Beschreibung /
Kowal_Gus Modul - Automatischer Abruf von Unternehmensdaten aus GUS in Magento 2
MAGENTO 2 · B2B · UNTERNEHMENSDATEN · CHECKOUT
NIP eingeben. Unternehmensdaten aus GUS ergänzen.
Kowal Gus
Erleichtern Sie Firmenkunden die Bestellung: Rufen Sie den Firmennamen und die Adresse aus dem GUS-Register ab, statt jedes Element manuell einzugeben. Nutzen Sie dieselbe Funktion auch beim Erstellen von Bestellungen im Magento-Panel.
Name und Adresse · Checkout und Magento Admin · Testmodus
SO FUNKTIONIERT ES IN DER PRAXIS
01 · Sie konfigurieren den Zugriff Sie aktivieren das Modul und legen den Benutzerschlüssel für den GUS-Dienst fest.
02 · Der Nutzer gibt die NIP ein Die Änderung des Feldes startet den Abruf der Unternehmensdaten.
03 · Das Formular ergänzt die Daten Name, Straße, Postleitzahl und Ort werden in die Adressfelder übernommen.
Was gewinnt Ihr Shop?
Lernen Sie Funktionen, Einsatzmöglichkeiten und Einstellungen des Moduls kennen.
Einführung
Das Modul Kowal_Gus ist eine innovative Lösung für Shops auf Basis von Magento 2, die Unternehmensdaten automatisch anhand der NIP-Nummer abruft. Dank der Integration mit der API des polnischen Statistischen Zentralamts (GUS) können Nutzer Adressdaten blitzschnell ausfüllen, ohne Informationen manuell eingeben zu müssen.
Modulfunktionen
Automatischer Abruf von Unternehmensdaten anhand der NIP-Nummer
Ausfüllen der Formularfelder: Firmenname, Adresse, Postleitzahl, Ort
Unterstützung sowohl der Bestellseite (Checkout) als auch des Administrationspanels
Option zum Aktivieren und Deaktivieren des Moduls in der Magento-Konfiguration
Reibungslose Integration mit nativen Magento-Formularen
Vorteile der Modulimplementierung
Zeitersparnis – keine manuelle Dateneingabe mehr
Höhere Genauigkeit – Vermeidung von Tippfehlern und fehlerhaften Adressen
Besserer Kundenservice – ein schnellerer und intuitiverer Bestellprozess
Korrekte Unternehmensdaten für die weitere Bearbeitung und Rechnungen; der Datenabruf aus dem Register unterstützt deren Genauigkeit, bestätigt jedoch nicht die steuerliche Konformität.
Wie funktioniert das Modul?
Nach Eingabe der NIP-Nummer im Bestellformular sendet das Modul eine Anfrage an die GUS API und ergänzt die Formularfelder automatisch mit den entsprechenden Daten. Der Mechanismus funktioniert sowohl auf der Checkout-Seite als auch beim manuellen Erstellen einer Bestellung im Administrationspanel.
Installation und Konfiguration
Das Modul lässt sich einfach in Magento 2 installieren, indem es zum Verzeichnis app/code/Kowal/Gus hinzugefügt und in der Systemkonfiguration aktiviert wird. Im Admin-Panel gibt es eine Option zur Aktivierung des Moduls sowie zur Eingabe des API-Schlüssels für den autorisierten Zugriff auf GUS-Daten.
Zusammenfassung
Das Modul Kowal_Gus ist die ideale Lösung für Betreiber von Magento 2 Shops, die den Prozess der Eingabe von Daten für Firmenkunden optimieren möchten. Durch Automatisierung verkürzt es die Bestellzeit deutlich, verbessert die Genauigkeit und erhöht die Qualität des Kundenservice.
Zugriff auf GUS und Formularunterstützung
Unter Stores → Configuration → Kowal → nipfromgus → Einstellungen aktivieren Sie das Modul, legen den Testmodus und den GUS-Benutzerschlüssel fest. Das Paket nutzt die Bibliothek gusapi/gusapi. Es benötigt Zugriff auf den GUS-Dienst sowie ein sichtbares NIP-Feld.
Das Skript entfernt aus der NIP alle Zeichen außer Ziffern und sendet nach einer Feldänderung eine Anfrage, wenn die Nummer 10 Ziffern hat. Nach der Antwort füllt es Firmenname, Straße mit Gebäude- und Wohnungsnummer, Postleitzahl sowie Ort aus. Der Code enthält Layouts für Checkout, Amasty Checkout und die Erstellung von Bestellungen im Panel; die Zusammenarbeit mit einem konkreten Checkout und Theme sollte bei der Implementierung geprüft werden.
Korrekte Daten für die weitere Bearbeitung
Der Abruf von Registerdaten reduziert die manuelle Eingabe und kann die Anzahl von Tippfehlern verringern. Die Daten sollten vor der Verwendung für eine Bestellung oder Rechnung geprüft werden. Das Modul führt keine separate steuerliche Prüfung des Unternehmens durch.
Installation über Composer
Paket kowal/module-gus, Modul Kowal_Gus. Nach der Konfiguration des Zugriffs auf das Kowal-Repository installieren Sie das Paket, aktivieren das Modul, aktualisieren Magento und leeren den Cache. In der Produktion berücksichtigen Sie die Kompilierung und Bereitstellung statischer Inhalte gemäß dem Prozess des Shops.
Von der Konfiguration zum Ergebnis
1. Sie konfigurieren den Zugriff Sie aktivieren das Modul und legen den Benutzerschlüssel für den GUS-Dienst fest.
2. Der Nutzer gibt die NIP ein Die Änderung des Feldes startet den Abruf der Unternehmensdaten.
3. Das Formular ergänzt die Daten Name, Straße, Postleitzahl und Ort werden in die Adressfelder übernommen.
Weniger Eingaben beim Kauf als Unternehmen
Der Kunde gibt die NIP im Checkout an. Nach einer korrekten Antwort von GUS füllt das Modul den Firmennamen und die Adresse aus. Der Kunde prüft die Daten vor dem Absenden der Bestellung.
Der Administrator kann den Datenabruf auch beim manuellen Erstellen einer Bestellung nutzen.
Installieren Sie das Modul: - Fügen Sie das Composer-Repository zur Konfiguration hinzu, indem Sie Folgendes ausführen
Die Zugangsdaten zum Composer-Repository (E-Mail-Adresse des Kunden und Lizenz-Token) erhalten Sie nach dem Kauf per E-Mail. Sie sind außerdem nach dem Einloggen im Kundenpanel auf kowal.store verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.
Ermöglicht das Modul, Firmendaten anhand der NIP-Nummer automatisch auszufüllen?
Antwort
Ja — nach Eingabe der NIP-Nummer im Shop-Formular ruft das Modul die Firmendaten über die GUS-API ab und füllt automatisch die Felder aus: Firmenname, Adresse, Postleitzahl, Stadt.
Frage
Funktioniert das Modul sowohl auf der Checkout-Seite als auch im Administrationsbereich?
Antwort
Ja — das Modul funktioniert sowohl beim Aufgeben einer Bestellung im Shop (Checkout-Seite) als auch beim manuellen Erstellen einer Bestellung im Administrationsbereich von Magento 2.
Frage
Kann ich die Funktion des Moduls in der Magento-Konfiguration aktivieren oder deaktivieren?
Antwort
Ja — das Modul verfügt über eine Option zum Aktivieren oder Deaktivieren in den Einstellungen des Magento-Shops.
Frage
Erfordert das Modul das Überschreiben von Magento-Core- oder Theme-Dateien?
Antwort
Nein — das Modul integriert sich in die nativen Formulare von Magento 2 und arbeitet gemäß der Erweiterungsarchitektur, ohne dass Core-Dateien geändert werden müssen.
Frage
Muss ich einen API-Schlüssel erhalten, damit das Modul die GUS-Datenbank nutzen kann?
Antwort
Ja — das Modul nutzt die API des GUS (über das Portal stat.gov.pl oder die entsprechende Schnittstelle), um Daten anhand der NIP abzurufen.
Frage
Verbessert das Modul die Genauigkeit der Firmendaten in Bestellungen und auf Rechnungen?
Antwort
Ja — durch das automatische Abrufen von Daten aus dem GUS verringert sich das Risiko von Tippfehlern und Fehlern in den Firmendaten, was die Rechnungsausstellung oder korrekte Buchhaltungsdaten erleichtert.
Frage
Funktioniert das Modul in den Versionen Magento 2-2.3.x und 2.4.x?
Antwort
Ja — in der Produktbeschreibung ist die Kompatibilität mit Magento 2.3.4-2.3.7 sowie 2.4.0-2.4.7 angegeben.
Frage
Beeinflusst es die Leistung des Shops?
Antwort
Die Auswirkungen sind minimal — das Modul führt eine Abfrage nach der Eingabe der NIP aus und füllt die Felder automatisch aus, sodass die Belastung gering ist. Dennoch lohnt es sich immer, vor dem Produktivbetrieb in einer Umgebung zu testen.
Frage
Kann das Modul in einem B2B-Shop verwendet werden, in dem die Kunden Unternehmen sind?
Antwort
Ja — es ist eine Lösung, die besonders in B2B-Shops nützlich ist, in denen Kunden Unternehmensdaten eingeben und Shops die Korrektheit der Daten sicherstellen sowie den Bestellvorgang vereinfachen möchten.
Frage
Erhalte ich nach dem Kauf eine Installationsdokumentation sowie technischen Support?
Antwort
Ja — nach dem Kauf des Moduls ist eine Anleitung zur Installation und Konfiguration verfügbar.
