Оплата рахунку і закриття замовлення
Повідомлення для фіскалізації
Відповідь
Відповідь обробки операції необхідно надіслати в наступному вигляді:
Ідентифікатор ресторану
Підпис запиту
Ідентифікатор рахунку у ресторані
Номер замовлення
235
Ідентифікатор запиту в системі Shake To Pay
2021-04-01 09:39:06.021078#BpOI0gO
Деталірування проблеми, що виникла
Результат виконання оплати
SUCCESS
Possible values: substate
Ім'я (ПІБ) офіціанта
Петро
Ідентифікатор офіціанта
f14da21a-5be9-4736-9ece-420bd310bc8a
POST /callback/payBill HTTP/1.1
Host: api.shaketopay.com.ua
restoId: text
signature: text
Content-Type: application/json
Accept: */*
Content-Length: 545
{
"billId": "text",
"guests": [
{
"dishes": [
{
"category": "Кухня",
"categoryId": "18afdzgu53a",
"checkNumber": "text",
"count": 1.3,
"dishId": "text",
"linkedTo": "text",
"name": "Шаурма царська",
"orderNumber": 12365,
"positionId": "text",
"sum": 34.56,
"taxCategory": "налоги",
"taxCategoryId": "18afdzgu534",
"type": "modifier"
}
],
"name": "Гость 1"
}
],
"orderNumber": 235,
"rID": "2021-04-01 09:39:06.021078#BpOI0gO",
"stackTraceMessage": "text",
"state": "SUCCESS",
"substate": "text",
"waiter": "Петро",
"waiterId": "f14da21a-5be9-4736-9ece-420bd310bc8a"
}
No content
Результатом закриття замовлення у POS-системі можуть бути 2 статуси - FAIL та SUCCESS. Для статусу FAIL існують суб-статуси, які дозволяють правильно комунікувати проблему співробітникам закладу.
Важливим є реалізація усіх підстатусів, тому як Expirenza має знати у якому суб-статусі знаходиться замовлення, а ресторан має знати що саме пішло не так.
Якщо наведені вище сценарії не покривають всіх потреб вашої інтеграції, будь ласка, зверніться до аккаунт-менеджера ресторану з детальним описом потреби вашої інтеграції.
Ми розглянемо можливість додавання додаткового суб-статусу в Expirenza API.
Підстатуси FAIL
WRONG_REQUEST_SUM
Description:
Сума, що прийшла у запиті для оплати, більша або менша від суми замовлення в POS-системі.
Така ситуація може виникнути, якщо замовлення було відредаговано у проміжку між отриманням оплати від гостя та закриттям замовлення у POS-системі.
Обробка substate:
Система спише оплату з гостя та покаже повідомлення “Оплата успішна”;.
Система надішле персоналу повідомлення в бот з рекомендацією повернути замовлення у початковий стан (скасувати зміни), щоб розблокувати закриття замовлення, або повернути оплату гостю та попросити оплатити заново.
Система повторюватиме спроби закрити замовлення з певним інтервалом.
CASHIERS_SHIFT_CLOSED
Description:
Неможливо закрити замовлення через те, що в POS-системі закрита касова зміна.
Обробка substate:
Система спише оплату з гостя та покаже повідомлення “Оплата успішна”.
Система відправить персоналу повідомлення у бот з рекомендацією відкрити касову зміну, щоб розблокувати закриття замовлення у POS-системі.
Система повторюватиме спроби закрити замовлення з певним інтервалом.
PRINTER_ERROR
Description:
Неможливо закрити замовлення через проблему з фіскальним принтером.
Обробка substate:
Система спише оплату з гостя та покаже повідомлення "Оплата успішна".
Система надішле персоналу повідомлення у бот з рекомендацією виправити проблему з фіскальним принтером, щоб розблокувати закриття замовлення у POS-системі.
Система повторюватиме спроби закрити замовлення з певним інтервалом.
CLOSE_ORDER_BLOCKED
Description:
Закриття замовлення заблоковано відкладеною подачею страв.
Наприклад: У замовленні є нероздрукований “бігунок” на кухню або бар.
Обробка substate:
Система спише оплату з гостя та покаже повідомлення “Оплата успішна”.
Система надішле персоналу повідомлення в бот з рекомендацією видалити бігунки або передати на кухню нероздруковані “бігунки”, щоб розблокувати закриття замовлення у POS-системі.
Система повторюватиме спроби закрити замовлення з певним інтервалом.
BILL_IN_USE
Description:
Замовлення заблоковане іншим модулем POS-системи.
Наприклад:На даний час замовлення відкрито на касовій станції та редагується офіціантом.
Обробка substate:
Система спише оплату з гостя та покаже повідомлення "Оплата успішна".
Система відправить персоналу повідомлення у бот з рекомендацією вийти з режиму редагування замовелння на робочій станції, щоб розблокувати закриття замовлення у POS-системі.
Система повторюватиме спроби закрити замовлення з певним інтервалом.
OTHER_ERROR
Description:
Інші помилки під час закриття замовлення.
Обробка суб-статусу:
Система спише оплату з гостя та покаже повідомлення “Оплата успішна”.
Система надішле персоналу повідомлення у бот з рекомендацією звернутися до служби підтримки постачальника POS-системи для закриття замовлення.
Система не робитиме повторних спроб закрити таке замовлення, а здійснить виплату ресторану за даними замовелння отриманими перед оплатою.
Last updated