Dokumentacja - Pobieranie danych firmy na podstawie NIPu z GUS

8.0.X  1.7.X 
1.2.1 / 2022-09-26
zobacz changelog

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.1
  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.