VibeFox Correos CityPaq for WooCommerce — Допомога

Вимоги

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

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

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

Облікові дані API Correos (лише для актуального списку поштоматів): список CityPaq від Correos зчитує активні поштомати через API «terminals» Correos. На порталі розробників Correos відкрийте API «terminals» і натисніть Request access для вашого застосунку. Correos схвалює запити своїх бізнес-клієнтів і надсилає client ID та client secret. Вони також показані в розділі My applications на порталі. Якщо покупці вводять поштомат самостійно або обирають зі вашого списку, облікові дані API не потрібні.

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

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

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

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

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

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

5. Заповніть таблицю цін і виберіть, як покупець обирає поштомат (див. розділ «Налаштування»).

6. Додайте VibeFox Correos CityPaq до зони доставки для Іспанії в WooCommerce > Settings > Shipping > Shipping zones або увімкніть Ignore shipping zones.

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

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

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

Попередження над налаштуваннями показують, коли в таблиці цін немає жодного придатного рядка, коли обраний спосіб вибору поштомата не може працювати (немає поштоматів у вашому списку, немає облікових даних API) і яка була остання помилка API Correos. Ціни та суми приймають десятковою комою або крапкою.

Загальні

Поштомати CityPaq є лише в Іспанії, тому метод ніколи не пропонується для інших країн.

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

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

Tax status: Taxable додає податок WooCommerce до цін з таблиці, None не додає.

Ціни (у заголовку розділу показано валюту вашого магазину)

Price table: рядок для Spain (ES) та/або рядок за замовчуванням *. Кожен рядок містить базову Price і необов'язкові ціни для розмірів посилок XS (до 1 кг), S (до 2 кг), M (до 3 кг), L (до 5 кг) та XL (понад 5 кг). Ціна розміру 0 або порожня використовує базову ціну. Натисніть + Add row, щоб додати рядок, і хрестик, щоб видалити його. Вводьте тарифи за вашим договором із Correos у валюті магазину. Без відповідного рядка метод приховано. Некоректні ціни та дубльовані рядки повідомляються під час збереження.

Calculation type: як визначається розмір посилки.

Per order (size by the total cart weight): одна ціна для всього кошика, обирається за загальною вагою. Це значення за замовчуванням.

Per item (size by each item weight, multiplied by quantity): кожен товар отримує ціну свого розміру, помножену на кількість, а ціни додаються.

Ваги товарів переводяться в кг з одиниці ваги вашого магазину (кг, г, фунти або унції).

Умови

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

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

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

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

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

Free shipping: вмикає безкоштовну доставку CityPaq від суми, зазначеної нижче.

Free shipping from: проміжна сума кошика (після знижок, до податків), починаючи з якої цей метод коштує 0. Використовується, лише якщо увімкнено Free shipping.

Вибір поштомата CityPaq

Locker selection: як покупець обирає поштомат перед оформленням замовлення. За замовчуванням: покупець вводить поштомат.

Customer chooses from the Correos CityPaq list (Correos API, credentials below): покупець бачить активні поштомати CityPaq за поштовим індексом адреси доставки і може шукати інший 5-значний поштовий індекс. Якщо для індексу немає поштомата, показуються поштомати тієї самої місцевості, потім тієї самої області, спочатку з найближчими поштовими індексами. Кожен поштомат показує назву, адресу, поштовий індекс, місто та графік роботи. Якщо список не вдається завантажити або він нічого не знаходить, покупець вводить поштомат вручну.

Customer enters the locker (code or address from the Correos finder): обов'язкове поле для коду поштомата (наприклад, S0000213D) або адреси, з посиланням на офіційний пошук поштоматів CityPaq від Correos.

Customer chooses from my list of lockers (below): обов'язковий випадаючий список поштоматів із My lockers. Поштомати поблизу поштового індексу покупця показуються першими.

Do not ask for a locker: питання про поштомат під час оформлення не ставиться.

Якщо ви обираєте список Correos без облікових даних API або власний список, коли My lockers порожній, покупцеві пропонується ввести поштомат вручну.

My lockers: використовується, коли Locker selection встановлено на ваш список. Один поштомат в рядку: CODE | Name | Address | Postal code | City. Код і назва обов'язкові. Некоректні та дубльовані рядки повідомляються під час збереження.

Список Correos CityPaq (API) (використовується лише зі списком Correos CityPaq)

Розділ містить посилання на сторінку API «terminals» на порталі розробників Correos. Зчитується лише список поштоматів. Ціни завжди беруться з таблиці цін.

API client ID: client_id вашого застосунку на порталі розробників Correos.

API client secret: client_secret вашого застосунку на порталі розробників Correos.

Коли ви змінюєте облікові дані або вибір поштомата, кешовані списки поштоматів очищаються.

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

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

Додатково

Debug log: записує рядки налагодження в WooCommerce > Status > Logs, джерело vfd-correos-citypaq. Помилки API Correos завжди записуються, навіть коли цей параметр вимкнено. Облікові дані та персональні дані ніколи не записуються.

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

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

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

Коли покупець обирає CityPaq, поле поштомата з'являється під методом. Замовлення не можна оформити без дійсного поштомата. Це також перевіряється на сервері, зокрема для замовлень, оформлених через блоки «Кошик» і «Оформлення замовлення». Зі списком Correos код поштомата приймається, лише якщо Correos запропонував його цьому покупцеві, а назва та адреса беруться з Correos. Кількість пошуків поштового індексу за сеанс покупця обмежена. Коли ліміт досягнуто, покупець вводить поштомат вручну.

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

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

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

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

Обраний поштомат зберігається в замовленні. Він відображається в адмін-панелі замовлення під адресою доставки, на сторінці «Замовлення отримано», у My account > Orders і в усіх листах про замовлення (HTML і простий текст) як CityPaq locker.

В адмін-панелі замовлення можна змінити поштомат у полі Change CityPaq locker: обрати інший поштомат зі свого списку або ввести новий код чи адресу. Зі списком Correos введений код поштомата перевіряється в Correos. Залиште поле порожнім, щоб зберегти поточний поштомат. Кожна зміна додає примітку до замовлення.

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

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

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

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

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

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

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

Покупці мають вводити поштомат, хоча обрано список Correos: перевірте, що заповнені API client ID і API client secret, і подивіться попередження над налаштуваннями. Там показано останню помилку API Correos. HTTP 401/403 означає, що Correos відхилив облікові дані: перевірте їх і переконайтеся, що ваш застосунок має доступ до API «terminals». Після помилки наступна спроба виконується через 10 хвилин.

Немає поштоматів для поштового індексу: Correos не знайшов активного поштомата для цього індексу, його місцевості чи області. Покупець може пошукати інший поштовий індекс або ввести поштомат, знайдений на пошуку CityPaq від Correos.

Випадаючий список моїх поштоматів не з'являється: My lockers порожній або його рядки некоректні. Кожен рядок має містити щонайменше CODE | Name.

Де покупці знаходять код поштомата: на пошуку CityPaq від Correos, посилання на який розміщено під полем поштомата.

Примітки для розробників: поштомат зберігається в метаданих замовлення _vfd_cpq_locker (текст, який відображається всюди) та _vfd_cpq_locker_id (код поштомата, коли він обраний зі списку Correos або зі вашого списку). Плагін використовує продуктивний API «terminals» Correos. Для цього API sandbox не задокументовано.

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

Видалення

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

Correos і CityPaq є торговими марками їхніх власників. Цей плагін не афілійований із Correos і не схвалений Correos.