Allgemein

Die nachfolgenden Informationen richten sich insbesondere an interessierte Personen mit Programmierkenntnissen.

Die Implementierung der Schnittstelle ist in unterschiedlichen Programmiersprachen und auf unterschiedlichen Systemplattformen möglich. Der Transport der Daten erfolgt mit dem sicheren Übertragungsprotokoll HTTPS (TLS 1.2) und die Darstellung der übertragenen Daten geschieht in der Extensible Markup Language (XML). Weitere Informationen erhalten Sie auf der XML-RPC Homepage.

Die Anfragen (Requests) und Antworten (Responses) werden jeweils in Echtzeit an den entsprechenden EU-Mitgliedstaat geschickt. Die Aufbereitung der Anfragen erfolgt ebenfalls in Echtzeit. Es handelt sich um eine synchrone Kommunikation. Das heißt, dass nach jeder Anfrage sofort eine Antwort generiert wird. Es werden nur Einzelabfragen verarbeitet. Diese werden nacheinander abgearbeitet. Jede Anfrage erfordert eine Antwort.

Hier finden Sie Informationen zu:

Schnittstelle Aufruf

Nachfolgend finden Sie die für den Aufruf notwendigen Parameter:

Unabhängig von der Art der Bestätigung (einfach oder qualifiziert) sind immer alle Parameter anzugeben.
Welche Parameter für welche Bestätigung mit Werten zu übergeben sind, entnehmen Sie bitte der folgenden Tabelle:

HTTPS - Aufruf

(Bei diesen Beispielen wird kein gültiges Ergebnis produziert!)

Beispielsyntax für eine einfache Bestätigungsanfrage:

https://evatr.bff-online.de/evatrRPC?UstId_1=DE123456789&UstId_2=AB1234567890&Firmenname=&Ort=&PLZ=&Strasse=

Beispielsyntax für eine qualifizierte Bestätigungsanfrage mit Anforderung einer Bestätigungsmitteilung:

https://evatr.bff-online.de/evatrRPC?UstId_1=DE123456789&UstId_2=AB1234567890&Firmenname=Firmenname einschl. Rechtsform&Ort=Ort der Firma&PLZ=12345&Strasse=Strasse der Firma

Bei gewünschter SSL-Verschlüsselung ist das Hypertext Transfer Protocol Secure (HTTPS) zu verwenden.

Antwort - Aufbau

Werte für die Parameter Erg_Name, Erg_Ort, Erg_PLZ und Erg_StrFolgende Werte sind als Ergebnis möglich:

• A = stimmt überein
• B = stimmt nicht überein
• C = nicht angefragt
• D = vom EU-Mitgliedsstaat nicht mitgeteilt

Übersicht der ErrorCodes

Antwort - Beispiel

Das Ergebnis hat folgendes Format:

Datum 27.07.2006 Uhrzeit 13:35:53 ErrorCode 200 UstId_1 DE123456789 UstId_2 AB1234567890 Firmenname Firma XY Rechtsform Ort Firmenort PLZ 1234 Strasse Firmenstrasse Erg_Name A Erg_Ort A Erg_PLZ A Erg_Str A Gueltig_ab Gueltig_bis

<params>
<param>
<value><array><data>
<value><string>Datum</string></value>
<value><string>27.07.2006</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Uhrzeit</string></value>
<value><string>13:35:53</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>ErrorCode</string></value>
<value><string>200</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>UstId_1</string></value>
<value><string>DE123456789</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>UstId_2</string></value>
<value><string>AB1234567890</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Firmenname</string></value>
<value><string>Firma XY Rechtsform</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Ort</string></value>
<value><string>Firmenort</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>PLZ</string></value>
<value><string>1234</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Strasse</string></value>
<value><string>Firmenstrasse</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Erg_Name</string></value>
<value><string>A</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Erg_Ort</string></value>
<value><string>A</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Erg_PLZ</string></value>
<value><string>A</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Erg_Str</string></value>
<value><string>A</string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Gueltig_ab</string></value>
<value><string></string></value>
</data></array></value>
</param>
<param>
<value><array><data>
<value><string>Gueltig_bis</string></value>
<value><string></string></value>
</data></array></value>
</param>
</params>

Python - Beispiel

Nachfolgendes Beispiel ist in der Programmiersprache Python (Version 2.7) verfasst. Die entsprechenden Aufrufparameter müssen natürlich noch durch reale Werte ersetzt werden.

Als Basis wird die nachfolgende XML-RPC-Bibliothek genutzt:

import xmlrpclib

server_url = 'https://evatr.bff-online.de/'

server     = xmlrpclib.Server(server_url)

# daten zum testen

UstId_1    = 'DE123456789'

UstId_2    = 'AB123456789012'

Firmenname = 'Firmenname einschl. Rechtsform'

Ort        = 'Ort'

PLZ        = '1234567'

Strasse    = 'Strasse und Hausnummer' 

rpc = server.evatrRPC(UstId_1, UstId_2, Firmenname, Ort, PLZ, Strasse)

print rpc

Technische Hinweise

Ihre Bestätigungsabfrage läuft über das Internet und damit mehr oder weniger - von der Auslastung des Netzes und von den benutzen Verbindungen abhängig - schnell zum Bundeszentralamt für Steuern. Hier wird Ihre Anfrage maschinell bearbeitet und geprüft, ob alle Angaben richtig sind.

Ist dies der Fall, wird Ihre Anfrage über eine Netzwerkverbindung an den jeweiligen EU-Mitgliedstaat weitergeleitet. Dort wird eine weitere maschinelle Verarbeitung angestoßen und die Antwort zum Bundeszentralamt für Steuern zurückgesandt. Hier wird diese Antwort aufbereitet und zurück zu Ihnen geschickt.

Die Antwort auf eine von Ihnen gestartete, gültige Abfrage kann also, in Abhängigkeit von Ihrer Internetanbindung und der Antwortzeit des entsprechenden Mitgliedstaates, zwischen einigen Sekunden und mehreren Minuten dauern.