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

Вимоги

PrestaShop: 8.0–9.x.

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

API-ключ PostNord (для вибору пункту видачі): створіть безкоштовний обліковий запис на developer.postnord.com, додайте застосунок і скопіюйте його API-ключ. Без ключа перевізники все одно працюватимуть, але покупці не зможуть обрати пункт видачі.

Договір із PostNord: щоб відправляти посилки, потрібен ваш звичайний клієнтський договір із PostNord, наприклад для MyPack Collect або MyPack Home.

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

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

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

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

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

4. Вставте API key PostNord, оберіть Agreement country, заповніть Country prices (див. розділ «Налаштування») і натисніть Save.

Під час встановлення модуль створює двох перевізників. PostNord доставляє до пункту видачі, з текстом строку доставки Delivery to a PostNord service point. Він увімкнений. PostNord Home delivery доставляє за адресою, з текстом PostNord home delivery. Він вимкнений, доки ви не увімкнете Home delivery. Обидва перевізники призначені для зон Швеції, Данії, Норвегії та Фінляндії та для всіх груп клієнтів. Зони, групи клієнтів, текст строку доставки, логотип і обмеження розміру можна змінити в розділі Shipping > Carriers. Ціни там не встановлюйте: ціна завжди береться з модуля.

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

Усі параметри знаходяться на сторінці модуля: Modules > Module Manager > VibeFox PostNord > Configure. Кожен розділ має власну кнопку Save, яка зберігає всю сторінку. Кожне збереження також очищає кеш списків пунктів видачі.

Над налаштуваннями сторінка попереджає, якщо ще немає API-ключа, ще немає ціни, видалено перевізника PostNord або модуль не знає одиницю ваги магазину. Тоді ваги товарів вважаються в кілограмах. Використовуйте kg, g, lb або oz у розділі International > Localization (Local units).

Загальні

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

Name: назва перевізника з пунктом видачі під час оформлення замовлення, наприклад «PostNord MyPack Collect». За замовчуванням: PostNord. Обов’язкове поле.

Home delivery: пропонувати також доставку додому від PostNord. Це другий перевізник, без пункту видачі. За замовчуванням вимкнено.

Home delivery name: назва перевізника доставки додому під час оформлення замовлення, наприклад «PostNord MyPack Home». За замовчуванням: PostNord Home delivery. Обов’язкове поле.

Tax status: None означає, що ціни нижче остаточні. Taxable: з наступним податковим правилом означає, що PrestaShop додає до цін податок на доставку за цим правилом. Застосовується до обох перевізників.

API PostNord (вибір пункту видачі)

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

Remove the saved API key: позначте прапорець і натисніть Save, щоб видалити збережений ключ.

Test mode: використовує тестове середовище PostNord (atapi2.postnord.com). Лише для ключів, виданих для тестового середовища.

Agreement country: країна вашого клієнтського договору з PostNord: Швеція, Данія, Норвегія або Фінляндія. Вона визначає, які пункти видачі пропонуються. Same as the delivery country (за замовчуванням) використовує країну клієнта.

Ціни

У заголовку розділу показано основну валюту вашого магазину. Ціни вказані в цій валюті, без податку, і однакові для обох перевізників. У PostNord немає публічного API цін, тож ціни встановлюєте ви, зазвичай за тарифами вашого договору з PostNord. Порядок застосування такий: поріг безкоштовної доставки, потім таблиця за країнами і, нарешті, запасна вартість.

Calculation type: Per order стягує ціну один раз. Per item (price x number of items) множить її на кількість товарів у кошику.

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

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

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

Доступність

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

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

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

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

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

Суми та ваги приймаються з комою або крапкою. Значення, яке не є числом 0 або більше, не зберігається, і з’являється повідомлення.

Додатково

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

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

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

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

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

Для перевізника з пунктом видачі та адреси доставки в Швеції, Данії, Норвегії або Фінляндії ваш сервер запитує в PostNord Business Location API 10 найближчих до поштового індексу доставки пунктів видачі. Він передає країну та поштовий індекс доставки, а також країну договору. Тайм-аут API становить 10 секунд. Списки кешуються на 6 годин для кожного поштового індексу, відповіді «пунктів немає» — на 1 годину. Помилки API кешуються на 5 хвилин, щоб збій PostNord не сповільнював кожне оновлення кроку доставки. Крок доставки ніколи не чекає на PostNord: якщо списку ще немає в кеші, його завантажують після того, як клієнт обрав перевізника.

Для інших напрямків перевізники все одно можуть пропонуватися з вашими цінами, але без вибору пункту. Перевізник доставки додому ніколи не показує вибір пункту.

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

Модуль не запитує актуальні ціни PostNord і не створює етикетки для відправлення, не бронює відправлення (EDI), не надає трек-номери та не надсилає листи з відстеженням. Режиму перегляду на карті немає. Для відправлень використовуйте PostNord Portal, Skicka Direkt Business або інструмент для друку етикеток: їм потрібен збережений ID пункту видачі.

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

Коли покупець обирає перевізника з пунктом видачі, під ним з’являється список PostNord service point з найближчими пунктами, згрупований за містами з відстанню. Доки поштовий індекс не введено, покупець бачить повідомлення «Введіть поштовий індекс, щоб обрати пункт видачі PostNord.» Вибір зберігається разом із кошиком і не скидається під час оновлення кроку доставки.

Коли список завантажено, пункт треба обрати. Без вибору кнопка Continue не працює, і з’являється повідомлення «Будь ласка, оберіть пункт видачі PostNord.» Обраний пункт перевіряється на сервері за списком PostNord для адреси доставки. Пункт, обраний для іншого поштового індексу, не використовується.

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

Сторінка замовлення в адмін-панелі: блок PostNord service point з назвою, адресою та Service point ID. Якщо пункт не обрано, там написано «не вибрано — PostNord доставить до пункту видачі, найближчого до адреси доставки».

Підтвердження замовлення та дані замовлення клієнта: PostNord service point: з назвою та адресою.

Листи про замовлення: лист із підтвердженням замовлення клієнту та сповіщення про нове замовлення магазину показують назву пункту, адресу та ID поруч із назвою перевізника. Сповіщення магазину також містить «not selected», якщо пункт не обрано.

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

Модуль працює з ліцензійним ключем VibeFox із vibefox.net. Блок ліцензії License — VibeFox PostNord є першим блоком на сторінці Modules > Module Manager > VibeFox PostNord > Configure, над налаштуваннями. Вставте ключ у поле License key і натисніть Activate. Після цього блок показує ключ замаскованим, статус (наприклад, дату, до якої ліцензія активна, і ваш домен) та кнопки Check now, щоб перевірити статус знову, Change key, щоб ввести інший ключ, і Remove key, щоб видалити ключ із цього магазину. Нижче розташовані рядок Product: presta-shipping-postnord і посилання 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.

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

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

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

PostNord не з’являється під час оформлення замовлення: перевірте, чи активна ліцензія і чи увімкнено Enable/Disable (або Home delivery). У розділі Shipping > Carriers перевірте, чи перевізник охоплює зону країни клієнта та його групу, або увімкніть Ignore shipping zones. Перевірте, чи задано ціну для країни (рядок країни, рядок * або Fallback cost), ліміти ваги та Minimum subtotal. Товари також можуть бути обмежені певними перевізниками на сторінці товару.

Вибір пункту повідомляє, що пункти видачі не можна завантажити: перевірте API key і налаштування Test mode. Продуктивний ключ не працює з тестовим середовищем, і навпаки. Увімкніть Debug log, перезавантажте оформлення замовлення і перегляньте поле Log на сторінці модуля. Замовлення все одно можна оформити; тоді PostNord доставить до найближчого пункту видачі.

Неочікувані пункти видачі: перевірте Agreement country. Саме воно визначає, які пункти видачі пропонуються.

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

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

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

Видалення

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

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