Główne funkcje i zalety
- Automatyczne wstrzykiwanie formularza — moduł sam dodaje formularz wyszukiwania po VAT/NIP nad formularzami adresowymi na froncie sklepu i w panelu admin. Zero edycji plików motywu.
- Obsługa polskich numerów NIP — integracja z oficjalnym API GUS (REGON) umożliwia pobieranie pełnych danych firmowych z polskiego rejestru: nazwa firmy, adres, kod pocztowy, miasto.
- 5 providerów EU VAT do wyboru — VIES REST API (Komisja Europejska), VATcomply, VATLayer i viesapi.eu. Dwa z nich są całkowicie bezpłatne i nie wymagają rejestracji.
- Łańcuch providerów z automatycznym fallbackiem — skonfiguruj kolejność do 3 providerów. Jeśli Provider 1 nie odpowie lub zwróci błąd, moduł automatycznie odpyta Provider 2, a następnie Provider 3.
- Inteligentny cache odpowiedzi — wyniki wyszukiwania są przechowywane w pamięci podręcznej z konfigurowalnym czasem życia (TTL) per provider. Zmniejsza liczbę zapytań do API i przyspiesza powtórne wyszukiwania.
- Konfigurowalny timeout i retry — dla każdego providera osobno ustawisz maksymalny czas oczekiwania (1–60 sekund) oraz opcję automatycznego ponawiania żądania przy błędach serwera.
- Pulpit z telemetrią providerów — wbudowany dashboard pokazuje w czasie rzeczywistym: średni czas odpowiedzi API, procent sukcesu, liczbę zapytań zewnętrznych, trafienia w cache oraz status każdego providera.
- Przegląd cache — panel administracyjny wyświetla liczbę aktywnych i wygasłych wpisów, rozmiar cache oraz datę ostatniego zapisu — pełna kontrola nad pamięcią podręczną.
- Działa na checkout, rejestracji i w adminie — formularz pojawia się automatycznie na stronach: zamówienia (checkout), edycji adresu, rejestracji konta, a także przy dodawaniu/edycji adresów w panelu administracyjnym (AdminAddresses, AdminCarts).
- Obsługa dynamicznie ładowanych formularzy — dzięki wbudowanemu MutationObserver moduł wykrywa formularze adresowe pojawiające się dynamicznie (np. AJAX checkout, okna modalne) i automatycznie dodaje do nich formularz wyszukiwania.
- Wzajemne wykluczanie providerów — w konfiguracji łańcucha providerów nie można wybrać tego samego providera w dwóch slotach. Wybrany provider jest automatycznie blokowany w pozostałych polach select.
- Pełna kompatybilność — PrestaShop 1.7.0 – 9.x, PHP 7.0 – 8.5, MySQL 5.6+ / MariaDB 10.x+. Brak zależności od Composera, brak zewnętrznych bibliotek. Działa z każdym motywem.
- Wielojęzyczność — moduł jest w pełni przetłumaczony na język polski i angielski. Obsługuje system tłumaczeń PrestaShop (legacy l() oraz nowoczesny trans()).
- Szczegółowe instrukcje konfiguracji — wbudowany przewodnik z opisem każdego providera, instrukcjami uzyskania kluczy API oraz krokami szybkiego startu dostępny bezpośrednio w panelu modułu.
Link do demo modułu:
Demo panel administracyjny:
https://moduly-prestashop.eu/pobierz-dane-firmy-po-nip/admin-dev
Demo panel przedni:
https://moduly-prestashop.eu/pobierz-dane-firmy-po-nip