external:доставка:api:extv2

Различия

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

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
external:доставка:api:extv2 [2022/01/26 11:19] Александр Ильинexternal:доставка:api:extv2 [2022/10/20 14:40] (текущий) – Добавил описание данных в callback_url Данила Матюшев
Строка 34: Строка 34:
 Необязательные поля могут быть безболезненно исключены из запроса. Необязательные поля могут быть безболезненно исключены из запроса.
 ===== Список доступных функций ===== ===== Список доступных функций =====
-/ping  +[[external:доставка:api:extv2#проверка_соединения|/ping]] - проверка соединения  
-/getmenu +[[external:доставка:api:extv2#получение_меню|/getmenu]] - получение меню 
-/validate +[[external:доставка:api:extv2#валидация_корзины|/validate]] - проверка возможности создания заказа 
-/postorder +[[external:доставка:api:extv2#создание_заказа|/postorder]] - создание заказ 
-/expressorders+[[external:доставка:api:extv2#получение_статуса_заказа|/orderstate]] - Получение статуса заказа 
 +[[external:доставка:api:extv2#получение_списка_активных_заказов|/expressorders]] - Получение списка заказов 
  
 ===== Проверка соединения ===== ===== Проверка соединения =====
Строка 307: Строка 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**\\ **введено с версии 3.0.5.1053**\\
 **order.content** - (array) Список блюд, заказанных гостем. **order.content** - (array) Список блюд, заказанных гостем.
Строка 376: Строка 386:
  
 Расшифровка статусов заказов:\\ Расшифровка статусов заказов:\\
-  * 0 - "Ожидает" - Такой статус имеют заказы только что созданные через API \\ Они еще не обработаны оператором в ресторане. \\ Заказы в статусе 0 не возвращают содержимое (массив items) +  * 0 - "Ожидает" - Такой статус имеют заказы только что созданные через API \\ Они еще не обработаны оператором в ресторане (в кипере заказа еще нет). \\ Заказы в статусе 0 не возвращают содержимое (массив items) 
-  * 1Х - "В работе" - Заказ обработан в заведении и передан на кухню. +  * 1Х - "В работе" - Заказ обработан в заведении и передан на кухню (заказ принят, в кипере создан стол, прошла сервис печать)
-  * 2Х - "В пути" - Заказ отправлен с курьером +  * 2Х - "В пути" - Заказ отправлен с курьером (в кипере выбит пречек или чек) 
-  * 3Х - "В архиве" - Курьер вернулся в ресторан, заказ полностью завершен +  * 3Х - "В архиве" - Курьер вернулся в ресторан, заказ полностью завершен (ручной статус, никак не связан с кипером) 
-  * 4Х - "Отменен" - Работники ресторана отменили заказ по той или иной причине+  * 4Х - "Отменен" - Работники ресторана отменили заказ по той или иной причине. Переход в этот статус возможен как из статуса 0 (т.е. заказ в кипере не создавался даже), так и из любого другого статуса (т.е. в кипере стол с блюдами был создан, потом все блюда удалены и пустой стол закрыт)
  
 ===== Получение списка активных заказов ===== ===== Получение списка активных заказов =====
Строка 431: Строка 441:
 **phone** - Телефон гостя\\ **phone** - Телефон гостя\\
 **fullname** - ФИО гостя\\ **fullname** - ФИО гостя\\
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
- 
  • external/доставка/api/extv2.1643185150.txt.gz
  • Последнее изменение: 2022/01/26 11:19
  • Александр Ильин