biz87 / modretailcrm-2.0 Goto Github PK

Компонент для интеграции популярного сервиса RetailCRM с MODX.

Компонент в основном заточен под популярный интернет-магазин miniShop2, но может работать и без него в ручном режиме, поддерживая весь функционал заложенный в API RetaiCRM

• Плагин, отслеживающий определенные события
• Ряд системных настроек
• Сниппет icml, формирующий базовую выгрузку для каталога RetailCRM

1. Отслеживать регистрацию новых пользователей (в том числе и скрытую регистрацию при создании заказа miniShop2) и создавать пользователей в RetailCRM
2. Отслеживать создание новых заказов miniShop2 и передавать данных о заказах в RetailCRM
3. Отслеживать изменение статусов заказов в интернет-магазине, и передавать эти изменения в RetailCRM, меняя статус заказа и там.
4. Отслеживать изменения статусов заказов в RetailCRM и менять статусы этих заказов в интернет-магазине (Требуется дополнительная настройка на стороне RetailCRM)
5. Работать с формами, отправляя необходимые данные (Требуется подготовка и написание сниппета)

1. Email
2. Номер телефона
3. Имя
4. Идентификационный номер пользователя в MODX

1. Номер заказа
2. Перечень товаров в заказе, включая цену, наименование, количество, идентификатор товара (для связи с каталогом RetailCRM)
3. Модификации товара на основе компонента msOptionsPrice2 и опции товаров
4. Стоимость и способ доставки
5. Способ оплаты
6. Скидка сформированная компонентом msPromoCode
7. Адрес доставки
8. Общий вес заказа

1. Событие OnUserSave - Регистрация новых пользователей. Данные о новых пользователях передаются в RetailCRM
2. Событие msOnCreateOrder - Новые заказы. Данные передаются в RetailCRM
3. Событие msOnChangeOrderStatus - Изменение статуса заказа. Данные об обновленном заказе передаются в RetailCRM
4. Событие OnMODXInit - Добавление новых полей к способам Оплаты и Доставки, к статусу Заказа
5. Событие msOnManagerCustomCssJs - Добавление новых полей к способам Оплаты и Доставки, к статусу Заказа
6. Событие OnHandleRequest - Отлавливает данные из RetailCRM, переданные при помощи триггеров и применяет к соответствующим объектам на сайте (Например меняет статус заказа)

1. Естественно у вас должен быть аккаунт в RetailCRM.
2. В системных настройках сайта (раздел modretailcrm) Вам нужно обязательно указать

• API ключ.
• адрес вашей CRM.
• символьный код сайта.

3. Доставка. Для передачи способов доставки при заказе нужно указать их символьные коды Идем в настройки miniShop2 - открываем по очереди все активные способы доставки - в окне редактирования должно появиться новое поле Символьный код RetailCRM

Записываем туда соответствующий символьный код из справочника доставок RetailCRM. Сохраняем.

4. Проделываем то же самое со способами оплаты. Справочник типов оплаты можно найти в разделе Администрирование/Справочники RetailCRM

5. Проделываем то же самое со статусами заказа. Справочник статусов заказов можно найти в разделе Администрирование/Статусы RetailCRM

6. После этого рекомендуется настроить выгрузку товаров в каталог RetailCRM, Выгрузку существующих пользователей и заказов. По каждому из пунктов есть отдельный раздел документации. Это не обязательное условие для работы, но так вы получите более качественные отчеты и аналитику.