VibeFox DPD Pickup for PrestaShop — Допомога

Вимоги

PrestaShop: від 8.0 до 9.x.

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

Облікові дані DPD Baltic (Литва, Латвія, Естонія): список пунктів видачі береться з веб-сервісу DPD Baltic. Потрібні ім'я користувача та пароль API, які DPD видає своїм бізнес-клієнтам. Уточніть їх у свого менеджера DPD або в службі підтримки DPD вашої країни. Один обліковий запис показує пункти видачі Литви, Латвії та Естонії.

DPD Словаччина: публічний пошук parcelshop DPD Словаччини не потребує облікових даних.

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

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

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

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

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

4. Оберіть свій API DPD. Для DPD Литви, Латвії або Естонії введіть ім'я користувача та пароль API. Перевірте ціни за країнами та натисніть Save. Потім натисніть Refresh pickup points, щоб перевірити з'єднання (див. Налаштування).

Під час встановлення модуль створює перевізника DPD Pickup Point з текстом терміну доставки DPD Pickup point or locker. Перевізника призначено до зон Словаччини, Литви, Латвії та Естонії та до всіх груп клієнтів, без податкового правила. Зони, групи клієнтів, текст терміну доставки, логотип і обмеження розмірів можна змінити в Shipping > Carriers. Ціни там не встановлюйте: ціна завжди береться з модуля.

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

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

Попередження у верхній частині сторінки повідомляють, коли порожнє ім'я користувача або пароль DPD Baltic, коли не задано жодної ціни (в обох випадках перевізник не показується під час оформлення замовлення), коли перевізника видалено, а також коли модуль не знає одиницю ваги магазину (International > Localization, Local units), тож ваги товарів читаються як кг. Значення, яке не є числом, або від'ємне число в полі суми чи ваги не зберігається: поле очищується, і попередження його називає. Рядки Country prices, які не відповідають формату CC:ЦІНА, перелічуються в попередженні та ігноруються.

Загальні

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

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

Tax status: податкове правило перевізника, що застосовується до ціни доставки. None означає відсутність податку. Інші варіанти показують Taxable з назвою податкового правила вашого магазину.

Список пунктів видачі DPD

Пункти видачі завантажуються з DPD і кешуються на 24 години.

DPD API: компанія DPD, з якою у вас обліковий запис. Балтійські облікові записи використовують веб-сервіс своєї країни.

API username (Baltic): ваше ім'я користувача веб-сервісу DPD Baltic. Для DPD Словаччина не потрібне. Якщо його очистити, збережений пароль також видаляється.

API password (Baltic): ваш пароль веб-сервісу DPD Baltic. Для DPD Словаччина не потрібен. Після збереження поле залишається порожнім і показує Saved - leave empty to keep it. Вводьте нове значення, лише якщо хочете його змінити.

Pickup points: кнопка Refresh pickup points очищає кеш і одразу завантажує пункти видачі з DPD: Литва, Латвія та Естонія для Baltic API та тестовий пошук у Братиславі для DPD Словаччини. Вона показує кількість пунктів видачі або помилку для кожної країни. Спочатку збережіть налаштування.

Ціни

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

Country prices: один рядок на країну: CC:ціна, наприклад EE:3.50. Приймається десятковий кома. За замовчуванням: SK:3.50, LT:4.00, LV:4.00, EE:4.00.

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

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

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

Доступність

Перевізника також приховано, якщо DPD не повертає пунктів видачі для адреси покупця або якщо API DPD недоступне, адже замовлення не можна доставити без пункту видачі.

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

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

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

Ignore shipping zones: коли увімкнено, перевізника пов'язано з усіма зонами та пропонують для країн, зазначених нижче. Зона, яку ви створите пізніше, пов'язується одразу. Коли вимкнено, перевізника пропонують лише в його зонах із Shipping > Carriers. Після вимкнення перевізник повертається до зон, які мав раніше.

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

Вибір пункту видачі

City order: спочатку показувати великі міста (Таллінн, Рига, Вільнюс, Братислава та інші). Увімкнено за замовчуванням.

City list width: ширина списку міст у CSS, наприклад 100% або 300px. За замовчуванням: 100%.

Pickup point list width: ширина списку пунктів видачі у CSS, наприклад 100% або 400px. За замовчуванням: 100%.

Додатково

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

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

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

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

На етапі доставки PrestaShop запитує в модуля ціну DPD Pickup. Враховуються лише фізичні товари: віртуальні товари не додають ваги і не входять до суми замовлення. Модуль перевіряє країни (з Ignore shipping zones), вагу кошика та мінімальну суму, бере ціну для країни (або запасну вартість) і застосовує безкоштовну доставку, якщо сума замовлення достатня. Потім він завантажує пункти видачі DPD для адреси. Якщо DPD не повертає жодного, не відповідає або бракує облікових даних Baltic, перевізника приховують. Ціна обчислюється в базовій валюті магазину, а потім показується у валюті кошика покупця.

Список пунктів видачі кешується на 24 години, порожній список — на 1 годину. Невдалий запит пам'ятається 5 хвилин, тож збій DPD ніколи не сповільнює оформлення замовлення. Тайм-аут API — 15 секунд.

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

Модуль не запитує ціни DPD, не створює відправлення DPD, не друкує етикетки, не створює маніфести, не замовляє кур'єрський забір, не відстежує посилки й не показує карту. Підтримуються лише веб-сервіс DPD Baltic та пошук parcelshop DPD Словаччини.

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

Коли покупець обирає DPD Pickup, під перевізником з'являються список міст і список пунктів видачі. Місто з адреси покупця вибирається автоматично. Вибір зберігається в кошику одразу, щойно покупець його зробив. Для DPD Словаччини покупець бачить Enter your city and postcode to see the DPD pickup points nearby., доки адресу не заповнено, а потім найближчі пункти. Якщо DPD не має пунктів для адреси, покупець бачить No DPD pickup points are available for this address right now. Please check the address or choose another shipping method.

Пункт видачі обов'язковий. Без нього покупець не може продовжити й бачить Please select a DPD pickup point. Сервер перевіряє, що пункт належить до списку DPD для адреси покупця. Підроблений або застарілий вибір відхиляється з повідомленням The selected DPD pickup point is not available for this address. Please choose another one.

Обраний пункт зберігається в замовленні. Він показується на сторінці підтвердження замовлення та в деталях замовлення покупця як DPD pickup point:. У листі з підтвердженням замовлення його додають після назви перевізника. Новий лист про замовлення для магазину (ps_emailalerts) також показує ID пункту. Назва, що зберігається в замовленні, береться з DPD, а не з браузера.

На сторінці замовлення в панелі адміністратора блок DPD pickup point показує назву пункту, його ID та країну. Натисніть Edit, оберіть місто та інший пункт, потім натисніть Save. Пункт перевіряється за списком DPD для адреси замовлення, і сторінка показує Pickup point updated. або Pickup point not found for the order address. Для зміни пункту потрібен дозвіл на редагування замовлень, а не доступ до сторінок Modules. Кожна зміна записується в Advanced Parameters > Logs замовлення: старий пункт, новий пункт і співробітник. Щоб змінити пункт у DPD Словаччини, замовлення повинно мати місто й поштовий індекс доставки.

Якщо кошик розділено на кілька замовлень, пункт видачі залишається за першим замовленням. Інші замовлення показують No pickup point was selected for this order., у журналі налагодження для кожного з них є помилка, а Edit там показує The pickup point of this cart belongs to another order of the same cart. Nothing was changed. Пункт такого замовлення потрібно передати в DPD вручну.

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

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

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

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

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

DPD Pickup не з'являється під час оформлення замовлення: перевірте, що ліцензія активна і Enable/Disable увімкнено. У Shipping > Carriers перевірте, що перевізник охоплює зону країни покупця та групу клієнтів (або що Ignore shipping zones увімкнено і країну дозволено). Перегляньте попередження у верхній частині сторінки модуля та натисніть Refresh pickup points. Перевірте обмеження ваги та суми замовлення і те, що для країни є ціна (або запасна вартість). Товари також можуть бути обмежені певними перевізниками на сторінці товару.

Помилка після Refresh pickup points: результат показує помилку DPD для кожної країни. Наприклад, «Login failed» означає, що DPD відхилив облікові дані Baltic, тож жодного пункту видачі завантажити не можна. Перевірте ім'я користувача та пароль API у DPD.

DPD Словаччина не показує пункти: пункти з'являються, коли покупець ввів місто та поштовий індекс. DPD показує лише пункти в радіусі 50 км від цієї адреси. Розробники можуть змінити радіус за допомогою хука модуля actionVfdDpdSkSearchRadius.

Пошук причини: увімкніть Debug log, перезавантажте оформлення замовлення та перегляньте поле Log на сторінці модуля. Там записується кожне рішення. Помилки API завжди записуються. Імена користувачів і паролі API ніколи не записуються в журнал.

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

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

Видалення

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

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