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-денний тріал.