SalesPlatform vtiger crm 620 Интеграция с веб-сайтом посредством CommerceML
Содержание |
Краткий обзор
Система SalesPlatform Vtiger CRM предоставляет возможность обмена информацией о Заказах на Продажу и Каталогах, описывающих информацию о предоставляемых Услугах и Товарах с сайтом, по стандарту CommerceML 2 с помощью протокола обмена, разработанным компаниями 1С и 1С-Битрикс. При обмене информацией с сайтом система SalesPlatform Vtiger CRM выступает в роли 1С Предприятие. Обмен товарами и заказами периодически инициируется системой SalesPlatform Vtiger CRM c помощью соответствующих задач Планировщика. Реализованный механизм взаимодействия с сайтом не нарушает интеграцию CRM c системой 1С Предприятие и может быть использован совместно.
Настройка параметров обмена с сайтом
Настроить параметры обмена с сайтом можно с помощью соответствующей панели,доступ к которой осуществляется через модуль Настройки:
Для осуществления обмена необходимо корректно настроить следующие поля:
- Логин администратора сайта - необходим для идентификации запросов на обмен данными от CRM системы;
- Пароль администратора сайта - для аутентификации;
- Адрес сайта - сетевой адрес обработчика запросов (чаще всего имя обработчика - 1c_exchange.php);
- Ответственный пользователь - пользователь SalesPlatform Vtiger CRM, который будет ответственным в Заказах на Продажу, созданных на основе информации полученной с сайта.
Внешний вид панели представлен на рисунке ниже:
Также необходимо настроить соответствие статусов заказов на сайте и Заказов на Продажу в CRM. Для этого предоставляется панель настроек статусов. Для задания соответствия статусов необходимо указать значение статуса на сайте, и соответствующее ему значение в CRM:
Просмотр истории обмена
Для просмотра истории обмена необходимо в панели настроек параметров обмена нажать на кнопку История обменов:
История обменов отображается в отдельном окне. Каждый произведенный обмен описывают следующие поля:
- Номер - номер обмена по порядку;
- Время - дата и время обмена;
- Статус - обмен произведен успешно или нет;
- Направление обмена - обмен был с 1C или с сайтом;
- Ошибка - в случае если в ходе обмена была ошибка, запись о ней будет в этом поле.
Настройка частоты обмена с сайтом
Частота обмена с сайтом контролируется с помощью соответствующих задач Планировщика. Обмен каталогами и обмен заказами представлен в виде двух отдельных задач Планировщика. Для изменения периода необходимо для соответствующей задачи изменить ее частоту:
Особенности обмена Каталогами с сайтом
Обмен каталогами инициируется системой SalesPlatform Vtiger CRM с частотой, указанной в Планировщике. По своей сути - это выгрузка информации о состоянии каталогов на сайт. В соответствии с протоколом обмена, CRM выступает в роли 1С Предприятие и осуществляет выгрузку информации о каждом Каталоге в формате CommerceML 2 в виде двух файлов - Import.xml и Export.xml, описывающих соответственно электронные документы (ЭД) "Каталог" и "Пакет предложений". Эти два файла содержат информацию, описывающую сущность Каталог - его имя, идентификатор, а также информацию о включенных в него Товарах и Услугах (цена, количество на складе, название и т.д.). Для каждого Каталога формируются соответствующие файлы import.xml и export.xml, которые в зависимости от параметров обмена отправляются либо в сжатом виде в архиве, либо каждый по отдельности. Все взаимодействия сайта и CRM производятся в соответствии с протоколом обмена. Форматы ЭД "Каталог" и "Пакет предложений" описаны в документации по стандарту CommerceML 2. Историю выгрузки Каталогов можно просмотреть в панели настроек обмена с сайтом.
Особенности обмена Заказами на Продажу с сайтом
Обмен информацией о Заказах на Продажу инициируется системой SalesPlatform Vtiger CRM с частотой, указанной в Планировщике. Взаимодействия между сайтом и CRM осуществляются в рамках протокола обмена заказами. В соответсвии с протоколом, вначале CRM система посылает запрос на получение заказов - в ответе сайт присылает информацию о заказах. Для того, чтобы отличать Заказы на Продажу, созданные на основе информации с сайта, и созданные вручную, заказы с сайта идентифицируются по скрытому полю from_site, которое является номером заказа на сайте. Номер соответствующего заказа на сайте содержится в присылаемой информации с сайта. У Заказов на Продажу, созданных вручную, поле from_site пусто. В соответствии с данными, полученными от сайта, обновляются информация о соответствующих Заказах на Продажу.
Примечание. Если в заказе, полученном с сайта, указан Контрагент, которого нет в базе CRM, то он будет создан. Идентификация Контрагентов производится по полю ПолноеНаименование в соответствующем ЭД "Документ" в формате CommerceML 2.
После обновления информации о Заказах на Продажу, в рамках протокола обмена производится выгрузка на сайт тех Заказов на Продажу, информация о которых не была обновлена.
Примечание. Выгружаются только те Заказы на Продажу, которые были ранее получены с сайта и не были обновлены в ходе текущей транзакции. Такой же механизм выгрузки/обновления заказов реализован в системе 1С Предприятие.
Историю обмена Заказами на Продажу можно просмотреть в панели настроек обмена с сайтом.