VibeFox Sameday Easybox for WooCommerce — Допомога

Вимоги

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

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

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

Ім'я користувача та пароль API Sameday: доступ до API є частиною бізнес-облікового запису Sameday у Румунії, Угорщині або Болгарії. Уточніть у свого менеджера Sameday або в команді інтеграції Sameday. Облікові дані часто такі самі, як для порталу eAWB (eawb.sameday.ro, .hu або .bg). Для демо-API Sameday надає окремі тестові облікові дані. Без імені користувача та пароля API спосіб доставки не пропонується, оскільки покупець не зможе обрати локер.

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

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

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

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

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

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

5. Введіть API username та API password Sameday, оберіть Sameday country і збережіть. Сторінка має показати "Connected to Sameday ... easybox lockers". Поля Pickup point та Easybox service заповнюються з вашого облікового запису.

6. Налаштуйте ціни: Exchange rate of the estimate, якщо валюта вашого магазину відрізняється від валюти Sameday, і рядок Country prices (наприклад * Default) або Fallback cost.

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

Конфігурація

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

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

Над налаштуваннями сторінка показує статус підключення: хост Sameday, кількість локерів easybox і час останнього оновлення списку, або повідомлення про те, що Sameday відхилив ім'я користувача чи пароль. Також перелічуються проблеми конфігурації, наприклад відсутні облікові дані, ціна або курс обміну для розрахунку.

Усі ціни та обмеження приймають кому або крапку як десятковий роздільник (4,99 або 4.99). Некоректне число відхиляється з повідомленням.

Загальні

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

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

Tax status: Taxable додає податок WooCommerce до вартості доставки, None не додає.

Обліковий запис Sameday (API)

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

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

API password: ваш пароль API Sameday. Якщо Sameday його відхилив, повторна спроба не робиться протягом 10 хвилин.

Sameday country: країна вашого облікового запису Sameday: Romania (api.sameday.ro) (за замовчуванням), Hungary (api.sameday.hu) або Bulgaria (api.sameday.bg). Пропонуються її локери, а спосіб відображається лише для цієї країни призначення.

Test mode: використовує демо-API Sameday з демонстраційними обліковими даними.

Ціни

Порядок використання такий: розрахунок Sameday (коли задані Pickup point і Easybox service), потім таблиця цін за країнами, потім запасна вартість. Ціни в таблиці вводяться у валюті магазину.

Pickup point: ваш пункт приймання Sameday, де Sameday забирає посилки. Після успішного входу це список пунктів приймання вашого облікового запису, і пункт за замовчуванням обирається автоматично. Потрібен для розрахунку Sameday. Оберіть - not set (price table only) -, щоб використовувати лише таблицю цін.

Easybox service: послуга Sameday для доставки easybox, зазвичай "Locker NextDay" (код LN), обирається автоматично. Потрібна для розрахунку Sameday.

Exchange rate of the estimate: Sameday розраховує вартість у валюті вашої країни Sameday: RON, HUF або BGN (EUR для болгарських магазинів, які продають у євро). Якщо ваш магазин продає в іншій валюті, введіть вартість 1 одиниці валюти Sameday у валюті магазину, наприклад 0.20. Без цього значення розрахунок не використовується, і діє таблиця цін. Лев і євро конвертуються автоматично за фіксованим курсом.

Table price: Per order стягує ціну один раз. Per item (price x quantity) множить її на кількість товарів, які можна доставити. Це стосується ціни з таблиці та запасної вартості. Розрахунок Sameday завжди стосується всієї посилки.

Country prices: ціна для кожної країни призначення та ваги посилки. Натисніть + Add country, щоб додати рядок, і хрестик, щоб видалити його. Кожен рядок має колонку Price та колонки ваги: XS до 1 кг, S 1–2 кг, M 2–3 кг, L 3–5 кг і XL понад 5 кг. Колонка ваги, залишена на 0, використовує колонку Price. Рядок * Default використовується для країн без власного рядка. Новий рядок створюється як * Default зі всіма цінами 0, що означає безкоштовну доставку. Оберіть країну та введіть ціни перед збереженням або видаліть рядок. Якщо одна країна вказана у двох рядках, під час збереження залишається лише перший. Якщо клітинка не є допустимим числом, таблиця не зберігається.

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

Free shipping from: сума кошика (після знижок, без податку), починаючи з якої доставка easybox безкоштовна. Діє лише там, де знайдено ціну: рядок країни, рядок * Default або запасна вартість (тоді розрахунок Sameday не запитується), або розрахунок Sameday. Залиште порожнім, щоб ніколи не пропонувати безкоштовну доставку.

Доступність

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

Maximum weight (kg): посилки важчі за це значення не отримують пропозицію доставки easybox. Default: 30. Перевірте ліміт вашого договору з Sameday та розміри комірок easybox. Порожнє поле або 0 означає відсутність обмеження.

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

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

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

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

Додатково

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

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

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

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

Інакше плагін запитує в Sameday розрахунок, щойно покупець вкаже місто та область. Він надсилає ваш пункт приймання та послугу, вагу посилки, а також вулицю, місто, область і поштовий індекс покупця. Ім'я, e-mail і телефон не надсилаються. Бухарест надсилається як "Sector 1", як і в офіційному плагіні Sameday. Розрахунок перераховується у валюту вашого магазину. Якщо розрахунку немає (не налаштовано, ще немає міста чи області, помилка, немає курсу обміну), ціна береться з таблиці за країнами, потім із запасної вартості. Якщо ціни немає, спосіб приховується.

Проблеми з Sameday ніколи не зривають оформлення замовлення. Розрахунок кешується на 1 годину. Помилка кешується на 10 хвилин. Після тайм-ауту або помилки сервера розрахунок не запитується протягом 5 хвилин. Запити завершуються за 15 секунд. Список локерів під час оформлення замовлення читається з вашого сервера, а не з Sameday.

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

Плагін не створює AWB (відправлення), не друкує етикетки, не відстежує посилки та не обробляє накладений платіж. Немає кур'єрської доставки додому та віджета карти Sameday. Створіть AWB у порталі Sameday eAWB або у звичному інструменті, використовуючи ID локера, що показаний у замовленні.

Вибір локера

Коли покупець обирає спосіб доставки, під ним з'являється блок easybox locker із двома списками: - Select city - і - Select easybox locker -. Місто покупця попередньо обирається, якщо там є локери. Кожен локер показує свою назву та адресу. Вибір запам'ятовується під час оновлення оформлення замовлення або перезавантаження сторінки.

Локер обов'язковий. Без нього оформлення замовлення зупиняється з повідомленням "Please choose a Sameday easybox locker.". Сервер перевіряє, що обраний локер є у списку, як у класичному оформленні замовлення, так і в блочному. Підроблений або видалений ID локера відхиляється з повідомленням "The selected easybox locker is not available any more. Please choose another easybox locker.". Назва та адреса, що зберігаються із замовленням, беруться зі списку, а не з браузера.

Екран замовлення в адмінпанелі: Sameday easybox locker з назвою та адресою і Locker ID для AWB Sameday, під адресою доставки. Якщо в замовленні easybox немає локера, на екрані з'являється повідомлення "No easybox locker was selected for this order.".

Сторінка подяки та перегляд замовлення: Sameday easybox locker: з назвою та адресою.

Листи про замовлення: назва та адреса локера в HTML- і текстових листах. Листи адміністратору також містять Locker ID.

У базі даних локер зберігається в метаданих замовлення _vfd_sdeb_locker_id (ID локера Sameday для AWB) і _vfd_sdeb_locker_name (назва та адреса).

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

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

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

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

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

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

Sameday easybox не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено, ім'я користувача та пароль API введені, а на сторінці налаштувань написано "Connected to Sameday", і що країна призначення є країною вашого облікового запису Sameday. Перевірте, що доступна ціна (розрахунок Sameday, рядок країни, рядок * Default або Fallback cost), обмеження ваги та суми, Excluded shipping classes, а також що спосіб доданий до відповідної зони (або увімкнено Ignore shipping zones). Увімкніть Debug log, щоб побачити причину в WooCommerce > Status > Logs.

Sameday відхилив ім'я користувача або пароль API: перевірте їх і збережіть знову. Демонстраційні облікові дані працюють лише з увімкненим Test mode, робочі — лише з вимкненим. До того часу пропонується збережений список локерів, якщо він є, а розрахунок Sameday не використовується.

Ціна береться з моєї таблиці, а не з Sameday: для розрахунку потрібні Pickup point, Easybox service і, якщо валюта вашого магазину відрізняється від валюти Sameday, Exchange rate of the estimate. Розрахунок запитується лише після того, як покупець вказав місто та область. Коли Sameday недоступний або повертає помилку, використовується таблиця або запасна вартість; причина є в журналі.

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

Доставка безкоштовна помилково: перевірте Country prices на рядки з Price 0, особливо на рядок * Default, доданий через + Add country і залишений незаповненим.

Транскордонні локери: розробники можуть додавати країни призначення фільтром vfd_sdeb_countries. Список локерів завжди належить вашому обліковому запису.

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

Видалення

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

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