GeLi_Gas 2.0 Kap. 1.6.1 Bestandslisten

START_VERSAND_BESTANDSLISTE_GAS (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

GeLi_Gas 2.0 Kap. 1.6.1 Bestandslisten — NB

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "bilanzierungsbeginn": "2024-08-25T15:00:00Z",
        "bilanzierungsende": "2024-08-25T15:00:00Z",
        "bilanzkreise": [
          {
            "bezeichnung": "bezeichnung"
          }
        ],
        "fallgruppenzuordnung": "GABI_RLMmT",
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "kundenwert": {
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "herausgeber": "herausgeber",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE"
      }
    ],
    "ENERGIELIEFERVERTRAG": [
      {
        "vertragspartner2": [
          {
            "anrede": "anrede",
            "gewerbekennzeichnung": true,
            "name1": "name1",
            "name2": "name2",
            "name3": "name3",
            "name4": "name4"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "lokationsadresse": {
          "hausnummer": "hausnummer",
          "landescode": "AC",
          "ort": "ort",
          "ortsteil": "ortsteil",
          "postfach": "postfach",
          "postleitzahl": "postleitzahl",
          "strasse": "strasse",
          "zusatzInformation": {
            "zusatz1": "zusatz1",
            "zusatz2": "zusatz2",
            "zusatz3": "zusatz3",
            "zusatz4": "zusatz4",
            "zusatz5": "zusatz5"
          }
        },
        "marktlokationsId": "marktlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true,
          "netznutzungsvertrag": "KUNDEN_NB",
          "netznutzungszahler": "KUNDE"
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "gueltigAb": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "44019",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_BESTANDSLISTE",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_BESTANDSLISTE_GAS (NB) › Request Body

Der Rumpf dieses Aufrufs — eine Spalte je zulässigem Prüfidentifikator. Ein Wert in der Spalte heißt, dass das Feld zu diesem Prüfidentifikator gehört: Muss, wenn das Schema es verlangt, sonst Kann.

Struktur (BO4E)	Beschreibung	Format	44019
stammdaten*	—	object	Muss
BILANZIERUNG[ ]*	—	object[]	Muss
`bilanzierungsbeginn`00010	Inklusiver Start der Bilanzierung	string (date-time)	Kann
`bilanzierungsende`00020	Exklusives Ende der Bilanzierung	string (date-time)	Kann
`fallgruppenzuordnung`00030	Fallgruppenzuordnung (für gas RLM)	string	Kann
`GABI_RLMmT`			Kann
`GABI_RLMoT`			Kann
`GABI_RLMNEV`			Kann
`prognosegrundlage`*00040	Prognosegrundlage	string	Muss
`WERTE`			Muss
`PROFILE`			Muss
bilanzkreise[ ]*	—	object[]	Muss
`bezeichnung`*00050	Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.	string	Muss
jahresverbrauchsprognose	—	object	Kann
`einheit`00060	Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können	string	Kann
`W`			Kann
`WH`			Kann
`KW`			Kann
`KWH`			Kann
`KVARH`			Kann
`MW`			Kann
`MWH`			Kann
`STUECK`			Kann
`KUBIKMETER`			Kann
`STUNDE`			Kann
`TAG`			Kann
`MONAT`			Kann
`JAHR`			Kann
`PROZENT`			Kann
`ANZAHL`			Kann
`VAR`			Kann
`KVAR`			Kann
`VARH`			Kann
`KWHK`			Kann
`Z16`			Kann
`KWT`			Kann
`wert`00070	Wert	number (float)	Kann
kundenwert	—	object	Kann
`wert`00080	Wert	number (float)	Kann
lastprofile[ ]	—	object[]	Kann
`bezeichnung`00090	Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.	string	Kann
`herausgeber`00100	Herausgeber des Lastprofils	string	Kann
`verfahren`00110	Profilverfahren	string	Kann
`SYNTHETISCH`			Kann
`ANALYTISCH`			Kann
tagesparameter	—	object	Kann
`dienstanbieter`00120	dienstanbieter	string	Kann
`herausgeber`00130	Herausgeber des Lastprofils	string	Kann
`klimazone`00140	klimazone	string	Kann
`temperaturmessstelle`00150	temperaturmessstelle	string	Kann
ENERGIELIEFERVERTRAG[ ]	—	object[]	Kann
vertragspartner2[ ]	—	object[]	Kann
`anrede`00160	Die Anrede für den GePa, Z.B. Herr.	string	Kann
`gewerbekennzeichnung`00170	Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true) oder eine Privatperson handelt. (gewerbeKennzeichnung = false)	boolean	Kann
`name1`00180	Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH oder Hagen	string	Kann
`name2`00190	Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele: Bereich Süd oder Nina	string	Kann
`name3`00200	Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika oder Sängerin	string	Kann
`name4`00210	name4	string	Kann
MARKTLOKATION[ ]*	—	object[]	Muss
`marktlokationsId`*00220	Identifikationsnummer einer Marktlokation, an der Energie entweder verbraucht, oder erzeugt wird	string	Muss
lokationsadresse	—	object	Kann
`hausnummer`00230	Hausnummer und Ergänzung	string	Kann
`landescode`00240	Landescode	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`00250	Ort	string	Kann
`ortsteil`00260	Ortsteil	string	Kann
`postfach`00270	Postfach	string	Kann
`postleitzahl`00280	Postleitzahl	string	Kann
`strasse`00290	Strasse	string	Kann
zusatzInformation	—	object	Kann
`zusatz1`00300	Adresszusatz 1	string	Kann
`zusatz2`00310	Adresszusatz 2	string	Kann
`zusatz3`00320	Adresszusatz 3	string	Kann
`zusatz4`00330	Adresszusatz 4	string	Kann
`zusatz5`00340	Adresszusatz 5	string	Kann
NETZNUTZUNGSVERTRAG[ ]*	—	object[]	Muss
`vertragsbeginn`00350	Gibt an, wann der Vertrag beginnt.	string (date-time)	Kann
`vertragsende`00360	Datum Vertragsende / DTM+93	string (date-time)	Kann
vertragskonditionen*	—	object	Muss
`haushaltskunde`*00370	haushaltskunde	boolean	Muss
`netznutzungsvertrag`*00380	Netznutzungsvertrag	string	Muss
`KUNDEN_NB`			Muss
`LIEFERANTEN_NB`			Muss
`netznutzungszahler`*00390	Netznutzungszahler	string	Muss
`KUNDE`			Muss
`LIEFERANT`			Muss
transaktionsdaten*	—	object	Muss
`gueltigAb`*00400	gueltigAb	string (date-time)	Muss
`pruefidentifikator`00410	Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 44019.	—	Kann
`sparte`*00420	Enthält Informationen über die Sparte	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00430	Gibt die Codenummer der Marktrolle an.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00440	Gibt die Codenummer der Marktrolle an.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00450	—	string	Muss
`prozessId`*00460	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "bilanzierungsbeginn": "2024-08-25T15:00:00Z",
        "bilanzierungsende": "2024-08-25T15:00:00Z",
        "bilanzkreise": [
          {
            "bezeichnung": "bezeichnung"
          }
        ],
        "fallgruppenzuordnung": "GABI_RLMmT",
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "kundenwert": {
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "herausgeber": "herausgeber",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE"
      }
    ],
    "ENERGIELIEFERVERTRAG": [
      {
        "vertragspartner2": [
          {
            "anrede": "anrede",
            "gewerbekennzeichnung": true,
            "name1": "name1",
            "name2": "name2",
            "name3": "name3",
            "name4": "name4"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "lokationsadresse": {
          "hausnummer": "hausnummer",
          "landescode": "AC",
          "ort": "ort",
          "ortsteil": "ortsteil",
          "postfach": "postfach",
          "postleitzahl": "postleitzahl",
          "strasse": "strasse",
          "zusatzInformation": {
            "zusatz1": "zusatz1",
            "zusatz2": "zusatz2",
            "zusatz3": "zusatz3",
            "zusatz4": "zusatz4",
            "zusatz5": "zusatz5"
          }
        },
        "marktlokationsId": "marktlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true,
          "netznutzungsvertrag": "KUNDEN_NB",
          "netznutzungszahler": "KUNDE"
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "gueltigAb": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "44019",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_BESTANDSLISTE",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_BESTANDSLISTE_GAS (NB) › Responses

Erfolg | Success

Struktur (BO4E)	Beschreibung	Format
`businessKey`*	Einzigartige Kennung des Geschäftsprozesses \| Unique identifier of the business process	string (uuid)
`message`*	Nachricht mit Details zum ausgelösten Event \| Message with details about the triggered event	string

Trigger-Event START_VERSAND_BESTANDSLISTE_GAS der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Hinweise zu dieser Seite

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.

START_VERSAND_BEENDIGUNG_AGV Übermittlung des Lieferscheins zur…

START_VERSAND_BESTANDSLISTE_GAS (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

GeLi_Gas 2.0 Kap. 1.6.1 Bestandslisten — NB

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "bilanzierungsbeginn": "2024-08-25T15:00:00Z",
        "bilanzierungsende": "2024-08-25T15:00:00Z",
        "bilanzkreise": [
          {
            "bezeichnung": "bezeichnung"
          }
        ],
        "fallgruppenzuordnung": "GABI_RLMmT",
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "kundenwert": {
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "herausgeber": "herausgeber",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE"
      }
    ],
    "ENERGIELIEFERVERTRAG": [
      {
        "vertragspartner2": [
          {
            "anrede": "anrede",
            "gewerbekennzeichnung": true,
            "name1": "name1",
            "name2": "name2",
            "name3": "name3",
            "name4": "name4"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "lokationsadresse": {
          "hausnummer": "hausnummer",
          "landescode": "AC",
          "ort": "ort",
          "ortsteil": "ortsteil",
          "postfach": "postfach",
          "postleitzahl": "postleitzahl",
          "strasse": "strasse",
          "zusatzInformation": {
            "zusatz1": "zusatz1",
            "zusatz2": "zusatz2",
            "zusatz3": "zusatz3",
            "zusatz4": "zusatz4",
            "zusatz5": "zusatz5"
          }
        },
        "marktlokationsId": "marktlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true,
          "netznutzungsvertrag": "KUNDEN_NB",
          "netznutzungszahler": "KUNDE"
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "gueltigAb": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "44019",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_BESTANDSLISTE",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_BESTANDSLISTE_GAS (NB) › Request Body

Struktur (BO4E)	Beschreibung	Format	44019
stammdaten*	—	object	Muss
BILANZIERUNG[ ]*	—	object[]	Muss
`bilanzierungsbeginn`00010	Inklusiver Start der Bilanzierung	string (date-time)	Kann
`bilanzierungsende`00020	Exklusives Ende der Bilanzierung	string (date-time)	Kann
`fallgruppenzuordnung`00030	Fallgruppenzuordnung (für gas RLM)	string	Kann
`GABI_RLMmT`			Kann
`GABI_RLMoT`			Kann
`GABI_RLMNEV`			Kann
`prognosegrundlage`*00040	Prognosegrundlage	string	Muss
`WERTE`			Muss
`PROFILE`			Muss
bilanzkreise[ ]*	—	object[]	Muss
`bezeichnung`*00050	Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.	string	Muss
jahresverbrauchsprognose	—	object	Kann
`einheit`00060	Einheit: Messgrößen, die per Messung oder Vorgabe ermittelt werden können	string	Kann
`W`			Kann
`WH`			Kann
`KW`			Kann
`KWH`			Kann
`KVARH`			Kann
`MW`			Kann
`MWH`			Kann
`STUECK`			Kann
`KUBIKMETER`			Kann
`STUNDE`			Kann
`TAG`			Kann
`MONAT`			Kann
`JAHR`			Kann
`PROZENT`			Kann
`ANZAHL`			Kann
`VAR`			Kann
`KVAR`			Kann
`VARH`			Kann
`KWHK`			Kann
`Z16`			Kann
`KWT`			Kann
`wert`00070	Wert	number (float)	Kann
kundenwert	—	object	Kann
`wert`00080	Wert	number (float)	Kann
lastprofile[ ]	—	object[]	Kann
`bezeichnung`00090	Zusätzliche Bezeichnung, z.B. Zählwerk_Wirkarbeit.	string	Kann
`herausgeber`00100	Herausgeber des Lastprofils	string	Kann
`verfahren`00110	Profilverfahren	string	Kann
`SYNTHETISCH`			Kann
`ANALYTISCH`			Kann
tagesparameter	—	object	Kann
`dienstanbieter`00120	dienstanbieter	string	Kann
`herausgeber`00130	Herausgeber des Lastprofils	string	Kann
`klimazone`00140	klimazone	string	Kann
`temperaturmessstelle`00150	temperaturmessstelle	string	Kann
ENERGIELIEFERVERTRAG[ ]	—	object[]	Kann
vertragspartner2[ ]	—	object[]	Kann
`anrede`00160	Die Anrede für den GePa, Z.B. Herr.	string	Kann
`gewerbekennzeichnung`00170	Kennzeichnung ob es sich um einen Gewerbe/Unternehmen (gewerbeKennzeichnung = true) oder eine Privatperson handelt. (gewerbeKennzeichnung = false)	boolean	Kann
`name1`00180	Erster Teil des Namens. Hier kann der Firmenname oder bei Privatpersonen beispielsweise der Nachname dargestellt werden. Beispiele: Yellow Strom GmbH oder Hagen	string	Kann
`name2`00190	Zweiter Teil des Namens. Hier kann der eine Erweiterung zum Firmennamen oder bei Privatpersonen beispielsweise der Vorname dargestellt werden. Beispiele: Bereich Süd oder Nina	string	Kann
`name3`00200	Dritter Teil des Namens. Hier können weitere Ergänzungen zum Firmennamen oder bei Privatpersonen Zusätze zum Namen dargestellt werden. Beispiele: und Afrika oder Sängerin	string	Kann
`name4`00210	name4	string	Kann
MARKTLOKATION[ ]*	—	object[]	Muss
`marktlokationsId`*00220	Identifikationsnummer einer Marktlokation, an der Energie entweder verbraucht, oder erzeugt wird	string	Muss
lokationsadresse	—	object	Kann
`hausnummer`00230	Hausnummer und Ergänzung	string	Kann
`landescode`00240	Landescode	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`00250	Ort	string	Kann
`ortsteil`00260	Ortsteil	string	Kann
`postfach`00270	Postfach	string	Kann
`postleitzahl`00280	Postleitzahl	string	Kann
`strasse`00290	Strasse	string	Kann
zusatzInformation	—	object	Kann
`zusatz1`00300	Adresszusatz 1	string	Kann
`zusatz2`00310	Adresszusatz 2	string	Kann
`zusatz3`00320	Adresszusatz 3	string	Kann
`zusatz4`00330	Adresszusatz 4	string	Kann
`zusatz5`00340	Adresszusatz 5	string	Kann
NETZNUTZUNGSVERTRAG[ ]*	—	object[]	Muss
`vertragsbeginn`00350	Gibt an, wann der Vertrag beginnt.	string (date-time)	Kann
`vertragsende`00360	Datum Vertragsende / DTM+93	string (date-time)	Kann
vertragskonditionen*	—	object	Muss
`haushaltskunde`*00370	haushaltskunde	boolean	Muss
`netznutzungsvertrag`*00380	Netznutzungsvertrag	string	Muss
`KUNDEN_NB`			Muss
`LIEFERANTEN_NB`			Muss
`netznutzungszahler`*00390	Netznutzungszahler	string	Muss
`KUNDE`			Muss
`LIEFERANT`			Muss
transaktionsdaten*	—	object	Muss
`gueltigAb`*00400	gueltigAb	string (date-time)	Muss
`pruefidentifikator`00410	Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 44019.	—	Kann
`sparte`*00420	Enthält Informationen über die Sparte	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00430	Gibt die Codenummer der Marktrolle an.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00440	Gibt die Codenummer der Marktrolle an.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00450	—	string	Muss
`prozessId`*00460	—	string	Muss

Example Request Body

{
  "stammdaten": {
    "BILANZIERUNG": [
      {
        "bilanzierungsbeginn": "2024-08-25T15:00:00Z",
        "bilanzierungsende": "2024-08-25T15:00:00Z",
        "bilanzkreise": [
          {
            "bezeichnung": "bezeichnung"
          }
        ],
        "fallgruppenzuordnung": "GABI_RLMmT",
        "jahresverbrauchsprognose": {
          "einheit": "W",
          "wert": 0
        },
        "kundenwert": {
          "wert": 0
        },
        "lastprofile": [
          {
            "bezeichnung": "bezeichnung",
            "herausgeber": "herausgeber",
            "tagesparameter": {
              "dienstanbieter": "dienstanbieter",
              "herausgeber": "herausgeber",
              "klimazone": "klimazone",
              "temperaturmessstelle": "temperaturmessstelle"
            },
            "verfahren": "SYNTHETISCH"
          }
        ],
        "prognosegrundlage": "WERTE"
      }
    ],
    "ENERGIELIEFERVERTRAG": [
      {
        "vertragspartner2": [
          {
            "anrede": "anrede",
            "gewerbekennzeichnung": true,
            "name1": "name1",
            "name2": "name2",
            "name3": "name3",
            "name4": "name4"
          }
        ]
      }
    ],
    "MARKTLOKATION": [
      {
        "lokationsadresse": {
          "hausnummer": "hausnummer",
          "landescode": "AC",
          "ort": "ort",
          "ortsteil": "ortsteil",
          "postfach": "postfach",
          "postleitzahl": "postleitzahl",
          "strasse": "strasse",
          "zusatzInformation": {
            "zusatz1": "zusatz1",
            "zusatz2": "zusatz2",
            "zusatz3": "zusatz3",
            "zusatz4": "zusatz4",
            "zusatz5": "zusatz5"
          }
        },
        "marktlokationsId": "marktlokationsId"
      }
    ],
    "NETZNUTZUNGSVERTRAG": [
      {
        "vertragsbeginn": "2024-08-25T15:00:00Z",
        "vertragsende": "2024-08-25T15:00:00Z",
        "vertragskonditionen": {
          "haushaltskunde": true,
          "netznutzungsvertrag": "KUNDEN_NB",
          "netznutzungszahler": "KUNDE"
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "gueltigAb": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "44019",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_BESTANDSLISTE",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_BESTANDSLISTE_GAS (NB) › Responses

Erfolg | Success

Struktur (BO4E)	Beschreibung	Format
`businessKey`*	Einzigartige Kennung des Geschäftsprozesses \| Unique identifier of the business process	string (uuid)
`message`*	Nachricht mit Details zum ausgelösten Event \| Message with details about the triggered event	string

Trigger-Event START_VERSAND_BESTANDSLISTE_GAS der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Hinweise zu dieser Seite

Feedback zur Dokumentation

Feedback zur Dokumentation

GeLi_Gas 2.0 Kap. 1.6.1 Bestandslisten

START_VERSAND_BESTANDSLISTE_GAS (NB)

START_VERSAND_BESTANDSLISTE_GAS (NB) › Request Body

START_VERSAND_BESTANDSLISTE_GAS (NB) › Responses

GeLi_Gas 2.0 Kap. 1.6.1 Bestandslisten

START_VERSAND_BESTANDSLISTE_GAS (NB)

START_VERSAND_BESTANDSLISTE_GAS (NB) › Request Body

START_VERSAND_BESTANDSLISTE_GAS (NB) › Responses