Интеграция службы доставки 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"
}
]
}
Трекинг и статусы
Статусы заказа можно отслеживать через polling (GET /api/business/v1/orders/{id}) или webhook. Актуальные статусы: new, available_for_couriers, active, finished, delayed, courier_not_found, canceled.
В ответе есть поле courier_latitude и courier_longitude — координаты курьера для отображения на карте в реальном времени.
Выбор типа транспорта
Dostavista позволяет выбирать транспорт под груз:
- Пешеход — мелкие документы, конверты
- Велосипед/мотоцикл — небольшие посылки, еда
- Автомобиль — крупные товары, несколько коробок
На фронте это реализуется как дополнительный шаг при выборе доставки или автоматически на основе габаритов товара.
Сроки интеграции
Базовая интеграция с расчётом и созданием заказов — 2–3 рабочих дня. С трекингом на карте и webhook-обработкой — 4–5 дней.