BOX NOW для WooCommerce — доставка в почтоматы Греции, Кипра, Болгарии и Хорватии

CatCode BOX NOW Lockers for WooCommerce — доставка в почтоматы BOX NOW для магазинов в Греции, на Кипре, в Болгарии и Хорватии. Покупатель выбирает почтомат на карте BOX NOW прямо на чекауте, магазин создаёт накладную и печатает этикетку из карточки заказа, а наложенный платёж BOX NOW принимает в самом почтомате.

Как это выглядит для покупателя

Если покупатель не выбрал почтомат или выбрал почтомат другой страны, заказ не принимается — и на классическом чекауте, и через Store API блочного чекаута или экспресс-кнопок. Проверка делается на сервере, поэтому обойти её со стороны браузера не получится. Другие способы доставки при этом никогда не блокируются.

Что получает админ

• Накладная из карточки заказа — одна кнопка. Номер посылки, состояние и ссылка на отслеживание сразу в блоке и в заметках.
• PDF-этикетка открывается из того же блока. Этикетки нескольких посылок (Pro) собираются в один PDF на бумаге A6 или A4.
• Отмена посылки, пока BOX NOW её ещё не забрал.
• Ручная смена почтомата в заказе, пока по нему нет активных посылок.
• Наложенный платёж для выбранных способов оплаты: покупатель платит сумму заказа в почтомате. Лимит суммы проверяется ещё до запроса в BOX NOW.
• Настройки в одном месте: WooCommerce → BOX NOW. Хост API (пресеты или свой из письма BOX NOW), client ID и secret, кнопка «Проверить подключение» со списком складов, отправитель, возвраты, язык карты, геолокация, журнал.
• Понятные тексты ошибок вместо кодов: P400–P467 переведены в человеческие объяснения — что именно не так с телефоном, адресом, суммой наложенного платежа или состоянием посылки.

Как это работает — шаг за шагом

1. Вы добавляете способ доставки «BOX NOW locker (CatCode)» в зону Греции, Кипра, Болгарии или Хорватии: цена, бесплатно от суммы, лимит веса на посылку.
2. Покупатель видит способ только тогда, когда адрес — GR, CY, BG или HR и корзина физически помещается в ячейку почтомата (60 × 45 см, высота 8, 17 или 36 см).
3. Покупатель открывает карту и выбирает почтомат. Выбор сохраняется в сессии WooCommerce и показывается в блоке под способами доставки.
4. Сервер проверяет выбор при оформлении: нет почтомата или почтомат в другой стране — заказ не создаётся.
5. Заказ хранит почтомат в мета (совместимо с HPOS), показывает его на «Заказ получен», в аккаунте и в письмах.
6. Вы создаёте накладную из карточки заказа — или, с Pro, она создаётся сама, как только заказ переходит в выбранный статус.
7. Печатаете этикетку PDF и отдаёте посылку курьеру BOX NOW со своего склада.
8. С Pro статусы посылок подтягиваются каждый час и ложатся в заметки, а когда покупатель забрал все посылки — заказ можно автоматически переводить в «Выполнен».

Что под капотом

• Проверка на сервере, а не в браузере. Классический чекаут проверяется в woocommerce_after_checkout_validation, блочный и экспресс-кнопки — в Store API. Подделать выбор почтомата через консоль не выйдет.
• Сообщения от карты принимаются только от нашего iframe и только с домена boxnow.*, так что сторонняя страница не подсунет магазину чужой почтомат.
• Защита от двойной доставки. Заказ блокируется на уровне базы (GET_LOCK), а номер накладной детерминированный: <номер заказа>-<попытка>, и счётчик растёт только после успеха. Поэтому повтор после таймаута даёт от BOX NOW отказ «такой номер уже есть», а не вторую посылку.
• Client secret хранится в базе зашифрованным, а запросы идут только на хосты boxnow.* — произвольный хост в настройки не вписать.
• Упаковка считается локально: размеры ячеек 60 × 45 см с высотой 8, 17 и 36 см, корзина раскладывается по посылкам по высоте (в Free — одна посылка, в Pro — до десяти).
• Токен API кешируется и обновляется сам; просроченный токен даёт ровно один повтор запроса, а не бесконечный цикл.
• Pro-гейт без «кирпича»: когда триал закончился, отключаются только Pro-возможности. Доставка, карта, накладные и этикетки работают дальше.
• Переводы: украинский и греческий, исходные строки английские.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите catcode-box-now-lockers-for-woocommerce-1.0.2.zip и активируйте.
2. WooCommerce → BOX NOW: выберите хост API, впишите client ID и client secret, сохраните.
3. Нажмите «Проверить подключение» и выберите склад, с которого BOX NOW будет забирать посылки.
4. Заполните отправителя: название, телефон в международном формате, e-mail.
5. WooCommerce → Настройки → Доставка → ваша зона (Греция, Кипр, Болгария, Хорватия) → Добавить способ доставки → «BOX NOW locker (CatCode)». Укажите цену, бесплатно от суммы и лимит веса.
6. Для наложенного платежа отметьте в настройках способы оплаты, которые BOX NOW должен принимать в почтомате.
7. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал.