Hilfe

Zurück zur Übersicht

Import von Anfragen zur Auskunft über tatsächlich freigestellte Kapitalerträge

  • Allgemeine Informationen
  • Wichtige Hinweise
  • Versionstabelle
  • Datensatztabellen und Satzarten
  • Beispielhafte CSV-Datei
  • Liste der zulässigen Staatenkürzel
  • Hotline und Benutzersupport

Allgemeine Informationen

In dieser Importhilfe finden Sie formularspezifische Informationen zum Aufbau einer CSV-Datei und zur aktuellen Version der CSV-Schnittstelle. 

Falls Sie mit der Importfunktion noch nicht vertraut sind und allgemeine Informationen zum Erstellen von CSV-Dateien benötigen, nutzen Sie bitte die  allgemeine Anleitung zur Erstellung von CSV-Dateien für die Importfunktion .


Wichtige Hinweise

Im Zusammenhang mit der Nutzung der Importfunktion macht das Bundeszentralamt für Steuern auf Folgendes aufmerksam:

Die Benutzung der Importfunktion erfolgt auf eigenes Risiko. Das BZSt schließt jegliche Haftung für unmittelbare und mittelbare Schäden aus, die den Antragstellern aufgrund der Benutzung dieser Funktionalität oder der Unfähigkeit, diese Funktionalität zu verwenden, entstehen, insbesondere für Datenverluste, Mehraufwendungen oder fehlerhafte Ergebnisse, entgangenem Gewinn, Betriebsunterbrechung, Verlust von geschäftlichen Informationen und sonstige finanzielle Verluste.

Hinweis

Die Importfunktion wurde überarbeitet. Aufgrund des erweiterten Zeichensatzes müssen zu importierende CSV-Dateien zwingend in UTF-8 encodiert sein. Das bisherige Encoding ISO-8859-15 wird nicht weiter unterstützt.

Weitere Informationen finden Sie hier.

Hinweis - Grafik Sprechblase

Versionstabelle

CSV-VersionExcel-VersionInhalt der Änderungen
2.0
2.2.0
Umstellung des Encodings der CSV-Dateien von ISO-8859-15 auf UTF-8
1.0
1.1.0
Erste Version der Importfunktion

Datensatztabellen und Satzarten

Die folgenden Datensatztabellen beschreiben alle in der Importfunktion verfügbaren Satzarten.

Es können maximal 1000 Datenzeilen in einer CSV-Datei importiert werden.

Legende der Abkürzungen des Formats in der Spaltenbeschreibung:

AbkürzungFormat
A oder ANalphanumerisch, d.h. Text und Ziffern
Nnumerisch, d.h. Ziffern
(X)X ist die Anzahl maximal angebbarer Zeichen

Datensatztabelle Anfragen (Satzart 1)

Feldbeschreibung
ErläuterungPflichtfeld
Allgemeine Angaben zur Anfrage
OrdnungsbegriffAN(45)

Benutzerdefinierter Ordnungsbegriff für diese Meldung

Optional
Beginn AnfragezeitraumN(4)Das Jahr für den Beginn des Anfragezeitraum. Der Zeitpunkt darf nicht vor 2011 und nicht in der Zukunft liegen.

Format "JJJJ"

Pflicht
Ende AnfragezeitraumN(4)

Das Jahr für das Ende des Anfragezeitraums. Das Ende darf nicht vor dem Beginn und muss vor dem aktuellen Jahr liegen.

Der Auskunftszeitraum darf maximal 10 Jahre betragen.

In einer CSV-Datei können Anfragen für mehrere verschiedene Jahre enthalten sein.

Pflicht
Angaben zur angefragten Person
GeburtsdatumAN(10)

Geburtsdatum der angefragten Person. Kann auch teilbekannt sein.

Format: TT.MM.JJJJ, 00.MM.JJJJ, 00.00.JJJJ, 00.00.0000 

zum Beispiel "24.12.1973", "00.12.1973", 00.00.1973" oder "00.00.0000"

Falls das Jahr bekannt ist, darf es nicht vor 1900 liegen.

Pflicht
VorsatzwortAN(20)

Vorsatz zum Namen der angefragten Person

Optional
TitelAN(20)

Titel der angefragten Person

Optional
NameAN(45)

Nachname der angefragten Person

Pflicht
NamenszusatzAN(20)

Zusatz zum Namen der angefragten Person

Optional
GeburtsnameAN(45)

Geburtsname der angefragten Person (falls abweichend vom Nachnamen)

Optional
GeburtsortAN(80)

Geburtsort der angefragten Person

Optional
GeburtslandAN(80)

Geburtsland der angefragten Person

Optional
VornameAN(45)

Vorname der angefragten Person

Optional
IdNrN(11)

Steuerliche Identifikationsnummer der angefragten Person

Optional
Anschrift der angefragten Person - Inlandsadresse
StrasseAN(80)

Straßenname

Optional
HausnummerN(5)

Hausnummer

Optional
ZusatzAN(20)

Zusatz zur Hausnummer

Optional
PostleitzahlN(5)

Postleitzahl

Pflicht bei einer Inlandsadresse. Dann müssen exakt 5 Ziffern angegeben werden.

(Pflicht)
OrtAN(80)

Ortsangabe

Pflicht bei einer Inlandsadresse.

(Pflicht)
Anschrift der angefragten Person - Auslandsadresse
StraßeAN(80)StraßennameOptional
HausnummerN(5)HausnummerOptional
ZusatzAN(20)Zusatz zur HausnummerOptional
PostleitzahlN(12)PostleitzahlOptional
OrtAN(80)Ortsangabe(Pflicht)
AdressergänzungAN(50)AdressergänzungOptional
StaatAN(2)

 Angabe des Staates

Eine Aufstellung aller zulässigen Einträge finden Sie in der Liste der zulässigen Staatenkürzel.

(Pflicht)

Beispielhafte CSV-Datei

Das folgende Beispiel einer CSV-Datei kann mit Hilfe der Importfunktion in das Formular importiert werden. Das Beispiel dient lediglich zur Veranschaulichung der Importfunktion und stellt keinen realen Datensatz dar.

#v2.0
#ve2.2.0
Ordnungsbegriff,Beginn Anfragezeitraum,Ende Anfragezeitraum,Geburtsdatum,Vorsatzwort,Titel,Name,Namenszusatz,Geburtsname,Geburtsort,Geburtsland,Vorname,IdNr,Strasse,Hausnummer,Zusatz,Postleitzahl,Ort,Strasse,Hausnummer,Zusatz,Postleitzahl,Ort,Adressergaenzung,Staat
Begriff1,2015,2020,10.10.2000,,,Mustermann,,,,,Erika,,Testweg,5,Hinterhof,03265,Stadt,,,,,,,
Begriff2,2016,2020,08.10.2000,,,Musterfrau,,,,,Max,,Testweg,16,d,02565,Kleinstadt,,,,,,,
Begriff3,2011,2020,08.08.2000,Graf,Dr,Schulze,von,Schmidt,Madrid,Spanien,Maria,,Testweg,22,d,09875,Bielefeld,,,,,,,

Liste der zulässigen Staatenkürzel

Die erste Spalte der folgenden Tabelle enthält die für das Feld "Staat" zulässigen Einträge.

StaatenkürzelStaat
ADAndorra
AEVereinigte Arabische Emirate
AFAfghanistan
AGAntigua und Barbuda
AIAnguilla
ALAlbanien
AMArmenien
AOAngola
AQAntarktis
ARArgentinien
ASAmerikanisch Samoa
ATÖsterreich
AUAustralien
AWAruba
AXÅlandinseln
AZAserbaidschan
BABosnien und Herzegowina
BBBarbados
BDBangladesch
BEBelgien
BFBurkina Faso
BGBulgarien
BHBahrain
BIBurundi
BJBenin
BLSaint Barthélemy
BMBermuda
BNBrunei Darussalam
BOBolivien
BQBonaire, Saba und Sint Eustatius
BRBrasilien
BSBahamas
BTBhutan
BVBouvetinsel
BWBotsuana
BYBelarus (Weißrussland)
BZBelize
CAKanada
CCKokosinseln (Keeling)
CDKongo, Demokratische Republik
CFZentralafrikanische Republik
CGKongo
CHSchweiz
CICôte d'Ivoire
CKCookinseln
CLChile
CMKamerun
CNChina
COKolumbien
CRCosta Rica
CUKuba
CVKap Verde
CWCuracao
CXWeihnachtsinsel
CYZypern
CZTschechische Republik
DEDeutschland
DJDjibouti
DKDänemark
DMDominica
DODominikanische Republik
DZAlgerien
ECEcuador
EEEstland
EGÄgypten
EHWestsahara (Demokratische Arabische Republik)
EREritrea
ESSpanien
ETÄthiopien
FIFinnland
FJFidschi
FKFalklandinseln (Malvinen)
FMMikronesien, Föderierte Staaten von
FOFäröer
FRFrankreich
GAGabun
GBVereinigtes Königreich
GDGrenada
GEGeorgien
GFFranzösisch Guyana
GGGuernsey
GHGhana
GIGibraltar
GLGrönland
GMGambia
GNGuinea
GPGuadeloupe
GQÄquatorial-Guinea
GRGriechenland
GSSüdgeorgien und die Südlichen Sandwichinseln
GTGuatemala
GUGuam
GWGuinea-Bissau
GYGuyana
HKHongkong
HMHeard und die McDonaldinseln
HNHonduras
HRKroatien
HTHaiti
HUUngarn
IDIndonesien
IEIrland
ILIsrael
IMInsel Man
INIndien
IOBritisches Territorium im Indischen Ozean
IQIrak
IRIran, Islamische Republik
ISIsland
ITItalien
JEJersey
JMJamaika
JOJordanien
JPJapan
KEKenia
KGKirgisistan
KHKambodscha
KIKiribati
KMKomoren
KNSaint Kitts and Nevis
KPKorea, Demokratische Volksrepublik
KRKorea, Republik
KWKuwait
KYKaimaninseln
KZKasachstan
LALaos, Demokratische Volksrepublik
LBLibanon
LCSaint Lucia
LILiechtenstein
LKSri Lanka
LRLiberia
LSLesotho
LTLitauen
LULuxemburg
LVLettland
LYLibysch-Arabische Dschamahirija (Libyen)
MAMarokko
MCMonaco
MDMoldau, Republik
MEMontenegro
MFSaint Martin (französischer Teil)
MGMadagaskar
MHMarshallinseln
MKMazedonien, die ehemalige jugoslawische Republik
MLMali
MMMyanmar
MNMongolei
MOMacau
MPMarianen, Nördliche
MQMartinique
MRMauretanien
MSMontserrat
MTMalta
MUMauritius
MVMalediven
MWMalawi
MXMexiko
MYMalaysia
MZMosambik
NANamibia
NCNeukaledonien
NENiger
NFNorfolkinsel
NGNigeria
NINicaragua
NLNiederlande
NONorwegen
NPNepal
NRNauru
NUNiue
NZNeuseeland
OMOman
PAPanama
PEPeru
PFFranz.-Polynesien
PGPapua-Neuguinea
PHPhilippinen
PKPakistan
PLPolen
PMSt. Pierre und Miquelon
PNPitcairninseln
PRPuerto Rico
PSPalästinensische Autonomiegebiete
PTPortugal
PWPalau
PYParaguay
QAKatar
RERéunion
RORumänien
RSSerbien
RURussische Föderation
RWRuanda
SAKönigreich Saudi-Arabien
SBSalomonen
SCSeychellen
SDSudan
SESchweden
SGSingapur
SHSt. Helena
SISlowenien
SJSvalbard und Jan Mayen
SKSlowakische Republik
SLSierra Leone
SMSan Marino
SNSenegal
SOSomalia
SRSuriname
SSSüdsudan
STSao Tome und Principe
SVEl Salvador
SXSt. Martin (Niederländischer Teil)
SYSyrien, Arabische Republik
SZSwasiland
TCTurks- und Caicosinseln
TDTschad
TFFranzösische Südgebiete
TGTogo
THThailand
TJTadschikistan
TKTokelau
TLTimor-Leste
TMTurkmenistan
TNTunesien
TOTonga
TRTürkei
TTTrinidad und Tobago
TVTuvalu
TWTaiwan
TZTansania
UAUkraine
UGUganda
UMAmerikanische Überseeinseln, Kleinere
USVereinigte Staaten von Amerika
UYUruguay
UZUsbekistan
VAHeiliger Stuhl (Vatikanstadt)
VCSt. Vincent und die Grenadinen
VEVenezuela
VGBritische Jungferninseln
VIAmerikanische Jungferninseln
VNVietnam
VUVanuatu
WFWallis und Futuna
WSSamoa
XICeuta
XJMelilla
XKKosovo
YEJemen
YTMayotte
ZASüdafrika
ZMSambia
ZWSimbabwe

Hotline und Benutzersupport

Außer den Hinweisen, die Sie über die Online-Hilfe direkt von Mein BOP erhalten, können Sie eine von den Steuerverwaltungen des Bundes und der Länder eingerichtete Informationsstelle (Hotline) nutzen, die Ihnen

  • montags bis freitags von 7:00 bis 22:00 Uhr sowie
  • samstags und sonntags von 10:00 bis 18:00 Uhr
bei Fragen und Problemen mit Mein BOP zur Verfügung steht. Einzelfragen werden dort telefonisch unter der Nummer 0800 52 35 055 (Für Anrufer mit ausländischer Rufnummer: +49 180 5 23 50 55) beantwortet bzw. entgegengenommen. Die Informationsstelle ist auch per Kontaktformular erreichbar.  Zum Kontaktformular

Beachten Sie bitte: Über die Hotline ist keine steuerliche Beratung möglich.