Teil 3b CRS: Datenübermittlung an das BZSt über die ELMA- Massendatenschnittstelle

Transkript

1 Kommunikationshandbuch Teil 3b CRS: Datenübermittlung an das BZSt über die ELMA- Massendatenschnittstelle

2 Inhaltsverzeichnis 0 INFORMATIONEN ZUM VORLIEGENDEN DOKUMENT AUFBAU UND ZWECK DES DOKUMENTS ÄNDERUNGSHISTORIE AUFBAU DER CRS XML-DATEI ALLGEMEINER AUFBAU VERFAHRENSSPEZIFISCHE CRS-FELDER IN ELMAHEADER WEITERE TECHNISCHE VORGABEN Dateigrößenbeschränkung Zeichensatz - unzulässige Zeichen RÜCKMELDUNG ZUR DATENLIEFERUNG ÜBERSICHT Eingangsbestätigung per durch ELMA Dateibearbeitung durch das CRS-Fachverfahren Bestätigung nach Erhalt der Datei durch das CRS-Fachverfahren Bestätigung nach Prüfung der Datei durch das CRS-Fachverfahren BEREITSTELLUNG DES XML-VERARBEITUNGSPROTOKOLLS XML-Schema Definition für das Verarbeitungsprotokoll Abholung des XML-Verarbeitungsprotokolls BEISPIELDATEIEN VERARBEITUNGSPROTOKOLLE ANHÄNGE Seite 2 -

3 Abbildungsverzeichnis Abbildung 1: ELMACS Wurzelknoten mit Unterelementen... 6 Abbildung 2: Beispiel für ein CRS-Verarbeitungsprotokoll im XML-Format Tabellenverzeichnis Tabelle 1: Abweichende Feldbefüllung des ELMAHeader für die Verwendung im CRS- Verfahren... 7 Tabelle 2: Ergänzende Einschränkung der erlaubten CRS-Zeichen... 9 Tabelle 3: Beispiel-Verarbeitungsprotokolle nach Erhalt durch das CRS-Fachverfahren Tabelle 4: Beispiel-Verarbeitungsprotokolle nach Prüfung durch das CRS-Fachverfahren Tabelle 5: Anhänge Seite 3 -

4 0 Informationen zum vorliegenden Dokument Verfahrensbezeichnung CRS Dokumententitel Kommunikationshandbuch Verantwortlicher Autor Bundeszentralamt für Steuern (BZSt) CRS-Bereich Erstellt am Zuletzt geändert am Bearbeitungszustand In Bearbeitung / Entwurf Vorgelegt X Fertiggestellt 0.1 Aufbau und Zweck des Dokuments Im vorliegenden Kommunikationshandbuch Teil 3b wird der CRS-spezifische Teil des Verfahrens zur Datenübermittlung von Massendaten über die ELMA-Schnittstelle an das BZSt beschrieben. 0.2 Änderungshistorie Version XML- Schema- Version Datum Änderung Initiale Erstellung Versionsangleichung zum KHB 3a Bereinigung von Tippfehlern Link zu den XSD-Dateien erneuert Darüber hinaus sind redaktionelle Anpassungen vorgenommen worden Austausch Abbildungen in Kapitel 3.1 Aktualisierung Beispieldateien Kapitel 2.2 und Kapitel 3 Neue Version der ELMAFEHLER_ xsd-Datei Redaktionelle Änderungen - Seite 4 -

5 1 Aufbau der CRS XML-Datei Die Finanzinstitute übertragen über die XML-Dateien. Mit den XML-Dateien werden die fachlichen Daten zu CRS (Nutzdaten) wie meldepflichtiges Konto und Angaben zum Finanzinstitut an das BZSt gemeldet. Neben diesen fachlichen Daten sind in der Datei zudem Metadaten wie Absender der Daten, Verfahrensbezug etc. (Kopfdaten) zu übermitteln. In Kapitel 1 werden der allgemeine Aufbau der XML-Datei (Trennung von Nutzdaten und Kopfdaten), Details zu den Kopfdaten der XML-Datei sowie weitere technische Vorgaben dokumentiert. Bei der Verwendung der wird eine XML-Datei übertragen, die aus dem ELMACS- Wurzelelement und den zugehörigen Unterelementen sowie den meldepflichtigen CRS-Daten besteht. Jede Datei enthält nur eine Instanz des Schemas. 1.1 Allgemeiner Aufbau Das Datenschema entspricht für den Nutzdatenteil ab dem Knoten CRS_OECD den Vorgaben des XML-Schemas der OECD für den internationalen CRS-Datenaustausch. Dieses Schema wurde für die Nutzung der nationalen um die ELMA- Schemakomponenten ergänzt. Hinweise zur CRS-Semantik sind zusammen mit praktischen Anwendungsfällen im CRS- Kommunikationshandbuch, Teil 4, dokumentiert. Dieses enthält Schema-Beschreibungen, Fehlernummern, Fehlerhinweise und konkrete Anwendungsbeispiele. Es soll den Datenersteller bei der Abgabe von Meldungen mit konkreten Beispielen unterstützen. Die nachfolgende Abbildung zeigt den Aufbau einer CRS-Meldung bzw. die einzelnen Gruppen und Elemente. ELMACS dient als Wurzelknoten für die zu übertragende Datei. ELMACS stellt den Einstieg in den Baum dar, auf den der ELMAKOM-Abschnitt folgt. Der ELMAKOM-Abschnitt enthält den ELMAHeader mit den globalen Verfahrensdaten und den Senderinformationen sowie dem Abschnitt ELMA-Verfahren. In diesem befinden sich die dem CRS-Schema entsprechenden Nutzdaten. - Seite 5 -

6 Abbildung 1: ELMACS Wurzelknoten mit Unterelementen Die XML-Schema-Definition steht als ZIP-Archiv für den Download zur Verfügung: CRS_ELMA_XSD.zip 1 Die folgenden Dateien sind Bestandteil des ZIP-Archives: ELMACS_ xsd (Root-Knoten) ELMAFEHLER_ xsd (ELMAFEHLER) ELMAGLOBAL_ xsd (einfache Typen) ELMAKOM_ xsd CrsXML_v1.0.xsd (CRS_OECD) CommonTypesFatcaCrs_v1.1.xsd FatcaTypes_v1.1.xsd isocrstypes_v1.0.xsd (ISO 3166 und ISO 4217) oecdtypes_v4.1.xsd (OECD Typen) Jede erstellte XML-Datei ist vor der Versendung gegen das CRS-XSD-Schema in der aktuellen Version zu validieren. 1.2 Verfahrensspezifische CRS-Felder in ELMAHeader Für das CRS-Verfahren entspricht der Aufbau des ELMAHeaders dem im Kommunikationshandbuch, Teil 3a, in Kapitel beschriebenen Standard. Nachfolgende Tabelle beschreibt die vom Standard abweichende verfahrensspezifische Befüllung des ELMAHeaders Seite 6 -

7 Feldname ELMAKOMVersio n Anzahl Zeichen Typ Tabelle 1: Abweichende Feldbefüllung des ELMAHeader für die Verwendung im CRS-Verfahren 1.3 Weitere technische Vorgaben Die Erläuterungen zur Verwendung der Felder und konkrete Meldefolgen sind als Beispiele im Kommunikationshandbuch, Teil 4, beschrieben Dateigrößenbeschränkung M/Muss K/Kann Die in Kapitel des Kommunikationshandbuches, Teil 3a, beschriebene Dateigrößenbeschränkung ist für das CRS Verfahren nicht gültig. Eine über das ELMA-Massendatenverfahren zu sendende CRS-Datei muss kleiner als 20 MB sein und darf nicht mehr als 4000 Datensätze enthalten Zeichensatz - unzulässige Zeichen Inhalt / Erläuterung Bemerkungen 1 String K 1 Wird für CRS nicht verwendet Datenart 10 ENUM M CRS_ELMA konstant Die in Kapitel des Kommunikationshandbuches, Teil 3a, beschriebenen Zeichen finden Anwendung. Diese Zeichen werden für CRS um die in Tabelle 2 "Ergänzende Einschränkung der erlaubten CRS-Zeichen aufgeführten Zeichen reduziert. Es ist zu berücksichtigen, dass die Menge der erlaubten Standard ELMA-Zeichen nicht identisch ist mit der Menge der erlaubten Zeichen im CRS-Verfahren. Die wurde für eine Vielzahl von Verfahren konzipiert; deshalb gibt es Abweichungen zwischen den Zeichen, die in der Datengruppe CRS_OECD benutzt werden dürfen und solchen, die im ELMAKOMHeader Verwendung finden. Die folgenden Zeichen dürfen im CRS-Verfahren nicht benutzt werden: Name UTF8 Code Ausrufezeichen U+0021 Dollarzeichen U+0024 Zirkumflex Tilde U+005E U+007E - Seite 7 -

8 Pfundzeichen Allgemeines Währungssymbol Yen-Zeichen Unterbrochener Strich Paragraphenzeichen Trema Copyrightzeichen Feminines Ordinalzeichen Nach links zeigendes doppeltes spitzes Anführungszeichen Nicht-Zeichen Weiches Trennzeichen Zeichen für ein registriertes Warenzeichen Makron Gradzeichen Plusminuszeichen Hochgestellte Zwei Hochgestellte Drei Akut Mikro-Zeichen Mittelpunkt Cedille Hochgestellte Eins Maskulines Ordinalzeichen Nach rechts zeigendes doppeltes spitzes Anführungszeichen Bruch ein Viertel U+00A3 U+00A4 U+00A5 U+00A6 U+00A7 U+00A8 U+00A9 U+00AA U+00AB U+00AC U+00AD U+00AE U+00AF U+00B0 U+00B1 U+00B2 U+00B3 U+00B4 U+00B5 U+00B7 U+00B8 U+00B9 U+00BA U+00BB U+00BC - Seite 8 -

9 Bruch einhalb Bruch drei viertel Umgekehrtes Fragezeichen Divisionszeichen U+00BD U+00BE U+00BF U+00F7 Tabelle 2: Ergänzende Einschränkung der erlaubten CRS-Zeichen 2 Rückmeldung zur Datenlieferung 2.1 Übersicht In diesem Kapitel werden die verschiedenen möglichen Rückmeldungen zur Datenlieferung beschrieben Eingangsbestätigung per durch ELMA Nach dem Durchlauf sämtlicher ELMA-Prüfungen steht für die eingereichte CRS-Datei ein Prüfstatus fest. Hinweise zur ELMA-Eingangsprüfung finden Sie im Kommunikationshandbuch, Teil 3a, in Kapitel 7.1. Abhängig vom Prüfstatus ergeben sich die beiden folgenden Verarbeitungswege Alle ELMA Prüfungen fehlerfrei absolviert In diesem Fall wird die CRS-Datei an das Fachverfahren übergeben und danach im upload Verzeichnis auf dem ELMA-Server gelöscht. Der Portalkontoinhaber erhält eine E- Mail mit dem positiven Status der ELMA-Prüfung und dem Hinweis der Dateiweiterleitung an das Fachverfahren ELMA Prüfung hat Fehler ergeben In diesem Fall wird die CRS-Datei im upload -Verzeichnis auf dem ELMA-Server gelöscht. Es erfolgt KEINE Weitergabe an das Fachverfahren und KEINE Speicherung. Der Dateiname darf nicht noch mal verwendet werden. Der Portalkontoinhaber erhält eine mit dem negativen Status der ELMA-Prüfung Dateibearbeitung durch das CRS-Fachverfahren Nach erfolgreicher Absolvierung der ELMA-Prüfungen steht die Datei dem CRS-Fachverfahren (Backend) zur Verfügung. - Seite 9 -

10 2.1.3 Bestätigung nach Erhalt der Datei durch das CRS-Fachverfahren Das CRS-Fachverfahren bestätigt den Eingang der Datei. Zu diesem Zeitpunkt sind noch keine inhaltlichen Prüfungen erfolgt Bestätigung nach Prüfung der Datei durch das CRS-Fachverfahren Das CRS-Fachverfahren führt fachliche Prüfungen durch und erstellt zu jeder eingereichten Datei ein oder mehrere Verarbeitungsprotokoll(e) im XML-Format unter Verwendung der UTF-8 Codepage. Die Protokolle stehen auf dem ELMA-Server im download -Verzeichnis zur Verfügung. Der Portalkontoinhaber erhält für jedes eingestellte Verarbeitungsprotokoll eine an die im Portalkonto hinterlegte -Adresse. 2.2 Bereitstellung des XML-Verarbeitungsprotokolls Das XML-Verarbeitungsprotokoll (Antwortdatei) wird im download -Verzeichnis auf dem ELMA- Server bereitgestellt. Zeitgleich wird eine an den Portalkontoinhaber versendet. Für jede Lieferung wird mindestens eine separate Antwortdatei erzeugt. Diese wird ohne Signaturdatei in das "download"-verzeichnis auf dem ELMA-Server eingestellt. - Seite 10 -

11 Abbildung 2: Beispiel für ein CRS-Verarbeitungsprotokoll im XML-Format XML-Schema Definition für das Verarbeitungsprotokoll Die XML-Schema Definition für das Verarbeitungsprotokoll steht über den folgenden Link zum Download bereit: XML-Schema Definition für das Verarbeitungsprotokoll 2 Für die Massendatenschnittstelle können somit eine automatisierte Abholung und Auswertung des Verarbeitungsprotokolls betrieben werden Abholung des XML-Verarbeitungsprotokolls Hinweise zur Abholung der XML-Verarbeitungsprotokolle vom ELMA-Server finden Sie im Kommunikationshandbuch, Teil 3a, in Kapitel Seite 11 -

12 3 Beispieldateien 3.1 Verarbeitungsprotokolle Über Beispiele_Verarbeitungsprotokoll.zip 3 werden Beispiele für Verarbeitungsprotokolle nach Erhalt und nach Prüfung der Daten bereit gestellt. Beispiele für Verarbeitungsprotokolle nach Erhalt der Datei durch das CRS-Fachverfahren Ohne Fehler Mit Fehler zur Lieferung selbst Beispiel_nach_Erhalt_ohne_Fehler.xml Beispiel_nach_Erhalt_mit_Fehler.xml Tabelle 3: Beispiel-Verarbeitungsprotokolle nach Erhalt durch das CRS-Fachverfahren Beispiele für Verarbeitungsprotokolle nach Prüfung der Datei durch das CRS-Fachverfahren Ohne Fehler Mit Fehler zur Lieferung selbst Mit Fehler zum AccountReport Beispiel_nach_Prüfung_ohne_Fehler.xml Beispiel_nach_Prüfung_mit_Fehler_Lieferung.xml Beispiel_nach_Prüfung_mit_Fehler_AccountReport.xml Tabelle 4: Beispiel-Verarbeitungsprotokolle nach Prüfung durch das CRS-Fachverfahren 4 Anhänge Nr. Titel Ablageort/URL 1 Kommunikationshandbuch Teile 0,1, 2, 3a, 3b, 4 Kommunikationshandbuch 4 Tabelle 5: Anhänge Seite 12 -