Установка модуля интеграции Opencart и Битрикс 24

• Установка модуля
• Настройка модуля
  • Создание Входящего вебхука
  • Настройка событий Opencart
  • Добавление Исходящего вебхука
  • Настройка заказов
  • Настройка отправки пользовательских полей
  • Настройка работы с клиентами
  • Настройка товаров
  • Настройка статусов заказов
• Зависимости
• Автоматизация
  • Отправка брошенной корзины
  • Отправка заказов при отключенных событиях Opencart
  • Синхронизация товаров Opencart
  • Обновление товаров Opencart

Установка модуля

Перейдите на страницу “Установка дополнений”. Нажмите “Загрузить”. Выберите файл модуля для вашей версии Opencart. Нажмите “Продолжить”. 

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

Перейдите на страницу “Дополнения”, нажмите “Установить”

Настройка модуля

Перейдите к редактированию настроек модуля

Создание Входящего вебхука

В Битрикс 24 перейдите на страницу Разработчикам - Другое - Входящий вебхук.

В области Настройка прав выберите: catalog, Пользователи (user), CRM (crm)

Сохраните изменения

Перейдите в Интеграции

Выберите созданный Входящий вебхук

Скопируйте ссылку на вебхук и вставьте в настройки модуля

Сохраните изменения в модуле

В случае если при нажатии на кнопку сохранения не появляются вкладки заказы, пользовательские поля, клиенты, товары, настройка статусов необходимо проверить настройку прав Входящего вебхука (catalog, Пользователи (user), CRM (crm)). После коррекции прав на Входящий вебхук сохранить настройки модуля повторно.

Настройка событий Opencart

Модуль для триггеров отправки данных использует события Opencart. Для Opencart 2.3 и 3.0 включение/отключение событий возможно в визуальном режиме. 

• b24_admin_orderpro_edit - отправка измененного заказа из модуля OpderPro
• b24_admin_order_edit - отправка измененного заказа из заказов Opencart
• b24_affilate_form - отправка формы регистрации партнёра
• b24_category_add - добавление категории в Битрикс 24
• b24_category_delete - удаление категории из Битрикс 24
• b24_category_edit - редактирование категории в Битрикс 24
• b24_customer_add - добавление контакта после регистрации клиента     в Opencart
• b24_customer_add_address  - обновление адреса контакта при добавлении адреса клиента
• b24_customer_admin_edit - обновление контакта после редактирования клиента в админке
• b24_customer_edit - после редактирования данных клиента в личном кабинете изменение данных контакта Битрикс 24
• b24_customer_edit_address - изменение адреса контакта в Битрикс 24 после изменения адреса в личном кабинете клиента
• b24_order_add - отправка заказа в Битрикс24 после подтверждения заказа в Opencart
• b24_product_add - добавление товара в Битрикс 24 после добавления товара в Opencart
• b24_product_delete - удаление товара в Битрикс 24 после удаления товара в Opencart
• b24_product_edit - редактирование товара в Битрикс 24 после редактирования товара в Opencart
• b24_return - отправка формы возврата товара в лиды Битрикс 24

Для включения/выключения события в Opencart 2.1 обратитесь в техническую поддержку api-pro.ru

Добавление Исходящего вебхука

Создайте исходящий вебхук на странице Разработчикам - Другое - Исходящий вебхук

URL вашего обработчика должен быть: https://вашдомен/index.php?route=api/b24

События

• Обновление лида (ONCRMLEADUPDATE)
• Удаление лида (ONCRMLEADDELETE)
• Обновление сделки (ONCRMDEALUPDATE)
• Удаление сделки (ONCRMDEALDELETE)
• Обновление контакта (ONCRMCONTACTUPDATE)
• Удаление контакта (ONCRMCONTACTDELETE)
• Удаление товара (ONCRMPRODUCTDELETE)

Добавьте токен приложения в настройки модуля и сохраните изменения.

Настройка заказов

Отправка заказов в Битрикс.	Данная настройка управляет тем куда будут отправляться заказы из Opencart в Битрикс 24.
Синхронизация заказов магазина и Битрикс 24.	Нажимая на кнопку “Синхронизировать” вы  отправляете заказы Opencart в Битрикс 24.
Создатель заказов Битрикс 24.	Выберите пользователя Битрикс 24 от чьего имени будет создана сделка или лид.
Менеджер заказов.	Выберите пользователя Битрикс 24 кому будет доступна для ведения сделка или лид Битрикс 24. При создании сделки, в случае отсутствия контакта он автоматически создается и прикрепляется к сделке. Менеджер заказов прикрепляется к созданному контакту.
Добавлять комментарий в заказе к таймлайну.	При создании сделки коментарии к заказу будет добавлен к Таймлайну.
Заказы видны всем менеджерам.	Данная настройка позволяет сделать видимой сделку для всех менеджеров Битрикс 24.
Источник заказа.	Выберите источник заказа из доступных. Если вы хотите создать новый источник создайте его в настройках Битрикс 24 и нажмите кнопку “Обновить настройки из Б24”.
Воронка сделки по умолчанию.	Статусы выбранной воронки будут доступны для конфигурации во вкладке “Настройка статусов”. Выбранная воронка будет назначена всем отправленным в Битрикс 24 заказам.
ID товара Битрикс24 в качестве доставки.	Если у вас есть товар в Opencart который отвечает за доставку добавьте его ID.
Способ оплаты.	Выберите пользовательское поле для лида или сделки в которое будет записываться способ оплаты из корзины Opencart. В случае если пользовательское поле это список, будет предложен выбор соответствия способа оплаты в Opencart и элемента списка в Битрикс 24.
Способ доставки.	Выберите пользовательское поле для лида или сделки в которое будет записываться способ доставки из корзины Opencart. В случае если пользовательское поле это список, будет предложен выбор соответствия способа доставки в Opencart и элемента списка в Битрикс 24.
Roistat.	Выберите пользовательское поле для лида или сделки в которое будет записываться значение Cookie Roistat из корзины Opencart.

Настройка отправки пользовательских полей

Выберите пользовательское поле в сделке и данные из заказа

Добавьте статичные данные в отправку поля сделки по ID поля.

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

Синхронизация клиентов.	Кнопка синхронизации переносит зарегистрированных клиентов Opencart в контакты Битрикс 24.
Источник клиента.	При добавлении нового клиента ему будет присвоен выбранный источник из настроек CRM.
Тип клиента.	При добавлении нового клиента ему будет присвоен выбранный тип из настроек CRM.
Клиенты видны всем менеджерам.	При выборе настройки все добавленные из Opencart клиенты будут видимы всем менеджерам Битрикс 24.

Настройка товаров

Синхронизировать по идентификатору.	При добавлении товаров в Битрикс 24 можно явно указать по какому параметру будет производиться поиск товара для его сопоставления. Указав любой параметр отличный от ID товара и выбрав соответствующие поля в свойствах товара можно добиться хорошей синхронизации при наличии товара в Битрикс 24 на момент синхронизации. Другими словами избежать дублирования товаров в Битрикс 24 при синхронизации.
Синхронизировать категории.	Настройка позволяет отключить добавление дерева категорий из Opencart в Битрикс 24. При этом синхронизированные товары будут расположены в корне каталога Битрикс 24.
Синхронизировать товары.	Настройка позволяет отключить добавление и синхронизацию товаров в Битрикс 24. При добавлении новых они не будут добавлены в Битрикс 24 и при обновлении существующих товары не будут обновлены в Битрикс 24.
Кнопка синхронизации.	Позволяет синхронизировать по количеству и составу товары в Opencart и товары в Битрикс 24. При синхронизации существующие товары в Битрикс 24 не обновляются.
Кнопка обновления.	Позволяет обновить в товарах Битрикс 24 данные из товаров Opencart. Обновляются только товары дата изменения которых в Opencart позже чем обновление в Битрикс 24.
Название товара.	Настройка позволяет сформировать название товара Битрикс 24 из набора характеристик. Порядок характеристик в названии будет соответствовать порядку в настройках модуля.
Изображение товара.	Позволяет выключать отправку изображений в товары Битрикс 24.
Свойства товаров.	Настройка позволяет выбрать соответствие свойств товаров Битрикс 24 и Opencart.

Настройка статусов заказов

Статусы Битрикс 24 -> Opencart

Данная настройка позволяет присваивать статус заказу в Opencart при его изменении в Битрикс 24. Возможна настройка статусов лидов и сделок. Настройка производится на основании выбранной воронки по умолчанию (вкладка Заказы).

Статусы Opencart > Битрикс 24

Данная настройка позволяет присваивать статус заказу в Битрикс 24 при его изменении в Opencart.
В случае если статус не выбран он не изменится в Opencart или Битрикс 24.

Зависимости

Синхронизация заказов. Желательно перед синхронизацией заказов:

• убрать на время токен исходящего вебхука.
• настроить полностью соответствие статусов.

Дело в том что при переносе заказов в Битрикс 24 и настроенном исходящем вебхуке Opencart будет получать изменения по заказам и возможно рассылать клиентам оповещения.

Изменение настроек на стороне Битрикс 24. 

При любом изменении настроек CRM Битрикс 24 необходимо обновлять настройки в Opencart кнопкой “Обновить настройки из Б24”.

Изменение состава модулей доставки или оплаты

При любом изменении состава модулей доставки и оплаты необходимо обновлять настройки в Opencart кнопкой “Обновить настройки из Б24” и сохранять изменения.

Необходимыми условиями правильной работы модуля являются:

1. Настройка входящего и исходящего вебхуков
2. Настройка модуля
3. Синхронизация статусов
4. Синхронизация товаров
5. Синхронизация клиентов

Автоматизация

Для автоматической синхронизации используется планировщик CRON. 

Отправка брошенной корзины

Обычно Opencart сохраняет данные по заказам в которых были введены email, ФИО покупателя, но не завершен процесс оформления заказа.
Для отправки в битрикс таких заказов можно настроить задание в планировщике CRON. В этом случае в сделки будут попадать заказы с пометкой “Брошенная корзина”.
Файл для запуска находится по пути корневая папка вашего сайта/system/cron/send_lost_order_b24.php

Отправка заказов при отключенных событиях Opencart

Отправка заказов при этом возможна через планировщик CRON.
В этом случае возможно не будут отправлены UTM метки по заказу
Файл для запуска находится по пути корневая папка вашего сайта/system/cron/send_order.php

Синхронизация товаров Opencart

Если у вас добавление товаров производится сторонним модулем без задействования стандартных механизмов Opencart синхронизация товаров возможна через планировщик CRON.
Файл для запуска находится по пути корневая папка вашего сайта/system/cron/send_product_b24.php

Обновление товаров Opencart

Если у вас обновление товаров производится сторонним модулем без задействования стандартных механизмов Opencart синхронизация товаров возможна через планировщик CRON.
Файл для запуска находится по пути корневая папка вашего сайта/system/cron/update_product_b24.php