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

Вимоги

OpenCart: 3.0.x (перевірено на 3.0.5.0) або 4.0.2 та новіші (перевірено на 4.1.0.3).

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

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

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

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

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

Завантаження — це один zip-файл із пакетами для обох версій OpenCart. Розпакуйте його на своєму комп'ютері. Він містить README.txt, пакет для OpenCart 3 vfd_postnord-oc3-(version).ocmod.zip і пакет для OpenCart 4 vfd_postnord.ocmod.zip. Встановлюйте лише пакет для вашої версії OpenCart. Ліцензійний ключ однаковий для обох версій.

OpenCart 3

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_postnord-oc3-(version).ocmod.zip. Розширення не додає модифікацій OCMOD, тож оновлювати Extensions > Modifications не потрібно. Замість Installer ви можете скопіювати вміст папки upload з пакета в кореневу папку вашого магазину.

2. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox PostNord і натисніть Install (зелена кнопка +).

3. Натисніть Edit (кнопка з олівцем), щоб відкрити сторінку налаштувань.

4. Введіть ваш ліцензійний ключ VibeFox у поле License key у блоці ліцензії вгорі сторінки Edit і натисніть Activate (див. розділ Ліцензійний ключ).

5. Увімкніть Enable/Disable (доставка до пункту обслуговування) та/або Home delivery, вставте API key PostNord, оберіть Agreement country, заповніть Country prices або Fallback cost (див. розділ Налаштування) і натисніть Save.

OpenCart 4

1. В адмінпанелі перейдіть до Extensions > Installer, натисніть Upload і виберіть файл vfd_postnord.ocmod.zip. Не перейменовуйте файл: OpenCart 4 бере код розширення з назви файлу, і перейменований пакет не працює.

2. Пакет з'являється у списку встановлених розширень на тій самій сторінці. Натисніть Install (зелена кнопка +) поруч із ним.

3. Перейдіть до Extensions > Extensions і виберіть тип розширень Shipping. Знайдіть VibeFox PostNord, натисніть Install (зелена кнопка +), а потім Edit (кнопка з олівцем).

4. Введіть ліцензійний ключ і налаштування так само, як у кроках 4 і 5 для OpenCart 3. Сторінка налаштувань і її поля однакові в обох версіях.

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

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

Усі налаштування розташовані на сторінці розширення: Extensions > Extensions > Shipping > VibeFox PostNord > Edit. Розділи перелічено ліворуч. Одна кнопка Save внизу зберігає всю сторінку без перезавантаження. Кожне збереження також очищає кеш списків пунктів обслуговування. Зберігати налаштування можуть лише адміністратори з правом змінювати це розширення.

Якщо значення неправильне, нічого не зберігається, і сторінка показує причину: порожню назву, назву довшу за 64 символи або з символами < > ; = # { }, порядок сортування, який не є цілим числом, неправильний податковий статус або геозону, або Min weight (kg), більше за Max weight (kg). Числове поле зі значенням, яке не є числом 0 або більше, зберігається порожнім, з повідомленням. Комірка таблиці цін, яка не є числом 0 або більше, зберігається як 0, з повідомленням.

Над налаштуваннями сторінка попереджає, якщо ще немає API-ключа, ще не встановлено жодної ціни та в магазині немає вагової категорії «kg».

Загальні

Обидва варіанти доставки пропонуються в геозоні, встановленій у Availability, або для країн з Ignore shipping zones.

Enable/Disable: вмикає або вимикає доставку PostNord до пункту обслуговування чи поштомата. Покупець обирає пункт під час оформлення замовлення. За замовчуванням: вимкнено.

Name: назва варіанта пункту обслуговування під час оформлення замовлення, наприклад «PostNord MyPack Collect». За замовчуванням: PostNord. Обов'язкове поле, до 64 символів, без символів < > ; = # { }.

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

Home delivery name: назва варіанта домашньої доставки під час оформлення замовлення, наприклад «PostNord MyPack Home». За замовчуванням: PostNord Home delivery. Ті самі правила, що й для Name.

Sort order: позиція PostNord серед способів доставки під час оформлення замовлення. Ціле число.

Tax status: None (the prices are final) (за замовчуванням) або податковий клас: тоді OpenCart додає до цін податок на доставку цього класу. Стосується обох варіантів.

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 кг, S до 2 кг, M до 3 кг, L до 5 кг і XL понад 5 кг. Колонка ваги зі значенням 0 використовує колонку Price, а Price зі значенням 0 означає безкоштовну доставку. Країна * All other countries охоплює всі країни, які не мають власного рядка. Десяткові числа з комою або крапкою (9,99 або 9.99). Новий рядок створюється як * All other countries з усіма цінами 0. Оберіть країну та введіть ціни перед збереженням або видаліть рядок. Порожня комірка зберігається як 0.

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

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

Доступність

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

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

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

Geo zone: пропонує PostNord лише для адрес у цій геозоні. All zones (за замовчуванням) означає без обмеження. Геозони керуються в System > Localisation > Geo Zones. Не використовується, поки ввімкнено Ignore shipping zones.

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

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

Додатково

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

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

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

Імпорт / Експорт

Export: натисніть Download JSON, щоб зберегти налаштування у файл JSON. API-ключ не експортується.

Import: вставте раніше експортований JSON і натисніть Import, щоб відновити налаштування, наприклад в іншому магазині. Значення перевіряються так само, як під час звичайного збереження. Збережений API-ключ зберігається.

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

Коли OpenCart показує способи доставки, він запитує в розширення ціну кожного варіанта PostNord. Враховуються лише товари, для яких Requires Shipping встановлено на Yes: інші товари не додають ваги й не входять до проміжної суми. Розширення перевіряє геозону або список країн, вагу кошика та мінімальну проміжну суму. Якщо діє безкоштовна доставка, ціна дорівнює 0. Інакше ціна береться з таблиці за країнами, а потім із резервної вартості. Якщо ціни немає, варіант приховується. Ціна розраховується у валюті магазину за замовчуванням і показується покупцеві у його валюті з податком, вибраним у Tax status. Розрахунок ціни ніколи не звертається до PostNord.

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

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

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

На OpenCart 4 покупець натискає Choose у блоці способу доставки на сторінці оформлення і вибирає опцію PostNord у вікні Shipping method options. Ціни такі самі, як в OpenCart 3.

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

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

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

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

Сторінки замовлень, листи та рахунок: пункт додається до способу доставки замовлення, наприклад «PostNord: назва, адреса (ID 12345)» (спочатку назва варіанта, потім пункт). Якщо текст довший за 128 символів, адреса пропускається (в OpenCart 4 такого обмеження немає, і адреса завжди зберігається). Він відображається скрізь, де OpenCart показує спосіб доставки: в історії замовлень покупця, в листах про замовлення, у рахунку та в Sales > Orders. Замовлення без пункту зберігає просту назву способу доставки.

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

На OpenCart 4 список пунктів обслуговування з'являється у вікні Shipping method options, під варіантом пункту обслуговування, і завантажується знову щоразу, коли відкривається вікно, бо адреса може змінитися під час оформлення в один крок. Кнопка Continue вікна не переходить далі без пункту зі списку, з тим самим повідомленням. Якщо покупець натискає її, поки список ще завантажується, вікно чекає списку без повідомлення і потім саме знову натискає Continue. Недоступний список також не блокує замовлення. OpenCart 4 зберігає одне замовлення для оформлення і оновлює його щоразу, коли покупець підтверджує знову, і пункт обслуговування замовлення оновлюється разом із ним.

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

Розширення працює з ліцензійним ключем VibeFox з vibefox.net. Блок ліцензії License — VibeFox PostNord є першим блоком на сторінці Extensions > Extensions > Shipping > VibeFox PostNord > Edit, над налаштуваннями. Введіть ключ у поле License key і натисніть Activate. Після цього блок показує ключ приховано, статус (наприклад, дату, до якої дійсна ліцензія, і ваш домен), а також кнопки Check now для повторної перевірки статусу, Change key для введення іншого ключа та Remove key для видалення ключа з цього магазину. Нижче розташовано рядок Product: opencart-shipping-postnord і посилання Manage licenses and domains in your account, яке відкриває ваш обліковий запис vibefox.net. Змінювати ключ можуть лише адміністратори з правом Modify для розширення. Тексти блоку відповідають мові адмінпанелі (включено англійську та російську).

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

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

Без активного ключа варіанти доставки PostNord не показуються покупцям під час оформлення замовлення, і ціна доставки не розраховується. Адміністратор, який увійшов в адмін-панель у тому самому браузері, усе ще бачить варіанти в магазині, позначені як (unlicensed — visible to admins only), тож ви можете налаштувати та протестувати розширення до купівлі ключа. На OpenCart 4 такого попереднього перегляду немає: магазин не бачить вхід адміністратора, тому без активного ключа варіанти приховано для всіх. Після того як ви один раз відкрили сторінку Edit, на адмін-панелі Dashboard з'являється нагадування. Закрийте його кнопкою ×, щоб приховати на 7 днів. Наявні замовлення не змінюються.

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

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

PostNord не з'являється під час оформлення замовлення: перевірте, чи ліцензія активна та чи ввімкнено Enable/Disable (або Home delivery). Перевірте Geo zone або список Countries, якщо ввімкнено Ignore shipping zones. Перевірте, чи встановлено ціну для країни (рядок країни, рядок * або Fallback cost), обмеження ваги та Minimum subtotal. Перевірте, чи в товарів Requires Shipping встановлено на Yes.

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

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

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

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

Ваги товарів виглядають неправильно: якщо сторінка розширення попереджає, що в магазині немає вагової категорії «kg», перевірте System > Localisation > Weight Classes. Ваги товарів перераховуються за назвою одиниці їхньої категорії, невідомі одиниці читаються як кг.

Сторінка показує «Warning: You do not have permission to modify VibeFox PostNord!»: ваша група адміністраторів може лише переглядати налаштування. Надайте групі право змінювати extension/shipping/vfd_postnord (OpenCart 3) або extension/vfd_postnord/shipping/vfd_postnord (OpenCart 4) у System > Users > User Groups.

Для розробників: адресу API PostNord можна замінити налаштуванням vfd_ptnd_api_url (для тестів); для нього немає поля на сторінці налаштувань.

Видалення

Перейдіть до Extensions > Extensions, виберіть тип Shipping і натисніть Uninstall (червона кнопка −) поруч із VibeFox PostNord. Ліцензійний ключ і статус ліцензії цього розширення завжди видаляються. OpenCart завжди скидає статус розширення, Sort order, Tax status і Geo zone. Кешовані списки пунктів обслуговування завжди видаляються. Якщо ввімкнено Remove data on uninstall, також видаляються налаштування PostNord, журнал налагодження та пункти обслуговування оформлень, які так і не стали замовленням. Якщо вимкнено, решта налаштувань зберігається і знову використовується під час повторного встановлення розширення. Наявні замовлення зберігають свій спосіб доставки, вартість і збережений пункт обслуговування.

На OpenCart 4, щоб також видалити файли розширення, після видалення перейдіть до Extensions > Installer, натисніть Uninstall (помаранчева кнопка −) поруч із VibeFox PostNord у списку встановлених розширень, а потім Delete (червона кнопка з кошиком), щоб видалити завантажений пакет.

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