SalesPlatform vtiger crm 540 Интеграция с 1С посредством CommerceML

Материал из SalesPlatform Wiki
Перейти к: навигация, поиск

Главная страница руководства


Содержание

Краткий обзор

Система SalesPlatform Vtiger CRM предоставляет возможность обновления информации о Каталогах, Товарах, Услугах и обмена данными по Контрагентам и Заказам на Продажу с 1С. В соответствии со стандартом CommerceML 2 обмен Товарами, Услугами и Каталогами осуществляется только от 1С к SalesPlatform Vtiger CRM, а обмен Заказами на Продажу и Контрагентами двунаправленный. Обмен реализован в соответствии с протоколом обмена системы 1С.

Допущения

Если название сущности начинается с большой буквы (Товар, Заказы на Продажу) - то подразумевается принадлежность этой сущности к SalesPlatform Vtiger CRM. Если название сущности начинается с маленькой буквы, то подразумевается ее принадлежность к 1С.


Настройка обмена

Настройка обмена в SalesPlatform Vtiger CRM

Система SalesPlatform Vtiger CRM позволяет включать/отключать обмен данными с 1С. За это отвечает специальный модуль SPCMLConnector. Для включения обмена данными, необходимо включить этот модуль в менеджере модулей:

Рис. 2.1: Менеджер модулей
Рис. 2.2: Модуль интеграции с 1С


При включенном модуле обмен разрешен. При выключенном модуле обмен производиться не будет.

Настройка обмена в 1С

1. Создайте новый узел обмена с сайтами

Рис. 2.3 Создание узла обмена


Vt note.png
Примечание. Можно создать несколько узлов обмена с сайтом


2. Настройте категории обмена информацией

Рис. 2.3 а)Учетная запись пользователя


Рис. 2.3 б)Ключ доступа пользователя


Рис. 2.4 Настройка параметров соединения



3. Настройка выгрузки товаров

Рис. 2.5 Настройка выгрузки товаров


4. Настройка обмена заказами

На вкладке Основные настройки обмена заказами укажите:


Рис. 2.6 Основные настройки обмена заказами


На вкладке Дополнительно:

Рис. 2.7 Дополнительные настройки обмена заказами


После этого необходимо сохранить все настройки (на рисунке 2.7 выделено красным цветом)

Выполнение обмена

Для выполнения обмена с SalesPlatform Vtiger CRM, если не был настроен автоматический обмен данными, требуется в окне Узлы обмена с сайтами выбрать необходимый узел обмена и выполнить для него следующие действия: Все действия --> Выполнение обмена данными --> Выполнить обмен данными.

Рис. 3.1 Выполнение обмена данными


После этого будет произведен обмен данными в соответствии с настройками выбранного узла обмена. Результаты обмена можно посмотреть в этом же окне с помощью Журнала обмена. Для этого необходимо выполнить Все действия --> Выполнение обмена данными --> События загрузки данных/События выгрузки данных. В журнале приведено время последнего обмена и информация о том как он завершился.

Результаты обмена

Результат обмена товарами

Результатом обмена товарами является обновление существующих или создание новых Товаров, Услуг и Каталогов в SalesPlatform Vtiger CRM. Как соотносятся Товары, Услуги и Каталоги в SalesPlatform Vtiger CRM с товарами,услугами и каталогами в 1С описано в разделе Особенности обмена с 1С.

При выгрузке товаров из 1С, в SalesPlatform Vtiger CRM обновляется следующая информация о Товарах и Услугах:

Кроме того, в SalesPlatform Vtiger CRM обновляется информация о Каталоге, в который включены соответствующие Товары и Услуги.

Результат выгрузки товаров из Основного каталога 1С представлен на рисунках ниже.

Рис. 4.1 Полученные из 1С товары


Рис. 4.2 Полученные из 1С услуги


Рис. 4.3 Полученный из 1C каталог


Результат обмена заказами

Результатом обмена заказами являются:

Если Заказ на Продажу в SalesPlatform Vtiger CRM был изменен в ходе обмена заказами, то при следующем обмене он не будет выгружаться. В учет идут только "ручные" изменения Заказов на Продажу. Некоторые особенности обмена и как соотносятся Заказы на Продажу в SalesPlatform Vtiger CRM к заказам в 1С описано в разделе Особенности обмена с 1С.

Результаты обмена Заказами на Продажу представлены на рисунках ниже:

Рис. 4.4 Заказ клиента в vtiger CRM


Рис. 4.5 Заказ клиента в vtiger CRM. Товарная часть


Рис. 4.6 Заказ клиента в 1С



Дополнительно, необходимо проверить, что в директории установки SalesPlatform Vtiger CRM присутствует директория /test/upload/1c - так как в нее сохраняются временные файлы, присылаемые 1С.

Особенности обмена с 1С

Особенности выгрузки каталогов из 1С на сайт больших размеров

Если размер выгружаемого каталога больше, чем может быть передано за один запрос, то система 1С разбивает его на несколько частей и посылает их за несколько запросов. На данный момент сборка информации из нескольких переданных частей не предусмотрена и выгрузка не будет осуществлена. Поэтому для того, чтобы осуществить выгрузку каталогов больших размеров, необходимо выставить размер единовременно загружаемой части больше, чем размер передаваемого каталога. Сделать это можно следующим образом - в функции runTranzaction() которая находится в файле modules/SPCMLConnector/TranzactionController.php изменить строчку

$answer = "zip=yes 1024000";

так, чтобы указанный размер (в байтах) был больше, чем размер передаваемой части.

Особенности обмена заказами

1. При обмене заказами, из SalesPlatform Vtiger CRM выгружаются в 1С только те Заказы на Продажу, которые были изменены после последнего обмена с 1С;

2. Система 1С выгружает в SalesPlatform Vtiger CRM только те заказы, которые были ранее получены от SalesPlatform Vtiger CRM. Причем в выгрузку попадают только те, которые не были переданы в текущем обмене. Это связано с особенностями реализации 1С. Некоторые особенности 1С обсуждаются тут

3. Статус заказа в 1С не будет изменен в соответствии с полученным статусом Заказа на Продажу от SalesPlatform Vtiger CRM, если к заказу в 1С привязан какой-либо документ;

4. Нумерация заказов в 1С ведется только по данным SalesPlatform Vtiger CRM. В SalesPlatform Vtiger CRM производится только обновление Заказов на Продажу по данным, полученным от 1С - новые Заказы на Продажу не создаются.

5. Соответствие заказов в 1С и Заказов на Продажу в SalesPlatform Vtiger CRM осуществляется по уникальному номеру Заказа на Продажу в SalesPlatform Vtiger CRM, генерируемому автоматически. Обновление Заказа на Продажу осуществляется в соответствии с теми Товарами и Услугами, которые были переданы из 1С.

6. При получении пустого ответа при обмене заказами (нет изменений в Заказах на Продажу в SalesPlatform Vtiger CRM) система 1С считает что это ошибка.

7. В явном виде система 1С не выгружает статус заказа. Поэтому соотвтествие статусов Заказов на Продажу с SalesPlatform Vtiger CRM производится следующим образом:


Особенности обмена товарами

1. При выгрузке товаров возможно нарушение протокола обмена системой 1С - после передачи архива с товарами 1С передает их повторно в несжатом виде, что не соотвтетствует протоколу. SalesPlatform Vtiger CRM расценивает это как неудачную новую попытку обмена и завершает транзакцию. Соответственно система 1С считает что произошла ошибка.

2. Соответствие товаров в 1С и в SalesPlatform Vtiger CRM осуществляется по наименованию Товара и его артикулу. Если из 1С получен товар с уже имеющимся названием, но отличающимся артикулом, то в SalesPlatform Vtiger CRM будет создан новый Товар. Пустой артикул тоже считается.

3. Обмен товарами всегда односторонний - только из 1С в SalesPlatform Vtiger CRM.


Особенности сопоставления сущностей из 1С с сущностями SalesPlatform Vtiger CRM

1. Товар в SalesPlatform Vtiger CRM идентифицируются по Наименованию товара и его Артикулу из 1С. Если в SalesPlatform Vtiger CRM не найдено соответствие, то производится поиск Товара по скрытому полю Идентификатор 1С. Если и в этом случае не будет найдено соответствия, то создается новый Товар. Во всех остальных случаях информация о Товаре обновляется.

2. Услуга в SalesPlatform Vtiger CRM идентифицируются по Названию услуги, полученной от 1С. Если в SalesPlatform Vtiger CRM не найдено соответствие, то производится поиск Услуги по скрытому полю Идентификатор 1С. Если и в этом случае не будет найдено соответствия, то создается новая Услуга. Во всех остальных случаях информация об Услуге обновляется.

3. Каталог в SalesPlatform Vtiger CRM идентифицируется по скрытому полю Идентификатор 1С. Если не найдено соответствия, то будет создан новый Каталог.

4. Контрагент в SalesPlatform Vtiger CRM идентифицируется по скрытому полю Идентификатор 1С. Если не найдено соответствия (первый обмен) - то поиск будет производиться по имени Контрагента. Если и в этом случае не будет найдено соответствия то будет создан новый Контрагент.

5. Заказы на продажу в SalesPlatform Vtiger CRM идентифицируются только по Номеру заказа. Номер автоматически генерируется системой при создании Заказа на Продажу. Информация о Заказах на Продажу в в SalesPlatform Vtiger CRM только обновляется.

Личные инструменты
Пространства имён
Варианты
Действия
Навигация
Инструменты