Как настроить модуль 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. На стандартно заведенных проектах указывается WebsiteID.

Далее нужно настроить связь полей в Bitrix и Mindbox:

Поле в Bitrix - выбирается дополнительное поле Bitrix.
Поле в Mindbox - указывается системное имя дополнительного поля в Mindbox.

Про дополнительные поля в Mindbox можно больше узнать здесь: инструкция.

Типы выбранных полей должны совпадать в двух системах, например, если в Bitrix поле с типом дата, то и в Mindbox тип поля должен быть дата:

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

Идентификатор заказа - системное имя идентификатора заказа с сайта в системе Mindbox. Настраивается в разделе "Дополнительные поля" в Mindbox. Тип поля - заказ - внешний идентификатор.

Далее нужно настроить связь полей в Bitrix и Mindbox:
Поле в Bitrix - выбирается дополнительное поле Bitrix.
Поле в Mindbox - указывается системное имя дополнительного поля в Mindbox.

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

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

Чтобы изменение статусов заказов в Bitrix корректно отражалось в Mindbox, необходимо настроить соответствие этих статусов. Для этого нужно:

1. Убедиться, что на проекте в Mindbox заведены необходимые статусы заказов. Настроить статусы заказов можно так: инструкция.
   Базовые статусы позиции заказов выглядят так:
   

2. В административной панели Bitrix перейти на страницу: Рабочий стол - Настройки - Настройки модулей - Mindbox, вкладка "Настройки заказов".
   Здесь необходимо настроить соответствие статусов заказов вашего сайта на Bitrix и статусов заказов в Mindbox.

Важно: при добавлении кастомного статуса необходимо также добавить его в Mindbox с таким же внешним идентификатором:

Настройки подключения

Клиент HTTP - Тип HTTP клиента, используемого для запросов к API. Для использования curl уточните у разработчика Bitrix, что в модуле установленно расширение php curl.

Таймаут асинхронных запросов (в секундах) - Время ожидания ответа для запросов к API из очереди запросов.

Таймаут синхронных запросов (в секундах) - Время ожидания ответа для запросов к API.

Путь к логам - Абсолютный путь до директории, куда модуль будет писать логи. Логи имееют следующую структуру хранения:

   your_log_directory/
        -- mindbox/
            ---- 2019/
                ------ 04/
                    -------- 29/
                        ---------- mindbox.log
                    -------- 30/
                        ---------- mindbox.log