Изменения

Перейти к навигации Перейти к поиску

API Orders

203 байта добавлено, 09:09, 27 октября 2024
==Методы==
===Получение списка заказов===
GET /v1/orders
===Получение списка заказов в зависимости от статуса заказа===
GET /v1/orders?status= 
===Изменение и корректировка заказа поставщиком===
PUT /orders/{id}
===Получение списка заказов в зависимости от статуса заказа===
Для того чтобы получить список заказов имеющих определенный статус необходимо отправить GET-запрос c пустым телом по URL: https://food.smartsatu.com/api/v1/orders. В строке запроса необходимо добавить параметр статуса и его значение (?status=1). В итоге получаем запрос вида: https://food.smartsatu.com/api/v1/orders?status=31. В headers запроса обязательно должна передаваться страна пользователя, а также и уникальный токен авторизации, который был получен при входе в систему. Ответом от сервера будет являться массив данных со списком всех ваших заказов поставщика в указанном статусе, а также их данными.
Также возможно получение списка заказов, начиная за период от определенного времени, указав нужную дату и время указанного в '''GET-параметр параметре "updated_from", до времени выполнения запроса: "updated_from=2019-11-27T07:03:01"'''.
''Пример: https://food.smartsatu.com/api/v1/orders?status=7&updated_from=2019-11-27T07:03:01''
Перечень статусов заказа:
|-
| style="font-weight:bold;" | status=10
| Выполнен с корректировкой - <small>заказ в статусах "Подтвержден"/"Принят" доставлен в Торговую точку: ТТ , которая приняла не все товары (изменила количество) и подтвердила доставку</small>
|}
Если заказ должен быть изменен, то запрос должен содержать параметры '''offer_id''' и '''quantity'''.
<span style="color:#FFFFFF; background:#FF3333">Внимание: offer_id на самом деле является параметром id в order_items, а не offer_id - идентификатор предложения. :</span> [[Файл:Offer id.jpg||350px|offer_id для корректировки заказа]]
Если были переданы не все товарные позиции из order_items, то отсутствующие позиции будут удалены системой из заказа.
{
"status": 2,
"supplierStatus": "Заказ принят в обработкубез изменений",
}
| < items> array
| 4
|-
| style="font-weight:bold;" | delivery_date
| Дата доставки (строкой DD.MM.YYYY)
| string
| 09.10.2019
|-
| style="font-weight:bold;" | status
| integer($int64)
| 4
|-
| style="font-weight:bold;" | delivery_date
| Дата доставки (строкой DD.MM.YYYY)
| string
| 09.10.2019
|-
| style="font-weight:bold;" | offer_id
Пример запроса:
{
"comment": "Вот такой комментарий Изменена дата доставки и количество товара", "delivery_date": "09.10.2019",
"items":
[
{
"quantity": 50, "delivery_date": "09.10.2019", "offer_id": 4166524 }
],
"status": 4
}
===Response Orders Items===
'''Items'''
{| class="wikitable"
| style="font-weight:bold;" | sum
| Общая сумма заказа
| integerdecimal| 11340.00
|-
| style="font-weight:bold;" | comments
| Комментарий к заказу
| stringarray
| Ок
|-
|-
| style="font-weight:bold;" | order_items
| Массивarray
| < order_items > array
|
|-
| style="font-weight:bold;" | Supplier_company_namesupplier_company_name
| Название поставщика
| string
|-
| style="font-weight:bold;" | store_company
| Массивarray
| < store_company > array
|
|-
| style="font-weight:bold;" | service_fee_amount
| Сумма сервисного сбора
| decimal
| 300.00
|}
'''Order Items'''
|-
| style="font-weight:bold;" | images
| Массивarray
| < images > array
|

Навигация