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

Зміст

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

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

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

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

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

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

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

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

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

undefined {"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 зробіть наступне:

1. Авторизуйтесь у Панель Моніторингу.
2. Знайдіть замовлення, яке не вивантажилося.
3. Натисніть кнопку 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/10/2024