Dots Platform дозволяє автоматично вивантажувати замовлення до iiko. Для цього необхідно налаштувати інтеграцію кожної окремої точки видачі. Крім того, необхідно налаштувати зовнішні ідентифікатори товарів та їх модифікаторів, а також налаштувати ідентичні акції на обох платформах.

Зміст

Прийом замовлення
Відображення замовлення в терміналі iiko
Проблеми та можливі рішення
Поширені запитання

Прийом замовлення

Залежно від налаштувань синхронізації замовлення можуть передаватися в термінал iiko вручну або автоматично.

Якщо авто-синхронізація увімкнена, замовлення буде вивантажено в термінал iiko відразу після його прийому в додатку Dots Business.



При ручному прийомі замовлення необхідно тапнути на іконку трикутника для відкриття деталей замовлення. Потім у картці замовлення, що відкрилася, потрібно тапнути Вивантажити в iiko і підтвердити дію. Після цього інформація на замовлення буде синхронізована з терміналом iiko.

Відображення замовлення в терміналі iiko

Дані, що відправляються в iiko при розвантаженні замовлення:

Номер замовлення
Тип отримання замовлення (самовивіз, доставка тощо)
Час видачі замовлення кур'єру/клієнту
Ім'я клієнта
Номер телефону клієнта
Коментар до замовлення
Кількість осіб
Склад замовлення (кількість товарів (страв), їх вартість та модифікатори)
Сума замовлення без урахування вартості доставки
Спосіб оплати

Приклад тіла запиту, який надсилається в термінал iiko

{"organization":"e3620000-7b0f-0696-8dcc-08d8cf49a917","customer":{"name":"TEST","phone":"380935928671"},"order":{"id":"","externalId":3359,"date":"2021-02-17 15:22:40","items":[{"id":"efea1912-85f0-4f32-bb0c-8eb0fe4eb05f","name":"Піца \"Грибна з куркою\" максі","amount":1,"sum":208.0,"modifiers":[]},{"id":"26","name":"Піца \"4 сира\"","amount":1,"sum":68.0,"modifiers":[]}],"phone":"380935928671","comment":"Номер заказа: 046-90400 | Доставка до дома: Проспект миру, 23, кв. 2 | Количество персон: 1","fullSum":299.0,"address":{"city":"Чернігів","street":"Проспект миру","home":"23","apartment":"2"},"number":"046-90400","isSelfService":"true"}}

Примітка: Інтеграція з iiko є односторонньою. У момент, коли точка видачі приймає замовлення, відбувається автоматичне надсилання інформації в iiko. Після цього вся робота із замовленням відбувається у терміналі iiko. Якщо після прийому замовлення компанією, у ньому здійснюються будь-які зміни, їх необхідно вносити в iiko, щоб дані не відрізнялися.

Проблеми та можливі рішення

При виникненні проблеми з розвантаженням замовлень у iiko зробіть наступне:
Авторизуйтесь у Панель Моніторингу.
Знайдіть замовлення, яке не вивантажилося.
Натисніть кнопку POS та та переконайтесь про успішність операції.





У разі відображення помилки інтеграція працює некоректно. Можливими причинами можуть бути:

Проблеми з налаштуваннями інтеграції

Якщо в історії дій відображається помилка, в якій вказано “orderRequest.order.items[1].id”, це означає, що зовнішній ідентифікатор другого товару (нумерація в запиті начитується з 0) у замовленні неправильно. Переконайтеся, що ідентифікатор товару в iiko та зовнішній ID товару Dots Platform не відрізняються.



Некоректно підключена інтеграція з iiko у налаштуваннях точки видачі. У цьому випадку необхідно оновити налаштування інтеграції.



Текст помилки містить “response”: “DeliveryOrderItems: Items collections is empty”. Це означає, що у запиті не вказано зовнішніх ID товарів у замовленні. У такому разі необхідно перевірити правильність зазначених ідентифікаторів у налаштуваннях товарів.

Проблема на стороні сервісу iiko

Ця проблема може стосуватися обладнання та серверів, які використовує компанія, а також безпосередньо сервісів iiko. У цьому випадку необхідно звернутися до служби підтримки iiko із зазначенням тексту помилки.
Приклад
Якщо в тексті помилки вказано “response”: “RfbbitMq queue is not found”, вам необхідно звернутися до служби підтримки iiko і попросити перезавантажити чергу.

Поширені запитання

При прийомі замовлень у Панелі Моніторингу вони автоматично не вивантажуються в термінал iiko.

Замовлення будуть вивантажуватись автоматично тільки при прийомі в Dots Business. Крім того, для цього необхідно увімкнути опцію "Автосинхронізація при прийомі замовлення" .

Як вивантажити архів замовлень у iiko?

Можливість передавати замовлення з архіву Панелі Моніторингу до POS-системи iiko не передбачена функціоналом платформи.

Якщо ми включимо інтеграцію з iiko, чи є можливість втратити дані на замовлення в Dots?

При включенні інтеграції з iiko замовлення не пропадають з нашої платформи. Крім того, інтеграція працює тільки з замовленнями, що надходять, і не зачіпає налаштувань системи.

Які можливості інтеграції з iiko доступні на даний момент? Як надходять замовлення?

При налаштованій інтеграції замовлення з Dots можуть автоматично або вручну передаватися на робочий термінал iiko. У замовленнях передається інформація про клієнта, яка включає: ім'я, номер телефону та адресу клієнта. Інформація про замовлення відображається в коментарях та включає: номер замовлення в Dots, склад замовлення, тип доставки, застосовані промо-коди та акції. Дані про кур'єра відображаються лише у Dots.

Як передаються замовлення з акціями та знижками?

Якщо замовлення із застосованою акцією оформлено через Dots, то при прийомі замовлення в Dots Business інформація по ньому буде передана в термінал iiko. Якщо аналогічна акція не налаштована в iiko, необхідно буде змінити суму за чеком вручну.

Як передаються модифікатори страви?

При розвантаженні замовлення зовнішні ID модифікаторів будуть автоматично передані в термінал iiko. Необхідно переконатися, що ID модифікаторів у Dots відповідають таким у iiko.

Як синхронізувати меню між iiko у Dots?

Всі товари синхронізуються за допомогою зовнішнього ID. При додаванні нових товарів до iiko, необхідно також додати ці товари в меню компанії. Після цього необхідно скопіювати зовнішні ID товарів з iiko в Панель Управління. Якщо їх не буде додано, то товари не будуть розпізнані при розвантаженні замовлення в термінал.

Чи зміниться сума за чеком у Dots, якщо вона була змінена в терміналі iiko?

Якщо сума за чеком змінилася після вивантаження замовлення в iiko, її необхідно відредагувати вручну.

Чи обов'язково мати iiko delivery ліцензію?

Інтеграція з iiko передбачає використання API iiko delivery. Для роботи з цим API необхідно мати дві ліцензії:
iiko delivery (ліцензія оплачується 1 раз)
API iiko delivery (ліцензія оплачується 1 раз на місяць)

Що вказується в полях iiko ID та Secret у Панелі керування?

У цих полях відображаються дані від ліцензії API iiko delivery.

Чи передається в iiko вартість доставки?

В iiko передається лише сума за чеком без урахування вартості доставки. Для того щоб сума замовлення в Dots і iiko збігалася, необхідно змінити її в iiko, додавши доставку.

Чому всі замовлення вивантажуються в iiko як "Самовівоз"?

Для коректності прийому замовлень необхідно обов'язково передавати адресу клієнта у тому вигляді, який є у довіднику iiko.
Приклад
Якщо у довіднику iiko вказано “вул. Шевченка”, то замовлення з варіантами “Шевченка”, “Шевченка”, “Шевченка”, “Шевченко та ін. будуть відображатися як самовивіз.

Де знайти Terminal ID для iiko?

У налаштуваннях інтеграції необхідно топнути "Отримати список терміналів". Далі перейдіть за посиланням http://json.parser.online.fr/ і вставте отримані дані для їх коректного відображення.
TerminalID необхідно вказати для кожної точки видачі, де налаштовано інтеграцію з iiko.

Якщо у замовлення Dots відбулися зміни, то вони синхронізуються з iiko?

У разі зміни суми за чеком у Dots її також необхідно вручну змінити в Iiko. Якщо замовлення було скасовано, його необхідно скасувати в Iiko.

Посилання на цю статтю: тут.

Оновлено: 10/04/2024