Основні функції та переваги
- Автоматичне вставлення форми — модуль сам додає форму пошуку за VAT/NIP над адресними формами на фронтенді магазину та в панелі адміністратора. Жодного редагування файлів теми.
- Підтримка польських номерів NIP — інтеграція з офіційним API GUS (REGON) дає змогу отримувати повні дані компанії з польського реєстру: назва компанії, адреса, поштовий індекс, місто.
- 5 провайдерів EU VAT на вибір — VIES REST API (Європейська Комісія), VATcomply, VATLayer і viesapi.eu. Два з них є повністю безкоштовними та не потребують реєстрації.
- Ланцюжок провайдерів з автоматичним fallback — налаштуйте послідовність до 3 провайдерів. Якщо Provider 1 не відповість або поверне помилку, модуль автоматично звернеться до Provider 2, а потім до Provider 3.
- Інтелектуальний кеш відповідей — результати пошуку зберігаються в кеші з налаштовуваним часом життя (TTL) для кожного провайдера. Це зменшує кількість запитів до API та прискорює повторні пошуки.
- Налаштовуваний timeout і retry — для кожного провайдера окремо можна встановити максимальний час очікування (1–60 секунд), а також опцію автоматичного повторення запиту у разі помилок сервера.
- Панель з телеметрією провайдерів — вбудований dashboard у реальному часі показує: середній час відповіді API, відсоток успішних запитів, кількість зовнішніх запитів, влучання в кеш і статус кожного провайдера.
- Огляд кешу — панель адміністратора відображає кількість активних і прострочених записів, розмір кешу та дату останнього запису — повний контроль над кешем.
- Працює на checkout, реєстрації та в адмінці — форма автоматично з’являється на сторінках: оформлення замовлення (checkout), редагування адреси, реєстрації облікового запису, а також під час додавання/редагування адрес у панелі адміністратора (AdminAddresses, AdminCarts).
- Підтримка динамічно завантажуваних форм — завдяки вбудованому MutationObserver модуль виявляє адресні форми, що з’являються динамічно (наприклад, AJAX checkout, модальні вікна), і автоматично додає до них форму пошуку.
- Взаємне виключення провайдерів — у конфігурації ланцюжка провайдерів не можна вибрати того самого провайдера у двох слотах. Вибраний провайдер автоматично блокується в інших полях select.
- Повна сумісність — PrestaShop 1.7.0 – 9.x, PHP 7.0 – 8.5, MySQL 5.6+ / MariaDB 10.x+. Відсутність залежностей від Composer, відсутність зовнішніх бібліотек. Працює з будь-якою темою.
- Багатомовність — модуль повністю перекладений польською та англійською мовами. Підтримує систему перекладів PrestaShop (legacy l() та сучасний trans()).
- Детальні інструкції з налаштування — вбудований посібник з описом кожного провайдера, інструкціями щодо отримання API-ключів і кроками швидкого старту доступний безпосередньо в панелі модуля.
Посилання на демо модуля:
Демо панель адміністратора:
https://moduly-prestashop.eu/pobierz-dane-firmy-po-nip/admin-dev
Демо фронтенд:
https://moduly-prestashop.eu/pobierz-dane-firmy-po-nip