Как настроить модуль Bitrix

Модуль Bitrix помогает упростить и ускорить интеграцию с Mindbox.

Описание возможностей, ограничений и инструкция по установке https://developers.mindbox.ru/docs/module-bitrix

Для начала работы необходимо установить и настроить модуль.

Общие настройки

Режим работы - по умолчанию "Стандартный". Обеспечивает асинхронную передачу данных в Mindbox.

Точка интеграции - уникальный идентификатор сайта/мобильного приложения/и т.п. Инструкция по настройке.

Секретный ключ - каждой "Точка интеграции" соответствует свой "Секретный ключ".

Снимок экрана 2022-04-27 в 16.41.10.png

Префикс операций - префикс для стандартных операций API Mindbox. Для стандратно заведенных проектов нужно добавить Website.

Снимок экрана 2022-04-27 в 16.51.13.png

Системное имя - указать системное имя проекта. Для проекта demo.mindbox.ru бренд нужно указать "Demo".

Бренд - значение поля совпадает с именем проекта. Для проекта demo.mindbox.ru бренд нужно указать "Demo".

Домен API - нужно выбрать api.mindbox.ru

Снимок экрана 2021-03-29 в 10.17.26.png

Настройки продуктов (Yml-фид)

Идентификатор продукта - идентификатор внешней системы, используемый при оформлении заказов. Для стандартных проектов нужно указать Website.

ИД каталога в Битриксе - выбрать основной каталог с товарами на стороне сайта. Эти товары попадут в товарный фид.

Название yml фида - указывается название товарного фида. Например: upload/mindbox.xml

Далее фид нужно будет добавить в Mindbox: инструкция.

Снимок экрана 2021-04-01 в 10.32.24.png

Для корректного формирования фида убедитесь, что в настройках редактирования сайта указан URL сервера.

Путь до настройки: Рабочий стол - Настройки - Настройки продукта - Сайты - Список сайтов

Снимок экрана 2021-10-04 в 16.35.34.png

Настройки клиентов

Идентификатор клиента - системное имя идентификатора клиента сайта в системе Mindbox. На стандартно заведенных проектах указывается WebsiteID.

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

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

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

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

Снимок экрана 2021-04-01 в 10.40.36.png

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

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

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

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

Снимок экрана 2021-04-01 в 10.43.16.png

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

Данный пункт важен для корректной работы операции изменения статуса заказов.
В случае если соответствие статусов между Mindbox и Bitrix не настроено, нужный функционал модуля будет отключен в фоне без явных сообщений об ошибках.

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

Скриншот 25-11-2021 20.07.52.png

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

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

Скриншот 25-11-2021 19.45.09.png

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

Клиент 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

Снимок экрана 2021-04-01 в 10.20.22.png

Работа с API без навыков программирования - интегрируем друг с другом разные сервисы типа банкинга, телефонии и CRM-систем.