Интеграция службы доставки Яндекс.Доставки на сайт
Яндекс.Доставка — логистический сервис для 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"
}
]
}
Трекинг заказа
Яндекс.Доставка поддерживает webhook-уведомления и polling. Статусы: new → estimating → performer_lookup → performer_found → pickup_arrived → ready_for_pickup_from_sender → en_route_to_pickup → picked_up → delivered.
Статус синхронизируется с заказом в системе и отображается покупателю.
Условия и ограничения
- Вес одного места: до 30 кг (зависит от тарифа)
- Габариты: до 150 см по длинной стороне
- Работает в крупных городах и областных центрах (не везде)
- Минимальная стоимость зависит от тарифа и города
Сроки интеграции
Базовая интеграция (расчёт + создание заявки + трекинг) — 3–4 рабочих дня. Полная интеграция с автоматическим созданием заявок, webhook-обработкой и отображением на карте — 1–1,5 недели.