Найти в Дзене

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

Для бизнеса, связанного с выездными мероприятиями, синхронизация данных между Iiko и Битрикс24 — это ключ к упрощению процессов между кухней и отделом продаж. В этой статье мы расскажем, как настроить бесшовную интеграцию для передачи товаров и банкетов из Iiko в смарт-процессы Битрикс24 и в обратную сторону из Битрикс24 в iiko, чтобы обеспечить актуальность данных и точную аналитику. Наш клиент занимается организацией выездных мероприятий. Заказы на банкеты обрабатываются менеджерами в сделках Битрикс24, а кухня и логистика мероприятий управляются через платформу iiko. В Iiko банкет формируется на основе резерва и включает карточку гостя, выбранные блюда, столик, официанта, дату, время и другие данные. Клиент хотел передавать данные о банкетах из iiko в смарт-процессы Битрикс24 для дальнейшего анализа. Однако банкеты содержат блюда, которые в iiko хранятся как товары. В Битрикс24 каталог товаров отсутствовал, что делало передачу банкетов невозможной без предварительной синхронизации.
Оглавление

Для бизнеса, связанного с выездными мероприятиями, синхронизация данных между Iiko и Битрикс24 — это ключ к упрощению процессов между кухней и отделом продаж. В этой статье мы расскажем, как настроить бесшовную интеграцию для передачи товаров и банкетов из Iiko в смарт-процессы Битрикс24 и в обратную сторону из Битрикс24 в iiko, чтобы обеспечить актуальность данных и точную аналитику.

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

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

В Iiko банкет формируется на основе резерва и включает карточку гостя, выбранные блюда, столик, официанта, дату, время и другие данные.

-2

Проблема

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

Дополнительная сложность заключалась в том, что:

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

Решение

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

Стоимость товаров, у которых в iiko не указана цена, менеджеры по продажам должны указать в Битрикс24.

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

Чтобы поддерживать актуальность цен, мы добавили еще одну интеграцию, которая обновляет товары в iiko при их изменении в Битрикс24 (а именно - обновление цены).

Пока не будут синхронизированы товары, банкеты не будут синхронизироваться.

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

Резюмируем техническое решение

1.1. Нужно настроить интеграцию, которая скопирует все товары из iiko и добавит их в Битрикс24 с информацией из полей (iiko – Битрикс24):

– id товара из iiko – одноименное поле в Битрикс24.

– Name – наименование товара.

– Description – описание товара Num – номер товара из iiko.

– Code – код товара из iiko.

– Price – предполагаемая цена покупки из iiko.

1.2. Будет добавлена интеграция, которая будет отслеживать изменения товаров в Битрикс24 и обновлять соответствующий товар в iiko по полям:

– Name – наименование товара.

– Description – описание товара.

– Price – предполагаемая цена покупки из iiko.

Готовые шаблоны данных интеграций вы можете установить здесь.

-3

Далее покажем пример настройки.

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

2.1. Шаг 1: Откуда

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

-4

2.2. Шаг 2: Инструменты

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

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

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

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

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

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

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

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

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

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

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

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

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

{
"fields": {
"name": "{{step5.0.name}}",
"iblockId": 14
}
}
-10
  • Сохранили сопоставление

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

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

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

-12

2.3. Шаг 3: Куда

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

-13

2.4. Шаг 4: Сопоставление данных

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

Название - {{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}}
-14
-15

2.5. Шаг 5: Запуск

Запускаем.

-16

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

3.1. Шаг 1: Откуда

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

-17

3.2. Шаг 2: Инструменты

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

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

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

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

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

-19
  • Изменили товар в 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}}"
}
-20
  • Прерываем интеграцию

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

-21

3.3. Шаг 3: Куда

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

-22

3.4. Шаг 4: Сопоставление данных

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

-23

3.5. Шаг 5: Запуск

Запускаем.

-24

4. Итог

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

Готовый шаблон интеграции вы можете скачать по ссылке.

-25

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

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

#пинол #пинкит #pinall #pinkit #bitrix24 #битрикс24 #amo #amocrm #амо #амоцрм #crm #црм #црмсистема #црм_система #внедрениецрм #интеграция #миграция #обмен  #пинкитбилдер #Пинкит_битрикс24_битрикс24