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

Вимоги

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

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

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

Обліковий запис ShipStation: підключіть перевізників у ShipStation (Settings > Shipping > Carriers), а потім скопіюйте API Key і API Secret зі сторінки ShipStation > Settings > Account > API Settings. Доступ до API залежить від вашого тарифного плану ShipStation. Якщо сторінка недоступна, ваш план не містить доступу до API. Плагін використовує ShipStation API V1 (API Key і API Secret). Облікові записи ShipStation API V2 з одним ключем API не підтримуються. Без ключів використовуються лише резервні ціни.

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

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

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

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

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

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

5. Вставте API Key і API Secret, введіть поштовий індекс відправлення та збережіть. Сторінка тепер покаже коди перевізників вашого облікового запису. Введіть потрібні в Carrier codes і збережіть ще раз.

6. Якщо валюта вашого магазину не збігається з валютою облікового запису ShipStation, задайте Exchange rate.

7. За бажанням заповніть резервні ціни.

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

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

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

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

Щоразу, коли ви зберігаєте налаштування, кеш тарифів ShipStation очищується, а API Key та API Secret перевіряються. Потім сторінка показує перевізників, підключених до вашого облікового запису, з їхніми кодами, наприклад "stamps_com (Stamps.com), ups_walleted (UPS by ShipStation)". Попередження над налаштуваннями повідомляють, коли актуальні тарифи не можуть працювати: немає ключів, немає коду перевізника, немає поштового індексу відправлення, немає курсу обміну, не пройшла перевірка з'єднання або коди перевізників не підключені до вашого облікового запису.

Загальні

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

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

Обліковий запис ShipStation

API Key: API Key зі сторінки ShipStation > Settings > Account > API Settings.

API Secret: API Secret з тієї самої сторінки.

Carrier codes: один або кілька кодів перевізників ShipStation через кому, наприклад stamps_com, ups_walleted. Використовується до 5 кодів, з одним запитом до API на кожного перевізника. Показується найдешевший тариф цих перевізників. Беріть коди зі списку, який з'явиться після збереження.

Allowed services: необов'язково, коди служб ShipStation через кому, наприклад usps_priority_mail, ups_ground. Залиште порожнім, щоб показувати найдешевшу службу перевізників, вказаних вище.

Package code: "package" (за замовчуванням) розраховує тариф для вашої власної коробки та виключає конверти перевізника і коробки з фіксованим тарифом. Залиште порожнім, щоб розраховувати тарифи для всіх типів упаковки, які пропонує перевізник.

Відправлення з

Ship-from postal code: обов'язковий для актуальних тарифів. ShipStation розраховує тарифи лише за поштовим індексом, і він має бути в країні вашого облікового запису ShipStation. Залиште порожнім, щоб використовувати поштовий індекс магазину з WooCommerce > Settings > General.

Тарифи

Parcels: як кошик надсилається до ShipStation.

ShipStation account currency: валюта, у якій ShipStation повертає тарифи: USD, CAD, GBP, AUD, NZD або EUR. За замовчуванням: USD (облікові записи США).

Exchange rate: ціна 1 одиниці валюти облікового запису у валюті вашого магазину, наприклад 0.92. Потрібен лише тоді, коли валюта магазину відрізняється від валюти облікового запису. Без нього актуальні тарифи не використовуються і застосовуються резервні ціни. Курси обміну не оновлюються автоматично.

Tax status: Taxable дозволяє WooCommerce додавати податок на доставку згідно з вашими податковими правилами, None не додає. Тарифи ShipStation не містять податку з продажу.

Резервні ціни (використовуються, коли немає актуального тарифу: немає API-ключів, ShipStation недоступний або перевізники не повернули тарифів для адреси; ціни у валюті вашого магазину; залиште таблицю та Other countries порожніми, щоб у цьому разі приховати спосіб)

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

Other countries: ціна, якщо в таблиці немає ціни для країни. Залиште порожнім, щоб у цьому разі приховати спосіб.

Умови

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

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

Minimum weight: мінімальна вага кошика в одиницях ваги вашого магазину, за якої показується цей спосіб. 0 означає без обмеження.

Maximum weight: спосіб приховується, якщо вага кошика більша за це значення в одиницях ваги вашого магазину. 0 означає без обмеження.

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

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

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

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

Додатково

Debug log: записує запити до ShipStation у WooCommerce > Status > Logs, джерело vfd-shipstation. Помилки API записуються завжди, навіть коли цю опцію вимкнено. API Key, API Secret і адреси покупців ніколи не записуються. Поштовий індекс маскується.

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

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

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

Далі плагін надсилає до ShipStation поштовий індекс відправлення, країну призначення, регіон, місто та поштовий індекс призначення, вагу посилки і розмір коробки. Запит не надсилається, доки покупець не введе поштовий індекс. Країни без поштових індексів отримують резервні ціни. Ваги та розміри перераховуються з одиниць вашого магазину. Товари складаються в одну коробку. Якщо товар не має розмірів, посилка розраховується лише за вагою.

ShipStation запитується один раз для кожного коду перевізника. Плагін показує найдешевший дозволений тариф, перерахований у валюту вашого магазину, під назвою способу.

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

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

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

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

Замовлення

Рядок доставки замовлення зберігає обрану Service, наприклад "USPS Ground Advantage - Package". Ви бачите її на екрані замовлення в адмін-панелі і можете створити відповідну етикетку в ShipStation.

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

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

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

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

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

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

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

На оформленні замовлення показується резервна ціна замість тарифу ShipStation: перевірте попередження вгорі сторінки налаштувань (ключі, код перевізника, поштовий індекс відправлення, курс обміну). Увімкніть Debug log і відкрийте WooCommerce > Status > Logs, джерело vfd-shipstation. Потрібен поштовий індекс покупця. Запит не надсилається, доки його не введено.

Який код перевізника вводити: збережіть налаштування з ключем і секретом. Сторінка покаже коди перевізників вашого облікового запису. Використовуйте один або кілька з них.

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

Для розробників: фільтри vfd_shst_rate_request, vfd_shst_selected_rate і vfd_shst_api_url змінюють запит тарифу для кожного перевізника, обраний тариф і базову URL-адресу API.

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

Видалення

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

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