Beschreibung
USt-ID Onlineprüfung ist ein Prüfmodul für OXID eShop 6 ab Version 6.1 und OXID eShop 7 ab Version 7.1. Es kontrolliert die Umsatzsteuer-ID und die Rechnungsadresse ausländischer EU-Kunden live über die REST-Schnittstelle des Bundeszentralamts für Steuern. Nur eine bestätigte Prüfung erlaubt die umsatzsteuerfreie Lieferung.
Handbuch Demo-Video Installationsservice
USt-ID Onlineprüfung für OXID eShop
Mit der eComStyle.de USt-ID Onlineprüfung prüfen Sie die Umsatzsteuer-ID (USt-IdNr.) Ihrer Kunden aus dem EU-Ausland automatisiert und live im Bestellprozess – direkt über die offizielle Schnittstelle des Bundeszentralamts für Steuern (BZSt / evatr). So erhöhen Sie die Sicherheit bei steuerfreien innergemeinschaftlichen Lieferungen (B2B), reduzieren Fehlabwicklungen und schaffen eine bessere Nachvollziehbarkeit für Buchhaltung, Steuerberatung und interne Prozesse.
Das Modul ist für OXID eShop konzipiert und legt besonderen Fokus auf zwei Punkte: verlässliche Live-Prüfung und saubere Dokumentation. Neben einer verständlichen Ergebnisdarstellung werden die Prüfdaten dauerhaft nachvollziehbar abgelegt: Bei erfolgreicher Prüfung wird ein Prüfzeitpunkt in der Bestellung gespeichert und das Original-Ergebnis der BZSt-Antwort wird in der Historie (als historischer Eintrag zur Bestellung/Kunde) gespeichert. Dadurch können Sie auch später noch nachvollziehen, welche Daten tatsächlich geprüft wurden und welche Rückmeldung vom BZSt kam – ein wichtiger Baustein für revisionssichere Abläufe.
- Shop-Versionen: OXID eShop 6 ab 6.1 (Smarty) · OXID eShop 7 ab 7.1 (Twig)
- Schnittstelle: BZSt / evatr REST-API, verschlüsselt per HTTPS
- Geprüft wird: ausländische USt-IdNr. sowie Rechnungsadresse (qualifiziert, länderabhängig)
- Prüfnachweis: Prüfzeitpunkt an der Bestellung und Original-BZSt-Antwort in der Historie
Warum eine USt-ID-Prüfung im Checkout so wichtig ist
Bei EU-Auslandskunden ist die korrekte Behandlung der Umsatzsteuer ein sensibler Bereich. Eine USt-freie Lieferung setzt in der Praxis häufig voraus, dass die USt-ID des Geschäftskunden gültig ist und (bei qualifizierter Prüfung) die Angaben plausibel bestätigt werden. Das Modul unterstützt Sie dabei, diese Prüfung nicht erst im Nachhinein, sondern genau zum Bestellzeitpunkt durchzuführen und die Ergebnisse für spätere Prüfungen/Fragen zu dokumentieren.
- Weniger Risiko: USt-frei nur dann, wenn die USt-ID tatsächlich bestätigt werden kann
- Weniger Rückfragen: Klare Fehlermeldungen statt „unklarem Verhalten" im Checkout
- Bessere Nachvollziehbarkeit: Prüfzeitpunkt und Original-Antwort in der Historie gespeichert
Funktionsumfang & Highlights
Die Abfrage erfolgt online über die offizielle BZSt-Schnittstelle (REST-API) und berücksichtigt die relevanten Kundendaten.
Neben der USt-ID werden – je nach Verfügbarkeit im jeweiligen EU-Mitgliedsstaat – Kriterien wie Firma, Ort, PLZ und Straße in die qualifizierte Bestätigung einbezogen.
Verständliche Rückmeldung inkl. offizieller BZSt-Fehlercodes (übersetzt) statt nur „gültig/ungültig", sowie klare Darstellung, welche Bestandteile bestätigt wurden.
Bei erfolgreicher Prüfung wird der Prüfzeitpunkt in der Bestellung gespeichert; das Original-Ergebnis der BZSt-Antwort wird in der Historie abgelegt.
Im Adminbereich erkennen Sie auf einen Blick, ob die USt-ID-Prüfung zum Bestellzeitpunkt erfolgreich gespeichert wurde (inkl. Datum/Uhrzeit).
Je nach Shop-Strategie entscheiden Sie, ob bei ungültiger USt-ID nur eine Meldung erscheint oder der Checkout konsequenter behandelt wird (z. B. Fortschritt blockieren).
So läuft die Prüfung im Shop ab
- 1 Kunde gibt USt-ID an
Die Prüfung greift nur, wenn eine USt-ID vorhanden ist und der Kunde nicht aus Deutschland kommt (EU-Ausland). - 2 Prüfung zum Bestellzeitpunkt
Beim Bestellabschluss erfolgt die Live-Abfrage beim BZSt (evatr) mit den relevanten Rechnungsdaten (z. B. Firma/Ort/PLZ/Straße – abhängig von der Prüfart). - 3 Ergebnis & Checkout-Verhalten
Ist die USt-ID gültig und die qualifizierten Merkmale bestätigt (bzw. je nach Einstellung „nicht prüfbar" zulässig), kann die Bestellung als USt-frei behandelt werden. Bei ungültiger USt-ID erfolgt eine klare Meldung und – falls aktiviert – eine Einschränkung des Bestellfortschritts. - 4 Dokumentation
Bei erfolgreicher Prüfung wird der Prüfzeitpunkt in der Bestellung gespeichert und das Original-Ergebnis in der Historie abgelegt – damit Sie später nachvollziehen können, was exakt geprüft wurde.
Moduleinstellungen
Sie steuern das Verhalten des Moduls über wenige, aber wichtige Optionen – ideal, um den Prozess an Ihre Geschäftslogik anzupassen:
- PLZ/Straße tolerant behandeln (wenn länderbedingt nicht prüfbar): Manche EU-Länder liefern keine bestätigbaren Adressdetails; ein Merkmal kann den Status „D" (nicht prüfbar) haben. Aktiviert gilt die Prüfung als ausreichend, sofern die Kernmerkmale bestätigt sind.
- Checkout bei ungültiger USt-ID blockieren: USt-freie Bestellungen nur bei erfolgreicher Prüfung zulassen – der Kunde kann nicht „einfach weiterklicken".
Für wen ist das Modul ideal?
- B2B-Shops mit EU-Auslandskunden und USt-freien Lieferungen
- Händler mit erhöhtem Prüf- und Dokumentationsbedarf (Buchhaltung/Steuerberatung)
- Shops mit vielen manuellen Nacharbeiten, die automatisiert und sauber dokumentiert werden sollen
- OXID eShop 6 ab Version 6.1 mit Smarty (Wave oder Flow) oder OXID eShop 7 ab Version 7.1 mit Twig und Apex
- Eigene deutsche USt-IdNr. des Shops für die qualifizierte Prüfung
- HTTPS-Zugriff auf den BZSt-Prüfdienst; pro Anfrage wartet das Modul höchstens 30 Sekunden
- Unverschlüsselter Quelltext
- Prüfzeitpunkt an der Bestellung und vollständige BZSt-Antwort als Kundenbemerkung gespeichert
Die Pakete für OXID 6 und OXID 7 sind getrennt ausgeliefert und nicht austauschbar. Die Installation bieten wir schnell und unkompliziert zum Festpreis an: Modul-Installation Service. Natürlich können Sie das Modul auch selbst oder über Ihre Agentur installieren.
Wird auch bei deutschen Kunden geprüft?
Nein. Die Prüfung greift nur bei vorhandener USt-ID und einem Land ungleich Deutschland.
Warum wird manchmal Straße/PLZ nicht bestätigt?
Einige EU-Mitgliedsstaaten stellen Adressdaten nicht vollständig zur Verfügung oder bestätigen diese nicht. Das kann zu „nicht prüfbar" führen. Über die entsprechende Option steuern Sie, ob dies für Ihre USt-freie Behandlung akzeptabel sein soll.
Wo finde ich das Prüfungsergebnis später wieder?
Der Prüfzeitpunkt wird in der Bestellung gespeichert. Zusätzlich wird das Original-Ergebnis der BZSt-Antwort in der Historie abgelegt, sodass Sie das Ergebnis auch später nachvollziehen und dokumentieren können.
Für welche Shopversionen ist die USt-ID Onlineprüfung verfügbar?
Für OXID eShop 6 ab Version 6.1 mit Wave oder Flow und für OXID eShop 7 ab Version 7.1 mit Apex und Twig. Die Pakete sind je Hauptversion getrennt ausgeliefert.
Welche Daten sendet das Modul an den BZSt?
Die eigene deutsche USt-IdNr., die ausländische Kunden-USt-IdNr. sowie Firma, Ort, PLZ und Straße der Rechnungsadresse. Die Übertragung erfolgt verschlüsselt per HTTPS.
Beim Abspielen wird eine Verbindung zu YouTube (Google) hergestellt.
Auch die Prüfung inkl. exakter Rückmeldung für den Kunden (zB Ort = nicht ok) ist einmalig!