Экономия пробега и топливаПодключение службы доставки по API состоит из четырёх шагов: получение токена, расчёт стоимости, создание заявки и приём статусов. Сайт запрашивает у службы варианты и цену, создаёт заявку, проверяет её результат и подтверждает; если выполнить заявку нельзя, служба возвращает причины отказа. Так описана интеграция Яндекс Доставки, и похожая последовательность встречается у других операторов. Дальше чек-лист для разработчика и владельца магазина, типичные ошибки и показатели интеграции, для магазинов России и Беларуси.
Что такое API доставки и зачем он нужен
API это способ обмена данными между вашей системой и службой доставки без ручного ввода. Магазин отправляет данные заказа, служба отвечает ценой, номером заявки и статусами. Автоматизация экономит время и убирает опечатки. Для магазина с несколькими десятками заказов в день ручной ввод уже обходится дороже интеграции. Если нужен только вызов курьера пару раз в неделю, хватит личного кабинета: Личный кабинет службы доставки: что в нём должно быть.
Этапы подключения
- Договор и доступ. После заключения договора служба открывает доступ к кабинету, в котором создают токен для API (порядок описан в документации службы).
- Изучение документации и выбор сценариев: экспресс-доставка по городу, доставка в пункт выдачи, межгород, возвраты.
- Тестовая среда. Если она есть, начинайте с неё, не с боевого режима.
- Расчёт стоимости на странице оформления заказа. Покупатель видит цену и срок до оплаты.
- Создание заявки после подтверждения заказа: адреса, контакты, габариты, вес, сумма оплаты при получении.
- Приём статусов через опрос или вебхук. Статусы обновляют карточку заказа и уведомляют покупателя.
- Обработка ошибок и отмен: заказ отменён, адрес не найден, получатель отказался.
- Запуск на небольшой доле заказов и анализ результатов.
Что передавать в заявке
| Группа данных | Поля |
|---|---|
| Отправитель | Адрес, контактное лицо, телефон, часы работы |
| Получатель | ФИО, телефон, адрес, этаж, подъезд, комментарий |
| Груз | Описание, вес, габариты, количество мест |
| Услуга | Тип доставки, окно времени, особые условия |
| Платёж | Оплата при получении, объявленная ценность |
| Служебные | Номер заказа в вашей системе, идентификатор клиента |
Следите за единицами измерения: вес в килограммах или граммах, размеры в сантиметрах или метрах. Ошибка в единицах приводит к неверной цене. Расчётный вес по габаритам заранее оценивают в калькуляторе объёмного веса.
Типичные ошибки интеграции
- Расчёт цены для покупателя и итоговая цена отличаются. Причины: другая точка забора, габариты, время. Закладывайте запас или сверяйте параметры.
- Не обрабатываются отказы заявки. Магазин не знает, что курьер не поедет.
- Нет проверки адреса, из-за чего растёт доля неудачных вручений.
- Токен хранится в коде сайта в открытом виде.
- Нет повторной отправки при временной ошибке сервиса.
- Не ведётся журнал запросов и ответов, и непонятно, кто виноват при споре.
- Статусы не сопоставлены с вашими. Покупатель видит технические коды вместо понятных сообщений.
Показатели интеграции
| Показатель | Хороший результат | Что делать при проблеме |
|---|---|---|
| Доля заявок, созданных без ошибок | Почти все | Разобрать причины отказов |
| Время ответа расчёта | Секунды | Кэшировать расчёты, упростить запросы |
| Доля вручений с первой попытки | Растёт после проверки адресов | Добавить подсказки адреса и подтверждение по СМС |
| Расхождение расчётной и итоговой цены | Минимальное | Уточнить параметры расчёта |
| Доля заказов с актуальными статусами | Все | Проверить вебхуки или периодичность опроса |
Расчёт окупаемости
Условный пример. Магазин отправляет 600 заказов в месяц. На ручной ввод одного заказа уходит 3 минуты, это 30 часов в месяц. Если час сотрудника стоит 400 рублей, расходы на ручной ввод 12 000 рублей. Кроме того, ручной ввод даёт ошибки: допустим, 2% заказов, то есть 12 заказов с повторным выездом по 250 рублей, ещё 3000 рублей. Итого 15 000 рублей в месяц. Если интеграция стоит 60 000 рублей, она окупится примерно за четыре месяца. Подставьте свои цифры.
Выбор типа доставки
Экспресс по городу подходит для быстрой доставки в день заказа и срочных курьерских задач. Доставка в пункт выдачи дешевле, но зависит от режима работы точки. Межгород отдаётся партнёрским службам с трекингом. Для каждого сценария проверьте лимиты по весу и габаритам и условия возврата. Термосумки для еды и скоропортящегося: Термокороб Яндекс Доставки: нужен ли и как выбрать. Если у вас курьеры собственные, маршрутизация поможет снизить пробег: Яндекс Маршрутизация для курьерских служб.
Россия и Беларусь
Яндекс Доставка в документации описана для России, перечень стран и городов для услуг меняется, поэтому для Беларуси проверяйте доступность у менеджера и в документации. Для белорусских магазинов также работают Белпочта и местные курьерские службы со своими интеграциями. Данные покупателей, которые вы передаёте службе, подпадают под законы о персональных данных обеих стран.
Частые вопросы
Сколько времени занимает интеграция? Зависит от платформы сайта и числа сценариев. Для готовых плагинов от нескольких часов до дней, для собственной разработки недели.
Нужен ли разработчик? Для популярных CMS есть плагины. Для собственного сайта потребуется разработчик.
Что делать, если API недоступен? Нужен план: переключение на ручное создание заявок, письмо менеджеру, резервный подрядчик.
Читайте также
- Личный кабинет службы доставки: что в нём должно быть
- Калькулятор доставки Яндекса: как рассчитать цену
- Агрегаторы доставки: одна заявка и несколько служб
- Логистика e-commerce: склад, доставка и возвраты
Больше материалов: IT и инновации.
Проверено: октябрь 2026. Источники: документация Яндекс Доставки для разработчиков, законы о персональных данных РФ и РБ.
Раздел: Технологии и сервисы / IT и инновации