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

Möglichkeiten

In MBS können verschiedene Arten von CSV-Dateien importiert werden. Jedes Format wird durch eine Vertragsimportkonfiguration beschrieben und lässt sich anpassen (siehe Kundenindividuelles Format).

Format Identifikationskriterium Spalten in der CSV-Datei Konvertierung
Verivox Verivox_ID Spalten des Portals, siehe Aufbau Formate Dynamisch
Check24 Check24_ID wie Verivox Dynamisch
Interne Plattform Interne_Plattform_ID wie Verivox, mit Abweichungen Dynamisch
Standardimport (leer) alte Namen der technischen Felder (Record-Namen), siehe Aufbau Formate Standard
MBS MBS_Import_ID 1:1 Feldnamen des Records (siehe unten Feldname (neuer Name)) Dynamisch
Kundenindividuell frei wählbar frei wählbar, siehe Kundenindividuelles Format frei wählbar
  • Check24 entspricht dem Verivox-Format. Es unterscheidet sich nur durch die Identifikationsspalte: Check24_ID statt Verivox_ID. Sie enthält die Vertriebspartner-Nr.
  • Interne Plattform entspricht dem Verivox-Format für den Vertriebspartner “Interne Plattform”. Abweichungen:
    • Interne_Plattform_ID statt Verivox_ID (der Inhalt wird als Vertriebspartner-Nr. übernommen)
    • Tarife_ID gibt die ID des Tarifs an, alternativ zu Tarifname
    • AD_Vorlieferant Code (mit Leerzeichen) statt AD_Vorlieferant_Code
    • KD_EMail_Adresse statt KD_E-Mail_Adresse
    • AD_Marktlokation wird nicht geliefert
  • Standardimport ist das Format, das verwendet wird, wenn die Kopfzeile kein Identifikationskriterium einer anderen Konfiguration enthält. Die Spalten heißen wie die bisherigen technischen Felder (alte Record-Namen, z. B. Kvorname, KStrasse_Postfach, Neu_Einzug), die Groß- und Kleinschreibung wird nicht beachtet. Die Unterschiede der Konvertierung stehen in Aufbau Formate.
  • Verivox, Check24 und die Interne Plattform liefern die Felder für Wasser und Abwasser (WA_*) nicht und haben sie ausgeschaltet. Der Standardimport liest sie aus Spalten mit dem Namen des Feldes.

Funktionsweise

  1. Konfiguration wählen: MBS prüft die Kopfzeile (erste Zeile) der CSV-Datei. Enthält sie das Identifikationskriterium einer Vertragsimportkonfiguration, wird diese Konfiguration verwendet. Die Prüfung erkennt auch Teile eines Spaltennamens und unterscheidet Groß- und Kleinschreibung. Die Identifikationskriterien sollten so gewählt werden, dass jeweils nur eine Konfiguration zur Kopfzeile passt. Enthält die Kopfzeile kein Identifikationskriterium, wird die Standardkonfiguration verwendet.
  2. Spalten zuordnen: Jedes Feld aus Beschreibung der Felder wird aus einer Spalte der CSV-Datei gelesen. Gibt es in der Konfiguration keinen Eintrag für das Feld, heißt die Spalte wie das Feld (z. B. KD_Vorname). Gibt es einen Eintrag mit “Spalte in Importdatei”, heißt die Spalte so. Ist die “Spalte in Importdatei” leer, ist das Feld ausgeschaltet: MBS erwartet und liest die Spalte nicht. Beim Lesen der Werte wird die Groß- und Kleinschreibung der Spaltennamen nicht beachtet. Spalten ohne passendes Feld werden als Vertragszusatzfelder behandelt.
  3. Kopfzeile prüfen: Vor dem Import prüft MBS, ob alle erwarteten Spalten in der Kopfzeile vorkommen. Fehlende Spalten werden alle gemeinsam in der Fehlermeldung genannt, und es wird nichts importiert. Eine Spalte darf in den Datenzeilen leer sein, muss aber in der Kopfzeile stehen. Liefert die CSV-Datei ein Feld nicht, muss es in der Konfiguration ausgeschaltet werden. Ist “Fehlende Spalten ignorieren” gesetzt, entfällt die Prüfung und fehlende Felder bleiben leer (nur in der Standardkonfiguration voreingestellt).
  4. Werte verarbeiten: Für jede Zeile werden nacheinander das Format von Datumsspalten und die Operationen angewendet und die Pflichtfelder geprüft (siehe Einträge). Anschließend werden die Werte nach der Konvertierung der Konfiguration in einen Vertrag umgewandelt.

Aufbau Formate

Die Tabelle nennt für jedes Feld die Spalte im Format von Verivox und Check24, die Spalte im Standardimport (alter Record-Name) und den Feldnamen (neuer Name, siehe Beschreibung der Felder). Ein “–” heißt: Das Format liefert das Feld nicht, es ist ausgeschaltet. Die Spalte “Konvertierung” nennt die Unterschiede der Konvertierungen “Standard” und “Dynamisch” (siehe Möglichkeiten). Ist sie leer, gibt es keinen Unterschied.

Verivox/Check24 Standardimport (alter Record-Name) Feldname (neuer Name) Konvertierung
– Kunden_nr MBS_Kundennummer  
KD_Titel KTitel KD_Titel  
KD_Anrede KAnrede KD_Anrede  
KD_Vorname Kvorname KD_Vorname  
KD_Nachname Knachname KD_Nachname  
– KD_Namenszusatz KD_Namenszusatz  
KD_Firma KFirma KD_Firma  
– KUmsatzsteuerId KD_Umsatzsteuer_Id  
KD_Telefon KTel KD_Telefon  
KD_E-Mail_Adresse KEmail KD_EMail_Adresse  
KD_Geburtsdatum KGeburtsdatum KD_Geburtsdatum  
– Bonitaets_Score KD_Bonitaets_Score  
LA_Straße KStrasse_Postfach LA_Strasse  
LA_Hausnummer KHaus_NR LA_Hausnummer  
– KHaus_NR_Zusatz LA_Hausnummer_Zusatz  
LA_PLZ KPLZ LA_PLZ  
LA_Ort KOrt LA_Ort  
– KAdress_Zusatz LA_Adresszusatz  
– KundenAdresseStrasse_Postfach KD_Strasse  
– KundenAdresseHaus_NR KD_Hausnummer  
– KundenAdresseHaus_NR_Zusatz KD_Hausnummer_Zusatz  
– KundenAdressePLZ KD_PLZ  
– KundenAdresseOrt KD_Ort  
– KundenAdresseAdress_Zusatz KD_Adresszusatz  
RA_Titel ETitel RA_Titel  
RA_Anrede EAnrede RA_Anrede  
RA_Vorname EVorname RA_Vorname  
RA_Nachname ENachname RA_Nachname  
– RA_Namenszusatz RA_Namenszusatz  
RA_Firma EFirma RA_Firma  
– EUmsatzsteuerId RA_Umsatzsteuer_Id  
– – RA_Geburtsdatum  
– ETel RA_Telefon  
– EEmail RA_EMail_Adresse  
RA_Straße EStrasse_Postfach RA_Strasse  
RA_Hausnummer EHaus_NR RA_Hausnummer  
– EHaus_NR_Zusatz RA_Hausnummer_Zusatz  
RA_PLZ EPLZ RA_PLZ  
RA_Ort EOrt RA_Ort  
– EAdress_Zusatz RA_Adresszusatz  
– Kanrede_2 KD2_Anrede  
– KVorname_2 KD2_Vorname  
– Knachname_2 KD2_Nachname  
– KP_Anrede KP_Anrede  
– KP_Titel KP_Titel  
– KP_Vorname KP_Vorname  
– KP_Nachname KP_Nachname  
– KP_Namenszusatz KP_Namenszusatz  
– KP_Firma KP_Firma  
– KP_MBS_Kundennummer KP_MBS_Kundennummer  
– KP_Umsatzsteuer_Id KP_Umsatzsteuer_Id  
– KP_Telefon KP_Telefon  
– KP_Mobil KP_Mobil  
– KP_Fax KP_Fax  
– KP_EMail_Adresse KP_EMail_Adresse  
– KP_Geburtsdatum KP_Geburtsdatum  
– KP_Geburtsname KP_Geburtsname  
BD_IBAN Konto_NR BD_IBAN  
BD_BIC Bankleitzahl BD_BIC  
BD_Bank Bank BD_Bank  
BD_Kontoinhaber Kontoinhaber BD_Kontoinhaber  
– Kontoinhaber_Vorname BD_Kontoinhaber_Vorname  
BD_Zahlweg Zahlungsart BD_Zahlweg  
– Sepa_Mandats_ID BD_Sepa_Mandats_ID  
– Sepa_Unterschriftsdatum BD_Sepa_Unterschriftsdatum  
– ZD_IBAN ZD_IBAN  
– ZD_BIC ZD_BIC  
– ZD_Bank ZD_Bank  
– ZD_Kontoinhaber ZD_Kontoinhaber  
– ZD_Sepa_Mandats_ID ZD_Sepa_Mandats_ID  
– ZD_Sepa_Unterschriftsdatum ZD_Sepa_Unterschriftsdatum  
– ZD_Auszahlung_IBAN ZD_Auszahlung_IBAN  
– ZD_Auszahlung_BIC ZD_Auszahlung_BIC  
– ZD_Auszahlung_Bank ZD_Auszahlung_Bank  
– ZD_Auszahlung_Kontoinhaber ZD_Auszahlung_Kontoinhaber  
AD_Terminwunsch Datum_Lieferungswunsch AD_Terminwunsch  
AD_Neueinzug Neu_Einzug AD_Neueinzug Standard: true = Umzug, sonst Lieferantenwechsel.
Dynamisch: Datum = Umzug mit diesem Lieferbeginn, leer = Lieferantenwechsel.
– Alt_Lieferant_gekuendigt_Kunde AD_Vorlieferant_gekuendigt Nur Standard: true = Altlieferant gekündigt.
Dynamisch: gekündigt, wenn AD_Gekuendigt gesetzt ist.
AD_Gekündigt Lieferant_gekuendigt_zum AD_Gekuendigt Dynamisch: Ist das Datum gesetzt, gilt der Altlieferant als gekündigt.
AD_Zählernummer Anmelde_Zaehlernr AD_Zaehlernummer  
– Anmelde_Zaehlpunkt AD_Anmelde_Zaehlpunkt  
– Netzbetreiber_ID AD_Netzbetreiber_ID  
AD_Kundennummer Alt_Lieferant_Kunden_NR AD_Kundennummer  
AD_Vorlieferant_Code Altlieferant_Identcode AD_Vorlieferant_Code  
– Marktlokation AD_Marktlokation  
AD_Gesamtverbrauch Verbrauch_HT_Kundenangabe AD_Gesamtverbrauch  
– – AD_Gesamtverbrauch_m3  
– Spannungsebene_Kundenangabe AD_Spannungsebene  
– AD_EnFG_Voraussetzung AD_EnFG_Voraussetzung  
– AD_EnFG_Privilegierungsgrund AD_EnFG_Privilegierungsgrund  
– AD_Steuerkanal AD_Steuerkanal  
– AD_Weitere_Technische_Einrichtungen AD_Weitere_Technische_Einrichtungen  
– AD_EnWG_Modul AD_EnWG_Modul  
– AD_Anlagenart AD_Anlagenart  
– AD_EnWG_Inbetriebnahmedatum AD_EnWG_Inbetriebnahmedatum  
– AD_Zusatzinformationen AD_Zusatzinformationen  
– Tarife_ID T_Tarife_ID  
Tarifname Tarifname T_Tarifname  
Sparte Sparte Sparte  
AP_Brutto AP T_AP_Brutto Standard: Euro unverändert.
Dynamisch: Cent, wird durch 100 geteilt.
AP_Netto AP_Netto T_AP_Netto Standard: Euro unverändert.
Dynamisch: Cent, wird durch 100 geteilt.
NT_AP_Brutto – T_NT_AP_Brutto Nur Dynamisch: Cent, wird durch 100 geteilt.
NT_AP_Netto – T_NT_AP_Netto Nur Dynamisch: Cent, wird durch 100 geteilt.
GP_Brutto GP T_GP_Brutto  
GP_Netto GP_Netto T_GP_Netto  
– Bonus_Prozent T_PBonus  
– Bonus_Max T_PBonus_Max  
– Bonus_Prozent_Faelligkeit T_PBonus_Faelligkeit  
SBonus_Brutto SAZ T_SBonus_Brutto Standard: Wert unverändert.
Dynamisch: Bruttowert, die Steuer wird je Sparte und Abschlussdatum herausgerechnet.
– SAZ_Faelligkeit T_SBonus_Faelligkeit Standard: Wert aus der CSV-Datei.
Dynamisch: Bonustage aus der Global Property des Vertriebspartners (VERIVOX_DIRECT_BONUS_DAYS, CHECK24_DIRECT_BONUS_DAYS, INTERNAL_PLATFORM_DIRECT_BONUS_DAYS), Standard 60.
NKBonus_Brutto – T_NKBonus_Brutto Nur Dynamisch: Bruttowert, die Steuer wird herausgerechnet.
Verivox_ID (Check24: Check24_ID) Vertriebspartner_NR Vertriebspartner_NR  
– Vertriebspartner_name Vertriebspartner_name Standard: Wert der Spalte.
Dynamisch: Ist die Spalte leer, der Vertriebspartner der Konfiguration (Standard “Interne Plattform”).
– Vertragsnr_extern MBS_Vertragsnr  
Abschlussdatum Datum_Kundenunterschrift AD_Abschlussdatum  
– Datum_Lieferende AD_Datum_Lieferende  
– Abschlagsintervall AD_Abschlagsintervall  
– AD_Kein_Abschlagsplan AD_Kein_Abschlagsplan  
– Rechnungsintervall AD_Rechnungsintervall  
Typ – Typ Nur Dynamisch: RLM, TLP oder SLP (Standard).
– Stromsteuerbefreit AD_Stromsteuerbefreit  
– Virtuelle_Kontonummer BD_Virtuelle_Kontonummer  
– Kommunikationsweg AD_Kommunikationsweg  
– Kontierungsmerkmal AD_Kontierungsmerkmal  
– IsInitialSupply AD_Neuanlage  
– – WA_Tarif_ID  
– – WA_Abwasser_Tarif_ID  
– – WA_Ablesestrategie  
– – WA_Gesperrt  
– – WA_Fallklasse  
– – WA_Kontextvertrag  
– – WA_Altvertrag_Wasser  
– – WA_Altvertrag_Abwasser  
– – WA_ZD_IBAN  
– – WA_ZD_BIC  
– – WA_ZD_Bank  
– – WA_ZD_Kontoinhaber  
– – WA_ZD_Sepa_Mandats_ID  
– – WA_ZD_Sepa_Unterschriftsdatum  
– – WA_ZD_Auszahlung_IBAN  
– – WA_ZD_Auszahlung_BIC  
– – WA_ZD_Auszahlung_Bank  
– – WA_ZD_Auszahlung_Kontoinhaber  

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 kann eine neue Vertragsimportkonfiguration angelegt werden. Die Konfigurationen von Verivox, Check24, Interner Plattform und der Standardimport sind bereits angelegt und können angepasst werden. Eine neue Konfiguration muss gespeichert und wieder geöffnet werden. Danach lassen sich über das “+”-Symbol Einträge anlegen.

Angaben der Konfiguration

Angabe Bedeutung
Identifikationskriterium Pflichtfeld bei kundenindividuellen Formaten. Ein CSV-Spaltenname, der die Eingabedatei eindeutig dieser Konfiguration zuordnet (siehe Funktionsweise). Die Spaltennamen “Verivox_ID”, “Check24_ID” und “Interne_Plattform_ID” sind bereits vergeben und dürfen nicht verwendet werden. Der Inhalt der Identifikationsspalte kann auf ein beliebiges MBS-Feld gemappt werden.
Vertriebspartner Optional. Ist er nicht gesetzt, wird “Interne Plattform” verwendet.
Konvertierung “Standard” oder “Dynamisch” legt fest, wie die Werte in einen Vertrag umgewandelt werden. Ist nichts eingetragen, gilt “Standard”. Die Unterschiede (Einheit der Preise, Boni, Neueinzug, Vertragstyp u. a.) stehen in der Spalte “Konvertierung” der Tabelle in Aufbau Formate. Felder, die die Konvertierung nicht kennt, sind auszuschalten.
Fehlende Spalten ignorieren Die Prüfung der Kopfzeile entfällt, fehlende Felder bleiben leer. Voreingestellt nur in der Standardkonfiguration.

Einträge

In der Konfiguration stehen nur die Felder, für die ein Eintrag angelegt wurde. Alle anderen Felder werden aus der Spalte gelesen, die wie das Feld heißt. Jeder Eintrag hat die folgenden Angaben:

Angabe Bedeutung
Spalte in MBS Name des Feldes aus Beschreibung der Felder oder technischer Name eines Vertragszusatzfeldes.
Spalte in Importdatei Der MBS-Spalte zuzuordnende CSV-Spalte. Ist die Angabe leer, ist das Feld ausgeschaltet. Ist hier eine Spalte angegeben, die in der Importdatei nicht vorhanden ist, wird beim Import ein Fehler angezeigt.
Format Bei Datumsspalten das Datumsformat, beispielsweise dd.MM.yyyy. Ohne Format werden Datumswerte als yyyy-MM-dd oder dd.MM.yyyy gelesen.
Operationen Transformation der Eingabewerte, siehe Operationen.
Pflichtfeld Ist die Spalte auf Pflichtfeld gesetzt, gibt es beim Import einen Fehler, wenn sie nicht gefüllt ist. Das gilt auch für Vertragszusatzfelder.
Operationen

Operationen erlauben die Transformation von Eingabewerten. Es gibt die Operationen replace, removeChars und loadSupplierIln. Beispiele:

  • 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), behalte nicht-leere Werte. Das kann z. B. für KD_EMail_Adresse sinnvoll sein.
  • removeChars(#): Entfernt alle Zeichen, die dem regulären Ausdruck entsprechen, hier “#”, aus dem Wert.
  • loadSupplierIln: Der Wert ist der Name eines Lieferanten. Ersetzt ihn durch dessen ILN-Nummer. Gibt es keinen oder mehrere Lieferanten mit diesem Namen, bleibt das Feld leer. Das kann z. B. für AD_Vorlieferant_Code sinnvoll sein.

Hinweise

  • Das Identifikationskriterium sollte nicht zu kurz gewählt werden, weil auch Teile eines Spaltennamens erkannt werden.
  • Die Spalte der Standardkonfiguration lässt sich ändern, beispielsweise auf die Feldnamen.

Beschreibung der Felder

Die Tabellen nennen die Felder (Spalte in MBS) mit ihrer Bedeutung. Die Angabe in der Spalte “Pflicht” bezieht sich auf den Wert in der Importdatei. Jede Spalte muss unabhängig davon in der Kopfzeile stehen, solange das Feld nicht ausgeschaltet ist oder “Fehlende Spalten ignorieren” gesetzt ist. Die Namen der Spalten in den einzelnen Formaten stehen in Aufbau Formate.

Tarif, Preise und Boni

Spalte in MBS Bedeutung Mögliche Werte Pflicht
T_Tarife_ID Welcher Tarif soll für den Vertrag gelten? Numerisch (muss ID aus Datenbank-Tabelle “fl_tarif” entsprechen) T_Tarife_ID oder T_Tarifname ist Pflichtfeld
T_Tarifname Welcher Tarif soll für den Vertrag gelten? Tarifname (muss name_ oder nameextern_ aus Datenbank-Tabelle “fl_tarif” entsprechen) T_Tarife_ID oder T_Tarifname ist Pflichtfeld
Sparte Zu welcher Sparte gehört der Tarif? Strom Gas Pflichtfeld

Ist T_Tarife_ID leer, wird der Standardtarif der Sparte verwendet (Global Properties CONTRACT_IMPORT_DEFAULT_TARIFF und CONTRACT_IMPORT_DEFAULT_TARIFF_GAS). Ist keiner hinterlegt, wird der Tarif über den Tarifnamen gesucht.

Die Einheit der Preise und die Behandlung der Boni hängen von der Konvertierung der Konfiguration ab (siehe Spalte “Konvertierung” in Aufbau Formate).

Spalte in MBS Bedeutung Mögliche Werte Pflicht
T_AP_Brutto Arbeitspreis brutto zum Vertragsabschluss Numerisch (Dezimalwert, z. B. 0,152857) Pflicht, wenn der Tarif keinen Preis vorgibt
T_AP_Netto Arbeitspreis netto zum Vertragsabschluss Numerisch (Dezimalwert) Optional
T_NT_AP_Brutto Arbeitspreis brutto der Nebenzeit Numerisch (Dezimalwert) Optional
T_NT_AP_Netto Arbeitspreis netto der Nebenzeit Numerisch (Dezimalwert) Optional
T_GP_Brutto Grundpreis brutto zum Vertragsabschluss (€) Numerisch (Dezimalwert, z. B. 4,941176) Pflicht, wenn der Tarif keinen Preis vorgibt
T_GP_Netto Grundpreis netto zum Vertragsabschluss (€) Numerisch (Dezimalwert) Optional
T_SBonus_Brutto Wie hoch soll der Sofortbonus sein? Numerisch Optional
T_SBonus_Faelligkeit Fälligkeit des Sofortbonus Numerisch Optional
T_NKBonus_Brutto Wie hoch soll der Jahresbonus sein? Numerisch (Dezimalwert, z. B. 0,152857) Optional
T_PBonus Wie hoch soll der Jahresbonus sein (in Prozent z. B. x% der Jahresrechnung)? Numerisch Optional
T_PBonus_Max Höchstbetrag des Jahresbonus in Prozent Numerisch Optional
T_PBonus_Faelligkeit Fälligkeit des Jahresbonus in Prozent Numerisch Optional

Vertragsnehmer

Adressdaten gelten für den Kunden, nicht für die Lieferadresse. Falls nicht angegeben, wird die Lieferadresse verwendet.

Spalte in MBS Bedeutung Mögliche Werte Pflicht
MBS_Kundennummer Kundennummer Text (muss dem für Kundennummer festgelegten Format entsprechen) Optional
KD_Anrede Anrede des Vertragsinhabers Herr, Frau, Firma Pflichtfeld
KD_Titel Titel des Vertragsinhabers Dr., Prof. Optional
KD_Vorname Vorname des Vertragsinhabers Text Pflichtfeld
KD_Nachname Nachname des Vertragsinhabers Text Pflichtfeld
KD_Namenszusatz Namenszusatz des Vertragsinhabers Text Optional
KD_Firma Firma des Vertragsinhabers, die Rechtsform ist dann “Firma” Text Optional
KD_Geburtsdatum Geburtsdatum des Vertragsinhabers Datum (TT.MM.JJJJ) Pflichtfeld
KD_Umsatzsteuer_Id Umsatzsteuer-ID des Vertragsinhabers Text 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
KD_PLZ Postleitzahl der Kundenadresse Numerisch Optional
KD_Ort Stadt zur Kundenadresse Text Optional
KD_Strasse 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“) Optional
KD_Adresszusatz Adresszusatz zur Kundenadresse Text Optional
KD_Bonitaets_Score Risikoklasse, die die Bonität des Kunden widerspiegelt. Die akzeptierten Risikoklassen werden konfiguriert. R1 - R6 Optional

Weiterer Vertragsnehmer

Der weitere Vertragsnehmer wird nur angelegt, wenn Vor- oder Nachname angegeben sind.

Spalte in MBS Bedeutung Mögliche Werte Pflicht
KD2_Anrede Anrede Herr, Frau Optional
KD2_Vorname Vorname Text Optional
KD2_Nachname Nachname Text Optional

Ansprechpartner

Der Ansprechpartner wird nur angelegt, wenn mindestens eine Spalte dieser Tabelle gefüllt ist.

Spalte in MBS Bedeutung Mögliche Werte Pflicht
KP_Anrede Anrede des Ansprechpartners Herr, Frau, Firma Optional
KP_Titel Titel des Ansprechpartners Dr., Prof. Optional
KP_Vorname Vorname des Ansprechpartners Text Optional
KP_Nachname Nachname des Ansprechpartners Text Optional
KP_Namenszusatz Namenszusatz des Ansprechpartners Text Optional
KP_Firma Firma des Ansprechpartners Text Optional
KP_MBS_Kundennummer Kundennummer des Ansprechpartners Text Optional
KP_Umsatzsteuer_Id Umsatzsteuer-ID des Ansprechpartners Text Optional
KP_Telefon Telefonnummer des Ansprechpartners Numerisch Optional
KP_Mobil Mobilnummer des Ansprechpartners Numerisch Optional
KP_Fax Faxnummer des Ansprechpartners Numerisch Optional
KP_EMail_Adresse E-Mail-Adresse des Ansprechpartners E-Mail-Adresse Optional
KP_Geburtsdatum Geburtsdatum des Ansprechpartners Datum (TT.MM.JJJJ) Optional
KP_Geburtsname Geburtsname des Ansprechpartners Text Optional

Abweichender Postempfänger

Der abweichende Postempfänger wird nur angelegt, wenn Vor- oder Nachname angegeben sind.

Spalte in MBS 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_Namenszusatz Namenszusatz des Postempfängers Text Optional
RA_Firma Firma Text Optional
RA_Umsatzsteuer_Id Umsatzsteuer-ID des Postempfängers Text Optional
RA_Geburtsdatum Geburtsdatum des Postempfängers Datum (TT.MM.JJJJ) Optional
RA_Telefon Telefonnummer des Postempfängers Numerisch Optional
RA_EMail_Adresse E-Mail-Adresse des Postempfängers E-Mail-Adresse Optional
RA_PLZ PLZ zur Postanschrift Numerisch Optional
RA_Ort Ort zur Postanschrift Text Optional
RA_Strasse 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_Adresszusatz Adresszusatz zur Postanschrift Text Optional

Lieferstelle

Spalte in MBS Bedeutung Mögliche Werte Pflicht
LA_PLZ Postleitzahl der Lieferadresse Numerisch Pflichtfeld
LA_Ort Stadt zur Lieferadresse Text Pflichtfeld
LA_Strasse 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“) Optional
LA_Adresszusatz Adresszusatz zur Lieferadresse Text Optional
AD_Zaehlernummer Zählernummer der Lieferstelle Text Pflichtfeld
AD_Anmelde_Zaehlpunkt Zählpunkt der Lieferstelle Text Optional
AD_Marktlokation Marktlokation der Lieferstelle Text Optional
AD_Netzbetreiber_ID Netzbetreiber der Lieferstelle Text Optional
AD_Spannungsebene Spannungsebene laut Kundenangabe Text Optional
AD_Gesamtverbrauch Kunden-Prognose (Wichtig: HT + NT) Numerisch Pflichtfeld
AD_Gesamtverbrauch_m3 Prognose in m³ (Wasser/Abwasser) Numerisch Optional

Lieferbeginn und Altlieferant

Spalte in MBS Bedeutung Mögliche Werte Pflicht
AD_Terminwunsch Gewünschter Termin des Lieferbeginns Datum (TT.MM.JJJJ) Optional
AD_Neueinzug Neueinzug Standard: true, Dynamisch: Datum (TT.MM.JJJJ) Optional
AD_Neuanlage Neuanlage Text (true/false) Optional
AD_Kundennummer Kundennummer beim Altlieferanten Text Optional
AD_Vorlieferant_Code ILN-Nummer vom Altlieferanten Text Optional
AD_Vorlieferant_gekuendigt Wurde der Altlieferant vom Kunden gekündigt? true Optional
AD_Gekuendigt Kündigungsdatum beim Altlieferanten Datum (TT.MM.JJJJ) Pflichtfeld (wenn Altlieferant gekündigt)

Bankdaten

Die Bankdaten werden nur übernommen, wenn BD_IBAN angegeben ist. Ist BD_Zahlweg weder “Bankeinzug” noch “Lastschrift”, wird das Konto nur für Auszahlungen verwendet.

Spalte in MBS 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)
BD_Sepa_Mandats_ID ID des SEPA-Mandats Text Optional (bei Bankeinzug)
BD_Sepa_Unterschriftsdatum Unterschriftsdatum des SEPA-Mandats Datum (TT.MM.JJJJ) Optional (bei Bankeinzug)
BD_Virtuelle_Kontonummer Virtuelle Kontonummer des Kunden Text Optional

Zahlungsdaten

Die Zahlungsdaten werden nur übernommen, wenn mindestens eine Spalte dieser Tabelle gefüllt ist. Sie haben dann Vorrang vor den Bankdaten (BD_). Mit einer IBAN in ZD_IBAN ist die Zahlart Lastschrift und das SEPA-Mandat wird angelegt.

Spalte in MBS Bedeutung Mögliche Werte Pflicht
ZD_IBAN IBAN des Zahlungskontos (Lastschrift) Text (Format: IBAN) Optional
ZD_BIC BIC des Zahlungskontos. Bei einer deutschen IBAN wird sie aus der IBAN ermittelt. Text (Format: BIC) Optional
ZD_Bank Bankname des Zahlungskontos. Bei einer deutschen IBAN wird er aus der IBAN ermittelt. Text Optional
ZD_Kontoinhaber Kontoinhaber des Zahlungskontos Text Optional
ZD_Sepa_Mandats_ID Referenz des SEPA-Mandats. Ist sie leer, wird sie erzeugt. Text Optional
ZD_Sepa_Unterschriftsdatum Unterschriftsdatum des SEPA-Mandats. Ist es leer, wird das Abschlussdatum verwendet. Datum (TT.MM.JJJJ) Optional
ZD_Auszahlung_IBAN IBAN des Auszahlungskontos. Ist sie leer oder gleich ZD_IBAN, wird das Zahlungskonto auch als Auszahlungskonto verwendet. Text (Format: IBAN) Optional
ZD_Auszahlung_BIC BIC des Auszahlungskontos. Bei einer deutschen IBAN wird sie aus der IBAN ermittelt. Text (Format: BIC) Optional
ZD_Auszahlung_Bank Bankname des Auszahlungskontos. Bei einer deutschen IBAN wird er aus der IBAN ermittelt. Text Optional
ZD_Auszahlung_Kontoinhaber Kontoinhaber des Auszahlungskontos Text Optional

Vertragsdaten

Spalte in MBS Bedeutung Mögliche Werte Pflicht
Vertriebspartner_NR externe ID des Imports Text (z. B. 002) Optional
Vertriebspartner_name Name des Vertriebspartners Text Optional
MBS_Vertragsnr Vertragsnummer Text Optional
AD_Abschlussdatum Wann wurde der Vertrag unterschrieben? Datum (TT.MM.JJJJ) Pflichtfeld
AD_Datum_Lieferende Ende der Lieferung Datum (TT.MM.JJJJ) Optional
AD_Rechnungsintervall Rechnungsintervall 1 3 6 12 Optional, 12 (Jährlich) ist der Standard
AD_Abschlagsintervall Gewünschtes Abschlagsintervall in Monaten Numerisch Optional
AD_Kein_Abschlagsplan Soll kein Abschlagsplan angelegt werden? true/false oder ja/nein Optional
Typ Vertragstyp SLP RLM TLP Optional, SLP ist der Standard
AD_Stromsteuerbefreit Ist der Vertrag von der Stromsteuer befreit? true/false oder ja/nein Optional
AD_Kommunikationsweg Bevorzugter Kommunikationsweg EMAIL LETTER ARCHIVE_ONLY Optional
AD_Kontierungsmerkmal Kontierungsmerkmal Numerisch Optional

EnWG und EnFG

Die Werte werden unverändert als Text übernommen.

Spalte in MBS Bedeutung Mögliche Werte Pflicht
AD_EnFG_Voraussetzung Voraussetzung nach EnFG Text Optional
AD_EnFG_Privilegierungsgrund Grund der Privilegierung nach EnFG Text Optional
AD_Steuerkanal Steuerkanal Text Optional
AD_Weitere_Technische_Einrichtungen Weitere technische Einrichtungen Text Optional
AD_EnWG_Modul EnWG-Modul Text Optional
AD_Anlagenart Art der Anlage Text Optional
AD_EnWG_Inbetriebnahmedatum Inbetriebnahmedatum nach EnWG Text, wird nicht als Datum geprüft Optional
AD_Zusatzinformationen Zusätzliche Informationen Text Optional

Wasser und Abwasser

Die Felder für Wasser- und Abwasserverträge werden nur übernommen, wenn mindestens eine Spalte dieser Tabelle gefüllt ist. Die Werte werden eingelesen und für die Anlage von Wasser- und Abwasserverträgen bereitgestellt. Für die Zahlungsdaten (WA_ZD_*) gelten dieselben Regeln wie bei den Zahlungsdaten.

Spalte in MBS Bedeutung Mögliche Werte Pflicht
WA_Tarif_ID ID des Tarifs für Wasser Numerisch Optional
WA_Abwasser_Tarif_ID ID des Tarifs für Abwasser Numerisch Optional
WA_Ablesestrategie Art der Ablesung des Zählers (Karte oder Funk) Text Optional
WA_Gesperrt Ist der Vertrag gesperrt? true/false oder ja/nein Optional, nein ist der Standard
WA_Fallklasse Legt fest, ob ein Wasser- und/oder Abwasservertrag angelegt wird WATER WASTEWATER WATER_AND_WASTEWATER Pflicht
WA_Kontextvertrag Vertragsnummer des Vertrags, dem der neue Vertrag angehängt wird Text Optional
WA_Altvertrag_Wasser Vertragsnummer des zu beendenden Wasservertrags Text Optional
WA_Altvertrag_Abwasser Vertragsnummer des zu beendenden Abwasservertrags Text Optional
WA_ZD_IBAN IBAN des Zahlungskontos (Lastschrift) Text (Format: IBAN) Optional
WA_ZD_BIC BIC des Zahlungskontos. Bei einer deutschen IBAN wird sie aus der IBAN ermittelt. Text (Format: BIC) Optional
WA_ZD_Bank Bankname des Zahlungskontos. Bei einer deutschen IBAN wird er aus der IBAN ermittelt. Text Optional
WA_ZD_Kontoinhaber Kontoinhaber des Zahlungskontos Text Optional
WA_ZD_Sepa_Mandats_ID Referenz des SEPA-Mandats. Ist sie leer, wird sie erzeugt. Text Optional
WA_ZD_Sepa_Unterschriftsdatum Unterschriftsdatum des SEPA-Mandats. Ist es leer, wird das Abschlussdatum verwendet. Datum (TT.MM.JJJJ) Optional
WA_ZD_Auszahlung_IBAN IBAN des Auszahlungskontos. Ist sie leer oder gleich WA_ZD_IBAN, wird das Zahlungskonto auch als Auszahlungskonto verwendet. Text (Format: IBAN) Optional
WA_ZD_Auszahlung_BIC BIC des Auszahlungskontos. Bei einer deutschen IBAN wird sie aus der IBAN ermittelt. Text (Format: BIC) Optional
WA_ZD_Auszahlung_Bank Bankname des Auszahlungskontos. Bei einer deutschen IBAN wird er aus der IBAN ermittelt. Text Optional
WA_ZD_Auszahlung_Kontoinhaber Kontoinhaber des Auszahlungskontos Text Optional

Vertragszusatzfelder

Beim Vertragsimport können die Vertragszusatzfelder ebenfalls mitgegeben werden. Der technische Name aus der Konfiguration der Vertragszusatzfelder muss als Spaltenname in der CSV-Datei verwendet werden, damit der Import funktioniert. Alternativ kann in der Konfiguration ein Eintrag mit dem technischen Namen als “Spalte in MBS” angelegt und einer beliebigen CSV-Spalte zugeordnet werden. Format, Operation und Pflichtfeld gelten auch für diese Einträge. Die Kopfzeile wird für Vertragszusatzfelder nur geprüft, wenn ein Eintrag mit einer Spalte in der Importdatei existiert. Unbekannte Spalten werden ignoriert.

Bonitätsprüfung

In der Datenbanktabelle fl_ratingThresholdData kann für jede Kombination aus Sparte und Geschäftsform eine oder mehrere Risikoklassen festgelegt werden, die zur automatischen Ablehnung des Vertrags führen. Die Risikoklassen werden dabei mit den Kürzeln “R1” bis “R6” gekennzeichnet. Wird bei einem Vertragsimport die Spalte “KD_Bonitaets_Score” innerhalb der CSV-Datei definiert, wird die Datenbanktabelle auf die Kombination aus Sparte, Geschäftsform und Risikoklasse durchsucht. Ist ein entsprechender Datensatz vorhanden, so wird der Vertrag mit Sperrgrund “Bonität” gesperrt und eine entsprechende E-Mail an den Kunden versendet.

Hinweise zum angelegten Tarif

Am durch den Vertragsimport angelegten Tarif werden folgende Merkmale gesetzt:

  • Quelle = DELIVERY_START
  • Zuweisungsart = TARIFF_CHANGE

Änderungen MDB-20

Mit MDB-20 wurde der Vertragsimport auf ein zentrales Mapping umgestellt: Alle Formate werden durch Vertragsimportkonfigurationen beschrieben.

Was Sie nach dem Update tun müssen

  • Führen Sie jeden konfigurierten und genutzten Import (Verivox, Check24, Interne Plattform, kundenindividuell, Standard) einmal in einer Testumgebung mit einer bisherigen Importdatei aus. Prüfen Sie dabei vor allem Preise, Boni und Lieferbeginn.
  • Fehlende Spalten in der CSV werden jetzt als Fehler gemeldet, alle in einer Meldung. Schalten Sie Felder, die die CSV-Datei nicht liefert, in der Konfiguration aus.
  • Die Standardkonfiguration (ohne Identifikationsspalte) darf nicht gelöscht werden.
  • Konfigurationen mit leerer oder fehlender Identifikationsspalte wurden stillgelegt (Präfix MIGRATION_UNGUELTIG_). Legen Sie sie bei Bedarf neu an.

Was sich geändert hat

  • Die Oberfläche zeigt nur noch konfigurierte Einträge aus der Datenbank. Es gibt keine automatisch angelegten leeren Einträge mehr.
  • Die Spaltennamen heißen jetzt LA_Strasse, KD_Strasse, RA_Strasse, AD_Gekuendigt, AD_Zaehlernummer und AD_Vorlieferant_Code. Außerdem wurden die Feldnamen vereinheitlicht, zum Beispiel T_Tarife_ID, T_AP_Brutto, AD_Abschlussdatum, AD_Rechnungsintervall, BD_Sepa_Mandats_ID, BD_Virtuelle_Kontonummer und AD_Neuanlage statt IsInitialSupply (alle Namen siehe Aufbau Formate). Bestehende Konfigurationen wurden automatisch angepasst und behalten ihre bisherigen CSV-Spalten, die Spalten der Importdateien bleiben unverändert.
  • Entfallen sind 38 nicht ausgewertete Felder (siehe unten). Ihre Spalten landen wie jede unbekannte Spalte in den Vertragszusatzfeldern, sofern sie unter dem Namen konfiguriert sind.

Standardimport und Import der Internen Plattform

Bisher gab es zwei fest programmierte CSV-Formate ohne eigene Konfiguration:

  • Standardimport (bisher Default-Import): Er wurde verwendet, wenn keine andere Konfiguration passte. Die Spaltennamen entsprachen den alten internen Feldnamen. Preise wurden in Euro übernommen, Werte unverändert.
  • Interne Plattform: Er wurde verwendet, wenn die Datei die Spalte Interne_Plattform_ID enthielt. Die Spaltennamen entsprachen dem Verivox-Format. Es galten die Verivox-Regeln, mit einigen wenigen Ausnahmen, siehe oben.

Beide Formate sind jetzt normale Konfigurationen unter “Vertragsimport-Konfiguration” (Standardkonfiguration und Interne Plattform) und wurden bei der Migration automatisch angelegt.

So erkennen Sie, welchen Import Sie bisher genutzt haben

Ihre CSV-Datei … bisher genutzt
hat in der Kopfzeile eine Spalte Interne_Plattform_ID Interne Plattform
hat in der Kopfzeile die Identifikationsspalte einer eigenen Konfiguration, z. B. Verivox_ID oder Portal_ID die Konfiguration
hat keine dieser Spalten, die Spalten heißen z. B. Kvorname, Knachname, Tarife_ID Standardimport

Müssen Sie Ihre CSV-Dateien ändern?

  • Standardimport: nein. Die Standardkonfiguration bildet die bisherigen Spaltennamen auf die neuen Feldnamen ab. Fehlende Spalten werden wie bisher ignoriert, die Felder bleiben dann leer.
  • Interne Plattform: in der Regel nein, mit zwei Ausnahmen:
    • Interne_Plattform_ID muss in der Kopfzeile stehen. Bisher reichte es, wenn der Text irgendwo in der Datei vorkam.
  • Konfigurationsimport (eigene Konfigurationen): nein, diese Importe funktionieren unverändert.
  • Gernerell gilt - Fehlende Spalten werden jetzt gemeldet. Erwartet die Konfiguration eine Spalte, die Ihre Datei nicht enthält, bricht der Import mit der Liste aller fehlenden Spalten ab. Dann ergänzen Sie entweder die Spalte in der Datei oder schalten das Feld in der Konfiguration aus.

Neue Felder

Der Vertragsimport kennt neue Felder, beschrieben in Beschreibung der Felder. Sie sind in bestehenden Konfigurationen ausgeschaltet und lassen sich über einen Eintrag mit “Spalte in Importdatei” aktivieren. Die Standardkonfiguration liest sie aus Spalten mit dem Namen des Feldes.

  • Ansprechpartner (KP_*): Anrede, Titel, Vorname, Nachname, Namenszusatz, Firma, Kundennummer, USt-Id, Telefon, Mobil, Fax, E-Mail, Geburtsdatum, Geburtsname.
  • Zahlungsdaten (ZD_*): Zahlungs- und Auszahlungskonto (IBAN, BIC, Bank, Kontoinhaber) und SEPA-Mandat. Sie haben Vorrang vor den Bankdaten (BD_*). Eine leere BIC oder Bank wird bei deutschen IBANs ermittelt, ein leeres Mandat wird erzeugt.
  • EnWG/EnFG: AD_EnFG_Voraussetzung, AD_EnFG_Privilegierungsgrund, AD_Steuerkanal, AD_Weitere_Technische_Einrichtungen, AD_EnWG_Modul, AD_Anlagenart, AD_EnWG_Inbetriebnahmedatum, AD_Zusatzinformationen.
  • Wasser und Abwasser (WA_*): Tarife, Ablesestrategie, Sperre, Fallklasse, Kontext- und Altverträge sowie Zahlungsdaten (WA_ZD_*) für Wasser- und Abwasserverträge, siehe Wasser und Abwasser.
  • Weitere: KD_Namenszusatz, RA_Namenszusatz und AD_Kein_Abschlagsplan (kein Abschlagsplan beim Vertrag).

Entfallene Felder

38 Felder fallen weg, da sie nicht genutzt wurden:

  • Alt_Lieferant_ID, Netzgebiet_ID, Verbrauchsart, KFirma_zusatz
  • AAnrede, ATitel, AVorname, ANachname
  • AAnrede_2, Atitel_2, AVorname_2, ANachname_2
  • AFirma, AFirma_zusatz, APLZ, AOrt
  • AStrasse_Postfach, AHaus_Nr, AHaus_Nr_Zusatz
  • Vertrieb_unterstruktur, Kontaktart
  • EAnrede_2, EVorname_2, ENachname_2, EFirma_zusatz
  • Verbrauch_NT_Kundenangabe, Leistung_Kundenangabe, Netz_Identcode
  • untergrenze, Obergrenze, grenze_Prozent
  • AP_untergrenze, GP_untergrenze, AP_obergrenze, GP_obergrenze
  • Preisgarantie, Paketgroesse
  • SchufaKlasse (bei Verivox KD_Schufa_Klasse)