VibeFox PostNL for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша версія.

WooCommerce: 7.0 або новіша, встановлений та активний. Плагін не активується без нього.

PHP: 8.0 або новіша.

Ключ API PostNL (лише для пунктів видачі): пункти видачі завантажуються з PostNL Checkout API. Бізнес-клієнти PostNL знаходять ключ API у Mijn PostNL за шляхом My account > API beheren. Для sandbox PostNL потрібен окремий ключ sandbox. Способи доставки на адресу ключа не потребують.

Ліцензійний ключ VibeFox: купується на vibefox.net. Один ключ працює на одному домені.

Встановлення

1. У WordPress перейдіть до Plugins > Add New > Upload Plugin, виберіть ZIP-файл плагіна і натисніть Install Now. Також можна завантажити папку vfd_postnl до /wp-content/plugins/ через FTP.

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Shipping > VibeFox PostNL або натисніть Settings під назвою плагіна на сторінці Plugins.

4. Введіть ліцензійний ключ VibeFox у блоці ліцензії вгорі сторінки і натисніть Activate.

5. Заповніть ціни. Для пунктів видачі також введіть API key PostNL і Ship from (postcode) (див. Налаштування).

6. Додайте VibeFox PostNL до зони доставки в WooCommerce > Settings > Shipping > Shipping zones, наприклад Нідерланди та Бельгія. У зоні встановіть Title і Delivery to. Додайте спосіб удруге для іншого типу доставки.

Налаштування

Усі налаштування, окрім назви та типу доставки, розміщені на одній сторінці: WooCommerce > Settings > Shipping > VibeFox PostNL. Вони діють для всіх зон доставки. Коли ви додаєте спосіб до зони, вікно зони має два поля:

Title (zone): назва, яку бачить покупець для цього способу в зоні. Залиште порожнім, щоб використовувати глобальне Name.

Delivery to (zone): As in the global settings (за замовчуванням), PostNL pickup point (customer chooses a point) або Home address. Додайте спосіб до зони двічі, щоб пропонувати обидва варіанти.

Над налаштуваннями сторінка показує попередження: відсутній ключ API або поштовий індекс відправлення для пунктів видачі, увімкнений sandbox, не встановлено жодної ціни, а також останній невдалий запит до PostNL з датою і помилкою.

Загальні

Enable/Disable: вмикає або вимикає доставку PostNL в усіх зонах одночасно.

Name: назва способу доставки, яку бачить покупець на оформленні замовлення. Назву Title, встановлену в зоні, вона замінює. За замовчуванням: PostNL.

Delivery to: тип доставки за замовчуванням для способів зон із As in the global settings та для режиму Ignore zones.

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає.

API PostNL (пункти видачі) (для доставки на адресу не потрібно)

API key: ваш ключ API PostNL з Mijn PostNL (My account > API beheren). Він надсилається до PostNL в заголовку «apikey», зберігається в базі даних WordPress і ніколи не показується покупцям та не записується в журнал.

Sandbox: використовує sandbox PostNL (api-sandbox.postnl.nl) з ключем API sandbox. Тоді покупці бачитимуть тестові пункти видачі. У робочому магазині тримайте вимкненим.

Ship from (country): країна, з якої ви передаєте посилки PostNL, Нідерланди або Бельгія. За замовчуванням це країна вашого магазину. PostNL використовує адресу відправника для дати забору.

Ship from (postcode): поштовий індекс відправника, наприклад 1234AB у Нідерландах або 1000 у Бельгії. Залиште порожнім, щоб використовувати поштовий індекс магазину з WooCommerce > Settings > General, якщо магазин у тій самій країні. Недійсний індекс відхиляється з повідомленням. Коли ви змінюєте ключ API, налаштування sandbox або адресу відправлення, кешовані списки пунктів видачі очищаються.

Ціни (у валюті магазину)

PostNL не має публічного API тарифів, тому плагін не запитує тарифи в реальному часі й ніколи не конвертує ціни.

Price per country: один рядок на країну призначення. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити. Оберіть * All other countries для рядка, що охоплює всі країни без власного рядка. Кожен рядок має Price і необов'язкові вагові класи за вагою кошика: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг і XL понад 5 кг. Ціна вагового класу замінює Price; залиште її порожньою, щоб використовувати Price. Price 0 означає безкоштовну доставку. Приймаються і «6.95», і «6,95». Порожні рядки та невалідні коди країн видаляються під час збереження. Якщо країна трапляється двічі, зберігається перший рядок. Невалідні ціни ігноруються з повідомленням.

Calculation: Per order стягує ціну один раз. Per item (price x quantity) множить її на кількість товарів у кошику, які можна відправити.

Price for other countries: використовується, якщо в таблиці немає ні країни, ні рядка *. Залиште порожнім, щоб приховати спосіб там.

Умови

Free shipping from: сума кошика, починаючи з якої доставка безкоштовна. Діє лише там, де знайдено ціну. Залиште порожнім, щоб ніколи не пропонувати безкоштовну доставку.

Minimum subtotal: показувати спосіб, лише якщо проміжна сума кошика не менша за цю суму. Залиште порожнім, щоб показувати завжди.

Minimum weight (kg): приховати спосіб, якщо кошик важить менше. Ваги товарів перераховуються з одиниці вимірювання вашого магазину. Залиште порожнім, щоб не мати обмеження.

Maximum weight (kg): приховати спосіб для важчих кошиків. За замовчуванням: 30 (посилки PostNL у Benelux важать до 30 кг). Залиште порожнім, щоб не мати обмеження.

Hide for shipping classes: приховати спосіб, якщо в кошику є товар із будь-якого з цих класів доставки WooCommerce.

Усі суми та ваги приймають десятковий кому, також із роздільником тисяч (1.234,50 або 1,234.50). Невірне число ігнорується з повідомленням.

Доступність без зон доставки

Ignore zones: пропонувати PostNL також у країнах нижче, коли жодна зона його не додає. Зони, що містять спосіб, працюють як звичайно. Цей режим використовує глобальні Name і Delivery to.

Countries: країни призначення для цього режиму. Залиште порожнім, щоб використовувати всі країни, куди магазин доставляє. Це поле використовується лише коли ввімкнено Ignore zones.

Додатково

Debug log: записує налагоджувальні повідомлення в WooCommerce > Status > Logs (джерело «vfd-postnl»). Помилки API завжди записуються. Ключ API та дані покупців не записуються. Вимкніть журнал, коли закінчите.

Remove data on uninstall: якщо увімкнено, видалення плагіна стирає налаштування PostNL і способи зон. Деактивація плагіна ніколи не видаляє налаштування. Пункти видачі, збережені в замовленнях, завжди зберігаються.

Як це працює на оформленні замовлення

Коли покупець вводить адресу доставки, WooCommerce запитує в плагіна тариф. Плагін перевіряє умови: вагу кошика, мінімальну суму та класи доставки. Потім він бере ціну з таблиці для країни та вагового класу або ціну для інших країн. Якщо ціни немає, спосіб приховується. Якщо сума кошика досягає Free shipping from, ціна дорівнює 0.

Спосіб із пунктом видачі пропонується лише для адрес у Нідерландах і Бельгії та лише за наявності ключа API. Щойно покупець введе дійсний поштовий індекс, плагін запитує в PostNL Checkout API найближчі пункти видачі. Він надсилає поштовий індекс, вулицю, номер будинку, місто та країну покупця, а також адресу відправлення вашого магазину. Для способів доставки на адресу нічого не надсилається. Якщо PostNL недоступний або не повертає пунктів для адреси, спосіб із пунктом видачі приховується, а інші способи залишаються доступними. Тайм-аут API становить 12 секунд.

Списки пунктів кешуються на 6 годин для кожного поштового індексу, а відповіді «пунктів немає» — на 1 годину. Невдалі запити кешуються на 10 хвилин, щоб збій не сповільнював кожне оновлення оформлення замовлення. Остання помилка показується на сторінці налаштувань.

Спосіб працює в класичному оформленні замовлення та в блоках Cart і Checkout. Він сумісний із High-Performance Order Storage (HPOS) WooCommerce.

Плагін не запитує тарифи PostNL у реальному часі та не створює етикетки для відправлень, штрихкоди, track and trace, повернення чи попередні повідомлення. Немає опцій дня доставки, вечірньої чи ранкової доставки. Створіть відправлення в Mijn PostNL або іншому інструменті PostNL, використовуючи збережений пункт видачі.

Пункти видачі

Коли покупець обирає спосіб із пунктом видачі, під ним з'являється список PostNL pickup point із трьома найближчими пунктами: назва компанії, адреса та відстань. Перш ніж покупець введе поштовий індекс, він бачить повідомлення «Введіть поштовий індекс (наприклад, 1234 AB), щоб побачити пункти видачі PostNL.» (4 цифри для Бельгії). Вибір запам'ятовується, коли оформлення замовлення оновлюється.

Пункт обов'язковий. Без пункту оформлення зупиняється з повідомленням «Оберіть пункт видачі PostNL.» Сервер звіряє пункт зі списком PostNL для адреси доставки. Якщо його немає в списку, оформлення зупиняється з повідомленням «Обраний пункт видачі PostNL недоступний для цієї адреси. Оберіть його знову.» Назва та адреса, збережені із замовленням, беруться з PostNL, а не з браузера.

Екран замовлення в адмінці: PostNL pickup point з назвою, адресою та Location code під адресою доставки.

Сторінка подяки та перегляд замовлення в «Мій обліковий запис»: PostNL pickup point з назвою та адресою.

Листи про замовлення: назва та адреса пункту в HTML- і текстових листах.

У базі даних пункт зберігається в метаданих замовлення _vfd_ptnl_servicepoint_id (код місця PostNL), _vfd_ptnl_servicepoint_name (назва та адреса) і _vfd_ptnl_servicepoint (ID партнера, компанія, вулиця, номер будинку, поштовий індекс, місто, країна).

Ліцензійний ключ

Плагін працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії розміщено вгорі WooCommerce > Settings > Shipping > VibeFox PostNL. Вставте ключ у поле License key і натисніть Activate. Блок показує статус, наприклад дату, до якої ліцензія активна, і ваш домен. Використовуйте Check now, щоб знову перевірити статус, Change key, щоб ввести інший ключ, і Remove key, щоб видалити його з цього сайту. Посилання Manage licenses and domains in your account відкриває ваш обліковий запис на vibefox.net.

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє слот домену. Звільніть його у своєму обліковому записі на vibefox.net.

Без активного ключа PostNL не показується покупцям на оформленні замовлення. Менеджери магазину, які ввійшли в систему, його бачать, позначеним (unlicensed — visible to admins only), щоб ви могли налаштувати й протестувати плагін до купівлі ключа. Нагадування з'являється на сторінці Plugins і на сторінках WooCommerce. Наявні замовлення не змінюються.

Коли ліцензія закінчується, плагін продовжує працювати, але для оновлень і підтримки потрібне продовження. Статус автоматично перевіряється у фоновому режимі.

Усунення несправностей

PostNL не з'являється на оформленні замовлення: перевірте, що ліцензія активна, що Enable/Disable увімкнено і спосіб додано до зони країни покупця (або увімкнено Ignore zones і країна дозволена). Перевірте, що для країни встановлено ціну, обмеження ваги, Minimum subtotal і Hide for shipping classes.

Спосіб із пунктом видачі не з'являється: він показується лише для адрес у Нідерландах і Бельгії, лише за наявності ключа API, поштового індексу відправлення та ціни, і лише коли PostNL повертає пункти для поштового індексу покупця. Перегляньте попередження над сторінкою налаштувань і WooCommerce > Status > Logs, джерело «vfd-postnl». Помилки завжди записуються; увімкніть Debug log для деталей.

«Пункти видачі PostNL зараз неможливо завантажити»: PostNL недоступний, відхилив ключ API або відсутній поштовий індекс відправлення. Сторінка налаштувань показує останню помилку. Ключ sandbox працює лише з увімкненим Sandbox, а робочий ключ — лише з вимкненим.

Покупці бачать тестові пункти видачі: вимкніть Sandbox.

Фільтри для розробників: vfd_ptnl_number_of_locations (за замовчуванням 3), vfd_ptnl_checkout_request (тіло запиту) і vfd_ptnl_api_url.

Блок ліцензії показує помилку: дотримуйтесь повідомлення в блоці. Наприклад, якщо ключ уже використовується на іншому домені, звільніть слот у своєму обліковому записі на vibefox.net і натисніть Check now. Якщо адреса сайту змінилася, натисніть Check now, щоб активувати ключ для нового домену. Якщо сервер ліцензій недоступний, плагін продовжує працювати за останнім відомим статусом.

Видалення

Деактивація плагіна зберігає всі налаштування і лише очищає кешовані списки пунктів видачі. Щоб видалити його, деактивуйте і видаліть на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються разом із кешованими списками пунктів видачі та останньою помилкою API. Налаштування та способи зон видаляються лише якщо було увімкнено Remove data on uninstall. Інакше вони зберігаються для повторного встановлення. Наявні замовлення зберігають свої рядки доставки та збережений пункт видачі.

PostNL — торговельна марка її власника. Цей плагін не є афілійованим із PostNL і не схвалений PostNL.