- Kundendokumentation
- Oracle
- API Docs
- Overview
- Error codes
- Changelog Interfaces
- Business Objects
- Integration Layer
- Trigger Events (MACO APP)
- Read BO4E (Backend)
- Get Communication Data
- Get Meter
- Get Tranche
- Get Technical Resource
- Get Controllable Resource
- Get Grid Usage Contract
- Get Grid Location
- Get Metering Point Operation Contract
- Get Meter Location
- Get Market Location
- Get Location Bundle
- Get Meter Readings
- Get The Load Profile
- Get Energy Amount
- Get Energy Supply Contract
- Get Balance Sheet
- Get CalculationFormula
- Get Avis
- Read Process Data (Backend)
- Write Process Data LF (Backend)
- Process Docs
Start of delivery
POST
/inbound
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Body Params application/json
Examples
{
"stammdaten": {
"MARKTLOKATION": [
{
"boTyp": "MARKTLOKATION",
"versionStruktur": "1",
"marktlokationsId": "50754496000",
"erforderlichesProduktpaket": [
{
"produktpaketId": 1,
"produkt": [
{
"produktCode": "9991000002082",
"wertedetails": "11Y0-0000-0077-K"
},
{
"produktCode": "9991000002008",
"codeProdukteigenschaft": "9991000002115"
}
],
"umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
}
],
"marktlokationsTyp": [
{
"typ": "STANDARD_MARKTLOKATION"
}
]
}
],
"NETZNUTZUNGSVERTRAG": [
{
"boTyp": "VERTRAG",
"versionStruktur": "1",
"vertragsart": "NETZNUTZUNGSVERTRAG",
"sparte": "STROM",
"vertragskonditionen": {
"haushaltskunde": true
}
}
],
"ENERGIELIEFERVERTRAG": [
{
"boTyp": "VERTRAG",
"versionStruktur": "1",
"vertragsart": "ENERGIELIEFERVERTRAG",
"sparte": "STROM",
"vertragspartner2": [
{
"boTyp": "GESCHAEFTSPARTNER",
"versionStruktur": "1",
"anrede": "Herr",
"name1": "Glöppel",
"name2": "Walter",
"gewerbekennzeichnung": false,
"geschaeftspartnerrolle": [
"KUNDE"
]
}
],
"korrespondenzpartner": {
"boTyp": "GESCHAEFTSPARTNER",
"versionStruktur": "1",
"name1": "Glöppel",
"gewerbekennzeichnung": false,
"partneradresse": {
"postleitzahl": "41515",
"ort": "Grevenbroich",
"strasse": "Bahnstraße",
"hausnummer": "49",
"landescode": "DE"
}
},
"enFG": [
{
"grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG",
"grund": [
"ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
]
}
]
}
]
},
"transaktionsdaten": {
"transaktionsgrund": "E01",
"transaktionsgrundergaenzung": "ZW4",
"sparte": "STROM",
"vertragsbeginn": "2025-10-31T23:00:00Z",
"absender": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9903526000002",
"rollencodetyp": "BDEW"
},
"empfaenger": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9900683000008",
"rollencodetyp": "BDEW"
},
"kategorie": "E01"
},
"zusatzdaten": {
"prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
"eventname": "START_LIEFERBEGINN"
}
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST '/inbound' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"stammdaten": {
"MARKTLOKATION": [
{
"boTyp": "MARKTLOKATION",
"versionStruktur": "1",
"marktlokationsId": "50754496000",
"erforderlichesProduktpaket": [
{
"produktpaketId": 1,
"produkt": [
{
"produktCode": "9991000002082",
"wertedetails": "11Y0-0000-0077-K"
},
{
"produktCode": "9991000002008",
"codeProdukteigenschaft": "9991000002115"
}
],
"umsetzungsgradvorgabe": "ZUORDNUNG_NUR_WENN_PRODUKTPAKET_UMSETZBAR"
}
],
"marktlokationsTyp": [
{
"typ": "STANDARD_MARKTLOKATION"
}
]
}
],
"NETZNUTZUNGSVERTRAG": [
{
"boTyp": "VERTRAG",
"versionStruktur": "1",
"vertragsart": "NETZNUTZUNGSVERTRAG",
"sparte": "STROM",
"vertragskonditionen": {
"haushaltskunde": true
}
}
],
"ENERGIELIEFERVERTRAG": [
{
"boTyp": "VERTRAG",
"versionStruktur": "1",
"vertragsart": "ENERGIELIEFERVERTRAG",
"sparte": "STROM",
"vertragspartner2": [
{
"boTyp": "GESCHAEFTSPARTNER",
"versionStruktur": "1",
"anrede": "Herr",
"name1": "Glöppel",
"name2": "Walter",
"gewerbekennzeichnung": false,
"geschaeftspartnerrolle": [
"KUNDE"
]
}
],
"korrespondenzpartner": {
"boTyp": "GESCHAEFTSPARTNER",
"versionStruktur": "1",
"name1": "Glöppel",
"gewerbekennzeichnung": false,
"partneradresse": {
"postleitzahl": "41515",
"ort": "Grevenbroich",
"strasse": "Bahnstraße",
"hausnummer": "49",
"landescode": "DE"
}
},
"enFG": [
{
"grundlageVerringerungUmlagen": "ERFUELLT_VORAUSSETZUNG_NACH_ENFG",
"grund": [
"ENFG_ELEKTRISCH_ANGETRIEBENE_WAERMEPUMPEN"
]
}
]
}
]
},
"transaktionsdaten": {
"transaktionsgrund": "E01",
"transaktionsgrundergaenzung": "ZW4",
"sparte": "STROM",
"vertragsbeginn": "2025-10-31T23:00:00Z",
"absender": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9903526000002",
"rollencodetyp": "BDEW"
},
"empfaenger": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9900683000008",
"rollencodetyp": "BDEW"
},
"kategorie": "E01"
},
"zusatzdaten": {
"prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E",
"eventname": "START_LIEFERBEGINN"
}
}'Responses
🟢201Created
application/json
Body
Example
{
"businessKey": "2318a5eb-43aa-4608-9ea1-3dcf2eacc794",
"message": "received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107"
}🟠400Bad Request
Modified at 2025-09-19 08:49:26