Экономия пробега и топливаSDK курьерской службы это набор готовых библиотек и примеров, который помогает вызывать API оператора из вашего сайта или приложения. Через API магазин считает стоимость доставки, создаёт заказ, получает статусы и печатает этикетки без ручной работы менеджера. Если у оператора нет SDK, интегрируются напрямую по HTTP: принцип тот же, просто разработчику придётся самому собирать запросы.
API, SDK и готовый модуль: в чём разница
| Способ | Что это | Кому подходит |
|---|---|---|
| API | Набор запросов к серверу оператора, обычно REST с форматом JSON | Магазину со своей разработкой |
| SDK | Библиотека под язык программирования (PHP, Python, JavaScript, Java) поверх API | Команде, которая хочет быстрее начать |
| Модуль для CMS | Готовый плагин для популярной платформы магазина | Небольшому магазину без разработчика |
| Виджет | Блок на странице оформления заказа: выбор пункта выдачи на карте | Тем, кому нужна только карта и расчёт |
Крупные операторы в России и Беларуси, как правило, публикуют документацию к API для клиентов с договором. Наличие SDK, условия доступа и ограничения по числу запросов уточняйте у конкретного оператора перед выбором.
Какие функции обычно доступны
- расчёт стоимости и срока по адресу, весу и габаритам;
- список пунктов выдачи и постаматов с режимом работы;
- создание заказа и присвоение трек-номера;
- вызов курьера для забора партии;
- печать накладных и этикеток;
- получение статусов отправления: принято, в пути, прибыло, вручено, возврат;
- отмена заказа и изменение данных получателя до передачи в доставку.
Как устроена интеграция по шагам
- Заключите договор с оператором и получите доступ к тестовой среде. Без договора ключи обычно не выдают.
- Сохраните ключи и логины в защищённом хранилище на сервере. В коде страницы или мобильного приложения ключи хранить нельзя.
- Передавайте в запросах точные вес и габариты. Для расчёта тарифа оператор использует большее из двух значений: фактический или объёмный вес. Проверить расчёт можно в калькуляторе объёмного веса.
- Свяжите статусы оператора со статусами вашего магазина, чтобы покупатель видел понятное сообщение.
- Подключите приём статусов: либо вы опрашиваете сервер по расписанию, либо оператор сам присылает уведомления на ваш адрес (вебхуки). Второй вариант быстрее и создаёт меньше нагрузки.
- Предусмотрите повтор запроса при сбое. Если создание заказа может уйти дважды, используйте уникальный номер заказа, чтобы оператор не завёл дубль.
- Протестируйте типичные ситуации: неверный адрес, вес выше лимита, отказ получателя, неполучение, возврат.
Соответствие статусов
Покупателю не нужны внутренние коды оператора. Простая таблица соответствия делает уведомления понятными.
| Статус оператора | Что показывать покупателю |
|---|---|
| Заказ создан | Заказ передан в доставку |
| Принят от отправителя | Посылка принята на складе службы |
| В пути | Посылка едет в ваш город |
| Прибыл в пункт выдачи | Можно забирать, срок хранения указан в уведомлении |
| Вручён | Заказ получен |
| Возврат | Посылка возвращается продавцу |
Безопасность и данные
Передавайте оператору только данные, необходимые для доставки: имя, телефон, адрес. В России и Беларуси действуют законы о персональных данных, и магазин отвечает за то, куда они уходят. Закрепите это в договоре: цель обработки, срок хранения, порядок удаления. Соединение с API должно идти по защищённому протоколу, а ключи нужно менять при смене сотрудников, которые имели к ним доступ.
Сколько это стоит и сколько занимает
Стоимость зависит от того, нужен ли готовый модуль или своя разработка. Для небольшого магазина готовый плагин проще и дешевле, для крупного нужна доработка под склад и процессы. Сроки определяют после анализа: простое подключение расчёта и создания заказа занимает недели, а полноценный обмен статусами с учётной системой дольше.
Вопросы и ответы
Нужен ли SDK, если есть API?
Нет. SDK экономит время разработчику, но интеграцию можно собрать на любом языке по описанию запросов.
Можно ли подключить несколько служб сразу?
Можно. Для этого магазин делает единый слой доставки, который одинаково вызывает разных операторов и приводит ответы к одному виду.
Как проверить тариф, который вернул API?
Сравните его с тарифом в личном кабинете для той же отправки. При расхождении проверьте вес, габариты и зону доставки.
Что делать, если API недоступен?
Показывайте покупателю запасной вариант расчёта по фиксированным тарифам и создавайте заказ позже, когда связь восстановится.
Читайте также
- Sdk курьерская служба
- Стоимость грузоперевозки: как узнать и снизить
- Как открыть курьерскую службу
- Как выбрать курьерскую службу для доставки по городу
Больше материалов о доставке для магазинов в разделе Службы доставки.
Проверено: октябрь 2026. Источники: публичная документация API операторов доставки, законы о персональных данных Российской Федерации и Республики Беларусь.
Раздел: Технологии и сервисы / TMS, CRM и автоматизация