Umsatzsteuer USTID Validierung PRO für EU (B2B)
Beschreibung
Highlights
Features
Über die Erweiterung
Mit unserer App USTID Validierung PRO für B2B kannst Du Umsatzsteuer-IDs in Deinem Shop automatisch prüfen lassen und dem Kunden eine steuerfreie Lieferung (ab v1.0.6) ermöglichen. Die App bietet zahlreiche Funktionen, die für Dich wichtig sind, wenn Du häufig mit EU-Unternehmen handelst. Nachfolgend lernst Du die App kennen:
Funktionen
- Prüft USTID von EU-Unternehmen automatisch.
- Jede Anfrage an eine Schnittstelle wird geloggt und in der Datenbank gespeichert. So kannst Du nachweisen, dass Du die USTID geprüft hast. Den Log kannst Du als csv-Datei im Adminbereich unter Kunden -> USTID-Validierungslog downloaden (ab v5.0.13).
- Die Validierung erfolgt automatisch 1x pro Tag, wenn der Kunde im Onlineshop aktiv ist, oder bei Änderung der Adresse. Bei einer Adressänderung wird die neue Lieferadresse sofort überprüft.
- Eine Validierung der USTID bei der Registrierung ist optional möglich.
- Beim Hinterlegen der USTID im Kundenaccount wird diese validiert und auf ihre Gültigkeit überprüft.
- Deine Kunden bekommen auf der Bestellbestätigungsseite (Checkout) direkt angezeigt, ob die Validierung erfolgreich war und wenn nicht, werden die Validierungsfehler mit Lösungsvorschlägen in einer Übersicht direkt angezeigt. Über den Button "Vorschläge anwenden" werden die Vorschläge direkt in die Adresse übertragen. Eine manuelle Adressanpassung durch den Kunden ist nicht nötig.
- Die Validierung der USTID erfolgt für Deine Kunden, die ihren Sitz in Länder haben, die als steuerfrei gekennzeichnet sind, beim Bestellabschluss. Ist die USTID korrekt wird die Bestellung ohne MwSt angezeigt.
In der Plugin-Konfiguration hast Du die Möglichkeit für Gastbesteller eine steuerfreie Bestellung zu unterbinden unabhängig vom Ergebnis der Validierung. - Zu Beachten gilt: Die Länder, die steuerfrei sind, müssen unter Einstellungen -> Shop -> Länder für jedes Land eingestellt werden. Dies war zuvor in der App möglich und ist jetzt in den Shopware Standard gewechselt.
- Zu Beachten gilt: Deutsche USTIDs werden nicht validiert.
- Hinweis: Bei der Registrierung wird unabhängig von den App-Einstellungen immer die Rechnungsadresse geprüft.
- Für die Validierung von Unternehmen aus Nordirland muss Nordirland als eigenes Land angelegt werden und dort Steuerfrei für Unternehmen aktiviert werden. Als Länder-ISO für Nordirland muss GB oder XI hinterlegt werden.
- Wenn die Konfiguration "Bestellung blockieren, wenn USTID-Prüfung nicht gültig ist" aktiviert ist, wird bereits im Off-Canvas-Warenkorb ein Hinweis ausgegeben, welche Daten nicht korrekt sind. Mit einem Klick auf "Details ansehen" gelangt der Kunde zur Tabelle auf /checkout/confirm.
- Ab Version 2.0.22: Im Kundenaccount kann über ein Zusatzfeld der Validierungstyp für diesen Kunden individuell angepasst werden.
- Ab Version 5.8.1: Im Kundenaccount kann über das Zusatzfeld-Set "USTID Validierung - Kunde" eine Alternative für die zusätzliche Validierung (Gleiche Adresse/Gleiches Land bei Rechnungs- und Lieferadresse) sowie Ausnahmen für Firma, Straße, PLZ und Ort definiert werden, welche bei der Validierung beachtet werden.
- Ab Version 6.0.4: Nun ist es möglich mit der Aktivierung der Option "Benutze USTID der Adresse zur Validierung" die USTID bei der Adresse gepflegt werden kann. Dadurch kann dein Kunde für jede seiner Lieferadressen die jeweilig zugehörige USTID hinterlegen. Zu Beachten ist, dass USTIDs die bereits im persönlichen Profil gepflegt sind, nicht automatisch einer Adresse zugeordnet werden.
- Ab Version 6.0.6: In der Plugin-Konfiguration kannst Du festlegen, welche API genutzt werden soll für die Validierung. Mindestens eine der APIs (EU oder DE) muss aktiviert werden, damit eine Validierung ausgeführt wird.
Optionen
Konfiguration
- Ihre Umsatzsteuer-ID: Gib hier Deine Umsatzsteuer-ID ein, damit unsere App die Umsatzsteuer-IDs Deiner Kunden prüfen kann.
- Adresse für Validierung: Du kannst festlegen welche Adresse als Grundlage für die Validierung dienen soll. Zur Auswahl stehen die Rechnungs- oder Lieferadresse. Wir empfehlen stets die Lieferadresse zu verwenden.
- Benutze USTID der Adresse für Validierung? (Eigene USTID pro Adresse): Bei Aktivierung dieser Option wird die USTID bei der Adresse des Kunden gepflegt und nicht unter "Persönliches Profil". Beachte: Bereits vorhandene USTIDs werden nicht automatisch einer Adresse zugeordnet.
- 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.
- Validierung als "valide" durchgehen lassen, wenn von allen APIs ein Fehler zurückgegeben wird: aktiv / inaktiv
- 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, 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.
- API-Timeout in Sekunden
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.
- 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.
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.
- 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.
- 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.
Hinweise zu APIs
EU-API
- Bis Version 5.0.7: Estland: Keine Validierung der Stadt über EU-API möglich
Ab Version 5.0.8: Estland: Stadt wird aus Stadt und ggf. weiteren Daten wie z.B. Landkreis validiert. - Irland: Postleitzahl über EU-API nicht validierbar.
- Litauen: Postleitzahl über EU-API nicht validierbar.
- Spanien: Validierung ist möglich, aber es werden keine Adressvorschläge angezeigt.
Bitte frage z.B. Deinen Steuerberater wie Du Unterlagen für die Finanzbehörden vorhalten musst. Wir übernehmen dafür keine Haftung.
Voraussetzungen:
- php-soap
Infos zur innergemeinschaftlichen Lieferung findest Du hier: https://www.frankfurt-main.ihk.de/recht/steuerrecht/umsatzsteuer_international/innergemeinschaftliche_lieferungen/
Weitere Informationen
Allgemein
Unsere Erweiterungen basieren auf Standardfunktionen von Shopware 6 (Community Edition) und dem Standard Responsive Theme. Individuelle oder stark angepasste Themes können bei der Entwicklung nicht berücksichtigt werden. In solchen Fällen können Anpassungen nötig sein, um eine vollständige Kompatibilität sicherzustellen.
Kompatibilität
Unsere Erweiterungen sind grundsätzlich untereinander kompatibel. Wenn sich Funktionen gegenseitig ausschließen oder überschneiden, weisen wir in der Erweiterungs-Beschreibung explizit darauf hin.
Wir garantieren die Kompatibilität mit der Community Edition und dem Standard-Theme. Bei Nutzungs-Schwierigkeiten unterstützen wir dich selbstverständlich gern. Eine Kompatibilität mit Erweiterungen von Drittanbietern oder Shopware Premium-Erweiterungen können wir nicht garantieren.
Support
Unser Support-Team ist gerne für dich da! Bitte stelle deine Supportanfrage über deinen Shopware Account.
Prüfe dies vorab:
- Aktuellste Version der Erweiterung installiert
- Gültige Mietlizenz
- Fehler tritt auch im Standard Theme auf
- Drittanbieter-Erweiterungen sind deaktiviert
- keine eigenen Code-Anpassungen an der Erweiterung
Für die Analyse benötigen wir:
- Uneingeschränkten Admin-Zugriff
- Ggf. zusätzlich SSH- oder Datenbankzugang
Wichtig: Einrichtung und Entfernung der Zugänge liegt in deiner Verantwortung. Zudem empfehlen wir für den Support eine Staging- oder Entwicklungsumgebung.
Wird festgestellt, dass die Ursache nicht in unserer Erweiterung liegt (z.B. Theme-Anpassungen, Drittanbieter-Plugins oder Serverkonfiguration), erfolgt eine weitere Analyse kostenpflichtig nach vorheriger Rücksprache.
Testversion
Bei der erstmaligen Miete kannst du unsere Erweiterung 30 Tage kostenlos testen. Nutze die Testphase, um alle Funktionen in Ruhe zu prüfen. Bei Fragen unterstützt dich unser Support-Team jederzeit gern.
Individuelle Anpassungen
Du brauchst eine individuelle Erweiterung oder Anpassung? Wir helfen dir gerne weiter:
- info@lenz-ebusiness.de – mit kurzer Beschreibung deiner Anforderung
- Oder direkt Termin buchen unter: https://lenz-ebusiness.de/kontakt/
Features
Neue Features und Erweiterungen entwickeln wir stets auf Basis der jeweils aktuellen Shopware-Version. Alle beschriebenen Funktionen beziehen sich immer auf die neuste Version der jeweiligen Erweiterung.
Haftungssauschluss
Unsere Erweiterungen werden sorgfältig entwickelt und regelmäßig aktualisiert. Dennoch übernehmen wir keine Gewährleistung für einen jederzeit fehlerfreien Betrieb, da Shop-Konfigurationen, Serverumgebungen oder Drittanbieter-Erweiterungen individuelle Einflüsse haben können.
Wir haften nicht für Schäden, sofern diese nicht auf vorsätzlichem oder grob fahrlässigem Verhalten unsererseits beruhen. Bitte prüfe vor Updates stets die Systemvoraussetzungen und die Kompatibilität in deiner Shopumgebung.
Transparenz
Offene und transparente Kommunikation ist uns wichtig. Dein Feedback hilft uns dabei, unsere Erweiterungen kontinuierlich zu verbessern.
Wenn du zufrieden bist, freuen wir uns über eine positive Bewertung – sie hilft uns und auch anderen Shopbetreibern gleichermaßen.
Weitere Informationen zu unseren Erweiterungen findest Du in unserer Dokumentation: https://docs.lenz-ebusiness.de/
Details
- Verfügbar in: Englisch, Deutsch
- Zuletzt aktualisiert: 5. Februar 2026
- Veröffentlicht: 17. März 2020
- Version: 7.0.12
- Kategorie: B2B-Erweiterungen
Ressourcen
Bewertungen (3)
kaum ein Kunde schafft es durch die Prüfung. Dafür sehr teuer
Viele meiner EU Kunden scheitern an der Prüfung. Maximaler Ärger und manuelle Nacharbeit
Die empfohlenen Grundeinstellungen waren komplett unbrauchbar.
Der Log: nur für Programmierer verständlich. Wo sehe ich auf einen Blick woran die Prüfung gescheitert ist?
Immerhin ist der Support sehr geduldig.
Plugin mit gutem Support
sehr nützlich
Über den Extension Partner
LENZ eBusiness GmbH
Partner Status
-
Shopware
Bronze Partner -
Shopware
Premium Extension Partner
Details
- Ø-Bewertung: 4.9
- Partner seit: 2014
- Erweiterungen: 87
- Zertifizierungen: Zertifizierungen
Support
- Land: Germany
- Spricht: Deutsch, Englisch
- Reaktionszeit: Sehr schnell