API Delivery Intervals: различия между версиями
User (обсуждение | вклад) |
|||
| (не показаны 3 промежуточные версии этого же участника) | |||
| Строка 4: | Строка 4: | ||
POST /api/delivery-intervals?store_id=9576&start=1&end=1 | POST /api/delivery-intervals?store_id=9576&start=1&end=1 | ||
| − | где | + | где |
'''store_id''' — идентификатор торговой точки в SmartSatu | '''store_id''' — идентификатор торговой точки в SmartSatu | ||
| − | '''start=1''' и '''end=1''' — идентификаторы начала и конца очереди (используется по аналогии с загрузкой предложений при количестве записей более 500) | + | '''start=1''' и '''end=1''' — идентификаторы начала и конца очереди (используется по аналогии с [[API Offers|загрузкой предложений]] при количестве записей более 500) |
Тело запроса содержит: | Тело запроса содержит: | ||
| Строка 122: | Строка 122: | ||
|- | |- | ||
| style="font-weight:bold;" | delivery_date_interval_from | | style="font-weight:bold;" | delivery_date_interval_from | ||
| − | | начало интервала, скорректированного поставщиком | + | | начало интервала, скорректированного поставщиком |
| − | | | + | передается местное время поставщика с указанием часового пояса |
| − | | | + | | string |
| + | | 2021-05-30T15:35+03 | ||
|- | |- | ||
| style="font-weight:bold;" | delivery_date_interval_to | | style="font-weight:bold;" | delivery_date_interval_to | ||
| − | | конец интервала, скорректированного поставщиком | + | | конец интервала, скорректированного поставщиком |
| − | | | + | передается местное время поставщика с указанием часового пояса |
| − | | | + | | string |
| + | | 2021-05-30T16:30+03 | ||
|} | |} | ||
Текущая версия на 23:17, 26 июля 2021
Содержание
Загрузка интервалов доставки
Загрузка интервалов доставки в систему 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 | начало интервала, скорректированного поставщиком
передается местное время поставщика с указанием часового пояса |
string | 2021-05-30T15:35+03 |
| delivery_date_interval_to | конец интервала, скорректированного поставщиком
передается местное время поставщика с указанием часового пояса |
string | 2021-05-30T16:30+03 |