Table of Contents

Einrichtung

Dieser Abschnitt beschreibt die Voraussetzungen und die Konfiguration der VAT ID Check App. Nach der Installation sind sinnvolle Standardwerte bereits gesetzt – Sie müssen im Wesentlichen nur die eigene USt-IdNr. hinterlegen und die App aktivieren.

Voraussetzungen

Für die qualifizierte BZSt-Abfrage müssen folgende Angaben gepflegt sein:

  1. Eigene USt-IdNr. in den Firmendaten (Company Information → Feld USt-IdNr.). Das BZSt verlangt die anfragende USt-IdNr. als Absender jeder Abfrage – ohne sie ist keine Prüfung möglich.
  2. Länder-/Regionscodes der zu prüfenden Geschäftspartner müssen gepflegt und für EU-Länder mit einem EU-Ländercode versehen sein (Länder/Regionen). Nicht-EU-Nummern werden nicht geprüft.
Important

Das BZSt bestätigt nur ausländische EU-USt-IdNrn. Ihre eigene (inländische) USt-IdNr. sowie inländische Debitoren/Kreditoren werden bewusst übersprungen (siehe Ländercode für Inland).

Tip

📷 Screenshot-Platzhalter: Die Firmendaten mit gepflegter eigener USt-IdNr. → Bild speichern als images/einrichtung-firmendaten.png, dann diesen Hinweis durch ![Eigene USt-IdNr. in den Firmendaten](images/einrichtung-firmendaten.png) ersetzen.

Einrichtungsseite öffnen

Die App erweitert die Standard-Einrichtung des USt-IdNr.-Prüfdienstes. Sie erreichen die Seite über:

  • Suche (Alt+Q) → „USt-IdNr.-Prüfdienst einrichten" bzw. „VAT Registration Config", oder
  • das Rollencenter „USt-IdNr.-Prüfung" → Aktion Einrichtung.
Tip

📷 Screenshot-Platzhalter: Die Einrichtungsseite mit den BZSt- und Prüfeinstellungen. → Bild speichern als images/einrichtung-config.png, dann diesen Hinweis durch ![Einrichtung der USt-IdNr.-Prüfung](images/einrichtung-config.png) ersetzen.

Einstellungen im Überblick

BZSt-Verbindung

Feld Bedeutung
Aktiviert Schaltet die Prüfung und die FactBoxen ein. Ohne Aktivierung bleibt die App inaktiv.
BZSt-API-Endpunkt REST-Endpunkt des eVATR-Verfahrens. Standard: https://api.evatr.vies.bzst.de/app/v1/abfrage. Nur bei Vorgabe des BZSt ändern.
Zeitlimit für Anfragen (Sekunden) Timeout je Anfrage. Standard: 30.
Wiederholungsanzahl Anzahl der Wiederholungen bei vorübergehenden Fehlern. Standard: 3.
Wartezeit bis zum erneuten Versuch (Sekunden) Pause zwischen den Versuchen. Standard: 5.

Mit der Aktion BZSt-Verbindung testen prüfen Sie die Erreichbarkeit des Dienstes.

Prüfverhalten

Feld Bedeutung
Gültigkeitsdauer Datumsformel (z. B. 3M), nach der ein Ergebnis abläuft und erneut geprüft werden sollte. Leer = läuft nie ab.
Ländercode für Inland Ihr eigenes Land (Standard: DE). USt-IdNrn., die mit diesem Code beginnen, gelten als inländisch.
Inländische USt-IdNrn. überspringen Überspringt inländische Nummern, da der Bestätigungsdienst nur ausländische EU-Nummern prüfen kann.
Ergebnis auf zugehörige Datensätze übertragen Kopiert ein Ergebnis auf verknüpfte Debitoren/Kreditoren/Kontakte (über Geschäftsbeziehungen), damit dieselbe USt-IdNr. nicht mehrfach geprüft werden muss.

Belegsperren

Steuern, ob und wann Belege bei einer nicht gültigen USt-IdNr. gesperrt werden:

Feld Bedeutung
Freigabe bei ungültiger USt-IdNr. sperren Blockiert die Freigabe eines Belegs, wenn die Nummer ungültig ist.
Freigabe bei Abweichung sperren Blockiert die Freigabe bei einem Anschriften-Mismatch (gelbe Ampel). Standard: aus.
Genehmigung bei ungültiger USt-IdNr. sperren Blockiert den Genehmigungs-Workflow bei ungültiger Nummer.

Zusätzlich lässt sich die Freigabe-/Genehmigungssperre je Belegart (Angebot, Auftrag, Rechnung, Gutschrift, Rahmenauftrag, Reklamation – im Verkauf wie im Einkauf) fein steuern.

Note

Die Sperre greift auf Basis des gespeicherten Nummern-Status. Ein reiner Anschriften-Mismatch (gelb) sperrt nur, wenn Freigabe bei Abweichung sperren aktiv ist.

Sichtbarkeit der FactBox

Legen Sie je Seite fest, ob die USt-IdNr.-FactBox angezeigt wird (Debitoren-/Kreditoren-/Kontaktkarte und -liste sowie die einzelnen Belegseiten). So blenden Sie die FactBox dort aus, wo sie nicht benötigt wird.

Note

Bei Kontakten wird die FactBox nur für Unternehmenskontakte angezeigt, nicht für Personenkontakte – diese führen keine USt-IdNr.

Statusmeldungen aktualisieren

Die App führt einen Katalog der BZSt-Statusmeldungen (Ergebnis-, Hinweis- und Fehlercodes), damit Meldungen verständlich angezeigt werden. Der Katalog wird bei Bedarf automatisch (höchstens einmal täglich) aktualisiert. Über die Aktion Statusmeldungen aktualisieren im Rollencenter können Sie ihn manuell auffrischen.

Berechtigungen

Die App liefert drei Berechtigungssätze mit:

Berechtigungssatz Zweck
USt-IdNr.-Prüfung – Ansicht Lesen von Einrichtung, Protokoll und FactBoxen.
USt-IdNr.-Prüfung – Bearbeiten Prüfen, Ergebnisse und Belegverhalten nutzen.
USt-IdNr.-Prüfung – Einrichtung Konfiguration der App.

Weisen Sie diese den Benutzern entsprechend ihrer Rolle zu.