Zum Inhalt

Ablauf der Prüfung

Wo geprüft wird

Stelle Prüfart aus Geprüfte Daten Wenn die Prüfung fehlschlägt
Registrierung (Kontotyp „Gewerblich“) „Validierung bei Registrierung“ USt-ID und Rechnungsadresse Meldung am Feld „Umsatzsteuer-ID“, das Konto wird nicht angelegt
Profil, beim Speichern „Validierung bei Profil-Update“ nur die USt-ID Meldung am Feld, das Profil wird nicht gespeichert
Adresse, beim Speichern (nur mit „Benutze USTID der Adresse für Validierung?“) „Validierung bei Steuerfreiheit + Bestellabschluss:“ USt-ID und Adresse Meldung am Feld, die Adresse wird nicht gespeichert
Während der Eingabe (Registrierung, Adressformular) „Einfach“, danach „Validierung bei Steuerfreiheit + Bestellabschluss:“ USt-ID, bei „Erweitert“ auch die Adresse nur ein Hinweis am Feld
Warenkorb und Seite „Bestellung abschließen“ „Validierung bei Steuerfreiheit + Bestellabschluss:“ USt-ID und die Adresse aus „Adresse für Validierung“ Die Umsatzsteuer wird berechnet, auf Wunsch wird die Bestellung gesperrt

Bei Registrierung, Adresse und im Warenkorb wird nur geprüft, wenn das Land der geprüften Adresse in der EU liegt und „Steuerfrei (B2B)“ hat. Im Warenkorb muss die Adresse außerdem eine Firma enthalten.


Schnittstellen

Die Erweiterung fragt die Schnittstellen in dieser Reihenfolge:

  1. DE-API (BZSt), wenn „DE-API aktiv?“ an ist, „Ihre Umsatzsteuer-ID“ mit DE beginnt und die USt-ID des Kunden nicht.
  2. EU-API (VIES), wenn „EU-API aktiv?“ an ist.

Die EU-API wird nur gefragt, wenn

  • die DE-API nicht in Frage kommt,
  • die DE-API mit einem Fehler antwortet (nach den eingestellten zusätzlichen Versuchen) oder
  • die DE-API die USt-ID als gültig meldet, aber die Adresse nicht passt. Die DE-API liefert keine Vorschläge, die EU-API kann sie liefern.

Meldet die DE-API die USt-ID als ungültig, gilt das Ergebnis, ohne dass die EU-API gefragt wird. Antwortet die EU-API mit einem Fehler, nachdem die DE-API bereits ein Ergebnis geliefert hat, gilt das Ergebnis der DE-API.

Abgleich der Adresse bei „Erweitert“

  • DE-API: Das BZSt meldet für Firma, Straße, PLZ und Ort, ob sie passen. Liefert ein Mitgliedstaat zu einem Feld keine Daten, zählt das Feld als passend.
  • EU-API: Liefert VIES zu einem Feld ein eigenes Abgleichergebnis, gilt dieses. Sonst vergleicht die Erweiterung die Eingabe mit Name und Adresse aus VIES. Groß- und Kleinschreibung, Leerzeichen, Zeilenumbrüche, Bindestriche, Schrägstriche, Apostrophe und die Zeichen < und > spielen keine Rolle, andere Schriften werden in lateinische Buchstaben umgeschrieben. Danach müssen beide Werte gleich sein. Passt ein Feld bei diesem Vergleich nicht, wird der Wert aus VIES als Vorschlag angezeigt.
  • Liefert VIES statt einer Adresse einen Platzhalter (leer, N/A, --- oder 00000 OSOITE TUNTEMATON), bleiben Straße, PLZ und Ort ungeprüft, der Name wird geprüft. Litauen liefert nie eine Adresse.
  • Liefert VIES zu einem einzelnen Feld keinen Wert, bleibt dieses Feld ungeprüft und bekommt keinen Vorschlag. Beispiel: rumänische Adressen mit der PLZ 00000. Bei rumänischen Adressen ohne sechsstellige PLZ, etwa in Bukarest, wird der Ort nicht geprüft.
  • Bei ungarischen USt-Gruppen liefert VIES statt des Namens einen Hinweis der Steuerbehörde („Áfa csoport / VAT Group …“). Der Name bleibt dann ungeprüft und bekommt keinen Vorschlag, die Adresse wird geprüft.
  • Kann die Erweiterung die Adresse aus VIES nicht in Straße, PLZ und Ort zerlegen, ist die Prüfung nicht gültig. Der Kunde sieht „Ihre Adresse konnte technisch nicht ausgewertet werden. …“, im Log steht der Grund unter „Fehler bei der Adressauswertung“. Melde solche Fälle bitte an unseren Support.
  • Das Länderkürzel der USt-ID muss zum Land der Adresse passen. EL gilt als Griechenland, XI als Großbritannien.

Der Kunde soll Name und Adresse so eingeben, wie sie bei der Behörde registriert sind. Dafür gibt es die Vorschläge. Weicht die Eingabe ab, zum Beispiel durch eine abgekürzte Rechtsform oder „ue“ statt „ü“, lehnt die Prüfung ab.


Speicherung und erneute Prüfung

Jede Abfrage wird gespeichert. Für dieselben Daten (USt-ID, Prüfart, Firma, Straße, PLZ, Ort, Land und Ausnahmen des Kunden) verwendet die Erweiterung das gespeicherte Ergebnis, solange es nach „Wie viele Tage ist ein Ergebnis der API-Validierung gültig?“ gilt. Im Standard ist das bis zum Ende des Tages. Ändert der Kunde seine Adresse oder wählt eine andere Lieferadresse, wird sofort neu geprüft.

Mit Daten erneut abfragen auf der Seite „Bestellung abschließen“ fragt der Kunde unabhängig davon neu ab. Die Schaltfläche erscheint, wenn die Prüfung ungültig ist oder eine Schnittstelle einen Fehler gemeldet hat.


Ergebnis auf der Seite „Bestellung abschließen“

Der Kasten „USTID Validierung“ erscheint bei Firmenkunden mit USt-ID, wenn das Land der geprüften Adresse in der EU liegt und „Steuerfrei (B2B)“ hat. Er zeigt einen dieser Zustände:

Zustand Text (Textbaustein siehe Meldungen im Shop)
Gültig, steuerfrei Ihre USTID "…" passt zur Adresse, daher kann steuerfrei bestellt werden.
USt-ID ungültig oder Adresse passt nicht Die hinterlegte USTID passt nicht zur Lieferadresse, daher wird die Umsatzsteuer berechnet.
USt-ID gültig, aber „Zusätzliche Validierung“ verletzt Ihre USTID ist gültig, aber Rechnungs- und Lieferadresse erfüllen die zusätzliche Prüfung nicht, daher wird die Umsatzsteuer berechnet.
Gültig, aber trotzdem nicht steuerfrei Keine steuerfreie Lieferung möglich: … Daher wird die Umsatzsteuer berechnet. (mit Grund, siehe Wann ist eine Bestellung steuerfrei?)
Fehler der Schnittstelle API-Fehler. Bitte später erneut prüfen. (Steuerfreiheit kann nicht gewährt werden!)
Adresse aus VIES nicht auswertbar Ihre Adresse konnte technisch nicht ausgewertet werden. …
Adresse ohne Firma Keine Steuerfreiheit, da Privatadresse.
Lieferung in ein Drittland, steuerfrei Lieferung in ein Drittland: Die Bestellung erfolgt als Ausfuhr steuerfrei.
Lieferland mit „Steuerfrei (B2C)“ Lieferungen in dieses Land sind für alle Kunden steuerfrei.

Die Meldung zur Ausfuhr erscheint nur mit „Adresse für Validierung: Rechnungsadresse“ und einer Rechnungsadresse in der EU. Mit „Lieferadresse“ liegt die geprüfte Adresse dann außerhalb der EU, und der Kasten erscheint nicht.

Ist die Prüfung ungültig, folgt eine Tabelle mit USt-ID, Firma, Straße, PLZ, Ort, Land und „Zusätzliche Prüfungen“. Jedes Feld ist als passend, nicht passend oder „(nicht geprüft)“ markiert. Bei nicht passenden Feldern steht unter „Erwartet:“ der Vorschlag. Vorschläge anwenden schreibt die Vorschläge in die Adresse aus „Adresse für Validierung“.

Storefront: Erfolgreiche Validierung im Checkout

Storefront: Erfolgreiche Validierung im Checkout

Storefront: Fehlgeschlagene Validierung im Checkout

Storefront: Fehlgeschlagene Validierung im Checkout


Validierungslog

Unter Kunden → USTID-Validierungslog steht jede Abfrage, die neueste oben. Download lädt das gesamte Log als CSV-Datei herunter, unabhängig von der Suche.

Spalte Inhalt
USTID geprüfte USt-ID
Validierungsdatum Zeitpunkt der Abfrage
Status „Gültig“, „Ungültig“ oder „API nicht erreichbar“
Api-Typ „BZSt (DE)“, „MIAS (EU)“ oder „–“ (ohne Schnittstelle)
Prüfungstiefe „Keine Prüfung“, „Offline (nur Syntax)“, „Einfach“ oder „Erweitert“
Grund Stelle der Abfrage, siehe unten
USTID gültig, Firmenname, Straße, PLZ, Ort, Land Ergebnis je Feld: „Gültig“, „Ungültig“ oder „Nicht geprüft“
Grund Stelle
customer-registration Registrierung
customer-profile-update Profil
address-update Speichern einer Adresse mit eigener USt-ID
ajax-validation, ajax-validation-extended Echtzeit-Prüfung während der Eingabe (ohne bzw. mit Adresse)
tax-detector-is-net-delivery Berechnung des Warenkorbs
cart-validator Prüfung des Warenkorbs vor dem Bestellabschluss
order-confirm-page Seite „Bestellung abschließen“
recheck-by-customer Daten erneut abfragen

Die Detailseite zeigt unter „Validierungsergebnis“ Status, Prüfungstiefe und API-Backend, unter „Geprüfte Felder“ je Feld die Eingabe, das Ergebnis und den Vorschlag. Darunter stehen API-Fehler, „Fehler bei der Adressauswertung“, die API-Antwort und die Validierungsdaten.

In der Bestellung zeigt die Karte „USTID-Validierungsdaten“ den Logeintrag der Seite „Bestellung abschließen“ mit Link Zum Logeintrag. Die USt-ID steht außerdem in der Übersicht der Bestellung unter „USTID“.


Dashboard: API-Status

Die Karte „USt-IdNr. API-Status“ im Dashboard zeigt je Schnittstelle („BZSt (DE)“ und „VIES (EU)“):

  • Erreichbar / Nicht erreichbar: Ergebnis einer Testverbindung beim Laden der Karte, mit 5 Sekunden Wartezeit. Bei abgeschalteter Schnittstelle steht „Deaktiviert“.
  • Verfügbar, Beeinträchtigt oder Nicht verfügbar: Aus den letzten 100 Logeinträgen der Schnittstelle zählt die Erweiterung die aufeinanderfolgenden Fehler bis zum neuesten Eintrag. Kein Fehler: „Verfügbar“. Mindestens ein Fehler: „Beeinträchtigt“. Ab dem Wert aus „Health Monitor: Aufeinanderfolgende Fehler bis zur Markierung als nicht verfügbar“: „Nicht verfügbar“.

Aktualisieren lädt die Karte neu. Die Prüfungen selbst laufen unabhängig vom angezeigten Status weiter über die Schnittstelle.

Admin: Dashboard - API-Status

Admin: Dashboard - API-Status