Prod: https://server.chocodostavka.kz
Dev: https://dev-server.chocodostavka.kz
Сделайте запрос методом POST по ссылке: {SERVER_HOST}/api-gate/v0/deliveries/groups
Headers:
--header 'Authorization: JWT {Token}' \\
--header 'Content-Type: application/json' \\
Body:
{
"transport_type": "CAR", // необязательное поле
"is_fastest": true, // необязательное поле
"callback_url": "example.com/api/update_status", // необязательное поле
"verification_type": 11, // необязательное поле
"planned_datetime": "2021-05-18T17:25", // необязательное поле
"optimize_trip": true, // необязательно поле
"points": [
{ // точка №1
"contact_info": {
"phone_number": "+77771234567"
},
"address": {
"city": "Алматы",
"street": "улица Байзакова",
"building": "280",
"longitude": 76.915048, // необязательное поле
"latitude":43.237235 // необязательное поле
}
},
{ // точка №2
"merchant_order_id": 192594, // идентификатор со стороны партнера
"order_comment": "комментарий к заказу",
"tasks": [{"id": 1, "comment": "Проверьте по удостверению"},
{"id": 5, "comment": "Сфоткайте товар"},
{"id": 13}], // для списка задач есть отдельный запрос
"contact_info": {
"phone_number": "+77777777771",
"contact_name": "Kolya"
},
"address": {
"city": "Алматы",
"street": "улица Байзакова",
"building": "298",
"apartment": "297a",
"entrance": "подъезд",
"floor": "этаж",
"intercom": "код домофона",
"extra_info": "офис компании Chocofamily, вход с торца",
"longitude": 76.915722,
"latitude": 43.235057
}
},
{ // точка №3
"merchant_order_id": 192595,
"order_comment": "Заказ оплачен",
"contact_info": {
"phone_number": "+77777777778",
"contact_name": "Nurbergen"
},
"address": {
"city": "Алматы",
"street": "Проспект Абая",
"building": "206",
"extra_info": "Нурберген " // дополнительное инфо. при необходимости
}
},
// ... можете создавать до 30 точек в одном заказе
{ // точка №N
"contact_info": {
"phone_number": "+77771234567"
},
"address": {
"street": "м-н Аксай-4",
"building": "дом 44",
"longitude": 76.892449,
"latitude": 43.202585
},
"amount_to_accept_payment": "765300", //сумма в тг
"items": [
{
"title": "iPhone XR",
"price": 270300,
"count": 1
},
{
"title": "Macbook Pro 15",
"price": 450000,
"count": 1
},
{
"title": "Apple Air Tag",
"price": 15000,
"count": 3
}
],
"tasks": [
{
"id": 4,
"comment": "Примите оплату"
}
]
}
]
}
phone_number, address: street, buildingtransport_type — вид транспорта, на данный момент доступны 2 вида: CAR и FOOT. Предварительную цену по всем тарифам можете получить тут по вашим адресам. Поле необязательное, если ее не будет, система возьмет смешанный тариф по стандартной цене.is_fastest — вид тарифа, true - тариф срочный (курьер доставит как можно скорее, но нельзя создавать доп. задачи), false - тариф 3-х часовой (курьер доставит в течение 3-х часов). Данное поле необязательное, по умолчанию будет false .callback_url — cсылка, по которой будет выполняться запрос для обновления статуса по заказу. Не должна заканчиваться на слэш (“/”). Должно начинаться на https:// .verification_type — тип верификации для передачи товара получателю. Код для этого поля можете получить от наших разработчиков. Это поле позволит использовать свою верификацию для выдачи товара получателю, в том числе верификацию от маркетплейсов (Kaspi, Jusan, Halyk и т.д.) От вас необходимы 2 API метода:
planned_datetime — время к которому подадим курьера. Поле формата YYYY-MM-DDThh:mm. Пример: «2021-05-18T17:25». Система отреагирует и создаст заказ за 30 минут до указанной даты и времени. Поле необязательное, в случаях отсутствия этого поля, поиск курьера начнется мгновенно.points — список адресов получателей. Получатель может быть 1 или несколько.
merchant_order_id — идентификатор заказа на стороне партнера.tasks — идентификатор задач. GET метод для получения доступных задач по ссылке. При необходимости можно создать индивидуальные задачи под вас.city — город, где будет происходить доставка. Список доступных городов: Almaty, Astana, Atyrau, Aktau, Karaganda, Shymkent, Aktobe, Kostanay, Oral, Oskemen, Pavlodar, Taldykorgan, Kyzylorda. По умолчанию Almaty.longitude и latitude — при передачи координат нужно указывать 6 цифр после точки.
city, street и building) в теле запроса.longitude и latitude) необязательны. Но мы рекомендуем их отправлять, чтобы избежать ошибок при одинаковых названиях улиц/микрорайонов. Например: Хан-тенгри 101 мы можем определить как “улица Хан-Тенгри 101” вместо “микрорайона Хан-тенгри 101”;amount_to_accept_payment — сумма в тенге, которую курьер должен принять у получателя.items — список товаров которые должен передать на точке и принять оплату. Желательно указывать сумму, так как при частичном выкупе получателем, курьер примет оплату за минусом указанной суммы за товар который получатель на месте решил не покупать.optimize_trip — Параметр позволяет оптимизировать маршрут при создании мультиточечных заказов. Установка этого параметра в значение 'true' вызовет анализ точек доставки и автоматическую реорганизацию их в наиболее эффективном порядке. Это может сэкономить время и ресурсы при доставке и обеспечить более эффективный процесс.Response:
Status: 201 Created