API служб доставки: расчёт стоимости и трекинг на своём сайте

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

Что обычно умеет API доставки

• Справочники: города, районы, пункты выдачи, тарифы и виды доставки
• Расчёт стоимости и ориентировочного срока по адресу, весу и габаритам
• Создание отправления с данными получателя и описанием посылки
• Печать этикеток и сопроводительных документов
• Вызов курьера на забор
• Получение статусов и трек-номера
• Вебхуки — уведомления о смене статуса
• Данные о наложенном платеже и сверка расчётов

Набор функций у разных перевозчиков разный, поэтому начинать стоит с изучения документации конкретной службы.

Сценарий интеграции с сайтом

1. Покупатель вводит адрес, сайт запрашивает у API доступные способы и стоимость доставки.
2. Покупатель выбирает вариант, оформляет и оплачивает заказ.
3. После подтверждения заказа система создаёт отправление через API и получает трек-номер.
4. Склад печатает этикетку, курьер забирает посылку.
5. Статусы приходят через вебхук или периодический запрос и показываются клиенту в личном кабинете или в Telegram-боте.
6. При доставке заказ автоматически закрывается, а данные о наложенном платеже сверяются с поступлениями.

Несколько служб доставки

Крупные магазины работают с несколькими перевозчиками: один для города, другой для регионов, самовывоз из пунктов выдачи. Тогда в системе нужен единый слой доставки: общие статусы, единый формат адреса, правила выбора перевозчика. Статусы разных служб сопоставляются с вашими внутренними: «принят», «в пути», «доставлен», «возврат». Иначе клиент и менеджер будут видеть разную терминологию.

Адреса — главная сложность

Ошибки в адресах — одна из частых причин неудачных доставок. Помогают справочники городов и районов от перевозчика, выбор точки на карте, обязательный телефон получателя, проверка адреса до создания отправления. Для Ташкента и регионов полезно хранить ориентиры, которыми привыкли пользоваться клиенты, отдельным полем.

Что проверить у перевозчика до интеграции

• Есть ли документация API и тестовая среда
• Какие операции доступны через API, а какие только в кабинете
• Как передаются статусы: вебхуки или только опрос
• Ограничения частоты запросов
• Как оформляются возвраты и частичный выкуп
• Как работает наложенный платёж и сверка расчётов
• Кто поддерживает интеграцию с их стороны и как быстро отвечают

Надёжность интеграции

API перевозчика может быть временно недоступен. Система должна уметь повторить создание отправления позже, не создав дубль, и показать менеджеру заказы, которые не ушли. Расчёт стоимости на сайте стоит кэшировать на короткое время и иметь запасной вариант — например, показывать стандартный тариф или предлагать уточнить доставку у менеджера.

Связь с учётом

Отгрузка и списание товара в учётной системе должны совпадать с фактической передачей курьеру. Возвраты — возвращать товар на склад и отражать в учёте. Расходы на доставку по каждому заказу полезно сохранять для анализа рентабельности направлений.

С чего начать

Опишите текущий процесс доставки по шагам и отметьте, где больше всего ручной работы и ошибок. Чаще всего первым автоматизируют создание отправлений и статусы для клиента: это сразу снимает нагрузку с менеджеров и колл-центра. Расчёт стоимости на сайте и сверку платежей подключают следующими этапами.