Herzlich willkommen

USt-IdNr.-Feld

Diese Einstellungen steuern, wo und wie sich das USt-IdNr.-Eingabefeld im Frontend und im Adminbereich verhält. Sie liegen unter Stores → Configuration → (Sales) EU VAT Enhanced → Integration.

Integration
Integration

Feldvalidierung je Kontext

Für fünf Kontexte legen Sie unabhängig fest, wie streng das Feld geprüft wird:

  • Feldüberprüfung bei der Kundenregistrierung (field_validation_registration)
  • Feldüberprüfung bei Kundenadresse bearbeiten (field_validation_addressedit)
  • Feldüberprüfung beim Checkout (field_validation_checkout)
  • Field validation at Admin Customer Address Edit (field_validation_admin_address) – Admin-Adressbearbeitung (im Admin nicht übersetzt)
  • Field validation at Admin Sales Order Create (field_validation_admin_order) – Admin-Bestellanlage (im Admin nicht übersetzt)

Alle fünf nutzen dieselben Optionen (Standard jeweils: Optional, erfordert aber beim Ausfüllen eine gültige USt-IdNr.):

Wert Option (Admin-Bezeichnung)
(leer) Optional
valid-vat-if-specified Optional, erfordert aber beim Ausfüllen eine gültige USt-IdNr.
valid-vat-required Sie benötigen eine gültige USt-IdNr. (validiert durch den Prüfungsdienst)
valid-vat-if-company-specified Verlangt eine gültige USt-IdNr., wenn das Feld Unternehmen ausgefüllt ist
required-entry Erforderlich (akzeptiert jeden Wert)

Die Option valid-vat-if-company-specified wird beim Abschluss der Bestellung zusätzlich auf der effektiven Rechnungsadresse erzwungen – ist ein Firmenname gesetzt, muss eine gültige USt-IdNr. vorliegen.

Sichtbarkeit des Feldes

  • Feld für die USt-IdNr. bei der Versandadresse ausblenden (hide_on_shipping, Standard: Nein)
  • Hide the VAT ID field on the billing address (hide_on_billing, Standard: Nein) – Feld auf der Rechnungsadresse ausblenden (im Admin nicht übersetzt).
  • Feld USt-IdNr. sichtbar für diese Länder (visible_countries, Standard: alle EU-Länder): Für welche Länder das Feld angezeigt wird. Es erscheinen nur Länder, die unter Stores → Configuration → General → Countries Options als „Allow Countries" konfiguriert sind.
  • Nummern aus diesen Ländern nicht prüfen (disable_validation_countries): Für die ausgewählten Länder findet keine Validierung statt; die obigen Feldvalidierungsoptionen greifen dort nicht – die Nummer wird ungeprüft übernommen (das Feld wirkt dort effektiv wie Optional).
  • Syntaktisch gültige USt-IdNr. für diese Länder akzeptieren (accept_syntactically_valid_countries, Standard: leer): Für die ausgewählten Länder wird eine syntaktisch gültige USt-IdNr. auch dann durch die „gültige USt-IdNr. erforderlich"-Prüfungen gelassen, wenn der Prüfdienst (VIES) sie als ungültig meldet. Anders als bei Nummern aus diesen Ländern nicht prüfen bleiben Pflicht und Syntaxprüfung erhalten (leere oder syntaktisch falsche Eingaben werden weiter abgelehnt). Die Bestellung kommt zustande, es wird jedoch die lokale Steuer berechnet – eine Steuerbefreiung (Reverse-Charge) erfolgt weiterhin nur bei einer vom Prüfdienst bestätigt gültigen Nummer. Die Zuordnung erfolgt über das Land der Adresse. Primär gedacht für inländische Nummern (Präfix = Land des Kunden), die national gültig, aber nicht für innergemeinschaftliche Umsätze registriert sind (z. B. bestimmte Schulen, Vereine, Organisationen). Gilt für jedes ausgewählte Land.

Führen Sie hier gewählte Länder möglichst nicht zusätzlich unter Offline-Prüfung Länder auf – fällt der Prüfdienst aus, behandelt der Offline-Fallback dieselben Nummern (temporär) als gültig und gewährt eine Steuerbefreiung statt der lokalen Steuer.

Erscheinungsbild

  • Feld USt-IdNr. Tooltip (field_tooltip, Standard: leer): Hilfetext am Feld. Leerer Wert deaktiviert den Tooltip.
  • Feld USt-IdNr. Platzhalter (field_placeholder, Standard: leer): Platzhaltertext im Feld. Leerer Wert deaktiviert den Platzhalter.
  • Verzögerung im Feld USt-IdNr. (field_delay, Standard: 3000 ms): Wartezeit, bevor die Eingabe während des Tippens geprüft wird (1000 ms = 1 Sekunde).

Verhalten

  • Kunde fragen, ob das Adressland automatisch angepasst werden soll (ask_customer_country_correction, Standard: Ja): Weicht das Land der USt-IdNr. vom gewählten Land ab, fragt ein Bestätigungs-Popup, ob das Land entsprechend dem USt-IdNr.-Präfix gesetzt werden soll. Das vermeidet Fehler, wenn das Standardland nicht geändert wurde.
  • Aktivieren Sie Adressfelder auf der Registrierungsseite (show_address_on_regpage, Standard: Nein): Zeigt zusätzlich zur USt-IdNr. die Adressfelder auf der Registrierungsseite, sodass Kunden bei der Registrierung direkt der passenden Gruppe zugeordnet werden können. Das Feld erscheint nur, wenn die USt-IdNr.-Validierung aktiviert ist – andernfalls muss es manuell ins Formular eingebunden werden.

Damit das USt-IdNr.-Feld (vat_id) im Frontend überhaupt erscheint, muss es in der Kundenkonfiguration aktiviert sein. Details und die Abgrenzung zum taxvat-Feld finden Sie unter Fehlersuche → Korrekte Verwendung des USt-Nummernfeldes.