VibeFox DHL Africa for WooCommerce — Допомога

Вимоги

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

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

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

Обліковий запис DHL Express (лише для актуальних тарифів): актуальні тарифи використовують MyDHL API. Вам потрібні номер облікового запису DHL Express і облікові дані MyDHL API: API key і API secret. Запитати їх можна на порталі розробників DHL (MyDHL API, "Get access") або у менеджера вашого облікового запису DHL Express. Облікові записи, які ще мають облікові дані DHL XML Services (Site ID і пароль), можуть використовувати їх замість цього. Якщо ви використовуєте лише резервні ціни, облікові дані DHL не потрібні.

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

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

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

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

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

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

5. Виберіть DHL API, введіть API key, API secret і номер облікового запису DHL. Залишайте Test mode увімкненим, поки використовуєте тестові облікові дані. Введіть адресу Ship from. Якщо ваш обліковий запис DHL не виставляє рахунки у валюті магазину, встановіть DHL quote currency і Exchange rate. За бажанням задайте ціни за країнами та резервну вартість (див. розділ «Налаштування»).

6. Додайте DHL Express Africa до зон доставки в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни.

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

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

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

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

Загальні

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

Name: назва способу доставки, що показується під час оформлення замовлення. За замовчуванням: DHL Express.

Tax status: Taxable (за увімкнених податків WooCommerce) бере тариф DHL без податку, який включає котирування DHL, а податок додає WooCommerce. None стягує тариф DHL як у котируванні, з податком включно.

Обліковий запис DHL Express (потрібен лише для актуальних тарифів)

DHL API: який інтерфейс DHL використовується. Показуються лише поля обраного API.

API key: ваше ім'я користувача MyDHL API (API key).

API secret: ваш пароль MyDHL API (API secret).

XML Site ID: ваш Site ID DHL XML Services (лише для застарілого API).

XML password: ваш пароль DHL XML Services (лише для застарілого API).

DHL account number: ваш номер облікового запису DHL Express (9 цифр). MyDHL API його вимагає. З XML Services він повертає тарифи вашого облікового запису замість опублікованих тарифів.

Test mode: використовувати тестове середовище DHL. Увімкнено за замовчуванням. Тестові облікові дані працюють лише в тестовому середовищі, а робочі — лише в робочому. Вимкніть, коли переходите в робочий режим.

Місце відправлення

Адреса, з якої DHL забирає посилки. Тариф залежить від неї.

Origin country: країна, з якої ви відправляєте.

Origin city: місто, з якого ви відправляєте, наприклад Johannesburg. MyDHL API його вимагає.

Origin postcode: залиште порожнім для країн без поштових індексів (наприклад Кенія, Нігерія, Гана).

Тарифи

Усі ціни вказуються у валюті вашого магазину. Актуальний тариф — це найдешевший продукт DHL Express для посилки. Якщо DHL не налаштовано, не відповідає або не має сервісу для маршруту, використовується ціна за країну, потім резервна вартість. Якщо немає ні того, ні іншого, спосіб доставки приховується.

DHL quote currency: DHL надає котирування у валюті країни вашого облікового запису DHL (наприклад ZAR, NGN або KES). Якщо DHL не повертає суму у валюті вашого магазину, актуальний тариф конвертується з цієї валюти за обмінним курсом нижче. Інакше він не використовується.

Exchange rate: скільки коштує 1 одиниця валюти котирування DHL у валюті вашого магазину, наприклад 1 ZAR = 0.05. Залиште порожнім, якщо конвертація не потрібна. Курс задається вручну.

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

Country prices: резервна ціна для кожної країни призначення, по одному рядку: CC:Price, наприклад ZA:25.00. Використовується, коли немає актуального тарифу.

Fallback price basis: Per order стягує ціну один раз. Per item (multiplied by the cart quantity) множить її на кількість товарів. Застосовується лише до ціни за країну та резервної вартості. Актуальний тариф DHL завжди розраховується для всієї посилки.

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

Умови

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

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

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

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

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

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

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

Додатково

Debug log: записує розрахунки тарифів у WooCommerce > Status > Logs, джерело vfd-dhl-africa. Помилки DHL записуються завжди, навіть якщо це вимкнено. Облікові дані та адреси покупців ніколи не записуються.

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

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

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

Інакше плагін надсилає DHL відправлення та призначення (країна, місто, поштовий індекс), вагу кошика в кг (щонайменше 0,5 кг) і одну коробку, побудовану за розмірами товарів у см: найбільша довжина, найбільша ширина і сума висот у стопці. Товари без розмірів нічого не додають. Якщо жоден товар не має розмірів, використовується коробка 10 x 10 x 10 см. Міжнародні відправлення декларуються як товари, з сумою кошика як заявленою вартістю, тож DHL надає котирування продуктів для посилок. Внутрішні відправлення не декларуються. Актуальний тариф запитується лише після того, як покупець ввів місто (з XML Services — місто або поштовий індекс).

Найдешевший продукт DHL Express показується як один тариф з вашою назвою. Покупець не бачить продукту DHL чи терміну доставки. Назва продукту (наприклад "EXPRESS WORLDWIDE (P)") зберігається як DHL product у рядку доставки замовлення, щоб ви знали, що бронювати.

Кожне котирування кешується на 1 годину для посилки та маршруту. Невдалий запит кешується на 10 хвилин, щоб оформлення не чекало DHL при кожному оновленні. Тайм-аут API — 12 секунд. Якщо DHL повертає помилку або не має сервісу, покупець не бачить помилки: використовується резервна ціна або спосіб приховується.

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

Плагін лише розраховує тарифи. Він не створює відправлень DHL, не друкує етикетки чи комерційні накладні, не замовляє забір кур'єром, не відстежує посилки, не пропонує пункти обслуговування DHL, не дає покупцеві вибрати між продуктами DHL, не пакує кілька коробок, не додає страхування і не розраховує мита та податки. Котирування стосується лише доставки. Мита та імпортні податки сплачує одержувач.

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: перевірте попередження вгорі сторінки налаштувань (відсутні облікові дані або місце відправлення). Увімкніть Debug log і відкрийте WooCommerce > Status > Logs, джерело vfd-dhl-africa. Помилки DHL, як-от неправильні облікові дані, відсутність сервісу для маршруту або проблема з валютою, завжди записуються. Перевірте, що Test mode відповідає вашим обліковим даним.

DHL повертає тариф у ZAR, NGN або KES, але мій магазин використовує іншу валюту: встановіть DHL quote currency у цю валюту і введіть Exchange rate. Без цього актуальний тариф не використовується, і діють резервні ціни.

У мене старі облікові дані DHL XML Services: виберіть XML Services (legacy) у DHL API. Перейдіть на MyDHL API, коли отримаєте облікові дані MyDHL.

Податок стягується на доставку двічі: встановіть Tax status у Taxable, щоб тариф DHL брався без ПДВ DHL, або в None, щоб стягувати суму DHL як у котируванні.

Тарифи застаріли після змін: збережіть сторінку налаштувань. Це очистить кешовані котирування DHL.

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

Видалення

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

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