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.