UID-Abfrage-Webservice

Transkript

1 Bundesministerium für Finanzen Seite 1 vn 5 1 Einleitung UID-Abfrage- Die Einrichtung eines s richtet sich an Spezialisten. WSDL ist ein Standard für s im Internet. Wir ersuchen daher um Verständnis, dass das BMF und die FinanzOnline-Htline für die Lösung vn technischen Prblemen im Zusammenhang mit der Einrichtung des s nicht zur Verfügung stehen können. Der Aufruf des s kann aus Prgrammen auf nahezu jeder Plattfrm (z.b. Java) erflgen. 2 Beschreibung Vraussetzung für das Der Übermittler muss FinanzOnline Teilnehmer sein. Der Teilnehmer muss in der Benutzerverwaltung einen Benutzer für 's' anlegen. Das muss mit diesem Benutzer verwendet werden. WSDL Die technische Beschreibung der s für FinanzOnline als WSDL ist unter erreichbar. Url Für den Verbindungsaufbau wird das Zertifikat vn FinanzOnline benötigt. Das Zertifikat kann im Internet-Explrer mit dem Zertifikatsexprt-Assistenten heruntergeladen werden (FinanzOnline-Startseite aufrufen, Datei/Eigenschaften/Zertifikate/Details).

2 Bundesministerium für Finanzen Seite 2 vn 5 3 Ablauf 3.1 Aufruf Sessin- Das WSDL-Servicedkument für das Sessin- ist unter zu finden. Client tid, benid, pin > < id / errr Verbindung aufbauen Verschlüsselte Verbindung aufbauen mittels FinanzOnline-Zertifikat Die Parameter zum Starten des s sind wie flgt zu belegen: tid benid pin = 'Teilnehmer-Identifikatin' = 'Benutzer-Identifikatin des -Benutzers', der in der Benutzerverwaltung angelegt wurde = 'Pin des -Benutzers' Methde 'lgin' aufrufen Antwrt auswerten Es wird ein string mit der SessinID zurückgegeben 3.2 Aufruf UID-Abfrage- Das WSDL-Servicedkument für das UID-Abfrage- ist unter zu finden. Client sessinid, tid, benid, uid_tn, uid, stufe > < rc / errr Die Parameter zum Starten des s sind wie flgt zu belegen: sessinid tid benid uid_tn = mit Methde 'lgin' ermittelte SessinID = 'Teilnehmer-Identifikatin = 'Benutzer-Identifikatin des -Benutzers' = UID-Nummer des Antragstellers (eigene UID), beginnend mit ATU********

3 Bundesministerium für Finanzen Seite 3 vn 5 uid stufe = UID-Nummer des Erwerbers = Stufe der UID-Abfrage 1 Stufe 1 (gültig der nicht gültig) 2 Stufe 2 (gültig der nicht gültig; wenn gültig, zusätzlich Name und Anschrift) Methde 'uidabfrage' aufrufen Antwrt auswerten Es wird ein Array vn Objekten (siehe wsdl-dkument) zurückgegeben rc = Returncde der Anfrage (siehe 4 Returncdes) name = Name des Empfängers (nur bei Stufe 2 befüllt) adrz1 = Zeile 1 der Adresse des Empfängers (nur bei Stufe 2 befüllt) adrz2 = Zeile 2 der Adresse des Empfängers (nur bei Stufe 2 befüllt) adrz3 = Zeile 3 der Adresse des Empfängers (nur bei Stufe 2 befüllt) adrz4 = Zeile 4 der Adresse des Empfängers (nur bei Stufe 2 befüllt) adrz5 = Zeile 5 der Adresse des Empfängers (nur bei Stufe 2 befüllt) adrz6 = Zeile 6 der Adresse des Empfängers (nur bei Stufe 2 befüllt) 3.3 Aufruf Sessin- Das WSDL-Servicedkument für das Sessin- ist unter zu finden. Client id, tid, benid > < k / errr Die Parameter zum Starten des s sind wie flgt zu belegen: id = mit Methde 'lgin' ermittelte SessinID tid = 'Teilnehmer-Identifikatin benid = 'Benutzer-Identifikatin des -Benutzers' Methde 'lgut' aufrufen

4 Bundesministerium für Finanzen Seite 4 vn 5 4 Returncdes Als Antwrt auf die UID-Abfrage wird ein Returncde zurückgeliefert (bei Stufe 2 zusätzlich Name und Anschrift). Bedeutung der Returncdes: 0 Die UID des Erwerbers ist gültig. 1 Die UID des Erwerbers ist nicht gültig. 3 Die UID-Nummer des Antragstellers ist ungültig. 4 Die UID-Nummer des Erwerbers ist falsch. 5 Die UID-Nummer des Antragstellers ist ungültig. 6 Der angegebene Mitgliedstaat ist derzeit nicht erreichbar. 7 Der angegebene Mitgliedstaat ist derzeit nicht erreichbar. 8 Anfragen sind derzeit nicht möglich. 9 Name und Anschrift des Erwerbers sind derzeit nicht ermittelbar. 101 Die UID des Antragstellers muss mit "ATU" beginnen. 102 Bei "Stufe" ist nur "1" der "2" zulässig. 103 Die angefragte UID-Nummer kann im FinanzOnline nur in Stufe 1 bestätigt werden, da diese UID-Nummer zu einer Unternehmensgruppe (Umsatzsteuergruppe) gehört. Aus technischen Gründen werden aus Tschechien keine Firmendaten angezeigt. Für eine gültige Stufe 2 Abfrage ist es daher erfrderlich, dass Sie sich unter die Daten der CZ-Umsatzsteuergruppe aufrufen und kntrllieren, b das angefragte Unternehmen auch tatsächlich zu dieser Gruppe gehört. Bitte bewahren Sie den Ausdruck dieser Anfrage in Ihren Unterlagen als Beleg gemäß 132 BAO auf. Für jede Anfrage Stufe 2 ist swhl das Bestätigungsverfahren in Stufe 1 im FinanzOnline als auch das Gruppenregister im anderen Mitgliedsstaat laut.a. Link zu knsultieren. Im Falle vn Fragen wenden Sie sich bitte an Ihr zuständiges Finanzamt. 104 Die angefragte UID-Nummer kann im FinanzOnline nur in Stufe 1 bestätigt werden, da diese UID-Nummer zu einer Unternehmensgruppe (Umsatzsteuergruppe) gehört. Aus technischen Gründen werden aus der Slwakei keine Firmendaten angezeigt. Für eine gültige Stufe 2 Abfrage ist es daher erfrderlich, dass Sie sich unter die Daten der SK-Umsatzsteuergruppe aufrufen und kntrllieren, b das angefragte Unternehmen auch tatsächlich zu dieser Gruppe gehört. Bitte bewahren Sie den Ausdruck dieser Anfrage in Ihren Unterlagen als Beleg gemäß 132 BAO auf. Für jede Anfrage Stufe 2 ist swhl das Bestätigungsverfahren in Stufe 1 im FinanzOnline als auch das Gruppenregister im anderen Mitgliedsstaat laut.a. Link zu knsultieren. Im Falle vn Fragen wenden Sie sich bitte an Ihr zuständiges Finanzamt. 105 Die UID-Nummer ist über FinanzOnline einzeln abzufragen. 999 Nicht alle erfrderlichen Parameter wurden angegeben Der angegebene Mitgliedstaat ist derzeit nicht erreichbar.

5 Bundesministerium für Finanzen Seite 5 vn 5 5 Bestätigung Die Bestätigung als Nachweis für die erflgte Abfrage der Gültigkeit einer Umsatzsteuer- Identifikatinsnummer wird am flgenden Tag in die Databx vn FinanzOnline zugestellt. Dabei wird pr Antragsteller-UID eine eigene Bestätigung ausgestellt. Die ausgedruckte Bestätigung gilt als Beleg und ist gemäß 132 BAO aufzubewahren.