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

Вимоги

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

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

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

API-токен Delhivery (лише для актуальних тарифів): увійдіть у Delhivery One і відкрийте Settings > API setup. Статтю довідки Delhivery «API token generation» пояснює кроки. Тестові токени працюють із тестовим середовищем (staging). Також потрібен 6-значний PIN-код вашого пункту відправлення. Якщо ви використовуєте лише фіксовані ціни, токен не потрібен.

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

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

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

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

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

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

5. Введіть API-токен і PIN-код відправлення, оберіть Express або Surface та Pre-paid або COD. Якщо валюта вашого магазину не INR, введіть курс конвертації. За бажанням введіть фіксовані ціни (див. розділ «Налаштування»).

6. Додайте VibeFox Delhivery до зони доставки (наприклад, Індія) в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore zones і оберіть країни.

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

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

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

Щоразу, коли ви зберігаєте налаштування, кешовані тарифи Delhivery очищаються. Ціни та суми приймають «9.99» і «9,99».

Загальні

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

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

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

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

Environment: Production (track.delhivery.com) (за замовчуванням) або Staging / test account (staging-express.delhivery.com). Використовуйте Staging лише з тестовим токеном Delhivery.

API token: ваш API-токен Delhivery. Він надсилається лише в заголовку авторизації і ніколи не записується в логи.

Origin pincode: 6-значний PIN-код вашого пункту відправлення або складу, наприклад 110001.

Актуальні тарифи

Актуальний тариф запитується для напрямків в Індії з дійсним 6-значним PIN-кодом, для прямої доставки.

Shipping mode: режим тарифікації Delhivery для розрахунку: Express (за замовчуванням) або Surface.

Payment type: тип оплати, який передається в Delhivery: Pre-paid (за замовчуванням) або COD (накладений платіж; Delhivery додає свою комісію COD). Плагін не змінює його залежно від способу оплати, який обрав покупець.

Rate amount: Delhivery повертає вартість з GST і без GST.

INR to (store currency) conversion rate: тарифи Delhivery вказані в індійських рупіях. Якщо валюта вашого магазину не INR, введіть, скільки одиниць вашої валюти коштує одна рупія, наприклад 0.011. Якщо поле порожнє, актуальні тарифи не використовуються, застосовуються фіксовані ціни і над налаштуваннями показується попередження. Не потрібно, якщо валюта магазину — INR.

Фіксовані ціни (використовуються, коли актуального тарифу немає)

Фіксовані ціни застосовуються, якщо токен або PIN-код ще не вказано, адреса доставки знаходиться поза Індією, PIN-код не обслуговується або API повернув помилку. Ціни вказані у валюті вашого магазину.

Prices per country: по одному рядку на країну у форматі COUNTRY_CODE:price, наприклад IN:120. Перевіряються раніше за резервну ціну.

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

Fixed price is charged: Per order — ціна стягується один раз. Per item (price × quantity) — ціна множиться на кількість товарів у кошику. Актуальний тариф Delhivery завжди розраховується за загальною вагою посилки.

Умови

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

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

Min weight (kg): мінімальна вага кошика, за якої показується спосіб. 0 — без обмежень.

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

Ваги товарів переводяться в кг з одиниці ваги вашого магазину. Тариф використовує фактичну вагу кошика (суму ваг товарів) без об'ємної ваги та коробок.

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

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

Ignore zones: пропонувати Delhivery без додавання до зони доставки, для країн, зазначених нижче.

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

Додатково

Debug log: записує розрахунки тарифів у WooCommerce > Status > Logs, джерело vfd_delhivery. Помилки API записуються завжди, навіть коли цей параметр вимкнено. Токени та повні PIN-коди покупців ніколи не записуються в логи.

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

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

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

Для адреси в Індії з дійсним 6-значним PIN-кодом плагін надсилає в Delhivery PIN-коди відправлення та призначення, вагу кошика в грамах, режим доставки та тип оплати, і показує повернену суму, перераховану у валюту вашого магазину. Кожна відповідь кешується на 1 годину. Невдалий запит кешується на 10 хвилин, щоб оформлення замовлення не чекало Delhivery при кожному оновленні. Тайм-аут API — 10 секунд.

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

Спосіб працює в класичному оформленні замовлення та в блоках Кошик і Оформлення замовлення. Він сумісний з HPOS (сховищем замовлень високої продуктивності) WooCommerce.

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

Замовлення та відстеження

На екрані замовлення, під адресою доставки, блок Delhivery показує режим доставки (Express або Surface) і джерело ціни: актуальний тариф Delhivery, фіксована ціна або поріг безкоштовної доставки.

Створіть відправлення в Delhivery One, потім вставте його AWB у поле Delhivery AWB / tracking number і збережіть замовлення. В адмінці з'явиться посилання Track on delhivery.com. Покупець бачить Delhivery tracking з посиланням на сторінці замовлення в розділі «Мій обліковий запис» та в листах про замовлення (HTML і простий текст). AWB зберігається раніше за статус замовлення, тож лист «Виконане замовлення» вже містить його, якщо ви виконуєте замовлення тим самим збереженням.

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: перевірте API-токен, коректний Origin pincode і, якщо валюта магазину не INR, курс конвертації. Покупець має ввести коректний 6-значний індійський PIN-код. Увімкніть Debug log і відкрийте WooCommerce > Status > Logs, джерело vfd_delhivery, щоб побачити помилки API, наприклад PIN-код, який не обслуговується.

GST нараховується двічі: загальна сума Delhivery вже включає GST. Встановіть Rate amount у значення Gross amount (excluding GST) або Tax status у значення None.

Тестування: використовуйте Environment Staging з тестовим токеном Delhivery.

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

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

Видалення

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

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