In diesem Abschnitt ist der Aufbau der CSV-Datei beschrieben, die für den Import von Buchungen in myBusiness Supplier benötigt wird.
CSV-Format
Die CSV-Datei muss UTF-8 codiert sein. Spaltentrenner ist das Semikolon. In der ersten Zeile wird ein Spaltenheader erwartet. Die Zuordnung der Spalten erfolgt über die Bezeichner im Header. Die Reihenfolge der Spalten ist gleichgültig.
Datumsangaben müssen im Format dd.MM.yyyy angegeben werden.
Fließkommazahlen müssen stets positiv sein. Nachkommastellen werden mit Komma abgetrennt.
| Spalte im CSV | Bedeutung | Format | Validierung beim Import |
|---|---|---|---|
| CONTRACT_NUMBER | Vertragskontonummer Alt | Text | Pflichtfeldvalidierung |
| CUSTOM_ACCOUNT_CONFIG_ID | Buchungstyp - Typ der Buchung gemäß Mapping der Haupt- und Teilvorgänge auf die Vorgänge, die im Zielsystem übernommen werden sollen (z.B. Forderung, Guthaben, Gebühr) | name_ aus FL_CustomTransferConfigur | Pflichtfeldvalidierung Validierung gegen Katalog |
| VALUE | Brutto-Betrag (immer positive Werte - Vorzeichen wird über den Typ definiert) | Numerisch | PflichtfeldvalidierungWert >0 Maximal Dezimalstellen 2 |
| CREATION_DATE | Belegdatum im Beleg | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) |
| POSTING_DATE | Buchungsdatum im Beleg | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) |
| DUE_DATE | Fälligkeit | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) |
| SUBJECT_INTERNAL | MBS interne Referenznummer aus Quellsystem z.B. “MIG” + Belegnummer Altsystem | Text | Feldlänge <=255 Zeichen |
| SUBJECT_EXTERNAL | Referenztext, die auf der Rechnung des Endkunden angedruckt wird z.B. “Zwischenrechnung |
Text | Pflichtfeldvalidierung Feldlänge <=255 Zeichen |
| DUNNING_BLOCK_END | Bis wann liegt die Mahnsperre vor | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) leer = unendlich ist erlaubt |
| DUNNING_BLOCK_REASON | Was ist der Grund der Mahnsperre | subject_ aus FL_BlockCreationReason | Validierung gegen Katalog wenn DUNNING_BLOCK_END gefüllt, dann Pflicht |
| DUNNING_BLOCK_ADJ_ACTION | Die Migrationsbuchungen sollen bis “zur nächsten Rechnung” gesperrt sein und nicht bis zu einem festem Datum. | Text | SetBlockEndToDebitorInvoiceDueDate oder leer |
| DIRECT_DEBIT_BLOCK_END | Bis wann liegt die Eingangszahlsperre vor? | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) leer = unendlich ist erlaubt |
| DIRECT_DEBIT_BLOCK_REASON | Was für ein Grund hat die Eingangszahlsperre? | subject_ aus FL_BlockCreationReason | Validierung gegen Katalog wenn DIRECT_DEBIT_BLOCK_END gefüllt, dann Pflicht |
| DIRECT_DEBIT_BLOCK_ADJ_ACTION | Die Migrationsbuchungen sollen bis “zur nächsten Rechnung” gesperrt sein und nicht bis zu einem festem Datum. | Text | SetBlockEndToDebitorInvoiceDueDate oder leer |
| PAYOUT_BLOCK_END | Bis wann liegt die Ausangszahlsperre vor? | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) leer = unendlich ist erlaubt |
| PAYOUT_BLOCK_REASON | Was für ein Grund hat die Ausgangszahlsperre? | subject_ aus FL_BlockCreationReason | Validierung gegen Katalog wenn PAYOUT_BLOCK_END gefüllt, dann Pflicht |
| PAYOUT_BLOCK_ADJ_ACTION | Die Migrationsbuchungen sollen bis “zur nächsten Rechnung” gesperrt sein und nicht bis zu einem festem Datum. | Text | SetBlockEndToDebitorInvoiceDueDate oder leer |
| BALANCING_BLOCK_END | Bis wann liegt die Deckungssperre (synonym Ausgleichssperre) vor | Datum (TT.MM.JJJJ) | Formatprüfung (Datum) leer = unendlich ist erlaubt |
| BALANCING_BLOCK_REASON | Was ist der Grund der Deckungssperre (synonym Ausgleichssperre) | subject_ aus FL_BlockCreationReason | Validierung gegen Katalog wenn BALANCING_BLOCK_END gefüllt, dann Pflicht |
| BALANCING_BLOCK_ADJ_ACTION | Die Migrationsbuchungen sollen bis “zur nächsten Rechnung” gesperrt sein und nicht bis zu einem festem Datum. | Text | SetBlockEndToDebitorInvoiceDueDate oder leer |
Beispieldaten
CONTRACT_NUMBER;CUSTOM_ACCOUNT_CONFIG_ID;VALUE;CREATION_DATE;POSTING_DATE;DUE_DATE;SUBJECT_INTERNAL;SUBJECT_EXTERNAL;DUNNING_BLOCK_END;DUNNING_BLOCK_REASON;DIRECT_DEBIT_BLOCK_END;DIRECT_DEBIT_BLOCK_REASON;PAYOUT_BLOCK_END;PAYOUT_BLOCK_REASON;BALANCING_BLOCK_END;BALANCING_BLOCK_REASON
081000993081;Rechnungsbonus;58,54;17.06.2013;15.10.2017;08.01.2013;MIG010000011364;Zahlungsreg. Eingang;31.12.2001;Beschwerde;31.12.2022;Preiswiderspruch;;Externe Inkassounternehmen;;