Contract termination

START_KUENDIGUNG (LF)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (2):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionsStruktur": "1",
        "vertragspartner2": {
          "boTyp": "GESCHAEFTSPARTNER",
          "externeReferenzen": {
            "exRefName": "Kundennummer beim Altlieferanten",
            "exRefWert": "123456789"
          },
          "geschaeftspartnerrolle": "KUNDE",
          "name1": "Muster",
          "name2": "Mann",
          "versionStruktur": "1"
        }
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "lokationsadresse": {
          "hausnummer": "5",
          "landescode": "DE",
          "ort": "Gera",
          "postleitzahl": "07549",
          "strasse": "Musterstraße"
        },
        "marktlokationsId": "50754496000",
        "sparte": "GAS",
        "versionStruktur": "1"
      }
    ],
    "ZAEHLER": [
      {
        "boTyp": "ZAEHLER",
        "versionStruktur": "1",
        "zaehlernummer": "7AMX1706001745"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9803526000002",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9800683000008",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "endezumtermin": "2025-04-30T23:00:00Z",
    "kategorie": "E35",
    "sparte": "GAS",
    "transaktionsgrund": "E03"
  },
  "zusatzdaten": {
    "eventname": "START_KUENDIGUNG",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}'

START_KUENDIGUNG (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	44016	55016
stammdaten*	—	object	Muss	Muss
ENERGIELIEFERVERTRAG[ ]	—	object[]	Kann
vertragspartner2[ ]	—	object[]	Kann
`anrede`00010	The form of address for the GePa, e.g. Mr.	string	Kann
`gewerbekennzeichnung`00020	Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false)	boolean	Kann
`name1`00030	First part of the name. Here the company name or, for private individuals, for example the surname can be entered. Examples: Yellow Strom GmbH or Hagen	string	Kann
`name2`00040	Second part of the name. This can hold an extension to the company name or, for private individuals, the first name, for example. Examples: South region or Nina	string	Kann
`name3`00050	Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer	string	Kann
`name4`00060	name4	string	Kann
externeReferenzen[ ]	—	object[]	Kann
`exRefName`00070	Name of the external reference (e.g. "hochfrequenz integration services")	string	Kann
`Kundennummer beim Lieferanten`			Kann
`Kundennummer beim Altlieferanten`			Kann
`exRefWert`00080	Value of the external reference (e.g. "123456"; "4711")	string	Kann
MARKTLOKATION[ ]*	—	object[]	Muss	Muss
`marktlokationsId`00090	Identification number of a market location at which energy is either consumed or generated	string	Kann	Kann
`sparte`*00100	Contains information about the division	string	Muss	Muss
`STROM`			Muss	Muss
`GAS`			Muss	Muss
`FERNWAERME`			Muss	Muss
`NAHWAERME`			Muss	Muss
`WASSER`			Muss	Muss
`ABWASSER`			Muss	Muss
lokationsadresse	—	object	Kann
`hausnummer`00110	House number and supplement	string	Kann
`landescode`00120	Country code	string	Kann
`AC`			Kann
`AD`			Kann
`AE`			Kann
`AF`			Kann
`AG`			Kann
`AI`			Kann
`AL`			Kann
`AM`			Kann
`AN`			Kann
`AO`			Kann
`AQ`			Kann
`AR`			Kann
`AS`			Kann
`AT`			Kann
`AU`			Kann
`AW`			Kann
`AX`			Kann
`AZ`			Kann
`BA`			Kann
`BB`			Kann
`BD`			Kann
`BE`			Kann
`BF`			Kann
`BG`			Kann
`BH`			Kann
`BI`			Kann
`BJ`			Kann
`BL`			Kann
`BM`			Kann
`BN`			Kann
`BO`			Kann
`BQ`			Kann
`BR`			Kann
`BS`			Kann
`BT`			Kann
`BU`			Kann
`BV`			Kann
`BW`			Kann
`BY`			Kann
`BZ`			Kann
`CA`			Kann
`CC`			Kann
`CD`			Kann
`CF`			Kann
`CG`			Kann
`CH`			Kann
`CI`			Kann
`CK`			Kann
`CL`			Kann
`CM`			Kann
`CN`			Kann
`CO`			Kann
`CP`			Kann
`CR`			Kann
`CS`			Kann
`CU`			Kann
`CV`			Kann
`CW`			Kann
`CX`			Kann
`CY`			Kann
`CZ`			Kann
`DE`			Kann
`DG`			Kann
`DJ`			Kann
`DK`			Kann
`DM`			Kann
`DO`			Kann
`DZ`			Kann
`EA`			Kann
`EC`			Kann
`EE`			Kann
`EG`			Kann
`EH`			Kann
`ER`			Kann
`ES`			Kann
`ET`			Kann
`EU`			Kann
`FI`			Kann
`FJ`			Kann
`FK`			Kann
`FM`			Kann
`FO`			Kann
`FR`			Kann
`FX`			Kann
`GA`			Kann
`GB`			Kann
`GD`			Kann
`GE`			Kann
`GF`			Kann
`GG`			Kann
`GH`			Kann
`GI`			Kann
`GL`			Kann
`GM`			Kann
`GN`			Kann
`GP`			Kann
`GQ`			Kann
`GR`			Kann
`GS`			Kann
`GT`			Kann
`GU`			Kann
`GW`			Kann
`GY`			Kann
`HK`			Kann
`HM`			Kann
`HN`			Kann
`HR`			Kann
`HT`			Kann
`HU`			Kann
`IC`			Kann
`ID`			Kann
`IE`			Kann
`IL`			Kann
`IM`			Kann
`IN`			Kann
`IO`			Kann
`IQ`			Kann
`IR`			Kann
`IS`			Kann
`IT`			Kann
`JE`			Kann
`JM`			Kann
`JO`			Kann
`JP`			Kann
`KE`			Kann
`KG`			Kann
`KH`			Kann
`KI`			Kann
`KM`			Kann
`KN`			Kann
`KP`			Kann
`KR`			Kann
`KW`			Kann
`KY`			Kann
`KZ`			Kann
`LA`			Kann
`LB`			Kann
`LC`			Kann
`LI`			Kann
`LK`			Kann
`LR`			Kann
`LS`			Kann
`LT`			Kann
`LU`			Kann
`LV`			Kann
`LY`			Kann
`MA`			Kann
`MC`			Kann
`MD`			Kann
`ME`			Kann
`MF`			Kann
`MG`			Kann
`MH`			Kann
`MK`			Kann
`ML`			Kann
`MM`			Kann
`MN`			Kann
`MO`			Kann
`MP`			Kann
`MQ`			Kann
`MR`			Kann
`MS`			Kann
`MT`			Kann
`MU`			Kann
`MV`			Kann
`MW`			Kann
`MX`			Kann
`MY`			Kann
`MZ`			Kann
`NA`			Kann
`NC`			Kann
`NE`			Kann
`NF`			Kann
`NG`			Kann
`NI`			Kann
`NL`			Kann
`NO`			Kann
`NP`			Kann
`NR`			Kann
`NT`			Kann
`NU`			Kann
`NZ`			Kann
`OM`			Kann
`PA`			Kann
`PE`			Kann
`PF`			Kann
`PG`			Kann
`PH`			Kann
`PK`			Kann
`PL`			Kann
`PM`			Kann
`PN`			Kann
`PR`			Kann
`PS`			Kann
`PT`			Kann
`PW`			Kann
`PY`			Kann
`QA`			Kann
`RE`			Kann
`RO`			Kann
`RS`			Kann
`RU`			Kann
`RW`			Kann
`SA`			Kann
`SB`			Kann
`SC`			Kann
`SD`			Kann
`SE`			Kann
`SF`			Kann
`SG`			Kann
`SH`			Kann
`SI`			Kann
`SJ`			Kann
`SK`			Kann
`SL`			Kann
`SM`			Kann
`SN`			Kann
`SO`			Kann
`SR`			Kann
`SS`			Kann
`ST`			Kann
`SU`			Kann
`SV`			Kann
`SX`			Kann
`SY`			Kann
`SZ`			Kann
`TA`			Kann
`TC`			Kann
`TD`			Kann
`TF`			Kann
`TG`			Kann
`TJ`			Kann
`TK`			Kann
`TL`			Kann
`TM`			Kann
`TN`			Kann
`TO`			Kann
`TP`			Kann
`TR`			Kann
`TT`			Kann
`TV`			Kann
`TW`			Kann
`TZ`			Kann
`UA`			Kann
`UG`			Kann
`UK`			Kann
`UM`			Kann
`US`			Kann
`UY`			Kann
`UZ`			Kann
`VA`			Kann
`VC`			Kann
`VE`			Kann
`VG`			Kann
`VI`			Kann
`VN`			Kann
`VU`			Kann
`WF`			Kann
`WS`			Kann
`XK`			Kann
`YE`			Kann
`YT`			Kann
`YU`			Kann
`ZA`			Kann
`ZM`			Kann
`ZR`			Kann
`ZW`			Kann
`ort`00130	City	string	Kann
`ortsteil`00140	District	string	Kann
`postfach`00150	PO box	string	Kann
`postleitzahl`00160	Postal code	string	Kann
`strasse`00170	Street	string	Kann
zusatzInformation	—	object	Kann
`zusatz1`00180	Address supplement 1	string	Kann
`zusatz2`00190	Address supplement 2	string	Kann
`zusatz3`00200	Address supplement 3	string	Kann
`zusatz4`00210	Address supplement 4	string	Kann
`zusatz5`00220	Address supplement 5	string	Kann
MESSLOKATION[ ]	—	object[]	Kann
`messlokationsId`00230	The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567	string	Kann
NETZNUTZUNGSVERTRAG[ ]	—	object[]	Kann	Kann
`vertragsende`00240	Contract end date / DTM+93	string (date-time)	Kann	Kann
ZAEHLER[ ]	—	object[]	Kann
`zaehlernummer`00250	Numbering of the meter, assigned by the metering point operator	string	Kann
TRANCHE[ ]	—	object[]		Kann
`tranchenId`00260	tranchenId	string		Kann
transaktionsdaten*	—	object	Muss	Muss
`kategorie`*00270	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss	Muss
`pruefidentifikator`00280	Determined dynamically in the event process (basis for the decision: sparte). A value supplied by the sender is ignored. Check identifiers possible in the topic — 44016, 55016.	—	Kann	Kann
`transaktionsgrund`*00290	The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03	string	Muss	Muss
absender*	—	object	Muss	Muss
`rollencodenummer`00300	Specifies the code value of the market role.	string	Kann	Kann
empfaenger*	—	object	Muss	Muss
`marktrolle`00310	Indicates the designation of the market role in free text.	string	Kann	Kann
`NB`			Kann	Kann
`LF`			Kann	Kann
`MSB`			Kann	Kann
`MSBA`			Kann	Kann
`GMSB`			Kann	Kann
`MDL`			Kann	Kann
`DL`			Kann	Kann
`BKV`			Kann	Kann
`BKO`			Kann	Kann
`UENB`			Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann
`MGV`			Kann	Kann
`EIV`			Kann	Kann
`RB`			Kann	Kann
`KUNDE`			Kann	Kann
`INTERESSENT`			Kann	Kann
`KN`			Kann	Kann
`UBA`			Kann	Kann
`BIKO`			Kann	Kann
`ESA`			Kann	Kann
`rollencodenummer`00320	Specifies the code value of the market role.	string	Kann	Kann
zusatzdaten*	—	object	Muss	Muss
`eventname`*00330	—	string	Muss	Muss
`prozessId`*00340	—	string	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionsStruktur": "1",
        "vertragspartner2": {
          "boTyp": "GESCHAEFTSPARTNER",
          "externeReferenzen": {
            "exRefName": "Kundennummer beim Altlieferanten",
            "exRefWert": "123456789"
          },
          "geschaeftspartnerrolle": "KUNDE",
          "name1": "Muster",
          "name2": "Mann",
          "versionStruktur": "1"
        }
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "lokationsadresse": {
          "hausnummer": "5",
          "landescode": "DE",
          "ort": "Gera",
          "postleitzahl": "07549",
          "strasse": "Musterstraße"
        },
        "marktlokationsId": "50754496000",
        "sparte": "GAS",
        "versionStruktur": "1"
      }
    ],
    "ZAEHLER": [
      {
        "boTyp": "ZAEHLER",
        "versionStruktur": "1",
        "zaehlernummer": "7AMX1706001745"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9803526000002",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9800683000008",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "endezumtermin": "2025-04-30T23:00:00Z",
    "kategorie": "E35",
    "sparte": "GAS",
    "transaktionsgrund": "E03"
  },
  "zusatzdaten": {
    "eventname": "START_KUENDIGUNG",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}

json

application/json

START_KUENDIGUNG (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_KUENDIGUNG 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 104 Rumpfvarianten heraus, damit sie einzeln lesbar und ausprobierbar sind.

Business data request, …Start of supply, creation

START_KUENDIGUNG (LF)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (2):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionsStruktur": "1",
        "vertragspartner2": {
          "boTyp": "GESCHAEFTSPARTNER",
          "externeReferenzen": {
            "exRefName": "Kundennummer beim Altlieferanten",
            "exRefWert": "123456789"
          },
          "geschaeftspartnerrolle": "KUNDE",
          "name1": "Muster",
          "name2": "Mann",
          "versionStruktur": "1"
        }
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "lokationsadresse": {
          "hausnummer": "5",
          "landescode": "DE",
          "ort": "Gera",
          "postleitzahl": "07549",
          "strasse": "Musterstraße"
        },
        "marktlokationsId": "50754496000",
        "sparte": "GAS",
        "versionStruktur": "1"
      }
    ],
    "ZAEHLER": [
      {
        "boTyp": "ZAEHLER",
        "versionStruktur": "1",
        "zaehlernummer": "7AMX1706001745"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9803526000002",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9800683000008",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "endezumtermin": "2025-04-30T23:00:00Z",
    "kategorie": "E35",
    "sparte": "GAS",
    "transaktionsgrund": "E03"
  },
  "zusatzdaten": {
    "eventname": "START_KUENDIGUNG",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}'

START_KUENDIGUNG (LF) › Request Body

Structure (BO4E)	Description	Format	44016	55016
stammdaten*	—	object	Muss	Muss
ENERGIELIEFERVERTRAG[ ]	—	object[]	Kann
vertragspartner2[ ]	—	object[]	Kann
`anrede`00010	The form of address for the GePa, e.g. Mr.	string	Kann
`gewerbekennzeichnung`00020	Indicates whether this is a commercial business/company (gewerbeKennzeichnung = true) or a private individual. (gewerbeKennzeichnung = false)	boolean	Kann
`name1`00030	First part of the name. Here the company name or, for private individuals, for example the surname can be entered. Examples: Yellow Strom GmbH or Hagen	string	Kann
`name2`00040	Second part of the name. This can hold an extension to the company name or, for private individuals, the first name, for example. Examples: South region or Nina	string	Kann
`name3`00050	Third part of the name. Here further additions to the company name or, for private individuals, additions to the name can be shown. Examples: and Africa or singer	string	Kann
`name4`00060	name4	string	Kann
externeReferenzen[ ]	—	object[]	Kann
`exRefName`00070	Name of the external reference (e.g. "hochfrequenz integration services")	string	Kann
`Kundennummer beim Lieferanten`			Kann
`Kundennummer beim Altlieferanten`			Kann
`exRefWert`00080	Value of the external reference (e.g. "123456"; "4711")	string	Kann
MARKTLOKATION[ ]*	—	object[]	Muss	Muss
`marktlokationsId`00090	Identification number of a market location at which energy is either consumed or generated	string	Kann	Kann
`sparte`*00100	Contains information about the division	string	Muss	Muss
`STROM`			Muss	Muss
`GAS`			Muss	Muss
`FERNWAERME`			Muss	Muss
`NAHWAERME`			Muss	Muss
`WASSER`			Muss	Muss
`ABWASSER`			Muss	Muss
lokationsadresse	—	object	Kann
`hausnummer`00110	House number and supplement	string	Kann
`landescode`00120	Country code	string	Kann
`AC`			Kann
`AD`			Kann
`AE`			Kann
`AF`			Kann
`AG`			Kann
`AI`			Kann
`AL`			Kann
`AM`			Kann
`AN`			Kann
`AO`			Kann
`AQ`			Kann
`AR`			Kann
`AS`			Kann
`AT`			Kann
`AU`			Kann
`AW`			Kann
`AX`			Kann
`AZ`			Kann
`BA`			Kann
`BB`			Kann
`BD`			Kann
`BE`			Kann
`BF`			Kann
`BG`			Kann
`BH`			Kann
`BI`			Kann
`BJ`			Kann
`BL`			Kann
`BM`			Kann
`BN`			Kann
`BO`			Kann
`BQ`			Kann
`BR`			Kann
`BS`			Kann
`BT`			Kann
`BU`			Kann
`BV`			Kann
`BW`			Kann
`BY`			Kann
`BZ`			Kann
`CA`			Kann
`CC`			Kann
`CD`			Kann
`CF`			Kann
`CG`			Kann
`CH`			Kann
`CI`			Kann
`CK`			Kann
`CL`			Kann
`CM`			Kann
`CN`			Kann
`CO`			Kann
`CP`			Kann
`CR`			Kann
`CS`			Kann
`CU`			Kann
`CV`			Kann
`CW`			Kann
`CX`			Kann
`CY`			Kann
`CZ`			Kann
`DE`			Kann
`DG`			Kann
`DJ`			Kann
`DK`			Kann
`DM`			Kann
`DO`			Kann
`DZ`			Kann
`EA`			Kann
`EC`			Kann
`EE`			Kann
`EG`			Kann
`EH`			Kann
`ER`			Kann
`ES`			Kann
`ET`			Kann
`EU`			Kann
`FI`			Kann
`FJ`			Kann
`FK`			Kann
`FM`			Kann
`FO`			Kann
`FR`			Kann
`FX`			Kann
`GA`			Kann
`GB`			Kann
`GD`			Kann
`GE`			Kann
`GF`			Kann
`GG`			Kann
`GH`			Kann
`GI`			Kann
`GL`			Kann
`GM`			Kann
`GN`			Kann
`GP`			Kann
`GQ`			Kann
`GR`			Kann
`GS`			Kann
`GT`			Kann
`GU`			Kann
`GW`			Kann
`GY`			Kann
`HK`			Kann
`HM`			Kann
`HN`			Kann
`HR`			Kann
`HT`			Kann
`HU`			Kann
`IC`			Kann
`ID`			Kann
`IE`			Kann
`IL`			Kann
`IM`			Kann
`IN`			Kann
`IO`			Kann
`IQ`			Kann
`IR`			Kann
`IS`			Kann
`IT`			Kann
`JE`			Kann
`JM`			Kann
`JO`			Kann
`JP`			Kann
`KE`			Kann
`KG`			Kann
`KH`			Kann
`KI`			Kann
`KM`			Kann
`KN`			Kann
`KP`			Kann
`KR`			Kann
`KW`			Kann
`KY`			Kann
`KZ`			Kann
`LA`			Kann
`LB`			Kann
`LC`			Kann
`LI`			Kann
`LK`			Kann
`LR`			Kann
`LS`			Kann
`LT`			Kann
`LU`			Kann
`LV`			Kann
`LY`			Kann
`MA`			Kann
`MC`			Kann
`MD`			Kann
`ME`			Kann
`MF`			Kann
`MG`			Kann
`MH`			Kann
`MK`			Kann
`ML`			Kann
`MM`			Kann
`MN`			Kann
`MO`			Kann
`MP`			Kann
`MQ`			Kann
`MR`			Kann
`MS`			Kann
`MT`			Kann
`MU`			Kann
`MV`			Kann
`MW`			Kann
`MX`			Kann
`MY`			Kann
`MZ`			Kann
`NA`			Kann
`NC`			Kann
`NE`			Kann
`NF`			Kann
`NG`			Kann
`NI`			Kann
`NL`			Kann
`NO`			Kann
`NP`			Kann
`NR`			Kann
`NT`			Kann
`NU`			Kann
`NZ`			Kann
`OM`			Kann
`PA`			Kann
`PE`			Kann
`PF`			Kann
`PG`			Kann
`PH`			Kann
`PK`			Kann
`PL`			Kann
`PM`			Kann
`PN`			Kann
`PR`			Kann
`PS`			Kann
`PT`			Kann
`PW`			Kann
`PY`			Kann
`QA`			Kann
`RE`			Kann
`RO`			Kann
`RS`			Kann
`RU`			Kann
`RW`			Kann
`SA`			Kann
`SB`			Kann
`SC`			Kann
`SD`			Kann
`SE`			Kann
`SF`			Kann
`SG`			Kann
`SH`			Kann
`SI`			Kann
`SJ`			Kann
`SK`			Kann
`SL`			Kann
`SM`			Kann
`SN`			Kann
`SO`			Kann
`SR`			Kann
`SS`			Kann
`ST`			Kann
`SU`			Kann
`SV`			Kann
`SX`			Kann
`SY`			Kann
`SZ`			Kann
`TA`			Kann
`TC`			Kann
`TD`			Kann
`TF`			Kann
`TG`			Kann
`TJ`			Kann
`TK`			Kann
`TL`			Kann
`TM`			Kann
`TN`			Kann
`TO`			Kann
`TP`			Kann
`TR`			Kann
`TT`			Kann
`TV`			Kann
`TW`			Kann
`TZ`			Kann
`UA`			Kann
`UG`			Kann
`UK`			Kann
`UM`			Kann
`US`			Kann
`UY`			Kann
`UZ`			Kann
`VA`			Kann
`VC`			Kann
`VE`			Kann
`VG`			Kann
`VI`			Kann
`VN`			Kann
`VU`			Kann
`WF`			Kann
`WS`			Kann
`XK`			Kann
`YE`			Kann
`YT`			Kann
`YU`			Kann
`ZA`			Kann
`ZM`			Kann
`ZR`			Kann
`ZW`			Kann
`ort`00130	City	string	Kann
`ortsteil`00140	District	string	Kann
`postfach`00150	PO box	string	Kann
`postleitzahl`00160	Postal code	string	Kann
`strasse`00170	Street	string	Kann
zusatzInformation	—	object	Kann
`zusatz1`00180	Address supplement 1	string	Kann
`zusatz2`00190	Address supplement 2	string	Kann
`zusatz3`00200	Address supplement 3	string	Kann
`zusatz4`00210	Address supplement 4	string	Kann
`zusatz5`00220	Address supplement 5	string	Kann
MESSLOKATION[ ]	—	object[]	Kann
`messlokationsId`00230	The metering location identification. This is the former metering point identifier, e.g. DE 47108151234567	string	Kann
NETZNUTZUNGSVERTRAG[ ]	—	object[]	Kann	Kann
`vertragsende`00240	Contract end date / DTM+93	string (date-time)	Kann	Kann
ZAEHLER[ ]	—	object[]	Kann
`zaehlernummer`00250	Numbering of the meter, assigned by the metering point operator	string	Kann
TRANCHE[ ]	—	object[]		Kann
`tranchenId`00260	tranchenId	string		Kann
transaktionsdaten*	—	object	Muss	Muss
`kategorie`*00270	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss	Muss
`pruefidentifikator`00280	Determined dynamically in the event process (basis for the decision: sparte). A value supplied by the sender is ignored. Check identifiers possible in the topic — 44016, 55016.	—	Kann	Kann
`transaktionsgrund`*00290	The transaction reason describes the business transaction for the category in more detail / UTILMD STS+7++###+ZW4+E03	string	Muss	Muss
absender*	—	object	Muss	Muss
`rollencodenummer`00300	Specifies the code value of the market role.	string	Kann	Kann
empfaenger*	—	object	Muss	Muss
`marktrolle`00310	Indicates the designation of the market role in free text.	string	Kann	Kann
`NB`			Kann	Kann
`LF`			Kann	Kann
`MSB`			Kann	Kann
`MSBA`			Kann	Kann
`GMSB`			Kann	Kann
`MDL`			Kann	Kann
`DL`			Kann	Kann
`BKV`			Kann	Kann
`BKO`			Kann	Kann
`UENB`			Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann
`MGV`			Kann	Kann
`EIV`			Kann	Kann
`RB`			Kann	Kann
`KUNDE`			Kann	Kann
`INTERESSENT`			Kann	Kann
`KN`			Kann	Kann
`UBA`			Kann	Kann
`BIKO`			Kann	Kann
`ESA`			Kann	Kann
`rollencodenummer`00320	Specifies the code value of the market role.	string	Kann	Kann
zusatzdaten*	—	object	Muss	Muss
`eventname`*00330	—	string	Muss	Muss
`prozessId`*00340	—	string	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "ENERGIELIEFERVERTRAG": [
      {
        "boTyp": "VERTRAG",
        "versionsStruktur": "1",
        "vertragspartner2": {
          "boTyp": "GESCHAEFTSPARTNER",
          "externeReferenzen": {
            "exRefName": "Kundennummer beim Altlieferanten",
            "exRefWert": "123456789"
          },
          "geschaeftspartnerrolle": "KUNDE",
          "name1": "Muster",
          "name2": "Mann",
          "versionStruktur": "1"
        }
      }
    ],
    "MARKTLOKATION": [
      {
        "boTyp": "MARKTLOKATION",
        "lokationsadresse": {
          "hausnummer": "5",
          "landescode": "DE",
          "ort": "Gera",
          "postleitzahl": "07549",
          "strasse": "Musterstraße"
        },
        "marktlokationsId": "50754496000",
        "sparte": "GAS",
        "versionStruktur": "1"
      }
    ],
    "ZAEHLER": [
      {
        "boTyp": "ZAEHLER",
        "versionStruktur": "1",
        "zaehlernummer": "7AMX1706001745"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9803526000002",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "empfaenger": {
      "boTyp": "MARKTTEILNEHMER",
      "rollencodenummer": "9800683000008",
      "rollencodetyp": "DVGW",
      "versionStruktur": "1"
    },
    "endezumtermin": "2025-04-30T23:00:00Z",
    "kategorie": "E35",
    "sparte": "GAS",
    "transaktionsgrund": "E03"
  },
  "zusatzdaten": {
    "eventname": "START_KUENDIGUNG",
    "prozessId": "00505688-E4A2-1EDF-A0C2-C81842E2515E"
  }
}

json

application/json

START_KUENDIGUNG (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_KUENDIGUNG der Marktrolle LF.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Feedback on the documentation

Feedback on the documentation

Contract termination

START_KUENDIGUNG (LF)

START_KUENDIGUNG (LF) › Request Body

START_KUENDIGUNG (LF) › Responses

Contract termination

START_KUENDIGUNG (LF)

START_KUENDIGUNG (LF) › Request Body

START_KUENDIGUNG (LF) › Responses