Как настроить модуль Bitrix
Модуль Bitrix помогает упростить и ускорить интеграцию с Mindbox.
Описание возможностей, ограничений и инструкция по установке https://developers.mindbox.ru/docs/module-bitrix
Для начала работы необходимо установить и настроить модуль.
Общие настройки
Режим работы - по умолчанию "Стандартный". Обеспечивает асинхронную передачу данных в Mindbox.
Точка интеграции - уникальный идентификатор сайта/мобильного приложения/и т.п. Инструкция по настройке.
Секретный ключ - каждой "Точка интеграции" соответствует свой "Секретный ключ".
Префикс операций - префикс для стандартных операций API Mindbox. Для стандратно заведенных проектов нужно добавить Website
.
Системное имя - указать системное имя проекта. Для проекта demo.mindbox.ru бренд нужно указать "Demo".
Бренд - значение поля совпадает с именем проекта. Для проекта demo.mindbox.ru бренд нужно указать "Demo".
Домен API - нужно выбрать api.mindbox.ru
Настройки продуктов (Yml-фид)
Идентификатор продукта - идентификатор внешней системы, используемый при оформлении заказов. Для стандартных проектов нужно указать Website
.
ИД каталога в Битриксе - выбрать основной каталог с товарами на стороне сайта. Эти товары попадут в товарный фид.
Название yml фида - указывается название товарного фида. Например: upload/mindbox.xml
Далее фид нужно будет добавить в Mindbox: инструкция.
Для корректного формирования фида убедитесь, что в настройках редактирования сайта указан URL сервера.
Путь до настройки: Рабочий стол - Настройки - Настройки продукта - Сайты - Список сайтов
Настройки клиентов
Идентификатор клиента - системное имя идентификатора клиента сайта в системе Mindbox. На стандартно заведенных проектах указывается WebsiteID
.
Далее нужно настроить связь полей в Bitrix и Mindbox:
Поле в Bitrix - выбирается дополнительное поле Bitrix.
Поле в Mindbox - указывается системное имя дополнительного поля в Mindbox.
Про дополнительные поля в Mindbox можно больше узнать здесь: инструкция.
Типы выбранных полей должны совпадать в двух системах, например, если в Bitrix поле с типом дата, то и в Mindbox тип поля должен быть дата:
Настройки заказов
Идентификатор заказа - системное имя идентификатора заказа с сайта в системе Mindbox. Настраивается в разделе "Дополнительные поля" в Mindbox. Тип поля - заказ - внешний идентификатор.
Далее нужно настроить связь полей в Bitrix и Mindbox:
Поле в Bitrix - выбирается дополнительное поле Bitrix.
Поле в Mindbox - указывается системное имя дополнительного поля в Mindbox.
Типы выбранных полей должны совпадать в двух системах:
Настройка статусов заказов
Данный пункт важен для корректной работы операции изменения статуса заказов.
В случае если соответствие статусов между Mindbox и Bitrix не настроено, нужный функционал модуля будет отключен в фоне без явных сообщений об ошибках.
Чтобы изменение статусов заказов в Bitrix корректно отражалось в Mindbox, необходимо настроить соответствие этих статусов. Для этого нужно:
1. Убедиться, что на проекте в Mindbox заведены необходимые статусы заказов. Настроить статусы заказов можно так: инструкция.
Базовые статусы позиции заказов выглядят так:
2. В административной панели Bitrix перейти на страницу: Рабочий стол - Настройки - Настройки модулей - Mindbox, вкладка "Настройки заказов".
Здесь необходимо настроить соответствие статусов заказов вашего сайта на Bitrix и статусов заказов в Mindbox.
Важно: при добавлении кастомного статуса необходимо также добавить его в Mindbox с таким же внешним идентификатором:
Настройки подключения
Клиент HTTP - Тип HTTP клиента, используемого для запросов к API. Для использования curl уточните у разработчика Bitrix, что в модуле установленно расширение php curl.
php -i | grep curl
Таймаут асинхронных запросов (в секундах) - Время ожидания ответа для запросов к API из очереди запросов.
Таймаут синхронных запросов (в секундах) - Время ожидания ответа для запросов к API.
Путь к логам - Абсолютный путь до директории, куда модуль будет писать логи. Логи имееют следующую структуру хранения:
your_log_directory/
-- mindbox/
---- 2019/
------ 04/
-------- 29/
---------- mindbox.log
-------- 30/
---------- mindbox.log