Billing data for balancing group settlement, …

START_VERSAND_BEARB_MELDUNG (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (7):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "enFG": [
          {
            "grund": [
              "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
            ],
            "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG"
          }
        ],
        "korrespondenzpartner": {
          "boTyp": "GESCHAEFTSPARTNER",
          "gewerbekennzeichnung": false,
          "name1": "Glöppel",
          "partneradresse": {
            "hausnummer": "49",
            "landescode": "DE",
            "ort": "Grevenbroich",
            "postleitzahl": "41515",
            "strasse": "Bahnstraße"
          },
          "versionStruktur": "1"
        },
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "ENERGIELIEFERVERTRAG",
        "vertragspartner2": [
          {
            "anrede": "Herr",
            "boTyp": "GESCHAEFTSPARTNER",
            "geschaeftspartnerrolle": [
              "KUNDE"
            ],
            "gewerbekennzeichnung": false,
            "name1": "Glöppel",
            "name2": "Walter",
            "versionStruktur": "1"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "erforderlichesProduktpaket": [
          {
            "produkt": [
              {
                "produktCode": "9991000002082",
                "wertedetails": "11Y0-0000-0077-K"
              },
              {
                "codeProdukteigenschaft": "9991000002115",
                "produktCode": "9991000002008"
              }
            ],
            "produktpaketId": 1,
            "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
          }
        ],
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "NETZNUTZUNGSVERTRAG",
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "kategorie": "E01",
    "sparte": "STROM",
    "transaktionsgrund": "E01",
    "transaktionsgrundergaenzung": "ZW4"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_NN",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}'

START_VERSAND_BEARB_MELDUNG (NB) › Request Body

The body of this call — one column per admissible Prüfidentifikator. A value in the column means the field belongs to that Prüfidentifikator: Must where the schema requires it, otherwise May.

Structure (BO4E)	Description	Format	21047
stammdaten*	—	object	Muss
STATUSMITTEILUNG[ ]*	—	object[]	Muss
`auftragsstatus`*00010	Order status	string	Muss
`GESCHEITERT`			Muss
`ERFOLGREICH`			Muss
`LIEFERUNG_GEPLANT`			Muss
`GEPLANT`			Muss
`ZUGESTIMMT`			Muss
`WIDERSPROCHEN`			Muss
`STOERUNGSFREI`			Muss
`GESTOERT`			Muss
`FESTGESTELLTE_STOERUNG`			Muss
`VERMUTETE_STOERUNG`			Muss
`ABGELEHNT`			Muss
`BEENDET`			Muss
`ANTWORT_DRITTER`			Muss
`BESTAETIGT`			Muss
`UMGESETZT`			Muss
`ENFG_STROMSPEICHER_UND_VERLUSTENERGIE`			Muss
`ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN`			Muss
`ENFG_UMLAGEERHEBUNG_BEI_ANLAGEN_ZUR_VERSTROMUNG_VON_KUPPELGASEN`			Muss
`ENFG_HERSTELLUNG_VON_GRUENEN_WASSERSTOFF`			Muss
`ENFG_STROMKOSTENINTENSIVE_UNTERNEHMEN`			Muss
`ENFG_HERSTELLUNG_VON_WASSERSTOFF_IN_STROMKOSTENINTENSIVEN_UNTERNEHMEN`			Muss
`ENFG_SCHIENENBAHNEN`			Muss
`ENFG_ELEKTRISCHE_BETRIEBENE_BUSSEN_IM_LINIENVERKEHR`			Muss
`ENFG_LANDSTROMANLAGEN`			Muss
`AENDERUNG_DER_DATEN`			Muss
`KEINE_AENDERUNG_DER_DATEN`			Muss
`ZEITREIHE_AKZEPTIERT`			Muss
`ZEITREIHE_NICHT_AKZEPTIERT`			Muss
`statusObjekt`*00020	Status object	string	Muss
`MSBWECHSEL`			Muss
`UMBAUMELO`			Muss
`ERSTEINBAUIMS`			Muss
`ERSTEINBAUMME`			Muss
`GERAET`			Muss
`ANGEBOTANFRAGE`			Muss
`STATUSBESTELLUNG`			Muss
`LIEFERSCHEIN`			Muss
`SPERREN`			Muss
`ENTSPERREN`			Muss
`PRIVILEGIERUNG_NACH_ENFG`			Muss
`VERAENDERUNGSSTATUS_DER_DATEN`			Muss
`TURNUSAUSLESUNG`			Muss
`PRUEFSTATUS_ANTWORT_SUMMENZEITREIHEN`			Muss
`ABWEISUNG_SUMMENZEITREIHE`			Muss
`PRUEFSTATUS_SUMMENZEITREIHE`			Muss
`DATENSTATUS_SUMMENZEITREIHE`			Muss
`ABWEISUNG_STATUSMELDUNG_AENDERUNG`			Muss
`AUSFALLARBEIT`			Muss
`FAHRPLANANTEIL`			Muss
`GEGENVORSCHLAG_AUSFALLARBEIT`			Muss
`GEGENVORSCHLAG_FAHRPLANANTEIL`			Muss
positionsdaten[ ]*	—	object[]	Muss
`positionsnummer`*00030	Line item number	integer	Muss
allgemeineInformationen	—	object	Kann
`info1`00040	General info 1	string	Kann
`info2`00050	General info 2	string	Kann
`info3`00060	General info 3	string	Kann
`info4`00070	General info 4	string	Kann
`info5`00080	General info 5	string	Kann
transaktionsdaten*	—	object	Muss
`pruefidentifikator`00090	Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 21047.	—	Kann
`sparte`*00100	Contains information about the division	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00110	Specifies the code value of the market role.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00120	Specifies the code value of the market role.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00130	—	string	Muss
`prozessId`*00140	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "enFG": [
          {
            "grund": [
              "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
            ],
            "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG"
          }
        ],
        "korrespondenzpartner": {
          "boTyp": "GESCHAEFTSPARTNER",
          "gewerbekennzeichnung": false,
          "name1": "Glöppel",
          "partneradresse": {
            "hausnummer": "49",
            "landescode": "DE",
            "ort": "Grevenbroich",
            "postleitzahl": "41515",
            "strasse": "Bahnstraße"
          },
          "versionStruktur": "1"
        },
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "ENERGIELIEFERVERTRAG",
        "vertragspartner2": [
          {
            "anrede": "Herr",
            "boTyp": "GESCHAEFTSPARTNER",
            "geschaeftspartnerrolle": [
              "KUNDE"
            ],
            "gewerbekennzeichnung": false,
            "name1": "Glöppel",
            "name2": "Walter",
            "versionStruktur": "1"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "erforderlichesProduktpaket": [
          {
            "produkt": [
              {
                "produktCode": "9991000002082",
                "wertedetails": "11Y0-0000-0077-K"
              },
              {
                "codeProdukteigenschaft": "9991000002115",
                "produktCode": "9991000002008"
              }
            ],
            "produktpaketId": 1,
            "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
          }
        ],
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "NETZNUTZUNGSVERTRAG",
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "kategorie": "E01",
    "sparte": "STROM",
    "transaktionsgrund": "E01",
    "transaktionsgrundergaenzung": "ZW4"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_NN",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}

json

application/json

START_VERSAND_BEARB_MELDUNG (NB) › Responses

Success | Success

Structure (BO4E)	Description	Format
`businessKey`*	Unique identifier of the business process \| Unique identifier of the business process	string (uuid)
`message`*	Message with details about the triggered event \| Message with details about the triggered event	string

Trigger-Event START_VERSAND_BEARB_MELDUNG der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

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.

START_VERSAND_ANF_STORNO START_VERSAND_BEENDIGUNG_AGV

START_VERSAND_BEARB_MELDUNG (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (7):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "enFG": [
          {
            "grund": [
              "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
            ],
            "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG"
          }
        ],
        "korrespondenzpartner": {
          "boTyp": "GESCHAEFTSPARTNER",
          "gewerbekennzeichnung": false,
          "name1": "Glöppel",
          "partneradresse": {
            "hausnummer": "49",
            "landescode": "DE",
            "ort": "Grevenbroich",
            "postleitzahl": "41515",
            "strasse": "Bahnstraße"
          },
          "versionStruktur": "1"
        },
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "ENERGIELIEFERVERTRAG",
        "vertragspartner2": [
          {
            "anrede": "Herr",
            "boTyp": "GESCHAEFTSPARTNER",
            "geschaeftspartnerrolle": [
              "KUNDE"
            ],
            "gewerbekennzeichnung": false,
            "name1": "Glöppel",
            "name2": "Walter",
            "versionStruktur": "1"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "erforderlichesProduktpaket": [
          {
            "produkt": [
              {
                "produktCode": "9991000002082",
                "wertedetails": "11Y0-0000-0077-K"
              },
              {
                "codeProdukteigenschaft": "9991000002115",
                "produktCode": "9991000002008"
              }
            ],
            "produktpaketId": 1,
            "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
          }
        ],
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "NETZNUTZUNGSVERTRAG",
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "kategorie": "E01",
    "sparte": "STROM",
    "transaktionsgrund": "E01",
    "transaktionsgrundergaenzung": "ZW4"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_NN",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}'

START_VERSAND_BEARB_MELDUNG (NB) › Request Body

Structure (BO4E)	Description	Format	21047
stammdaten*	—	object	Muss
STATUSMITTEILUNG[ ]*	—	object[]	Muss
`auftragsstatus`*00010	Order status	string	Muss
`GESCHEITERT`			Muss
`ERFOLGREICH`			Muss
`LIEFERUNG_GEPLANT`			Muss
`GEPLANT`			Muss
`ZUGESTIMMT`			Muss
`WIDERSPROCHEN`			Muss
`STOERUNGSFREI`			Muss
`GESTOERT`			Muss
`FESTGESTELLTE_STOERUNG`			Muss
`VERMUTETE_STOERUNG`			Muss
`ABGELEHNT`			Muss
`BEENDET`			Muss
`ANTWORT_DRITTER`			Muss
`BESTAETIGT`			Muss
`UMGESETZT`			Muss
`ENFG_STROMSPEICHER_UND_VERLUSTENERGIE`			Muss
`ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN`			Muss
`ENFG_UMLAGEERHEBUNG_BEI_ANLAGEN_ZUR_VERSTROMUNG_VON_KUPPELGASEN`			Muss
`ENFG_HERSTELLUNG_VON_GRUENEN_WASSERSTOFF`			Muss
`ENFG_STROMKOSTENINTENSIVE_UNTERNEHMEN`			Muss
`ENFG_HERSTELLUNG_VON_WASSERSTOFF_IN_STROMKOSTENINTENSIVEN_UNTERNEHMEN`			Muss
`ENFG_SCHIENENBAHNEN`			Muss
`ENFG_ELEKTRISCHE_BETRIEBENE_BUSSEN_IM_LINIENVERKEHR`			Muss
`ENFG_LANDSTROMANLAGEN`			Muss
`AENDERUNG_DER_DATEN`			Muss
`KEINE_AENDERUNG_DER_DATEN`			Muss
`ZEITREIHE_AKZEPTIERT`			Muss
`ZEITREIHE_NICHT_AKZEPTIERT`			Muss
`statusObjekt`*00020	Status object	string	Muss
`MSBWECHSEL`			Muss
`UMBAUMELO`			Muss
`ERSTEINBAUIMS`			Muss
`ERSTEINBAUMME`			Muss
`GERAET`			Muss
`ANGEBOTANFRAGE`			Muss
`STATUSBESTELLUNG`			Muss
`LIEFERSCHEIN`			Muss
`SPERREN`			Muss
`ENTSPERREN`			Muss
`PRIVILEGIERUNG_NACH_ENFG`			Muss
`VERAENDERUNGSSTATUS_DER_DATEN`			Muss
`TURNUSAUSLESUNG`			Muss
`PRUEFSTATUS_ANTWORT_SUMMENZEITREIHEN`			Muss
`ABWEISUNG_SUMMENZEITREIHE`			Muss
`PRUEFSTATUS_SUMMENZEITREIHE`			Muss
`DATENSTATUS_SUMMENZEITREIHE`			Muss
`ABWEISUNG_STATUSMELDUNG_AENDERUNG`			Muss
`AUSFALLARBEIT`			Muss
`FAHRPLANANTEIL`			Muss
`GEGENVORSCHLAG_AUSFALLARBEIT`			Muss
`GEGENVORSCHLAG_FAHRPLANANTEIL`			Muss
positionsdaten[ ]*	—	object[]	Muss
`positionsnummer`*00030	Line item number	integer	Muss
allgemeineInformationen	—	object	Kann
`info1`00040	General info 1	string	Kann
`info2`00050	General info 2	string	Kann
`info3`00060	General info 3	string	Kann
`info4`00070	General info 4	string	Kann
`info5`00080	General info 5	string	Kann
transaktionsdaten*	—	object	Muss
`pruefidentifikator`00090	Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 21047.	—	Kann
`sparte`*00100	Contains information about the division	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00110	Specifies the code value of the market role.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00120	Specifies the code value of the market role.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00130	—	string	Muss
`prozessId`*00140	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "enFG": [
          {
            "grund": [
              "ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
            ],
            "grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG"
          }
        ],
        "korrespondenzpartner": {
          "boTyp": "GESCHAEFTSPARTNER",
          "gewerbekennzeichnung": false,
          "name1": "Glöppel",
          "partneradresse": {
            "hausnummer": "49",
            "landescode": "DE",
            "ort": "Grevenbroich",
            "postleitzahl": "41515",
            "strasse": "Bahnstraße"
          },
          "versionStruktur": "1"
        },
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "ENERGIELIEFERVERTRAG",
        "vertragspartner2": [
          {
            "anrede": "Herr",
            "boTyp": "GESCHAEFTSPARTNER",
            "geschaeftspartnerrolle": [
              "KUNDE"
            ],
            "gewerbekennzeichnung": false,
            "name1": "Glöppel",
            "name2": "Walter",
            "versionStruktur": "1"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "erforderlichesProduktpaket": [
          {
            "produkt": [
              {
                "produktCode": "9991000002082",
                "wertedetails": "11Y0-0000-0077-K"
              },
              {
                "codeProdukteigenschaft": "9991000002115",
                "produktCode": "9991000002008"
              }
            ],
            "produktpaketId": 1,
            "umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
          }
        ],
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "sparte": "STROM",
        "versionStruktur": "1",
        "vertragsart": "NETZNUTZUNGSVERTRAG",
        "vertragsbeginn": "2025-10-31T23:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "kategorie": "E01",
    "sparte": "STROM",
    "transaktionsgrund": "E01",
    "transaktionsgrundergaenzung": "ZW4"
  },
  "zusatzdaten": {
    "eventname": "START_ABR_NN",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}

json

application/json

START_VERSAND_BEARB_MELDUNG (NB) › Responses

Success | Success

Structure (BO4E)	Description	Format
`businessKey`*	Unique identifier of the business process \| Unique identifier of the business process	string (uuid)
`message`*	Message with details about the triggered event \| Message with details about the triggered event	string

Trigger-Event START_VERSAND_BEARB_MELDUNG der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Feedback on the documentation

Feedback on the documentation

Billing data for balancing group settlement, …

START_VERSAND_BEARB_MELDUNG (NB)

START_VERSAND_BEARB_MELDUNG (NB) › Request Body

START_VERSAND_BEARB_MELDUNG (NB) › Responses

Billing data for balancing group settlement, …

START_VERSAND_BEARB_MELDUNG (NB)

START_VERSAND_BEARB_MELDUNG (NB) › Request Body

START_VERSAND_BEARB_MELDUNG (NB) › Responses