Интеграция iiko и Битрикс24: синхронизация товаров и банкетов (из Айко в смарт-процессы Битрикс24 и обратно)

1. Слаженная работа кухни и отдела продаж

Представьте: заказ на банкет оформлен в Битрикс24, менеджер ведёт диалог с клиентом, уточняет нюансы, а кухня уже в курсе всех деталей — без звонков, переписок и таблиц.

Именно так работает наш заказчик, занимающийся выездными мероприятиями.

Продажи ведутся в сделках Битрикс24, а организация — от кухни до логистики — полностью выстроена в iiko.

В этой системе каждый банкет оформляется на базе резерва и включает не просто список блюд, а полную картину: кто гость, что он выбрал, за каким столиком будет сидеть, кто из официантов его обслужит, когда и где всё произойдёт.

Вся эта информация фиксируется в карточке гостя.

Где возникла загвоздка: невидимые блюда и молчаливое API

Заказчик стремился к полной прозрачности — передавать информацию о банкетах из iiko в смарт-процессы Битрикс24, чтобы получать аналитику, строить отчеты и управлять продажами на уровне данных.

Но на пути к этому идеалу возникло несколько «но».

Например, каждый банкет в iiko — это не просто событие, а целый набор блюд, которые в системе хранятся как отдельные товары.

А вот в Битрикс24 на тот момент товарного каталога не было вовсе.

Это означало: без предварительной синхронизации банкеты просто «не проходили» — им не на что было опереться.

А теперь к главным проблемам:

• В iiko у многих товаров не было указано цен — и это превращало данные в неполные.


• REST API iiko не поддерживает отслеживание изменений в товарах. То есть если в iiko обновляется блюдо, Битрикс24 об этом просто не узнает. Никаких уведомлений, никаких автообновлений.

Всё это делало автоматическую синхронизацию не просто задачей — настоящим вызовом.

Как мы решили задачу: синхронизация в две стороны

Чтобы запустить обмен банкетами между iiko и Битрикс24, нужно было навести порядок в базовых данных — начать с каталога товаров.

Мы предложили клиенту первый ключевой шаг: выгрузить все позиции из iiko в товарный каталог Битрикс24.

Но на этом всё не заканчивается. Так как в iiko у части блюд просто не была указана цена, менеджеры получили возможность вручную заполнять недостающие данные уже в Битрикс24.

Это позволило подготовить систему к полноценной работе с банкетами.

Главный технический вызов — отсутствие автоматического трекинга изменений в товарах через REST API iiko.

Иными словами, iiko "молчит", когда данные в нём обновляются.

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

Мы развернули дополнительную интеграцию, но уже в обратную сторону.

Теперь при изменении цены в Битрикс24 она автоматически обновляется в iiko.

То есть управление ценами — полностью под контролем менеджеров по продажам.

Важно: банкеты начинают синхронизироваться только после того, как в обеих системах настроено соответствие по товарам.

Это — своего рода «ключ», без которого система просто не откроется.

Возможно, вас заинтересует интеграция с Remarked? Гляньте кейс и протестируйте готовый шаблон здесь.

Как работает техническое решение на практике

Чтобы связать iiko и Битрикс24 в единую систему, мы реализовали двухстороннюю интеграцию, которая обеспечивает чистую, актуальную и управляемую базу товаров — основу для корректной передачи банкетов.

1.1. Выгрузка товаров из iiko в Битрикс24

Первая часть решения — синхронизация товарного каталога из iiko в Битрикс24.

Все ключевые поля копируются и автоматически заполняются, чтобы в дальнейшем не было разрывов при передаче банкетов:

• ID товара из iiko → в соответствующее поле в Битрикс24


• Name → наименование товара


• Description → описание


• Num → внутренний номер позиции в iiko


• Code → артикул


• Price → предполагаемая закупочная цена из iiko

1.2. Автоматическое обновление данных из Битрикс24 в iiko

Так как iiko не отслеживает изменения на своей стороне, мы реализовали обратную интеграцию.

Теперь, если менеджер обновит информацию о товаре в Битрикс24 — эти изменения будут автоматически отражены в iiko.

Обновляемые поля:

• Name — наименование


• Description — описание


• Price — цена закупки

Таким образом, центр управления товарами находится в Битрикс24, а iiko всегда получает актуальные данные без ручных правок.

Готовый шаблон для настройки интеграции уже доступен для установки по ссылке.

В следующем разделе разберем настройку интеграций.

2. Передача новых товаров из iiko в Битрикс24

Шаг первый: Откуда

Получаем все товары из iiko. Новое событие мы добавили через Пинкитбилдер.

Шаг второй: Инструменты

• Существует ли товар?

Используем Поиск ID соответствующий сущности в поле source.id. Сопоставляем сущности товаров.

• Если товар не существует, то продолжить

Используем проверку в поле step9. Условие - Пустое значение. Действие - Продолжить, если проверка пройдена.

• Существует ли товарный каталог?

Используем Поиск ID соответствующий сущности в поле source.parent. Сопоставляем каталоги в iiko и Битрикс24.

• Получили результат по существованию каталога

Используем инструмент Если-Иначе в поле step3. Условие - Пустое значение, Результат при успешной проверке = 1, Результат при неуспешной проверке = 0.

• Получили каталог в iiko

Используем API-запрос методом GET. Условие выполнения - step7. URL = /v2/entities/products/group/list?ids={{source.parent}}.

• Создали каталог в Битрикс24

Используем API-запрос методом POST. Условие выполнения - step7. URL = /catalog.section.add.

Тело запроса:

{

"fields": {

"name": "{{step5.0.name}}",

"iblockId": 14

}

}

• Сохранили сопоставление

Используем инструмент Сохранить сопоставление сущностей. Условие выполнения - step7. ID сущности-источника - {{source.parent}}. ID сущности-цели - {{step4.result.section.id}}. Сопоставляем каталоги.

• Забираем новый или старый каталог?

Используем инструмент Если-Иначе в поле step7. Условие - (Число) Равно, Сравниваемое значение = 1, Результат при успешной проверке = {{step4.result.section.id}}, Результат при неуспешной проверке = {{step3}}.

Шаг третий: Куда

Создаем товар в Битрикс24.

Шаг четвертый: Сопоставление данных

Сопоставляем данные:

Название - {{source.name}}

Описание - {{source.description}}

Цена - {{source.defaultSalePrice}}

Идентификатор раздела - {{step8}}

И пользовательские сопоставления:

ID Товара из iiko

Тип: Тело

Название параметра: fields.PROPERTY_106

Значение параметра: {{source.id}}

Номер товара из iiko

Тип: Тело

Название параметра: fields.PROPERTY_108

Значение параметра: {{source.num}}

Описание товара из iiko

Тип: Тело

Название параметра: fields.PROPERTY_110

Значение параметра: {{source.description}}

Код товара из iiko

Тип: Тело

Название параметра: fields.PROPERTY_112

Значение параметра: {{source.code}}

Цена товара из iiko

Тип: Тело

Название параметра: fields.PROPERTY_114

Значение параметра: {{source.defaultSalePrice}}

Шаг пятый: Запуск

Запускаем.

3. Выгрузка изменения товаров из Битрикс24 в iiko

Шаг первый: Откуда

Указываем событие обновления товаров в Битрикс24.

Шаг второй: Инструменты

• Проверяем что это товар из iiko

Используем инструмент Проверка в поле source.PROPERTY_106.value.

Условие - Не пустое значение, Действие - Продолжить, если проверка пройдена.

• Получили товар из iiko

Используем API-запрос методом GET с указанием урла /v2/entities/products/list?ids={{source.PROPERTY_106.value}}.

• Изменили товар в iiko

Используем API-запрос методом POST. URL = /v2/entities/products/update.

Тело запроса:

{

"id": "{{step4.0.id}}",

"deleted": "{{step4.0.deleted}}",

"name": "{{source.NAME}}",

"description": "{{source.DESCRIPTION}}",

"num": "{{step4.0.num}}",

"code": "{{step4.0.code}}",

"parent": "{{step4.0.parent}}",

"accountingCategory": "{{step4.0.accountingCategory}}",

"mainUnit": "{{step4.0.mainUnit}}",

"defaultSalePrice": "{{source.PRICE}}",

"defaultIncludedInMenu": "{{step4.0.defaultIncludedInMenu}}",

"unitWeight": "{{step4.0.unitWeight}}",

"unitCapacity": "{{step4.0.unitCapacity}}",

"type": "{{step4.0.type}}"

}

• Прерываем интеграцию

Используем инструмент Проверка в поле source.odifhgoujfdhgjikfdhlg. Условие - Существует, Действие - Продолжить, если проверка пройдена.

Шаг третий: Куда

Обновляем товар в iiko.

Шаг четвертый: Сопоставление данных

Сопоставляем данные товаров в каталоге Битрикс24 и iiko.

Шаг пятый: Запуск

Запускаем.

4. Итог

Теперь процесс синхронизации стал простым и прозрачным.

Сначала все товары из iiko автоматически загружаются в Битрикс24.

Затем банкетные заказы легко передаются в смарт-процессы для дальнейшего анализа и отчётности.

Интеграция настроена так, чтобы отдел продаж и кухня работали синхронно, без потерь данных и ручных действий.

Что особенно приятно — настройка взаимодействия с iiko выполнена без программирования, с помощью конструктора Пинкитбилдер.

Всё реализовано быстро, удобно и масштабируемо.

Готовый шаблон интеграции уже доступен для скачивания — просто переходите по ссылке и внедряйте решение под ваш бизнес.

Если у вас есть вопросы, пишите нам в Телеграм или WhatsApp, расскажите о вашем бизнес-сценарии, и наши инженеры помогут настроить интеграцию без ручного труда и разработки.

Если вам нужна интеграция с сервисом, которого в Пинкит нет, или приватное событие/действие, через Пинкитбилдер вы можете самостоятельно настроить авторизацию, необходимые события и действия без разработки с ограниченным доступом к ним.

Подберите свой шаблон интеграции без регистрации здесь.

Алексей Окара,
продакт-менеджер Пинкит