Dieser Abschnitt steuert die Schnittstellenkonfiguration, wie auf Ausfälle reagiert wird und ob weitere länderspezifische Schnittstellen genutzt werden. Alle Felder finden Sie unter Stores → Configuration → (Sales) EU VAT Enhanced.
Interface-Einstellungen
- Aktivieren Sie die Funktionalität des VAT-Feldes (
enable_vat_validation, Standard: Ja): Aktiviert bzw. deaktiviert sämtliche Validierungsfunktionen. Bei „Nein" werden Nummern weder online noch syntaktisch geprüft. - Offline-Prüfung Fallback (
use_offline_validation, Standard: Nein): Akzeptiert eine USt-IdNr. als gültig, sofern die Syntax korrekt ist, die Schnittstelle aber nicht erreichbar ist (offline, Mitgliedsstaat offline oder Zeitüberschreitung). Die Nummer kann später automatisch online nachgeprüft werden. - Offline-Prüfung Länder (
offline_validation_countries, Standard: alle EU-Länder): Beschränkt den Offline-Fallback auf die ausgewählten Länder. Sichtbar nur, wenn der Fallback aktiviert ist. - Absender der Benachrichtigung (
offline_notification_sender, Standard: General Contact): Absender-Identität für die E-Mail-Benachrichtigung, wenn eine USt-IdNr. über den Offline-Fallback genehmigt wurde. - Empfänger-E-Mail der Benachrichtigung (
offline_notification_recipient, Standard: leer): Empfänger dieser Benachrichtigung. Leer lassen, um sie zu deaktivieren.
Diese Offline-Einstellungen sind im Admin unter „General Interface Settings" in der einklappbaren Untergruppe Offline-Prüfung Fallback zusammengefasst. Wird eine Bestellung mit einer nur über den Offline-Fallback als gültig akzeptierten USt-IdNr. aufgegeben, versendet das Modul eine E-Mail an den konfigurierten Empfänger (Betreff „Bestellung <Nr.>: USt-IdNr. über Offline-Fallback genehmigt"), damit sie vor Versand und Fakturierung manuell geprüft werden kann. Ohne hinterlegten Empfänger wird keine E-Mail versendet.
Die VIES/MIAS-Schnittstelle arbeitet als Proxy zu den nationalen Registern; einige Länder haben eine schlechtere Verfügbarkeit als andere. Wählen Sie unter „Offline-Prüfung Länder" am besten nur Länder aus, für die Sie konkrete Verfügbarkeitsprobleme kennen, statt pauschal alle.
Solange der Prüfdienst für ein hier gewähltes Land ausfällt, gilt jede syntaktisch gültige Nummer dieses Landes als gültig – der Kunde erhält dann (temporär) eine Steuerbefreiung/Reverse-Charge, obwohl VIES die Nummer nie bestätigt hat; eine spätere Revalidierung kann sie als ungültig markieren. Möchten Sie für ein Land verlässlich die lokale Steuer auf nicht bestätigte Nummern berechnen, führen Sie es nicht hier, sondern unter Syntaktisch gültige USt-IdNr. für diese Länder akzeptieren.
VIES Interface
Die EU-weite Prüfung erfolgt über VIES (in Deutschland als MIAS bezeichnet). Aktuell ist VIES die einzige implementierte Schnittstelle.
- SOAP Service URL (
soap_url, Standard:https://ec.europa.eu/taxation_customs/vies/services/checkVatService.wsdl): Endpunkt des VIES-SOAP-Dienstes. Ändern Sie diesen Wert nur, wenn sich die offizielle URL nachweislich geändert hat. Das Feld lässt sich über „Standard verwenden" zurücksetzen. - Wiederholungsanzahl (
retry_count, Standard: 3): Schlägt eine Anfrage wegen Nichtverfügbarkeit fehl, wird die Validierung mit exponentiellem Backoff (Basisverzögerung 1 Sekunde) wiederholt. Empfohlen ist 3. Werte über 5 sind nicht zu empfehlen, da sie zu langen Wartezeiten für den Kunden führen. - IPv6-Kompatibilität (
ip_compat, Standard: Nein): Bindet die ausgehende Anfrage an Ihre IPv4- statt an Ihre IPv6-Adresse. Aktivieren Sie diese Option, wenn es Verbindungsprobleme mit VIES gibt – einige Schnittstellen haben weiterhin Probleme mit IPv6. - IPv4-Adresse Ihres Servers (
ipv4_address): Die zu verwendende IPv4-Adresse (z. B.192.168.100.10). Sichtbar und erforderlich nur bei aktivierter IPv6-Kompatibilität; das Feld wird auf eine gültige IPv4-Adresse validiert.
USt-IdNr. des Antragstellers
- USt-IdNr. des Antragstellers (
requester_vat_number, im Abschnitt Umsatzsteuer Einstellungen): Ihre eigene USt-IdNr. Sie muss zum konfigurierten Inland gehören und wird bei jeder Prüfanfrage mitgesendet. VIES gibt dann eine Anforderungskennung (request identifier) zurück – einen Nachweis, dass der Antragsteller die Nummer zu einem bestimmten Zeitpunkt geprüft hat.
Ob die Anforderungskennung in Ihrem lokalen Steuerrecht als gültiger Nachweis gilt, klären Sie bitte mit Ihrem Steuerberater.
Norwegen-Schnittstelle
Optionale Behandlung Norwegens (MVA) als EU-äquivalentes Land für das Reverse-Charge-Verfahren.
- Norwegische MVA-Behandlung aktivieren (
norway_settings/enabled, Standard: Nein): Behandelt Norwegen für Reverse-Charge wie ein EU-Land und prüft norwegische MVA-Nummern gegen das Brønnøysund Enhetsregisteret. - Brønnøysund-Service-URL (
norway_settings/service_url, Standard:https://data.brreg.no/enhetsregisteret/api/enheter/): Endpunkt des norwegischen Registers. Sichtbar nur bei aktivierter Norwegen-Behandlung; über „Standard verwenden" zurücksetzbar.
Damit für Norwegen tatsächlich der korrekte Satz bzw. Reverse-Charge greift, müssen die übrigen steuerlichen Voraussetzungen (Steuerregel/-satz, dynamische Steuerklasse) wie unter Steuerklassen & Berechnung beschrieben erfüllt sein.