5Post — логистическая сеть X5 с постаматами и ПВЗ в «Пятёрочке» и «Перекрёстке». К 1С-Битрикс она подключается через API: справочник точек, расчёт доставки, создание отправлений и получение статусов.
Что такое 5Post и её особенность
5Post — служба доставки экосистемы X5 Retail Group. Её ключевая ценность — плотная сеть постаматов и пунктов выдачи в магазинах «Пятёрочка» и «Перекрёсток», особенно удобная для лёгких посылок B2C.
- Доставка преимущественно до постамата и ПВЗ, а не курьером до двери.
- Ограничения по весу и габаритам — постаматы рассчитаны на небольшие отправления.
- Работа по договору и через API личного кабинета отправителя.
Для магазина это значит: 5Post хорошо ложится как дополнительная дешёвая опция «до точки», рядом с курьерскими службами.
С чего начинается подключение
Готового коробочного обработчика 5Post в 1С-Битрикс нет — подключают через модуль Маркетплейса или собственную интеграцию с API. Порядок такой.
- Заключить договор с 5Post и получить доступ в кабинет.
- Получить ключи API (токен авторизации) и идентификатор договора/отправителя.
- Настроить в Битриксе службу доставки-профиль 5Post и прописать реквизиты.
- Проверить отправку на тестовом контуре до запуска.
Справочник постаматов и ПВЗ
Точки выдачи 5Post отдаются через API. Из-за большого объёма сети их удобнее не запрашивать онлайн на каждом оформлении, а хранить локально.
| Подход | Плюсы | Минусы |
|---|---|---|
| Онлайн-запрос | Всегда актуально | Зависит от API при оформлении |
| Импорт в Highload-блок | Быстрая карта, автономность | Нужен регулярный апдейт |
Оптимально — выгружать справочник по расписанию (cron/агент) в Highload-блок, а на витрине показывать точки на карте с фильтром по городу и типу «постамат/ПВЗ». Выбранная точка пишется в свойство заказа.
Расчёт доставки и оформление
Стоимость 5Post считается через её API по весу, габаритам и точке назначения. В Битриксе это профиль службы доставки, который в методе calculate() возвращает цену и срок.
- Вес и габариты берутся из карточек товаров каталога.
- Точка назначения — выбранный постамат или ПВЗ.
- Результат кэшируется на несколько минут ради скорости корзины.
На шаге оформления 5Post показывается вместе с другими службами. Логично ограничить её только теми регионами и весами, где сеть реально работает — через механизм ограничений службы.
Создание отправлений и штрихкоды
После оформления заказ передаётся в 5Post: создаётся отправление, назначается точка, возвращаются трек-номер и штрихкод. Как правило, работа идёт партиями (реестрами) отправлений.
- Формирование заказа в API с указанием точки выдачи и содержимого.
- Получение трек-номера и печатной формы (этикетки со штрихкодом).
- Передача реестра/манифеста при отгрузке партии.
Статусы и возвраты
Статусы отправлений (принято, в пути, в постамате, выдано, истёк срок хранения) забираются из API по расписанию. Для постаматной доставки статус «истёк срок хранения» особенно важен — по нему запускают возврат.
- Опрос статусов агентом Битрикса или по cron.
- Автоматическое обновление статуса заказа и уведомление клиента.
- Обработка невыкупа: возврат отправления и корректный статус заказа.
Статусы стоит маппить на статусы заказа Битрикса, чтобы менеджер видел ситуацию без захода в кабинет 5Post.
Когда выбирать 5Post
5Post — не универсальная служба на все случаи, а точечная опция. Она максимально выгодна для лёгких недорогих товаров массового спроса, когда покупателю удобно забрать заказ в ближайшей «Пятёрочке».
| Сценарий | 5Post | Альтернатива |
|---|---|---|
| Лёгкая посылка до постамата | Оптимально | — |
| Крупногабарит и тяжёлый груз | Не подходит | ТК (ПЭК, Деловые Линии) |
| Срочно в тот же день | Не про это | Экспресс (Достависта) |
| Доставка до двери | Ограниченно | Курьерские службы |
Поэтому 5Post ставят рядом с курьерскими службами и транспортными компаниями, а не вместо них — покупатель сам выбирает удобный и недорогой вариант на шаге доставки.
Итог
5Post даёт магазину дешёвую доставку до постаматов и ПВЗ сети X5. Подключение к 1С-Битрикс — это API-интеграция: локальный справочник точек, расчёт по весу и габаритам, ограничения по лимитам ячеек, создание отправлений со штрихкодами и трекинг с обработкой невыкупа.
Мы в B2Bsite подключаем 5Post как одну из опций в общем блоке доставки, аккуратно ограничивая её по весу и географии. Настраиваем импорт точек, создание реестров и обмен статусами, чтобы менеджеры работали в одном окне.
Частые вопросы
Куда доставляет 5Post?
В основном до постаматов и пунктов выдачи сети X5 — «Пятёрочка» и «Перекрёсток». Это удобная и недорогая опция для небольших посылок.
Есть ли готовый модуль для Битрикса?
В коробке нет. Подключают через модуль Маркетплейса или собственную интеграцию с API 5Post по договору и токену.
Как показать постаматы на сайте?
Справочник точек выгружают из API в Highload-блок по расписанию и показывают на карте с фильтром по городу и типу. Так карта работает быстро.
Есть ли ограничения по весу и размеру?
Да, ячейки постаматов рассчитаны на небольшие отправления. Эти лимиты задают как ограничения службы, чтобы 5Post не предлагался для крупногабарита.
Как передаются заказы в 5Post?
Через API создаётся отправление с точкой выдачи, возвращается трек-номер и штрихкод. Обычно отгрузка идёт партиями-реестрами.
Что делать при невыкупе?
По статусу истёкшего срока хранения запускается возврат. Статус заказа обновляется автоматически, менеджер видит ситуацию в Битриксе.
Как избежать дублей отправлений?
Перед повторной передачей проверяйте, есть ли у заказа сохранённый трек-номер. Это обеспечивает идемпотентность и защищает от задвоения.
Обновляются ли статусы автоматически?
Да, их забирают из API по расписанию агентом или cron и маппят на статусы заказа Битрикса, уведомляя клиента.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.