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.

  1. PHP: 7.1 - 8.4 (z wykluczeniem 8.0)
  2. ionCube: tak

Instalacja

Moduł możesz znaleźć na liście jako

  1. Nazwa: Pobieranie danych firmy na podstawie NIPu przez GUS API
  2. Autor: x13.pl
  3. Kategoria: Funkcjonalność sklepu
  4. 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.

Cookies

Informacje dotyczące plików cookies

Ta witryna korzysta z własnych plików cookie, aby zapewnić Ci najwyższy poziom doświadczenia na naszej stronie . Wykorzystujemy również pliki cookie stron trzecich w celu ulepszenia naszych usług, analizy a nastepnie wyświetlania reklam związanych z Twoimi preferencjami na podstawie analizy Twoich zachowań podczas nawigacji.

Zarządzanie plikami cookies

O Cookies

Pliki cookie to niewielkie pliki tekstowe, które są zapisywane na komputerze lub urządzeniu mobilnym przez strony internetowe, które odwiedzasz. Służą do różnych celów, takich jak zapamiętywanie informacji o logowaniu użytkownika, śledzenie zachowania użytkownika w celach reklamowych i personalizacji doświadczenia przeglądania użytkownika. Istnieją dwa rodzaje plików cookie: sesyjne i trwałe. Te pierwsze są usuwane po zakończeniu sesji przeglądarki, podczas gdy te drugie pozostają na urządzeniu przez określony czas lub do momentu ich ręcznego usunięcia.