Yandex.Delivery Integration on Website
Yandex.Delivery is a logistics service for B2C and B2B working in Russian cities. Supports same-day and next-day courier delivery, delivery to pickup points, routing integration. API enables cost calculation, order creation, status tracking.
API Connection
Yandex.Delivery provides REST API. Base URL: https://b2b.taxi.yandex.net/b2b/cargo/integration/v2/. Authorization via OAuth token or API key in Authorization: Bearer {token} header.
Delivery Cost Calculation
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]}, // warehouse
{"coordinates": [37.624747, 55.753595]} // customer
],
"skip_door_to_door": false
}
Response contains cost and available rates. Calculation cached 15–30 minutes during order checkout.
Create Delivery Claim
After order confirmation by seller:
POST /b2b/cargo/integration/v2/claims/create
{
"items": [...],
"route_points": [
{
"address": {"fullname": "Moscow, Skladskaya St, 1"},
"contact": {"name": "Ivan", "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": "Moscow, Pokupatelskaya St, 5, apt. 10"},
"contact": {"name": "Maria", "phone": "+79007654321"},
"point_id": 2,
"type": "destination"
}
]
}
Order Tracking
Yandex.Delivery supports webhook notifications and polling. Statuses: new → estimating → performer_lookup → performer_found → pickup_arrived → ready_for_pickup_from_sender → en_route_to_pickup → picked_up → delivered.
Status syncs with order system and displays to customer.
Conditions and Limitations
- Weight per parcel: up to 30 kg (depends on rate)
- Dimensions: up to 150 cm longest side
- Works in major cities and regional centers (not everywhere)
- Minimum cost depends on rate and city
Timeline
Basic integration (calculation + claim creation + tracking) — 3–4 working days. Full integration with auto claim creation, webhook handling, map display — 1–1.5 weeks.