5Post — доставка в точки выдачи X5

Модуль подключает 5Post к ADWOS CMS и помогает владельцу сайта принимать заказы с выдачей в магазинах и постаматах X5.

---

Что умеет

• Проверка доступа. Получает JWT по apikey партнёра и показывает, что ключ принят API 5Post.
• Точки выдачи. Загружает активные пункты выдачи через POST /api/v1/pickuppoints/query.
• Создание заказа. Передаёт заказ в 5Post через POST /api/v1/createOrder.
• Статус заказа. Запрашивает состояние отправления через POST /api/v1/getOrderStatus.
• Отмена заказа. Отменяет отправление по orderId или senderOrderId через актуальные v2-методы 5Post.

---

Как настроить

1. Получите у менеджера 5Post партнёрский apikey и partnerLocationId склада или точки отгрузки.
2. Согласуйте с 5Post рабочую среду: preprod для тестов или production для боевых заказов.
3. В админке ADWOS откройте модуль 5Post, заполните API key, режим среды, partnerLocationId и бренд отправителя для SMS.
4. Сначала выполните проверку токена через /jwt, затем загрузите точки выдачи через /pickup-points.
5. Для боевого запуска проверьте создание тестового заказа в согласованной среде и убедитесь, что статусы возвращаются по вашему senderOrderId.

---

Важно знать

• Справочник точек выдачи 5Post лучше обновлять один раз в сутки после 05:00 по Москве.
• Формат этикетки согласуется с ответственным менеджером 5Post; модуль не обещает отдельное скачивание PDF или ZIP, если такой маршрут не выдан партнёру.
• Секретные значения храните только в защищённых полях настроек ADWOS.