Reading backend interfaces
Read metering point operation contract
Read metering point operation contract
GET
https://mock.macoapp.de
/getMeasuringPointOperationContractBasic
Reading the metering point operation contract of a location (Parameter1) of type (Parameter2 - default MALO) as of the key date (Parameter3)
query Parameters
| Structure (BO4E) | Description | Format |
|---|---|---|
parameter1* | Location ID · Example: 74018657187 · Default: 74018657187 | string |
parameter2* | Location type · Example: MALO · Default: MALO | stringMALO, MELO, NELO TECHNISCHE_RESSOURCE, STEUERBARE_RESOURCE, TRANCHE |
parameter3* | Date (valid from) or key date if parameter4 is not set · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
parameter4* | Date (Valid until) · Example: 2024-06-28T12:18:00Z · Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$ | string (date-time) |
command | Corresponds to the operationId of this interface. This operation ID corresponds to the command in the Camunda connector process. If the backend provides a generic endpoint, this command can be used to define which operation is to be executed. | string |
Read metering point operation contract › Responses
Successful reading of the metering point operation contract | Successful reading of metering contract
Array of: Contract — the response is a list of these objects, not a single object. Every entry has this structure:
| Structure (BO4E) | Description | Format |
|---|---|---|
boTyp* | Type of the 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* | obligatory version of the BO4E definition. Currently hard coded to 1 | string |
sparte | Options for distinguishing the division. | stringSTROM, GAS, FERNWAERME NAHWAERME, WASSER, ABWASSER |
vertragsart | Specifies which type of contract this is. E.g. grid usage contract | string |
vertragsnummer | A number for the contract that is unique in the context of use | string |
beschreibung | Free text describing the terms, e.g. "Standard terms gas" | string |
lokationsId | Reference to the ID of the market location / metering location RFF Z18 Customer of the LF PI 55043 55168 55169 RFF Z46 Malo 55616 55622 55628 55634 55109 55137 55110 55136 55643 55648 55663 55669 55653 55658 RFF Z19 PI 55040 55043 55168 55169 | string |
lokationsTyp | Reference to the ID of the metering location RFF Z19 | stringMALO, MELO, NELO TECHNISCHE_RESSOURCE, STEUERBARE_RESSOURCE, TRANCHE, MABIS_ZAEHLPUNKT |
vertragsstatus | not in use | stringIN_ARBEIT, UEBERMITTELT, ANGENOMMEN AKTIV, ABGELEHNT, WIDERRUFEN, STORNIERT, GEKUENDIGT, BEENDET |
vertragsbeginn | Indicates when the contract or the assignment begins. DTM 92 PI 55001 55002 55077 55078 55600 55602 55601 55603 55013 55014 55607 55608 55004 55005 55051 55052 55238 55239 55235 55237 | string (date-time) |
vertragsende | Indicates the end of the grid usage or of an assignment. If no contract end date exists yet, the default value "9999-12-31T23:59:59Z" is expected. DTM 93 PI 55016 55017 55001 55002 55600 55602 55013 55014 55607 55608 55010 55011 55004 55005 55007 55008 55039 55040 55051 55052 55240 55241 55242 55243 55236 55237 | string (date-time) |
gemeinderabatt | Municipal discount - details on the discount on grid usage charges QTY Z16 PI 44112 44139 44142 44001 44002 44013 44014 44035 | integer |
| vertragskonditionen | Determinations on contract durations and notice periods. | object |
netznutzungszahler | This specifies who pays for the grid usage of the consuming Malo. CAV Z73 PI 55218 55220 | stringKUNDE, LIEFERANT |
netznutzungsvertrag | Details of the grid usage contract; the relationship of the contracting parties to the consuming Malo. CAV Z74 PI 55218 55220 | stringKUNDEN_NB, LIEFERANTEN_NB |
beinhaltetSingulaerGenutzteBetriebsmittel | Singularly used equipment in the grid usage settlement This states whether singularly used equipment is billed in the grid usage settlement of the consuming market location. | boolean |
netznutzungsabrechnungsgrundlage | Basis for the delivery note check, whether the supplier can use the received quantities for the delivery note check Z12 or whether an agreement exists that determined values do not match the values of the grid usage settlement Z13. CAV ZA7 PI 55218 55220 | stringLIEFERSCHEIN, ABWEICHENDE_GRUNDLAGE |
netznutzungsabrechnungsvariante | Grid usage settlement variant of a consuming market location CAV ZB1 PI 44112 44139 44142 44002 44013 44014 44035 | stringARBEITSPREIS_GRUNDPREIS, ARBEITSPREIS_LEISTUNGSPREIS |
haushaltskunde | Group assignment, indicates whether this is a household customer or not. Z15 Household customer as per EnWG Z18 Not a household customer as per EnWG CCI Z15 PI 55001 55600 55013 55014 55109 55137 | boolean |
abrechnungUeberNna | Billing via Nna | boolean |
startAbrechnungsjahr | Start of the billing year for market locations with an annual demand charge - invoicing period, start date DTM 155 PI 44112 44139 44142 44002 44013 44014 44035 | string (date-time) |
naechstenetznutzungsabrechnung | Next grid usage settlement - notification to the LF of the year in which the next grid usage settlement takes place. DTM Z09 PI 55218 55220 | string |
abrechnungsintervall | Billing interval of the LF in months DTM Z20 PI 44109 44137 44138 44001 44002 44014 | integer |
netznutzungsabrechnungIntervall | Grid usage settlement or feed-in remuneration interval of the NB; the number of months until the next grid usage settlement is to be stated here. DTM Z22 PI 55218 55220 | integer |
beauftragungMsb | Indicates whether a contract exists between the connection user and MSB and whether the contract with the previous contracting party was terminated before the registration. AGR Z04 PI 55042 | stringVERTRAG_AN_MSB, VERTRAGSBEENDIGUNG_MSB |
kuendigungstermin | Transmission of a specific contract termination date DTM Z10 PI 55018 55041 | string |
anzahl_abschlaege | Number of agreed instalments per year, e.g. 12 | number (float) |
beschreibung | Free text describing the terms, e.g. "Standard terms gas" | string |
| netznutzungsabrechnung | Reference to the period ID | object |
zeiteinheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Time span, value | integer |
startdatum | Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start | string (date-time) |
enddatum | Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end | string (date-time) |
einheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | Period text | string |
zeitraumId | Reference to period ID RFF Z46 PI 25001 | integer |
| gemeinderabatt | not in use | object |
wert | Municipal discount MOA Z01 PI 31002 31004 31010 | number (float) |
einheit | Unit | string |
typ | Type | string |
bemessungsgrundlage | Assessment basis of the municipal discount - monetary amount | number (float) |
| geplanteTurnusablesung | Reference to the period ID | object |
zeiteinheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Time span, value | integer |
startdatum | Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start | string (date-time) |
enddatum | Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end | string (date-time) |
einheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | Period text | string |
zeitraumId | Reference to period ID RFF Z46 PI 25001 | integer |
| kuendigungsfrist | The contract can be terminated within this deadline. Details period DTM Z01 PI 55018 55041 | object |
zeiteinheit | Zeiteinheit | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | dauer | integer |
startdatum | startdatum | string (date-time) |
enddatum | enddatum | string (date-time) |
einheit | Zeiteinheit | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | ableseZeitraum | string |
abrechnungsZeitraum | abrechnungsZeitraum | string |
zeitraumText | zeitraumText | string |
zeitraumId | zeitraumId | integer |
| vertragslaufzeit | Reference to the period ID | object |
zeiteinheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Time span, value | integer |
startdatum | Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start | string (date-time) |
enddatum | Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end | string (date-time) |
einheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | Period text | string |
zeitraumId | Reference to period ID RFF Z46 PI 25001 | integer |
| abschlagszyklus | Reference to the period ID | object |
zeiteinheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Time span, value | integer |
startdatum | Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start | string (date-time) |
enddatum | Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end | string (date-time) |
einheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | Period text | string |
zeitraumId | Reference to period ID RFF Z46 PI 25001 | integer |
| vertragsverlaengerung | Reference to the period ID | object |
zeiteinheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Time span, value | integer |
startdatum | Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start | string (date-time) |
enddatum | Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end | string (date-time) |
einheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | Period text | string |
zeitraumId | Reference to period ID RFF Z46 PI 25001 | integer |
| korrespondenzpartner | Correspondence address of the supplier's customer NAD Z04 PI 44109 44112 44113 44137 44138 44001 44002 44013 44014 | object |
boTyp* | Type of the 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 |
anrede | The form of address for the GePa, e.g. Herr. Z04 Correspondence address of the customer of the supplier PI 55001 55600 55601 55013 55014 55043 55168 55169 | string |
name1 | First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen | string |
name2 | Second part of the name. Here an extension to the company name or, for private individuals, the first name for example can be entered. Examples: Bereich Süd or Nina | string |
name3 | Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer | string |
name4 | Name 4 | string |
umsatzsteuerId | The VAT ID of the business partner. Example: DE 813281825 | string |
glaeubigerId | The creditor ID used in payment transactions- e.g. DE 47116789 | string |
emailAdresse | email address | string |
website | Website of the market partner. Example: www.mp-energie.de | string |
gewerbekennzeichnung | Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) Z01 Structure of personal names Z02 Structure of the company name | boolean |
hrnummer | Commercial register number of the business partner | string |
amtsgericht | Local court or commercial register court that issued the commercial register number | string |
externeKundenummerLieferant | externeKundenummerLieferant | string |
geschaeftspartnerrolle[ ] | Geschaeftspartnerrolle | string[]KUNDE, LIEFERANT, DIENSTLEISTER INTERESSENT, MARKTPARTNER, EIGENTUEMER, HAUSVERWALTER, KORRESPONDENZEMPFAENGER, ABLESEKARTENEMPFAENGER |
kontaktweg[ ] | Indicates the way in which the person or the business partner can be contacted | string[]ANSCHREIBEN, TELEFONAT, FAX E_MAIL, SMS |
| partneradresse | Address of the business partner at which the head office is located. | object |
postleitzahl | Postal code | string |
ort | City | string |
strasse | Street | string |
hausnummer | House number and supplement | string |
postfach | PO box | string |
adresszusatz | Address supplement | string |
coErgaenzung | coErgaenzung | string |
landescode | Country code | stringAC, AD, AE AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BU, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CP, CR, CS, CU, CV, CW, CX, CY, CZ, DE, DG, DJ, DK, DM, DO, DZ, EA, EC, EE, EG, EH, ER, ES, ET, EU, FI, FJ, FK, FM, FO, FR, FX, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, IC, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NT, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SF, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SU, SV, SX, SY, SZ, TA, TC, TD, TF, TG, TJ, TK, TL, TM, TN, TO, TP, TR, TT, TV, TW, TZ, UA, UG, UK, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, YU, ZA, ZM, ZR, ZW |
ortsteil | District | string |
| zusatzInformation | Additional information for identification, line for name and address | object |
zusatz1 | Address supplement 1 | string |
zusatz2 | Address supplement 2 | string |
zusatz3 | Address supplement 3 | string |
zusatz4 | Address supplement 4 | string |
zusatz5 | Address supplement 5 | string |
| externeReferenzen[ ] | IDs of other systems can be stored here (e.g. a SAP business partner number) (for details see external reference) | object[] |
exRefName | Name of the external reference, customer number at the supplier, refers to the preceding NAD segment RFF AVC PI 55109 55137 RFF AVC customer number at the supplier ORDERS PI 17101 | stringKundennummer beim Lieferanten, Kundennummer beim Altlieferanten |
exRefWert | Customer number at the previous supplier - specification of references for responses and requests PI 55109 55137 ORDERS PI 17101 | string |
| ansprechpartner | Contact person as in EDIFACT CTA+IC' COM+?+3222271020:TE', that includes e.g. the phone number of customer. | object |
boTyp* | Type of the 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 |
nachname | Surname (family name) of the contact person | string |
eMailAdresse | Email address | string |
| rufnummern[ ] | List of the telephone numbers on which the contact person can be reached. | object[] |
nummerntyp | Type of means of communication COM | stringRUF_ZENTRALE, FAX_ZENTRALE, SAMMELRUF SAMMELFAX, ABTEILUNGRUF, ABTEILUNGFAX, RUF_DURCHWAHL, FAX_DURCHWAHL, MOBIL_NUMMER |
rufnummer | Phone number | string |
abrechnungUeberNna | Billing of the metering point operation via NNE - whether the charges for metering point operation are billed via the grid usage settlement - is answered with JA or NEIN RFF Z05 PI 55620 55626 | boolean |
datenqualitaet | Reference to an ID of a market location from LOC+Z16 RFF Z50 PI 55218 55640 55650 55660 55043 55168 55169 RFF Z51 Z52 PI 55220 55645 55655 55665 | stringERWARTETE_DATEN, IM_SYSTEM_VORHANDENE_DATEN, INFORMATIVE_DATEN GUELTIGE_DATEN, KEINE_DATEN, IM_SYSTEM_KEINE_DATEN_VORHANDEN, KEINE_DATEN_ERWARTET, DIFFERENZ_DATEN, DIFFERENZ_ERWARTETE_DATEN, DIFFERENZ_IM_SYSTEM_VORHANDENE_DATEN |
| gueltigkeitszeitraum | Reference to the period ID | object |
zeiteinheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
dauer | Time span, value | integer |
startdatum | Date from DTM Z25 Use of the data from DTM 163 Processing, start date/time DTM 155 Invoicing period, start date DTM Z42 Provisional billing period start | string (date-time) |
enddatum | Date from DTM Z26 Use of the data until DTM164 Processing, end date/time DTM 156 Invoicing period, end date DTM Z43 Provisional billing period end | string (date-time) |
einheit | not in use | stringSEKUNDE, MINUTE, STUNDE VIERTEL_STUNDE, TAG, WOCHE, MONAT, QUARTAL, HALBJAHR, JAHR |
ableseZeitraum | Periodic meter reading of the NB DTM 752 PI 44113 44140 44142 44043 44168 44169 44060 | string |
abrechnungsZeitraum | Date on which the grid usage settlement of the NB takes place DTM Z21 PI 44112 44139 44142 44002 44013 44014 44035 | string |
zeitraumText | Period text | string |
zeitraumId | Reference to period ID RFF Z46 PI 25001 | integer |
| vertragspartner1[ ] | Correspondence address of the supplier's customer NAD Z04 PI 44109 44112 44113 44137 44138 44001 44002 44013 44014 | object[] |
boTyp* | Type of the 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 |
anrede | The form of address for the GePa, e.g. Herr. Z04 Correspondence address of the customer of the supplier PI 55001 55600 55601 55013 55014 55043 55168 55169 | string |
name1 | First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen | string |
name2 | Second part of the name. Here an extension to the company name or, for private individuals, the first name for example can be entered. Examples: Bereich Süd or Nina | string |
name3 | Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer | string |
name4 | Name 4 | string |
umsatzsteuerId | The VAT ID of the business partner. Example: DE 813281825 | string |
glaeubigerId | The creditor ID used in payment transactions- e.g. DE 47116789 | string |
emailAdresse | email address | string |
website | Website of the market partner. Example: www.mp-energie.de | string |
gewerbekennzeichnung | Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) Z01 Structure of personal names Z02 Structure of the company name | boolean |
hrnummer | Commercial register number of the business partner | string |
amtsgericht | Local court or commercial register court that issued the commercial register number | string |
externeKundenummerLieferant | externeKundenummerLieferant | string |
geschaeftspartnerrolle[ ] | Geschaeftspartnerrolle | string[]KUNDE, LIEFERANT, DIENSTLEISTER INTERESSENT, MARKTPARTNER, EIGENTUEMER, HAUSVERWALTER, KORRESPONDENZEMPFAENGER, ABLESEKARTENEMPFAENGER |
kontaktweg[ ] | Indicates the way in which the person or the business partner can be contacted | string[]ANSCHREIBEN, TELEFONAT, FAX E_MAIL, SMS |
| partneradresse | Address of the business partner at which the head office is located. | object |
postleitzahl | Postal code | string |
ort | City | string |
strasse | Street | string |
hausnummer | House number and supplement | string |
postfach | PO box | string |
adresszusatz | Address supplement | string |
coErgaenzung | coErgaenzung | string |
landescode | Country code | stringAC, AD, AE AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BU, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CP, CR, CS, CU, CV, CW, CX, CY, CZ, DE, DG, DJ, DK, DM, DO, DZ, EA, EC, EE, EG, EH, ER, ES, ET, EU, FI, FJ, FK, FM, FO, FR, FX, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, IC, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NT, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SF, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SU, SV, SX, SY, SZ, TA, TC, TD, TF, TG, TJ, TK, TL, TM, TN, TO, TP, TR, TT, TV, TW, TZ, UA, UG, UK, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, YU, ZA, ZM, ZR, ZW |
ortsteil | District | string |
| zusatzInformation | Additional information for identification, line for name and address | object |
zusatz1 | Address supplement 1 | string |
zusatz2 | Address supplement 2 | string |
zusatz3 | Address supplement 3 | string |
zusatz4 | Address supplement 4 | string |
zusatz5 | Address supplement 5 | string |
| externeReferenzen[ ] | IDs of other systems can be stored here (e.g. a SAP business partner number) (for details see external reference) | object[] |
exRefName | Name of the external reference, customer number at the supplier, refers to the preceding NAD segment RFF AVC PI 55109 55137 RFF AVC customer number at the supplier ORDERS PI 17101 | stringKundennummer beim Lieferanten, Kundennummer beim Altlieferanten |
exRefWert | Customer number at the previous supplier - specification of references for responses and requests PI 55109 55137 ORDERS PI 17101 | string |
| ansprechpartner | Contact person as in EDIFACT CTA+IC' COM+?+3222271020:TE', that includes e.g. the phone number of customer. | object |
boTyp* | Type of the 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 |
nachname | Surname (family name) of the contact person | string |
eMailAdresse | Email address | string |
| rufnummern[ ] | List of the telephone numbers on which the contact person can be reached. | object[] |
nummerntyp | Type of means of communication COM | stringRUF_ZENTRALE, FAX_ZENTRALE, SAMMELRUF SAMMELFAX, ABTEILUNGRUF, ABTEILUNGFAX, RUF_DURCHWAHL, FAX_DURCHWAHL, MOBIL_NUMMER |
rufnummer | Phone number | string |
| vertragspartner2[ ] | Correspondence address of the supplier's customer NAD Z04 PI 44109 44112 44113 44137 44138 44001 44002 44013 44014 | object[] |
boTyp* | Type of the 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 |
anrede | The form of address for the GePa, e.g. Herr. Z04 Correspondence address of the customer of the supplier PI 55001 55600 55601 55013 55014 55043 55168 55169 | string |
name1 | First part of the name. This can hold the company name or, for private individuals, the surname, for example. Examples: Yellow Strom GmbH or Hagen | string |
name2 | Second part of the name. Here an extension to the company name or, for private individuals, the first name for example can be entered. Examples: Bereich Süd or Nina | string |
name3 | Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer | string |
name4 | Name 4 | string |
umsatzsteuerId | The VAT ID of the business partner. Example: DE 813281825 | string |
glaeubigerId | The creditor ID used in payment transactions- e.g. DE 47116789 | string |
emailAdresse | email address | string |
website | Website of the market partner. Example: www.mp-energie.de | string |
gewerbekennzeichnung | Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false) Z01 Structure of personal names Z02 Structure of the company name | boolean |
hrnummer | Commercial register number of the business partner | string |
amtsgericht | Local court or commercial register court that issued the commercial register number | string |
externeKundenummerLieferant | externeKundenummerLieferant | string |
geschaeftspartnerrolle[ ] | Geschaeftspartnerrolle | string[]KUNDE, LIEFERANT, DIENSTLEISTER INTERESSENT, MARKTPARTNER, EIGENTUEMER, HAUSVERWALTER, KORRESPONDENZEMPFAENGER, ABLESEKARTENEMPFAENGER |
kontaktweg[ ] | Indicates the way in which the person or the business partner can be contacted | string[]ANSCHREIBEN, TELEFONAT, FAX E_MAIL, SMS |
| partneradresse | Address of the business partner at which the head office is located. | object |
postleitzahl | Postal code | string |
ort | City | string |
strasse | Street | string |
hausnummer | House number and supplement | string |
postfach | PO box | string |
adresszusatz | Address supplement | string |
coErgaenzung | coErgaenzung | string |
landescode | Country code | stringAC, AD, AE AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BU, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CP, CR, CS, CU, CV, CW, CX, CY, CZ, DE, DG, DJ, DK, DM, DO, DZ, EA, EC, EE, EG, EH, ER, ES, ET, EU, FI, FJ, FK, FM, FO, FR, FX, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, IC, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NT, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SF, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SU, SV, SX, SY, SZ, TA, TC, TD, TF, TG, TJ, TK, TL, TM, TN, TO, TP, TR, TT, TV, TW, TZ, UA, UG, UK, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, YU, ZA, ZM, ZR, ZW |
ortsteil | District | string |
| zusatzInformation | Additional information for identification, line for name and address | object |
zusatz1 | Address supplement 1 | string |
zusatz2 | Address supplement 2 | string |
zusatz3 | Address supplement 3 | string |
zusatz4 | Address supplement 4 | string |
zusatz5 | Address supplement 5 | string |
| externeReferenzen[ ] | IDs of other systems can be stored here (e.g. a SAP business partner number) (for details see external reference) | object[] |
exRefName | Name of the external reference, customer number at the supplier, refers to the preceding NAD segment RFF AVC PI 55109 55137 RFF AVC customer number at the supplier ORDERS PI 17101 | stringKundennummer beim Lieferanten, Kundennummer beim Altlieferanten |
exRefWert | Customer number at the previous supplier - specification of references for responses and requests PI 55109 55137 ORDERS PI 17101 | string |
| ansprechpartner | Contact person as in EDIFACT CTA+IC' COM+?+3222271020:TE', that includes e.g. the phone number of customer. | object |
boTyp* | Type of the 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 |
nachname | Surname (family name) of the contact person | string |
eMailAdresse | Email address | string |
| rufnummern[ ] | List of the telephone numbers on which the contact person can be reached. | object[] |
nummerntyp | Type of means of communication COM | stringRUF_ZENTRALE, FAX_ZENTRALE, SAMMELRUF SAMMELFAX, ABTEILUNGRUF, ABTEILUNGFAX, RUF_DURCHWAHL, FAX_DURCHWAHL, MOBIL_NUMMER |
rufnummer | Phone number | string |
| enFG[ ] | enFG | object[] |
grundlageVerringerungUmlagen | Basis for the reduction of levies under the EnFG CCI Z61 PI 55001 55014 55109 55137 | stringERFUELLT_VORAUSSETZUNG_NACH_ENFG, ERFUELLT_NICHT_VORAUSSETZUNG_NACH_ENFG, KEINE_ANGABE |
grund[ ] | GrundlageVerringerungUmlagenGrund | string[]ENFG_STROMSPEICHER_UND_VERLUSTENERGIE, ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN, ENFG_UMLAGEERHEBUNG_BEI_ANLAGEN_ZUR_VERSTROMUNG_VON_KUPPELGASEN ENFG_HERSTELLUNG_VON_GRUENEN_WASSERSTOFF, ENFG_STROMKOSTENINTENSIVE_UNTERNEHMEN, ENFG_HERSTELLUNG_VON_WASSERSTOFF_IN_STROMKOSTENINTENSIVEN_UNTERNEHMEN, ENFG_SCHIENENBAHNEN, ENFG_ELEKTRISCHE_BETRIEBENE_BUSSEN_IM_LINIENVERKEHR, ENFG_LANDSTROMANLAGEN |