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.
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.
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.