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.

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.