Dokumentacja - Pobieranie danych firmy na podstawie NIPu z GUS

1.7.X 
1.2.0 / 2022-05-12
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 - 7.4
  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 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"}
   <pdiv class="js-address-form">
i dodajemy w pierwszej linii pod
{widget name='x13gusdata'}
czyli finalnie uzyskujemy:
{block name="address_form_url"}
   <pdiv 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.