DataBox-Download-Webservice - Bundesministerium für Finanzen
DataBox-Download-Webservice - Bundesministerium für Finanzen
DataBox-Download-Webservice - Bundesministerium für Finanzen
Sie wollen auch ein ePaper? Erhöhen Sie die Reichweite Ihrer Titel.
YUMPU macht aus Druck-PDFs automatisch weboptimierte ePaper, die Google liebt.
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 1 von 9<br />
1 Einleitung<br />
<strong>DataBox</strong>-<strong>Download</strong>-<strong>Webservice</strong><br />
Die Einrichtung eines <strong>Webservice</strong>s richtet sich an Spezialisten. WSDL ist ein Standard <strong>für</strong><br />
<strong>Webservice</strong>s im Internet.<br />
Wir ersuchen daher um Verständnis, dass das BMF und die FinanzOnline-Hotline <strong>für</strong> die<br />
Lösung von technischen Problemen im Zusammenhang mit der Einrichtung des <strong>Webservice</strong>s<br />
nicht zur Verfügung stehen können.<br />
Der Aufruf des <strong>Webservice</strong>s kann aus Programmen auf nahezu jeder Plattform (z.B. Java)<br />
erfolgen.<br />
2 Beschreibung<br />
Voraussetzung <strong>für</strong> das <strong>Webservice</strong><br />
WSDL<br />
o Der Übermittler muss FinanzOnline Teilnehmer sein.<br />
o Der Teilnehmer muss in der Benutzerverwaltung einen Benutzer <strong>für</strong><br />
'<strong>Webservice</strong>s' anlegen.<br />
o Das <strong>Webservice</strong> muss mit diesem Benutzer verwendet werden.<br />
o Der <strong>Webservice</strong>-Benutzer hat alle Rechte des Teilnehmers.<br />
o Der <strong>Webservice</strong>-Benutzer kann im Online-Verfahren nicht verwendet werden.<br />
Die technische Beschreibung der <strong>Webservice</strong>s <strong>für</strong> FinanzOnline als WSDL ist unter<br />
https://finanzonline.bmf.gv.at/fon/wsdl/index.html erreichbar.<br />
<strong>Webservice</strong> – Url<br />
Für den Verbindungsaufbau wird das Zertifikat von FinanzOnline benötigt. Das<br />
Zertifikat kann im Internet-Explorer mit dem Zertifikatsexport-Assistenten<br />
heruntergeladen werden (FinanzOnline-Startseite aufrufen,<br />
Datei/Eigenschaften/Zertifikate/Details).<br />
Stand: 24.09.2012
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 2 von 9<br />
3 Ablauf<br />
3.1 Aufruf Session-<strong>Webservice</strong><br />
Das WSDL-Servicedokument <strong>für</strong> das Session-<strong>Webservice</strong> ist unter<br />
https://finanzonline.bmf.gv.at/fon/services/SessionWSI/wsdl/SessionWSIService.wsdl zu<br />
finden.<br />
Client tid, benid, pin -----------------------------------------------><br />
<br />
<br />
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 3 von 9<br />
Parameter belegen<br />
Die Parameter, um das <strong>Webservice</strong> zu starten, sind wie folgt zu belegen:<br />
string parameter:<br />
tid = 'Teilnehmercode'<br />
benid = 'Benutzer-Identifikation des <strong>Webservice</strong>-Benutzers'<br />
id = mit Methode 'login' ermittelte SessionID<br />
art = Art des <strong>DataBox</strong>-Inhalts; wird keine Art angegeben, werden alle<br />
ungelesenen behördlich zugestellten <strong>DataBox</strong>-Inhalte zurückgeliefert<br />
keine Einschränkung<br />
AE Amtshilfeersuchen Einheitswerte (nur <strong>für</strong> Notare)<br />
AF Amtshilfeersuchen Erledigung durch Finanzamt (nur <strong>für</strong><br />
Notare)<br />
AK Amtshilfeersuchen Kontoabfragen (nur <strong>für</strong> Notare)<br />
AZ Amtshilfeersuchen Abschluss (nur <strong>für</strong> Notare)<br />
B Bescheide, Ergänzungsersuchen und Bescheinigungen<br />
DL Dienstgeberbeitragslisten (nur <strong>für</strong> Gemeinden)<br />
E Prüfungsergebnisse (nur <strong>für</strong> Gemeinden)<br />
EU EU-Erledigungen<br />
FB Firmenbuchzustellungen (nur <strong>für</strong> Wirtschaftstreuhänder,<br />
Notare und Rechtsanwälte)<br />
GM Grundsteuermessbeträge<br />
I Informationen<br />
KG Kommunalsteuergrundlagen (nur <strong>für</strong> Gemeinden)<br />
M Mitteilungen<br />
P Protokolle<br />
QL Quotenlisten (nur <strong>für</strong> Parteienvertreter)<br />
SS Selbstberechnungserklärungen (nur <strong>für</strong> Wirtschaftstreuhänder,<br />
Notare und Rechtsanwälte)<br />
datvon Das Datum darf max. 31 Tage in der Vergangenheit liegen (nur<br />
bei Methode 'getDataboxByDate')<br />
datbis Das Datum darf max. 7 Tage nach 'datvon' liegen (nur bei<br />
Methode 'getDataboxByDate')<br />
Methode 'getDatabox' bzw. 'getDataboxExt' bzw. 'getDataboxByDate'<br />
aufrufen<br />
'getDatabox' und 'getDataboxExt' liefern nur ungelesene Databox-Inhalte. Der<br />
Unterschied der beiden Methoden liegt im Umfang der zurückgegebenen<br />
Daten. Bei der Methode 'getDataboxExt' wird zusätzlich das Feld 'FILEBEZ'<br />
zurückgegeben, das bei Protokollen auf Grund von Datenstromübermittlungen<br />
den Namen der übermittelten Datei enthält. Somit kann über das Feld<br />
'FILEBEZ' die Verbindung zwischen übermittelter Datei und Protokoll<br />
hergestellt werden.<br />
'getDataboxByDate' liefert gelesene und ungelesene Databox-Inhalte <strong>für</strong> den<br />
Zeitraum zwischen 'datvon' und 'datbis'. Bei dieser Methode wird zusätzlich<br />
das Feld 'STATUS' zurückgegeben, das angibt, ob der Inhalt ungelesen (' ')<br />
oder gelesen ('1') ist.<br />
Antwort auswerten<br />
Es wird ein Array von Objekten (siehe wsdl-Dokument) zurückgegeben<br />
Stand: 24.09.2012
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 4 von 9<br />
Parameter belegen<br />
Die Parameter, um das <strong>Webservice</strong> zu starten, sind wie folgt zu belegen:<br />
string parameter:<br />
tid = 'Teilnehmercode'<br />
benid = 'WS -Benutzer' der in der Benutzerverwaltung angelegt wurde<br />
id = von Methode 'login' zurückgegebene SessionID<br />
sid<br />
appl<br />
applkey<br />
fileart<br />
Methode 'getDataboxEntry' mit jedem Objekt aus dem von der Methode<br />
'getDatabox' zurückgegebenen Array aufrufen<br />
Antwort auswerten<br />
Es wird ein Base64-codierter String zurückgegeben<br />
3.1 Aufruf Session-<strong>Webservice</strong><br />
Das WSDL-Servicedokument <strong>für</strong> das Session-<strong>Webservice</strong> ist unter<br />
https://finanzonline.bmf.gv.at/fon/services/SessionWSI/wsdl/SessionWSIService.wsdl zu<br />
finden.<br />
Client id, tid, benid -------------------------------------------------><br />
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 5 von 9<br />
Alternativ zu den Methoden 'getDatabox' bzw. 'getDataboxExt', bei denen ein Array<br />
zurückgegeben wird, kann auch die Methode 'getDataboxXML' aufgerufen werden,<br />
welche die <strong>DataBox</strong>-Einträge als xml in einem String zurückgibt.<br />
Parameter belegen<br />
Die Parameter, um das <strong>Webservice</strong> zu starten, sind wie folgt zu belegen:<br />
string parameter:<br />
tid = 'Teilnehmercode'<br />
benid = 'WS -Benutzer' der in der Benutzerverwaltung angelegt wurde<br />
id = mit Methode 'login' ermittelte SessionID<br />
art = Art des <strong>DataBox</strong>-Inhalts; wird keine Art angegeben, werden alle<br />
ungelesenen behördlich zugestellten <strong>DataBox</strong>-Inhalte zurückgeliefert<br />
keine Einschränkung<br />
AE Amtshilfeersuchen Einheitswerte (nur <strong>für</strong> Notare)<br />
AF Amtshilfeersuchen Erledigung durch Finanzamt (nur <strong>für</strong><br />
Notare)<br />
AK Amtshilfeersuchen Kontoabfragen (nur <strong>für</strong> Notare)<br />
AZ Amtshilfeersuchen Abschluss (nur <strong>für</strong> Notare)<br />
B Bescheide, Ergänzungsersuchen und Bescheinigungen<br />
DL Dienstgeberbeitragslisten (nur <strong>für</strong> Gemeinden)<br />
E Prüfungsergebnisse (nur <strong>für</strong> Gemeinden)<br />
EU EU-Erledigungen<br />
FB Firmenbuchzustellungen (nur <strong>für</strong> Wirtschaftstreuhänder,<br />
Notare und Rechtsanwälte)<br />
GM Grundsteuermessbeträge<br />
I Informationen<br />
KG Kommunalsteuergrundlagen (nur <strong>für</strong> Gemeinden)<br />
M Mitteilungen<br />
P Protokolle<br />
QL Quotenlisten (nur <strong>für</strong> Parteienvertreter)<br />
SS Selbstberechnungserklärungen (nur <strong>für</strong> Wirtschaftstreuhänder,<br />
Notare und Rechtsanwälte)<br />
Methode 'getDataboxXML' aufrufen<br />
Antwort auswerten<br />
Es wird ein string der <strong>DataBox</strong>-Einträge im xml-Format zurückgegeben. Folgende<br />
tags werden übertragen:<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
Stand: 24.09.2012
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 6 von 9<br />
4 Fehlercodes<br />
Bei einem Fehler im <strong>Webservice</strong> wird eine SOAP-Exception ausgelöst. Der oder die<br />
aufgetretenen Fehlercodes befinden sich im Detail-String (2stellig, durch Strichpunkt<br />
getrennt).<br />
Bedeutung der Fehlercodes:<br />
01 - Die Art darf nur 2stellig und alphanumerisch sein<br />
02 - Die Zeitraumsfelder wurden nicht korrekt übergeben<br />
03 - 'datvon' und 'datbis' müssen angegeben werden<br />
04 - 'datvon' darf nicht größer als 'datbis' sein<br />
05 - 'datvon' darf nicht größer als das aktuelle Datum sein<br />
06 - 'datbis' darf nicht größer als das aktuelle Datum sein<br />
07 - 'datvon' darf nicht kleiner als das aktuelle Datum – 31 Tage sein<br />
08 - 'datbis' darf nicht größer als 'datvon' + 7 Tage sein<br />
Stand: 24.09.2012
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 7 von 9<br />
5 Liste der Anbringen<br />
Art Anbringen Text<br />
AE AHEEW Einheitswertinformation-AHE<br />
AF AHEFA AHE-Nachlass<br />
AK AHEKO Kontoinformation-AHE<br />
AZ AHEZU AHE-Nachlass Abschluss<br />
B 90a Bescheid gem. § 90a BAO<br />
B 90aWI Bescheid gem. § 90a BAO<br />
BEGLEIT Begleitbrief<br />
B BPBERI Lohnsteuerprüfungsbericht<br />
B BPBESCH Haftungs- und Abgabenbescheid<br />
BPRMVERZ Rechtsmittelverzicht zum Verkürzungszuschlag<br />
BPVKZBER Verkürzungszuschlagsbescheid<br />
B E1 Einkommensteuerbescheid<br />
B E3 Einkommensteuerbescheid<br />
B E5 Einkommensteuerbescheid<br />
B E6 Feststellungsbescheid der Einkünfte von Personengesellschaften<br />
B E7 Einkommensteuerbescheid<br />
B EVZ Einkommensteuervorauszahlungsbescheid<br />
B FBB Freibetragsbescheid<br />
M FBBEST Bestätigung über den Bezug der Familienbeihilfe<br />
B FGM Feststellungsbescheid Gruppenmitglied<br />
B FGT Feststellungsbescheid Gruppenträger<br />
FSU Bescheid über die Festsetzung von Umsatzsteuer<br />
B G1 Gruppenfeststellungsbescheid<br />
B GK Körperschaftsteuerbescheid Gruppe<br />
B K1 Körperschaftsteuerbescheid<br />
B K2 Körperschaftsteuerbescheid<br />
B K3 Körperschaftsteuerbescheid<br />
B KVZ Körperschaftsteuervorauszahlungsbescheid<br />
B L1 Einkommensteuerbescheid<br />
L1BE Einkommensteuerbescheid (beschränkte Steuerpflicht)<br />
B MKZ Mehrkindzuschlagsbescheid<br />
RAAUS Rückstandsbescheinigung gemäß § 229a BAO<br />
STAB Stabilitätsabgabebescheid<br />
B U1 Umsatzsteuerbescheid<br />
U5 Bescheid über die Erstattung von Vorsteuern<br />
U15A Neuerliche Bekanntgabe der UID-Nummer<br />
U70 Nachweis über die Erfassung als Unternehmer<br />
VERF34 Unbedenklichkeitsbescheinigung Abgabenforderungen<br />
B VE1 Verspätungszuschlagsbescheid<br />
B VE7 Verspätungszuschlagsbescheid<br />
VFSU Verspätungszuschlagsbescheid<br />
B VK Verspätungszuschlagsbescheid<br />
B VK2 Verspätungszuschlagsbescheid<br />
B VK3 Verspätungszuschlagsbescheid<br />
VOAF Ergänzungsersuchen<br />
Stand: 24.09.2012
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 8 von 9<br />
VOAF_AL Ergänzungsersuchen – Abgabe von alkoholischen Getränken<br />
VOAF_E Ergänzungsersuchen – Einkommensteuer<br />
VOAF_E7 Ergänzungsersuchen – Einkommensteuer (beschränkte<br />
Steuerpflicht)<br />
VOAF_F Ergänzungsersuchen – Feststellung der Einkünfte von<br />
Personengesellschaften<br />
VOAF_GW Ergänzungsersuchen – Gewerbesteuer<br />
VOAF_K Ergänzungsersuchen – Körperschaftsteuer<br />
VOAF_K3 Ergänzungsersuchen – Körperschaftsteuer (beschränkte<br />
Steuerpflicht)<br />
VOAF_KR1 Ergänzungsersuchen – Kraftfahrzeugsteuer<br />
VOAF_MKZ Ergänzungsersuchen – Mehrkindzuschlag<br />
VOAF_U Ergänzungsersuchen – Umsatzsteuer<br />
B VU Verspätungszuschlagsbescheid<br />
VWA1 Verspätungszuschlagsbescheid<br />
WA1 Werbeabgabebescheid<br />
B ZE1 Anspruchszinsenbescheid<br />
B ZE3 Anspruchszinsenbescheid<br />
B ZE5 Anspruchszinsenbescheid<br />
B ZE7 Anspruchszinsenbescheid<br />
B ZK Anspruchszinsenbescheid<br />
B ZK2 Anspruchszinsenbescheid<br />
B ZK3 Anspruchszinsenbescheid<br />
B ZL1 Anspruchszinsenbescheid<br />
DL DBLI Dienstgeberbeitragsliste<br />
E KOM Kommunalsteuerprüfung<br />
EU VATDECI Entscheidung<br />
VATEMPF Empfangsbestätigung<br />
FB ERV-BE Firmenbuchbeschluss<br />
FB ERV-GB Firmenbuchgebühren<br />
GM GEMDAT Grundsteuermessbeträge gemäß §194 Abs. 4 BAO<br />
GEMXGES Grundsteuermessbeträge Gesamtbestand (XML)<br />
I Informationen<br />
KG KOMMST1 Kommunalsteuergrundlagen<br />
KG KOMMST2 Kommunalsteuergrundlagen (Schließung)<br />
M 255 Zurücknahme der Berufung gem. § 255 (3) BAO<br />
M 293 Berichtigung gem. § 293 BAO<br />
M 293A Berichtigung gem. § 293a BAO<br />
M 293B Berichtigung gem. § 293b BAO<br />
M 295A Änderung gem. § 295a BAO<br />
M 303 Wiederaufnahme gem. § 303 (1) BAO<br />
M 308 Wiedereinsetzung gem. § 308 (1) BAO<br />
M AENBIL Änderung des Bilanzstichtages<br />
M AENVZ Änderung der Vorauszahlung<br />
ANMPT Anmeldung zu FinanzOnline<br />
M AUFH Aufhebung gem. § 299 (1) BAO<br />
M AUSEH Aussetzung der Einhebung gem. § 212a BAO<br />
M BA Bekanntgabe Betriebsaufgabe<br />
M BERU Berufung gem. § 243 BAO<br />
Stand: 24.09.2012
<strong>Bundesministerium</strong> <strong>für</strong> <strong>Finanzen</strong> Seite 9 von 9<br />
BPAKD Prüfungsankündigung<br />
M BVE2 Zustimmung zur 2. BVE gem. § 276 (5) BAO<br />
M ENDG Endgültigkeitserklärung gem. § 200 (2) BAO<br />
M EWBESCH Bescheidkopie des Einheitswertes<br />
M EWFORT Wert-, Art- oder Zurechnungsfortschreibung<br />
M FRBERU Fristverlängerung Berufungsfrist<br />
M FRMBA Fristverlängerung Mängelbehebungsauftrag<br />
M FRVOR Fristverlängerung Vorhaltsbeantwortung<br />
M NSA Nachsichtsansuchen<br />
M RAK Ersuchen (Rechts)auskünfte<br />
RAMIT Mitteilung Rückstandsbescheinigung<br />
M SONST Sonstige Anbringen und Anfragen<br />
M UBEIL Eilnachrichtverzichtserklärung<br />
M UBFIRM Unbedenklichkeitsbescheinigung Firmenbuch<br />
M UBSA Unbedenklichkeitsbescheinigung Staatsbürgerschaft/Aufenthalt<br />
M VORL Vorlageantrag gem. § 276 (2) BAO<br />
P Protokoll<br />
UID Protokoll UID-Bestätigung<br />
VAT Protokoll Vorsteuererstattung<br />
VATAB Protokoll Vorsteuererstattung Abschluss<br />
QL QUOAN Androhung des Ausschlusses von der Quotenregelung<br />
QL QUOAUS Einzelfallbezogene Quotenausschlussliste<br />
QL QUOAUSFA Ausschluss von der Quotenregelung<br />
QL QUOLI Verzeichnis der vertretenen Quotenfälle<br />
SS GEM Gemischte Schenkung<br />
SS GES Gesellschaftsteuer<br />
SS GRE Grunderwerbsteuer<br />
SS SCHE Schenkungssteuer<br />
SS STIF Stiftungseingangssteuer<br />
Stand: 24.09.2012
Change language