Интеграция 5Post с WooCommerce нужна интернет-магазину, когда покупатель должен увидеть доступные варианты доставки и ПВЗ прямо при оформлении заказа, а менеджер — не переносить данные между сайтом и службой доставки вручную.
5Post официально указывает, что его доставку можно встроить в интернет-магазин через API-решение. На стороне WooCommerce для этого есть штатный Shipping Method API, поэтому интеграцию можно сделать как отдельный плагин или аккуратный интеграционный модуль без правки ядра WooCommerce.
Что должна делать нормальная интеграция
Цепочка заказа
- КорзинаWooCommerce собирает состав заказа, вес, габариты и адресные данные.
- РасчётИнтеграция получает доступные варианты и стоимость доставки.
- ПВЗПокупатель выбирает точку получения на checkout.
- ЗаказПосле согласованного события данные передаются в службу доставки.
- СтатусыМагазин хранит внешний ID, трек-данные и состояние доставки.
Не каждому магазину нужны все пять этапов. Иногда достаточно расчёта и выбора ПВЗ, а создание отправления менеджер продолжает делать вручную. Поэтому перед разработкой важно определить, что именно автоматизируется.
Какие данные нужно подготовить в WooCommerce
Самая частая проблема интеграций доставки — не API, а неполные данные каталога. Для расчёта должны быть определены правила веса и габаритов для простых товаров, вариаций и комплектов.
- вес товара или упаковки;
- длина, ширина, высота;
- количество мест, если оно отличается от количества товаров;
- город/регион или выбранный ПВЗ;
- контактные данные, которые действительно нужны для доставки;
- правила для бесплатной доставки и исключений.
Если в половине карточек отсутствуют размеры, интеграция не должна молча придумывать их. Лучше явно определить fallback-правило или блокировать автоматический расчёт для некорректных позиций.
Как добавить 5Post как способ доставки WooCommerce
WooCommerce предоставляет Shipping Method API для расширений. Кастомный метод доставки обычно реализуется через класс на базе WC_Shipping_Method, который добавляет настройки и рассчитывает доступные rates. Это позволяет встроить интеграцию в стандартную систему shipping zones и checkout, а не подменять интерфейс случайным JavaScript.
Параметры подключения, тестовый/боевой режим и другие настройки лучше хранить на серверной стороне. API-ключи нельзя отдавать в браузер вместе с публичным JavaScript карты ПВЗ.
Выбор ПВЗ: храните ID, а не только адрес
Покупатель видит человекочитаемый адрес точки, но интеграции нужен устойчивый идентификатор. В заказе WooCommerce стоит сохранить как минимум ID выбранного ПВЗ и отображаемый адрес.
Это важно, потому что подпись точки или адрес могут со временем измениться. Служебный ID позволяет однозначно понять, что выбрал клиент, и корректно передать данные дальше.
Когда создавать отправление
Создавать отправление сразу при появлении заказа WooCommerce не всегда правильно: покупатель может не закончить оплату, платёжный шлюз может прислать повторный callback, а менеджер — изменить заказ. Триггер нужно выбирать по процессу магазина.
Обычно это один из вариантов:
- оплата успешно подтверждена;
- заказ переведён в согласованный статус;
- менеджер нажал отдельное действие «Передать в доставку»;
- внешняя CRM подтвердила готовность к отгрузке.
Идемпотентность: один заказ — одно отправление
Любой webhook или callback может прийти повторно. Поэтому обработчик должен проверять, сохранён ли внешний идентификатор отправления. Повторный запуск одного и того же события не должен создавать второй заказ в службе доставки.
| Ситуация | Что делать |
|---|---|
| Timeout после отправки запроса | Не отправлять повторно вслепую; сначала проверить результат по устойчивому ключу. |
| Повторный webhook оплаты | Проверить сохранённый внешний ID и завершить без дубля. |
| Ошибка в данных | Показать менеджеру понятную причину, а не бесконечно повторять запрос. |
| Временный 5xx | Использовать ограниченный retry с задержкой. |
Как синхронизировать статусы
Статус доставки и статус коммерческого заказа — разные сущности. Например, «прибыл в ПВЗ» не обязательно означает, что заказ WooCommerce должен стать Completed. Лучше сделать явную карту соответствий и менять основной статус магазина только для заранее согласованных событий.
Остальные транспортные статусы можно хранить отдельно в метаданных заказа и показывать менеджеру или клиенту.
Готовый модуль или кастомная интеграция
Готовое решение подходит, если используется стандартный checkout, простая схема склада и нет специальных правил расчёта. На рынке есть агрегаторы и модули, которые уже поддерживают 5Post вместе с другими службами доставки.
Кастомный плагин оправдан, когда нужны нестандартные тарифы, несколько складов, собственный checkout, B2B-логика, особая CRM/ERP, автоматическая маршрутизация или строгий контроль статусов.
Интеграция напрямую или через агрегатор
| Прямое API | Агрегатор |
|---|---|
| Полный контроль над логикой 5Post | Один интерфейс для нескольких служб |
| Больше собственной разработки и поддержки | Зависимость от возможностей посредника |
| Удобно для нестандартного процесса | Удобно для типовой мультидоставки |
Выбор зависит не от того, что «технически моднее», а от процесса магазина. Если завтра планируется подключить ещё СДЭК, Яндекс Доставку и Почту России, единый слой может быть выгоднее нескольких отдельных интеграций.
Безопасность
- секреты и токены только на сервере;
- минимум персональных данных в debug-логах;
- отдельный тестовый режим, если его предоставляет провайдер;
- проверка прав для административных действий;
- валидация входящих webhook и подписей, если механизм предусмотрен договором/API;
- контролируемые retries и журнал ошибок.
Чек-лист перед запуском 5Post в WooCommerce
- У всех доставляемых товаров определены вес и габариты.
- Определено, какие зоны и методы доставки доступны покупателю.
- ID выбранного ПВЗ сохраняется в заказе.
- Расчёт стоимости проверен на разных корзинах и регионах.
- Определён триггер создания отправления.
- Повторный callback не создаёт дубли.
- Статусы доставки не смешаны со статусами оплаты.
- API-секреты не доступны во frontend.
- Есть журнал ошибок и понятный ручной fallback.
- Тестовый заказ пройден от корзины до получения.
Что входит в разработку интеграции
В A.S Groups можно подключить 5Post к существующему WooCommerce-магазину или заложить интеграцию в новый проект. Состав работ фиксируется после проверки checkout, структуры каталога, текущих плагинов доставки и требований к автоматизации.
Обычно задача включает аудит данных, способ доставки, выбор ПВЗ, серверную работу с API, сохранение служебных полей заказа, обработку ошибок и тестирование ключевых сценариев. Если магазин уже использует несколько служб, можно спроектировать общий слой доставки.
Частые вопросы
Можно ли показать ПВЗ 5Post прямо на checkout?
Да, если выбранный вариант интеграции предоставляет данные точек и интерфейс выбора. Конкретная реализация зависит от API или используемого агрегатора.
Можно ли автоматически считать стоимость?
Да, при наличии необходимых тарифных данных и корректного веса/габаритов товаров.
Обязательно ли писать свой плагин?
Нет. Для типового магазина может подойти готовый модуль или агрегатор. Кастом нужен при нестандартной бизнес-логике.
Можно ли одновременно оставить другие службы доставки?
Да. WooCommerce рассчитан на несколько shipping methods; правила доступности можно настроить по зонам и условиям.
Источники
- 5Post — интеграция интернет-магазинов через API-решение
- WooCommerce — Shipping Method API
- WooCommerce APIs
Если нужно подключить 5Post к WooCommerce, можно прислать ссылку на магазин и описать желаемый сценарий доставки. Для нового проекта также доступна разработка WooCommerce-магазина под ключ.
Обсуждение
Вопросы и комментарии
Можно уточнить детали статьи или поделиться своим опытом. Первый комментарий проходит проверку.