Umsatzsteuer-(USTID)-Validierung PRO für B2B (Shopware 6)

Validiere die Umsatzsteuer-ID Deiner Kunden einfach mit unserem Plugin mit vielen Optionen, um Deinen Pflichten nach dem EU-Steuerrecht ausreichend nachzukommen.

Umsatzsteuer-(USTID)-Validierung PRO für B2B Plugin für Shopware 6 im Shopware Store

Funktionalitäten

Prüft die USTID von EU-Unternehmen.
Optionale Echtzeit Validierung mittels AJAX.
Direkte Schnittstellenanbindung an DE- / EU-API.
Jede Anfrage an eine Schnittstelle wird geloggt und in der Datenbank gespeichert.
Der Log kann als CSV-Datei im Adminbereich unter Kunden » USTID-Validierungslog heruntergeladen werden.
Der Log zeigt übersichtlich an mit welchem API-Typ die Abfrage erfolgt ist, welches Ergebnis erzielt wurde und welche Angaben von der API als gültig/ungültig angmerkt wurden.
Validierung erfolgt automatisch einmal pro Tag oder bei Änderung der Adresse.
Validierung bei Registrierung möglich.
Beim Hinterlegen der USTID im Kundenaccount wird diese validiert.
Beim Bestellabschluss werden Lösungsvorschläge angezeigt, wenn USTID und Angaben nicht zusammenpassen. Mit dem Button "Vorschläge anwenden" werden die Vorschläge direkt in die Adresse übernommen. Eine manuelle Adressanpassung durch den Kunden ist nicht nötig.
Für steuerfreie Länder wird die Bestellung ohne Mehrwertsteuer angezeigt.
Optional kann die steuerfreie Bestellung für Gastbesteller unterbunden werden – unabhängig vom Ergebnis der Validierung.
Im Off-Canvas-Warenkorb wird ein Hinweis angezeigt, welche Daten nicht korrekt sind, wenn die Option "Bestellung blockieren, wenn USTID-Prüfung nicht gültig ist" aktiviert ist.
Über ein Zusatzfeld beim Kunden kann der Validierungstyp für diesen Kunden individuell angepasst und alternative Adressangaben für die Validierung hinterlegt werden.
Optional kann die Eingabe der USTID pro Adresse (statt pro Kundenaccount) aktiviert werden.
In der Konfiguration kann festgelegt werden, welche API für die Validierung genutzt wird.
Health Monitor:
- Kontinuierliche Überwachung der Verfügbarkeit der APIs.
- Bei Überschreitung einer festgelegten Fehleranzahl wird die API automatisch als nicht verfügbar gekennzeichnet.
- Vorübergehndes Überspringen der API zur Vermeidung unnötiger Timeouts.
- Überblick mit aktuellem API-Status im Dashboard: Anzeige ob die API erreichbar und vollverfügabr ist oder ob Einschränkdungen vorliegen.
Zu beachten: Deutsche USTIDs werden nicht validiert.

Einstellungsmöglichkeiten / Konfiguration

Allgemein

Aktiv

Aktiviere die Funktion der Erweiterung für alle Verkaufskanäle oder ausgewählte Verkaufskanäle.

Echtzeit-AJAX-Validierung im Storefront aktivieren

Die aktivierte Option valdidiert die USTID live, während dein Kunde das Registrierungs-Formular ausfüllt.

Ihre Umsatzsteuer-ID

Gib hier Deine Umsatzsteuer-ID ein, damit unser Plugin die UST-IDs Deiner Kunden prüfen kann.

USTID als Pflichtfeld für folgende Länder

Wähle hier die Länder aus, für welche die Angabe der USTID erforderlich ist.

Benutze USTID der Adresse für Validierung? (Eigene USTID pro Adresse)

Wird diese Option aktiviert, wird die USTID auf Adressebene gepflegt und nicht im persönlichen Profil. Dadurch ist es beispielsweise möglich die Validierung der Adresse durchzuführen, auch wenn es sich um ein Konto des Typs "Privat" handelt. Hinweis: Bereits vorhandene USTIDs werden nicht automatisch zugeordnet.

Adresse für Validierung

Lege fest, welche Adresse als Grundlage dienen soll – Rechnungsadresse oder Lieferadresse. Wir empfehlen die Lieferadresse.

Validierung bei Registrierung

Die Validierung der UST-ID erfolgt bei der Registrierung. Unter den Validierungstypen "Keine", "Offline", "Einfach" und "Erweitert" kann gewählt werden. Bei "Offline" wird nur der Offline-Plausibilitätscheck (mehr als drei Zeichen und weniger als 15 Zeichen) durchgeführt. Bei "Einfach" wird geprüft, ob die Umsatzsteuer-ID gültig ist. Bei "Erweitert" wird geprüft, ob USTID und Adresse zueinander passen sowie passende Vorschläge zur Korrektur werden angezeigt.

Validierung bei Profil-Update

Die Validierung der UST-ID erfolgt bei der Änderung der USTID im Profil Deines Kunden. Die Validierungstypen "Keine", "Offline" und "Einfach" stehen zur Auswahl. Bei "Offline" wird nur der Offline-Plausibilitätscheck (mehr als drei Zeichen und weniger als 15 Zeichen) durchgeführt. Bei "Einfach" wird geprüft, ob die Umsatzsteuer-ID gültig ist.

Validierung bei Steuerfreiheit & Bestellabschluss

Du kannst festlegen, welcher Validierungstyp für Deine Kunden gewählt wird, die aufgrund ihres Landes steuerfrei bestellen können. Zur Auswahl stehen die Validierungstypen "Offline", "Einfach" und "Erweitert". Bei "Offline" wird nur der Offline-Plausibilitätscheck (mehr als drei Zeichen und weniger als 15 Zeichen) durchgeführt. Bei "Einfach" wird geprüft, ob die Umsatzsteuer-ID gültig ist. Bei "Erweitert" wird geprüft, ob USTID und Adresse zueinander passen sowie passende Vorschläge zur Korrektur werden angezeigt.

Als valide durchgehen lassen, wenn alle APIs Fehler zurückgeben

Validierung als "valide" durchgehen lassen, wenn von allen APIs ein Fehler zurückgegeben wird

Zusätzliche Validierung für steuerfreie Lieferung

Es gibt die Validierungstypen "Keine", "gleiche Adresse" und "Gleiches Land bei Rechnungs- und Lieferadresse". Die App überprüft bei "Gleiche Adresse", ob die ausgewählte Adresse mit der Adresse der USTID übereinstimmt. So kannst Du verhindern, dass ausländische Kunden die USTID einer Firma angeben können und dann die Ware steuerfrei an ihre private Adresse geliefert bekommen. Bei "Gleiches Land bei Rechnungs- und Lieferadresse" wird überprüft ob das Lieferland von Liefer- und Rechnungsadresse identisch ist.

Hinweis auf /checkout/confirm anzeigen, wenn bei Land mit "Steuerfreiheit (B2B)" keine USTID hinterlegt ist

Adressvorschläge ins lateinische Alphabet übersetzen?

Bestellung blockieren, wenn USTID-Prüfung nicht gültig ist?

Mit dieser Funktion kannst Du verhindern, dass Bestellungen abgeschlossen werden können, wenn die USTID-Prüfung nicht gültig ist. Erst wenn die USTID-Prüfung valide ist, kann die Bestellung abgeschlossen werden.

Bestellung blockieren, wenn API-Fehler auftritt?

Diese Option verhindert, dass dein Kunde die Bestellung abschließen kann, wenn von der API ein Fehler zurück kommt (z.B. API not reachable).

Bestellung blockieren, für Länder mit "Steuerfrei (B2B)" aktiv, wenn keine USTID hinterlegt wurde?

Mit dieser Option kannst Du verhindern, dass Bestellungen abgeschlossen werden können, wenn die USTID nicht angegeben wurde. Erst wenn eine USTID im Profil hinterlegt wurde, kann mit der Bestellung fortgefahren werden.

Experten-Einstellungen

Steuerfreiheit für Gast-Accounts verhindern?

Wenn diese Option aktiv ist, wird die Bestellung des Gast-Kunden immer mit Mehrwertsteuer berechnet unabhängig von der Prüfung.

Wie viele Tage ist ein Ergebnis der API-Validierung gültig?

Im Standard speichert die Erweiterung das Ergebnis der API-Validierung für den aktuellen Tag. Die API-Validierung wird nach Ablauf des Tages nochmals ausgeführt. Mit dieser Option kannst Du einen anderen Standard-Wert für die Gültigkeit der API-Validierung festlegen.

DE-API Einstellungen

DE-API aktiv?

Damit die Validierung über die deutsche API ausgeführt wird, musst Du diese Option aktivieren. Mindestens eine der APIs (DE oder EU) muss aktiviert sein, damit eine Prüfung durchgeführt werden kann.

Führende Nullen in Straße kürzen?

Mit dieser Option werden automatisch die führenden Nullen bei der Hausnummer weggekürzt, z.B. 00066 wird zu 66. Hinweis: Dies wird die führenden Nullen auch in der Abfragen und im Log entfernen. - DE-API aktiv?

De-API-Timeout in Sekunden

Standard 30 Sekunden

Wie viele zusätzliche Versuche sollen gemacht werden, wenn es einen API-Fehler gibt?

Definiere wie oft die API angefragt werden soll, wenn ein API-Fehler bei der ersten Anfrage zurückkommt.

Wie viele Sekunden sollen die zusätzlichen Versuche verzögert werden?

Definiere nach vielen Sekunden die weitere Anfrage gesendet werden soll.

Health Monitor: Aufeinanderfolgende Fehler bis zur Markierung als nicht verfügbar (0=Deaktiviert)

Nach dieser Anzahl aufeinanderfolgender API-Fehler wird die API vorübergehend übersprungen, um unnötige Timeouts zu vermeiden. Auf dem Dashboard ist eine Übersicht zur aktuellen Erreichbarkeit sichtbar.

EU-API Einstellungen

EU-API aktiv?

Damit die Validierung über die europäische API ausgeführt wird, musst Du diese Option aktivieren. Mindestens eine der APIs (DE oder EU) muss aktiviert sein, damit eine Prüfung durchgeführt werden kann.