Расширенная интеграция с retailCRM

Установка

После скачивания модуля, его установка производится штатными средствами CS-Cart на странице Панель администратора → Модули → Управление модулями → Загрузить и установить модуль (+).

Для версии CS-Cart более 4.13.1 Панель администратора → Модули → Управление модулями → Кнопка Шестеренка → Ручная установка

Нажимаем Загрузить, в появившемся окне выбираем файл модуля, далее Загрузить и установить.

Настройка

Первоначальная настройка осуществляется на вкладке Общие настройки, где надо ввести URL учетной записи RetailCRM и API ключ.

По умолчанию, модуль находится в статусе Выключен, рекомендуется провести настройку перед тем, как включить его.

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

Дополнительная настройка

Описание настроек:

На вкладке Справочники необходимо взаимно сопоставить статусы заказов, способы доставки, способы оплаты между CS-Cart и RetailCRM. Так же здесь указывается зависимость статуса платежа в retailCRM от статуса заказа в CS-Cart.

На вкладке Поля пользователей сопоставляются поля профилей покупателей

На вкладке Заказы детально настраивается синхронизация: отключается импорт новых заказов из retailCRM, импорт/экспорт изменений заказа, экспорт обратных звонков, заказов в один клик и т.д.

Для импорта товаров из CS-Cart в RetailCRM необходимо создать YML-файл (например с помощью стандартного модуля Экспорт в Яндекс.Маркет). Для этого необходимо зайти в Администрирование →  Экспорт в Яндекс.Маркет → Прайс-лист.

Нажать кнопку Создать новый прайс-лист в виде плюса.



Настроить необходимые значения Ключ доступа, Имя прайс-листа, Название магазина и поставить галочку Прайс-лист для RetailCRM.

Ключ доступа находится в RetailCRM Настройки - Интеграция - Ключи доступа к API

После этого нажимаем Создать, появятся дополнительные настройки экспорта (можно оставить по умолчанию) и ссылки для формирования и скачивания файла, а также cron-команда для автоматического обновления файла.

А со стороны RetailCRM прописать на вкладке Настройки → Магазины → [Выбрать нужный магазин] → Каталог выбрать Загружать из ICML и в поле URL ICML-файла указать адрес сформированного YML-файла.

Важно: Для сквозной синхронизации МойСклад - RetailCRM - CS-Cart необходимо в yml-файл добавлять external_id для товара. Сделать это можно с помощью нашего модуля Применение фиксов. 

Применяем 7 (Добавление в retailcrm xmlid изменения в gatherAdditional) и 8 (Добавление в retailcrm xmlid изменения в getRetailCrmOfferAttributes) фикс:

После этого для товаров нужно указать значение external_id:

После этого обязательно сгенерировать файл импорта заново и значение external_id появится там в поле  .....

Чтобы автоматически синхронизировать изменения заказов/статусов из RetailCRM в CS-Cart необходимо на сервере CS-Cart прописать cron-команду php /path/to/admin.php --dispatch=trigger.retailcrm_import.

После настройки синхронизации меняем статус модуля на Включен.

Важно: При включении/отключении и обновлении модуля обновляются точки старта для заказов и незавершенных покупок. Это сделано для тех случаев, если надолго отключили модуль, чтобы не выгружались старые заказы и не синхронизировались старые изменения из истории.

v1.11.15

[*] Улучшена проверка клиентов на стороне retailcrm для предотвращения дублирования
[*] Изменена структура файлов
[+] Добавлен выбор сайтов для клиентов в настройках модуля, по которому будут запрашиваться клиенты из retailcrm

v1.11.14

[+] Стандартизация модуля

v1.11.13

[!] Исправлена проблема с дублированием пользователей
[*] При выключенной настройке импортировать новые заказы, новые клиенты тоже не создаются
[*] При выключенной настройке импортировать новые заказы, новые клиенты тоже не создаются

v1.10.13

[!] Исправлена проблема с дублированием способа оплаты
[*] Добавление доставки в комментарий перенесено в другой хук

v1.9.13

[+] Добавлена возможность выгрузки способа доставки в комментарий

v1.8.13

[*] Изменены языковые переменные

v1.8.12

[+] Стандартизация модуля

v1.8.11

[+] Добавлена настройка - Выгружать external_id товара

v1.8.10

[!] Исправлен баг при совпадении внешнего кода клиента

v1.8.9

[*] Отключена отправка Email при импорте нового клиента в cs-cart

v1.8.8

[+] Добавлено сопоставление Доставок / ПВЗ (CS-Cart) с Магазинами / Складами (RetailCRM)

v1.7.8

[!] Исправлено дублирование заказа при покупке в один клик

v1.7.7

[+] Добавлена передача ФИО при создании клиента как физ. лица

v1.7.6

[+] Добавлено удаление ИНН из заказа при наличии в нём ошибки
[+] Добавлен адрес ПВЗ в заказ
[*] Изменено определение типа заказа по полю идентификации

v1.6.6

[+] Добавлено создание двух типов клиентов - юр.лицо и физ.лицо
[+] Добавлена привязка заказа к клиенту
[!] Исправлена ошибка при обращении к методам корпоративных клиентов

v1.5.6

[+] Добавлено сопоставление полей «ИНН» и «Имя компании» из модуля ms_invoicing
[+] Добавлено изменение типа заказа на «‎Юр. лицо» при заполненном ИНН
[+] Добавлена валидация email
[!] Исправлена ошибка «‎Не верный тип контрагента»

v1.4.6

[*] Обновлена иконка MakeShop.pro

v1.4.5

[+] Синхронизация объединения клиентов
[+] Настройка символьного обозначения заказов в 1 клик
[!] Фикс настроек в мультивендоре
[!] Фикс клиентов "Без ФИО"

v1.4.4

[*] Заменены языковые переменные

v1.4.3

[+] Добавлена возможность экспорта купона на скидку
[!] Исправлена ошибка взаимодействия с модулем "Обратный звонок"
[!] Исправлен языковой файл (en)

v1.4.2

[*] Исправлен баг в шаблонах настроек мультивендора

v1.4.1

[+] Удаление товаров из корзины со статусом отмены
[+] Добавлена функция логирования

v1.4.0

[+] Поддержка мультивитрин 

v1.3.3

[+] Выгрузка незавершенных покупок незарегистрированных пользователей с контактными данными 

v1.3.2

[+] Возможность отключения витрин 

v1.3.1

[+] Точка старта выгрузки незавершенных покупок
[*] Исправлены ошибки

v1.3.0

[+] Экспорт незавершенных покупок + настройки
[+] Подсчет веса
[+] Учет сумм подарочных сертификатов и купонов на скидку
[!] Исправлены подсчет и синхронизация скидок
[+] Возможность отключения импорта новых заказов из retailCRM
[+] Выполнение действий при обновлении модуля в режиме разработчика

v1.2.0

[*] Добавлены настройки обратного звонка и покупки в один клик
[*] Добавлена возможность добавлять в комментарий клиента адрес доставки, отделения СДЭК
[*] Добавлена возможность добавлять товары в корзине в комментарий клиента при покупке в один клик
[*] Добавлена возможность стирать поле email по указанным доменам
[*] Добавлена возможность указывать URL заказа из админки
[*] Добавлена возможность записывать ФИО в поле "имя"
[*] Добавлена опция отключения модуля (для отображения настроек в отключенном режиме)
[!] Исправлена ошибка с присвоением retailCRM ID клиента

v1.1.1

[!] Исправлена ошибка при создании заказа в один клик

v1.1.0

[+] Структура прайс-листа по документации retailCRM
[+] Опция "прайс-лист для retailCRM" в редактировании прайс-листа
[+] Опции включения/отключения импорта/экспорта
[*] Доработан расчет скидок
[!] Мелкие исправления

v1.0.0

[+] Первый выпуск