В 2023–2026 годах все три крупнейших американских перевозчика посылок изменили способ подключения программного обеспечения. UPS заменил ключи доступа на OAuth 2.0, USPS закрыл свои давно работавшие API Web Tools, а FedEx назначил срок перехода с прежних Web Services на REST API. Каждое из этих изменений разумно само по себе, но вместе они означают, что плагин доставки, установленный несколько лет назад, мог без особого предупреждения перестать возвращать тарифы или печатать этикетки. В руководстве кратко описано, что изменилось, и приведён чек-лист миграции API перевозчиков для интернет-магазинов.
Что изменилось у каждого перевозчика
| Перевозчик | Прежнее подключение | Текущее подключение | Ключевая дата |
|---|---|---|---|
| UPS | Ключ доступа, отправляемый с каждым запросом | REST API с токенами UPS OAuth, выдаваемыми приложению, созданному на портале разработчиков UPS | Ключи доступа перестали приниматься в 2024 году |
| USPS | API Web Tools (XML) с идентификатором пользователя | Новые API USPS на портале разработчиков USPS с использованием OAuth 2.0 | USPS сообщает, что платформа Web Tools закрыта 25 января 2026 года |
| FedEx | FedEx Web Services (SOAP/WSDL) | REST API FedEx с учётными данными OAuth с портала разработчиков FedEx | FedEx просил прямых клиентов завершить миграцию к 1 июня 2026 года |
Официальные источники — руководство UPS по миграции на OAuth, портал разработчиков API USPS и объявление FedEx о миграции. Закрытие USPS Web Tools затрагивает не только тарифы и этикетки: проверка адресов, отслеживание и сроки доставки тоже перешли на новую платформу.
Признаки того, что плагин доставки перестал работать
Сбои не всегда бывают громкими. Обратите внимание на следующее:
- При оформлении заказа предлагается только запасной фиксированный тариф или показывается «нет доступных способов доставки» для адресов, которые раньше работали.
- Создание этикеток в панели администратора завершается ошибкой или этикетки печатаются для одного перевозчика и не печатаются для другого.
- Номера отслеживания перестают обновляться или письма об отправке уходят без ссылки на отслеживание.
- В журналах ошибок видны ошибки аутентификации (ответы 401 или 403) или неудачные подключения к адресам перевозчиков.
Самый дорогой вариант — тихий: запасной тариф, который выглядит обычно, но находится намного ниже суммы, которую выставляет перевозчик. Когда плагин доставки перестал работать таким образом, убыток обнаруживается через несколько недель в счёте перевозчика, а не при оформлении заказа.
Чек-лист миграции API перевозчиков
- Составьте список всех систем, которые общаются с перевозчиком: расширение доставки магазина, программа для этикеток, ERP или складская система, инструменты маркетплейсов и любые пользовательские скрипты. Старые интеграции обычно прячутся в двух последних.
- Создайте учётные записи разработчика и приложения под собственными аккаунтами компании у перевозчиков, а не под личным логином разработчика, и запишите, кто ими владеет.
- Храните учётные данные на сервере вне репозитория кода и убедитесь, что интеграция сама запрашивает и обновляет токены доступа, а не полагается на однажды вставленный ключ.
- Обновите или замените коннектор. Актуальным коннектором доставки для FedEx и UPS может быть новая версия вашего плагина, другое расширение или мультиперевозочная платформа доставки. Убедитесь, что он вызывает новые API, а не слой совместимости над старыми.
- Проверьте в тестовых средах перевозчиков, затем сравните актуальные расчёты с вашими договорными тарифами и несколькими недавними счетами.
- Проверьте этикетки и документы: термопечать (ZPL) или формат PDF, таможенные данные для международных посылок, обратные этикетки.
- Повторно проверьте проверку адресов, включая различие между коммерческим и жилым адресом, которое влияет на цену.
Наша работа по интеграции API доставки и автоматизации логистики охватывает эти шаги: от защиты учётных данных перевозчиков до тестовых отправлений в тестовой среде, прежде чем уйдут настоящие посылки.
Чтобы работало и дальше: простой мониторинг API доставки
Интерфейсы перевозчиков будут продолжать меняться, поэтому заложите систему раннего предупреждения. Простой мониторинг API доставки примерно раз в час запрашивает тариф для известного адреса и посылки и оповещает кого-то, когда запрос не выполняется или цена резко меняется. Добавьте оповещения о доле неудачных запросов этикеток, напоминание в календаре для каждых учётных данных с истекающим сроком и подписку на объявления для разработчиков каждого перевозчика. Ничего из этого не сложно, и благодаря этому следующее уведомление о закрытии станет плановой задачей, а не сюрпризом в понедельник утром.
Прямая интеграция или платформа доставки?
Прямое подключение магазина к каждому перевозчику даёт наибольший контроль и никаких платежей платформе за каждую этикетку, но все изменения у перевозчиков ложатся на вас. Мультиперевозочные платформы, такие как ShipStation, Shippo или EasyPost, берут эти изменения на себя и добавляют пакетную печать этикеток и правила автоматизации ценой подписки или платы за этикетку и ещё одной системы в цепочке. Магазинам с одним перевозчиком и простыми правилами часто хорошо подходит прямое подключение; магазинам, отправляющим через нескольких перевозчиков или из нескольких мест, обычно выгодна платформа. В любом случае хорошие услуги по интеграции API доставки должны оставлять вам задокументированные учётные данные, журналы и мониторинг, а не только работающее оформление заказа.
Часто задаваемые вопросы: миграция API перевозчиков
Нужен ли новый аккаунт у перевозчика, чтобы пользоваться новыми API?
Нет. Вы сохраняете свой аккаунт доставки и создаёте на портале разработчиков перевозчика приложение, связанное с ним. Интеграция использует учётные данные этого приложения.
Будут ли наши договорные тарифы по-прежнему показываться при оформлении заказа?
Только если запросы тарифов делаются от вашего аккаунта. Коннектор, использующий общие учётные данные или прайс-листовые тарифы, покажет опубликованные цены.
Мы пропустили срок. Что делать?
Выясните, какие системы всё ещё обращаются к прежним интерфейсам, переключите оформление заказа на безопасный фиксированный тариф, если тарифы в реальном времени не работают, и в первую очередь исправьте подключение, печатающее этикетки, потому что именно из-за него заказы перестают отправляться. Затем перенесите остальное.
Тарифы не показываются при оформлении заказа или этикетки перестали печататься после изменений у перевозчика? Наша услуга интеграция API доставки подключает магазины к FedEx, UPS, USPS и платформам доставки, с тарифами в реальном времени, пакетной печатью этикеток и записью отслеживания обратно в магазин. Если остатки и заказы нужно передавать в ERP, см. интеграцию ERP и PIM. Свяжитесь с нами, указав вашу платформу, перевозчиков и используемый сейчас плагин, и мы проверим, что нужно изменить.
