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

Вимоги

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

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

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

Обліковий запис Aramex (лише для актуальних тарифів): актуальні тарифи використовують API калькулятора тарифів Aramex. Aramex надає доступ до API власникам облікових записів. Запитайте свого менеджера облікового запису Aramex або перегляньте Aramex Developers Solution Center на сайті Aramex. Потрібні шість значень: ім'я користувача API (зазвичай адреса e-mail), пароль, номер облікового запису, PIN облікового запису, entity облікового запису (наприклад DXB) і код країни облікового запису (наприклад AE). Якщо ви використовуєте лише фіксовані ціни за країнами, обліковий запис Aramex не потрібен.

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

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

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

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

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

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

5. Оберіть, як розраховується вартість доставки, і заповніть відповідні розділи (див. розділ «Налаштування»).

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

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

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

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

Щоразу, коли ви зберігаєте налаштування, кешовані тарифи Aramex очищаються.

Загальні

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

Method title: назва способу доставки, яка відображається в кошику та під час оформлення замовлення. За замовчуванням: Aramex.

Shipping cost: як розраховується ціна.

Fixed prices per country (table below): ціна береться з таблиці Price per country. Обліковий запис Aramex не потрібен.

Aramex live rates (API): ціна запитується в Aramex для кожного кошика. Якщо Aramex не повертає тариф, спосіб доставки приховується для цього кошика.

Aramex live rates, fixed prices if the API fails: ціна запитується в Aramex. Якщо Aramex не відповідає (неправильні дані для входу, тайм-аут, помилка служби), для країни використовується фіксована ціна.

Причина відсутності актуального тарифу записується в журнал налагодження. Вона ніколи не показується покупцеві.

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

Username: ваше ім'я користувача Aramex API, зазвичай адреса e-mail.

Password: ваш пароль Aramex API.

Account number: номер вашого клієнтського облікового запису Aramex.

Account PIN: PIN вашого облікового запису Aramex.

Account entity: код підрозділу (офісу) Aramex, до якого належить ваш обліковий запис, наприклад DXB, AMM або RUH.

Account country code: двобуквений код країни вашого облікового запису Aramex, наприклад AE.

Служба Aramex (використовується для актуальних тарифів)

Якщо адреса доставки знаходиться в країні відправлення, для відправлення запитується тариф Domestic. Для всіх інших відправлень запитується тариф International express.

International service: продукт Aramex для відправлень за кордон: PPX Priority Parcel Express (за замовчуванням), PDX Priority Document Express, PLX Priority Letter Express, DPX Value Express Parcels, EPX Economy Parcel Express, EDX Economy Document Express, GPX Ground Parcel Express або GDX Ground Document Express.

Domestic service: продукт Aramex для відправлень у межах країни відправлення: ONP Overnight Parcel (за замовчуванням), OND Overnight Document, SMP Same Day Parcel, SMD Same Day Document, SDD Same Day Delivery, EMD Early Morning Delivery, PEC Economy Delivery, PEX Road Express або HVY Heavy (20 кг і більше).

Payment type: хто оплачує Aramex за відправлення: Prepaid (платить відправник), Collect (платить одержувач) або Third party (третя сторона). Зазвичай Prepaid.

API weight unit: одиниця, яка надсилається в Aramex: KG або LB. Вага товарів перераховується з одиниці ваги вашого магазину. Тарифікаційна вага — це більша з фактичної та об'ємної ваги (довжина × ширина × висота в см / 5000). Мінімум становить 0,5 кг, це також стосується товарів без ваги.

Currency conversion rate: Aramex просять надавати котирування у валюті вашого магазину. Якщо Aramex все одно відповідає в іншій валюті, тариф множиться на це число (1 одиниця валюти Aramex = X одиниць валюти вашого магазину). Залиште порожнім, щоб відхиляти такі котирування, тоді покупець ніколи не сплатить у неправильній валюті. Як десятковий роздільник приймаються і крапка, і кома.

Місце відправлення (адреса відправника) (використовується для актуальних тарифів)

Origin country: країна, з якої ви відправляєте. За замовчуванням це країна вашого магазину.

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

Origin state / emirate: необов'язково.

Origin postcode: необов'язково.

Якщо країна відправлення — це країна вашого магазину, порожні поля заповнюються з адреси магазину в WooCommerce > Settings > General.

Фіксовані ціни (використовуються у фіксованому режимі та як резервні для актуальних тарифів)

Price per country: таблиця двобуквених кодів країн і цін у валюті вашого магазину. Натисніть Add row, щоб додати країну, і хрестик, щоб видалити її. Використовуйте * як код країни для всіх інших країн. Країни без ціни (якщо немає рядка з *) не отримують фіксованого тарифу, тому спосіб доставки для них приховується.

Fixed price applies: Per order стягує ціну один раз. Per item множить її на кількість товарів у кошику. Актуальні тарифи Aramex завжди розраховуються за відправлення.

Умови

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

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

Minimum order amount: показувати спосіб доставки лише тоді, коли проміжна сума кошика (після знижок, до податку) досягає цієї суми. Залиште порожнім, щоб показувати його завжди.

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

Free shipping: увімкнути безкоштовну доставку Aramex від суми, вказаної нижче.

Free shipping from: проміжна сума кошика (після знижок, до податку), від якої доставка безкоштовна. Використовується лише коли Free shipping увімкнено.

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — ні. Актуальні тарифи Aramex можуть уже включати ПДВ. У такому разі оберіть None, щоб податок не стягувався двічі.

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

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

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

Додатково

Debug log: записує розрахунки тарифів і помилки API у logs/vfd_armx_debug.log.php у папці плагіна. Файл не можна відкрити через веб. Паролі, PIN, номер облікового запису та адреси покупців приховуються. Вимкніть журнал, коли закінчите.

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

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

Коли покупець вводить адресу доставки, WooCommerce запитує у плагіна тариф. Спочатку плагін перевіряє умови: країну доставки, вагу кошика, мінімальну суму замовлення та виключені класи доставки. Якщо діє безкоштовна доставка, покупець бачить спосіб як Aramex (free), і запит до Aramex не надсилається.

У фіксованому режимі ціна береться з таблиці. В актуальних режимах плагін надсилає Aramex адреси відправлення та доставки, тарифікаційну вагу, службу та валюту вашого магазину і показує повернуту суму. Актуальний тариф запитується лише після того, як покупець ввів місто або поштовий індекс. Кожна відповідь кешується на 1 годину, тож той самий кошик не викликає новий запит. Невдалий запит кешується на 10 хвилин, щоб оформлення не чекало Aramex під час кожного оновлення. Тайм-аут API становить 10 секунд.

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

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

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

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: увімкніть Debug log, перезавантажте сторінку оформлення замовлення та відкрийте logs/vfd_armx_debug.log.php у папці плагіна. Там буде вказано причину: відсутні дані для входу в API, код помилки Aramex, немає міста відправлення, ще немає міста або поштового індексу доставки, обмеження ваги чи суми або котирування в іншій валюті. З Aramex live rates, fixed prices if the API fails покупці все одно отримують фіксовану ціну, поки ви виправляєте проблему.

Помилка ERR75 у журналі: Aramex відхилив вхід. Перевірте ім'я користувача, пароль, номер облікового запису, PIN, entity та код країни у свого менеджера облікового запису Aramex.

Котирування в іншій валюті відхилено: Aramex відповів у валюті, відмінній від валюти вашого магазину. Введіть Currency conversion rate або попросіть Aramex надавати котирування у вашій валюті.

Податок на доставку стягується двічі: суми Aramex можуть уже включати ПДВ. Встановіть Tax status на None.

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

Тестове середовище (sandbox) Aramex: плагін використовує робочий калькулятор тарифів Aramex. Розробники можуть змінити адресу API за допомогою фільтра vfd_armx_api_url. Фільтри vfd_armx_rate_request, vfd_armx_number_of_pieces і vfd_armx_volumetric_divisor змінюють запит, кількість місць та дільник для об'ємної ваги.

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

Видалення

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

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