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

Вимоги

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

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

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

Обліковий запис Servientrega (лише для актуальних тарифів): актуальні тарифи використовують Cotizador Corporativo Servientrega (корпоративний API котирувань). Вам потрібен корпоративний (кредитний) обліковий запис Servientrega з доступом до нього. Потрібні три значення: користувач, пароль і код білінгу (código de facturación, зазвичай починається з SER). Це ваші облікові дані SISCLINET, які видає ваш комерційний консультант Servientrega. Якщо ви використовуєте лише фіксовані ціни, обліковий запис Servientrega не потрібен.

Доступ до сервера (лише для актуальних тарифів): ваш сервер має мати доступ до web.servientrega.com через HTTP на порту 8058 (API котирувань) і порту 8081 (веб-сервіс шифрування паролів).

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

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

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

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

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

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

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

6. За бажанням додайте фіксовані ціни за країною та вагою і резервну вартість.

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

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

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

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

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

Загальні

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

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

API Servientrega (актуальні тарифи для Колумбії) (необов'язково; без облікових даних використовуються лише фіксовані ціни)

User (login): ваш користувач Servientrega / SISCLINET.

Password: ваш пароль Servientrega / SISCLINET, як ви його вводите. Плагін передає його на шифрування веб-сервісу Servientrega перед входом, так само як це робить офіційний клієнт Servientrega.

Billing code: код білінгу (código de facturación) вашого облікового запису Servientrega, який відображається в SISCLINET. Зазвичай починається з SER.

Усі три поля потрібні для актуальних тарифів. Актуальні тарифи запитуються лише для напрямків у Колумбії. Для інших країн використовуються фіксовані ціни.

Servientrega product: послуга з вашого договору з Servientrega, за якою запитується тариф.

Розрахункова вага — більша з фактичної та об'ємної.

Currency conversion rate: Servientrega розраховує в COP. Якщо валюта вашого магазину не COP, введіть вартість 1 COP у валюті вашого магазину, наприклад 0.00023. Оголошена вартість посилки перераховується в COP так само. Залиште поле порожнім, якщо валюта магазину — COP. Якщо магазин працює в іншій валюті, а це поле порожнє, актуальні тарифи не використовуються і діють фіксовані ціни. Плагін не завантажує курси валют. Крапка і кома приймаються як десятковий роздільник.

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

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

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

Price per country: таблиця країн і цін у валюті вашого магазину. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити. Price діє для будь-якої ваги. Вагові колонки XS ≤1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg і XL >5 kg замінюють Price для цієї ваги, якщо їхнє значення більше 0. Рядок * Default діє для всіх країн без власного рядка.

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

Fixed price applies: як нараховуються фіксовані ціни.

Актуальні тарифи Servientrega завжди розраховуються за відправлення.

Умови

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

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

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

Free shipping from: доставка безкоштовна, коли проміжна сума кошика (після знижок, до податків) досягає цієї суми. Це діє лише там, де метод має ціну: ціна з таблиці або резервна вартість (тоді запит до Servientrega не надсилається) чи актуальний тариф. Залиште порожнім, щоб ніколи не пропонувати безкоштовну доставку.

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None — не додає. Котирування Servientrega (ValorTotal) вже включають збори перевізника. Оберіть None, якщо не хочете додавати податок зверху.

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

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

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

Додатково

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

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

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

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

Для напрямку в Колумбії з налаштованими обліковими даними плагін знаходить код DANE муніципалітету покупця. Він використовує код DANE, введений як поштовий індекс або в полі міста, або співставляє департамент і місто з вбудованою таблицею близько 1 130 муніципалітетів. Наголоси та «D.C.» ігноруються. Назва міста, яка є лише в одному департаменті, знаходиться навіть без вказування департаменту.

Далі плагін надсилає до Servientrega одне місце на замовлення: загальну вагу, перераховану з одиниць вашого магазину в кг, і коробку з довжиною та шириною найбільшого товару та загальним об'ємом усіх товарів, перерахованим у см. Товари без розмірів рахуються як 10 × 10 × 10 см. Оголошена вартість — проміжна сума кошика, перерахована в COP, але не менше 6 000 COP. Servientrega повертає підсумок у COP, а плагін конвертує його у валюту вашого магазину.

Токен входу зберігається до закінчення строку дії, але не більше 4 днів. Відхилений токен автоматично оновлюється один раз. Кожне котирування кешується на 1 годину на маршрут і посилку, тож той самий кошик не викликає новий запит. Невдалий запит (шифрування, вхід або котирування) кешується на 10 хвилин, щоб оформлення замовлення не чекало Servientrega під час кожного оновлення. Тайм-аут — 10 секунд на запит.

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

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

Плагін лише розраховує тарифи. Він не створює накладні (guías), етикетки чи наклейки, не замовляє забір, не відстежує й не скасовує відправлення і не дозволяє покупцям вибрати відділення Servientrega (Centro de Soluciones). Накладну створіть у SISCLINET або в порталі Servientrega. Накладений платіж (logística de recaudo) не розраховується. Актуальні котирування стосуються лише внутрішніх відправлень у межах Колумбії. Еквадор, Перу, Панама та міжнародні відправлення використовують фіксовані ціни.

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

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

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

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

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

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

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

Актуальні тарифи не з'являються: увімкніть Debug log, перезавантажте оформлення замовлення і відкрийте WooCommerce > Status > Logs, джерело vfd_servientrega. Поширені причини: немає курсу конвертації (валюта магазину не COP), немає коду DANE місця відправлення, департамент або місто покупця ще не введені чи не є відомим муніципалітетом, неправильні облікові дані або немає покриття для маршруту. Фіксовані ціни покривають ці випадки, якщо ви їх задали.

Вхід не вдається: перевірте користувача, пароль і код білінгу у свого комерційного консультанта Servientrega. Після невдалого входу плагін чекає 10 хвилин перед наступною спробою. Збережіть налаштування, щоб спробувати одразу.

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

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

Для розробників: фільтри vfd_svtg_quote_request та vfd_svtg_default_dimensions змінюють запит котирування та розміри товарів, яких вони не мають. vfd_svtg_api_base і vfd_svtg_soap_url змінюють кінцеві точки, наприклад якщо Servientrega надасть вам інший сервер.

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

Видалення

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

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