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

Вимоги

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

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

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

Ключ API Coordinadora (лише для онлайн-тарифів): онлайн-тарифи надходять із Coordinadora Cotizador через сервіс Coordinadora для WooCommerce, той самий, який використовує офіційний плагін Coordinadora. Coordinadora видає ключ API клієнтам з чинною комерційною угодою. Запитайте свого менеджера облікового запису Coordinadora або перегляньте wc.coordinadora.com. Також потрібен 8-значний код DANE міста, з якого ви відправляєте. Без ключа спосіб доставки працює лише з фіксованими цінами.

Товари: для онлайн-тарифу кожен товар у кошику повинен мати вагу та розміри (довжину, ширину, висоту).

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

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

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

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

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

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

5. Введіть ключ API, код DANE міста відправлення та, якщо валюта магазину не COP, курс обміну в COP. Додайте принаймні одну фіксовану ціну для Колумбії як запасний варіант (див. Налаштування).

6. Додайте VibeFox Coordinadora до зони доставки, що охоплює Колумбію, у розділі WooCommerce > Settings > Shipping > Shipping zones, або увімкніть Ignore shipping zones і виберіть країни.

7. Переконайтеся, що у ваших товарів вказані вага та розміри.

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

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

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

Сторінка налаштувань показує попередження вгорі, якщо онлайн-тарифи не можуть працювати або спосіб було б приховано: код DANE міста відправлення відсутній або недійсний, курс COP не вказано або для Колумбії немає фіксованої ціни. Щоразу, коли ви зберігаєте налаштування, кешовані тарифи очищуються. Числа можна вводити з крапкою або комою (9,99 = 9.99).

Загальні

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

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

Tax status: Taxable додає податок на доставку WooCommerce понад тариф, None — не додає. Оберіть None, якщо ваші ціни або тариф Coordinadora вже включають податок.

Онлайн-тарифи Coordinadora

Онлайн-тарифи запитуються для напрямків у Колумбії. Залиште ключ порожнім, щоб використовувати лише фіксовані ціни.

API key: ваш ключ API Coordinadora для WooCommerce. Він ніколи не записується в журнал.

Origin city (DANE code): 8-значний код DANE міста, з якого ви відправляєте, наприклад 11001000 Bogotá, 05001000 Medellín, 76001000 Cali або 08001000 Barranquilla. Приймається також 5-значний код муніципалітету, який доповнюється до 8 знаків.

COP per 1 unit of store currency: Coordinadora розраховує тарифи в колумбійських песо. Якщо валюта вашого магазину не COP, вкажіть, скільки COP становить 1 одиниця вашої валюти, наприклад 4300. Курс також використовується, щоб передавати оголошену вартість у COP. Якщо залишити поле порожнім, онлайн-тарифи не використовуються. Якщо валюта магазину COP, залиште поле порожнім.

Фіксовані ціни (використовуються, коли немає ключа API, для напрямків поза Колумбією та як запасний варіант, коли онлайн-тариф недоступний)

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

Fixed price per: Order стягує ціну один раз. Item (price × quantity) множить її на кількість товарів у кошику. Це стосується лише фіксованих цін; онлайн-тариф Coordinadora завжди покриває все замовлення.

Умови

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

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

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

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

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

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

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

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

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

Додатково

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

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

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

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

Для адреси в Колумбії з ключем API плагін визначає код DANE міста призначення в такому порядку: код DANE в полі міста (плагіни колумбійських департаментів і міст для оформлення замовлення записують його, наприклад MEDELLIN (ANT) (05001000)), 8-значний поштовий індекс або вбудований список обласних центрів і близько 40 найбільших міст. Місто зі списку перевіряється відносно вибраного департаменту. Акценти та регістр ігноруються.

Далі плагін надсилає Coordinadora код DANE призначення та кожен товар із містом відправлення, його вагу (кг), розміри (см), кількість і оголошену вартість (COP). Одиниці вимірювання магазину перераховуються автоматично. Coordinadora повертає ціну в COP, а плагін конвертує її у валюту вашого магазину. Кожен тариф кешується на 1 годину. Невдалий запит запам'ятовується на 10 хвилин, щоб збій Coordinadora ніколи не сповільнював кожне оновлення оформлення замовлення. Тайм-аут API — 10 секунд.

Коли онлайн-тариф недоступний (помилка API, невідоме місто, товар без ваги або розмірів, відсутні налаштування), використовується фіксована ціна. Якщо її немає, спосіб приховується. Деталі помилок записуються в журнал WooCommerce, ніколи не показуються покупцеві.

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

Плагін лише розраховує тарифи. Він не створює відправлень і накладних (guías), не друкує етикетки, не замовляє забір (recogidas), не відстежує посилки, не стягує накладений платіж (recaudo) і не пропонує пункти видачі Droop; для цього використовуйте портал Coordinadora. Доставка в той самий день не розраховується, а міжнародні напрямки використовують фіксовані ціни.

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

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

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

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

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

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

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

Онлайн-тариф не показується, лише фіксована ціна: увімкніть Debug log, перезавантажте сторінку оформлення замовлення та відкрийте WooCommerce > Status > Logs, джерело vfd-coordinadora. Типові причини: місто призначення не розпізнано, у товару немає ваги або розмірів, відсутній код DANE міста відправлення чи курс COP, або Coordinadora повернула помилку.

Місто призначення не розпізнано: встановіть плагін колумбійських департаментів і міст для оформлення замовлення, який записує код DANE в поле міста. Розробники можуть зіставити більше міст за допомогою фільтрів vfd_crd_dane_cities і vfd_crd_destination_dane.

Чи включає тариф податок? Тариф — це сума, яку розраховує Coordinadora. Якщо Tax status встановлено на Taxable, WooCommerce додає податок на доставку понад тариф; оберіть None, якщо котирування його вже містить.

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

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

Видалення

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

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