SalesPlatform vtiger crm 600 Интеграция с 1С посредством CommerceML
Содержание |
Краткий обзор
Система SalesPlatform Vtiger CRM предоставляет возможность обновления информации о Каталогах, Товарах, Услугах и обмена данными по Контрагентам и Заказам на Продажу с 1С. В соответствии со стандартом CommerceML 2 обмен Товарами, Услугами и Каталогами осуществляется только от 1С к SalesPlatform Vtiger CRM, а обмен Заказами на Продажу и Контрагентами двунаправленный. Обмен реализован в соответствии с протоколом обмена системы 1С.
Допущения
Если название сущности начинается с большой буквы (Товар, Заказы на Продажу) - то подразумевается принадлежность этой сущности к SalesPlatform Vtiger CRM. Если название сущности начинается с маленькой буквы, то подразумевается ее принадлежность к 1С.
Внимание! Обмен по имеет свои особенности - в частности способ идентификации сущностей, сохранения единиц измерения для товаров и услуг, а также логику выгрузки/обновления заказов. Особенности обмена рассматриваются в разделе Особенности обмена с 1С
Настройка обмена
Настройка обмена в SalesPlatform Vtiger CRM
Система SalesPlatform Vtiger CRM позволяет включать/отключать обмен данными с 1С. За это отвечает специальный модуль SPCMLConnector. Для включения обмена данными, необходимо включить этот модуль в менеджере модулей:
При включенном модуле обмен разрешен. При выключенном модуле обмен производиться не будет.
Настройка обмена в 1С
1. Создайте новый узел обмена с сайтами
2. Настройте категории обмена информацией
- Введите наименование для обмена информацией;
- Укажите данные для обмена:
- Установите флаг Выгрузка товаров, чтобы происходил экспорт товаров из 1С на сайт;
- Установите флаг Обмен заказами, чтобы производился обмен заказами с SalesPlatform Vtiger CRM;
- Отметьте опцию Выгрузка на сайт. В настройках адреса сайта укажите URI на котором расположена SalesPlatform Vtiger CRM. К адресу добавте путь /1c_exchange.php. Поля Пользователь и Пароль заполните в соответствии с логином и Ключом доступа того пользователя системы SalesPlatform Vtiger CRM, от имени которого будут создаваться и обновляться записи. Получить ключ доступа можно в настройках учетной записи пользователя SalesPlatform Vtiger CRM в разделе Дополнительные Опции Пользователя:
- Контроль выгрузки - установите Полная выгрузка для обмена всеми товарами и заказами или Выгружать только измененные объекты для обмена только измененными объектами с момента предыдущего обмена;
- При необходимости можно настроить периодический обмен данными - установив флаг Использовать периодический обмен данными;
3. Настройка выгрузки товаров
- Выберите из списка существующих организацию которой принадлежит каталог;
- В поле Таблица каталогов выберите те каталоги, которые будут выгружаться в SalesPlatform Vtiger CRM;
- При необходимости, с помощью Настроить отбор можно настроить группы выгружаемых товаров из каталога;
4. Настройка обмена заказами
На вкладке Основные настройки обмена заказами укажите:
- Дополнительный реквизит Дата заказа на сайте укажите как ДатаНаСайте. Если реквизита нет его необходимо создать;
- Дополнительный реквизит Номер заказа на сайте укажите как НомерНаСайте. Если реквизита нет его необходимо создать;
- Способ идентификации контрагентов - укажите в зависимости от ваших предпочтений. Однако, так как поля ИНН и КПП в CRM не являются обязательными и могут отсутствовать у конкретного Контрагента, то в ходе обмена может возникнуть ошибка если они пусты - так как 1С не сможет идентифицировать контрагента;
- Вид номенклатуры (товар) укажите как Товар;
- Вид номенклатуры (услуга) укажите как Услуга;
- Выберите соответствующую единицу измерения номенклатуры;
- В поле Соглашение выберите или создайте новое соглашение, по которому будет производиться выгрузка;
- В поле Организация укажите организацию, от имени которой создаются заказы;
На вкладке Дополнительно:
- Установите флаги Проводить документы если хотите проводить документы сразу по получению с сайта и Вести нумерацию по данным сайта, если хотите, чтобы названия заказов соответствовали номерам Заказов на Продажу в CRM;
- Область Соответствие статусов заказов заполняется таким образом, чтобы статусы Заказов на Продажу в CRM соответствовали статусам заказов в 1С. Пример настройки соответствий приведен на рисунке 22.7. Так как стандартные статусы Заказов на Продажу в CRM хранятся в базе данных на английском языке, то и выгрузка в 1C производится на английском. Поэтому соответствие необходимо указывать с учетом этой особенности:
После этого необходимо сохранить все настройки (на рисунке 22.7 выделено красным цветом)
Выполнение обмена
Для выполнения обмена с SalesPlatform Vtiger CRM, если не был настроен автоматический обмен данными, требуется в окне Узлы обмена с сайтами выбрать необходимый узел обмена и выполнить для него следующие действия: Все действия --> Выполнение обмена данными --> Выполнить обмен данными.
После этого будет произведен обмен данными в соответствии с настройками выбранного узла обмена. Результаты обмена можно посмотреть в этом же окне с помощью Журнала обмена. Для этого необходимо выполнить Все действия --> Выполнение обмена данными --> События загрузки данных/События выгрузки данных. В журнале приведено время последнего обмена и информация о том как он завершился.
Результаты обмена
Результат обмена товарами
Результатом обмена товарами является обновление существующих или создание новых Товаров, Услуг и Каталогов в SalesPlatform Vtiger CRM. Как соотносятся Товары, Услуги и Каталоги в SalesPlatform Vtiger CRM с товарами,услугами и каталогами в 1С описано в разделе Особенности обмена с 1С.
При выгрузке товаров из 1С, в SalesPlatform Vtiger CRM обновляется следующая информация о Товарах и Услугах:
- Количестве на складе;
- Цена за единицу.
- Информация о НДС;
Кроме того, в SalesPlatform Vtiger CRM обновляется информация о Каталоге, в который включены соответствующие Товары и Услуги.
Результат выгрузки товаров из Основного каталога 1С представлен на рисунках ниже.
Результат обмена заказами
Результатом обмена заказами являются:
- Отправка из SalesPlatform Vtiger CRM в 1С тех Заказов на Продажу, которые были изменены с момента последнего обмена. Вместе с Заказом на Продажу выгружается информация и о привязанном к нему Контрагенте;
- Обновление информации по Заказам на Продажу и Контрагентам по данным, полученным от 1С;
Если Заказ на Продажу в SalesPlatform Vtiger CRM был изменен в ходе обмена заказами, то при следующем обмене он не будет выгружаться. В учет идут только "ручные" изменения Заказов на Продажу. Некоторые особенности обмена и как соотносятся Заказы на Продажу в SalesPlatform Vtiger CRM к заказам в 1С описано в разделе Особенности обмена с 1С.
Результаты обмена Заказами на Продажу представлены на рисунках ниже:
Особенности обмена с 1С
Особенности обмена заказами
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С заказ не проведен, то в SalesPlatform Vtiger CRM статус Заказа на Продажу Создан;
- Если в 1С заказ проведен, но нет документа оплаты заказа, то в SalesPlatform Vtiger CRM статус Заказа на Продажу Одобрен;
- Если в 1С заказ проведен и есть документ оплаты, то в SalesPlatform Vtiger CRM статус Заказа на Продажу Доставлен;
8. Если в ходе обмена из 1С передается заказ, в котором товары/услуги указаны в валюте, не активной в CRM, то произойдет ошибка. Для импорта в разных валютах необходимо вручную добавить требуемые валюты и настроить обменный курс. Валюта идентифицируется по международному трехзначному коду (EUR, RUR и т.д.)
Особенности обмена товарами
1. При выгрузке Товаров и Услуг, 1C выгружает единицу измерения на русском языке. Встроенные в CRM единицы измерения (список выбора) хранятся в базе данных на английском языке, поэтому при попытке обновить сущность вручную, сохраненное значение собьется. Для того, чтобы было возможным сохранять единицы измерения на любом языке, необходимо создать (заменить/продублировать - если уже существует такая единица измерения) новую единицу измерения в модуле Единицы Измерения, указав имя единицы в том виде, в каком она выгружается из 1С (значение в поле Единица измерения при просмотре карточки Товара ил Услуги)
2. Соответствие товаров в 1С и в SalesPlatform Vtiger CRM осуществляется по наименованию Товара и его артикулу. Если из 1С получен товар с уже имеющимся названием, но отличающимся артикулом, то в SalesPlatform Vtiger CRM будет создан новый Товар. Пустой артикул тоже считается.
3. Обмен товарами всегда односторонний - только из 1С в SalesPlatform Vtiger CRM.
4. Если в ходе обмена из 1С будет передан товар/услуга в валюте, не активной в 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 только обновляется - то на основании данных, переданных от 1С новый Заказ на Продажу никогда не создается.
