5Post и постаматы: подключение

5Post — логистический сервис на базе сети постаматов и пунктов выдачи в магазинах X5 (Пятёрочка, Перекрёсток). Это дешёвый и плотный по покрытию канал самовывоза. Разберём, как подключить 5Post к RetailCRM, настроить выбор постамата в заказе, учитывать габаритные ячейки и вести статусы доставки в CRM.

Чем 5Post отличается от классических служб

5Post работает через постаматы и пункты выдачи, размещённые в торговых точках сети X5. Для магазина это способ отдавать заказы близко к дому клиента при низкой стоимости последней мили. В отличие от курьерской доставки, здесь нет вручения «до двери» — только самовывоз из ячейки или на кассе ПВЗ.

Ключевые особенности, которые влияют на настройку:

• доставка идёт только до постамата/ПВЗ, адрес двери не используется;
• ячейки постаматов ограничены по габаритам — крупный товар не поместится;
• у постамата ограниченный срок хранения посылки;
• наложенный платёж поддерживается не во всех точках — зависит от оборудования.

Подключение модуля 5Post

5Post подключается как модуль доставки из Администрирование → Интеграция → Модули. Для авторизации нужен токен API, который выдают в личном кабинете 5Post по договору. Реквизиты вносятся в настройки модуля.

Что задаётся при подключении:

• Токен API (ключ доступа) — авторизация запросов;
• Идентификатор отправителя / договор — определяет тарифы;
• Пункт приёма — откуда 5Post забирает или куда магазин сдаёт посылки;
• Тип оплаты доставки — за счёт магазина или получателя.

После установки в справочнике Настройки → Справочники → Типы доставки появляется тип «5Post», а в карточке заказа — блок с выбором постамата и стоимости доставки.

Выбор постамата и габаритные ячейки

Список постаматов и ПВЗ подтягивается из API 5Post по городу получателя. При выборе точки важно учитывать габариты ячейки: если посылка не помещается в максимальный доступный размер, отправление не примут.

Габариты ячеек — ориентировочные и зависят от модели постамата. RetailCRM передаёт весогабариты заказа при создании отправления, поэтому их важно заполнять корректно, иначе 5Post отклонит регистрацию по превышению размера.

Создание отправления и трек-номер

Отправление создаётся из карточки заказа кнопкой «Создать отправление» или триггером при готовности к отгрузке. RetailCRM передаёт в 5Post состав заказа, весогабариты, код постамата и данные получателя, а в ответ получает трек-номер и этикетку.

1. В заказе выбран тип доставки «5Post» и конкретный постамат/ПВЗ.
2. Заполнены вес, габариты и телефон получателя (нужен для кода получения из ячейки).
3. Оператор создаёт отправление — трек-номер записывается в поле заказа.
4. Этикетка со штрихкодом печатается для наклейки на посылку.

Условно тело запроса к интеграции:

{ "delivery": { "code": "fivepost", "data": { "pointId": "POST-7788", "weight": 700, "payment": 0 } } }

Клиент получает уведомление с адресом постамата и кодом доступа к ячейке — его 5Post отправляет по SMS.

Статусы доставки в CRM

RetailCRM опрашивает 5Post по трек-номерам и нормализует статусы во внутренние статусы доставки, чтобы операторы видели картину по всем отправлениям в списке заказов.

• Отправление принято → «Отправлено»;
• В пути / на сортировке → «В пути»;
• Загружено в постамат / готово к выдаче → «Готово к выдаче»;
• Получено клиентом → «Доставлено»;
• Истёк срок хранения → «Возврат».

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

Типичные ошибки подключения

Ответ API 5Post виден в логе модуля — по нему определяется причина отказа.

Справочник точек 5Post стоит запрашивать динамически: сеть постаматов активно меняется, точки открываются и закрываются, а переполненный постамат временно не принимает новые посылки.

Итог

Подключение 5Post к RetailCRM открывает дешёвый и плотный канал самовывоза через постаматы и ПВЗ сети X5. Из карточки заказа доступны выбор точки, создание отправления с трек-номером и автоматические статусы. Важно контролировать габариты под ячейки, корректный телефон получателя и короткий срок хранения.

Мы подключаем 5Post, настраиваем справочник точек, триггеры напоминаний и правила, по которым постаматы предлагаются под подходящие по габаритам заказы. Если у вас несколько служб доставки, соберём их в единую логику отгрузок, чтобы операторы работали в одном окне RetailCRM и не заходили в кабинеты перевозчиков.