VibeFox Coordinadora for PrestaShop — Допомога

Вимоги

PrestaShop: 8.0–9.x.

PHP: 8.0 або новіша версія. Модуль не встановлюється на старіших версіях PHP.

Ключ API Coordinadora (лише для онлайн-тарифів): онлайн-тарифи надходять із Coordinadora Cotizador через сервіс Coordinadora WooCommerce, той самий, який використовує офіційний плагін Coordinadora. Ключ API Coordinadora видає клієнтам з чинною комерційною угодою. Зверніться до свого менеджера облікового запису Coordinadora або перегляньте wc.coordinadora.com. Також потрібен 8-значний код DANE міста, з якого ви відправляєте. Без ключа перевізник працює лише з фіксованими цінами.

Товари: для онлайн-тарифу кожен товар у кошику повинен мати вагу та розміри (ширина, висота, глибина).

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

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

1. У back office перейдіть до Modules > Module Manager і натисніть Upload a module. Оберіть ZIP-файл модуля.

2. Після завершення завантаження натисніть Configure або пізніше знайдіть VibeFox Coordinadora у списку модулів і натисніть Configure.

3. Введіть ліцензійний ключ VibeFox у License key у блоці ліцензії у верхній частині сторінки Configure і натисніть Activate (див. Ліцензійний ключ).

4. Введіть ключ API, код DANE міста відправлення і, якщо ваша валюта за замовчуванням не COP, курс обміну на COP. Додайте принаймні одну фіксовану ціну для Колумбії як запасний варіант (див. Налаштування). Натисніть Save.

5. Переконайтеся, що Колумбія активна у вашому магазині, а товари мають вагу та розміри.

Під час встановлення модуль створює перевізника Coordinadora з текстом терміну доставки Courier delivery in Colombia. Перевізник призначається всім зонам і всім групам клієнтів. Зони, групи клієнтів, термін доставки, логотип і обмеження розміру можна змінити в Shipping > Carriers. Не встановлюйте там ціни: ціна завжди береться з модуля.

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

Усі параметри розташовані на сторінці модуля: Modules > Module Manager > VibeFox Coordinadora > Configure. Вони застосовуються до всіх зон перевізника. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Кожне збереження також очищає кеш тарифів Coordinadora. Числа можна вводити з крапкою або комою (9,99 = 9.99).

Сторінка не зберігає дані та показує помилку, якщо число або ціна в таблиці некоректні чи від'ємні, COP per 1 unit of store currency дорівнює 0, Min weight більше за Max weight або Name довший за 64 символи. Нічого не зберігається, доки ви не виправите.

Сторінка показує попередження у верхній частині, коли онлайн-тарифи не можуть працювати або перевізник буде прихований: Origin city (DANE code) порожній або некоректний, відсутній COP per 1 unit of store currency, хоча валюта за замовчуванням не COP, або немає фіксованої ціни для Колумбії (чи *). Без ключа API та без такої фіксованої ціни перевізник ніколи не показується для колумбійських адрес. Попередження також з'являється, якщо модуль не знає одиницю ваги або розміру магазину в International > Localization (Local units); тоді вага товарів читається як кг, а розміри як см.

Загальне

Enable Coordinadora: вмикає або вимикає перевізника. Це той самий перемикач, що й статус перевізника в Shipping > Carriers.

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

Tax: податкове правило перевізника або No tax. З правилом PrestaShop додає податок на доставку понад тариф. Оберіть No tax, якщо ваші ціни або тариф Coordinadora вже містять податок.

Онлайн-тарифи Coordinadora

Онлайн-тарифи запитуються для адрес у Колумбії. Залиште ключ порожнім, щоб використовувати лише фіксовані ціни.

API key: ваш ключ API Coordinadora WooCommerce, отриманий від Coordinadora. Після збереження поле залишається порожнім і показує Saved — leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити. Ключ ніколи не записується в журнал.

Remove the saved API key: з'являється, лише якщо ключ збережено. Увімкніть і натисніть Save, щоб видалити ключ; після цього перевізник використовуватиме лише фіксовані ціни.

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

COP per 1 unit of store currency: Coordinadora розраховує тарифи в колумбійських песо. Якщо валюта за замовчуванням не COP, вкажіть, скільки COP становить 1 одиниця вашої валюти, наприклад 4300. Курс також використовується для передачі оголошеної вартості в COP. Якщо залишити поле порожнім, онлайн-тарифи не використовуються. Курс має бути більшим за 0. Якщо валюта за замовчуванням — COP, залиште поле порожнім.

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

Prices by country: таблиця країн зі стовпцем Price та необов'язковими цінами за розміром посилки у вашій валюті за замовчуванням, без податку. Розмір визначається за вагою кошика: XS до 1 кг, S 1–2 кг, M 2–3 кг, L 3–5 кг, XL понад 5 кг. Price використовується, коли в стовпці розміру стоїть 0 або порожньо. Натисніть Add country, щоб додати рядок, і хрестик, щоб видалити. Країна * All other countries застосовується до країн без власного рядка. Країна без рядка (і без *) не отримує фіксованої ціни. Рядок із Price 0 і без ціни за розміром дає безкоштовну доставку.

Fixed price per: Order стягує ціну один раз. Item (price × quantity) множить її на кількість товарів у кошику. Це стосується лише фіксованих цін; онлайн-тариф Coordinadora завжди охоплює все замовлення.

Умови

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

Max weight: приховує перевізника при вазі кошика вище цього значення, в кг. За замовчуванням: 25 (також використовується, якщо поле порожнє). 0 означає без обмежень. Не може бути меншим за Min weight.

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

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

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

Countries: пропонувати Coordinadora лише для цих країн призначення. Показано лише активні країни. Залиште порожнім, щоб дозволити всі країни зон перевізника.

Додатково

Debug log: записує розрахунки тарифів у logs/vfd_crd_debug.log.php у папці модуля. Файл не можна відкрити з веб. Помилки API та неповні налаштування завжди записуються в журнал, навіть коли цю опцію вимкнено. Ключ API та адреси покупців ніколи не записуються.

Log: показує розмір і останні записи журналу налагодження. Натисніть Clear log, щоб його очистити.

Remove data on uninstall: якщо увімкнено, видалення модуля видаляє налаштування Coordinadora, перевізника, кешовані тарифи та журнали. Якщо вимкнено, усе зберігається для повторного встановлення.

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

На кроці доставки PrestaShop запитує в модуля ціну Coordinadora. Враховуються лише фізичні товари: віртуальні товари не додають ваги і не входять до тарифу. Модуль спочатку перевіряє умови: дозволені країни, вагу кошика та мінімальну суму замовлення. Якщо діє безкоштовна доставка, ціна дорівнює 0 і запит до Coordinadora не надсилається.

Для адреси в Колумбії з ключем API модуль знаходить код DANE міста призначення в такому порядку: код DANE у полі міста (модулі колумбійських департаментів і міст для оформлення записують його, наприклад MEDELLIN (ANT) (05001000)), 8-значний поштовий індекс або вбудований список обласних центрів і близько 40 найбільших міст. Якщо в адресі вказано область (штат), місто зі списку перевіряється відповідно до неї. Діакритичні знаки та регістр не враховуються.

Далі модуль надсилає Coordinadora код DANE призначення та кожен товар з містом відправлення, його вагу (кг), розміри (см), кількість і оголошену вартість (COP). Оголошена вартість — це сума рядка товару до податків і до знижок кошика. Одиниці вимірювання магазину перераховуються автоматично. Coordinadora повертає ціну в COP, а модуль перераховує її у валюту за замовчуванням, а потім у валюту кошика покупця. Кожен тариф кешується на 1 годину. Невдалий запит запам'ятовується на 10 хвилин, щоб збій Coordinadora ніколи не уповільнював кожне оновлення сторінки оформлення. Тайм-аут API — 10 секунд.

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

Якщо ви редагуєте перевізника в Shipping > Carriers після того, як у нього є замовлення, PrestaShop зберігає його як нову версію перевізника. Модуль автоматично слідує за новою версією.

Модуль лише розраховує тарифи. Він не створює відправлення та накладні (guías), не друкує етикетки, не замовляє забір посилок (recogidas), не відстежує відправлення, не приймає накладений платіж (recaudo) і не пропонує пункти видачі Droop; для цього використовуйте портал Coordinadora. Міжнародні напрямки використовують фіксовані ціни.

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

Модуль працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox Coordinadora — це перший блок на сторінці Modules > Module Manager > VibeFox Coordinadora > Configure, над налаштуваннями. Вставте ключ у поле License key і натисніть Activate. Після цього блок показує ключ у прихованому вигляді, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче них розташовані рядок Product: presta-shipping-coordinadora і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис на vibefox.net. Змінювати ключ можуть лише співробітники з дозволом Configure для модуля. Тексти блоку відповідають мові бек-офісу (включено англійську та російську).

Якщо ключ не прийнято, блок повідомляє причину, наприклад Key not found, This key belongs to another product, Domain limit reached або License expired on з датою. Після зміни адреси магазину або після звільнення слота домену у вашому обліковому записі натисніть Check now. Якщо сервер ліцензій недоступний, модуль продовжує працювати за останнім відомим статусом.

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

Без чинного ключа перевізник Coordinadora не показується покупцям під час оформлення замовлення, і тариф не розраховується. Вітрина PrestaShop не знає, що ви ввійшли в бек-офіс, тому перевізник приховано й для вас: модуль можна налаштувати до купівлі ключа, але перевірити його під час оформлення замовлення не можна. Нагадування з'являється в Modules > Module Manager на вкладці Alerts. Наявні замовлення не змінюються.

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

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

Coordinadora не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і увімкнено Enable Coordinadora. У Shipping > Carriers перевірте, що перевізник охоплює зону країни покупця та його групу клієнтів. Перевірте Countries, обмеження ваги та Minimum order subtotal. Без онлайн-тарифу має існувати фіксована ціна для країни або для *. Товари також можна обмежити певними перевізниками на сторінці товару.

Онлайн-тариф не показується, лише фіксована ціна: увімкніть Debug log, перезавантажте оформлення замовлення і перегляньте поле Log на сторінці модуля. Типові причини: місто призначення не розпізнано, у товару немає ваги або розмірів, бракує коду DANE міста відправлення чи курсу COP, або Coordinadora повернула помилку.

Місто призначення не розпізнано: встановіть модуль колумбійських департаментів і міст для оформлення замовлення, який записує код DANE в поле міста. Розробники можуть зіставити більше міст через хуки модуля actionVfdCrdDaneCities і actionVfdCrdDestinationDane або змінити адресу API через actionVfdCrdApiUrl.

Тариф включає податок? Тариф — це сума, яку розраховує Coordinadora. З правилом Tax PrestaShop додає податок на доставку зверху; оберіть No tax, якщо тариф уже його містить.

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

Сторінка повідомляє, що перевізника Coordinadora не знайдено: перевізника видалено в Shipping > Carriers. Скиньте модуль у Modules > Module Manager, щоб створити його знову.

Видалення

Перейдіть до Modules > Module Manager, відкрийте меню поруч із VibeFox Coordinadora і оберіть Uninstall. Ліцензійний ключ, статус ліцензії та кешовані тарифи завжди видаляються. Якщо Remove data on uninstall увімкнено, перевізника буде видалено (замовлення зберігають історію), а налаштування та журнал — прибрано. Якщо вимкнено, перевізник лише деактивується і всі налаштування зберігаються. Повторне встановлення модуля або Reset повертає збереженому перевізнику статус, який він мав раніше: перевізник, який ви вимкнули, залишається вимкненим.

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