Lesende Backend-Schnittstellen
Preisblatt lesen
Preisblatt lesen
GET
https://mock.macoapp.de
/getPriceSheetBasic
Lesen eines Preisblatts anhand processDate / gueltigAb
query Parameters
| Struktur (BO4E) | Beschreibung | Format |
|---|---|---|
parameter1 | LokationsId · Beispiel: 74018657187 · Vorgabe: 74018657187 | string |
parameter2 | LokationsTyp · Beispiel: MALO · Vorgabe: MALO | stringMALO, MELO, NELO TECHNISCHE_RESSOURCE, STEUERBARE_RESOURCE, TRANCHE |
parameter3* | Datum (Gültig ab) oder Stichtag, wenn parameter4 nicht gesetzt · Beispiel: 2024-06-28T12:18:00Z · Muster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
parameter4 | Datum (Gültig bis) · Beispiel: 2024-06-28T12:18:00Z · Muster: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
command | Entspricht der operationId dieser Schnittstelle. Diese Operation Id entspricht dem Command im Camunda Konnektor Prozess. Wenn das Backend einen generischen Endpunkt bereitstellt, kann dieses Command gentutzt werden um zu definieren welche Operation ausgeführt werden soll. | string |
Preisblatt lesen › Responses
Erfolgreiches Lesen der Netzlokation | Successful reading of the network location
Array of: Preisblatt — die Antwort ist eine Liste dieser Objekte, nicht ein einzelnes Objekt. Jeder Eintrag hat diesen Aufbau:
| Struktur (BO4E) | Beschreibung | Format |
|---|---|---|
boTyp* | Typ des BO | stringANSPRECHPARTNER, AVIS, ENERGIEMENGE GESCHAEFTSOBJEKT, GESCHAEFTSPARTNER, MARKTLOKATION, MARKTTEILNEHMER, MESSLOKATION, ZAEHLER, KOSTEN, TARIF, PREISBLATT, PREISBLATTNETZNUTZUNG, PREISBLATTMESSUNG, PREISBLATTUMLAGEN, PREISBLATTDIENSTLEISTUNG, PREISBLATTKONZESSIONSABGABE, ZEITREIHE, LASTGANG, HANDELSUNSTIMMIGKEIT, ANFRAGE, AUFTRAG, STATUSMITTEILUNG, BERECHNUNGSFORMEL, RECHNUNG, BILANZIERUNG, NETZNUTZUNGSVERTRAG, MESSSTELLENBETRIEBSVERTRAG, ENERGIELIEFERVERTRAG, SPERRAUFTRAG, ANGEBOT, TRANCHE, KOMMUNIKATIONSDATEN, ZAEHLZEITDEFINITION, SCHALTZEITDEFINITION, LEISTUNGSKURVENDEFINITION, NETZLOKATION, STEUERBARE_RESSOURCE, TECHNISCHE_RESSOURCE, AD_HOC_STEUERKANAL, LOKATIONSBUENDEL, WERTE_NACH_TYP2, REKLAMATION, STATUSBERICHT, VERTRAG, BILANZKREIS, VERWENDUNGSZEITRAUM, TARIFINFO, SUMMENZEITREIHE |
versionStruktur* | versionStruktur | string |
bezeichnung | Bezeichnung des Auf-/Abschlags | string |
| gueltigkeit | Der Zeitraum für den der Preis festgelegt ist. Gültigkeitsbeginn DTM 157 PI 27002 27003 | object |
zeiteinheit | Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird. | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Zeitspanne, Wert | integer |
startdatum | Datum aus DTM Z25 Verwendung der Daten ab DTM 163 Verarbeitung, Beginndatum/-zeit DTM 155 Rechnungsperiode, Beginndatum DTM Z42 vorläufiger Abrechnungszeitraum Beginn | string (date-time) |
enddatum | Datum aus DTM Z26 Verwendung der Daten bis DTM164 Verarbeitung, Endedatum/-zeit DTM 156 Rechnungsperiode, Endedatum DTM Z43 vorläufiger Abrechnungszeitraum Ende | string (date-time) |
einheit | Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird. | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Turnusablesung des NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Termin, zu dem die Netznutzungsabrechnung des NB erfolgt DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | ZeitraumText | string |
zeitraumId | Referenz auf Zeitraum-ID RFF Z46 PI 25001 | integer |
preisstatus | Gibt den Status des veröffentlichten Preises an | stringVORLAEUFIG, ENDGUELTIG |
sparte | Strom oder Gas | stringSTROM, GAS, FERNWAERME NAHWAERME, WASSER, ABWASSER |
preisNetzbetreiberCodenummer | Preise des Netzbetreibers | string |
bilanzierungsdatum | Bilanzierungsdatum DTM 492 PI 27001 | string (date-time) |
regelzone | Regelzone LOC 231 PI 27001 | string |
leistungstyp | Standardisierte Bezeichnung für die abgerechnete Leistungserbringung. Details Leistungstyp | stringARBEITSPREIS_WIRKARBEIT, LEISTUNGSPREIS_WIRKLEISTUNG, ARBEITSPREIS_BLINDARBEIT_IND ARBEITSPREIS_BLINDARBEIT_KAP, GRUNDPREIS, MEHRMINDERMENGE, MESSSTELLENBETRIEB, MESSDIENSTLEISTUNG, MESSDIENSTLEISTUNG_INKL_MESSUNG, ABRECHNUNG, KONZESSIONS_ABGABE, KWK_UMLAGE, OFFSHORE_UMLAGE, ABLAV_UMLAGE, REGELENERGIE_UMLAGE, BILANZIERUNG_UMLAGE, AUSLESUNG_ZUSAETZLICH, ABLESUNG_ZUSAETZLICH, ABRECHNUNG_ZUSAETZLICH, SPERRUNG, ENTSPERRUNG, MAHNKOSTEN, INKASSOKOSTEN |
nichtGenutzt | nicht Genutzt | boolean |
| preispositionen[ ] | Die einzelnen Positionen, die mit dem Preisblatt abgerechnet werden können. Z.B. Arbeitspreis, Grundpreis etc. Code des Preisschlüsselstamms PIA 1 PI 27002 | object[] |
berechnungsmethode | Das Modell, das der Preisbildung zugrunde liegt. Details Kalkulationsmethode | stringKEINE, STAFFELN, ZONEN VORZONEN_GP, SIGMOID, BLINDARBEIT_GT_50_PROZENT, BLINDARBEIT_GT_40_PROZENT, AP_GP_ZONEN, LP_INSTALL_LEISTUNG, AP_TRANSPORT_ODER_VERTEILNETZ, AP_TRANSPORT_ODER_VERTEILNETZ_ORTSVERTEILNETZ_SIGMOID, LP_JAHRESVERBRAUCH, LP_TRANSPORT_ODER_VERTEILNETZ, LP_TRANSPORT_ODER_VERTEILNETZ_ORTSVERTEILNETZ_SIGMOID, FUNKTIONEN, VERBRAUCH_UEBER_SLP_GRENZE_FUNKTIONSBEZOGEN_WEITERE_BERECHNUNG_ALS_LGK |
leistungstyp | Standardisierte Bezeichnung für die abgerechnete Leistungserbringung. Details Leistungstyp | stringARBEITSPREIS_WIRKARBEIT, LEISTUNGSPREIS_WIRKLEISTUNG, ARBEITSPREIS_BLINDARBEIT_IND ARBEITSPREIS_BLINDARBEIT_KAP, GRUNDPREIS, MEHRMINDERMENGE, MESSSTELLENBETRIEB, MESSDIENSTLEISTUNG, MESSDIENSTLEISTUNG_INKL_MESSUNG, ABRECHNUNG, KONZESSIONS_ABGABE, KWK_UMLAGE, OFFSHORE_UMLAGE, ABLAV_UMLAGE, REGELENERGIE_UMLAGE, BILANZIERUNG_UMLAGE, AUSLESUNG_ZUSAETZLICH, ABLESUNG_ZUSAETZLICH, ABRECHNUNG_ZUSAETZLICH, SPERRUNG, ENTSPERRUNG, MAHNKOSTEN, INKASSOKOSTEN |
leistungsbezeichnung | Bezeichnung für die in der Position abgebildete Leistungserbringung. Z15 POG bei verbrauchender Marktlokation > 100.000 kWh/a mit iMS Z16 POG bei verbrauchender Marktlokation ]50.000 kWh/a; 100.000 kWh/a] mit iMS Z17 POG bei verbrauchender Marktlokation ]20.000 kWh/a; 50.000 kWh/a] mit iMS Z18 POG bei verbrauchender Marktlokation ]10.000 kWh/a; 20.000 kWh/a] mit iMS Z19 POG bei verbrauchender Marktlokation mit unterbrechbaren Verbrauchseinrichtung nach § 14a EnWG mit iMS Z20 POG bei verbrauchender Marktlokation ]6.000 kWh/a; 10.000 kWh/a] mit iMS Z21 POG bei erzeugender Marktlokation ]7 kW; 15kW] mit iMS Z22 POG bei erzeugender Marktlokation ]15 kW; 30 kW] mit iMS Z23 POG bei erzeugender Marktlokation ]30 kW; 100 kW] mit iMS Z24 POG bei erzeugender Marktlokation > 100 kW mit iMS Z25 POG bei Marktlokation mit mME Z28 POG bei verbrauchender Marktlokation ]4.000 kWh/a; 6.000 kWh/a] mit iMS Z29 POG bei verbrauchender Marktlokation ]3.000 kWh/a; 4.000 kWh/a] mit iMS Z30 POG bei verbrauchender Marktlokation ]2.000 kWh/a; 3.000 kWh/a] mit iMS Z31 POG bei verbrauchender Marktlokation [0 kWh/a; 2.000 kWh/a] mit iMS Z32 POG bei optionaler Ausstattung mit iMS von Neuanlagen von erzeugender Marktlokation Z41 Zusatzleistung IMD C PI 27002 | stringPOG_VERBRAUCH_IMS_UEBER_100K, POG_VERBRAUCH_IMS_50K_BIS_100K, POG_VERBRAUCH_IMS_20K_BIS_50K POG_VERBRAUCH_IMS_10K_BIS_20K, POG_VERBRAUCH_IMS_UNTERBRECHBAR, POG_VERBRAUCH_IMS_6K_BIS_10K, POG_ERZEUGUNG_IMS_7_BIS_15, POG_ERZEUGUNG_IMS_15_BIS_30, POG_ERZEUGUNG_IMS_30_BIS_100, POG_ERZEUGUNG_IMS_UEBER_100, POG_MME, POG_VERBRAUCH_IMS_4K_BIS_6K, POG_VERBRAUCH_IMS_3K_BIS_4K, POG_VERBRAUCH_IMS_2K_BIS_3K, POG_VERBRAUCH_IMS_0_BIS_2K, POG_ERZEUGUNG_IMS_OPTIONAL, ZUSATZLEISTUNG |
preiseinheit | Währungsangaben für die gesamte Preisliste CUX 2 EUR PI 27001 27002 27003 | stringEUR, CT |
bezugsgroesse | Hier wird festgelegt, auf welche Bezugsgröße sich der Preis bezieht, z.B. kWh oder Stück. Details Mengeneinheit | stringW, WH, KW KWH, KVARH, MW, MWH, STUECK, KUBIKMETER, STUNDE, TAG, MONAT, JAHR, PROZENT, ANZAHL, VAR, KVAR, VARH, KWHK, Z16, KWT, WATT_PRO_QUADRATMETER, METER_PRO_SEKUNDE |
zeitbasis | Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird. | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
tarifzeit | Festlegung, für welche Tarifzeit der Preis hier festgelegt ist. | stringTZ_STANDARD, TZ_HT, TZ_NT |
bdewArtikelnummer | Artikelnummer des BDEW Z01 Artikelnummer PI 27001 27002 27003 | stringLEISTUNG, LEISTUNG_PAUSCHAL, GRUNDPREIS REGELENERGIE_ARBEIT, REGELENERGIE_LEISTUNG, NOTSTROMLIEFERUNG_ARBEIT, NOTSTROMLIEFERUNG_LEISTUNG, RESERVENETZKAPAZITAET, RESERVELEISTUNG, ZUSAETZLICHE_ABLESUNG, PRUEFGEBUEHREN_AUSSERPLANMAESSIG, WIRKARBEIT, SINGULAER_GENUTZTE_BETRIEBSMITTEL, ABGABE_KWKG, ABSCHLAG, KONZESSIONSABGABE, ENTGELT_FERNAUSLESUNG, UNTERMESSUNG, BLINDMEHRARBEIT, ENTGELT_ABRECHNUNG, SPERRKOSTEN, ENTSPERRKOSTEN, MAHNKOSTEN, MEHR_MINDERMENGEN, INKASSOKOSTEN, BLINDMEHRLEISTUNG, ENTGELT_MESSUNG_ABLESUNG, ENTGELT_EINBAU_BETRIEB_WARTUNG_MESSTECHNIK, AUSGLEICHSENERGIE, AUSGLEICHSENERGIE_UNTERDECKUNG, ZAEHLEINRICHTUNG, WANDLER_MENGENUMWERTER, KOMMUNIKATIONSEINRICHTUNG, TECHNISCHE_STEUEREINRICHTUNG, PARAGRAF_19_STROM_NEV_UMLAGE, BEFESTIGUNGSEINRICHTUNG, OFFSHORE_HAFTUNGSUMLAGE, FIXE_ARBEITSENTGELTKOMPONENTE, FIXE_LEISTUNGSENTGELTKOMPONENTE, UMLAGE_ABSCHALTBARE_LASTEN, MEHRMENGE, MINDERMENGE, ENERGIESTEUER, SMARTMETER_GATEWAY, STEUERBOX, MSB_INKL_MESSUNG, ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_1_MSBG, ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_2_MSBG, ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_3_MSBG, ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_4_MSBG, ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_5_MSBG, ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_3_MSBG, ENTGELT_KAPAZITAETEN |
zonungsgroesse | Mit der Menge der hier angegebenen Größe wird die Staffelung/Zonung durchgeführt. Z.B. Vollbenutzungsstunden. | stringWIRKARBEIT_EL, LEISTUNG_EL, BLINDARBEIT_KAP BLINDARBEIT_IND, BLINDLEISTUNG_KAP, BLINDLEISTUNG_IND, WIRKARBEIT_TH, LEISTUNG_TH, VOLUMEN, VOLUMENSTROM, BENUTZUNGSDAUER, ANZAHL |
preisschluesselstamm | Preisschlüsselstamm | string |
positionsnummer | Fortlaufende Nummer für die Preisposition LIN PI 27001 27002 27003 | integer |
messebene | Spannungsebene der Primärwicklung des Wandlers CAV E06 PI 27002 | stringNSP, MSP, HSP HSS, MSP_NSP_UMSP, HSP_MSP_UMSP, HSS_HSP_UMSP, HD, MD, ND |
beschreibung | Produkt-/Leistungsbeschreibung, wenn IMD+X vorhanden | string |
beschreibungsformat | Vgl. PRICAT IMD 7077 | stringCODE, FREIER_TEXT, TEILSTRUKTURIERT |
artikelId | Artikel-ID des BDEW Z09 Artikel-ID PI 27001 27002 27003 | string |
| verarbeitungszeitraum | Der Zeitraum für den der Preis festgelegt ist. Gültigkeitsbeginn DTM 157 PI 27002 27003 | object |
zeiteinheit | Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird. | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Zeitspanne, Wert | integer |
startdatum | Datum aus DTM Z25 Verwendung der Daten ab DTM 163 Verarbeitung, Beginndatum/-zeit DTM 155 Rechnungsperiode, Beginndatum DTM Z42 vorläufiger Abrechnungszeitraum Beginn | string (date-time) |
enddatum | Datum aus DTM Z26 Verwendung der Daten bis DTM164 Verarbeitung, Endedatum/-zeit DTM 156 Rechnungsperiode, Endedatum DTM Z43 vorläufiger Abrechnungszeitraum Ende | string (date-time) |
einheit | Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird. | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Turnusablesung des NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Termin, zu dem die Netznutzungsabrechnung des NB erfolgt DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | ZeitraumText | string |
zeitraumId | Referenz auf Zeitraum-ID RFF Z46 PI 25001 | integer |
| zu_abschlaege[ ] | Zuschläge oder Abschläge auf die Position. | object[] |
bezeichnung | Bezeichnung | string |
beschreibung | Beschreibung | string |
aufAbschlagstyp | nicht in Benutzung | stringRELATIV, ABSOLUT |
aufAbschlagswert | auf Abschlagswert | number (float) |
aufAbschlagswaehrung | Währungsangaben für die gesamte Preisliste CUX 2 EUR PI 27001 27002 27003 | stringEUR, CT |
| preisstaffeln[ ] | Preisangaben Nettopreis für die aktuelle Position PRI CAL PI 27001 27002 27003 | object[] |
einheitspreis | Berechnungspreis PRI CAL PI | number (float) |
zeitbasis | Die Zeit(dauer) auf die sich der Preis bezieht. Z.B. ein Jahr für einen Leistungspreis der in €/kW/Jahr ausgegeben wird. | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
staffelgrenzeVon | Zonengrenzen von RGN 10 | number (float) |
staffelgrenzeBis | Zonengrenzen bis RGN 10 | number (float) |
einheit | Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können | stringW, WH, KW KWH, KVARH, MW, MWH, STUECK, KUBIKMETER, STUNDE, TAG, MONAT, JAHR, PROZENT, ANZAHL, VAR, KVAR, VARH, KWHK, Z16, KWT, WATT_PRO_QUADRATMETER, METER_PRO_SEKUNDE |
| sigmoidparameter | nicht in Benutzung | object |
A | A | number (float) |
B | B | number (float) |
C | C | number (float) |
D | D | number (float) |