Moduł Kowal_Gus - Automatyczne Pobieranie Danych Firmy z GUS w Magento 2

Wprowadzenie

Moduł Kowal_Gus to innowacyjne rozwiązanie dla sklepów opartych na Magento 2, które automatycznie pobiera dane firmy na podstawie numeru NIP. Dzięki integracji z API Głównego Urzędu Statystycznego (GUS), użytkownicy mogą błyskawicznie wypełniać dane adresowe bez konieczności ręcznego wpisywania informacji.

Funkcjonalności modułu

Automatyczne pobieranie danych firmy na podstawie numeru NIP

Wypełnianie pól formularza: nazwa firmy, adres, kod pocztowy, miasto

Obsługa zarówno strony zamówienia (checkout) jak i panelu administracyjnego

Opcja włączenia/wyłączenia modułu w konfiguracji Magento

Bezproblemowa integracja z natywnymi formularzami Magento

Korzyści z wdrożenia modułu

Oszczędność czasu – eliminacja ręcznego wpisywania danych

Zwiększona dokładność – unikanie błędów literowych i niepoprawnych adresów

Lepsza obsługa klienta – szybszy i bardziej intuicyjny proces składania zamówień

Zgodność z wymogami podatkowymi – poprawne dane firmowe w fakturach

Instalacja i wdrożenie

Aby zainstalować moduł, wystarczy:

Zainstaluj moduł: - Dodaj repozytorium composer do konfiguracji, uruchamiając

composer config repositories.gus vcs https://github.com/kowalco/magento-2-gus

Dodaj token dostępu do prywatnego repozytorium

composer config --global --auth github-oauth.github.com <YOUR_TOKEN>

Zainstaluj moduł composer uruchamiając

composer require kowal/module-gus

Włącz moduł uruchamiając

php bin/magento module:enable Kowal_Gus

Uruchomić komendy:

    bin/magento setup:upgrade
    bin/magento setup:di:compile
    bin/magento cache:flush
    bin/magento indexer:reindex sales_order_grid

Przejść do Kowal.co → GUS → Ustawienia i włącz moduł.

Przejdź na stronę https://api.stat.gov.pl/Home/RegonApi i postępuj zgodnie z instrukcja aby uzyskać klucz użytkownika API

Pytania i odpowiedzi

Pytanie

Czy moduł pozwala automatycznie wypełnić dane firmy na podstawie numeru NIP?

Odpowiedź

Tak — po wpisaniu numeru NIP w formularzu sklepu moduł pobiera dane firmy z API GUS i automatycznie uzupełnia pola: nazwa firmy, adres, kod pocztowy, miasto.

Pytanie

Czy moduł działa zarówno na stronie checkout, jak i w panelu administracyjnym?

Odpowiedź

Tak — moduł działa zarówno podczas składania zamówienia w sklepie (strona checkout) jak i przy ręcznym tworzeniu zamówienia w panelu administracyjnym Magento 2.

Pytanie

Czy mogę włączyć lub wyłączyć działanie modułu w konfiguracji Magento?

Odpowiedź

Tak — moduł posiada opcję włączenia lub wyłączenia w ustawieniach sklepu Magento.

Pytanie

Czy moduł wymaga nadpisywania plików rdzenia Magento lub motywu?

Odpowiedź

Nie — moduł integruje się z natywnymi formularzami Magento 2 i działa zgodnie z architekturą rozszerzeń, bez konieczności modyfikacji plików rdzenia.

Pytanie

Czy muszę uzyskać klucz API, aby moduł mógł korzystać z bazy GUS?

Odpowiedź

Tak — moduł korzysta z API GUS (poprzez portal stat.gov.pl lub odpowiedni interfejs) aby pobierać dane na podstawie NIP.

Pytanie

Czy moduł poprawia dokładność danych firmowych w zamówieniach i na fakturach?

Odpowiedź

Tak — dzięki automatycznemu pobieraniu danych z GUS zmniejsza się ryzyko literówek i błędów w danych firmy, co ułatwia wystawienie faktury lub poprawne dane księgowe.

Pytanie

Czy moduł działa w wersjach Magento 2‑2.3.x oraz 2.4.x?

Odpowiedź

Tak — w opisie produktu podano kompatybilność z Magento 2.3.4‑2.3.7 oraz 2.4.0‑2.4.7.

Pytanie

Czy wpływa na wydajność sklepu?

Odpowiedź

Wpływ jest minimalny — moduł wykonuje zapytanie po wpisaniu NIP i automatyczne uzupełnienie pól, więc obciążenie jest niewielkie. Zawsze jednak warto testować w środowisku przed produkcją.

Pytanie

Czy moduł może być wykorzystany w sklepie B2B, gdzie klienci to firmy?

Odpowiedź

Tak — jest to rozwiązanie szczególnie przydatne w sklepach B2B, gdzie klienci wpisują dane firmy, a sklepy chcą zapewnić poprawność danych i uprościć proces składania zamówienia.

Pytanie

Czy po zakupie otrzymuję dokumentację instalacji oraz wsparcie techniczne?

Odpowiedź

Tak — po zakupie modułu dostępna jest instrukcja instalacji oraz konfiguracji.