getPriceInformationForTariffChange
Beschreibung
Diese Schnittstelle selektiert für einen aktiven Vertrag in MBS alle möglichen Tarifwechsel-Optionen inklusive der zugehörigen Preise.
Die Optionen werden durch die Pflege der Tarifwechselmatrix ermittelt. Sind keine Optionen über die Tarifwechselmatrix gepflegt, liefert diese Schnittstelle keine Ergebnisse.
URL
/portal/pricecalculation/getPriceInformationForTariffChange
Input
POST
{
"consumption": 10000,
"contractNumber": "11035528224",
"requestDate": "2024-09-01T10:06:50.224Z"
}
Output
{
"isSufficientInformationProvided": true,
"priceInformation": [
{
"tariff": {
"periodStart": null,
"periodEnd": null,
"id": 106,
"nameExtern": "Strom Netznutzung (PLZ Bonus)",
"name": "Strom Netznutzung (PLZ Bonus)",
"energyPriceNet": 0.20604,
"energyPriceTax": 0.0391476,
"energyPriceGross": 0.2451876,
"baseFeeNet": 10.7225,
"baseFeeTax": 2.037275,
"baseFeeGross": 12.759775,
"boni": [],
"cancellationTerm": 1,
"cancellationTermUnit": "M",
"cancellationTermTo": "M",
"priceGuarantyFor": null,
"priceGuarantyEnd": 1577919599000,
"runtimeInMonth": null,
"renewalInMonth": null,
"portalInfoAdditionalPriceDetails": null,
"portalInfoAdditionalTariffDescription": null,
"tariffType": null,
"contractType": "SLP"
},
"priceCalculation": {
"advancePayPlanHeight": 258.32850225,
"advancePayPlanHeightNet": 217.082775,
"totalCostPerMonth": 217.082775,
"totalCostPerMonthNet": 182.4225,
"totalCostPerYear": 2604.9933,
"totalCostPerYearNet": 2189.07,
"totalCostPerMonthInFirstYear": 217.082775,
"totalCostPerMonthInFirstYearNet": 182.4225,
"totalCostPerYearInFirstYear": 2604.9933,
"totalCostPerYearInFirstYearNet": 2189.07,
"totalSavingsPerYear": null,
"totalSavingsPerYearNet": null,
"regionalPricePeriodStart": null
},
"charges": {
"chargesEntries": [
{
"key": "base_price",
"name": "Grundpreis",
"value": 35.000000004,
"unit": "EURO_YEARLY",
"sum": 35.000000004,
"unitSum": "EURO"
},
{
"key": "energy_price",
"name": "Arbeitspreis",
"value": 0.0497,
"unit": "EURO_KWH",
"sum": 497,
"unitSum": "EURO"
}
],
"totalChargesPerYear": 532.000000004,
"totalChargesPerYearUnit": "EURO",
"totalChargesPerKwH": 4.97,
"totalChargesPerKwHUnit": "CENT_KWH"
},
"expenses": {
"expenseEntries": [
{
"key": "100",
"name": "NN-Entgelte",
"value": 6.405,
"unit": "EURO_YEARLY",
"sum": 76.86,
"unitSum": "EURO"
},
{
"key": "100",
"name": "NN-Entgelte",
"value": 0.1002,
"unit": "EURO_KWH",
"sum": 1002,
"unitSum": "EURO"
},
{
"key": "101",
"name": "Konzessionsabgabe",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "101",
"name": "Konzessionsabgabe",
"value": 0.0199,
"unit": "EURO_KWH",
"sum": 199,
"unitSum": "EURO"
},
{
"key": "102",
"name": "Messdienstleistung",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "102",
"name": "Messdienstleistung",
"value": 0,
"unit": "EURO_KWH",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "103",
"name": "Messtellenbetrieb",
"value": 1.400833333,
"unit": "EURO_YEARLY",
"sum": 16.809999996,
"unitSum": "EURO"
},
{
"key": "103",
"name": "Messtellenbetrieb",
"value": 0,
"unit": "EURO_KWH",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "104",
"name": "§ 19 StromNEV-Umlage",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "104",
"name": "§ 19 StromNEV-Umlage",
"value": 0.00643,
"unit": "EURO_KWH",
"sum": 64.3,
"unitSum": "EURO"
},
{
"key": "105",
"name": "KWKG-Umlage",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "105",
"name": "KWKG-Umlage",
"value": 0.00275,
"unit": "EURO_KWH",
"sum": 27.5,
"unitSum": "EURO"
},
{
"key": "106",
"name": "Offshore-Haftungsumlage",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "106",
"name": "Offshore-Haftungsumlage",
"value": 0.00656,
"unit": "EURO_KWH",
"sum": 65.6,
"unitSum": "EURO"
},
{
"key": "107",
"name": "abLa-Umlage",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "107",
"name": "abLa-Umlage",
"value": 0,
"unit": "EURO_KWH",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "300",
"name": "EEG",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "300",
"name": "EEG",
"value": 0,
"unit": "EURO_KWH",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "301",
"name": "Stromsteuer",
"value": 0,
"unit": "EURO_YEARLY",
"sum": 0,
"unitSum": "EURO"
},
{
"key": "301",
"name": "Stromsteuer",
"value": 0.0205,
"unit": "EURO_KWH",
"sum": 205,
"unitSum": "EURO"
}
],
"totalExpensesPerMonth": 138.089166666,
"totalExpensesPerMonthUnit": "EURO",
"totalExpensesPerYear": 1657.069999996,
"totalExpensesPerYearUnit": "EURO",
"totalExpensesCostPerKwH": 15.634,
"totalExpensesCostsPerKwHUnit": "CENT_KWH",
"totalExpensesCostPerYear": 7.805833333,
"totalExpensesCostsPerYearUnit": "EURO_YEARLY"
},
"additionalCalculationData": [
{
"tariffId": "106",
"peak": 0,
"expectedPaymentPlanPerMonth": 217.082775,
"expectedPaymentPlanPerMonthUnit": "EURO",
"expectedPaymentPlanPerYear": 2604.9933,
"expectedPaymentPlanPerYearUnit": "EURO",
"msbPriceOnKwh": 0.014008333,
"msbPriceOnKwhUnit": "CENT",
"baseGridPriceOnKwh": 0,
"baseGridPriceOnKwhUnit": "CENT",
"netPowerPriceOnKwh": 0,
"netPowerPriceOnKwhUnit": "CENT",
"sumOfExpensesAndCharges": 15.648008333,
"sumOfExpensesAndChargesUnit": "CENT",
"sumOfExpensesAndMSB": 15.648008333,
"sumOfExpensesAndMSBUnit": "CENT",
"sumOfExpensesAndGridPricePerYear": 1657.069999996,
"sumOfExpensesAndGridPricePerYearUnit": "EURO"
}
],
"containsIndividualPrices": true
}
],
"validationResult": []
}
Validierungen
| Parameter | Validierung | Schüssel |
|---|---|---|
| contractNumber | Parameter darf nicht leer sein | error.getPriceInformationForTariffChange.contractNumber.invalid |
| contractNumber | Vertragsnummer muss in MBS bekannt sein | error.getPriceInformationForTariffChange.contractNumber.unknown |
| consumption | Parameter darf nicht leer sein | error.getPriceInformationForTariffChange.consumption.invalid |
| consumption | Verbrauch darf nicht negativ sein | error.getPriceInformationForTariffChange.consumption.negative |
| contractNumber | Vertrag erfordert eine aktive Tarifzuweisung (TariffApplication) | error.getPriceInformationForTariffChange.contractNumber.tariffapplication.inactive |
| requestDate | Parameter darf nicht leer sein | error.getPriceInformationForTariffChange.requestDate.invalid |
| requestDate | Das Datum darf nicht in der Vergangenheit liegen | error.getPriceInformationForTariffChange.requestDate.inPast |
| - | Fehler (Exception) bei der Preisberechnung | error.getPriceInformationForTariffChange.priceCalculationError |
| - | Für den aktuellen Tarif des Vertrags gibt es keine Optionen in der Tarifwechselmatrix | error.getPriceInformationForTariffChange.noResult |
Hinweise
Die einzelnen Blöcke der entsprechend inhaltlich den Feldern aus der Schnittstelle getPriceInformation. Der Block Expenses (Abgaben) wird im Gegensatz zu getPriceInformation pro Tarifergebnis erzeugt.
Es werden Fristen analog zu canTariffChange berechnet, um Optionen aus der Ergebnisliste herauszufiltern. Als Pivot gilt dabei der Parameter requestDate. Alle Optionen, deren Wechseldatum außerhalb des Zeitraums zwischen dem frühesten Datum und spätestens Datum liegen, werden nicht zurückgegeben.
Verfügbarkeit
MBS 145.0