Formate | wiki.konfipay.de

Zahlungsempfänger/Zahlungspflichtige

Für den Import von Zahlungsempfängern und Zahlungspflichtigen (Import → Zahlungsempfänger/Zahlungspflichtige) stehen drei CSV-Spezifikationen zur Auswahl. Es handelt sich um eigenständige Formate mit unterschiedlichem Aufbau: Die im Importdialog gewählte Spezifikation muss zum Aufbau der Datei passen.

Spezifikation	Spaltenzuordnung	Spaltenüberschriften
Windata	Über die feste Spaltenposition	Keine – die erste Zeile wird übersprungen
Travic-Port	Über den Spaltennamen	Englisch (z. B. `RECIPIENT_NAME`)
HBP	Über den Spaltennamen	Deutsch (z. B. `Empfängername`)

Bei den kopfzeilenbasierten Formaten Travic-Port und HBP werden die Spalten über die Spaltenüberschrift zugeordnet. Die Spaltenreihenfolge in der Datei ist daher unerheblich, zusätzliche oder unbekannte Spalten werden ignoriert. Nur bei Windata erfolgt die Zuordnung über die Spaltenposition – dort ist die Reihenfolge verbindlich.

Die Spaltentabellen der Formate Travic-Port und HBP listen deshalb die Felder auf, die der Import auswertet – nicht die Reihenfolge, in der sie in der Datei stehen müssen.

Windata

Allgemeine Angaben

Format	CSV (Comma-Separated Values)
Zeichenkodierung	UTF-8 (ohne BOM)
Zeilenende	\r\n
Feldtrenner	Semikolon → ;
Dezimaltrennzeichen	Komma → ,
Header-Zeile	Ja – die erste Zeile wird übersprungen und nicht importiert. Spaltennamen werden nicht ausgewertet.
Spaltenzuordnung	Über die feste Spaltenposition – die Spaltenreihenfolge ist verbindlich
Spaltenanzahl	Eine Datenzeile muss genau 18 Spalten enthalten, andernfalls wird sie übersprungen
IBAN	Erforderlich (Spalte 2) – es wird eine gültige IBAN erwartet

Dateiaufbau

#	Feld	Beschreibung	Anmerkung
0	Name	Text, max. 70 Zeichen
1	Ort	Text, max. 35 Zeichen
2	IBAN	Text, max. 50 Zeichen
3	BIC	Text, max. 50 Zeichen
4	Bank Name	Text, max. 35 Zeichen
5	Skonto	Gleitkommazahl
6	Verwendungszweck 1	Text, max. 35 Zeichen	Verwendungszweckfelder 1-4 werden beim Import in einem einzigen Feld mit 140 Zeichen abgebildet.
7	Verwendungszweck 2	Text, max. 35 Zeichen
8	Verwendungszweck 3	Text, max. 35 Zeichen
9	Verwendungszweck 4	Text, max. 35 Zeichen
10	Kundennummer	Text, max. 50 Zeichen
11	Fibu-Konto	-	Wird nicht importiert
12	Kategorie	-	Wird nicht importiert
13	Unterkategorie	-	Wird nicht importiert
14	Straße	Text, max. 50 Zeichen
15	Postleitzahl	Text, max. 35 Zeichen
16	E-Mail	Text, max. 100 Zeichen
17	Anmerkung	Text, max. 4000 Zeichen

Die erste Zeile dient nur der Lesbarkeit und wird beim Import ignoriert – die Bezeichnungen dürfen frei gewählt werden. Nicht benötigte Felder bleiben leer, das Semikolon muss aber gesetzt werden, damit die Zeile genau 18 Spalten enthält.

Travic-Port

Allgemeine Angaben

Format	CSV (Comma-Separated Values)
Zeichenkodierung	UTF-8 empfohlen
Zeilenende	\r\n oder \n
Feldtrenner	Semikolon → ;
Header-Zeile	Erforderlich – die erste Zeile, die mit `RECIPIENT_NAME;` beginnt (Groß-/Kleinschreibung wird nicht unterschieden)
Spaltenzuordnung	Über den Spaltennamen – die Spaltenreihenfolge ist unerheblich, unbekannte Spalten werden ignoriert
Übersprungene Zeilen	Zeilen, die mit `META;` beginnen, sowie Zeilen, die nur aus Semikolons bestehen
Übersprungene Datensätze	Wenn `RECIPIENT_NAME`, `IBAN` und `NATIONAL_ACCOUNT_NUMBER` leer sind
IBAN	Erforderlich – Ausnahme: Bei der Rolle Non-SEPA-Zahlungsempfänger kann ein Datensatz ohne IBAN über `NATIONAL_ACCOUNT_NUMBER` und `BIC` importiert werden. Für Zahlungsempfänger und Zahlungspflichtige im SEPA-Raum bleibt eine gültige IBAN verpflichtend.

Dateiaufbau

CSV-Spalte	Feld	Beschreibung	Anmerkung
`RECIPIENT_NAME`	Name	Text, max. 70 Zeichen
`RECIPIENT_STREET`	Straße	Text, max. 50 Zeichen
`RECIPIENT_CITY`	Ort	Text, max. 35 Zeichen
`RECIPIENT_COUNTRY_CODE_ISO`	Land	ISO-Ländercode, 2 Zeichen	z. B. DE, AT, CH
`RECIPIENT_PHONE`	Telefon	Text, max. 50 Zeichen
`RECIPIENT_EMAIL`	E-Mail	Text, max. 100 Zeichen
`IBAN`	IBAN	Text, max. 50 Zeichen
`NATIONAL_ACCOUNT_NUMBER`	Kontonummer	Text, max. 50 Zeichen	Wird nur für die Rolle Non-SEPA-Zahlungsempfänger ausgewertet
`BIC`	BIC	Text, max. 50 Zeichen
`BANK_NAME`	Bank Name	Text, max. 35 Zeichen
`BANK_STREET`	Straße der Bank	Text, max. 50 Zeichen
`BANK_CITY`	Ort der Bank	Text, max. 35 Zeichen
`DESCRIPTION`	Anmerkung	Text, max. 4000 Zeichen

Die Spaltenüberschriften dieses Formats sind englisch und werden vom exportierenden Programm vorgegeben – sie dürfen nicht übersetzt oder umbenannt werden.

HBP

Allgemeine Angaben

Format	CSV (Comma-Separated Values)
Zeichenkodierung	UTF-8 empfohlen. Dateien, in denen die Umlaute der Überschriften `Straße` und `Empfängername` falsch kodiert sind, werden toleriert.
Feldtrenner	Semikolon → ;
Header-Zeile	Erforderlich – die erste Zeile, die `Empf…`, `IBAN` und `BIC` enthält (Groß-/Kleinschreibung wird nicht unterschieden)
Spaltenzuordnung	Über den Spaltennamen – die Spaltenreihenfolge ist unerheblich, unbekannte Spalten werden ignoriert
Übersprungene Zeilen	Zeilen, die nur aus Semikolons bestehen
Übersprungene Datensätze	Wenn der Empfängername leer ist oder die IBAN leer ist
IBAN	Erforderlich – Zeilen ohne gültige IBAN werden übersprungen. Non-SEPA-Zahlungsempfänger (Kontonummer und BIC ohne IBAN) werden von diesem Format nicht unterstützt.

Dateiaufbau

CSV-Spalte	Feld	Beschreibung	Anmerkung
`Empfängername`	Name	Text, max. 70 Zeichen
`Straße`	Straße	Text, max. 50 Zeichen	Straße und Hausnummer stehen in getrennten Spalten
`Haus-Nr.`	Hausnummer	Text, max. 16 Zeichen
`Land`	Land	ISO-Ländercode, 2 Zeichen	z. B. DE, AT, CH
`PLZ`	Postleitzahl	Text, max. 35 Zeichen
`Ort`	Ort	Text, max. 35 Zeichen
`Zahlungsreferenz`	Verwendungszweck	Text, max. 140 Zeichen
`IBAN/Kontonr`	IBAN	Text, max. 50 Zeichen	Es wird eine gültige IBAN erwartet
`BIC / BLZ`	BIC	Text, max. 50 Zeichen

Die Spaltenüberschriften dieses Formats sind deutsch und werden vom exportierenden Programm vorgegeben – sie dürfen nicht übersetzt oder umbenannt werden.