Інтеграція служби доставки Яндекс.Доставки на сайт
Яндекс.Доставка — логістичний сервіс для B2C та B2B, який працює в містах Росії. Підтримує кур'єрську доставку день-в-день та наступного дня, доставку до ПВЗ, інтеграцію з маршрутизацією. API дозволяє розраховувати вартість, створювати заявки та відслідковувати статуси.
Підключення до API
Яндекс.Доставка надає REST API. Базова URL: https://b2b.taxi.yandex.net/b2b/cargo/integration/v2/. Авторизація через OAuth-токен або API-ключ у заголовку Authorization: Bearer {token}.
Розрахунок вартості доставки
POST /b2b/cargo/integration/v2/check-price
{
"items": [
{
"quantity": 1,
"size": {"length": 0.3, "width": 0.2, "height": 0.1},
"weight": 1.5,
"cost_value": "1500",
"cost_currency": "RUB"
}
],
"route": [
{"coordinates": [37.589008, 55.734008]}, // склад
{"coordinates": [37.624747, 55.753595]} // покупець
],
"skip_door_to_door": false
}
Відповідь містить вартість та доступні тарифи. Розрахунок кешується на 15–30 хвилин під час оформлення замовлення.
Створення заявки на доставку
Після підтвердження замовлення продавцем:
POST /b2b/cargo/integration/v2/claims/create
{
"items": [...],
"route_points": [
{
"address": {"fullname": "Москва, ул. Складская, 1"},
"contact": {"name": "Іван", "phone": "+79001234567"},
"point_id": 1,
"type": "source",
"pick_up_time": {"from": "2024-03-15T10:00:00+03:00", "to": "2024-03-15T12:00:00+03:00"}
},
{
"address": {"fullname": "Москва, ул. Покупательская, 5, кв. 10"},
"contact": {"name": "Марія", "phone": "+79007654321"},
"point_id": 2,
"type": "destination"
}
]
}
Трекінг замовлення
Яндекс.Доставка підтримує вебхук-сповіщення та поллінг. Статуси: new → estimating → performer_lookup → performer_found → pickup_arrived → ready_for_pickup_from_sender → en_route_to_pickup → picked_up → delivered.
Статус синхронізується з замовленням у системі та відображається покупцю.
Умови та обмеження
- Вага одного місця: до 30 кг (залежить від тарифу)
- Габарити: до 150 см по довгій стороні
- Працює в крупних містах та обласних центрах (не скрізь)
- Мінімальна вартість залежить від тарифу та міста
Строки
Базова інтеграція (розрахунок + створення заявки + трекінг) — 3–4 робочих дні. Повна інтеграція з автоматичним створенням заявок, обробкою вебхука та відображенням на карті — 1–1,5 тижня.