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 Tarifs, der in Zukunft für den Vertrag gelten soll Optional Integer 64 Bit Ganze positive Zahl 1234567890
Zuweisungsart Zuweisungsart des Tarifs, der in Zukunft für den Vertrag gelten soll Pflichtfeld Text siehe Abschnitt "Szenarien" TARIFF_CHANGE
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;Zuweisungsart;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;PRICE_ADJUSTMENT;;Regionale Preise;10;29;;28.01.2021;;;;;;

Beispiel mit Versorgeranteilen

Vertragsnummer;Zuweisungsart;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;PRICE_ADJUSTMENT;;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

Das Feld “Zuweisungsart” legt fest, welches Szenario ausgeführt wird. Die folgenden Ausprägungen sind möglich und werden im Folgenden näher beschrieben:

  • TARIFF_CHANGE - Tarifwechsel
  • PRICE_ADJUSTMENT - Preisanpassung
  • INDIVIDUAL_PRICE_ADJUSTMENT - Preisanpassung mit individueller Preiskomponente
  • TARIFF_CHANGE_PRICE_ADJUSTMENT - Preisanpassung im Sinne eines Tarifwechsels
  • TARIFF_ADJUSTMENT - Tarifanpassung

Tarifwechsel

Das Feld Neue_Tarif-ID muss gesetzt sein. 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 muss gesetzt sein 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.

Preisanpassung

Das Feld Neue_Tarif-ID darf nicht gesetzt sein. 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. Die angegebene Preiskomponente darf nicht vom Typ “Individuell” sein. Die Preise werden entweder mit den absoluten Werten oder mit den Differenzwerten berechnet und auf die angegebene Preiskomponente - und im Fall von Differenzwerten auf deren ursprüngliche Preise - angewandt.

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

Preisanpassung mit individueller Preiskomponente

Das Feld Neue_Tarif-ID muss gesetzt sein. Der angegebene Tarif muss derselbe sein, der dem Vertrag aktuell zugeordnet ist und die angegebene Preiskomponente muss dem angegebenen Tarif zugewiesen sein. Die angegebene Preiskomponente muss vom Typ “Individuell” sein. Ansonsten funktioniert dieses Szenario analog zur Preisanpassung für nicht-individuelle Preiskomponenten.

Tarifwechsel im Sinne einer Preisanpassung

Das Feld Neue_Tarif-ID muss gesetzt sein. Es gelten dieselben Voraussetzungen wie bei einem Tarifwechsel. Laufzeit und Fristen werden jedoch vom vorhandenen Tarif übernommen. Die Preise für die entsprechend hinterlegten Preiskomponenten werden, falls möglich, neu berechnet und am Vertrag hinterlegt.

Tarifanpassung

Im Gegensatz zu einem Tarifwechsel grenzt eine Tarifanpassung nicht den aktiven Tarif ab, sondern ändert gezielt bestimmte Attribute.

Es muss mindestens eines der folgenden Felder gesetzt sein:

  • 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, je nachdem 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, je nachdem welches Datum später und nicht in der Vergangenheit liegt.

Die Felder Neue_Tarif-ID und Preiskomponente_Typ dürfen nicht gesetzt sein.

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 Preisanpassung
(individuelle Preiskomponente)
Tarifwechsel
inkl. Tarifwechsel im Sinne einer Preisanpassung
Tarifanpassung
Vertragsnummer Pflichtangabe Pflichtangabe Pflichtangabe Pflichtangabe
Zuweisungsart Pflichtangabe Pflichtangabe Pflichtangabe Pflichtangabe
Neue_Tarif-ID Verboten Pflichtangabe Pflichtangabe Verboten
Preiskomponente_Typ Pflichtangabe Pflichtangabe Verboten Verboten
Neuer_Grundpreis * * Verboten Verboten
Neuer_Arbeitspreis * * Verboten Verboten
Grundpreisdifferenz * * Verboten Verboten
Arbeitspreisdifferenz * * Verboten Verboten
Gueltig_ab Pflichtangabe Pflichtangabe Pflichtangabe Pflichtangabe
E-Mail_Template Optional Optional Optional Optional
Attachment_Template Optional Optional Optional Optional
Bonus_anwenden Ignoriert Ignoriert Optional Ignoriert
Bonus_einbuchen Ignoriert Ignoriert Ignoriert Optional
Bonus_manuell_einbuchen Ignoriert Ignoriert Ignoriert Optional
Laufzeitverlaenerung Ignoriert Ignoriert Ignoriert Optional
KA_alt Optional Optional Ignoriert Ignoriert
KA_neu Optional Optional Ignoriert Ignoriert
KA_Diff Optional Optional Ignoriert Ignoriert
KWK_alt Optional Optional Ignoriert Ignoriert
KWK_neu Optional Optional Ignoriert Ignoriert
KWK_Diff Optional Optional Ignoriert Ignoriert
P19_alt Optional Optional Ignoriert Ignoriert
P19_neu Optional Optional Ignoriert Ignoriert
P19_Diff Optional Optional Ignoriert Ignoriert
Offshore_alt Optional Optional Ignoriert Ignoriert
Offshore_neu Optional Optional Ignoriert Ignoriert
Offshore_Diff Optional Optional Ignoriert Ignoriert
Netz-AP_alt Optional Optional Ignoriert Ignoriert
Netz-AP_neu Optional Optional Ignoriert Ignoriert
Netz-AP_Diff Optional Optional Ignoriert Ignoriert
Rest-AP_alt Optional Optional Ignoriert Ignoriert
Rest-AP_neu Optional Optional Ignoriert Ignoriert
Rest-AP_Diff Optional Optional Ignoriert Ignoriert
Netz-GP_alt Optional Optional Ignoriert Ignoriert
Netz-GP_neu Optional Optional Ignoriert Ignoriert
Netz-GP_Diff Optional Optional Ignoriert Ignoriert
MSB_alt Optional Optional Ignoriert Ignoriert
MSB_neu Optional Optional Ignoriert Ignoriert
MSB_Diff Optional Optional Ignoriert Ignoriert
Rest-GP_alt Optional Optional Ignoriert Ignoriert
Rest-GP_neu Optional Optional Ignoriert Ignoriert
Rest-GP_Diff Optional Optional Ignoriert Ignoriert

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