API в логистике это интерфейс, через который программы обмениваются данными без участия человека: магазин отправляет службе доставки заказ, получает тариф, этикетку и статусы, а склад и ERP получают подтверждения. Подключение API убирает ручной перенос данных, сокращает ошибки в адресах и весах и позволяет показывать клиенту актуальный статус посылки.

Что передают через API

Набор функций зависит от службы, но чаще всего встречаются одни и те же операции:

  • расчёт стоимости и срока доставки по весу, габаритам и направлению;
  • создание заказа или накладной на перевозку;
  • печать этикетки и сопроводительных документов;
  • вызов курьера или заявка на забор груза;
  • справочник пунктов выдачи и постаматов;
  • отслеживание статусов и история движения посылки;
  • отмена заказа и возвраты.

Крупные российские службы доставки и почта публикуют открытые интерфейсы для интернет-магазинов. Для белорусских перевозчиков и почты состав доступных функций и порядок подключения лучше уточнять в документации самой службы или у её менеджера.

Как работает типичная схема

ШагЧто происходитКто запускает
Оформление корзинымагазин запрашивает тариф и пункты выдачисайт магазина
Подтверждение заказасоздаётся заявка на доставку, возвращается номер отправлениясистема учёта заказов
Сборкасклад печатает этикетку из системы доставкиWMS или оператор склада
В путислужба доставки присылает статусы по вебхукуслужба доставки
Вручениестатус «доставлено» закрывает заказ и запускает расчётыслужба доставки, система учёта

Вебхуки и опрос статусов

Статусы можно получать двумя способами. Первый: система сама периодически спрашивает службу о заказе. Это просто, но создаёт нагрузку и даёт задержки. Второй: служба сама отправляет сообщение на ваш адрес при каждом изменении (вебхук). Такой подход быстрее и экономит запросы, но требует доступного адреса для приёма и проверки подписи сообщений. На практике многие подключают оба способа: вебхук для оперативных статусов и периодический опрос как страховку.

Что учесть при подключении

Технические детали различаются, но основные правила общие. Получите ключ или токен и храните его в защищённом хранилище, но не в коде страницы. Проверьте ограничения на число запросов в минуту и предусмотрите повтор при временной ошибке. Заведите тестовую среду, если служба её предоставляет, и сначала отправьте тестовые заказы. Договоритесь о формате веса и габаритов: граммы или килограммы, сантиметры или миллиметры. Расхождение единиц чаще всего даёт неверный тариф.

Адреса лучше нормализовать до отправки: единый справочник улиц и городов снижает число возвратов. Номера телефонов и имена получателей нужны в строгом формате, иначе заявка не пройдёт.

Где API даёт эффект

Эффект заметен при большом числе заказов. Если в день проходит десяток отправлений, ручная работа справляется. При сотнях заказов ошибки ввода и время на печать этикеток начинают стоить денег. Подключение к нескольким службам сразу позволяет сравнивать тарифы на лету и выбирать дешёвую или быструю доставку. Для проверки цены перевозки можно ориентироваться на расчёт объёмного веса: многие службы считают тариф по большему из двух значений, реального и объёмного.

В международных и транспортных перевозках интерфейсы нужны также для обмена электронными документами. В России электронная транспортная накладная обязательна с 1 сентября 2026 года с исключениями, и данные в неё поступают из учётной системы через оператора. В ЕС готовится регламент eFTI, который начнёт работать с 9 июля 2027 года и коснётся грузовых перевозок, где участвует европейская сторона.

Риски и ошибки

  • интеграцию делают под одну службу, и переключение на другую превращается в новый проект;
  • нет обработки ошибок, и заказ молча не уходит в доставку;
  • отсутствует журнал запросов, поэтому спор со службой нечем подтвердить;
  • токены остаются у уволенного разработчика.

Чтобы смена службы не ломала систему, между магазином и перевозчиком ставят внутренний слой, который переводит ваш формат заказа в формат конкретной службы.

Вопросы и ответы

Нужен ли программист, чтобы подключить API?

Для готовых модулей CMS и популярных учётных систем часто хватает настройки. Для нестандартных процессов нужен разработчик.

Сколько стоит подключение?

Многие службы дают доступ к интерфейсу без платы, затраты связаны с работой разработчика. Условия нужно уточнять у конкретной службы.

Что делать, если служба меняет версию интерфейса?

Следить за уведомлениями в личном кабинете и заранее тестировать новую версию на тестовой среде.

Можно ли подключить несколько служб в одном окне?

Да, это делают через сервисы-агрегаторы или собственный модуль выбора тарифа.

Проверено: октябрь 2026. Источники: документация служб доставки, регламент ЕС об электронной информации о грузовых перевозках (eFTI), нормы РФ об электронной транспортной накладной.

Читайте также

Раздел: службы доставки.

Раздел: Курьерская доставка и посылки / Службы доставки и курьерские компании

Похожие записи