Dokumentacja - Pobieranie danych firmy na podstawie NIPu z GUS
Pobieranie danych firmy na podstawie NIPu z GUS/REGON dla PrestaShop
Wersja PrestaShop:
1.7
8
9
To wersja, z którą dodatek został przetestowany i działa poprawnie
Aktualna wersja:
1.4.1 -
19/08/2025
zobacz changelog - listę zmian
Przed instalacją i konfiguracją modułu zapraszamy do zapoznania się z instrukcją.
Wymagania instalacyjne
Moduł wymaga kilku podstawowych usług na serwerze, które w większości przypadków są aktywne.
Gdyby któraś z wymienionych opcji nie była dostępna - należy ją włączyć w panelu serwera lub napisać do administratora.
- PHP: 7.1 - 8.4 (z wykluczeniem 8.0)
- ionCube: tak
Instalacja
Moduł możesz znaleźć na liście jako
- Nazwa: Pobieranie danych firmy na podstawie NIPu przez GUS API
- Autor: x13.pl
- Kategoria: Funkcjonalność sklepu
- Filtruj po: Zainstalowane i niezainstalowane / Aktywne i nieaktywne
W module mamy wbudowane 2 style:
- jeśli wybierzemy wyświetlanie przycisku w polu pobierania danych w polu NIPu zostanie on wyświetlony automatycznie (bez dodatkowych modyfikacji)
- Jeśli chcemy zdecydować się na wyświetlenie pola do pobierania danych przed formularzem danych, musimy edytować 2 pliki szablonu
Zmiana w plikach szablonu
Łączymy się przez FTP z naszym sklepem, i wchodzimy w odpowiednie folderu, oraz edytujemy pliki:
Dla PrestaShop 8.0.X oraz 1.7.X
Wybieramy folder themes/nazwa-szablonu/templates/checkout/_partials/address-form.tpl - edytujemy plik
odszukujemy w nim:{block name="address_form_url"}
i dodajemy w pierwszej linii pod
{widget name='x13gusdata'}
czyli finalnie uzyskujemy:
{block name="address_form_url"}
{widget name='x13gusdata'}
Następnie edytujemy plik themes/nazwa-szablonu/templates/customer/_partials/address-form.tpl - edytujemy plik
odszukujemy w nim:{block name="address_form_url"}
<div class="js-address-form">
i dodajemy w pierwszej linii pod
{widget name='x13gusdata'}
czyli finalnie uzyskujemy:
{block name="address_form_url"}
<div class="js-address-form">
{widget name='x13gusdata'}
Sprawdzenie kompilacji
Sprawdzamy, czy mamy ustawione wymuszanie zmian w szablonie lub czyścimy cache.
Wchodzimy w Parametry zaawansowane -> Wydajność
Klikamy po prawej Wyczyść pamięć podręczną.
Konfiguracja
W module domyślnie uzupełniliśmy klucz API w klucz wygenerowany typowo dla X13.pl.
Jeśli chcesz możesz w module skonfigurować swój klucz, aby uzyskać klucz musisz skontaktować się z GUSem, dokłada instrukcja dostępna jest tutaj.
Po otrzymaniu klucza, przechodzimy do konfiguracji modułu, wpisujemy go w polu Klucz API GUS, automatycznie po zapisaniu klucza wszystkie odpytania o dane będą realizowane na dedykowanym Twoim kluczu.