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

Вимоги

WordPress: 5.8 або новіша.

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

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

API-ключ PostNord (для вибору пункту видачі): створіть безкоштовний обліковий запис на developer.postnord.com, додайте застосунок і скопіюйте його API-ключ. Без ключа спосіб доставки працює, але покупці не можуть вибрати пункт видачі.

Договір з PostNord: для відправлення посилок потрібен ваш звичайний клієнтський договір з PostNord, наприклад MyPack Collect або MyPack Home.

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

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

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

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

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

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

5. Вставте API key PostNord, виберіть Agreement country і заповніть Country prices (див. розділ «Налаштування»).

6. Додайте VibeFox PostNord до зон доставки Швеції, Данії, Норвегії або Фінляндії в WooCommerce > Settings > Shipping > Shipping zones. У налаштуваннях способу вкажіть його Title і Delivery type. Або увімкніть Ignore shipping zones.

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

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

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

Delivery type (zone): Same as global setting (за замовчуванням), Service point / parcel locker або Home delivery. Додайте до зони два способи PostNord, щоб пропонувати обидва варіанти.

Над налаштуваннями сторінка попереджає, якщо ще немає API-ключа або ціни. Під час кожного збереження налаштувань кешовані списки пунктів видачі очищаються.

Загальні

Enable/Disable: якщо прапорець знято, спосіб приховано всюди, зокрема в зонах доставки.

Name: назва способу доставки, яку бачить покупець під час оформлення. Спосіб у зоні може замінити її власним Title. За замовчуванням: PostNord.

Delivery type: значення за замовчуванням для всіх способів PostNord; кожен спосіб у зоні може вибрати свій.

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

API PostNord (вибір пункту видачі)

API key: API-ключ вашого застосунку на developer.postnord.com. Він надсилається до PostNord лише з вашого сервера, ніколи не передається до браузера і не записується в журнал.

Test mode: використовує тестове середовище PostNord (atapi2.postnord.com). Лише для ключів, виданих для тестового середовища.

Agreement country: країна вашого клієнтського договору з PostNord: Швеція, Данія, Норвегія або Фінляндія. Вона визначає, які пункти видачі пропонуються. Same as the delivery country (за замовчуванням) використовує країну покупця.

Ціни

Ціни вказуються у валюті магазину. У PostNord немає публічного API цін, тож ви встановлюєте власні ціни, зазвичай ті, що за вашим договором з PostNord. Порядок такий: спочатку таблиця за країнами, потім запасна вартість; безкоштовна доставка діє лише там, де одне з цих значень дає ціну.

Calculation type: Per order стягує ціну один раз. Per item (price × number of items) множить її на кількість товарів у кошику.

Country prices: ціна за країною призначення та вагою кошика. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Кожен рядок має Price і колонки ваги: XS до 1 кг, S до 2 кг, M до 3 кг, L до 5 кг і XL понад 5 кг. Колонка ваги зі значенням 0 використовує колонку Price. Рядок * All other countries охоплює всі країни, для яких немає власного рядка. Десяткові числа з комою або крапкою (9,99 або 9.99). Новий рядок створюється як * All other countries з усіма цінами 0, що означає безкоштовну доставку. Оберіть країну та введіть ціни перед збереженням або видаліть рядок. Клітинка, у якій не число, зберігається як 0 з повідомленням.

Fallback cost: використовується, коли в таблиці країн немає рядка для країни призначення і немає рядка *. Залиште порожнім, щоб приховати спосіб для таких країн.

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

Доступність

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

Max weight (kg): приховує спосіб, якщо кошик важить більше. За замовчуванням: 30. 0 означає без обмежень. Перевірте обмеження ваги вашої послуги PostNord: поштомати приймають менше, ніж пункти видачі.

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

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

Ignore shipping zones: коли увімкнено, PostNord пропонується для країн, зазначених нижче, із загальними налаштуваннями, навіть якщо його не додано до зони доставки. Коли вимкнено, лише в тих зонах доставки, де ви його додали.

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

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

Додатково

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

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

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

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

Для способу з пунктом видачі та адреси доставки в Швеції, Данії, Норвегії або Фінляндії ваш сервер запитує у PostNord Business Location API пункти видачі, найближчі до поштового індексу доставки. Він передає країну та індекс доставки, а також країну договору. Тайм-аут API становить 10 секунд. Списки кешуються на 6 годин для кожного індексу, а відповіді «немає пунктів» — на 1 годину. Помилки API кешуються на 5 хвилин, щоб збій PostNord не сповільнював кожне оновлення оформлення замовлення.

Для інших напрямків спосіб може пропонуватися з вашими цінами, без вибору пункту.

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

Плагін не запитує актуальні ціни PostNord і не створює етикетки для відправлення, не бронює відправлення (EDI), не надає трек-номери та не надсилає листи із відстеженням. Режиму карти немає. Для відправлень використовуйте PostNord Portal, Skicka Direkt Business або плагін для етикеток; збережений ID пункту видачі потрібен саме цим інструментам.

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

Коли покупець обирає спосіб із пунктом видачі, під ним з'являється список PostNord service point з найближчими пунктами, згрупований за містами з відстанню. До введення індексу покупець бачить повідомлення "Enter your postcode to choose a PostNord service point.". Вибір зберігається під час оновлень оформлення замовлення.

Коли список завантажено, пункт обов'язковий. Без вибору оформлення зупиняється з повідомленням "Please select a PostNord service point.". Обраний пункт перевіряється на сервері за списком, і в класичному, і в блочному оформленні замовлення.

Вибір пункту ніколи не блокує продаж. Якщо список не вдалося завантажити (API-ключ ще не задано, API PostNord недоступний, поблизу індексу немає пунктів), покупець бачить примітку та все одно може оформити замовлення. Тоді PostNord доставить його до пункту видачі, найближчого до адреси.

Екран замовлення в адмінці: PostNord service point з назвою, адресою та Service point ID, під адресою доставки. Якщо пункт не обрано, там написано "not selected — PostNord delivers to the service point nearest to the shipping address".

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

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

У базі даних пункт зберігається в метаданих замовлення _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name і _vfd_ptnd_servicepoint_address.

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

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

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

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

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

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

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

Вибір повідомляє, що пункти видачі не можна завантажити: перевірте API key і налаштування Test mode. Продуктивний ключ не працює з тестовим середовищем, і навпаки. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело "vfd-postnord". Замовлення все одно можна оформити; тоді PostNord доставить його до найближчого пункту видачі.

Неочікувані пункти видачі: перевірте Agreement country. Він визначає, які пункти видачі пропонуються.

Доставка безкоштовна помилково: перевірте Country prices на рядки з Price 0, особливо на рядок *, доданий через + Add country і залишений незаповненим, а також перевірте Free shipping from.

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

Видалення

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

PostNord є торговельною маркою її власника. Цей плагін не пов'язаний з PostNord і не схвалений PostNord.