Інтеграція служби доставки Dostavista на сайт
Dostavista — сервіс експрес-доставки силами приватних кур'єрів. Працює в містах Росії, Європи, Азії. Основні сценарії: доставка протягом кількох годин, доставка крупногабаритних товарів (з вибором машини потрібного розміру), багатоточкова доставка.
Особливості API
Dostavista надає REST API з авторизацією через X-User-Email та X-User-Token. Sandbox-окружение доступне на robotapitest.dostavista.ru. Перед використанням потрібно створити аккаунт і отримати API-токен в особистому кабінеті.
Розрахунок вартості
POST /api/business/v1/calculate-order
{
"matter": "Документи",
"insurance_amount": "0",
"vehicle_type_id": 1, // 1=пішій, 2=велосипед, 3=мотоцикл, 8=авто
"points": [
{
"address": "Москва, Тверська, 1",
"client_order_id": "pickup"
},
{
"address": "Москва, Арбат, 10",
"client_order_id": "delivery"
}
]
}
Відповідь містить delivery_fee_amount. Рекомендується додати невелику буферність (+5–10%) до відображаємої вартості, оскільки кінцева ціна може незначно відрізнятися.
Створення замовлення
POST /api/business/v1/create-order
{
"matter": "Одяг",
"vehicle_type_id": 3,
"backpay_amount": "0", // наложений платіж
"points": [
{
"address": "Москва, Складський провулок, 5",
"contact_person": {"phone": "+79001234567", "name": "Склад"},
"taking_amount": "0",
"note": "Позвонити за 15 хвилин"
},
{
"address": "Москва, Ленина, 20, кв 5",
"contact_person": {"phone": "+79007654321", "name": "Покупець"},
"is_door_to_door": true,
"note": "Код домофона: 456"
}
]
}
Трекінг та статуси
Статус замовлення відстежується через поллінг (GET /api/business/v1/orders/{id}) або вебхук. Актуальні статуси: new, available_for_couriers, active, finished, delayed, courier_not_found, canceled.
У відповіді є поля courier_latitude та courier_longitude — координати кур'єра для відображення на карті в реальному часі.
Вибір типу транспорту
Dostavista дозволяє вибирати транспорт під груз:
- Пішоходець — дрібні документи, конверти
- Велосипед/мотоцикл — невеликі посилки, їжа
- Автомобіль — крупні товари, кілька коробок
На фронтенді це реалізується як додатковий крок при виборі доставки або автоматично на основі габаритів товара.
Строки
Базова інтеграція з розрахунком та створенням замовлень — 2–3 робочих дні. З трекінгом на карті та обробкою вебхука — 4–5 днів.