{
"openapi": "3.1.0",
"info": {
"title": "START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB)",
"version": "202610",
"description": "The event `START_ZUORDNUNG_ERZ_MALO_TRANCHE` of the market role NB as a standalone specification, derived from the trigger API of format version 202610. Exactly one path: `POST /inbound`; the event is derived from `zusatzdaten.eventname` in the body."
},
"servers": [
{
"description": "Fake Env",
"url": "https://api.macoapp.de"
}
],
"tags": [
{
"name": "START_ZUORDNUNG_ERZ_MALO_TRANCHE"
}
],
"paths": {
"/inbound": {
"post": {
"deprecated": false,
"description": "Trigger-Event **START_ZUORDNUNG_ERZ_MALO_TRANCHE** der Marktrolle NB.\n\n**Startet diese Rollensichten** (4):\n\n- [Fall 1: LF-Zuordnung bei EEG-Marktlokation ohne DV-Pflicht bzw. KWKG-Marktlokation ohne DV-Pflicht — NB](/prozessdoku/202610/NB/GPKE-Teil2-fall-1-lf-zuordnung-bei-eeg-marktlokation-ohne-dv-pflicht-bzw-kwkg-marktlokation-ohne-dv-pflicht)\n- [Fall 2: LF-Zuordnung bei EEG-Marktlokation mit DV-Pflicht — NB](/prozessdoku/202610/NB/GPKE-Teil2-fall-2-lf-zuordnung-bei-eeg-marktlokation-mit-dv-pflicht)\n- [Fall 3: LF-Zuordnung bei KWKG-Marktlokation mit DV-Pflicht bzw. Nicht-EEG-/Nicht-KWKG-Marktlokation und Marktlokation wird nicht-tranchiert abgebildet — NB](/prozessdoku/202610/NB/GPKE-Teil2-fall-3-lf-zuordnung-bei-kwkg-marktlokation-mit-dv-pflicht-bzw-nicht-eeg-nicht-kwkg-marktlokation-und-marktlokation-wird-nicht-tranchiert-abgebildet)\n- [Fall 4: LF-Zuordnung bei KWKG-Marktlokation mit DV-Pflicht bzw. Nicht-EEG-/Nicht-KWKG-Marktlokation und Marktlokation wird tranchiert abgebildet — NB](/prozessdoku/202610/NB/GPKE-Teil2-fall-4-lf-zuordnung-bei-kwkg-marktlokation-mit-dv-pflicht-bzw-nicht-eeg-nicht-kwkg-marktlokation-und-marktlokation-wird-tranchiert-abgebildet)\n\nSchema nur dieses Ereignisses herunterladen (OpenAPI, JSON).\n\n\n\nDer Aufruf geht tatsächlich an `POST /inbound`; das Event ergibt sich aus `zusatzdaten.eventname` im Rumpf. Diese Seite trennt eine von 104 Rumpfvarianten heraus, damit sie einzeln lesbar und ausprobierbar sind.\n\n",
"operationId": "trigger_NB_START_ZUORDNUNG_ERZ_MALO_TRANCHE",
"parameters": [],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/NB_START_ZUORDNUNG_ERZ_MALO_TRANCHE"
}
}
}
},
"responses": {
"201": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/event_responses_success"
}
}
},
"description": "Success | Success"
},
"400": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/event_response_fail"
}
}
},
"description": "Error | Fail"
}
},
"security": [
{
"bearer": []
}
],
"summary": "START_ZUORDNUNG_ERZ_MALO_TRANCHE (NB)",
"tags": [
"START_ZUORDNUNG_ERZ_MALO_TRANCHE"
],
"x-actual-endpoint": "POST /inbound",
"x-event-source": "event/202610/[NB]_START_ZUORDNUNG_ERZ_MALO_TRANCHE.yaml",
"x-handbuchsatz": true
}
}
},
"components": {
"securitySchemes": {
"bearer": {
"scheme": "bearer",
"type": "http"
}
},
"schemas": {
"BildungTranchengroesse": {
"description": "BildungTranchengroesse",
"enum": [
"PROZENTUAL",
"AUFTEILUNGSFAKTOR",
"AUFTEILUNG_TECHNISCHE_RESSOURCEN",
"BERECHNUNGSFORMEL"
],
"title": "BildungTranchengroesse",
"type": "string"
},
"Erzeugungsart": {
"description": "List of the generation types of energy.",
"enum": [
"EEG",
"KWK",
"EEG_DV",
"KWK_DV",
"WIND",
"SOLAR",
"KERNKRAFT",
"WASSER",
"GEOTHERMIE",
"BIOMASSE",
"KOHLE",
"GAS",
"SONSTIGE",
"SONSTIGE_EEG",
"SONSTIGE_ERZEUGUNGSART"
],
"title": "Generation type",
"type": "string"
},
"MSBEigenschaft": {
"description": "MSB property",
"enum": [
"GRUNDZUSTAENDIGER_MESSSTELLENBETREIBER",
"WETTBEWERBLICHER_MESSSTELLENBETREIBER",
"AUFFANGMESSSTELLENBETREIBER"
],
"title": "MSB property",
"type": "string"
},
"Marktrolle": {
"description": "A market participant can take on these roles",
"enum": [
"NB",
"LF",
"MSB",
"MSBA",
"GMSB",
"MDL",
"DL",
"BKV",
"BKO",
"UENB",
"KUNDE-SELBST-NN",
"MGV",
"EIV",
"RB",
"KUNDE",
"INTERESSENT",
"KN",
"UBA",
"BIKO",
"ESA"
],
"title": "Market role",
"type": "string"
},
"Mengeneinheit": {
"description": "Unit: measurands that can be determined by measurement or by specification",
"enum": [
"W",
"WH",
"KW",
"KWH",
"KVARH",
"MW",
"MWH",
"STUECK",
"KUBIKMETER",
"STUNDE",
"TAG",
"MONAT",
"JAHR",
"PROZENT",
"ANZAHL",
"VAR",
"KVAR",
"VARH",
"KWHK",
"Z16",
"KWT"
],
"title": "Unit of measurement",
"type": "string"
},
"NB_START_ZUORDNUNG_ERZ_MALO_TRANCHE": {
"properties": {
"stammdaten": {
"anyOf": [
{
"$ref": "#/components/schemas/PI_55607__stammdaten"
}
]
},
"transaktionsdaten": {
"properties": {
"absender": {
"properties": {
"rollencodenummer": {
"$ref": "#/components/schemas/rollencodenummer"
}
},
"type": "object"
},
"empfaenger": {
"properties": {
"rollencodenummer": {
"$ref": "#/components/schemas/rollencodenummer"
}
},
"type": "object"
},
"kategorie": {
"$ref": "#/components/schemas/kategorie"
},
"pruefidentifikator": {
"description": "Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 55607.",
"examples": [
"55607"
]
},
"sparte": {
"$ref": "#/components/schemas/sparte"
},
"transaktionsgrund": {
"$ref": "#/components/schemas/transaktionsgrund"
},
"transaktionsgrundergaenzung": {
"$ref": "#/components/schemas/transaktionsgrundergaenzung"
},
"transaktionsgrundergaenzungBefristeteAnmeldung": {
"$ref": "#/components/schemas/transaktionsgrundergaenzungBefristeteAnmeldung"
}
},
"required": [
"absender",
"empfaenger",
"kategorie",
"sparte",
"transaktionsgrund",
"transaktionsgrundergaenzung",
"transaktionsgrundergaenzungBefristeteAnmeldung"
],
"type": "object"
},
"zusatzdaten": {
"properties": {
"eventname": {
"const": "START_ZUORDNUNG_ERZ_MALO_TRANCHE",
"default": "START_ZUORDNUNG_ERZ_MALO_TRANCHE",
"type": "string"
},
"prozessId": {
"type": "string"
}
},
"required": [
"prozessId",
"eventname"
],
"type": "object"
}
},
"required": [
"stammdaten",
"transaktionsdaten",
"zusatzdaten"
],
"type": "object"
},
"PI_55607__stammdaten": {
"properties": {
"MARKTLOKATION": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__MARKTLOKATION"
},
"type": "array"
},
"MESSLOKATION": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__MESSLOKATION"
},
"type": "array"
},
"NETZLOKATION": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__NETZLOKATION"
},
"type": "array"
},
"NETZNUTZUNGSVERTRAG": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__NETZNUTZUNGSVERTRAG"
},
"type": "array"
},
"STEUERBARE_RESSOURCE": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__STEUERBARE_RESSOURCE"
},
"type": "array"
},
"TECHNISCHE_RESSOURCE": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__TECHNISCHE_RESSOURCE"
},
"type": "array"
},
"TRANCHE": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__TRANCHE"
},
"type": "array"
}
},
"required": [
"MARKTLOKATION",
"MESSLOKATION"
],
"type": "object",
"title": "55607"
},
"PI_55607__stammdaten__MARKTLOKATION": {
"properties": {
"energieherkunft": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__MARKTLOKATION__energieherkunft"
},
"type": "array"
},
"marktlokationsId": {
"$ref": "#/components/schemas/marktlokationsId",
"x-edifact-segment": [
"SG4.IDE+24.SG5.LOC+Z16"
]
},
"marktrollen": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__MARKTLOKATION__marktrollen"
},
"type": "array"
},
"statusErzeugendeMalo": {
"$ref": "#/components/schemas/statusErzeugendeMalo",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z98.SG10.CCI+Z22"
]
}
},
"required": [
"energieherkunft",
"marktlokationsId",
"marktrollen",
"statusErzeugendeMalo"
],
"type": "object"
},
"PI_55607__stammdaten__MARKTLOKATION__energieherkunft": {
"properties": {
"erzeugungsart": {
"$ref": "#/components/schemas/erzeugungsart",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z98.SG10.CCI+++Z34.CAV"
]
}
},
"required": [
"erzeugungsart"
],
"type": "object"
},
"PI_55607__stammdaten__MARKTLOKATION__marktrollen": {
"properties": {
"marktrolle": {
"$ref": "#/components/schemas/marktrolle",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z98.SG10.CCI+++ZB3.CAV+Z91"
]
},
"messstellenbetreiberEigenschaft": {
"$ref": "#/components/schemas/messstellenbetreiberEigenschaft",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z98.SG10.CCI+++ZB3.CAV+Z91"
]
},
"rollencodenummer": {
"$ref": "#/components/schemas/rollencodenummer",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z98.SG10.CCI+++ZB3.CAV+Z91"
]
},
"weiterverpflichtet": {
"$ref": "#/components/schemas/weiterverpflichtet",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z98.SG10.CCI+++ZB3.CAV+Z91"
]
}
},
"required": [
"messstellenbetreiberEigenschaft",
"rollencodenummer",
"weiterverpflichtet"
],
"type": "object"
},
"PI_55607__stammdaten__MESSLOKATION": {
"properties": {
"marktrollen": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__MESSLOKATION__marktrollen"
},
"type": "array"
},
"messlokationsId": {
"$ref": "#/components/schemas/messlokationsId",
"x-edifact-segment": [
"SG4.IDE+24.SG5.LOC+Z17",
"SG4.IDE+24.SG8.SEQ+ZF3.RFF+Z19"
]
}
},
"required": [
"messlokationsId"
],
"type": "object"
},
"PI_55607__stammdaten__MESSLOKATION__marktrollen": {
"properties": {
"marktrolle": {
"$ref": "#/components/schemas/marktrolle",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF3.SG10.CCI+++ZB3.CAV+Z91",
"SG4.IDE+24.SG8.SEQ+ZF3.SG10.CCI+++ZB3.CAV+ZF0"
]
},
"messstellenbetreiberEigenschaft": {
"$ref": "#/components/schemas/messstellenbetreiberEigenschaft",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF3.SG10.CCI+++ZB3.CAV+Z91"
]
},
"rollencodenummer": {
"$ref": "#/components/schemas/rollencodenummer",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF3.SG10.CCI+++ZB3.CAV+Z91",
"SG4.IDE+24.SG8.SEQ+ZF3.SG10.CCI+++ZB3.CAV+ZF0"
]
},
"weiterverpflichtet": {
"$ref": "#/components/schemas/weiterverpflichtet",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF3.SG10.CCI+++ZB3.CAV+Z91"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__NETZLOKATION": {
"properties": {
"marktrollen": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__NETZLOKATION__marktrollen"
},
"type": "array"
},
"netzlokationsId": {
"$ref": "#/components/schemas/netzlokationsId",
"x-edifact-segment": [
"SG4.IDE+24.SG5.LOC+Z18",
"SG4.IDE+24.SG8.SEQ+ZD7.RFF+Z32"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__NETZLOKATION__marktrollen": {
"properties": {
"marktrolle": {
"$ref": "#/components/schemas/marktrolle",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZD7.SG10.CCI+++ZB3.CAV+Z91"
]
},
"messstellenbetreiberEigenschaft": {
"$ref": "#/components/schemas/messstellenbetreiberEigenschaft",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZD7.SG10.CCI+++ZB3.CAV+Z91"
]
},
"rollencodenummer": {
"$ref": "#/components/schemas/rollencodenummer",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZD7.SG10.CCI+++ZB3.CAV+Z91"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__NETZNUTZUNGSVERTRAG": {
"properties": {
"vertragsbeginn": {
"$ref": "#/components/schemas/vertragsbeginn",
"x-edifact-segment": [
"SG4.IDE+24.DTM+92"
]
},
"vertragsende": {
"$ref": "#/components/schemas/vertragsende",
"x-edifact-segment": [
"SG4.IDE+24.DTM+93"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__STEUERBARE_RESSOURCE": {
"properties": {
"marktrollen": {
"items": {
"$ref": "#/components/schemas/PI_55607__stammdaten__STEUERBARE_RESSOURCE__marktrollen"
},
"type": "array"
},
"ressourcenId": {
"$ref": "#/components/schemas/ressourcenId",
"x-edifact-segment": [
"SG4.IDE+24.SG5.LOC+Z19",
"SG4.IDE+24.SG8.SEQ+ZF1.RFF+Z38"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__STEUERBARE_RESSOURCE__marktrollen": {
"properties": {
"marktrolle": {
"$ref": "#/components/schemas/marktrolle",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF1.SG10.CCI+++ZB3.CAV+Z91"
]
},
"messstellenbetreiberEigenschaft": {
"$ref": "#/components/schemas/messstellenbetreiberEigenschaft",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF1.SG10.CCI+++ZB3.CAV+Z91"
]
},
"rollencodenummer": {
"$ref": "#/components/schemas/rollencodenummer",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+ZF1.SG10.CCI+++ZB3.CAV+Z91"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__TECHNISCHE_RESSOURCE": {
"properties": {
"ressourcenId": {
"$ref": "#/components/schemas/ressourcenId",
"x-edifact-segment": [
"SG4.IDE+24.SG5.LOC+Z20"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__TRANCHE": {
"properties": {
"aufteilungsmenge": {
"$ref": "#/components/schemas/PI_55607__stammdaten__TRANCHE__aufteilungsmenge"
},
"bildungTranchengroesse": {
"$ref": "#/components/schemas/bildungTranchengroesse",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z15.SG10.CCI+Z37"
]
},
"tranchenId": {
"$ref": "#/components/schemas/tranchenId",
"x-edifact-segment": [
"SG4.IDE+24.SG5.LOC+Z21"
]
}
},
"type": "object"
},
"PI_55607__stammdaten__TRANCHE__aufteilungsmenge": {
"properties": {
"einheit": {
"$ref": "#/components/schemas/einheit",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z15.SG9.QTY+11"
]
},
"wert": {
"$ref": "#/components/schemas/wert",
"x-edifact-segment": [
"SG4.IDE+24.SG8.SEQ+Z15.SG9.QTY+11"
]
}
},
"type": "object"
},
"Sparte": {
"description": "Division",
"enum": [
"STROM",
"GAS",
"FERNWAERME",
"NAHWAERME",
"WASSER",
"ABWASSER"
],
"title": "Division",
"type": "string"
},
"StatusErzeugendeMarktlokation": {
"description": "Status of the generating market location",
"enum": [
"EINSPEISEVERGUETUNG_PARAGRAPH_37",
"GEFOERDERTE_DIREKTVERMARKTUNG",
"SONSTIGE_DIREKTVERMARKTUNG",
"VERMARKTUNG_OHNE_GESETZL_VERGUETUNG",
"KWKG_VERGUETUNG",
"EINSPEISEVERGUETUNG_PARAGRAPH_38_AUSFALLVERGUETUNG"
],
"title": "Status of the generating market location",
"type": "string"
},
"bildungTranchengroesse": {
"$ref": "#/components/schemas/BildungTranchengroesse"
},
"einheit": {
"$ref": "#/components/schemas/Mengeneinheit"
},
"erzeugungsart": {
"$ref": "#/components/schemas/Erzeugungsart",
"description": "Type of generation"
},
"event_response_fail": {
"description": "Error message on process data API call | Error message on process data API call",
"properties": {
"errorCode": {
"description": "Error identifier",
"example": "400",
"type": "string"
},
"message": {
"description": "Technical message | Technical message",
"example": "Validation Failed",
"type": "string"
}
},
"type": "object"
},
"event_responses_success": {
"description": "Success message on process data API call | Success message on process data API call",
"properties": {
"businessKey": {
"description": "Unique identifier of the business process | Unique identifier of the business process",
"format": "uuid",
"type": "string"
},
"message": {
"description": "Message with details about the triggered event | Message with details about the triggered event",
"example": "received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107",
"type": "string"
}
},
"required": [
"businessKey",
"message"
],
"type": "object"
},
"kategorie": {
"description": "Qualifier from the beginning of the EDIFACT message / BGM",
"type": "string"
},
"marktlokationsId": {
"description": "Identification number of a market location at which energy is either\nconsumed or generated",
"type": "string"
},
"marktrolle": {
"$ref": "#/components/schemas/Marktrolle",
"description": "Indicates the designation of the market role in free text."
},
"messlokationsId": {
"description": "The metering location identification. This is the former metering point identifier,\ne.g. DE 47108151234567",
"type": "string"
},
"messstellenbetreiberEigenschaft": {
"$ref": "#/components/schemas/MSBEigenschaft"
},
"netzlokationsId": {
"description": "Identification number of a grid location at which energy is either\nconsumed or generated (Like MarktlokationsId Marktlokation)",
"type": "string"
},
"ressourcenId": {
"description": "ressourcenId",
"type": "string"
},
"rollencodenummer": {
"description": "Specifies the code value of the market role.",
"type": "string"
},
"sparte": {
"$ref": "#/components/schemas/Sparte",
"description": "Contains information about the division"
},
"statusErzeugendeMalo": {
"$ref": "#/components/schemas/StatusErzeugendeMarktlokation"
},
"tranchenId": {
"description": "tranchenId",
"type": "string"
},
"transaktionsgrund": {
"description": "The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03",
"type": "string"
},
"transaktionsgrundergaenzung": {
"description": "Supplement to the transaction reason / UTILMD STS+7++E01+###+E03",
"type": "string"
},
"transaktionsgrundergaenzungBefristeteAnmeldung": {
"description": "Supplement to the transaction reason for temporary registrations/deregistrations / UTILMD STS+7++E01+ZW4+###",
"type": "string"
},
"vertragsbeginn": {
"description": "Specifies when the contract begins.",
"format": "date-time",
"type": "string"
},
"vertragsende": {
"description": "Contract end date / DTM+93",
"format": "date-time",
"type": "string"
},
"weiterverpflichtet": {
"description": "weiterverpflichtet",
"type": "boolean"
},
"wert": {
"description": "Value",
"format": "float",
"type": "number"
}
}
}
}