Различия

Показаны различия между двумя версиями страницы.

--- external:доставка:api:extv2 [2022/01/26 11:12] – [Общие положения] Александр Ильин
+++ external:доставка:api:extv2 [2022/10/20 14:40] (текущий) – Добавил описание данных в callback_url Данила Матюшев
@@ Строка 21: / Строка 21: @@
 Базовый URL для запросов: **http://IP:PORT/api/v2/ext/**
 Этот URL можно использовать для проверки работоспособности.
 Если набрать в любом браузере:  http://192.168.1.10:11011/api/v2/ext/  -  при работоспособном настроенном API мы должны получить ответ
@@ Строка 32: / Строка 30: @@
 В данном примере 11011 - порт DeliveryHatch, 192.168.1.10 - IP компьютера с установленным сервером мини-доставки. Аналогично стоит проверять доступность сервиса извне после проброса порта.
-**Важно**\\
+**Важно**
 Не передавайте "нейтральные" значения для необязательных полей в запросах, если нет вещественных данных для этих полей.
 Необязательные поля могут быть безболезненно исключены из запроса.
+===== Список доступных функций =====
+[[external:доставка:api:extv2#проверка_соединения|/ping]] - проверка соединения
+[[external:доставка:api:extv2#получение_меню|/getmenu]] - получение меню
+[[external:доставка:api:extv2#валидация_корзины|/validate]] - проверка возможности создания заказа
+[[external:доставка:api:extv2#создание_заказа|/postorder]] - создание заказ
+[[external:доставка:api:extv2#получение_статуса_заказа|/orderstate]] - Получение статуса заказа
+[[external:доставка:api:extv2#получение_списка_активных_заказов|/expressorders]] - Получение списка заказов
 ===== Проверка соединения =====
@@ Строка 304: / Строка 308: @@
 Запас по времени должен обсуждаться с конкретным заведением.\\
-**(order.status_callback)** - (url string) URL адрес, на который будут отправлены уведомления об изменении статуса заказа. **ВНИМАНИЕ. Внутри доставки адрес приводится к нижнему регистру (HttP://Ya.Ru/Status -> http://ya.ru/status)**\\
+**(order.status_callback)** - (url string) URL адрес, на который будут отправлены уведомления об изменении статуса заказа.\\ **ВНИМАНИЕ. Внутри доставки адрес приводится к нижнему регистру (HttP://Ya.Ru/Status -> http://ya.ru/status)**\\
+При изменении статуса заказа на указанный URL будет отправлен POST запрос со следующим JSON содержимым:
+<code>
+{
+  "order_id": Integer, // Идентификатор заказа
+  "guestmeta": Object, // Метаданные гостя
+  "phone_number": String, // Номер телефона гостя
+  "status": Integer //Новый статус заказа
+}
+</code>
 **введено с версии 3.0.5.1053**\\
 **order.content** - (array) Список блюд, заказанных гостем.
@@ Строка 373: / Строка 386: @@
 Расшифровка статусов заказов:\\
-  * 0 - "Ожидает" - Такой статус имеют заказы только что созданные через API \\ Они еще не обработаны оператором в ресторане. \\ Заказы в статусе 0 не возвращают содержимое (массив items)
+  * 0 - "Ожидает" - Такой статус имеют заказы только что созданные через API \\ Они еще не обработаны оператором в ресторане (в кипере заказа еще нет). \\ Заказы в статусе 0 не возвращают содержимое (массив items)
-  * 1Х - "В работе" - Заказ обработан в заведении и передан на кухню.
+  * 1Х - "В работе" - Заказ обработан в заведении и передан на кухню (заказ принят, в кипере создан стол, прошла сервис печать).
-  * 2Х - "В пути" - Заказ отправлен с курьером
+  * 2Х - "В пути" - Заказ отправлен с курьером (в кипере выбит пречек или чек)
-  * 3Х - "В архиве" - Курьер вернулся в ресторан, заказ полностью завершен
+  * 3Х - "В архиве" - Курьер вернулся в ресторан, заказ полностью завершен (ручной статус, никак не связан с кипером)
-  * 4Х - "Отменен" - Работники ресторана отменили заказ по той или иной причине
+  * 4Х - "Отменен" - Работники ресторана отменили заказ по той или иной причине. Переход в этот статус возможен как из статуса 0 (т.е. заказ в кипере не создавался даже), так и из любого другого статуса (т.е. в кипере стол с блюдами был создан, потом все блюда удалены и пустой стол закрыт)
 ===== Получение списка активных заказов =====
@@ Строка 428: / Строка 441: @@
 **phone** - Телефон гостя\\
 **fullname** - ФИО гостя\\