Moduł Kowal_Gus - Automatyczne Pobieranie Danych Firmy z GUS w Magento 2
- Kompatybilność
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
Opis / Moduł Kowal_Gus - Automatyczne Pobieranie Danych Firmy z GUS w Magento 2
MAGENTO 2 · B2B · DANE FIRMOWE · CHECKOUT
Wpisz NIP. Uzupełnij dane firmy z GUS.
Kowal Gus
Ułatw klientom firmowym składanie zamówień: pobierz nazwę firmy i adres z rejestru GUS zamiast wpisywać każdy element ręcznie. Korzystaj z tej samej funkcji przy tworzeniu zamówień w panelu Magento.
Nazwa i adres · Checkout i Magento Admin · Tryb testowy
JAK TO DZIAŁA W PRAKTYCE
01 · Konfigurujesz dostęp
Włączasz moduł i ustawiasz klucz użytkownika usługi GUS.
02 · Użytkownik wpisuje NIP
Zmiana pola uruchamia pobranie danych firmy.
03 · Formularz uzupełnia dane
Nazwa, ulica, kod pocztowy i miasto trafiają do pól adresu.
Co zyskuje Twój sklep?
Poznaj funkcje, zastosowanie i ustawienia modułu.
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ń
- Poprawne dane firmowe do dalszej obsługi i faktur; pobranie danych z rejestru wspiera ich dokładność, lecz samo nie potwierdza zgodności podatkowej.
Jak działa moduł?
Po wprowadzeniu numeru NIP w formularzu zamówienia, moduł wysyła zapytanie do API GUS i automatycznie uzupełnia pola formularza odpowiednimi danymi. Mechanizm działa zarówno na stronie checkout, jak i podczas ręcznego tworzenia zamówienia w panelu administracyjnym.
Instalacja i konfiguracja
Moduł można łatwo zainstalować w Magento 2 poprzez dodanie go do katalogu app/code/Kowal/Gus oraz włączenie go w konfiguracji systemowej. W panelu administratora znajduje się opcja aktywacji modułu oraz wprowadzenia klucza API do autoryzowanego dostępu do danych GUS.
Podsumowanie
Moduł Kowal_Gus to idealne rozwiązanie dla właścicieli sklepów Magento 2, którzy chcą usprawnić proces wprowadzania danych klientów firmowych. Dzięki automatyzacji znacząco skraca czas składania zamówień, poprawia ich dokładność i podnosi jakość obsługi klienta.
Dostęp do GUS i obsługa formularza
W Stores → Configuration → Kowal → nipfromgus → Ustawienia aktywujesz moduł, ustawiasz tryb testowy i klucz użytkownika GUS. Pakiet korzysta z biblioteki gusapi/gusapi. Potrzebuje dostępu do usługi GUS oraz widocznego pola NIP.
Skrypt usuwa z NIP znaki inne niż cyfry i wysyła zapytanie po zmianie pola, gdy numer ma 10 cyfr. Po odpowiedzi wypełnia nazwę firmy, ulicę z numerem budynku i lokalu, kod pocztowy oraz miasto. Kod zawiera układy checkout, Amasty Checkout i tworzenia zamówień w panelu; współdziałanie z konkretnym checkout i motywem należy sprawdzić przy wdrożeniu.
Poprawne dane do dalszej obsługi
Pobranie danych rejestrowych ogranicza ręczne wpisywanie i może zmniejszać liczbę literówek. Dane należy sprawdzić przed wykorzystaniem do zamówienia lub faktury. Moduł nie wykonuje osobnej weryfikacji podatkowej firmy.
Instalacja przez Composer
Pakiet kowal/module-gus, moduł Kowal_Gus. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.
Od konfiguracji do efektu
1. Konfigurujesz dostęp
Włączasz moduł i ustawiasz klucz użytkownika usługi GUS.
2. Użytkownik wpisuje NIP
Zmiana pola uruchamia pobranie danych firmy.
3. Formularz uzupełnia dane
Nazwa, ulica, kod pocztowy i miasto trafiają do pól adresu.
Mniej wpisywania przy zakupie firmowym
Klient podaje NIP w checkout. Po poprawnej odpowiedzi GUS moduł wypełnia nazwę firmy oraz adres. Klient sprawdza dane przed złożeniem zamówienia.
Administrator może skorzystać z pobrania danych także podczas ręcznego tworzenia zamówienia.
Uprość zamówienia dla klientów firmowych
Chcesz dopasować moduł do swojego sklepu? Zapytaj o wdrożenie Kowal Gus i omów konfigurację lub potrzebne rozszerzenia.
Więcej informacji
| Zgodność z szablonem | Luma / Blank, KOWAL |
|---|
Instrukcja Instalacji modułu
Instalacja i wdrożenie
Aby zainstalować moduł, wystarczy:
- Zainstaluj moduł: - Dodaj repozytorium composer do konfiguracji, uruchamiając
Dane dostępowe do repozytorium Composer (adres e-mail klienta i token licencyjny) otrzymasz e-mailem po zakupie. Są również dostępne w panelu klienta po zalogowaniu na kowal.store. Zastąp
TWOJ_EMAIL_KLIENTAadresem e-mail swojego konta, aTWOJ_TOKENotrzymanym tokenem. Polecenia wykonaj w katalogu głównym Magento.composer config repositories.kowal composer https://repo.kowal.store
Dodaj token dostępu do prywatnego repozytoriumcomposer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
Zainstaluj moduł composer uruchamiająccomposer require kowal/module-gus
Włącz moduł uruchamiającphp 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