Почта России: трек-номера и отправления

Почта России в RetailCRM закрывает всю розничную географию — от постаматов в мегаполисах до отделений в посёлках. Разберём, как из карточки заказа зарегистрировать отправление, получить трек-номер (ШПИ) и держать статусы доставки в актуальном состоянии без ручных проверок на сайте pochta.ru.

Как устроена интеграция с Почтой России

В RetailCRM Почта России подключается как отдельный модуль доставки из раздела Администрирование → Интеграция → Модули. После установки в справочнике Настройки → Справочники → Типы доставки появляется тип «Почта России», а в карточке заказа — блок доставки с полями адреса, индекса, трек-номера и стоимости.

Обмен идёт через официальный API Почты — сервисы OTPRAVKA (регистрация партий и отправлений) и Трекинг (получение статусов по ШПИ). Ключевой момент: интеграция оперирует не «кликами по сайту», а объектами заказа. Пока в заказе не заполнены обязательные для отправления поля, регистрация не пройдёт.

Что нужно для подключения

Для работы модуля нужен договор с Почтой России и доступ к личному кабинету otpravka.pochta.ru. Оттуда берутся реквизиты авторизации, которые вносятся в настройки модуля в RetailCRM:

• Токен авторизации приложения (Authorization token) — выдаётся в кабинете ОТПРАВКА;
• Ключ авторизации пользователя (X-User-Authorization) — Base64 от логина и пароля кабинета;
• Договор / номер клиента — определяет тарифы и способ оплаты;
• Адрес и индекс пункта отправки — обратный адрес магазина.

Без действующего договора доступен только расчёт и трекинг публичных отправлений, но не пакетная регистрация со скидкой. Проверьте, что в кабинете включён нужный способ расчётов (расчётный счёт или предоплата), иначе партии будут уходить в ошибку оплаты.

Типы отправлений и когда их выбирать

Почта России различает отправления по категории и виду — от этого зависят тариф, ограничения по весу и доступность наложенного платежа. В RetailCRM тип задаётся при формировании отправления.

Для розницы обычно используют «Посылку Онлайн» и EMS. Тип отправления влияет на набор обязательных полей: например, для наложенного платежа требуется указать сумму payment и объявленную ценность.

Регистрация отправления и получение трек-номера

Трек-номер появляется в момент регистрации отправления в системе Почты. Сценарий в RetailCRM:

1. В заказе выбран тип доставки «Почта России», заполнены адрес, индекс, вес и габариты.
2. Оператор нажимает «Создать отправление» (или это делает триггер при переходе в статус «Комплектация завершена»).
3. RetailCRM отправляет данные в сервис ОТПРАВКА, получает barcode (ШПИ) и записывает его в поле Трек-номер заказа.
4. ШПИ автоматически подставляется в уведомление клиенту через триггерную рассылку.

Через API это операция создания заказа в бэкенд-очереди отправлений, а затем формирования партии. Пример тела запроса в терминах интеграционного модуля:

{ "order": { "externalId": "10456", "delivery": { "code": "pochta-russia", "data": { "tariff": "online", "weight": 1200 } } } }

Автообновление статусов доставки

После регистрации RetailCRM периодически опрашивает сервис трекинга по каждому активному ШПИ и переносит движение отправления в карточку заказа. Статусы Почты нормализуются во внутренние статусы доставки CRM.

• Принято отделением связи → статус «Отправлено»;
• Обработка / покинуло сортировочный центр → «В пути»;
• Прибыло в место вручения → «Готово к выдаче»;
• Вручение адресату → «Доставлено»;
• Возврат отправителю → «Возврат».

Эти статусы удобно завязать на триггеры: например, при «Готово к выдаче» отправить клиенту SMS с адресом ОПС и сроком хранения, а при «Возврат» — поставить задачу менеджеру. Опрос трекинга происходит с интервалом, поэтому итоговый статус в CRM может отставать от сайта Почты на несколько часов — это нормально.

Типичные ошибки и как их читать

Большинство сбоев при регистрации — это некорректные или неполные данные заказа. RetailCRM показывает ответ Почты в логе модуля.

Отдельный класс проблем — расхождение веса и габаритов: если фактические параметры на отделении отличаются от заявленных, тариф пересчитают, и стоимость в заказе разойдётся с фактом. Стоит нормализовать весогабариты на этапе комплектации.

Итог

Интеграция Почты России в RetailCRM избавляет операторов от ручной регистрации на otpravka.pochta.ru: трек-номера присваиваются из карточки заказа, статусы подтягиваются автоматически, а уведомления клиентам уходят по триггерам. Чтобы это работало стабильно, нужен корректный договор, заполненные весогабариты и дисциплина закрытия партий.

Мы настраиваем модуль Почты «под ключ» — от подключения кабинета ОТПРАВКА и маппинга статусов до триггеров уведомлений и печати форм. Если в магазине несколько служб доставки, поможем выстроить единую логику отправлений и правила автоподстановки, чтобы Почта включалась там, где она выгоднее курьерских служб.