API Delivery Intervals

Загрузка интервалов доставки

Загрузка интервалов доставки в систему Smart Satu производится поочередно для каждой торговой точки. При повторной загрузке интервалов для этой ТТ, предыдущие интервалы удаляются.

POST /api/delivery-intervals?store_id=9576&start=1&end=1

где

store_id — идентификатор торговой точки в SmartSatu

start=1 и end=1 — идентификаторы начала и конца очереди (используется по аналогии с загрузкой предложений при количестве записей более 500)

Тело запроса содержит:

[
   {
      "is_default ": 0, 
      "datetime_delivery_interval_from": "2021-09-18T14:30+03",
      "datetime_delivery_interval_to": "2021-09-18T15:30+03",
      "deadline_processing": "2021-09-17T12:00+03"
   },
   {
      …
   }
]

Name	Description	Schema	Example
is_default	интервал «по-умолчанию»; при загрузке нескольких дефолтных значений, торговой точке подставляется самый ранний, а по истечению его времени — следующий	integer	0 или 1
datetime_delivery_interval_from	начало интервала, передается местное время поставщика с указанием часового пояса	string	2021-09-18T14:30+03
datetime_delivery_interval_to	конец интервала, передается местное время поставщика с указанием часового пояса	string	2021-09-18T15:30+03
deadline_processing	крайнее время использования интервала, по истечении которого интервал становится недоступным к выбору	string	2021-09-17T12:00+03

Удаление интервалов доставки

DELETE /api/delivery-intervals/all

Пустое тело запроса инициирует удаление всех ранее загруженных интервалов.

Для удаления интервалов конкретных торговых точек в тело запроса необходимо добавить параметр store_ids с массивом идентификаторов торговых точек:

{
   "store_ids": [9576, 9856]
}

Интервалы доставки в списке заказов

GET api/orders

API получения заказов расширена путем добавления новых полей (в ответе):

...
"initial_delivery_date_interval_from": 1622635200,
"initial_delivery_date_interval_to": 1622642400,
"delivery_date_interval_from": 1622365200,
"delivery_date_interval_to": " 1622376000",
...

Name	Description	Schema	Example
initial_delivery_date_interval_from	начало интервала, выбранного торговой точкой (UTC)	integer	1622365200
initial_delivery_date_interval_to	конец интервала, выбранного торговой точкой (UTC)	integer	1622642400
delivery_date_interval_from	начало интервала, скорректированного поставщиком (UTC)	integer	1622365200
delivery_date_interval_to	конец интервала, скорректированного поставщиком (UTC)	integer	1622376000

Примечание: При использовании поставщиком интервалов доставки, поля "delivery_date" и "initial_delivery_date" будут содержать пустое значение (null).

Корректировка интервала доставки в заказе

PUT api/orders/{order_id}

В случае корректировки поставщиком интервала доставки в теле запроса указывается новый интервал доставки (местное время поставщика с указанием часового пояса):

{
   "status": "4",
   "delivery_date_interval_from": "2021-05-30T15:35+03",
   "delivery_date_interval_to": "2021-05-30T16:30+03"
}

Name	Description	Schema	Example
status	статус заказа "Принят с корректировкой"	integer	4
delivery_date_interval_from	начало интервала, скорректированного поставщиком (UTC)	integer	1622365200
delivery_date_interval_to	конец интервала, скорректированного поставщиком (UTC)	integer	1622376000