Transmission of the delivery note for…

START_VERSAND_LIEFERSCHEIN (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

Übermittlung des Lieferscheins zur Netznutzungsabrechnung — NB

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ENERGIEMENGE": [
      {
        "energieverbrauch": [
          {
            "enddatum": "2024-08-25T15:00:00Z",
            "leistungsperiode": "leistungsperiode",
            "messwertstatus": "ABGELESEN",
            "obiskennzahl": "obiskennzahl",
            "position": 0,
            "startdatum": "2024-08-25T15:00:00Z",
            "statuszusatzinformationen": [
              {
                "art": "STROMERZEUGUNG",
                "status": "KUNDENSELBSTABLESUNG"
              }
            ],
            "wert": 0
          }
        ],
        "konfiguration": "konfiguration",
        "lokationsId": "lokationsId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "anfrageReferenz": "anfrageReferenz",
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "13016",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_LIEFERSCHEIN",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_LIEFERSCHEIN (NB) › 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	13016	13019
stammdaten*	—	object	Muss	Muss
ENERGIEMENGE[ ]*	—	object[]	Muss	Muss
`konfiguration`00010	Configuration (iMSys) of the meter register	string	Kann	Kann
`lokationsId`*00020	Which market or metering location this request applies to.	string	Muss	Muss
energieverbrauch[ ]*	—	object[]	Muss	Muss
`enddatum`00030	enddatum	string (date-time)	Kann	Muss
`leistungsperiode`00040	leistungsperiode	string	Kann
`messwertstatus`*00050	The status of a meter reading	string	Muss	Muss
`ABGELESEN`			Muss	Muss
`ERSATZWERT`			Muss	Muss
`VORSCHLAGSWERT`			Muss	Muss
`NICHT_VERWENDBAR`			Muss	Muss
`PROGNOSEWERT`			Muss	Muss
`ENERGIEMENGESUMMIERT`			Muss	Muss
`VOLAEUFIGERWERT`			Muss	Muss
`FEHLT`			Muss	Muss
`ANGABE_FUER_LIEFERSCHEIN`			Muss	Muss
`GRUNDLAGE_POG_ERMITTLUNG`			Muss	Muss
`obiskennzahl`*00060	obiskennzahl	string	Muss	Muss
`position`*00070	position	integer	Muss	Muss
`startdatum`00080	startdatum	string (date-time)	Kann	Muss
`wert`*00090	Value	number (float)	Muss	Muss
statuszusatzinformationen[ ]	—	object[]	Kann	Kann
`art`00100	Technical resource type	string	Kann	Kann
`STROMERZEUGUNG`			Kann	Kann
`STROMVERBRAUCH`			Kann	Kann
`SPEICHER`			Kann	Kann
`status`00110	Status	string	Kann	Kann
`KUNDENSELBSTABLESUNG`			Kann	Kann
`LEERSTAND`			Kann	Kann
`REALER_ZAEHLERUEBERLAUF_GEPRUEFT`			Kann	Kann
`PLAUSIBEL_WG_KONTROLLABLESUNG`			Kann	Kann
`PLAUSIBEL_WG_KUNDENHINWEIS`			Kann	Kann
`AUSTAUSCH_DES_ERSATZWERTES`			Kann	Kann
`RECHENWERT`			Kann	Kann
`BASIS_MME`			Kann	Kann
`VERGLEICHSMESSUNG_GEEICHT`			Kann	Kann
`VERGLEICHSMESSUNG_NICHT_GEEICHT`			Kann	Kann
`MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN`			Kann	Kann
`MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN`			Kann	Kann
`INTERPOLATION`			Kann	Kann
`HALTEWERT`			Kann	Kann
`BILANZIERUNG_NETZABSCHNITT`			Kann	Kann
`HISTORISCHE_MESSWERTE`			Kann	Kann
`STATISTISCHE_METHODE`			Kann	Kann
`AUFTEILUNG`			Kann	Kann
`VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS`			Kann	Kann
`UMGANGS_UND_KORREKTURMENGEN`			Kann	Kann
`ANGABEN_MESSLOKATION`			Kann	Kann
`KEIN_ZUGANG`			Kann	Kann
`KOMMUNIKATIONSSTOERUNG`			Kann	Kann
`NETZAUSFALL`			Kann	Kann
`SPANNUNGSAUSFALL`			Kann	Kann
`STATUS_GERAETEWECHSEL`			Kann	Kann
`KALIBRIERUNG`			Kann	Kann
`GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN`			Kann	Kann
`MESSEINRICHTUNG_GESTOERT_DEFEKT`			Kann	Kann
`UNSICHERHEIT_MESSUNG`			Kann	Kann
`BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK`			Kann	Kann
`MENGENUMWERTUNG_VOLLSTAENDIG`			Kann	Kann
`UHRZEIT_GESTELLT_SYNCHRONISATION`			Kann	Kann
`MESSWERT_UNPLAUSIBEL`			Kann	Kann
`FALSCHER_WANDLERFAKTOR`			Kann	Kann
`FEHLERHAFTE_ABLESUNG`			Kann	Kann
`AENDERUNG_DER_BERECHNUNG`			Kann	Kann
`UMBAU_DER_MESSLOKATION`			Kann	Kann
`DATENBEARBEITUNGSFEHLER`			Kann	Kann
`BRENNWERTKORREKTUR`			Kann	Kann
`Z_ZAHL_KORREKTUR`			Kann	Kann
`STOERUNG_DEFEKT_MESSEINRICHTUNG`			Kann	Kann
`AENDERUNG_TARIFSCHALTZEITEN`			Kann	Kann
`TARIFSCHALTGERAET_DEFEKT`			Kann	Kann
`IMPULSWERTIGKEIT_NICHT_AUSREICHEND`			Kann	Kann
`ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL`			Kann	Kann
`ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL`			Kann	Kann
`WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET`			Kann	Kann
`GESTOERTE_WERTE`			Kann	Kann
`WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN`			Kann	Kann
`KONSISTENZ_UND_SYNCHRONPRUEFUNG`			Kann	Kann
`GRUND_ANGABEN_MESSLOKATION`			Kann	Kann
`ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR`			Kann	Kann
`UMSTELLUNG_GASQUALITAET`			Kann	Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann	Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann	Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann	Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann	Kann
`GESCHEITERT`			Kann	Kann
`AUSGEBAUT`			Kann	Kann
transaktionsdaten*	—	object	Muss	Muss
`anfrageReferenz`*00120	Application number / RFF+AGI	string	Muss	Muss
`kategorie`*00130	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss	Muss
`pruefidentifikator`00140	Determined dynamically in the event process (basis for the decision: kategorie). A value supplied by the sender is ignored. Check identifiers possible in the topic — 13016, 13019.	—	Kann	Kann
`sparte`*00150	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
absender*	—	object	Muss	Muss
`rollencodenummer`00160	Specifies the code value of the market role.	string	Kann	Kann
empfaenger*	—	object	Muss	Muss
`rollencodenummer`00170	Specifies the code value of the market role.	string	Kann	Kann
zusatzdaten*	—	object	Muss	Muss
`eventname`*00180	—	string	Muss	Muss
`prozessId`*00190	—	string	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "ENERGIEMENGE": [
      {
        "energieverbrauch": [
          {
            "enddatum": "2024-08-25T15:00:00Z",
            "leistungsperiode": "leistungsperiode",
            "messwertstatus": "ABGELESEN",
            "obiskennzahl": "obiskennzahl",
            "position": 0,
            "startdatum": "2024-08-25T15:00:00Z",
            "statuszusatzinformationen": [
              {
                "art": "STROMERZEUGUNG",
                "status": "KUNDENSELBSTABLESUNG"
              }
            ],
            "wert": 0
          }
        ],
        "konfiguration": "konfiguration",
        "lokationsId": "lokationsId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "anfrageReferenz": "anfrageReferenz",
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "13016",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_LIEFERSCHEIN",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_LIEFERSCHEIN (NB) › 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_VERSAND_LIEFERSCHEIN der Marktrolle NB.

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.

Transmission of the previously measured…Request for master data change from the LF…

START_VERSAND_LIEFERSCHEIN (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

Übermittlung des Lieferscheins zur Netznutzungsabrechnung — NB

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "ENERGIEMENGE": [
      {
        "energieverbrauch": [
          {
            "enddatum": "2024-08-25T15:00:00Z",
            "leistungsperiode": "leistungsperiode",
            "messwertstatus": "ABGELESEN",
            "obiskennzahl": "obiskennzahl",
            "position": 0,
            "startdatum": "2024-08-25T15:00:00Z",
            "statuszusatzinformationen": [
              {
                "art": "STROMERZEUGUNG",
                "status": "KUNDENSELBSTABLESUNG"
              }
            ],
            "wert": 0
          }
        ],
        "konfiguration": "konfiguration",
        "lokationsId": "lokationsId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "anfrageReferenz": "anfrageReferenz",
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "13016",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_LIEFERSCHEIN",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_LIEFERSCHEIN (NB) › Request Body

Structure (BO4E)	Description	Format	13016	13019
stammdaten*	—	object	Muss	Muss
ENERGIEMENGE[ ]*	—	object[]	Muss	Muss
`konfiguration`00010	Configuration (iMSys) of the meter register	string	Kann	Kann
`lokationsId`*00020	Which market or metering location this request applies to.	string	Muss	Muss
energieverbrauch[ ]*	—	object[]	Muss	Muss
`enddatum`00030	enddatum	string (date-time)	Kann	Muss
`leistungsperiode`00040	leistungsperiode	string	Kann
`messwertstatus`*00050	The status of a meter reading	string	Muss	Muss
`ABGELESEN`			Muss	Muss
`ERSATZWERT`			Muss	Muss
`VORSCHLAGSWERT`			Muss	Muss
`NICHT_VERWENDBAR`			Muss	Muss
`PROGNOSEWERT`			Muss	Muss
`ENERGIEMENGESUMMIERT`			Muss	Muss
`VOLAEUFIGERWERT`			Muss	Muss
`FEHLT`			Muss	Muss
`ANGABE_FUER_LIEFERSCHEIN`			Muss	Muss
`GRUNDLAGE_POG_ERMITTLUNG`			Muss	Muss
`obiskennzahl`*00060	obiskennzahl	string	Muss	Muss
`position`*00070	position	integer	Muss	Muss
`startdatum`00080	startdatum	string (date-time)	Kann	Muss
`wert`*00090	Value	number (float)	Muss	Muss
statuszusatzinformationen[ ]	—	object[]	Kann	Kann
`art`00100	Technical resource type	string	Kann	Kann
`STROMERZEUGUNG`			Kann	Kann
`STROMVERBRAUCH`			Kann	Kann
`SPEICHER`			Kann	Kann
`status`00110	Status	string	Kann	Kann
`KUNDENSELBSTABLESUNG`			Kann	Kann
`LEERSTAND`			Kann	Kann
`REALER_ZAEHLERUEBERLAUF_GEPRUEFT`			Kann	Kann
`PLAUSIBEL_WG_KONTROLLABLESUNG`			Kann	Kann
`PLAUSIBEL_WG_KUNDENHINWEIS`			Kann	Kann
`AUSTAUSCH_DES_ERSATZWERTES`			Kann	Kann
`RECHENWERT`			Kann	Kann
`BASIS_MME`			Kann	Kann
`VERGLEICHSMESSUNG_GEEICHT`			Kann	Kann
`VERGLEICHSMESSUNG_NICHT_GEEICHT`			Kann	Kann
`MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN`			Kann	Kann
`MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN`			Kann	Kann
`INTERPOLATION`			Kann	Kann
`HALTEWERT`			Kann	Kann
`BILANZIERUNG_NETZABSCHNITT`			Kann	Kann
`HISTORISCHE_MESSWERTE`			Kann	Kann
`STATISTISCHE_METHODE`			Kann	Kann
`AUFTEILUNG`			Kann	Kann
`VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS`			Kann	Kann
`UMGANGS_UND_KORREKTURMENGEN`			Kann	Kann
`ANGABEN_MESSLOKATION`			Kann	Kann
`KEIN_ZUGANG`			Kann	Kann
`KOMMUNIKATIONSSTOERUNG`			Kann	Kann
`NETZAUSFALL`			Kann	Kann
`SPANNUNGSAUSFALL`			Kann	Kann
`STATUS_GERAETEWECHSEL`			Kann	Kann
`KALIBRIERUNG`			Kann	Kann
`GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN`			Kann	Kann
`MESSEINRICHTUNG_GESTOERT_DEFEKT`			Kann	Kann
`UNSICHERHEIT_MESSUNG`			Kann	Kann
`BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK`			Kann	Kann
`MENGENUMWERTUNG_VOLLSTAENDIG`			Kann	Kann
`UHRZEIT_GESTELLT_SYNCHRONISATION`			Kann	Kann
`MESSWERT_UNPLAUSIBEL`			Kann	Kann
`FALSCHER_WANDLERFAKTOR`			Kann	Kann
`FEHLERHAFTE_ABLESUNG`			Kann	Kann
`AENDERUNG_DER_BERECHNUNG`			Kann	Kann
`UMBAU_DER_MESSLOKATION`			Kann	Kann
`DATENBEARBEITUNGSFEHLER`			Kann	Kann
`BRENNWERTKORREKTUR`			Kann	Kann
`Z_ZAHL_KORREKTUR`			Kann	Kann
`STOERUNG_DEFEKT_MESSEINRICHTUNG`			Kann	Kann
`AENDERUNG_TARIFSCHALTZEITEN`			Kann	Kann
`TARIFSCHALTGERAET_DEFEKT`			Kann	Kann
`IMPULSWERTIGKEIT_NICHT_AUSREICHEND`			Kann	Kann
`ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL`			Kann	Kann
`ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL`			Kann	Kann
`WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET`			Kann	Kann
`GESTOERTE_WERTE`			Kann	Kann
`WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN`			Kann	Kann
`KONSISTENZ_UND_SYNCHRONPRUEFUNG`			Kann	Kann
`GRUND_ANGABEN_MESSLOKATION`			Kann	Kann
`ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR`			Kann	Kann
`UMSTELLUNG_GASQUALITAET`			Kann	Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann	Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann	Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann	Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann	Kann
`GESCHEITERT`			Kann	Kann
`AUSGEBAUT`			Kann	Kann
transaktionsdaten*	—	object	Muss	Muss
`anfrageReferenz`*00120	Application number / RFF+AGI	string	Muss	Muss
`kategorie`*00130	Qualifier from the beginning of the EDIFACT message / BGM	string	Muss	Muss
`pruefidentifikator`00140	Determined dynamically in the event process (basis for the decision: kategorie). A value supplied by the sender is ignored. Check identifiers possible in the topic — 13016, 13019.	—	Kann	Kann
`sparte`*00150	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
absender*	—	object	Muss	Muss
`rollencodenummer`00160	Specifies the code value of the market role.	string	Kann	Kann
empfaenger*	—	object	Muss	Muss
`rollencodenummer`00170	Specifies the code value of the market role.	string	Kann	Kann
zusatzdaten*	—	object	Muss	Muss
`eventname`*00180	—	string	Muss	Muss
`prozessId`*00190	—	string	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "ENERGIEMENGE": [
      {
        "energieverbrauch": [
          {
            "enddatum": "2024-08-25T15:00:00Z",
            "leistungsperiode": "leistungsperiode",
            "messwertstatus": "ABGELESEN",
            "obiskennzahl": "obiskennzahl",
            "position": 0,
            "startdatum": "2024-08-25T15:00:00Z",
            "statuszusatzinformationen": [
              {
                "art": "STROMERZEUGUNG",
                "status": "KUNDENSELBSTABLESUNG"
              }
            ],
            "wert": 0
          }
        ],
        "konfiguration": "konfiguration",
        "lokationsId": "lokationsId"
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "anfrageReferenz": "anfrageReferenz",
    "empfaenger": {
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "pruefidentifikator": "13016",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_LIEFERSCHEIN",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_LIEFERSCHEIN (NB) › 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_VERSAND_LIEFERSCHEIN der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Notes on this page

Feedback on the documentation

Feedback on the documentation

Transmission of the delivery note for…

START_VERSAND_LIEFERSCHEIN (NB)

START_VERSAND_LIEFERSCHEIN (NB) › Request Body

START_VERSAND_LIEFERSCHEIN (NB) › Responses

Transmission of the delivery note for…

START_VERSAND_LIEFERSCHEIN (NB)

START_VERSAND_LIEFERSCHEIN (NB) › Request Body

START_VERSAND_LIEFERSCHEIN (NB) › Responses