VibeFox SMSA Express for WooCommerce — Допомога

Вимоги

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

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

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

Тарифи SMSA Express: ціни для тарифної таблиці беруться з вашого облікового запису SMSA або від відділу продажів SMSA. Вводьте їх у валюті вашого магазину. Якщо ваші тарифи в SAR, AED або іншій валюті, спочатку переведіть їх.

passKey SMSA (лише для розрахунку в реальному часі): розрахунок у реальному часі використовує веб-сервіс SMSA (SECOM, операція getShipCharges). SMSA видає passKey на запит: зверніться до менеджера вашого облікового запису SMSA або напишіть на info@smsaexpress.com і попросіть доступ до веб-сервісу SMSA, вказавши номер вашого облікового запису. passKey може відрізнятися від API-ключа порталу електронної комерції SMSA. Для цього сервісу SMSA не надає тестового сервера (sandbox).

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

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

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

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

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

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

5. Введіть ваші ціни SMSA Express у тарифну таблицю.

6. Необов'язково: у розділі Live rates (API) увімкніть Live charges, введіть passKey SMSA, місто і країну відправлення та, якщо валюта вашого магазину не SAR, курс обміну.

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

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

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

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

Щоразу, коли ви зберігаєте налаштування, кеш розрахунків SMSA очищується. Коли розрахунок у реальному часі увімкнено, попередження над налаштуваннями повідомляють про відсутній passKey, місто відправлення чи курс обміну або про порожню тарифну таблицю.

Загальні

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

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

Розрахунок у реальному часі (API) (необов'язково; якщо SMSA не повертає вартість, використовується тарифна таблиця)

Live charges: отримувати вартість доставки від SMSA Express. За замовчуванням: вимк.

SMSA passKey: ключ веб-сервісу SMSA (SECOM). Якщо в журналі написано «Invalid Passkey», цей сервіс не приймає ключ. Запитайте в SMSA passKey веб-сервісу.

Ship-from city: місто, з якого відправляються ваші посилки, написане так, як його пише SMSA, наприклад Riyadh, Jeddah або Dammam. Залиште поле порожнім, щоб використовувати місто магазину з WooCommerce > Settings > General.

Ship-from country: країна, з якої відправляються ваші посилки. За замовчуванням це країна вашого магазину.

Shipment type: передається в SMSA як тип відправлення. DLV (за замовчуванням) означає стандартну доставку. Змінюйте його, лише якщо SMSA дав вам інший код.

Currency of SMSA charges: SMSA повертає кожну вартість з кодом валюти, зазвичай SAR (за замовчуванням). Вартість у будь-якій іншій валюті, крім цієї та валюти вашого магазину, не використовується.

Exchange rate: ціна 1 одиниці валюти SMSA у валюті вашого магазину, наприклад 0.24. Не потрібен, якщо валюти однакові. Без нього вартість в іншій валюті не використовується, і застосовується тарифна таблиця. Як десятковий роздільник приймаються і крапка, і кома.

Ціни (ваші тарифи SMSA Express у валюті магазину; використовуються, коли розрахунок у реальному часі вимкнено, і як запасний варіант, якщо SMSA не повертає вартість)

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

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

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

Ваги товарів переводяться з одиниці ваги вашого магазину в кілограми.

Умови

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

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

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

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

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

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

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

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

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

Додатково

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

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

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

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

Коли розрахунок у реальному часі увімкнено, плагін надсилає в SMSA місто і країну відправлення, місто і країну покупця, тип відправлення, вагу посилки в кг і суму накладеного платежу 0. SMSA відповідає вартістю та її валютою. Плагін перераховує її у валюту вашого магазину і показує. Розрахунок у реальному часі запитується лише після того, як покупець ввів місто.

Кожен розрахунок кешується на годину, тож той самий кошик не викликає новий запит. Невдалий запит кешується на 5 хвилин. Після тайм-ауту або помилки сервера SMSA не запитується 2 хвилини. Після відхиленого ключа — 5 хвилин. Так оформлення замовлення ніколи не чекає на сервіс, що не працює, при кожному оновленні. Тайм-аут запиту — 12 секунд.

Щоразу, коли SMSA не повертає придатної вартості (немає passKey, місто ще не введено, немає ваг товарів, недійсний ключ, тайм-аут, помилка, немає сервісу до міста або невідома валюта), використовується тарифна таблиця. Якщо таблиця і Price for countries not in the table не дають ціни, спосіб приховується. Покупець ніколи не бачить помилку. Причина записується в журнал.

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

Плагін лише розраховує вартість доставки. Він не створює відправлень SMSA, не друкує накладні AWB, не обробляє повернення і не відстежує посилки. Накладений платіж та його комісія не входять до розрахунку в реальному часі. Вибору роздрібного пункту SMSA немає: спосіб — доставка до дверей.

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

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

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

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

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

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

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

Покупці бачать ціну з таблиці замість вартості SMSA: SMSA потрібне місто покупця, тож доки його не введено, показується ціна з таблиці. Таблиця також використовується, коли SMSA не відповідає, відхиляє ключ або місто, або повертає вартість у валюті без курсу обміну. Відкрийте WooCommerce > Status > Logs, джерело vfd_smsa_express, щоб дізнатися причину.

«Invalid Passkey» у журналі: ключ не приймається веб-сервісом SMSA. Запитайте в SMSA passKey веб-сервісу.

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

Податок на доставку стягується двічі: ваші тарифи або вартість SMSA можуть уже містити ПДВ. Встановіть Tax status у значення None.

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

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

Видалення

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

SMSA Express є товарним знаком його власника. Цей плагін не пов'язаний із SMSA Express і не схвалений SMSA Express.