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.