CSV-Formate
In MBS können verschiedene Arten von CSV-Dateien importiert werden:
- CSV-Format vom Vergleichsportal Verivox
- CSV-Format vom Vergleichsportal Check24
- Kundenindividuelles Format
CSV-Format Verivox
Das Format der CSV-Dateien vom Anbieter Verivox beinhaltet die folgenden Spalten:
Nr. | Spalte im CSV |
---|---|
1 | Verivox_ID |
2 | Abschlussdatum |
3 | Tarifname |
4 | Sparte |
5 | Typ |
6 | Art |
7 | AD_Zählertyp |
8 | AD_Heizungsart |
9 | AD_Messart |
10 | AD_Zählernummer |
11 | AD_Vorlieferant |
12 | AD_Vorlieferant Code |
13 | AD_Kundennummer |
14 | AD_Gesamtverbrauch |
15 | AD_Verbrauch_HT |
16 | AD_Verbrauch_NT |
17 | AD_Terminwunsch |
18 | AD_Neueinzug |
19 | AD_Gekündigt |
20 | KD_Firma |
21 | KD_Anrede |
22 | KD_Titel |
23 | KD_Vorname |
24 | KD_Nachname |
25 | KD_EMail_Adresse |
26 | KD_Telefon |
27 | KD_Geburtsdatum |
28 | KD_Umsatzsteuer_Id |
29 | LA_Straße |
30 | LA_Hausnummer |
31 | LA_PLZ |
32 | LA_Ort |
33 | RA_Firma |
34 | RA_Anrede |
35 | RA_Titel |
36 | RA_Vorname |
37 | RA_Nachname |
38 | RA_Straße |
39 | RA_Hausnummer |
40 | RA_PLZ |
41 | RA_Ort |
42 | RA_Umsatzsteuer_Id |
43 | BD_Zahlweg |
44 | BD_Kontoinhaber |
45 | BD_Bank |
46 | BD_IBAN |
47 | BD_BIC |
48 | BDA_Straße |
49 | BDA_Hausnummer |
50 | BDA_PLZ |
51 | BDA_Ort |
52 | GP_Netto |
53 | GP_Brutto |
54 | AP_Netto |
55 | AP_Brutto |
56 | NT_AP_Netto |
57 | NT_AP_Brutto |
58 | NKBonus_Netto |
59 | NKBonus_Brutto |
60 | PBonus |
61 | SBonus_Netto |
62 | SBonus_Brutto |
63 | Preisgarantie |
64 | Schlüssel1 |
65 | Schlüssel2 |
66 | AGB_Version |
67 | Retention |
68 | RegioFilter |
69 | AD_Marktlokation |
CSV-Format Check 24
Das Format der CSV-Dateien vom Anbieter Check24 ist identisch zu Verivox und unterscheidet sich lediglich durch den Namen der ersten Spalte. Dieser ist Check24_ID statt Verivox_ID.
Kundenindividuelles Format
Kundenindividuelle Formate, sogenannte Vertragsimportkonfigurationen, ermöglichen die individuelle Zuordnung und Transformation von CSV- zu MBS-Spalten. Sie lassen sich unter Konfiguration > Vertragsimport anlegen und bearbeiten. Über das “+”-Symbol (nicht durch direkten Eintrag in die Tabelle) kann eine neue Vertragsimportkonfiguration angelegt werden.
“Identifikationskriterium” ist ein Pflichtfeld, das einen CSV-Spaltennamen enthalten muss, der die Eingabedatei eindeutig dieser Konfiguration zuordnet (diese Zuordnung geschieht auch bei der Identifikation der Formate Verivox und Check24 durch die Spalten “Verivox_ID” und “Check24_ID” - diese beiden Spaltennamen dürfen folglich bei kundenindividuellen Formaten nicht als Identifikationskriterium verwendet werden). Der Inhalt der Identifikationsspalte kann auf ein beliebiges MBS-Feld gemappt werden.
Optional kann ein “Vertriebspartner” angegeben werden. Ist dieser nicht gesetzt, wird “interne Platform” verwendet.
Eine neue Konfiguration muss gespeichert und wieder geöffnet werden, damit alle MBS-Spalten angezeigt werden. Die MBS-Spalten können dann auf Spalten in der CSV Import Datei gemappt werden.
Spalte in Importdatei
Der MBS-Spalte zuzuordnende CSV-Spalte. Falls hier Spalten angegeben sind, die im Import nicht vorhanden sind, wird beim Import ein Fehler angezeigt.
Format
Bei Datumsspalten muss hier das Datumsformat angegeben werden, beispielsweise dd.MM.yyyy.
Operationen
Operationen erlauben die Transformation von Eingabewerten. Beispiele:
replace
-
replace(Jährlich=12,Halbjährlich=6,Vierteljährlich=3,Monatlich=1)
Importiere “Jährlich” als “12”, “Halbjährlich” als “6”, usw.
-
replace(ja=Lastschrift,nein=Überweisung)
Fülle die MBS-Spalte “BD_Zahlweg” aus einer Eingabespalte “Sepa Mandat”.
-
replace(^$=vorgabe@example.com)
Ersetze leere Werte mit einem Vorgabewert (vorgabe@example.com), beibehalte nicht-leere Werte. Diese Transformation kann z. B. für KD_EMail_Adresse sinnvoll sein.
Pflichtfeld
Falls eine Spalte auf Pflichtfeld gesetzt wird, gibt es einen Fehler beim Import, falls diese Spalte nicht gefüllt ist.
Informationen zum Tarif
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
Tarife_ID | Welcher Tarif soll für den Vertrag gelten? | Numerisch (muss ID aus Datenbank-Tabelle "fl_tarif" entsprechen) |
Tarife_ID oder Tarifname ist Pflichtfeld |
Tarifname | Welcher Tarif soll für den Vertrag gelten? | Tarifname (muss name_ oder nameextern_ aus Datenbank-Tabelle "fl_tarif" entsprechen) |
Tarife_ID oder Tarifname ist Pflichtfeld |
Sparte | Zu welcher Sparte gehört der Tarif? | Strom Gas | Pflichtfeld |
Informationen zum Vertragsnehmer
Adressdaten gelten für den Kunden, nicht für die Lieferadresse. Falls nicht angegeben, wird die Lieferadresse verwendet.
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
AD_Kundennummer | Kundennummer | Text (muss dem für Kundennummer\ festgelegten Format entsprechen) | Optional |
KD_Anrede | Anrede des Vertragsinhabers | Herr, Frau | Pflichtfeld |
KD_Titel | Titel des Vertragsinhabers | Dr., Prof. | Optional |
KD_Vorname | Vorname des Vertragsinhabers | Text | Pflichtfeld |
KD_Nachname | Nachname des Vertragsinhabers | Text | Pflichtfeld |
KD_Geburtsdatum | Geburtsdatum des Vertragsinhabers | Datum (TT.MM.JJJJ) | Pflichtfeld |
KD_Umsatzsteuer_Id | Umsatzsteuer-ID des Vertragsinhabers | Text | Optional |
KD_Schufa_Klasse | Information zur Bonität des Kunden. Gültige Werte werden konfiguriert. | Text | Optional |
KD_PLZ | Postleitzahl der Kundenadresse | Numerisch | Optional |
KD_Ort | Stadt zur Kundenadresse | Text | Optional |
KD_Straße | Straße zur Kundenadresse | Text | Optional |
KD_Hausnummer | Hausnummer zur Kundenadresse (ohne Hausnummernzusatz) | Numerisch | Optional |
KD_Hausnummer_Zusatz | Hausnummernzusatz zur Kundenadresse | Text (z. B. „a“) Kann auch unter KA_Hausnummer übergeben werden | Optional |
KD_Bonitaets_Score | Score, der die Bonität des Kunden widerspiegelt. Der Bonitäts-Schwellenwert wird konfiguriert. | Numerisch (Natürliche Zahl oder Dezimalzahl, z.B. 5 oder 5,5) | Optional |
Informationen zur Lieferstelle
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
LA_PLZ | Postleitzahl der Lieferadresse | Numerisch | Pflichtfeld |
LA_Ort | Stadt zur Lieferadresse | Text | Pflichtfeld |
LA_Straße | Straße zur Lieferadresse | Text | Pflichtfeld |
LA_Hausnummer | Hausnummer zur Lieferadresse (ohne Hausnummernzusatz) | Numerisch | Pflichtfeld |
LA_Hausnummer_Zusatz | Hausnummernzusatz zur Lieferadresse | Text (z. B. „a“) Kann auch unter LA_Hausnummer übergeben werden | Optional |
KD_Telefon | Telefonnummer des Vertragsinhabers (Typ: Privat) | Numerisch | Optional |
KD_EMail_Adresse | E-Mail-Adresse des Vertragsinhabers | E-Mail-Adresse, z. B. customer@next-level-integration.de | Pflichtfeld |
Vertriebspartner und Vertragsabschlussdaten
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
ID | externe ID des Imports | Text (z. B. 002) | Optional |
Abschlussdatum | Wann wurde der Vertrag unterschrieben? | Datum (TT.MM.JJJJ) | Pflichtfeld |
Rechnungsintervall | Rechnungsinterval | 1 3 6 12 | Optional, 12 (Jährlich) ist der Standard |
Typ | Vertragstyp | SLP RLM | Optional, SLP ist der Standard |
Abweichender Postempfänger
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
RA_Anrede | Anrede |
|
Optional |
RA_Titel | Titel |
|
Optional |
RA_Vorname | Vorname | Text | Optional |
RA_Nachname | Nachname | Text | Optional |
RA_PLZ | PLZ zur Postanschrift | Numerisch | Optional |
RA_Ort | Ort zur Postanschrift | Text | Optional |
RA_Straße | Straße zur Postanschrift | Text | Optional |
RA_Hausnummer | Hausnummer zur Postanschrift (ohne Zusatz) | Numerisch | Optional |
RA_Hausnummer_Zusatz | Hausnummernzusatz zur Postanschrift | Text (z. B. „a“) | Optional |
RA_Umsatzsteuer_Id | Umsatzsteuer-ID des Postempfängers | Text | Optional |
Zählerstände und Bankdaten
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
BD_Zahlweg | Wie werden die Abschläge bezahlt? |
Lastschrift Überweisung |
Pflichtfeld |
BD_Kontoinhaber | Kontoinhaber-Name für Bankeinzug | Text | Pflichtfeld (bei Bankeinzug) |
BD_Kontoinhaber_Vorname | Kontoinhaber-Vorname für Bankeinzug | Text | Optional, kann auch unter BD_Kontoinhaber mit übertragen werden |
BD_IBAN | IBAN für Bankeinzug | Text (Format: IBAN) | Pflichtfeld (bei Bankeinzug) |
BD_BIC | BIC für Bankeinzug | Text (Format: BIC) | Optional (bei Bankeinzug) |
BD_Bank | Bankname für Bankeinzug | Text | Optional (bei Bankeinzug) |
AD_Kundennummer | Kundennummer beim Altlieferanten | Text | Optional |
AD_Neueinzug | Bei Neueinzug das Datum wann eingezogen wurde | Datum (TT.MM.JJJJ) | Optional |
AD_Gekündigt | Kündigungsdatum beim Altlieferanten | Datum (TT.MM.JJJJ) | Pflichtfeld (wenn Altlieferant gekündigt) |
AD_Terminwunsch | Gewünschter Termin des Lieferbeginns | Datum (TT.MM.JJJJ) | Optional |
AD_Zählernummer | Zählernummer der Lieferstelle | Text | Pflichtfeld |
AD_Gesamtverbrauch | Kunden-Prognose (Wichtig: HT + NT) | Numerisch | Pflichtfeld |
AD_Vorlieferant Code | ILN-Nummer vom Altlieferanten | Text | Optional |
AD_Marktlokation | Marktlokation der Lieferstelle | Text | Optional |
Bonuszahlungen
Spalte im CSV | Bedeutung | Mögliche Werte | Pflicht |
---|---|---|---|
SBonus_Brutto | Wie hoch soll der Sofortbonus sein? |
Numerisch | Optional |
NKBonus_Brutto* | Wie hoch soll der Jahresbonus sein | Numerisch (Dezimalwert, z. B. 0,152857) | Optional |
PBonus* | Wie hoch soll der Jahresbonus sein (in Prozent z. B. x% der Jahresrechnung)? |
Numerisch | Optional |
AP_Brutto | Arbeitspreis zum Vertragsabschluss (€) | Numerisch (Dezimalwert, z. B. 0,152857) | Pflicht, wenn der Tarif keinen Preis vorgibt |
GP_Brutto | Grundpreis zum Vertragsabschluss (€) |
Numerisch (Dezimalwert, z. B. 4,941176) | Pflicht, wenn der Tarif keinen Preis vorgibt |
Bonitätsprüfung
In der Datenbanktabelle fl_ratingThresholdData kann für jede Kombination aus Sparte und Geschäftsform ein Schwellenwert für die Bonität definiert werden. Wird bei einem Vertragsimport die Spalte “Score” innerhalb der CSV-Datei definiert und für einen Eintrag ein Wert in dieser Spalte hinterlegt, wird dieser Wert gegen den entsprechenden Schwellenwert in der Datenbank geprüft. Unterschreitet der Wert aus der CSV-Datei den Schwellenwert, so wird der Vertrag mit Sperrgrund “Bonität” gesperrt und eine entsprechende E-Mail an den Kunden versendet.