1612
правок
Изменения
Перейти к навигации
Перейти к поиску
Новая страница: «===Загрузка интервалов доставки=== Загрузка интервалов доставки в систему Smart Satu производ...»
===Загрузка интервалов доставки===
Загрузка интервалов доставки в систему 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"
},
{
…
}
]
{| class="wikitable"
! style="font-weight:bold;" | Name
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Schema
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | is_default
| интервал «по-умолчанию»; при загрузке нескольких дефолтных значений, торговой точке подставляется самый ранний,
а по истечению его времени — следующий
| integer
| 0 или 1
|-
| style="font-weight:bold;" | datetime_delivery_interval_from
| начало интервала, передается местное время поставщика с указанием часового пояса
| string
| 2021-09-18T14:30+03
|-
| style="font-weight:bold;" | datetime_delivery_interval_to
| конец интервала, передается местное время поставщика с указанием часового пояса
| string
| 2021-09-18T15:30+03
|-
| style="font-weight:bold;" | 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",
...
{| class="wikitable"
! style="font-weight:bold;" | Name
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Schema
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | initial_delivery_date_interval_from
| начало интервала, выбранного торговой точкой (UTC)
| integer
| 1622365200
|-
| style="font-weight:bold;" | initial_delivery_date_interval_to
| конец интервала, выбранного торговой точкой (UTC)
| integer
| 1622642400
|-
| style="font-weight:bold;" | delivery_date_interval_from
| начало интервала, скорректированного поставщиком (UTC)
| integer
| 1622365200
|-
| style="font-weight:bold;" | 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"
}
{| class="wikitable"
! style="font-weight:bold;" | Name
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Schema
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | status
| статус заказа "Принят с корректировкой": заказы, измененные поставщиком (наличие, количество, дата доставки)
| integer
| 4
|-
| style="font-weight:bold;" | delivery_date_interval_from
| начало интервала, скорректированного поставщиком (UTC)
| integer
| 1622365200
|-
| style="font-weight:bold;" | delivery_date_interval_to
| конец интервала, скорректированного поставщиком (UTC)
| integer
| 1622376000
|}
Загрузка интервалов доставки в систему 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"
},
{
…
}
]
{| class="wikitable"
! style="font-weight:bold;" | Name
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Schema
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | is_default
| интервал «по-умолчанию»; при загрузке нескольких дефолтных значений, торговой точке подставляется самый ранний,
а по истечению его времени — следующий
| integer
| 0 или 1
|-
| style="font-weight:bold;" | datetime_delivery_interval_from
| начало интервала, передается местное время поставщика с указанием часового пояса
| string
| 2021-09-18T14:30+03
|-
| style="font-weight:bold;" | datetime_delivery_interval_to
| конец интервала, передается местное время поставщика с указанием часового пояса
| string
| 2021-09-18T15:30+03
|-
| style="font-weight:bold;" | 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",
...
{| class="wikitable"
! style="font-weight:bold;" | Name
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Schema
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | initial_delivery_date_interval_from
| начало интервала, выбранного торговой точкой (UTC)
| integer
| 1622365200
|-
| style="font-weight:bold;" | initial_delivery_date_interval_to
| конец интервала, выбранного торговой точкой (UTC)
| integer
| 1622642400
|-
| style="font-weight:bold;" | delivery_date_interval_from
| начало интервала, скорректированного поставщиком (UTC)
| integer
| 1622365200
|-
| style="font-weight:bold;" | 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"
}
{| class="wikitable"
! style="font-weight:bold;" | Name
! style="font-weight:bold;" | Description
! style="font-weight:bold;" | Schema
! style="font-weight:bold;" | Example
|-
| style="font-weight:bold;" | status
| статус заказа "Принят с корректировкой": заказы, измененные поставщиком (наличие, количество, дата доставки)
| integer
| 4
|-
| style="font-weight:bold;" | delivery_date_interval_from
| начало интервала, скорректированного поставщиком (UTC)
| integer
| 1622365200
|-
| style="font-weight:bold;" | delivery_date_interval_to
| конец интервала, скорректированного поставщиком (UTC)
| integer
| 1622376000
|}
