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

Вимоги

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

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

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

Обліковий запис Andreani (лише для актуальних тарифів): актуальні тарифи використовують API котирувань Andreani. Andreani видає бізнес-клієнтам облікові дані API, код клієнта та номери договорів, зазвичай від приблизно 300 відправлень на місяць. Дивіться developers.andreani.com або напишіть на ventapyme@andreani.com. Вам потрібні ім'я користувача та пароль API, код клієнта і номер договору. Andreani видає окремий договір для кожної послуги (доставка додому, самовивіз з відділення). Без доступу до API використовуйте фіксовані ціни. Вибір відділення працює без облікових даних.

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

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

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

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

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

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

5. Укажіть назву, джерело тарифів, ціни за країнами (наприклад AR=5000) і для актуальних тарифів облікові дані API, код клієнта та номер договору (див. Налаштування).

6. Перейдіть до WooCommerce > Settings > Shipping > Shipping zones, відкрийте або створіть зону для Аргентини та додайте VibeFox Andreani. У вікні зони можна задати заголовок, спосіб доставки та окремий договір для цієї опції. Також можна ввімкнути Ignore shipping zones і обрати країни.

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

Основні параметри розташовані в WooCommerce > Settings > Shipping > VibeFox Andreani. Вони діють для всіх зон доставки. Попередження про незаповнені налаштування (облікові дані API, номер договору, курс обміну, немає ціни для Аргентини) з'являються вгорі сторінки. Щоразу, коли ви зберігаєте налаштування, кешовані токен, список відділень і тарифи очищаються.

Вікно зони (коли ви додаєте спосіб до зони доставки)

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

Delivery modality: Use global setting або один із чотирьох способів (див. нижче). Додайте спосіб до зони двічі, наприклад від дверей до дверей і самовивіз з відділення, щоб пропонувати обидва.

Contract number: договір Andreani для цієї опції. Залиште порожнім, щоб використовувати загальний договір.

Загальні

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

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

Tax status: Taxable означає, що WooCommerce додає податок до вартості доставки, тож тариф API береться без IVA. None означає, що тариф API береться з урахуванням IVA.

Andreani API (потрібно для актуальних тарифів)

Environment: Sandbox / QA (apisqa.andreani.com) (за замовчуванням) або Production (apis.andreani.com). Використовуйте середовище, до якого належать ваші облікові дані.

API username: ім'я користувача вашого API Andreani.

API password: пароль вашого API Andreani.

Client code: код клієнта (código de cliente), наданий Andreani, наприклад CL0000000.

Contract number: договір послуги, яка використовується для тарифів, наприклад доставка додому. Зона може використовувати інший договір, наприклад для самовивозу з відділення.

Origin branch code: необов'язкове відділення відправлення (sucursalOrigen) для котирувань тарифів. Залиште порожнім, щоб використовувати відділення, вказане у вашому договорі.

Доставка та тарифи

Delivery modality: перша частина вказує, звідки Andreani забирає посилку (ваша адреса або відділення, куди ви її здаєте). Друга частина вказує, де покупець її отримує.

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

Country prices: фіксована ціна для кожної країни призначення у валюті вашого магазину, по одному рядку на країну у форматі CC=PRICE, наприклад AR=5000. Використовується у фіксованому режимі та як резервний варіант, якщо API не працює. Рядки в іншому форматі ігноруються, а під час збереження з'являється попередження з їх переліком.

ARS exchange rate: Andreani формує котирування в аргентинських песо. Потрібно лише якщо валюта вашого магазину не ARS: ціна 1 ARS у валюті вашого магазину, наприклад 0.001. Без неї тарифи API не використовуються. Фіксовані ціни завжди у валюті магазину.

Default product weight (kg): використовується для товарів без ваги під час запиту тарифів API та перевірки обмежень ваги. За замовчуванням: 0.5.

Calculation type: Per order стягує ціну один раз. Per item (price x number of items) множить фіксовану ціну з Country prices на кількість товарів у кошику. Актуальний тариф Andreani вже розрахований на весь кошик і не множиться.

Доступність

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

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

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

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

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

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

Безкоштовна доставка

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

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

Вибір відділення на оформленні замовлення (показується для Door to branch і Branch to branch)

Province select width: ширина списку областей у CSS, наприклад 100% або 300px. За замовчуванням: 100%.

Branch select width: ширина списку відділень у CSS, наприклад 100% або 400px. За замовчуванням: 100%.

Додатково

Debug log: записує запити до API та розрахунки тарифів у WooCommerce > Status > Logs (джерело «vfd-andreani»). Помилки записуються завжди. Облікові дані та токени ніколи не записуються.

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

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

Коли покупець вводить адресу доставки, плагін перевіряє вагу кошика (ваги товарів переводяться в кг; товари без ваги використовують Default product weight (kg)), Minimum subtotal та Excluded shipping classes.

У фіксованому режимі ціна береться з Country prices. В актуальних режимах плагін входить в API Andreani і запитує котирування з поштовим індексом призначення, договором, кодом клієнта, вагою в кг, об'ємом за розмірами товарів і заявленою вартістю (проміжна сума кошика в ARS). Актуальний тариф запитується лише для коректного аргентинського поштового індексу. Сума в ARS конвертується за курсом ARS exchange rate, якщо валюта вашого магазину не ARS.

Токен входу кешується на 23 години і автоматично оновлюється, коли Andreani його відхиляє. Котирування кешуються на 1 годину. Невдалий запит до API не повторюється протягом 5 хвилин. Помилки API ніколи не показуються покупцеві: спосіб приховується або в резервному режимі використовується фіксована ціна. Причина записується в журнал.

Якщо Free shipping увімкнено і проміжна сума кошика досягає Free shipping from, тариф становить 0. Безкоштовна доставка застосовується лише там, де у способу є ціна: якщо API Andreani не повертає тариф (і немає фіксованої ціни для резерву), спосіб не відображається. За Per item фіксована ціна множиться на кількість товарів.

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

Плагін не створює відправлень Andreani, не друкує етикетки і не відстежує посилки. Для цього скористайтеся веб-порталом Andreani.

Пункти видачі

За Door to branch або Branch to branch під опцією Andreani на оформленні замовлення з'являються список областей і список відділень, як у класичному оформленні замовлення, так і в блоці Checkout. Область попередньо вибирається за адресою доставки. Список відділень береться з публічного API відділень Andreani і кешується на 12 годин. Відділення, які не видають посилки, не відображаються. Якщо відділень немає, покупець бачить повідомлення і може обрати інший спосіб доставки.

Замовлення не можна оформити без відділення: покупець бачить повідомлення Please select an Andreani pickup branch. Це перевіряється на сервері для обох варіантів оформлення.

Обране відділення зберігається в замовленні. На екрані замовлення в адмін-панелі спосіб і відділення показуються під адресою доставки. Натисніть Edit, щоб обрати іншу область і відділення. Покупець бачить відділення як Andreani pickup branch на сторінці замовлення та в листах про замовлення (HTML і текстова версія). Наявні замовлення зберігають дані про відділення.

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: увімкніть Debug log, перезавантажте оформлення замовлення і відкрийте WooCommerce > Status > Logs (джерело «vfd-andreani»). Там видно причину: відсутні облікові дані або номер договору, невдалий вхід (неправильні ім'я користувача, пароль або середовище), ще немає коректного аргентинського поштового індексу, немає курсу обміну або HTTP-помилка Andreani. З Andreani API, fixed price if the API fails покупці все одно отримують фіксовану ціну, поки ви усуваєте проблему.

Мій магазин не в аргентинських песо: встановіть ARS exchange rate на значення 1 ARS у валюті вашого магазину.

Податок на доставку виглядає неправильно: якщо Tax status встановлено на Taxable, використовується тариф Andreani без IVA, а WooCommerce додає власний податок. Із None використовується тариф з IVA, і WooCommerce податок не додає. Якщо ви використовуєте Taxable, перевірте, що податки WooCommerce налаштовані.

У списку немає відділень: API відділень Andreani не відповів. Невдалий запит повторюється через 5 хвилин. Перегляньте журнал.

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

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

Видалення

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

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