Datenformate¶
Kunden-Import (CSV)¶
Regeln für das CSV File¶
- Kommaseparierte Liste (Trennzeichen: ",")
- Keine Kopfzeile
Spaltenreihenfolge:
- Kundenummer (leer = automatisch vergeben)
- Anrede (MR, MRS, COMPANY) oder Spalte leer lassen
- Vorname
- Nachname
- Firmenname
- Adresse
- PLZ
- Ort
- Land
- E-Mail Adresse
Beispiel-CSV¶
5002,MR,Max,Mustermann,Muster AG,Musterweg 1,12345,Musterhausen,Deutschland,max@muster.de,
,MRS,Tine,Examplus,Example GmbH,Exempel Gasse 1,56789,Rosahausen,Deutschland,tine@example.de,
In diesem Beispiel wird für den ersten Kunden eine Kundenummer vorgegeben, für den zweiten Kunden wird die Nummer vom System automatisch vergeben.
Bankkontenumsätze (CSV, Generisches Fakturia-Format)¶
Spaltenbeschreibung¶
| Format | Beispiel | Anmerkungen | |
|---|---|---|---|
| Buchungsdatum | dd.MM.yyyy | 31.12.2018 | |
| Buchungstext | (String) | RE4321 KndNr 1337 FAK123456789ABCDEF987654321XD123 Something,Something | Zusammengesetzte Buchungstexte In diesem Feld wird auch das Fakturia-EREF-Pattern gesucht (End2End) |
| Account Owner | (String) | Manfred Herrlich | In diesem Feld steht der Name des Kontoinhabers (Account Owner) des Gegenkontos. |
| Betrag | (Number) |
|
Deutsches Format für Beträge. Dezimal-Trennzeichen: , (Komma) Tausender-Trennzeichen: . (Punkt) Vorzeichen für negative Beträge: - (Minus) |
CSV-Format¶
Aufbau¶
- Keine Kopfzeile
- 4 Spalten
- Semikolon ; als Spaltentrennzeichen
- Erlaubte Linebreaks: CR und LF
- Spaltenbegrenzungszeichen optional: "
- Zeichenkodierung: Auswählbar (UTF-8, UTF-16, ISO-8859-15, WINDOWS-1252)
- Reihenfolge der Spalten: BUCHUNGSDATUM;BUCHUNGSTEXT;ACCOUNTOWNER;BETRAG
Beispiel¶
01.12.2018;"RE4321 KndNr 1337 Something,Something";Dieter Dietrich;1.015,72
31.12.2018;"Rücklastschrift RE9999 FAK123456789ABCDEF987654321XD123";Deutschländer GmbH & Co KG;-49,99
31.12.2018;"Überweisung Michael Gehalt Januar";Michael Tiltfeuer;-10,00
Leistungs-Import (CSV)¶
Regeln für das CSV File¶
- Kommaseparierte Liste (Trennzeichen: ",")
- Keine Kopfzeile
- Datumsformat gem. ISO 8601 z.B. 2026-04-29
- "." als Dezimaltrennzeichen
Spaltenreihenfolge:
- Vertragsnummer (Pflichtfeld)
- Artikelnummer (Pflichtfeld)
- Anzahl (Pflichtfeld)
- Beginn Leistungszeitraum (Datum ohne Zeitanteil, Pflichtfeld)
- Ende Leistungszeitraum (Datum ohne Zeitanteil)
- Beschreibungstext
- Individueller Preis (netto)
- frühestes Abrechnungsdatum
- Leistungsart (Mögliche Werte: DEFAULT_PERFORMANCE, REVERSE_PERFORMANCE_COMMISSION, REVERSE_PERFORMANCE_OTHER, falls nicht gesetzt ist DEFAULT_PERFORMANCE der Defaultwert)
Beispiel-CSV¶
1,API001,250,2026-04-05,,Zusätzliche API-Calls,,,,
1,PROV001,25.84,2026-04-05,2026-04-10,Provisionszahlungen,,2026-08-01,REVERSE_PERFORMANCE_OTHER
In Beispiel 2 wird eine Buchung zur Ausschüttung über eine Gutschrift vorgenommen. Der Posten darf erst ab dem 01.08.2026 verrechnet werden