VibeFox Ninja Van for WooCommerce — Допомога

Вимоги

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

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

PHP: 8.0 або новіша версія.

Тарифна сітка Ninja Van: ціни з вашого облікового запису відправника Ninja Van або від відділу продажів Ninja Van, введені в таблицю цін. Ключі API не потрібні. Необов'язкові актуальні ціни всередині Індонезії використовують API тарифів Ninja Van, який є публічним і не потребує автентифікації.

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

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

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

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

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

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

5. Введіть ваші тарифи Ninja Van у таблицю цін. Для Індонезії за бажанням увімкніть Live rates (див. Налаштування).

6. Додайте VibeFox Ninja Van до зони доставки (наприклад, «Сінгапур») у WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones і виберіть країни.

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

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

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

Загальні

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

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

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

Введіть ціни з вашої тарифної сітки Ninja Van у валюті магазину. Якщо ваша сітка в SGD, MYR, IDR, PHP, THB або VND, спершу перерахуйте її. Ця таблиця використовується для всіх напрямків поза Індонезією та щоразу, коли актуальна ціна недоступна.

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

Price for countries not in the table: використовується, якщо в таблиці немає рядка для країни призначення (і рядка *) або в рядку немає ціни для цієї ваги. Залиште порожнім, щоб приховати спосіб у такому разі.

Price applies: спосіб підрахунку цін. Це стосується й актуальних цін.

Актуальні тарифи (API) — Індонезія

API тарифів Ninja Van повертає стандартну вартість доставки без надбавок і знижок для відправлень всередині Індонезії. Ninja Van пропонує його лише для Індонезії. Коли Live rates увімкнено, рядки статусу в цьому розділі показують зону відправлення, відсутній курс конвертації та останню відповідь API тарифів.

Live rates: отримувати актуальні ціни Ninja Van для доставки всередині Індонезії. За замовчуванням: вимкнено. Без цього параметра під час оформлення замовлення в Ninja Van нічого не надсилається.

Environment: Production (api.ninjavan.co) (за замовчуванням) або Sandbox — testing only (api-sandbox.ninjavan.co).

Service level: сервіс, для якого запитується ціна: Standard (за замовчуванням), Express, Same day або Next day. Якщо Ninja Van не має ціни для маршруту та сервісу, використовується таблиця цін.

Ship-from zone code L1 і Ship-from zone code L2: коди рівнів L1 та L2 району, з якого ви відправляєте, наприклад ID_A00007_01 і ID_B00069_01, з таблиці відповідності кодів зон Ninja Van (CSV), посилання на яку є на сторінці налаштувань. Введіть обидва або залиште обидва порожніми, щоб визначити їх за адресою магазину в WooCommerce > Settings > General: Індонезія, провінція, місто і, якщо в місті кілька зон, район (Kecamatan) у рядку адреси. Код невірного формату очищується з повідомленням про помилку.

IDR conversion rate: API тарифів повертає вартість в індонезійських рупіях (IDR). Якщо валюта вашого магазину — IDR, залиште поле порожнім. Інакше вкажіть, скільки коштує 1 IDR у валюті вашого магазину, наприклад 0.000058. Без цього значення актуальні ціни не використовуються, застосовується таблиця цін.

Умови

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

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

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

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає. Оберіть None, якщо ціни в таблиці вже включають податки (GST, SST, ПДВ).

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

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

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

Додатково

Debug log: записує розрахунки тарифів до WooCommerce > Status > Logs (джерело vfd_ninja_van). Адреси покупців не записуються. Невдалі запити до API тарифів записуються, навіть коли цей параметр вимкнено. Вимкніть його, коли закінчите.

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

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

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

Ціна береться з рядка країни (або рядка *): стовпець ваги, інакше базова ціна, інакше Price for countries not in the table. Ваги товарів переводяться з одиниці ваги магазину в кілограми. Якщо ціни немає, спосіб приховується.

Коли Live rates увімкнено, доставка всередині Індонезії спершу тарифікується Ninja Van. Плагін перетворює адреси відправлення та доставки на коди зон Ninja Van: провінція, місто або регентство та, для міст з кількома зонами, район (Kecamatan), вказаний у рядку адреси. Він надсилає коди, вагу та рівень сервісу і перераховує вартість з IDR у валюту вашого магазину. При Per item надсилається один запит на кожну окрему вагу товару, але не більше 5 на кошик.

API тарифів дозволяє 20 запитів на хвилину, тому відповіді кешуються на 6 годин, помилки — на 5 хвилин, а «немає ціни для цього маршруту» — на 1 годину. Плагін ніколи не надсилає більше 18 запитів на хвилину, а після відповіді HTTP 429 призупиняє запити на одну годину. Тайм-аут API — 12 секунд. Якщо Ninja Van не відповідає, відповідає помилкою, не має ціни для маршруту або адресу не вдається зіставити, використовується ціна з таблиці. Помилки потрапляють до журналу і ніколи не показуються покупцеві.

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

Плагін лише розраховує ціни. Він не створює замовлень у Ninja Van, не друкує авіанакладні (AWB), не замовляє забір посилок, не відстежує посилки та не працює з COD. Для цього використовуйте Ninja Van Dashboard. Вибору пункту видачі (Ninja Points) немає: спосіб — доставка до дверей. Актуальні ціни недоступні поза Індонезією.

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

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

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

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

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

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

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

Для деяких адрес актуальна ціна не використовується: призначення має відповідати зоні Ninja Van: Індонезія, провінція, місто або регентство та, для міст з кількома зонами, район (Kecamatan) у рядку адреси. Інакше використовується ціна з таблиці. Увімкніть Debug log, щоб побачити причину, і перевірте рядки статусу в розділі Актуальні тарифи (API) — Індонезія.

Актуальні ціни взагалі не запитуються: рядки статусу показують причину: адреса магазину не в Індонезії або зону відправлення не вдалося визначити (введіть обидва коди зон), або відсутній IDR conversion rate.

Досягнуто ліміту запитів (HTTP 429): актуальні запити призупиняються на одну годину, і до того часу використовується таблиця цін.

У якій валюті ціни: таблиця — у валюті вашого магазину. Актуальні ціни — у рупіях (IDR), перераховуються за IDR conversion rate, якщо валюта вашого магазину не IDR.

Розробникам: сайт з власним полем району (Kecamatan) під час оформлення замовлення може передавати коди зон через фільтр vfd_njvn_tariff_zone.

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

Видалення

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

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