Dostavista Delivery Service Integration on Website
Dostavista is express courier delivery service with private couriers. Works in Russian, European, Asian cities. Main scenarios: delivery within hours, large items (with vehicle size choice), multi-point delivery.
API Features
Dostavista provides REST API with authorization via X-User-Email and X-User-Token. Sandbox available at robotapitest.dostavista.ru. Create account and get API token in personal cabinet before use.
Cost Calculation
POST /api/business/v1/calculate-order
{
"matter": "Documents",
"insurance_amount": "0",
"vehicle_type_id": 1, // 1=pedestrian, 2=bike, 3=motorcycle, 8=car
"points": [
{
"address": "Moscow, Tverskaya, 1",
"client_order_id": "pickup"
},
{
"address": "Moscow, Arbat, 10",
"client_order_id": "delivery"
}
]
}
Response contains delivery_fee_amount. Recommend adding small buffer (+5–10%) to displayed cost as final price may differ slightly.
Order Creation
POST /api/business/v1/create-order
{
"matter": "Clothing",
"vehicle_type_id": 3,
"backpay_amount": "0", // cash on delivery
"points": [
{
"address": "Moscow, Warehouse Lane, 5",
"contact_person": {"phone": "+79001234567", "name": "Warehouse"},
"taking_amount": "0",
"note": "Call 15 min before"
},
{
"address": "Moscow, Lenin St, 20, apt 5",
"contact_person": {"phone": "+79007654321", "name": "Customer"},
"is_door_to_door": true,
"note": "Intercom code: 456"
}
]
}
Tracking and Statuses
Order status tracked via polling (GET /api/business/v1/orders/{id}) or webhook. Current statuses: new, available_for_couriers, active, finished, delayed, courier_not_found, canceled.
Response includes courier_latitude and courier_longitude for real-time map display.
Vehicle Type Selection
Dostavista allows choosing transport for cargo:
- Pedestrian — small documents, envelopes
- Bike/motorcycle — small parcels, food
- Car — large items, multiple boxes
Frontend implements as additional step in delivery selection or auto-select based on cargo dimensions.
Timeline
Basic integration with calculation and order creation — 2–3 working days. With tracking on map and webhook handling — 4–5 days.