USt-ID Onlineprüfung OXID 7 (twig)

Beschreibung

Ab Januar 2026 funktionieren Modulversionen vor v2.3.0 nicht mehr, da die Schnittstelle des Bundeszentralamtes für Steuern von XML zu Rest API umgestellt wurde. Bitte updaten Sie daher Ihr Modul auf die aktuelle Version (ab v2.3.0).

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.

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

• Live-Prüfung über BZSt (evatr)
  Die Abfrage erfolgt online über die offizielle BZSt-Schnittstelle (Rest API) und berücksichtigt die relevanten Kundendaten.
• Qualifizierte Prüfung (länderabhängig)
  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.
• Detaillierte Ergebnisanzeige statt „nur gültig/ungültig“
  Sie erhalten eine verständliche Rückmeldung inkl. offizieller BZSt-Fehlercodes (übersetzt), sowie eine klare Darstellung, welche Bestandteile bestätigt wurden.
• Dokumentation in der Bestellung + Historie
  Bei erfolgreicher Prüfung wird der Prüfzeitpunkt in der Bestellung gespeichert. Zusätzlich wird das Original-Ergebnis der BZSt-Antwort in der Historie abgelegt (für spätere Nachweise und interne Dokumentation).
• Admin-Anzeige direkt in der Bestellung
  Im Adminbereich erkennen Sie auf einen Blick, ob die USt-ID-Prüfung zum Bestellzeitpunkt erfolgreich gespeichert wurde (inkl. Datum/Uhrzeit).
• Konfigurierbares Verhalten bei ungültiger USt-ID
  Je nach Shop-Strategie können Sie entscheiden, ob bei ungültiger USt-ID nur eine Meldung ausgegeben wird oder ob der Checkout konsequenter behandelt wird (z.B. Bestellfortschritt blockieren).

So läuft die Prüfung im Shop ab (verständlich erklärt)

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). Die Abfrage nutzt dabei die 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 sind bestätigt (bzw. je nach Einstellung „nicht prüfbar“ zulässig), kann die Bestellung entsprechend als USt-frei behandelt werden. Bei ungültiger USt-ID erfolgt eine klare Meldung und – falls aktiviert – eine konsequentere Einschränkung des Bestellfortschritts.
4. Dokumentation
   Bei erfolgreicher Prüfung wird der Prüfzeitpunkt in der Bestellung gespeichert und das Original-Ergebnis wird in der Historie abgelegt – damit Sie später nachvollziehen können, was exakt geprüft wurde.

Moduleinstellungen (praxisorientiert)

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. In diesen Fällen kann ein Merkmal den Status „D“ (nicht prüfbar) haben. Wenn Sie diese Option aktivieren, kann die Prüfung trotzdem als ausreichend gewertet werden, sofern die relevanten Kernmerkmale bestätigt sind.
• Bei ungültiger USt-ID den Weiter-Button/Checkout blockieren
  Aktivieren Sie diese Option, wenn Sie USt-freie Bestellungen nur dann zulassen möchten, wenn die Prüfung erfolgreich ist, und der Kunde ansonsten nicht „einfach weiterklicken“ soll.

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

FAQ

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 können Sie steuern, 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.

Spezifikation