Prod: https://server.chocodostavka.kz
Dev: https://dev-server.chocodostavka.kz
Сделайте запрос методом POST
по ссылке: {SERVER_HOST}/api-gate/v0/deliveries/orders
Headers:
--header 'Authorization: JWT {Token}' \\
--header 'Content-Type: application/json' \\
Body:
{
"merchant_order_id": 1021,
"extra_info": "Принять оплату 23000тг.",
"city": "Almaty",
"from": {
"address": {
"apartment": "",
"entrance": "",
"floor": "",
"intercom": "",
"street": "Аль-Фараби",
"building": "12Б",
"extra_info": "Заезд со стороны Достык",
"longitude": 76.918615, //необязательное поле
"latitude": 43.201877 //необязательное поле
},
"phone_number": "+77076013399",
"name": "Алишер"
},
"to": {
"address": {
"apartment": "",
"entrance": "",
"floor": "",
"intercom": "",
"street": "проспект Абая",
"building": "18/1 блок 5",
"extra_info": "Заезд со стороны Тлендиева",
"longitude": 76.918700, //необязательное поле
"latitude": 43.201800 //необязательное поле
},
"phone_number": "+77076012246",
"name": "Вася Иванов"
},
"product_name": "iPhone XR;Macbook Pro 15;Apple Ait Tag",
"items": [
{
"title": "iPhone XR",
"price": 270300,
"count": 1
},
{
"title": "Macbook Pro 15",
"price": 450000,
"count": 1
},
{
"title": "Apple Air Tag",
"price": 15000,
"count": 3
}
],
"amount_to_accept_payment": 765300,
"planned_datetime": null,
"callback_url": "<callback_url>",
"transport_type": "FOOT"
}
<aside> 📌 Если в заказе больше 2х адресов, то рекомендуем отдавать их по оптимальному маршруту. Курьеры везут заказы по очереди от первой до последней точки. Поэтому, если порядок точек неоптимальный, то получится длинное расстояние, высокая стоимость заказа и долгая доставка курьера.
</aside>
merchant_order_id
, from
, to
, callback_url
.callback_url
— cсылка, по которой будет выполняться запрос для обновления данных по заказу. Не должна заканчиваться на слэш (“/”). Должно начинаться на https:// .merchant_order_id
— номер заказа на вашей стороне.city
— город, где будет происходить доставка. Список доступных городов: Almaty
, Astana
, Atyrau
, Aktau
, Karaganda
, Shymkent
, Aktobe
, Kostanay
, Oral
, Oskemen
, Pavlodar
, Taldykorgan
, Kyzylorda
. По умолчанию Almaty
.product_name
— название товара. Если товаров несколько, нужно перечислить название через точку с запятой «$;$».items
— список товаров. Это поле является более функциональной альтернативой полю product_name
. Если нужно указать стоимость товара, то нужно использовать поле items
. Если при создании заказа указать и product_name
и items
то приоритетным будет items
.amount_to_accept_payment
— сумма, которую должен принять курьер у клиента за товар.planned_datetime
— время доставки запланированных заказов, то есть заказов, которые нужно доставить в определенное время. Поле формата YYYY-MM-DDThh:mm
. Пример: «2021-05-18T17:25». Система отреагирует и создаст заказ за 75 минут до указанной даты и времени. Для заказов без определенного времени доставки нужно указывать null
.