Geräteübernahme

START_ANGEBOT_GERAETEUEBERNAHME (MSB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (2):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ANFRAGE": [
      {
        "anfragetyp": "KAUF"
      }
    ],
    "ANGEBOT": [
      {
        "anfragereferenz": "anfragereferenz",
        "angebotsdatum": "2024-08-25T15:00:00Z",
        "positionsdaten": [
          {
            "anbietbar": true,
            "artikelnummer": "LEISTUNG",
            "beteiligterMarktpartner": {
              "rollencodenummer": "rollencodenummer",
              "rollencodetyp": "BDEW"
            },
            "freitext": "freitext",
            "positionsbezeichnung": "positionsbezeichnung",
            "positionspreis": [
              {
                "bezugswert": "W",
                "menge": 0,
                "wert": 0
              }
            ],
            "verweisKatalognummer": {
              "katalognummer": "katalognummer",
              "versionsnummer": "versionsnummer",
              "zeilennummer": "zeilennummer"
            }
          }
        ]
      }
    ],
    "MESSLOKATION": [
      {
        "messlokationsId": "messlokationsId"
      }
    ],
    "ZAEHLER": [
      {
        "befestigungsart": "STECKTECHNIK",
        "eichungBis": "eichungBis",
        "geraete": [
          {
            "geraeteeigenschaften": {
              "faktor": 0,
              "geraetemerkmal": "EINTARIF"
            }
          }
        ],
        "messwerterfassung": "FERNAUSLESBAR",
        "tarifart": "EINTARIF",
        "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
        "zaehlergroesse": "EINTARIF",
        "zaehlertyp": "DREHSTROMZAEHLER",
        "zaehlertypspezifikation": "EDL40"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "15001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_ANGEBOT_GERAETEUEBERNAHME",
    "prozessId": "prozessId"
  }
}'

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Request Body

Der Rumpf dieses Aufrufs — eine Spalte je zulässigem Prüfidentifikator. Ein Wert in der Spalte heißt, dass das Feld zu diesem Prüfidentifikator gehört: Muss, wenn das Schema es verlangt, sonst Kann.

Struktur (BO4E)	Beschreibung	Format	15001
stammdaten*	—	object	Muss
ANFRAGE[ ]*	—	object[]	Muss
`anfragetyp`*00010	Typ/Art der Anfrage (ORDERS ORDRSP IMD 7081)	string	Muss
`KAUF`			Muss
`NUTZUNGSUEBERLASSUNG`			Muss
`ABRECHNUNGSBRENNWERT_UND_ZUSTANDSZAHL`			Muss
`LASTGANGDATEN`			Muss
`ZAEHLERSTAENDE`			Muss
`WERTEERMITTLUNG`			Muss
`ENERGIEMENGE_EINZELWERT`			Muss
`INNERHALB_DER_ARBEITSZEIT`			Muss
`AUCH_AUSSERHALB_DER_ARBEITSZEIT`			Muss
`WECHSEL_SAEMTLICHER_EINRICHTUNGEN`			Muss
`TEILWEISER_WECHSEL`			Muss
`AENDERUNG_ZAEHLZEITDEFINITION`			Muss
`ABBESTELLUNG_ZAEHLZEITEN`			Muss
`ABBESTELLUNG_MESSPRODUKT`			Muss
`ANGEBOT_AUF_BASIS_PREISBLATT`			Muss
`INDIVIDUELLES_ANGEBOT`			Muss
`AENDERUNG_KONFIGURATION`			Muss
`KANN_NICHT_ANGEBOTEN_WERDEN`			Muss
`NEUKONFIGURATION`			Muss
`BEENDIGUNG_KONFIGURATION`			Muss
`AKTIVIERUNG_KONFIGURATION`			Muss
ANGEBOT[ ]*	—	object[]	Muss
`anfragereferenz`*00020	Referenz auf eine Anfrage oder Ausschreibung. Kann dem Empfänger des Angebotes bei Zuordnung des Angebotes zur Anfrage bzw.Ausschreibung helfen.	string	Muss
`angebotsdatum`*00030	Erstellungsdatum des Angebots	string (date-time)	Muss
positionsdaten[ ]*	—	object[]	Muss
`anbietbar`00040	—	boolean	Kann
`artikelnummer`*00050	BDEW Artikelnummer	string	Muss
`LEISTUNG`			Muss
`LEISTUNG_PAUSCHAL`			Muss
`GRUNDPREIS`			Muss
`REGELENERGIE_ARBEIT`			Muss
`REGELENERGIE_LEISTUNG`			Muss
`NOTSTROMLIEFERUNG_ARBEIT`			Muss
`NOTSTROMLIEFERUNG_LEISTUNG`			Muss
`RESERVENETZKAPAZITAET`			Muss
`RESERVELEISTUNG`			Muss
`ZUSAETZLICHE_ABLESUNG`			Muss
`PRUEFGEBUEHREN_AUSSERPLANMAESSIG`			Muss
`WIRKARBEIT`			Muss
`SINGULAER_GENUTZTE_BETRIEBSMITTEL`			Muss
`ABGABE_KWKG`			Muss
`ABSCHLAG`			Muss
`KONZESSIONSABGABE`			Muss
`ENTGELT_FERNAUSLESUNG`			Muss
`UNTERMESSUNG`			Muss
`BLINDMEHRARBEIT`			Muss
`ENTGELT_ABRECHNUNG`			Muss
`SPERRKOSTEN`			Muss
`ENTSPERRKOSTEN`			Muss
`MAHNKOSTEN`			Muss
`MEHR_MINDERMENGEN`			Muss
`INKASSOKOSTEN`			Muss
`BLINDMEHRLEISTUNG`			Muss
`ENTGELT_MESSUNG_ABLESUNG`			Muss
`ENTGELT_EINBAU_BETRIEB_WARTUNG_MESSTECHNIK`			Muss
`AUSGLEICHSENERGIE`			Muss
`AUSGLEICHSENERGIE_UNTERDECKUNG`			Muss
`ZAEHLEINRICHTUNG`			Muss
`WANDLER_MENGENUMWERTER`			Muss
`KOMMUNIKATIONSEINRICHTUNG`			Muss
`TECHNISCHE_STEUEREINRICHTUNG`			Muss
`PARAGRAF_19_STROM_NEV_UMLAGE`			Muss
`BEFESTIGUNGSEINRICHTUNG`			Muss
`OFFSHORE_HAFTUNGSUMLAGE`			Muss
`FIXE_ARBEITSENTGELTKOMPONENTE`			Muss
`FIXE_LEISTUNGSENTGELTKOMPONENTE`			Muss
`UMLAGE_ABSCHALTBARE_LASTEN`			Muss
`MEHRMENGE`			Muss
`MINDERMENGE`			Muss
`ENERGIESTEUER`			Muss
`SMARTMETER_GATEWAY`			Muss
`STEUERBOX`			Muss
`MSB_INKL_MESSUNG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_1_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_2_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_3_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_4_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_5_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_3_MSBG`			Muss
`ENTGELT_KAPAZITAETEN`			Muss
`freitext`00060	Freitext / FTX+ACB	string	Kann
`positionsbezeichnung`*00070	Bezeichnung der Position	string	Muss
beteiligterMarktpartner	—	object	Kann
`rollencodenummer`00080	Gibt die Codenummer der Marktrolle an.	string	Kann
`rollencodetyp`00090	Gibt den Typ des Codes an.	string	Kann
`BDEW`			Kann
`GS1`			Kann
`GLN`			Kann
`DVGW`			Kann
positionspreis[ ]	—	object[]	Kann
`bezugswert`00100	Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können	string	Kann
`W`			Kann
`WH`			Kann
`KW`			Kann
`KWH`			Kann
`KVARH`			Kann
`MW`			Kann
`MWH`			Kann
`STUECK`			Kann
`KUBIKMETER`			Kann
`STUNDE`			Kann
`TAG`			Kann
`MONAT`			Kann
`JAHR`			Kann
`PROZENT`			Kann
`ANZAHL`			Kann
`VAR`			Kann
`KVAR`			Kann
`VARH`			Kann
`KWHK`			Kann
`Z16`			Kann
`KWT`			Kann
`menge`00110	menge	integer	Kann
`wert`00120	Wert	number (float)	Kann
verweisKatalognummer	—	object	Kann
`katalognummer`00130	Katalognummer	string	Kann
`versionsnummer`00140	Versionsnummer	string	Kann
`zeilennummer`00150	Zeilennummer	string	Kann
MESSLOKATION[ ]*	—	object[]	Muss
`messlokationsId`*00160	Die Messlokations-Identifikation. Das ist die frühere Zählpunktbezeichnung, z.B. DE 47108151234567	string	Muss
ZAEHLER[ ]	—	object[]	Kann
`befestigungsart`00170	Befestigungsart	string	Kann
`STECKTECHNIK`			Kann
`DREIPUNKT`			Kann
`HUTSCHIENE`			Kann
`EINSTUTZEN`			Kann
`ZWEISTUTZEN`			Kann
`eichungBis`00180	Bis zu diesem Datum ist der Zähler geeicht.	string	Kann
`messwerterfassung`00190	Messwerterfassung am Zählpunkt	string	Kann
`FERNAUSLESBAR`			Kann
`MANUELL_AUSGELESENE`			Kann
`tarifart`00200	Spezifikation bezüglich unterstützter Tarifarten.	string	Kann
`EINTARIF`			Kann
`ZWEITARIF`			Kann
`MEHRTARIF`			Kann
`SMART_METER`			Kann
`LEISTUNGSGEMESSEN`			Kann
`zaehlerauspraegung`00210	Spezifikation die Richtung des Zählers betreffend.	string	Kann
`EINRICHTUNGSZAEHLER`			Kann
`ZWEIRICHTUNGSZAEHLER`			Kann
`zaehlergroesse`00220	Zaehlergroesse	string	Kann
`EINTARIF`			Kann
`ZWEITARIF`			Kann
`MEHRTARIF`			Kann
`GAS_G2P5`			Kann
`GAS_G4`			Kann
`GAS_G6`			Kann
`GAS_G10`			Kann
`GAS_G16`			Kann
`GAS_G25`			Kann
`GAS_G40`			Kann
`GAS_G65`			Kann
`GAS_G100`			Kann
`GAS_G160`			Kann
`GAS_G250`			Kann
`GAS_G350`			Kann
`GAS_G400`			Kann
`GAS_G4000`			Kann
`GAS_G650`			Kann
`GAS_G6500`			Kann
`GAS_G1000`			Kann
`GAS_G10000`			Kann
`GAS_G12500`			Kann
`GAS_G1600`			Kann
`GAS_G16000`			Kann
`GAS_G2500`			Kann
`IMPULSGEBER_G4_G100`			Kann
`IMPULSGEBER_G100`			Kann
`MODEM_GSM`			Kann
`MODEM_GPRS`			Kann
`MODEM_FUNK`			Kann
`MODEM_GSM_O_LG`			Kann
`MODEM_GSM_M_LG`			Kann
`MODEM_FESTNETZ`			Kann
`MODEM_GPRS_M_LG`			Kann
`PLC_COM`			Kann
`ETHERNET_KOM`			Kann
`DSL_KOM`			Kann
`LTE_KOM`			Kann
`RUNDSTEUEREMPFAENGER`			Kann
`TARIFSCHALTGERAET`			Kann
`ZUSTANDS_MU`			Kann
`TEMPERATUR_MU`			Kann
`KOMPAKT_MU`			Kann
`SYSTEM_MU`			Kann
`UNBESTIMMT`			Kann
`WASSER_MWZW`			Kann
`WASSER_WZWW`			Kann
`WASSER_WZ01`			Kann
`WASSER_WZ02`			Kann
`WASSER_WZ03`			Kann
`WASSER_WZ04`			Kann
`WASSER_WZ05`			Kann
`WASSER_WZ06`			Kann
`WASSER_WZ07`			Kann
`WASSER_WZ08`			Kann
`WASSER_WZ09`			Kann
`WASSER_WZ10`			Kann
`WASSER_VWZ04`			Kann
`WASSER_VWZ05`			Kann
`WASSER_VWZ06`			Kann
`WASSER_VWZ07`			Kann
`WASSER_VWZ10`			Kann
`DICHTEMENGENUMWERTER`			Kann
`TEMPERATURMENGENUMWERTER`			Kann
`ZUSTANDSMENGENUMWERTER`			Kann
`BLOCKSTROMWANDLER`			Kann
`MESSWANDLERSATZ_IMS_MME`			Kann
`KOMBIMESSWANDLER`			Kann
`SPANNUNGSWANDLER`			Kann
`zaehlertyp`00230	Typisierung des Zählers	string	Kann
`DREHSTROMZAEHLER`			Kann
`BALGENGASZAEHLER`			Kann
`DREHKOLBENZAEHLER`			Kann
`SMARTMETER`			Kann
`LEISTUNGSZAEHLER`			Kann
`MAXIMUMZAEHLER`			Kann
`TURBINENRADGASZAEHLER`			Kann
`ULTRASCHALLGASZAEHLER`			Kann
`WECHSELSTROMZAEHLER`			Kann
`WIRBELGASZAEHLER`			Kann
`MESSDATENREGISTRIERGERAET`			Kann
`ELEKTRONISCHERHAUSHALTSZAEHLER`			Kann
`SONDERAUSSTATTUNG`			Kann
`WASSERZAEHLER`			Kann
`MODERNEMESSEINRICHTUNG`			Kann
`zaehlertypspezifikation`00240	Typisierung des Zählers (spezifikation für EHZ und MME)	string	Kann
`EDL40`			Kann
`EDL21`			Kann
`SONSTIGER_EHZ`			Kann
`MME_STANDARD`			Kann
`MME_MEDA`			Kann
geraete[ ]	—	object[]	Kann
geraeteeigenschaften	—	object	Kann
`faktor`00250	faktor	number (float)	Kann
`geraetemerkmal`00260	Geraetemerkmal	string	Kann
`EINTARIF`			Kann
`ZWEITARIF`			Kann
`MEHRTARIF`			Kann
`GAS_G2P5`			Kann
`GAS_G4`			Kann
`GAS_G6`			Kann
`GAS_G10`			Kann
`GAS_G16`			Kann
`GAS_G25`			Kann
`GAS_G40`			Kann
`GAS_G65`			Kann
`GAS_G100`			Kann
`GAS_G160`			Kann
`GAS_G250`			Kann
`GAS_G350`			Kann
`GAS_G400`			Kann
`GAS_G4000`			Kann
`GAS_G650`			Kann
`GAS_G6500`			Kann
`GAS_G1000`			Kann
`GAS_G10000`			Kann
`GAS_G12500`			Kann
`GAS_G1600`			Kann
`GAS_G16000`			Kann
`GAS_G2500`			Kann
`IMPULSGEBER_G4_G100`			Kann
`IMPULSGEBER_G100`			Kann
`MODEM_GSM`			Kann
`MODEM_GPRS`			Kann
`MODEM_FUNK`			Kann
`MODEM_GSM_O_LG`			Kann
`MODEM_GSM_M_LG`			Kann
`MODEM_FESTNETZ`			Kann
`MODEM_GPRS_M_LG`			Kann
`PLC_COM`			Kann
`ETHERNET_KOM`			Kann
`DSL_KOM`			Kann
`LTE_KOM`			Kann
`RUNDSTEUEREMPFAENGER`			Kann
`TARIFSCHALTGERAET`			Kann
`ZUSTANDS_MU`			Kann
`TEMPERATUR_MU`			Kann
`KOMPAKT_MU`			Kann
`SYSTEM_MU`			Kann
`UNBESTIMMT`			Kann
`WASSER_MWZW`			Kann
`WASSER_WZWW`			Kann
`WASSER_WZ01`			Kann
`WASSER_WZ02`			Kann
`WASSER_WZ03`			Kann
`WASSER_WZ04`			Kann
`WASSER_WZ05`			Kann
`WASSER_WZ06`			Kann
`WASSER_WZ07`			Kann
`WASSER_WZ08`			Kann
`WASSER_WZ09`			Kann
`WASSER_WZ10`			Kann
`WASSER_VWZ04`			Kann
`WASSER_VWZ05`			Kann
`WASSER_VWZ06`			Kann
`WASSER_VWZ07`			Kann
`WASSER_VWZ10`			Kann
`DICHTEMENGENUMWERTER`			Kann
`TEMPERATURMENGENUMWERTER`			Kann
`ZUSTANDSMENGENUMWERTER`			Kann
`BLOCKSTROMWANDLER`			Kann
`MESSWANDLERSATZ_IMS_MME`			Kann
`KOMBIMESSWANDLER`			Kann
`SPANNUNGSWANDLER`			Kann
transaktionsdaten*	—	object	Muss
`kategorie`*00270	Qualifier aus dem Beginn der EDIFact Nachricht / BGM	string	Muss
`pruefidentifikator`00280	Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 15001.	—	Kann
`sparte`*00290	Enthält Informationen über die Sparte	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`marktrolle`00300	Gibt im Klartext die Bezeichnung der Marktrolle an.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`rollencodenummer`00310	Gibt die Codenummer der Marktrolle an.	string	Kann
empfaenger*	—	object	Muss
`marktrolle`00320	Gibt im Klartext die Bezeichnung der Marktrolle an.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`rollencodenummer`00330	Gibt die Codenummer der Marktrolle an.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00340	—	string	Muss
`prozessId`*00350	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "ANFRAGE": [
      {
        "anfragetyp": "KAUF"
      }
    ],
    "ANGEBOT": [
      {
        "anfragereferenz": "anfragereferenz",
        "angebotsdatum": "2024-08-25T15:00:00Z",
        "positionsdaten": [
          {
            "anbietbar": true,
            "artikelnummer": "LEISTUNG",
            "beteiligterMarktpartner": {
              "rollencodenummer": "rollencodenummer",
              "rollencodetyp": "BDEW"
            },
            "freitext": "freitext",
            "positionsbezeichnung": "positionsbezeichnung",
            "positionspreis": [
              {
                "bezugswert": "W",
                "menge": 0,
                "wert": 0
              }
            ],
            "verweisKatalognummer": {
              "katalognummer": "katalognummer",
              "versionsnummer": "versionsnummer",
              "zeilennummer": "zeilennummer"
            }
          }
        ]
      }
    ],
    "MESSLOKATION": [
      {
        "messlokationsId": "messlokationsId"
      }
    ],
    "ZAEHLER": [
      {
        "befestigungsart": "STECKTECHNIK",
        "eichungBis": "eichungBis",
        "geraete": [
          {
            "geraeteeigenschaften": {
              "faktor": 0,
              "geraetemerkmal": "EINTARIF"
            }
          }
        ],
        "messwerterfassung": "FERNAUSLESBAR",
        "tarifart": "EINTARIF",
        "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
        "zaehlergroesse": "EINTARIF",
        "zaehlertyp": "DREHSTROMZAEHLER",
        "zaehlertypspezifikation": "EDL40"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "15001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_ANGEBOT_GERAETEUEBERNAHME",
    "prozessId": "prozessId"
  }
}

json

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Responses

Erfolg | Success

Struktur (BO4E)	Beschreibung	Format
`businessKey`*	Einzigartige Kennung des Geschäftsprozesses \| Unique identifier of the business process	string (uuid)
`message`*	Nachricht mit Details zum ausgelösten Event \| Message with details about the triggered event	string

Trigger-Event START_ANGEBOT_GERAETEUEBERNAHME der Marktrolle MSB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Hinweise zu dieser Seite

Der Aufruf geht tatsächlich an POST /inbound; das Event ergibt sich aus zusatzdaten.eventname im Rumpf. Diese Seite trennt eine von 105 Rumpfvarianten heraus, damit sie einzeln lesbar und ausprobierbar sind.

Anforderung Wert vom LF, …Gerätewechsel

START_ANGEBOT_GERAETEUEBERNAHME (MSB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (2):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ANFRAGE": [
      {
        "anfragetyp": "KAUF"
      }
    ],
    "ANGEBOT": [
      {
        "anfragereferenz": "anfragereferenz",
        "angebotsdatum": "2024-08-25T15:00:00Z",
        "positionsdaten": [
          {
            "anbietbar": true,
            "artikelnummer": "LEISTUNG",
            "beteiligterMarktpartner": {
              "rollencodenummer": "rollencodenummer",
              "rollencodetyp": "BDEW"
            },
            "freitext": "freitext",
            "positionsbezeichnung": "positionsbezeichnung",
            "positionspreis": [
              {
                "bezugswert": "W",
                "menge": 0,
                "wert": 0
              }
            ],
            "verweisKatalognummer": {
              "katalognummer": "katalognummer",
              "versionsnummer": "versionsnummer",
              "zeilennummer": "zeilennummer"
            }
          }
        ]
      }
    ],
    "MESSLOKATION": [
      {
        "messlokationsId": "messlokationsId"
      }
    ],
    "ZAEHLER": [
      {
        "befestigungsart": "STECKTECHNIK",
        "eichungBis": "eichungBis",
        "geraete": [
          {
            "geraeteeigenschaften": {
              "faktor": 0,
              "geraetemerkmal": "EINTARIF"
            }
          }
        ],
        "messwerterfassung": "FERNAUSLESBAR",
        "tarifart": "EINTARIF",
        "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
        "zaehlergroesse": "EINTARIF",
        "zaehlertyp": "DREHSTROMZAEHLER",
        "zaehlertypspezifikation": "EDL40"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "15001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_ANGEBOT_GERAETEUEBERNAHME",
    "prozessId": "prozessId"
  }
}'

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Request Body

Struktur (BO4E)	Beschreibung	Format	15001
stammdaten*	—	object	Muss
ANFRAGE[ ]*	—	object[]	Muss
`anfragetyp`*00010	Typ/Art der Anfrage (ORDERS ORDRSP IMD 7081)	string	Muss
`KAUF`			Muss
`NUTZUNGSUEBERLASSUNG`			Muss
`ABRECHNUNGSBRENNWERT_UND_ZUSTANDSZAHL`			Muss
`LASTGANGDATEN`			Muss
`ZAEHLERSTAENDE`			Muss
`WERTEERMITTLUNG`			Muss
`ENERGIEMENGE_EINZELWERT`			Muss
`INNERHALB_DER_ARBEITSZEIT`			Muss
`AUCH_AUSSERHALB_DER_ARBEITSZEIT`			Muss
`WECHSEL_SAEMTLICHER_EINRICHTUNGEN`			Muss
`TEILWEISER_WECHSEL`			Muss
`AENDERUNG_ZAEHLZEITDEFINITION`			Muss
`ABBESTELLUNG_ZAEHLZEITEN`			Muss
`ABBESTELLUNG_MESSPRODUKT`			Muss
`ANGEBOT_AUF_BASIS_PREISBLATT`			Muss
`INDIVIDUELLES_ANGEBOT`			Muss
`AENDERUNG_KONFIGURATION`			Muss
`KANN_NICHT_ANGEBOTEN_WERDEN`			Muss
`NEUKONFIGURATION`			Muss
`BEENDIGUNG_KONFIGURATION`			Muss
`AKTIVIERUNG_KONFIGURATION`			Muss
ANGEBOT[ ]*	—	object[]	Muss
`anfragereferenz`*00020	Referenz auf eine Anfrage oder Ausschreibung. Kann dem Empfänger des Angebotes bei Zuordnung des Angebotes zur Anfrage bzw.Ausschreibung helfen.	string	Muss
`angebotsdatum`*00030	Erstellungsdatum des Angebots	string (date-time)	Muss
positionsdaten[ ]*	—	object[]	Muss
`anbietbar`00040	—	boolean	Kann
`artikelnummer`*00050	BDEW Artikelnummer	string	Muss
`LEISTUNG`			Muss
`LEISTUNG_PAUSCHAL`			Muss
`GRUNDPREIS`			Muss
`REGELENERGIE_ARBEIT`			Muss
`REGELENERGIE_LEISTUNG`			Muss
`NOTSTROMLIEFERUNG_ARBEIT`			Muss
`NOTSTROMLIEFERUNG_LEISTUNG`			Muss
`RESERVENETZKAPAZITAET`			Muss
`RESERVELEISTUNG`			Muss
`ZUSAETZLICHE_ABLESUNG`			Muss
`PRUEFGEBUEHREN_AUSSERPLANMAESSIG`			Muss
`WIRKARBEIT`			Muss
`SINGULAER_GENUTZTE_BETRIEBSMITTEL`			Muss
`ABGABE_KWKG`			Muss
`ABSCHLAG`			Muss
`KONZESSIONSABGABE`			Muss
`ENTGELT_FERNAUSLESUNG`			Muss
`UNTERMESSUNG`			Muss
`BLINDMEHRARBEIT`			Muss
`ENTGELT_ABRECHNUNG`			Muss
`SPERRKOSTEN`			Muss
`ENTSPERRKOSTEN`			Muss
`MAHNKOSTEN`			Muss
`MEHR_MINDERMENGEN`			Muss
`INKASSOKOSTEN`			Muss
`BLINDMEHRLEISTUNG`			Muss
`ENTGELT_MESSUNG_ABLESUNG`			Muss
`ENTGELT_EINBAU_BETRIEB_WARTUNG_MESSTECHNIK`			Muss
`AUSGLEICHSENERGIE`			Muss
`AUSGLEICHSENERGIE_UNTERDECKUNG`			Muss
`ZAEHLEINRICHTUNG`			Muss
`WANDLER_MENGENUMWERTER`			Muss
`KOMMUNIKATIONSEINRICHTUNG`			Muss
`TECHNISCHE_STEUEREINRICHTUNG`			Muss
`PARAGRAF_19_STROM_NEV_UMLAGE`			Muss
`BEFESTIGUNGSEINRICHTUNG`			Muss
`OFFSHORE_HAFTUNGSUMLAGE`			Muss
`FIXE_ARBEITSENTGELTKOMPONENTE`			Muss
`FIXE_LEISTUNGSENTGELTKOMPONENTE`			Muss
`UMLAGE_ABSCHALTBARE_LASTEN`			Muss
`MEHRMENGE`			Muss
`MINDERMENGE`			Muss
`ENERGIESTEUER`			Muss
`SMARTMETER_GATEWAY`			Muss
`STEUERBOX`			Muss
`MSB_INKL_MESSUNG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_1_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_2_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_3_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_4_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_2_5_MSBG`			Muss
`ZUSATZDIENSTLEISTUNG_PARAGRAPH_35_3_MSBG`			Muss
`ENTGELT_KAPAZITAETEN`			Muss
`freitext`00060	Freitext / FTX+ACB	string	Kann
`positionsbezeichnung`*00070	Bezeichnung der Position	string	Muss
beteiligterMarktpartner	—	object	Kann
`rollencodenummer`00080	Gibt die Codenummer der Marktrolle an.	string	Kann
`rollencodetyp`00090	Gibt den Typ des Codes an.	string	Kann
`BDEW`			Kann
`GS1`			Kann
`GLN`			Kann
`DVGW`			Kann
positionspreis[ ]	—	object[]	Kann
`bezugswert`00100	Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können	string	Kann
`W`			Kann
`WH`			Kann
`KW`			Kann
`KWH`			Kann
`KVARH`			Kann
`MW`			Kann
`MWH`			Kann
`STUECK`			Kann
`KUBIKMETER`			Kann
`STUNDE`			Kann
`TAG`			Kann
`MONAT`			Kann
`JAHR`			Kann
`PROZENT`			Kann
`ANZAHL`			Kann
`VAR`			Kann
`KVAR`			Kann
`VARH`			Kann
`KWHK`			Kann
`Z16`			Kann
`KWT`			Kann
`menge`00110	menge	integer	Kann
`wert`00120	Wert	number (float)	Kann
verweisKatalognummer	—	object	Kann
`katalognummer`00130	Katalognummer	string	Kann
`versionsnummer`00140	Versionsnummer	string	Kann
`zeilennummer`00150	Zeilennummer	string	Kann
MESSLOKATION[ ]*	—	object[]	Muss
`messlokationsId`*00160	Die Messlokations-Identifikation. Das ist die frühere Zählpunktbezeichnung, z.B. DE 47108151234567	string	Muss
ZAEHLER[ ]	—	object[]	Kann
`befestigungsart`00170	Befestigungsart	string	Kann
`STECKTECHNIK`			Kann
`DREIPUNKT`			Kann
`HUTSCHIENE`			Kann
`EINSTUTZEN`			Kann
`ZWEISTUTZEN`			Kann
`eichungBis`00180	Bis zu diesem Datum ist der Zähler geeicht.	string	Kann
`messwerterfassung`00190	Messwerterfassung am Zählpunkt	string	Kann
`FERNAUSLESBAR`			Kann
`MANUELL_AUSGELESENE`			Kann
`tarifart`00200	Spezifikation bezüglich unterstützter Tarifarten.	string	Kann
`EINTARIF`			Kann
`ZWEITARIF`			Kann
`MEHRTARIF`			Kann
`SMART_METER`			Kann
`LEISTUNGSGEMESSEN`			Kann
`zaehlerauspraegung`00210	Spezifikation die Richtung des Zählers betreffend.	string	Kann
`EINRICHTUNGSZAEHLER`			Kann
`ZWEIRICHTUNGSZAEHLER`			Kann
`zaehlergroesse`00220	Zaehlergroesse	string	Kann
`EINTARIF`			Kann
`ZWEITARIF`			Kann
`MEHRTARIF`			Kann
`GAS_G2P5`			Kann
`GAS_G4`			Kann
`GAS_G6`			Kann
`GAS_G10`			Kann
`GAS_G16`			Kann
`GAS_G25`			Kann
`GAS_G40`			Kann
`GAS_G65`			Kann
`GAS_G100`			Kann
`GAS_G160`			Kann
`GAS_G250`			Kann
`GAS_G350`			Kann
`GAS_G400`			Kann
`GAS_G4000`			Kann
`GAS_G650`			Kann
`GAS_G6500`			Kann
`GAS_G1000`			Kann
`GAS_G10000`			Kann
`GAS_G12500`			Kann
`GAS_G1600`			Kann
`GAS_G16000`			Kann
`GAS_G2500`			Kann
`IMPULSGEBER_G4_G100`			Kann
`IMPULSGEBER_G100`			Kann
`MODEM_GSM`			Kann
`MODEM_GPRS`			Kann
`MODEM_FUNK`			Kann
`MODEM_GSM_O_LG`			Kann
`MODEM_GSM_M_LG`			Kann
`MODEM_FESTNETZ`			Kann
`MODEM_GPRS_M_LG`			Kann
`PLC_COM`			Kann
`ETHERNET_KOM`			Kann
`DSL_KOM`			Kann
`LTE_KOM`			Kann
`RUNDSTEUEREMPFAENGER`			Kann
`TARIFSCHALTGERAET`			Kann
`ZUSTANDS_MU`			Kann
`TEMPERATUR_MU`			Kann
`KOMPAKT_MU`			Kann
`SYSTEM_MU`			Kann
`UNBESTIMMT`			Kann
`WASSER_MWZW`			Kann
`WASSER_WZWW`			Kann
`WASSER_WZ01`			Kann
`WASSER_WZ02`			Kann
`WASSER_WZ03`			Kann
`WASSER_WZ04`			Kann
`WASSER_WZ05`			Kann
`WASSER_WZ06`			Kann
`WASSER_WZ07`			Kann
`WASSER_WZ08`			Kann
`WASSER_WZ09`			Kann
`WASSER_WZ10`			Kann
`WASSER_VWZ04`			Kann
`WASSER_VWZ05`			Kann
`WASSER_VWZ06`			Kann
`WASSER_VWZ07`			Kann
`WASSER_VWZ10`			Kann
`DICHTEMENGENUMWERTER`			Kann
`TEMPERATURMENGENUMWERTER`			Kann
`ZUSTANDSMENGENUMWERTER`			Kann
`BLOCKSTROMWANDLER`			Kann
`MESSWANDLERSATZ_IMS_MME`			Kann
`KOMBIMESSWANDLER`			Kann
`SPANNUNGSWANDLER`			Kann
`zaehlertyp`00230	Typisierung des Zählers	string	Kann
`DREHSTROMZAEHLER`			Kann
`BALGENGASZAEHLER`			Kann
`DREHKOLBENZAEHLER`			Kann
`SMARTMETER`			Kann
`LEISTUNGSZAEHLER`			Kann
`MAXIMUMZAEHLER`			Kann
`TURBINENRADGASZAEHLER`			Kann
`ULTRASCHALLGASZAEHLER`			Kann
`WECHSELSTROMZAEHLER`			Kann
`WIRBELGASZAEHLER`			Kann
`MESSDATENREGISTRIERGERAET`			Kann
`ELEKTRONISCHERHAUSHALTSZAEHLER`			Kann
`SONDERAUSSTATTUNG`			Kann
`WASSERZAEHLER`			Kann
`MODERNEMESSEINRICHTUNG`			Kann
`zaehlertypspezifikation`00240	Typisierung des Zählers (spezifikation für EHZ und MME)	string	Kann
`EDL40`			Kann
`EDL21`			Kann
`SONSTIGER_EHZ`			Kann
`MME_STANDARD`			Kann
`MME_MEDA`			Kann
geraete[ ]	—	object[]	Kann
geraeteeigenschaften	—	object	Kann
`faktor`00250	faktor	number (float)	Kann
`geraetemerkmal`00260	Geraetemerkmal	string	Kann
`EINTARIF`			Kann
`ZWEITARIF`			Kann
`MEHRTARIF`			Kann
`GAS_G2P5`			Kann
`GAS_G4`			Kann
`GAS_G6`			Kann
`GAS_G10`			Kann
`GAS_G16`			Kann
`GAS_G25`			Kann
`GAS_G40`			Kann
`GAS_G65`			Kann
`GAS_G100`			Kann
`GAS_G160`			Kann
`GAS_G250`			Kann
`GAS_G350`			Kann
`GAS_G400`			Kann
`GAS_G4000`			Kann
`GAS_G650`			Kann
`GAS_G6500`			Kann
`GAS_G1000`			Kann
`GAS_G10000`			Kann
`GAS_G12500`			Kann
`GAS_G1600`			Kann
`GAS_G16000`			Kann
`GAS_G2500`			Kann
`IMPULSGEBER_G4_G100`			Kann
`IMPULSGEBER_G100`			Kann
`MODEM_GSM`			Kann
`MODEM_GPRS`			Kann
`MODEM_FUNK`			Kann
`MODEM_GSM_O_LG`			Kann
`MODEM_GSM_M_LG`			Kann
`MODEM_FESTNETZ`			Kann
`MODEM_GPRS_M_LG`			Kann
`PLC_COM`			Kann
`ETHERNET_KOM`			Kann
`DSL_KOM`			Kann
`LTE_KOM`			Kann
`RUNDSTEUEREMPFAENGER`			Kann
`TARIFSCHALTGERAET`			Kann
`ZUSTANDS_MU`			Kann
`TEMPERATUR_MU`			Kann
`KOMPAKT_MU`			Kann
`SYSTEM_MU`			Kann
`UNBESTIMMT`			Kann
`WASSER_MWZW`			Kann
`WASSER_WZWW`			Kann
`WASSER_WZ01`			Kann
`WASSER_WZ02`			Kann
`WASSER_WZ03`			Kann
`WASSER_WZ04`			Kann
`WASSER_WZ05`			Kann
`WASSER_WZ06`			Kann
`WASSER_WZ07`			Kann
`WASSER_WZ08`			Kann
`WASSER_WZ09`			Kann
`WASSER_WZ10`			Kann
`WASSER_VWZ04`			Kann
`WASSER_VWZ05`			Kann
`WASSER_VWZ06`			Kann
`WASSER_VWZ07`			Kann
`WASSER_VWZ10`			Kann
`DICHTEMENGENUMWERTER`			Kann
`TEMPERATURMENGENUMWERTER`			Kann
`ZUSTANDSMENGENUMWERTER`			Kann
`BLOCKSTROMWANDLER`			Kann
`MESSWANDLERSATZ_IMS_MME`			Kann
`KOMBIMESSWANDLER`			Kann
`SPANNUNGSWANDLER`			Kann
transaktionsdaten*	—	object	Muss
`kategorie`*00270	Qualifier aus dem Beginn der EDIFact Nachricht / BGM	string	Muss
`pruefidentifikator`00280	Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 15001.	—	Kann
`sparte`*00290	Enthält Informationen über die Sparte	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`marktrolle`00300	Gibt im Klartext die Bezeichnung der Marktrolle an.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`rollencodenummer`00310	Gibt die Codenummer der Marktrolle an.	string	Kann
empfaenger*	—	object	Muss
`marktrolle`00320	Gibt im Klartext die Bezeichnung der Marktrolle an.	string	Kann
`NB`			Kann
`LF`			Kann
`MSB`			Kann
`MSBA`			Kann
`GMSB`			Kann
`MDL`			Kann
`DL`			Kann
`BKV`			Kann
`BKO`			Kann
`UENB`			Kann
`KUNDE-SELBST-NN`			Kann
`MGV`			Kann
`EIV`			Kann
`RB`			Kann
`KUNDE`			Kann
`INTERESSENT`			Kann
`KN`			Kann
`UBA`			Kann
`BIKO`			Kann
`ESA`			Kann
`rollencodenummer`00330	Gibt die Codenummer der Marktrolle an.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00340	—	string	Muss
`prozessId`*00350	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "ANFRAGE": [
      {
        "anfragetyp": "KAUF"
      }
    ],
    "ANGEBOT": [
      {
        "anfragereferenz": "anfragereferenz",
        "angebotsdatum": "2024-08-25T15:00:00Z",
        "positionsdaten": [
          {
            "anbietbar": true,
            "artikelnummer": "LEISTUNG",
            "beteiligterMarktpartner": {
              "rollencodenummer": "rollencodenummer",
              "rollencodetyp": "BDEW"
            },
            "freitext": "freitext",
            "positionsbezeichnung": "positionsbezeichnung",
            "positionspreis": [
              {
                "bezugswert": "W",
                "menge": 0,
                "wert": 0
              }
            ],
            "verweisKatalognummer": {
              "katalognummer": "katalognummer",
              "versionsnummer": "versionsnummer",
              "zeilennummer": "zeilennummer"
            }
          }
        ]
      }
    ],
    "MESSLOKATION": [
      {
        "messlokationsId": "messlokationsId"
      }
    ],
    "ZAEHLER": [
      {
        "befestigungsart": "STECKTECHNIK",
        "eichungBis": "eichungBis",
        "geraete": [
          {
            "geraeteeigenschaften": {
              "faktor": 0,
              "geraetemerkmal": "EINTARIF"
            }
          }
        ],
        "messwerterfassung": "FERNAUSLESBAR",
        "tarifart": "EINTARIF",
        "zaehlerauspraegung": "EINRICHTUNGSZAEHLER",
        "zaehlergroesse": "EINTARIF",
        "zaehlertyp": "DREHSTROMZAEHLER",
        "zaehlertypspezifikation": "EDL40"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "15001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_ANGEBOT_GERAETEUEBERNAHME",
    "prozessId": "prozessId"
  }
}

json

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Responses

Erfolg | Success

Struktur (BO4E)	Beschreibung	Format
`businessKey`*	Einzigartige Kennung des Geschäftsprozesses \| Unique identifier of the business process	string (uuid)
`message`*	Nachricht mit Details zum ausgelösten Event \| Message with details about the triggered event	string

Trigger-Event START_ANGEBOT_GERAETEUEBERNAHME der Marktrolle MSB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Hinweise zu dieser Seite

Feedback zur Dokumentation

Feedback zur Dokumentation

Geräteübernahme

START_ANGEBOT_GERAETEUEBERNAHME (MSB)

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Request Body

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Responses

Geräteübernahme

START_ANGEBOT_GERAETEUEBERNAHME (MSB)

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Request Body

START_ANGEBOT_GERAETEUEBERNAHME (MSB) › Responses