> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://dots.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Вивантаження замовлень у POS-систему iiko

Dots Platform дозволяє автоматично вивантажувати замовлення до iiko. Для цього необхідно налаштувати [інтеграцію кожної окремої точки видачі](https://dots.crisp.help/uk/article/20-panel-keruvannya-redaguvannya-zakladu-redaguvannya-adresi-pos-iiko-1vtknkq/). Крім того, необхідно налаштувати зовнішні ідентифікатори товарів та їх модифікаторів, а також налаштувати ідентичні акції на обох платформах.


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

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

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

![](https://storage.crisp.chat/users/helpdesk/website/3c7680cb850c3200/image_jeipf5.png)

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

[![](https://storage.crisp.chat/users/helpdesk/website/7bd068f578610000/a87063a3-b02a-42d3-97b8-f1908a_d19w1i.png)](https://downloads.intercomcdn.com/i/o/351498390/80b5a510e013d2957974f7aa/image.png)

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

[![](https://storage.crisp.chat/users/helpdesk/website/e439114cb8abb800/e2f8fec6-9140-426c-be60-8bee69_uygj0p.png)](https://dots-platform.intercom-attachments-7.com/i/o/350396665/c3374f774645e545b3160989/IudZLY6l2pGBgyA0Rp66vW5fCkvCKzRd6Fg6YA34kVAPPVDJQnUrqXIqMFp_ldAGbzdk5cL5fAs186petdbmvGIlh2_AaEvpjMRGW-v56eFE09FrGtK-AKHoGvNIn35TMgalw29Z)

[![](https://storage.crisp.chat/users/helpdesk/website/52bf4dbdf3ad4400/c8621d30-b2b2-435b-b844-9fbb81_132olhy.png)](https://dots-platform.intercom-attachments-7.com/i/o/350396671/59312a96804582e89a5c6f98/e7kNGLBlrZJqSaO-E3Y5FmmrchsoFK6rjOqc3aj_rST2kGeQJwCitaBumYxadaPAnR91WKzwuC_t1gAAq1eZ3USyCA4SMaEX_zV8wKkNJnfq51aWEQ_44K6JPnJM3Wo_IfBvyNfh)

### Дані, що відправляються в 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 зробіть наступне:
1.  Авторизуйтесь у Панель Моніторингу.    
2.  Знайдіть замовлення, яке не вивантажилося.    
3.  Натисніть кнопку POS та та переконайтесь про успішність операції.
    
    [![](https://storage.crisp.chat/users/helpdesk/website/1301c7a367140500/a7e22708-5615-477f-a625-cd5689_dp48tw.png)](https://downloads.intercomcdn.com/i/o/693643341/924537fdd3e5c1f764f729a4/POS.png)
    
    [![](https://storage.crisp.chat/users/helpdesk/website/c17cdf5807c98800/a62f4476-3075-406b-aa3a-cd99b2_n4fgqp.png)](https://downloads.intercomcdn.com/i/o/693643801/f39864a43d79933ea1a6cc74/POS+3.png)
    
    У разі відображення помилки інтеграція працює некоректно. Можливими причинами можуть бути:
    
## Проблеми з налаштуваннями інтеграції
*   Якщо в історії дій відображається помилка, в якій вказано “orderRequest.order.items[1].id”, це означає, що зовнішній ідентифікатор другого товару (нумерація в запиті начитується з 0) у замовленні неправильно. Переконайтеся, що ідентифікатор товару в iiko та зовнішній ID товару Dots Platform не відрізняються.
    
[![](https://storage.crisp.chat/users/helpdesk/website/1e9543f9fab37d00/baeba9cd-bbc1-45af-a374-5815ce_1h0agp8.png)](https://dots-platform.intercom-attachments-7.com/i/o/350396653/1d07dc954a4dacba530dfb41/obbr5vPMO8nQl7Z2WzLxEM6duNU7Y2kQJYPSP1kg9gDYrQ-IAFR6X0hO0mFHWO4AXw6MK0UdsV2K65595rqOIJXlHVZNXtJuR8k1ff7Vi-bGtePnkSHnn0o2rueYNRqdIQnQAQfH)

*   Некоректно підключена інтеграція з iiko у налаштуваннях точки видачі. У цьому випадку необхідно оновити [налаштування інтеграції](https://dots.crisp.help/uk/article/20-panel-keruvannya-redaguvannya-zakladu-redaguvannya-adresi-pos-iiko-1vtknkq/).
 
![](https://storage.crisp.chat/users/helpdesk/website/3c7680cb850c3200/image_45f2jz.png)

*   Текст помилки містить “response”: “DeliveryOrderItems: Items collections is empty”. Це означає, що у запиті не вказано зовнішніх ID товарів у замовленні. У такому разі необхідно перевірити правильність зазначених ідентифікаторів у [налаштуваннях товарів](https://dots.crisp.help/uk/article/20-panel-keruvannya-redaguvannya-zakladu-katalog-stvorennyaredaguvannya-tovaru-zagalni-1ty75ol/).

[![](https://storage.crisp.chat/users/helpdesk/website/d8f06d0be1ffe000/3900764b-6a3c-4749-bbf2-85f598_gieb5l.png)](https://dots-platform.intercom-attachments-7.com/i/o/350396657/784ac38cee0302b55814d424/YcJ0V1igvB6x4oaG1pnZLBE7SjkB3meBEHyrYNWVapVHXJzzJfHC9AecBQFiiE4mz-vnct8yM8_0ISkn-cgj_ipchf5xkINDjL581Oe3BJXH0k_gL_WCPhH0B9oCbIYRIf3nR5Cu)

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

[![](https://storage.crisp.chat/users/helpdesk/website/a3f4485ed61f8000/4554dcd5-d058-476c-9e6c-6cea7e_1fwy27t.png)](https://dots-platform.intercom-attachments-7.com/i/o/350396661/e142ab8afe2c36517d42c8aa/eJAPCQB-QhzEw0eml4jHOiMY9Aa8KsbWOMf3qiuAYbW6wHPkgWAW5T5KqjAWHuuPdXX5CB1LK1wEqK2a2kTIRSbytwfSU-5SnBOVgl3V6JZa2YU2R6RuOcNVRs5pWTFNOnkKkyrm)

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

### При прийомі замовлень у Панелі Моніторингу вони автоматично не вивантажуються в термінал iiko.
Замовлення будуть вивантажуватись автоматично тільки при прийомі в Dots Business. Крім того, для цього необхідно увімкнути опцію ** ["Автосинхронізація при прийомі замовлення"](https://dots.crisp.help/uk/article/20-panel-keruvannya-redaguvannya-zakladu-redaguvannya-adresi-pos-iiko-1vtknkq/) **.

### Як вивантажити архів замовлень у 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, необхідно також додати ці товари в [меню компанії](https://dots.crisp.help/uk/article/20-panel-keruvannya-redaguvannya-zakladu-katalog-tovari-1sqgtzn/?bust=1710674734594). Після цього необхідно скопіювати зовнішні 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/](http://json.parser.online.fr/) і вставте отримані дані для їх коректного відображення.
TerminalID необхідно вказати для кожної точки видачі, де налаштовано інтеграцію з iiko.

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

Посилання на цю статтю: [тут.](https://dots.crisp.help/uk/article/20-vivantazhennya-zamovlen-u-pos-sistemu-iiko-syrve-1yc778d/)