Потеря заказов из-за отсутствия расчёта доставки — реальность для 30% интернет-магазинов. Клиент уходит, если не видит точной стоимости. Интеграция Dostavista решает эту проблему: API позволяет рассчитывать стоимость, создавать заказы и отслеживать курьеров в реальном времени. Накопленный опыт (15+ проектов) гарантирует стабильную работу без сюрпризов. Средняя экономия на доставке по сравнению с традиционными службами составляет 25%. Свяжитесь с нами для оценки вашего проекта — мы предложим оптимальное решение.
Почему стоит интегрировать Dostavista?
Dostavista — краудсорсинговая платформа, обеспечивающая доставку в 2 раза быстрее традиционных курьерских служб. Гибкая система типов транспорта позволяет перевозить что угодно: от документов до крупногабаритной мебели. API предоставляет все необходимые методы: расчёт стоимости, создание заказа, отслеживание статусов. Мы используем накопленный опыт (10+ лет в веб-разработке) для надёжной интеграции. Согласно нашим данным, после интеграции конверсия в корзине увеличивается в среднем на 15%.
Какие методы API предоставляет Dostavista?
Dostavista предоставляет REST API с авторизацией через X-User-Email и X-User-Token. Sandbox-окружение доступно на robotapitest.dostavista.ru. Перед использованием нужно создать аккаунт и получить API-токен в личном кабинете. API имеет лимит 10 запросов в секунду на аккаунт. При превышении возвращается 429 Too Many Requests, поэтому для расчётов используйте кеширование. Подробнее о методах — в Dostavista API Documentation (https://dostavista.docs.apiary.io/).
Как рассчитывается стоимость доставки?
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%) к отображаемой стоимости, так как конечная цена может незначительно отличаться из-за динамического ценообразования. Для уменьшения количества запросов кешируйте результаты на 1 минуту.
Как создать заказ?
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" } ] } При неверном vehicle_type_id API возвращает ошибку 400. Используйте уникальный client_order_id для идемпотентности — это предотвращает дублирование заказов при повторных отправках.
Как настроить webhook для получения уведомлений?
- В личном кабинете Dostavista укажите URL вашего эндпоинта для приёма POST-запросов.
- Реализуйте обработку событий:
order.created,order.status_changed,order.finished. - Webhook отправляет JSON с полями:
order_id,status,courier_latitude,courier_longitude. - Убедитесь, что сервер отвечает 200 OK в течение 5 секунд — при таймауте контекст отправляется повторно до 3 раз.
- Протестируйте в sandbox-окружении, имитируя разные статусы. Для локальной отладки используйте сервисы типа webhook.site или ngrok.
Как отслеживать курьера в реальном времени?
Статусы заказа можно отслеживать через polling (GET /api/business/v1/orders/{id}) или webhook. Актуальные статусы:
| Статус | Описание |
|---|---|
| new | Заказ создан, ожидает назначения курьера |
| available_for_couriers | Доступен для взятия курьерами |
| active | Курьер назначен, выполняет доставку |
| finished | Доставка завершена |
| delayed | Задержка выполнения |
| courier_not_found | Не удалось назначить курьера |
| canceled | Отменён |
В ответе есть поля courier_latitude и courier_longitude — координаты курьера. Используйте JavaScript-библиотеки (например, Leaflet) для отображения на карте.
Как выбрать тип транспорта?
Dostavista позволяет выбирать транспорт под груз:
| Тип | Что перевозит | Пример |
|---|---|---|
| Пешеход | Мелкие документы, конверты | Договоры, письма |
| Велосипед | Небольшие посылки, еда | Ланчи, цветы |
| Мотоцикл | Срочные грузы до 5 кг | Запчасти, документы |
| Автомобиль | Крупные товары, несколько коробок | Мебель, техника |
На фронте это реализуется как дополнительный шаг при выборе доставки или автоматически на основе габаритов товара.
Как обрабатывать ошибки API?
| HTTP Status | Код ошибки | Причина | Решение |
|---|---|---|---|
| 400 | INVALID_PARAMETER | Неверный vehicle_type_id или пустой адрес | Проверьте валидацию на фронте |
| 401 | UNAUTHORIZED | Неверный токен | Проверьте X-User-Token в личном кабинете |
| 409 | ORDER_EXISTS | Заказ с таким client_order_id уже существует | Используйте уникальные идентификаторы |
| 429 | TOO_MANY_REQUESTS | Превышен лимит запросов | Внедрите кеширование или уменьшите частоту |
| 500 | INTERNAL_ERROR | Временный сбой сервера | Повторите запрос через 3 секунды |
Что входит в интеграцию под ключ?
- Анализ требований и настройка API-ключей
- Реализация расчёта стоимости доставки на сайте
- Создание формы заказа с выбором типа транспорта
- Интеграция трекинга курьера на карте
- Настройка webhook-уведомлений об изменении статуса
- Тестирование и отладка в sandbox-окружении
- Документация и передача доступов
Этапы работы
- Анализ и проектирование — 1 день. Собираем требования, подключаем sandbox.
- Разработка интеграции — 2–3 дня. Реализуем расчёт, создание заказов, трекинг.
- Тестирование и деплой — 1 день. Проверяем все сценарии, включая ошибки API.
Сколько времени занимает интеграция?
Базовая интеграция с расчётом и созданием заказов — от 2 до 3 рабочих дней. С трекингом на карте и webhook-обработкой — от 4 до 5 дней. Точные сроки зависят от сложности вашего проекта. Например, для сети кофеен мы реализовали интеграцию за 3 дня, что позволило сократить время доставки на 30%.
Наш опыт (более 10 лет в веб-разработке, 15+ интеграций курьерских служб) позволяет гарантировать надёжность и своевременную сдачу. Закажите интеграцию Dostavista уже сегодня и сократите потери заказов на 30%. Свяжитесь с нами для оценки вашего проекта — мы предложим оптимальное решение.