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

Import-Datei

Aufbau

Die Import-Datei mit den anzupassenden Verträgen muss im CSV-Format vorliegen und folgende Spalten enthalten:

Spalte Beschreibung Pflichtangabe? Datentyp Mögliche Inhalte Beispiel
Vertragsnummer Nummer des MBS-Vertrags, der angepasst werden soll Pflichtfeld Integer 64 Bit Ganze positive Zahl 11002877654
Neue_Tarif-ID MBS-Tarif ID, des Tarifes der in Zukunft für den Vertrag gelten soll Optional, wenn gesetzt handelt es sich um Tarifwechsel Integer 64 Bit Ganze positive Zahl 1234567890
Preiskomponente_Typ MBS-Name des Preiskomponenten-Typs Optional, wenn gesetzt müssen Preise für die Komponente angegeben sein Text Text aus der Spalte "Name" aus Tarifkonfiguration - Preiskomponenten anzeigen Regionale Preise
Neuer_Grundpreis Netto-Betrag in €, auf den der Grundpreis der Preiskomponete geändert werden soll. Optional Decimal leer oder 0-... 9,99
Neuer_Arbeitspreis Netto-Arbeitspreis in ct, auf den der Arbeitspreis der Preiskomponente geändert werden soll. Optional Decimal leer oder 0-... 23
Grundpreisdifferenz Netto-Betrag in €, der mit dem aktuellen Grundpreis der Komponente addiert wird Optional Decimal leer oder negative oder positive Werte 110
Arbeitspreisdifferenz Netto-Betrag in ct, der mit dem aktuellen Arbeitspreis der Komponente addiert wird Optional Decimal leer oder negative oder positive Werte 2
Gueltig_ab Datum, zu dem die Änderung wirksam werden soll Pflichtfeld Datum dd.MM.yyyy 01.01.2020
E-Mail_Template Vorlage für E-Mails, die ggf. aus dem entsprechenden Prozess zur Tarifänderung automatisch versendet werden. Optional Text Muss dem Namen eines in MBS gepflegten E-Mail-Templates entsprechen Eigenes Template
Attachment_Template Vorlage für Post Attachments, die ggf. aus dem entsprechenden Prozess zur Tarifänderung automatisch versendet werden. Optional Text Muss dem Namen eines in MBS gepflegten Templates entsprechen Eigenes Template
Bonus_anwenden Vorlage für Post Attachments, die ggf. aus dem entsprechenden Prozess zur Tarifänderung automatisch versendet werden. Optional Boolean "true" oder "false" bzw. leer entspricht false true
Laufzeitverlaengerung Verlängert die Laufzeit des aktuellen Tarifs um den angegebenen Wert. Optional Integer 64 Bit Ganze positive Zahl 12
Bonus_einbuchen Ein Bonus wird dem Vertrag eingebucht (Bonus-Applikation wird erstellt). Der Bonus muss existieren und aktiv sein. Die Angabe entspricht der ID des jeweiligen Bonus. Optional Integer 64 Bit Ganze positive Zahl 2
Bonus_manuell_einbuchen Ein Bonus wird dem Vertrag eingebucht (Manuelle Buchung wird erstellt). Der Bonus muss existieren und aktiv sein. Die Angabe entspricht der ID des jeweiligen Bonus. Optional Integer 64 Bit Ganze positive Zahl 2
KA_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
KA_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
KA_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
KWK_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
KWK_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
KWK_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
P19_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
P19_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
P19_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Offshore_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Offshore_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Offshore_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Netz-AP_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Netz-AP_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Netz-AP_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Rest-AP_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Rest-AP_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Rest-AP_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Netz-GP_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Netz-GP_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Netz-GP_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
MSB_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
MSB_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
MSB_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Rest-GP_alt Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Rest-GP_neu Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99
Rest-GP_Diff Versorgeranteil Optional Decimal leer oder negative oder positive Werte 9,99

Beispiel

Vertragsnummer;Neue_Tarif-ID;Preiskomponente_Typ;Neuer_Grundpreis;Neuer_Arbeitspreis;Grundpreisdifferenz;Arbeitspreisdifferenz;Gueltig_ab;E-Mail_Template;Attachement_Template;Bonus_anwenden;Bonus_einbuchen;Laufzeitverlaengerung;Bonus_manuell_einbuchen
11050563739;;;;;;;28.01.2021;;;;;;;

Beispiel mit Versorgeranteilen

Vertragsnummer;Neue_Tarif-ID;Preiskomponente_Typ;Neuer_Grundpreis;Neuer_Arbeitspreis;Grundpreisdifferenz;Arbeitspreisdifferenz;Gueltig_ab;E-Mail_Template;KA_alt;KA_neu;KA_Diff;KWK_alt;KWK_neu;KWK_Diff;P19_alt;P19_neu;P19_Diff;Offshore_alt;Offshore_neu;Offshore_Diff;Netz-AP_alt;Netz-AP_neu;Netz-AP_Diff;Rest-AP_alt;Rest-AP_neu;Rest-AP_Diff;Netz-GP_alt;Netz-GP_neu;Netz-GP_Diff;MSB_alt;MSB_neu;MSB_Diff;Rest-GP_alt;Rest-GP_neu;Rest-GP_Diff
11059167640;;Regionale Preise;10;29;;;02.09.2024;;2;3;1;3;4;1;4;5;1;5;6;1;6;7;1;7;8;1;8;9;1;9;11;2;11;14;3

Restriktionen

Zusätzlich zu den im Aufbau der Datei beschriebenen Restriktionen:

  • Für einen Vertrag darf nur ein Datensatz im Import vorhanden sein
  • Eine mögliche noch existierende Preisgarantie wird nicht berücksichtigt
  • Laufzeit, Kündigungsfristen und Preisgarantien werden 1:1 von der alten Tarifzuordnung übernommen.
  • Falls Preise überschrieben werden, gelten nach Ablauf der Preisgarantie wieder die dynamisch ermittelten Preise und nicht mehr die Preise aus diesem Import

Szenarien

Es existieren zwei Hauptszenarien Tarifwechsel und Preisanpassung. Welches Szenario gewählt wird, entscheidet das Setzen der Tarif-ID. Ist das Feld Neue_Tarif-ID leer, handelt es sich um eine Preisanpassung. Ist das Feld Neue-Tarif-ID befüllt, handelt es sich um einen Tarifwechsel.

Tarifwechsel

Das Feld Neue_Tarif-ID ist gesetzt. Die Tarif-ID muss in MBS als solche existieren und der Tarif muss aktiv sein. Die Eigenschaften vom neuen Tarif werden dann übernommen. Die Preise werden ebenfalls pro am Tarif hinterlegter Preiskomponente berechnet und am Vertrag des Kunden hinterlegt. Eine Besonderheit bei den Preiskomponenten stellt eine individuelle Preiskomponente dar. Besitzt der Tarif eine individuelle Preiskomponente, so müssen im Import Preise für diese angegeben werden. Es muss der Name der Preiskomponente und als Preise die absoluten Werte angegeben werden!

Bonus anwenden

Das Feld Neue_Tarif-ID ist gesetzt und es gelten die Voraussetzungen wie bei einem Tarifwechsel. Zusätzlich kann das Feld Bonus_anwenden konfiguriert werden, um einen existierenden Bonus, der dem Tarif zugewiesen ist, anzuwenden.

Um die Anwendung durchzuführen, ist das Feld mit dem Wert “true” zu belegen. Sind mehrere Boni am Tarif hinterlegt, werden alle angewendet.

Ist das Feld nicht gesetzt oder “false” wird keine Bonusanwendung durchgeführt.

Das Feld wird nicht berücksichtigt, wenn Neue_Tarif-ID nicht gesetzt ist.

Preisanpassung

Das Feld Neue_Tarif-ID ist nicht gesetzt. Die Eigenschaften vom bestehenden Tarif werden kopiert. Die Preise für die entsprechend hinterlegten Preiskomponenten werden, falls möglich, neu berechnet (z. B. Regionale Preise) und am Vertrag hinterlegt. Sollte eine individuelle Preiskomponente existieren, werden die Preise zunächst beibehalten. Ist im Import die individuelle Preiskomponente angegeben, werden die Preise entweder mit den absoluten Werten oder mit den Differenzwerten berechnet und hinterlegt. Sollte eine nicht individuelle Preiskomponente angegeben werden, werden die absoluten oder die Differenzen auf diese angewendet. Im Fall der Differenzen werden diese auf die ursprünglichen Preise angewendet.

Versorgeranteile

Die Felder, die mit Versorgeranteile gekennzeichnet sind (KA_alt, KA_neu, KA_Diff, …), werden in einer separaten Tabelle gespeichert, um im passenden DataSet ausgegeben zu werden.

Folgende Prüfungen finden statt, damit der Datensatz erkannt und angelegt wird:

1) Bei dem Import muss es sich um eine Preisanpassung handeln 2) Die Preisanpassung ist erfolgreich importiert worden (es liegen für den Datensatz keine Validierungsfehler vor) 3) Wenigstens ein Wert aus dieser Gruppe ist explizit angegeben 4) Wird ein Datensatz angelegt und manche Werte sind nicht gesetzt, werden diese automatisch als 0 angenommen

Tarifanpassung

Im Gegensatz zu einem Tarifwechsel grenzt eine Tarifanpassung nicht den aktiven Tarif ab, sondern ändert gezielt bestimmte Attribute. Derzeit werden folgendene Aktionen unterstützt.

  • Laufzeitverlaengerung: eine bestehende Laufzeit wird um die Angabe erhöht (Neuer Wert = alter wert + Angabe)
  • Bonus_manuell_einbuchen: ein bestehender Bonus wird in das Debitorenkonto des Kunden eingebucht. Als Betrag wird der Wert aus der Konfiguration genommen. Die Fälligkeit entspricht der Konfiguration (z.B. X Tage nach Lieferbeginn) oder dem Ende des nächsten Werktages, jenachdem welches Datum später und nicht in der Vergangenheit liegt.
  • Bonus_einbuchen: ein bestehender Bonus wird als Bonus-Applikation für den Kunden angelegt. Als Betrag wird der Wert aus der Konfiguration genommen. Die Fälligkeit entspricht der Konfiguration (z.B. X Tage nach Lieferbeginn) oder dem Ende des nächsten Werktages, jenachdem welches Datum später und nicht in der Vergangenheit liegt.

Alle Fälle zur Tarifanpassung können nur angewendet werden, wenn kein Tarifwechsel (Neue_Tarif-ID ist gesetzt) oder eine Preisanpassung (Preiskomponente_Typ ist gesetzt) vorliegt.

Ablaufübersicht

Mailversand

Über das Feld E-Mail_Template im Import kann gesteuert werden, ob eine E-Mail über die Preisanpassung oder Tarifänderung an den Kunden versandt wird. Ist dieses Feld gefüllt, muss das Template im System existieren. Ist es nicht gefüllt, wird keine E-Mail versendet.

Gueltig_ab

normalerweise werden nur Preisanpassungen für die Zukunft akzeptiert. Falls eine Preisanpassung für die Vergangenheit importiert werden soll, muss die GlobalProperty PRICE_ADJUSTMENT_ACCEPT_CHANGEDATE_IN_PAST = true gesetzt werden.

Testen

Es wird empfohlen Preisanpassungen vorab auf dem Testsystem zu testen

Prozessübersicht

Die folgende Matrix zeigt die erlaubten Kombinationen an anzugebenden Feldern je Prozess:

Feld Preisanpassung Tarifwechsel Tarifanpassung
Vertragsnummer Pflichtangabe Pflichtangabe Pflichtangabe
Neue_Tarif-ID Verboten Pflichtangabe  
Preiskomponente_Typ Pflichtangabe Verboten Verboten
Neuer_Grundpreis * Verboten Verboten
Neuer_Arbeitspreis * Verboten Verboten
Grundpreisdifferenz * Verboten Verboten
Arbeitspreisdifferenz * Verboten Verboten
Gueltig_ab Pflichtangabe Pflichtangabe Pflichtangabe
E-Mail_Template Optional Optional Optional
Attachment_Template Optional Optional Optional
Bonus_anwenden Ignoriert Optional Ignoriert
Bonus_einbuchen Ignoriert Ignoriert Optional
Bonus_manuell_einbuchen Ignoriert Ignoriert Optional
Laufzeitverlaenerung Ignoriert Ignoriert Optional
KA_alt Optional Ignoriert Ignoriert
KA_neu Optional Ignoriert Ignoriert
KA_Diff Optional Ignoriert Ignoriert
KWK_alt Optional Ignoriert Ignoriert
KWK_neu Optional Ignoriert Ignoriert
KWK_Diff Optional Ignoriert Ignoriert
P19_alt Optional Ignoriert Ignoriert
P19_neu Optional Ignoriert Ignoriert
P19_Diff Optional Ignoriert Ignoriert
Offshore_alt Optional Ignoriert Ignoriert
Offshore_neu Optional Ignoriert Ignoriert
Offshore_Diff Optional Ignoriert Ignoriert
Netz-AP_alt Optional Ignoriert Ignoriert
Netz-AP_neu Optional Ignoriert Ignoriert
Netz-AP_Diff Optional Ignoriert Ignoriert
Rest-AP_alt Optional Ignoriert Ignoriert
Rest-AP_neu Optional Ignoriert Ignoriert
Rest-AP_Diff Optional Ignoriert Ignoriert
Netz-GP_alt Optional Ignoriert Ignoriert
Netz-GP_neu Optional Ignoriert Ignoriert
Netz-GP_Diff Optional Ignoriert Ignoriert
MSB_alt Optional Ignoriert Ignoriert
MSB_neu Optional Ignoriert Ignoriert
MSB_Diff Optional Ignoriert Ignoriert
Rest-GP_alt Optional Ignoriert Ignoriert
Rest-GP_neu Optional Ignoriert Ignoriert
Rest-GP_Diff Optional Ignoriert Ignoriert

* bei einer Preisanpassung sind entweder Neuer_Grundpreis und Neuer_Arbeitspreis Pflicht oder Grundpreisdifferenz und Arbeitspreisdifferenz.