Подключение Почты России к Битрикс

Почта России остаётся базовой службой доставки почти для любого магазина на 1С-Битрикс: она покрывает населённые пункты, куда не едут коммерческие курьеры. Разберём, как подключить расчёт тарифов и оформление отправлений так, чтобы клиент видел корректную стоимость в корзине, а менеджер не считал индексы вручную.

Варианты подключения

В отличие от СДЭК или DPD, у Почты России нет единственного «официального» модуля в комплекте 1С-Битрикс. На практике используют три пути, и выбор зависит от того, нужен вам только расчёт стоимости или полный цикл до печати ярлыков.

• Тарификатор без авторизации — публичный сервис tariff.pochta.ru считает стоимость и срок по индексам и весу. Не требует договора, подходит, если печать отправлений ведётся в стороннем ЛК.
• API Отправки (otpravka-api) — https://otpravka-api.pochta.ru. Полноценная интеграция: создание заказов, трек-номера, партионная печать. Нужен договор и токены.
• Готовый модуль из Marketplace — решения вроде «ipol.Почта России» или отраслевых сборок, которые уже содержат обработчик службы доставки и связь с ЛК.

Что подготовить до настройки

Расчёт тарифов работает и без договора, но как только вы хотите передавать заказы в Почту и печатать бланки, потребуется доступ в Личный кабинет Отправка (otpravka.pochta.ru). Оттуда берутся ключи для API.

1. Зарегистрируйте организацию или ИП в ЛК Отправка и заключите договор на приём отправлений.
2. В разделе настроек получите Токен авторизации (заголовок Authorization: AccessToken).
3. Сформируйте ключ пользователя в формате Basic — он передаётся в заголовке X-User-Authorization.
4. Уточните индекс пункта отправления — он подставляется в расчёт как точка старта.

Эти три параметра (токен, ключ, индекс склада) — минимальный набор для любого модуля или самописной обработки. Тарификатор tariff.pochta.ru ключей не требует.

Настройка службы доставки в админке

Служба доставки создаётся в разделе Магазин → Настройки → Службы доставки. Нажмите «Добавить службу» и в списке обработчиков выберите тот, что дал установленный модуль Почты России (в коробочном ядре готового обработчика нет — он появляется после установки решения из Marketplace).

В карточке службы заполняются:

• Профили — типы отправлений: посылка обыкновенная, посылка 1 класса, EMS. Каждый профиль клиент видит как отдельный способ в корзине.
• Ограничения — вес, габариты, группы местоположений, для которых доступна служба.
• Учёт НДС и наценка — если вы закладываете упаковку или страховку в стоимость доставки.

Как считается тариф

Ключевой параметр расчёта у Почты России — не город, а почтовый индекс. Модуль передаёт индекс отправителя, индекс получателя, вес в граммах и тип отправления, а сервис возвращает стоимость и контрольный срок. Поэтому корректность расчёта напрямую зависит от того, как в вашем оформлении заказа определяется индекс покупателя.

Если в оформлении заказа используется только выбор города без ввода индекса, добавьте свойство типа «Местоположение» с привязкой к почтовым индексам либо отдельное поле «Индекс». Иначе для крупных городов с десятками индексов расчёт будет усреднённым и неточным.

Оформление и печать отправлений

Расчёт в корзине — только половина задачи. Второй контур — передача оформленного заказа в Почту. Через API Отправки модуль создаёт отправление, получает трек-номер и позволяет печатать сопроводительные документы, не заходя в ЛК вручную.

• Единичное оформление — из карточки заказа в админке создаётся отправление, трек записывается в свойство заказа и уходит покупателю в письме.
• Партионная отправка — заказы за день выгружаются пачкой, печатаются форма 103 (список) и адресные ярлыки Ф7.
• Отслеживание статусов — по трек-номеру подтягивается движение отправления, что удобно связать с этапами заказа.

Типичные ошибки

Большинство обращений после подключения сводится к нескольким повторяющимся ситуациям.

• Нулевая или пустая стоимость. Чаще всего не заполнены индексы в местоположениях или у товаров нулевой вес — тарификатор не может посчитать посылку без массы.
• Ошибка авторизации API. Перепутаны заголовки: Authorization ждёт токен доступа, а X-User-Authorization — ключ пользователя в Basic. Их нельзя менять местами.
• Расхождение цены с реальной. Не учтены надбавки за объявленную ценность и наложенный платёж — их закладывают наценкой в профиле или отдельной логикой.
• Таймауты в корзине. Внешний запрос к сервису Почты на каждый пересчёт замедляет оформление; помогает кэширование результатов расчёта по ключу «индекс + вес».

Итог

Подключение Почты России к 1С-Битрикс — это два независимых контура: расчёт тарифа по индексу и весу в корзине и оформление отправлений с трек-номерами через ЛК Отправка. Для расчёта хватает публичного тарификатора, для полного цикла нужны договор и токены API. Критичнее всего здесь корректная работа с почтовыми индексами и весами товаров — именно они определяют точность стоимости.

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