In diesem Abschnitt ist der Aufbau der CSV-Datei beschrieben, die für den Import von Verträgen in myBusiness Supplier benötigt wird.

CSV-Formate

In MBS können verschiedene Arten von CSV-Dateien importiert werden:

  1. CSV-Format vom Vergleichsportal Verivox
  2. CSV-Format vom Vergleichsportal Check24
  3. 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
  • Herr
  • Frau
Optional
RA_Titel Titel
  • Dr.
  • Prof.
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.