{
  "openapi": "3.1.0",
  "info": {
    "title": "START_MALOIDENT (LF)",
    "version": "202604",
    "description": "The event `START_MALOIDENT` of the market role LF as a standalone specification, derived from the trigger API of format version 202604. 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_MALOIDENT"
    }
  ],
  "paths": {
    "/inbound": {
      "post": {
        "deprecated": false,
        "description": "Trigger-Event **START_MALOIDENT** der Marktrolle LF.\n\n<a href=\"/apis/einzeln/202604/lf/START_MALOIDENT.json\" data-maco=\"einzelschema\" download target=\"_blank\">Schema nur dieses Ereignisses herunterladen</a> (OpenAPI, JSON).\n\n<Hinweisbereich>\n\nDer 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.\n\n</Hinweisbereich>",
        "operationId": "trigger_LF_START_MALOIDENT",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "examples": {
                "START_MALOIDENT": {
                  "$ref": "#/components/examples/START_MALOIDENT"
                }
              },
              "schema": {
                "$ref": "#/components/schemas/LF_START_MALOIDENT"
              }
            }
          }
        },
        "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_MALOIDENT (LF)",
        "tags": [
          "START_MALOIDENT"
        ],
        "x-actual-endpoint": "POST /inbound",
        "x-event-source": "event/202604/[LF]_START_MALOIDENT.yaml"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearer": {
        "scheme": "bearer",
        "type": "http"
      }
    },
    "schemas": {
      "LF_START_MALOIDENT": {
        "properties": {
          "transaktionsdaten": {
            "properties": {
              "absender": {
                "properties": {
                  "rollencodenummer": {
                    "$ref": "#/components/schemas/rollencodenummer"
                  }
                },
                "type": "object"
              },
              "ausfuehrungsdatum": {
                "$ref": "#/components/schemas/ausfuehrungsdatum"
              },
              "empfaenger": {
                "properties": {
                  "marktrolle": {
                    "$ref": "#/components/schemas/marktrolle"
                  },
                  "rollencodenummer": {
                    "$ref": "#/components/schemas/rollencodenummer"
                  }
                },
                "type": "object"
              },
              "pruefidentifikator": {
                "description": "Determined dynamically in the event process. A value supplied by the sender is ignored. Check identifiers possible in the topic — 3001.",
                "examples": [
                  "3001"
                ]
              }
            },
            "required": [
              "absender",
              "ausfuehrungsdatum",
              "empfaenger"
            ],
            "type": "object"
          },
          "zusatzdaten": {
            "properties": {
              "eventname": {
                "const": "START_MALOIDENT",
                "default": "START_MALOIDENT",
                "type": "string"
              },
              "prozessId": {
                "type": "string"
              }
            },
            "required": [
              "prozessId",
              "eventname"
            ],
            "type": "object"
          }
        },
        "required": [
          "stammdaten",
          "transaktionsdaten",
          "zusatzdaten"
        ],
        "type": "object",
        "x-pending-pruefis": [
          "3001"
        ]
      },
      "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"
      },
      "ausfuehrungsdatum": {
        "description": "The execution date describes at which point in time an order is to be executed.",
        "format": "date-time",
        "type": "string"
      },
      "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"
      },
      "marktrolle": {
        "$ref": "#/components/schemas/Marktrolle",
        "description": "Indicates the designation of the market role in free text."
      },
      "rollencodenummer": {
        "description": "Specifies the code value of the market role.",
        "type": "string"
      }
    },
    "examples": {
      "START_MALOIDENT": {
        "summary": "START_MALOIDENT - sending of a MaloIdent request (LF)",
        "value": {
          "stammdaten": {
            "ENERGIELIEFERVERTRAG": [
              {
                "boTyp": "VERTRAG",
                "versionStruktur": "1",
                "vertragsart": "ENERGIELIEFERVERTRAG",
                "vertragspartner2": [
                  {
                    "anrede": "Prof.Dr.",
                    "boTyp": "GESCHAEFTSPARTNER",
                    "externeReferenzen": [
                      {
                        "exRefName": "V567345345",
                        "exRefWert": "V567345345"
                      }
                    ],
                    "geschaeftspartnerrolle": [
                      "KUNDE"
                    ],
                    "gewerbekennzeichnung": false,
                    "name1": "Becker",
                    "name2": "Michael",
                    "versionStruktur": "1"
                  }
                ]
              }
            ],
            "MARKTLOKATION": [
              {
                "boTyp": "MARKTLOKATION",
                "energierichtung": "AUSSP",
                "geokoordinaten": {
                  "breitengrad": "52.5200",
                  "hochwert": "1234567",
                  "laengengrad": "13.4050",
                  "nordwert": "654321",
                  "ostwert": "123456",
                  "rechtswert": "7654321",
                  "zone": "UTMZone31"
                },
                "katasterinformation": {
                  "flurstueck": "123",
                  "flurstueckNummer": "456",
                  "gemarkung_flur": "Musterstadt"
                },
                "lokationsadresse": {
                  "adresszusatz": "Ausbau",
                  "hausnummer": "32",
                  "landescode": "DE",
                  "ort": "Berlin",
                  "postleitzahl": "12117",
                  "strasse": "Reinhardtstraße"
                },
                "marktlokationsId": "57685676748",
                "versionStruktur": "1"
              }
            ],
            "MESSLOKATION": [
              {
                "boTyp": "MESSLOKATION",
                "messlokationsId": "DE00014545768S0000000000000003054",
                "versionStruktur": "1"
              }
            ],
            "TRANCHE": [
              {
                "boTyp": "TRANCHE",
                "tranchenId": "57685676742",
                "versionStruktur": "1"
              }
            ],
            "ZAEHLER": [
              {
                "boTyp": "ZAEHLER",
                "versionStruktur": "1",
                "zaehlernummer": "1SM-8465929523"
              }
            ]
          },
          "transaktionsdaten": {
            "absender": {
              "rollencodenummer": "9904000000005"
            },
            "ausfuehrungsdatum": "2023-08-02T22:00:00Z",
            "empfaenger": {
              "rollencodenummer": "9900936000002"
            }
          },
          "zusatzdaten": {
            "eventname": "START_MALOIDENT",
            "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
          }
        }
      }
    }
  }
}