Übermittlung der bisher gemessenen…

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

Übermittlung der bisher gemessenen Arbeits- und Leistungswerte — 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"
    },
    "pruefidentifikator": "13015",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_GEMESSENE_ARB_LEIST_WERTE",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (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	13015
stammdaten*	—	object	Muss
ENERGIEMENGE[ ]*	—	object[]	Muss
`konfiguration`00010	Konfiguration (iMSys) des Zählwerks	string	Kann
`lokationsId`*00020	Für welche Markt- oder Messlokation gilt diese Anfrage.	string	Muss
energieverbrauch[ ]*	—	object[]	Muss
`enddatum`00030	enddatum	string (date-time)	Kann
`leistungsperiode`00040	leistungsperiode	string	Kann
`messwertstatus`*00050	Der Status eines Zählerstandes	string	Muss
`ABGELESEN`			Muss
`ERSATZWERT`			Muss
`VORSCHLAGSWERT`			Muss
`NICHT_VERWENDBAR`			Muss
`PROGNOSEWERT`			Muss
`ENERGIEMENGESUMMIERT`			Muss
`VOLAEUFIGERWERT`			Muss
`FEHLT`			Muss
`ANGABE_FUER_LIEFERSCHEIN`			Muss
`GRUNDLAGE_POG_ERMITTLUNG`			Muss
`obiskennzahl`*00060	obiskennzahl	string	Muss
`position`*00070	position	integer	Muss
`startdatum`00080	startdatum	string (date-time)	Kann
`wert`*00090	Wert	number (float)	Muss
statuszusatzinformationen[ ]	—	object[]	Kann
`art`00100	TechnischeRessourceArt	string	Kann
`STROMERZEUGUNG`			Kann
`STROMVERBRAUCH`			Kann
`SPEICHER`			Kann
`status`00110	Status	string	Kann
`KUNDENSELBSTABLESUNG`			Kann
`LEERSTAND`			Kann
`REALER_ZAEHLERUEBERLAUF_GEPRUEFT`			Kann
`PLAUSIBEL_WG_KONTROLLABLESUNG`			Kann
`PLAUSIBEL_WG_KUNDENHINWEIS`			Kann
`AUSTAUSCH_DES_ERSATZWERTES`			Kann
`RECHENWERT`			Kann
`BASIS_MME`			Kann
`VERGLEICHSMESSUNG_GEEICHT`			Kann
`VERGLEICHSMESSUNG_NICHT_GEEICHT`			Kann
`MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN`			Kann
`MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN`			Kann
`INTERPOLATION`			Kann
`HALTEWERT`			Kann
`BILANZIERUNG_NETZABSCHNITT`			Kann
`HISTORISCHE_MESSWERTE`			Kann
`STATISTISCHE_METHODE`			Kann
`AUFTEILUNG`			Kann
`VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS`			Kann
`UMGANGS_UND_KORREKTURMENGEN`			Kann
`ANGABEN_MESSLOKATION`			Kann
`KEIN_ZUGANG`			Kann
`KOMMUNIKATIONSSTOERUNG`			Kann
`NETZAUSFALL`			Kann
`SPANNUNGSAUSFALL`			Kann
`STATUS_GERAETEWECHSEL`			Kann
`KALIBRIERUNG`			Kann
`GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN`			Kann
`MESSEINRICHTUNG_GESTOERT_DEFEKT`			Kann
`UNSICHERHEIT_MESSUNG`			Kann
`BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK`			Kann
`MENGENUMWERTUNG_VOLLSTAENDIG`			Kann
`UHRZEIT_GESTELLT_SYNCHRONISATION`			Kann
`MESSWERT_UNPLAUSIBEL`			Kann
`FALSCHER_WANDLERFAKTOR`			Kann
`FEHLERHAFTE_ABLESUNG`			Kann
`AENDERUNG_DER_BERECHNUNG`			Kann
`UMBAU_DER_MESSLOKATION`			Kann
`DATENBEARBEITUNGSFEHLER`			Kann
`BRENNWERTKORREKTUR`			Kann
`Z_ZAHL_KORREKTUR`			Kann
`STOERUNG_DEFEKT_MESSEINRICHTUNG`			Kann
`AENDERUNG_TARIFSCHALTZEITEN`			Kann
`TARIFSCHALTGERAET_DEFEKT`			Kann
`IMPULSWERTIGKEIT_NICHT_AUSREICHEND`			Kann
`ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL`			Kann
`ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL`			Kann
`WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET`			Kann
`GESTOERTE_WERTE`			Kann
`WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN`			Kann
`KONSISTENZ_UND_SYNCHRONPRUEFUNG`			Kann
`GRUND_ANGABEN_MESSLOKATION`			Kann
`ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR`			Kann
`UMSTELLUNG_GASQUALITAET`			Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann
`GESCHEITERT`			Kann
`AUSGEBAUT`			Kann
transaktionsdaten*	—	object	Muss
`anfrageReferenz`*00120	Beantragungsnummer / RFF+AGI	string	Muss
`pruefidentifikator`00130	Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 13015.	—	Kann
`sparte`*00140	Enthält Informationen über die Sparte	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00150	Gibt die Codenummer der Marktrolle an.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00160	Gibt die Codenummer der Marktrolle an.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00170	—	string	Muss
`prozessId`*00180	—	string	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"
    },
    "pruefidentifikator": "13015",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_GEMESSENE_ARB_LEIST_WERTE",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (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_GEMESSENE_ARB_LEIST_WERTE 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 105 Rumpfvarianten heraus, damit sie einzeln lesbar und ausprobierbar sind.

Übermittlung des Lieferscheins zur…Übermittlung des Lieferscheins zur…

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (1):

Übermittlung der bisher gemessenen Arbeits- und Leistungswerte — 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"
    },
    "pruefidentifikator": "13015",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_GEMESSENE_ARB_LEIST_WERTE",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB) › Request Body

Struktur (BO4E)	Beschreibung	Format	13015
stammdaten*	—	object	Muss
ENERGIEMENGE[ ]*	—	object[]	Muss
`konfiguration`00010	Konfiguration (iMSys) des Zählwerks	string	Kann
`lokationsId`*00020	Für welche Markt- oder Messlokation gilt diese Anfrage.	string	Muss
energieverbrauch[ ]*	—	object[]	Muss
`enddatum`00030	enddatum	string (date-time)	Kann
`leistungsperiode`00040	leistungsperiode	string	Kann
`messwertstatus`*00050	Der Status eines Zählerstandes	string	Muss
`ABGELESEN`			Muss
`ERSATZWERT`			Muss
`VORSCHLAGSWERT`			Muss
`NICHT_VERWENDBAR`			Muss
`PROGNOSEWERT`			Muss
`ENERGIEMENGESUMMIERT`			Muss
`VOLAEUFIGERWERT`			Muss
`FEHLT`			Muss
`ANGABE_FUER_LIEFERSCHEIN`			Muss
`GRUNDLAGE_POG_ERMITTLUNG`			Muss
`obiskennzahl`*00060	obiskennzahl	string	Muss
`position`*00070	position	integer	Muss
`startdatum`00080	startdatum	string (date-time)	Kann
`wert`*00090	Wert	number (float)	Muss
statuszusatzinformationen[ ]	—	object[]	Kann
`art`00100	TechnischeRessourceArt	string	Kann
`STROMERZEUGUNG`			Kann
`STROMVERBRAUCH`			Kann
`SPEICHER`			Kann
`status`00110	Status	string	Kann
`KUNDENSELBSTABLESUNG`			Kann
`LEERSTAND`			Kann
`REALER_ZAEHLERUEBERLAUF_GEPRUEFT`			Kann
`PLAUSIBEL_WG_KONTROLLABLESUNG`			Kann
`PLAUSIBEL_WG_KUNDENHINWEIS`			Kann
`AUSTAUSCH_DES_ERSATZWERTES`			Kann
`RECHENWERT`			Kann
`BASIS_MME`			Kann
`VERGLEICHSMESSUNG_GEEICHT`			Kann
`VERGLEICHSMESSUNG_NICHT_GEEICHT`			Kann
`MESSWERTNACHBILDUNG_AUS_GEEICHTEN_WERTEN`			Kann
`MESSWERTNACHBILDUNG_AUS_NICHT_GEEICHTEN_WERTEN`			Kann
`INTERPOLATION`			Kann
`HALTEWERT`			Kann
`BILANZIERUNG_NETZABSCHNITT`			Kann
`HISTORISCHE_MESSWERTE`			Kann
`STATISTISCHE_METHODE`			Kann
`AUFTEILUNG`			Kann
`VERWENDUNG_VON_WERTEN_DES_STOERMENGENZAEHLWERKS`			Kann
`UMGANGS_UND_KORREKTURMENGEN`			Kann
`ANGABEN_MESSLOKATION`			Kann
`KEIN_ZUGANG`			Kann
`KOMMUNIKATIONSSTOERUNG`			Kann
`NETZAUSFALL`			Kann
`SPANNUNGSAUSFALL`			Kann
`STATUS_GERAETEWECHSEL`			Kann
`KALIBRIERUNG`			Kann
`GERAET_ARBEITET_AUSSERHALB_DER_BETRIEBSBEDINGUNGEN`			Kann
`MESSEINRICHTUNG_GESTOERT_DEFEKT`			Kann
`UNSICHERHEIT_MESSUNG`			Kann
`BERUECKSICHTIGUNG_STOERMENGENZAEHLWERK`			Kann
`MENGENUMWERTUNG_VOLLSTAENDIG`			Kann
`UHRZEIT_GESTELLT_SYNCHRONISATION`			Kann
`MESSWERT_UNPLAUSIBEL`			Kann
`FALSCHER_WANDLERFAKTOR`			Kann
`FEHLERHAFTE_ABLESUNG`			Kann
`AENDERUNG_DER_BERECHNUNG`			Kann
`UMBAU_DER_MESSLOKATION`			Kann
`DATENBEARBEITUNGSFEHLER`			Kann
`BRENNWERTKORREKTUR`			Kann
`Z_ZAHL_KORREKTUR`			Kann
`STOERUNG_DEFEKT_MESSEINRICHTUNG`			Kann
`AENDERUNG_TARIFSCHALTZEITEN`			Kann
`TARIFSCHALTGERAET_DEFEKT`			Kann
`IMPULSWERTIGKEIT_NICHT_AUSREICHEND`			Kann
`ENERGIEMENGE_IN_UNGEMESSENEM_ZEITINTERVALL`			Kann
`ENERGIEMENGE_AUS_DEM_UNGEPAIRTEN_ZEITINTERVALL`			Kann
`WARTUNGSARBEITEN_AN_GEEICHTEM_MESSGERAET`			Kann
`GESTOERTE_WERTE`			Kann
`WARTUNGSARBEITEN_AN_EICHRECHTSKONFORMEN_MESSGERAETEN`			Kann
`KONSISTENZ_UND_SYNCHRONPRUEFUNG`			Kann
`GRUND_ANGABEN_MESSLOKATION`			Kann
`ANFORDERUNG_IN_DIE_VERGANGENHEIT_ZUM_ANGEFORDERTEN_ZEITPUNKT_LIEGT_KEIN_WERT_VOR`			Kann
`UMSTELLUNG_GASQUALITAET`			Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_VORHANDEN_UND_KOMMUNIZIERT`			Kann
`ZAEHLERSTAND_ZUM_BEGINN_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann
`ZAEHLERSTAND_ZUM_ENDE_DER_ANGEGEBENEN_ENERGIEMENGE_NICHT_VORHANDEN_DA_MENGENABGRENZUNG`			Kann
`GESCHEITERT`			Kann
`AUSGEBAUT`			Kann
transaktionsdaten*	—	object	Muss
`anfrageReferenz`*00120	Beantragungsnummer / RFF+AGI	string	Muss
`pruefidentifikator`00130	Wird dynamisch im Event-Prozess ermittelt. Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 13015.	—	Kann
`sparte`*00140	Enthält Informationen über die Sparte	string	Muss
`STROM`			Muss
`GAS`			Muss
`FERNWAERME`			Muss
`NAHWAERME`			Muss
`WASSER`			Muss
`ABWASSER`			Muss
absender*	—	object	Muss
`rollencodenummer`00150	Gibt die Codenummer der Marktrolle an.	string	Kann
empfaenger*	—	object	Muss
`rollencodenummer`00160	Gibt die Codenummer der Marktrolle an.	string	Kann
zusatzdaten*	—	object	Muss
`eventname`*00170	—	string	Muss
`prozessId`*00180	—	string	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"
    },
    "pruefidentifikator": "13015",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_GEMESSENE_ARB_LEIST_WERTE",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (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_GEMESSENE_ARB_LEIST_WERTE der Marktrolle NB.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Hinweise zu dieser Seite

Feedback zur Dokumentation

Feedback zur Dokumentation

Übermittlung der bisher gemessenen…

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB)

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB) › Request Body

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB) › Responses

Übermittlung der bisher gemessenen…

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB)

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB) › Request Body

START_VERSAND_GEMESSENE_ARB_LEIST_WERTE (NB) › Responses