Почта России остаётся обязательной опцией для магазинов с доставкой в малые города и посёлки, куда не дотягиваются коммерческие службы. Интеграция с 1С-Битрикс здесь строится на двух отдельных API и тарификации по почтовым индексам. Показываем, как собрать расчёт, партионную отправку и трекинг без ручного ввода в личном кабинете.
Из чего складывается интеграция
У Почты России нет единого модуля «всё в одном» — интеграция собирается из нескольких сервисов, и это нужно понимать заранее.
- Tariff API — расчёт стоимости и сроков (
tariff.pochta.ru). Работает без авторизации, считает по индексам отправителя и получателя. - API «Отправка» — личный кабинет отправителя (
otpravka-api.pochta.ru): партии, заказы, ярлыки, формы Ф-103. - Трекинг — сервис отслеживания РПО по трек-номеру.
В 1С-Битрикс каждый сервис подключается как часть обработчика доставки в модуле sale. Официальный модуль Почты России из Маркетплейса объединяет расчёт и создание отправлений, но на боевых проектах мы часто дописываем логику под конкретный склад и типы отправлений.
Доступ и авторизация
Для API «Отправка» нужны два ключа. Первый — токен авторизации приложения, он выдаётся в личном кабинете отправителя. Второй — ключ авторизации пользователя: строка login:password, закодированная в Base64.
Оба передаются в заголовках каждого запроса:
Authorization: AccessToken ваш_токенX-User-Authorization: Basic base64(login:password)
Расчёт по индексам
Главная особенность Почты — тарификация по почтовым индексам, а не по городам. Значит, на шаге доставки нужно надёжно получить индекс получателя. Варианты: спросить индекс напрямую, определить его по адресу через справочник, или подтянуть по выбранному отделению.
- Определяем индекс отправителя (склад) и получателя.
- Задаём тип отправления: посылка онлайн, курьер онлайн, EMS.
- Передаём вес и объявленную ценность.
- Получаем стоимость и контрольные сроки.
Обратите внимание на разделение услуги и объявленной ценности: страховка считается от суммы, которую вы объявили, а не от суммы заказа. Для наложенного платежа передаётся отдельный параметр суммы к получению.
Партионная отправка и ярлыки
Через API «Отправка» магазин избавляется от ручного заполнения бланков. Логика такая: заказы копятся в партию, партия закрывается, система отдаёт готовые ярлыки и форму Ф-103 для сдачи на почту.
| Шаг | Метод API «Отправка» |
|---|---|
| Создать заказ в ЛК | POST /1.0/user/backlog |
| Сформировать партию | POST /1.0/batch |
| Печать ярлыков | GET /1.0/forms/{id}/f7p |
| Сопроводительный лист Ф-103 | GET /1.0/forms/backlog/{id}/f103 |
Трек-номер (РПО, 14 знаков) присваивается при формировании партии и сохраняется в свойство заказа. С этого момента менеджеру не нужно вбивать адреса вручную — всё уходит из карточки заказа.
Трекинг и статусы
Отслеживание у Почты России исторически шло через SOAP-сервис единого трекинга, есть и пакетный доступ для больших объёмов. По трек-номеру возвращается цепочка операций: приём, обработка в сортировочном центре, прибытие в отделение, вручение.
На стороне Битрикса удобно завести агент, который раз в несколько часов опрашивает статусы активных РПО и меняет статусы заказов. Для крупных магазинов лучше использовать пакетный трекинг, чтобы не упереться в лимиты по количеству запросов.
- Храните трек-номер в свойстве заказа и показывайте его клиенту в личном кабинете.
- Сопоставьте коды операций Почты со статусами заказа в вашей воронке.
- Закрывайте опрос по вручённым и возвращённым отправлениям, чтобы не жечь лимиты.
Особенности, о которых забывают
Почта России отличается от коммерческих служб рядом деталей, которые всплывают уже в бою.
- Разные типы отправлений. Посылка онлайн, курьер онлайн и EMS считаются по-разному — не сводите всё к одной услуге.
- Ограничения по весу и габаритам. У каждого типа свои лимиты; крупногабарит уходит только определёнными услугами.
- Отделение vs курьер. Для выдачи в отделении покупателю нужен индекс ОПС, для курьера — полный адрес.
- Наложенный платёж и комиссия. Учитывайте комиссию за перевод наложенного платежа при формировании цены.
- Актуальность справочников. Индексы и отделения меняются — обновляйте данные и не хардкодьте значения.
Итог
Интеграция Почты России с 1С-Битрикс — это связка Tariff API для расчёта по индексам и API «Отправка» для партий, ярлыков и трек-номеров, плюс регулярный трекинг статусов. Официальный модуль закрывает базовый сценарий, но реальные магазины почти всегда требуют настройки под типы отправлений, веса и склад.
Мы в B2Bsite подключаем Почту России так, чтобы менеджер не заходил в личный кабинет вручную: расчёт по индексам в корзине, автоматическая партионная отправка, печать Ф-103 и ярлыков, трек-номера и статусы прямо в заказе. При необходимости связываем всё это с 1С и другими службами в едином окне доставки.
Частые вопросы
Нужен ли договор с Почтой России для расчёта в корзине?
Нет. Tariff API для расчёта стоимости и сроков работает без авторизации по индексам. Договор и доступ к личному кабинету нужны для создания отправлений, печати ярлыков и трекинга через API Отправка.
По каким данным Почта считает доставку?
По почтовым индексам отправителя и получателя, типу отправления, весу и объявленной ценности. Поэтому на шаге доставки важно корректно определить индекс получателя.
Что такое партионная отправка?
Это формирование пачки отправлений в личном кабинете: заказы собираются в партию, система выдаёт трек-номера, ярлыки и сопроводительную форму Ф-103 для сдачи на почту без ручного заполнения бланков.
Как получить трек-номер заказа?
Трек-номер РПО присваивается при формировании партии через API Отправка и сохраняется в свойство заказа в Битриксе. Его можно показывать покупателю в личном кабинете.
Можно ли автоматически обновлять статусы доставки?
Да. Агент в Битриксе периодически опрашивает трекинг по активным трек-номерам и меняет статусы заказов. Для больших объёмов используется пакетный трекинг, чтобы не превышать лимиты.
Поддерживается ли наложенный платёж?
Да, Почта России поддерживает оплату при получении. При расчёте нужно учитывать комиссию за перевод наложенного платежа и передавать сумму к получению отдельным параметром.
Чем посылка онлайн отличается от EMS?
Это разные услуги с разной стоимостью, сроками и лимитами по весу и габаритам. EMS быстрее и дороже, посылка онлайн дешевле. В расчёте их нужно разделять, а не сводить к одному тарифу.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.