Order placement of a configuration from LF…

START_BESTELLUNG_KONFIGURATION (LF)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

Bestellung einer Konfiguration vom LF an MSB — LF

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "beteiligterMarktpartner": [
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "UENB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          },
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "MSB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          }
        ],
        "boTyp": "MARKTLOKATION",
        "energierichtung": "AUSSP",
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1",
        "zaehlwerke": [
          {
            "messprodukt": "9991000000044",
            "verwendungszwecke": [
              {
                "marktrolle": "NB",
                "zweck": [
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              },
              {
                "marktrolle": "LF",
                "zweck": [
                  {
                    "items": "ENDKUNDENABRECHNUNG"
                  },
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              }
            ],
            "zaehlzeiten": {
              "zaehlzeitDefinition": "ETS"
            }
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW"
    },
    "ausfuehrungsdatum": "2025-10-31T23:00:00Z",
    "beteiligterMarktpartner": {
      "boTyp": "MARKTTEILNEHMER",
      "geschaeftspartnerrolle": "LIEFERANT",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "Z92",
    "sparte": "STROM",
    "transaktionsgrund": "Z67"
  },
  "zusatzdaten": {
    "eventname": "START_BESTELLUNG_KONFIGURATION",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}'

START_BESTELLUNG_KONFIGURATION (LF) › 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	17130
stammdaten*	—	object	Muss
ANFRAGE[ ]*	—	object[]	Muss
`lokationsId`*00010	Which market or metering location this request applies to.	string	Muss
AUFTRAG[ ]	—	object[]	Kann
`ausfuehrungsdatum`00020	The execution date describes at which point in time an order is to be executed.	string (date-time)	Kann
WERTE_NACH_TYP2[ ]	—	object[]	Kann
`aenderungsmoeglichkeitKonfiguration`00030	AenderungsmoeglichkeitKonfiguration	string	Kann
`ERFORDERLICH`			Kann
`NICHT_ERFORDERLICH`			Kann
`messprodukt`00040	messprodukt	string	Kann
aussteller	—	object	Kann
`aussteller1`00050	aussteller1	string	Kann
`aussteller2`00060	aussteller2	string	Kann
`aussteller3`00070	aussteller3	string	Kann
`aussteller4`00080	aussteller4	string	Kann
`aussteller5`00090	aussteller5	string	Kann
schwellwerte[ ]	—	object[]	Kann
`konfigurationsprodukt`00100	konfigurationsprodukt	string	Kann
`obererSchwellwert`00110	obererSchwellwert	number (float)	Kann
`untererSchwellwert`00120	untererSchwellwert	number (float)	Kann
zertifikatsNutzer	—	object	Kann
`zertifikatsNutzer1`00130	zertifikatsNutzer1	string	Kann
`zertifikatsNutzer2`00140	zertifikatsNutzer2	string	Kann
`zertifikatsNutzer3`00150	zertifikatsNutzer3	string	Kann
`zertifikatsNutzer4`00160	zertifikatsNutzer4	string	Kann
`zertifikatsNutzer5`00170	zertifikatsNutzer5	string	Kann
zieladresse	—	object	Kann
`zieladresse1`00180	zieladresse1	string	Kann
`zieladresse2`00190	zieladresse2	string	Kann
`zieladresse3`00200	zieladresse3	string	Kann
`zieladresse4`00210	zieladresse4	string	Kann
`zieladresse5`00220	zieladresse5	string	Kann
transaktionsdaten*	—	object	Muss
`kategorie`*00230	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss
`pruefidentifikator`00240	Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 17130.	—	Kann
`sparte`*00250	Contains information about the division	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00260	Specifies the code value of the market role.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00270	Specifies the code value of the market role.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00280	—	string	Muss
`prozessId`*00290	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "beteiligterMarktpartner": [
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "UENB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          },
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "MSB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          }
        ],
        "boTyp": "MARKTLOKATION",
        "energierichtung": "AUSSP",
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1",
        "zaehlwerke": [
          {
            "messprodukt": "9991000000044",
            "verwendungszwecke": [
              {
                "marktrolle": "NB",
                "zweck": [
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              },
              {
                "marktrolle": "LF",
                "zweck": [
                  {
                    "items": "ENDKUNDENABRECHNUNG"
                  },
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              }
            ],
            "zaehlzeiten": {
              "zaehlzeitDefinition": "ETS"
            }
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW"
    },
    "ausfuehrungsdatum": "2025-10-31T23:00:00Z",
    "beteiligterMarktpartner": {
      "boTyp": "MARKTTEILNEHMER",
      "geschaeftspartnerrolle": "LIEFERANT",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "Z92",
    "sparte": "STROM",
    "transaktionsgrund": "Z67"
  },
  "zusatzdaten": {
    "eventname": "START_BESTELLUNG_KONFIGURATION",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}

json

application/json

START_BESTELLUNG_KONFIGURATION (LF) › 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_BESTELLUNG_KONFIGURATION der Marktrolle LF.

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_BESTELLUNG_ANGEBOT_KONFIGURATION Billing data for balancing group settlement, …

START_BESTELLUNG_KONFIGURATION (LF)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

Bestellung einer Konfiguration vom LF an MSB — LF

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "beteiligterMarktpartner": [
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "UENB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          },
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "MSB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          }
        ],
        "boTyp": "MARKTLOKATION",
        "energierichtung": "AUSSP",
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1",
        "zaehlwerke": [
          {
            "messprodukt": "9991000000044",
            "verwendungszwecke": [
              {
                "marktrolle": "NB",
                "zweck": [
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              },
              {
                "marktrolle": "LF",
                "zweck": [
                  {
                    "items": "ENDKUNDENABRECHNUNG"
                  },
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              }
            ],
            "zaehlzeiten": {
              "zaehlzeitDefinition": "ETS"
            }
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW"
    },
    "ausfuehrungsdatum": "2025-10-31T23:00:00Z",
    "beteiligterMarktpartner": {
      "boTyp": "MARKTTEILNEHMER",
      "geschaeftspartnerrolle": "LIEFERANT",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "Z92",
    "sparte": "STROM",
    "transaktionsgrund": "Z67"
  },
  "zusatzdaten": {
    "eventname": "START_BESTELLUNG_KONFIGURATION",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}'

START_BESTELLUNG_KONFIGURATION (LF) › Request Body

Structure (BO4E)	Description	Format	17130
stammdaten*	—	object	Muss
ANFRAGE[ ]*	—	object[]	Muss
`lokationsId`*00010	Which market or metering location this request applies to.	string	Muss
AUFTRAG[ ]	—	object[]	Kann
`ausfuehrungsdatum`00020	The execution date describes at which point in time an order is to be executed.	string (date-time)	Kann
WERTE_NACH_TYP2[ ]	—	object[]	Kann
`aenderungsmoeglichkeitKonfiguration`00030	AenderungsmoeglichkeitKonfiguration	string	Kann
`ERFORDERLICH`			Kann
`NICHT_ERFORDERLICH`			Kann
`messprodukt`00040	messprodukt	string	Kann
aussteller	—	object	Kann
`aussteller1`00050	aussteller1	string	Kann
`aussteller2`00060	aussteller2	string	Kann
`aussteller3`00070	aussteller3	string	Kann
`aussteller4`00080	aussteller4	string	Kann
`aussteller5`00090	aussteller5	string	Kann
schwellwerte[ ]	—	object[]	Kann
`konfigurationsprodukt`00100	konfigurationsprodukt	string	Kann
`obererSchwellwert`00110	obererSchwellwert	number (float)	Kann
`untererSchwellwert`00120	untererSchwellwert	number (float)	Kann
zertifikatsNutzer	—	object	Kann
`zertifikatsNutzer1`00130	zertifikatsNutzer1	string	Kann
`zertifikatsNutzer2`00140	zertifikatsNutzer2	string	Kann
`zertifikatsNutzer3`00150	zertifikatsNutzer3	string	Kann
`zertifikatsNutzer4`00160	zertifikatsNutzer4	string	Kann
`zertifikatsNutzer5`00170	zertifikatsNutzer5	string	Kann
zieladresse	—	object	Kann
`zieladresse1`00180	zieladresse1	string	Kann
`zieladresse2`00190	zieladresse2	string	Kann
`zieladresse3`00200	zieladresse3	string	Kann
`zieladresse4`00210	zieladresse4	string	Kann
`zieladresse5`00220	zieladresse5	string	Kann
transaktionsdaten*	—	object	Muss
`kategorie`*00230	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss
`pruefidentifikator`00240	Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 17130.	—	Kann
`sparte`*00250	Contains information about the division	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00260	Specifies the code value of the market role.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00270	Specifies the code value of the market role.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00280	—	string	Muss
`prozessId`*00290	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "MARKTLOKATION": [
      {
        "beteiligterMarktpartner": [
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "UENB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          },
          {
            "boTyp": "MARKTTEILNEHMER",
            "marktrolle": "MSB",
            "rollencodenummer": "9900683000008",
            "rollencodetyp": "BDEW",
            "versionStruktur": "1"
          }
        ],
        "boTyp": "MARKTLOKATION",
        "energierichtung": "AUSSP",
        "marktlokationsId": "50754496000",
        "sparte": "STROM",
        "versionStruktur": "1",
        "zaehlwerke": [
          {
            "messprodukt": "9991000000044",
            "verwendungszwecke": [
              {
                "marktrolle": "NB",
                "zweck": [
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              },
              {
                "marktrolle": "LF",
                "zweck": [
                  {
                    "items": "ENDKUNDENABRECHNUNG"
                  },
                  {
                    "items": "NETZNUTZUNGSABRECHNUNG"
                  },
                  {
                    "items": "BILANZKREISABRECHNUNG"
                  },
                  {
                    "items": "MEHRMINDERMENGENABRECHNUNG"
                  }
                ]
              }
            ],
            "zaehlzeiten": {
              "zaehlzeitDefinition": "ETS"
            }
          }
        ]
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "9903526000002",
      "rollencodetyp": "BDEW"
    },
    "ausfuehrungsdatum": "2025-10-31T23:00:00Z",
    "beteiligterMarktpartner": {
      "boTyp": "MARKTTEILNEHMER",
      "geschaeftspartnerrolle": "LIEFERANT",
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "rollencodenummer": "9900683000008",
      "rollencodetyp": "BDEW"
    },
    "kategorie": "Z92",
    "sparte": "STROM",
    "transaktionsgrund": "Z67"
  },
  "zusatzdaten": {
    "eventname": "START_BESTELLUNG_KONFIGURATION",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}

json

application/json

START_BESTELLUNG_KONFIGURATION (LF) › 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_BESTELLUNG_KONFIGURATION der Marktrolle LF.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Feedback on the documentation

Feedback on the documentation

Order placement of a configuration from LF…

START_BESTELLUNG_KONFIGURATION (LF)

START_BESTELLUNG_KONFIGURATION (LF) › Request Body

START_BESTELLUNG_KONFIGURATION (LF) › Responses

Order placement of a configuration from LF…

START_BESTELLUNG_KONFIGURATION (LF)

START_BESTELLUNG_KONFIGURATION (LF) › Request Body

START_BESTELLUNG_KONFIGURATION (LF) › Responses