Anwendung Modul “USt-IdNr Prüfung”


Anwendung

Auf dieser Seite finden Sie das Benutzerhandbuch zum Modul “USt-IdNr Prüfung”.

Das Modul “USt-IdNr Prüfung” ist unterteilt in zwei Bereiche. Der Einzelabfrage und der Stapelverarbeitung.

ID Validation Hauptfenster

Einzelabfrage

Die Einzelprüfung ermöglicht es, mit der Eingabe der relevanten Daten eine Prüfung unmittelbar auszuführen. Als Mindestangaben die zu prüfende USt-IdNr anzugeben. Dabei wird eine einfache Abfrage durchgeführt.

Für eine qualifizierte Prüfung können Sie die optionalen Felder Firmenname, Straße, Postleitzahl und Ort angeben.

Um eine schriftliche Bestätigung zu erhalten (diese wird direkt vom Bundeszentralamt für Steuern versandt), können Sie die Option „gedruckte Bestätigung über BZSt“ aktivieren.

Bei der Einzelabfrage findet keine Ausgabe der Prüfergebnisse in eine Datei statt. Diese Anwendungssicht dient zur schnellen Prüfung, z.B. bei der Durchgabe von USt-IdNrn. per Telefon, um diese auf Ihre Gültigkeit zu prüfen. Die Verarbeitung von Dateien werden über die Stapelverarbeitung oder der Hintergrundverarbeitung durchgeführt.

Stapelverarbeitung

Wählen Sie eine Datei aus und prüfen Sie diese durch das Betätigen des “Prüfen-Button”. Dadurch startet die Überprüfung der gesamten Datei. Diese erzeugt im Hintergrund das Protokoll. Das Protokoll kann im Anschluss über den Protokoll-Button geöffnet werden. Dieses beinhaltet alle Prüfergebnisse, der einzelnen Datensätze. Der Vorgang der Überprüfung nimmt je nach Größe der Datei einige Zeit in Anspruch. Auf den Aufbau der Importdatei (CSV) wird im nächsten Abschnitt genauer eingegangen.

Hinweise zu qualifizierten Abfragen

Stimmen bei einer qualifizierten Abfrage Daten der Adresse (Firmenname, Ort, Postleitzahl oder Straße) nicht überein, wird automatisch eine einfache Abfrage durchgeführt. Um bei gültigen Rückmeldungen dennoch die Information zu erhalten, ob Werte nicht übereinstimmen könnten, wird am Ende des jeweiligen Prüfdatensatzes die entsprechende Information angehängt, sofern aus den qualifizierten Angaben eine Prüfung negativ rückgemeldet wurde.

Importdateien

CSV

Durch die Verwendung einer einfachen CSV-Datei bietet Ihnen das Modul “USt-IdNr Prüfung” eine Möglichkeit, Ihren gesamten Datenbestand zu überprüfen.

Wir achten darauf, dass bei der Erweiterung der Schnittstellen die Kompatibilität gewahrt bleibt.

Um die Zugehörigkeit der einzelnen Datensätze in Ihre Stammdaten zu gewährleisten, haben Sie die Möglichkeit, bis zu zwei eindeutige Schlüssel in der Importdatei anzugeben. Diese werden in der Exportdatei wieder zurückgegeben.

Das Standard-Trennzeichen der einzelnen Elemente ist das ‚|‘-Zeichen (pipe). Dieses kann über die Einstellungen geändert werden. Fettgedruckte Feldnamen sind Pflichtfelder (das Trennzeichen über Einstellungen änderbar). Bitte beachten Sie, dass alle Felder in der Importdatei angegeben werden müssen, auch wenn Sie nur eine einfache Abfrage durchführen möchten.

Aufbau – Importdatei

Feld Format Beispiel
Schluessel_1 String 4711
Schluessel_2 String 2
Eigene USt-IdNr String DE123456789
Fremde USt-IdNr String AT12345678
Firmenname String
Ort String
Postleitzahl String
Strasse String
Druck String (ja/nein) nein

Beispiel in Form einer CSV-Datei: 4711|2|DE123456789|AT12345678|||||nein … (weitere USt-IdNr Prüfungen)

Hinweis

Bitte achten Sie bei dem Erstellen des Importes auf die korrekte Anzahl Spalten. Die CSV Datei darf keine weiteren Spalten nach der „Druck“ Spalte enthalten.

Aufbau – Exportdatei

Die Exportdatei beinhaltet die zurückgegebenen Werte der einzelnen Abfragen.

Feld Format Beispiel
Schluessel_1 String 4711
Schluessel_2 String 2
Eigene USt-IdNr String DE123456789
Fremde USt-IdNr String AT12345678
ErgebnisCode String 200
ErgebnisText String Die angefragte USt-IdNr. ist gültig.
gueltig_ab Datum, tt.mm.jjjj
gueltig_bis Datum, tt.mm.jjjj
Qualifizierte Rückmeldung String
Zeitstempel Datum + Uhrzeit 2019-11-05 14:35:43

Beispiel in Form einer CSV-Datei (mit Standard-Trennzeichen):

4711|2|DE123456789|AT12345678|200|Die angefragte USt-IdNr. ist gültig.|||2019-11-05 14:35:43

Rückgabewerte BZSt

Die Rückgabewerte werden über das Menü “Extras – Rückgabewerte USt-IdNr” angezeigt und bearbeitet. Die Bezeichnung und Nummer hängt vom BZSt ab. Einige systemische Rückgabewerte werden direkt durch die “USt-IdNr Prüfung” ausgegeben. Diese sind im 900er Nummernkreis. Weitere Informationen findet man in der Übersicht der Ergebniscodes.

Zusätzlich zu den Standardrückgabewerten besteht die Möglichkeit Bearbeitungshinweise zu erfassen. Diese sind beispielsweise für eine Integration in einen Workflow hilfreich. Damit erhält der Sachbearbeiter bei der Bearbeitung der Rückgabewerte eine Hilfestellung.

ID Validation Rückgabewerte BZSt

Die Beschreibung der Rückgabewerte des BZSt ist nicht änderbar. Bei jedem Start des Programmes werden die Rückgabewerte zurückgesetzt. Ihre Bearbeitungshinweise bleiben dabei erhalten.

Platzhalter in Bearbeitungshinweisen

Damit Sie einen Hinweis zur Bearbeitung mit Werten aus der jeweiligen Abfrage anreichern können, wird ein Platzhalter mit einem Doppelklick darauf eingefügt. Die Auswahl der Platzhalter (sogenannten Textmarker) zeigt Ihnen die Übersicht der Variablen. Diese besitzen nicht immer einen Wert. Dieses hängt maßgeblich von den importierten Daten und den Rückgabewerten des BZSt ab.

Rückgabewerte VIES

Die Schnittstelle VIES/MIAS gibt einen geringeren Umfang an möglichen Rückgabewerten. Prinzipiell wird nur „gültig“ oder „ungültig“ zurückgegeben. Im Falle von Schnittstellenfehlern haben Sie jedoch die Möglichkeit, Bearbeitungshinweise zu erfassen.

ID Validation Rückgabewerte VIES

Rohdaten-Viewer

Über das Menü Extras - USt-IdNr Rohdaten Viewer können Sie das Archiv durchsuchen. Geben Sie dazu die gewünschte USt-IdNr ein und betätigen Sie die Suchen-Schaltfläche. Alle Einträge werden Ihnen in der Ergebnisansicht bereitgestellt. Um einen Eintrag sich genauer ansehen zu können, klicken Sie in der Liste der gefundenen Einträge auf den gewünschten Eintrag. Es werden Ihnen die Abfragezeit, der original Request-String, die Antwortzeit des BZSt/VIES und die Original-Antwort angezeigt. Damit können Sie genau die Auskunft bekommen, wann eine USt-IdNr mit welchem Ergebnis abgefragt wurde.

ID Validation Rohdaten Viewer

Um die Echtheit eines Datensatzes zu gewährleisten, haben wir einen sog. MD5-Hash erzeugt. Damit können wir die Echtheit und den Schutz vor Manipulationen in den Dateien prüfen.

Sobald ein Datensatz nicht der Prüfsumme entspricht, wird dieses mit dem Zusatz “(Fehler)” angezeigt.

Konfigurationsdateien

Die Konfigurationsdateien werden im json-Format gespeichert und können auch manuell bearbeitet werden. Solange Sie ausschließlich die grafische Oberfläche verwenden, sollten Sie mit diesen Dateien selten in Berührung kommen.

Verwenden Sie bitte nur Editoren, die eine Syntaxprüfung durchführen können, um Fehlfunktionen zu vermeiden. Wir empfehlen stets die Oberfläche für die Konfiguration zu verwenden.

Ergebniscodes (Stand 14.06.2020)

Code Beschreibung
200 Die angefragte USt-IdNr. ist gültig.
201 Die angefragte USt-IdNr. ist ungültig.
202 Die angefragte USt-IdNr. ist ungültig. Sie ist nicht in der Unternehmerdatei des betreffenden EU-Mitgliedstaates registriert.Hinweis: Ihr Geschäftspartner kann seine gültige USt-IdNr. bei der für ihn zuständigen Finanzbehörde in Erfahrung bringen. Möglicherweise muss er einen Antrag stellen, damit seine USt-IdNr. in die Datenbank aufgenommen wird.
203 Die angefragte USt-IdNr. ist ungültig. Sie ist erst ab dem … gültig.
204 Die angefragte USt-IdNr. ist ungültig. Sie war im Zeitraum von … bis … gültig.
205 Ihre Anfrage kann derzeit durch den angefragten EU-Mitgliedstaat oder aus anderen Gründen nicht beantwortet werden. Bitte versuchen Sie es später noch einmal. Bei wiederholten Problemen wenden Sie sich bitte an das Bundeszentralamt für Steuern – Dienstsitz Saarlouis.
206 Ihre deutsche USt-IdNr. ist ungültig. Eine Bestätigungsanfrage ist daher nicht möglich. Den Grund hierfür können Sie beim Bundeszentralamt für Steuern – Dienstsitz Saarlouis – erfragen.
207 Ihnen wurde die deutsche USt-IdNr. ausschließlich zu Zwecken der Besteuerung desinnergemeinschaftlichen Erwerbs erteilt. Sie sind somit nicht berechtigt, Bestätigungsanfragen zu stellen.
208 Für die von Ihnen angefragte USt-IdNr. läuft gerade eine Anfrage von einem anderen Nutzer. Eine Bearbeitung ist daher nicht möglich. Bitte versuchen Sie es später noch einmal.
209 Die angefragte USt-IdNr. ist ungültig. Sie entspricht nicht dem Aufbau, der für diesen EU-Mitgliedstaat gilt.
210 Die angefragte USt-IdNr. ist ungültig. Sie entspricht nicht den Prüfziffernregeln, die für diesen EU Mitgliedstaat gelten.
211 Die angefragte USt-IdNr. ist ungültig. Sie enthält unzulässige Zeichen.
212 Die angefragte USt-IdNr. ist ungültig. Sie enthält ein unzulässiges Länderkennzeichen.
213 Die Abfrage einer deutschen USt-IdNr. ist nicht möglich.
214 Ihre deutsche USt-IdNr. ist fehlerhaft. Sie beginnt mit ‘DE’ gefolgt von 9 Ziffern.
215 Ihre Anfrage enthält nicht alle notwendigen Angaben für eine einfache Bestätigungsanfrage (Ihre deutsche USt-IdNr. und die ausl. USt-IdNr.). Ihre Anfrage kann deshalb nicht bearbeitet werden.
216 Ihre Anfrage enthält nicht alle notwendigen Angaben für eine qualifizierte Bestätigungsanfrage (Ihre deutsche USt-IdNr., die ausl. USt-IdNr., Firmenname einschl. Rechtsform und Ort). Es wurde eine einfache Bestätigungsanfrage durchgeführt mit folgendem Ergebnis: Die angefragte USt-IdNr. ist gültig.
217 Bei der Verarbeitung der Daten aus dem angefragten EU-Mitgliedstaat ist ein Fehler aufgetreten. Ihre Anfrage kann deshalb nicht bearbeitet werden.
218 Eine qualifizierte Bestätigung ist zurzeit nicht möglich. Es wurde eine einfache Bestätigungsanfrage mit folgendem Ergebnis durchgeführt: Die angefragte USt-IdNr. ist gültig.
219 Bei der Durchführung der qualifizierten Bestätigungsanfrage ist ein Fehler aufgetreten. Es wurde eine einfache Bestätigungsanfrage mit folgendem Ergebnis durchgeführt: Die angefragte USt-IdNr. ist gültig.
220 Bei der Anforderung der amtlichen Bestätigungsmitteilung ist ein Fehler aufgetreten. Sie werden kein Schreiben erhalten.
221 Die Anfragedaten enthalten nicht alle notwendigen Parameter oder einen ungültigen Datentyp.
900 Die geprüfte USt-IdNr. ist gültig, die übergebenen Daten für die qualifizierte Abfrage sind jedoch nicht korrekt.
997 Bitte stellen Sie sicher, dass alle USt-IdNr. in Großbuchstaben erfasst sind.
998 Eine Bearbeitung Ihrer Anfrage ist zurzeit nicht möglich. Bitte versuchen Sie es später noch einmal.
999 Eine Bearbeitung Ihrer Anfrage ist zurzeit nicht möglich. Bitte versuchen Sie es später noch einmal. Der Fehlercode 999 wird ebenfalls verwendet, um bei der automatischen Prüfung (Start-Parameter „-auto“) ggf. Fehlermeldungen anzuzeigen.