Abrechnung Leistungen des Preisblatts A…

START_VERSAND_ANTWORT_NNA (LF)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (8):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "AVIS": [
      {
        "avisNummer": "avisNummer",
        "avisTyp": "ABGELEHNTE_FORDERUNG",
        "positionen": [
          {
            "gesamtBrutto": {
              "wert": 0
            },
            "istSelbstausgestellt": true,
            "istStorno": true,
            "rechnungsDatum": "2024-08-25T15:00:00Z",
            "rechnungsNummer": "rechnungsNummer",
            "zuZahlen": {
              "wert": 0
            }
          }
        ],
        "zuZahlen": {
          "waehrung": "waehrung",
          "wert": 0
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "nachrichtendatum": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "33001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_ANTWORT_NNA",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_ANTWORT_NNA (LF) › 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	33001	33002	33003	33004
stammdaten*	—	object	Muss	Muss	Muss	Muss
AVIS[ ]*	—	object[]	Muss	Muss	Muss	Muss
`avisNummer`*00010	Eine im Verwendungskontext eindeutige Nummer für das Avis.	string	Muss	Muss	Muss	Muss
`avisTyp`*00020	Gibt den Typ des Avis an.	string	Muss	Muss	Muss	Muss
`ABGELEHNTE_FORDERUNG`			Muss	Muss	Muss	Muss
`ZAHLUNGSAVIS`			Muss	Muss	Muss	Muss
positionen[ ]*	—	object[]	Muss	Muss	Muss	Muss
`istSelbstausgestellt`*00030	istSelbstausgestellt	boolean	Muss	Muss	Muss	Muss
`istStorno`*00040	istStorno	boolean	Muss	Muss	Muss	Muss
`rechnungsDatum`*00050	rechnungsDatum	string (date-time)	Muss	Muss	Muss	Muss
`rechnungsNummer`*00060	rechnungsNummer	string	Muss	Muss	Muss	Muss
gesamtBrutto*	—	object	Muss	Muss	Muss	Muss
`wert`*00070	Wert	number (float)	Muss	Muss	Muss	Muss
zuZahlen*	—	object	Muss	Muss	Muss	Muss
`wert`*00080	Wert	number (float)	Muss	Muss	Muss	Muss
`referenz`00090	referenz	string		Kann	Kann	Kann
abweichung[ ]*	—	object[]		Muss	Muss
`abweichungsgrundBemerkung1`00100	Abweichungsgrund Bemerkung 1	string		Kann	Kann
`abweichungsgrundBemerkung2`00110	Abweichungsgrund Bemerkung 2	string		Kann	Kann
`abweichungsgrundBemerkung3`00120	Abweichungsgrund Bemerkung 3	string		Kann	Kann
`abweichungsgrundBemerkung4`00130	Abweichungsgrund Bemerkung 4	string		Kann	Kann
`abweichungsgrundBemerkung5`00140	Abweichungsgrund Bemerkung 5	string		Kann	Kann
`abweichungsgrundCode`*00150	Code des Abweichungsgrundes	string		Muss	Muss
`abweichungsgrundCodeliste`*00160	Codeliste des Abweichungsgrund	string		Muss	Muss
`abschlagsrechnungen`[ ]00170	Abschlagsrechnungen	string[]			Kann
`fehlendePositionen1`00180	fehlende Positionen 1	string			Kann
`fehlendePositionen2`00190	fehlende Positionen 2	string			Kann
`fehlendePositionen3`00200	fehlende Positionen 3	string			Kann
`fehlendePositionen4`00210	fehlende Positionen 4	string			Kann
`fehlendePositionen5`00220	fehlende Positionen 5	string			Kann
`zugehoerigeRechnung`00230	Angabe der Rechnungsnummer, auf die sich diese Abweichung bezieht	string			Kann
positionen[ ]*	—	object[]				Muss
`positionsnummer`*00240	Positionsnummer	integer				Muss
abweichung[ ]*	—	object[]				Muss
`abweichungsgrundBemerkung1`00250	Abweichungsgrund Bemerkung 1	string				Kann
`abweichungsgrundBemerkung2`00260	Abweichungsgrund Bemerkung 2	string				Kann
`abweichungsgrundBemerkung3`00270	Abweichungsgrund Bemerkung 3	string				Kann
`abweichungsgrundBemerkung4`00280	Abweichungsgrund Bemerkung 4	string				Kann
`abweichungsgrundBemerkung5`00290	Abweichungsgrund Bemerkung 5	string				Kann
`abweichungsgrundCode`*00300	Code des Abweichungsgrundes	string				Muss
`abweichungsgrundCodeliste`*00310	Codeliste des Abweichungsgrund	string				Muss
`referenz`00320	referenz	string				Kann
`zugehoerigeRechnung`00330	Angabe der Rechnungsnummer, auf die sich diese Abweichung bezieht	string				Kann
zuZahlen*	—	object	Muss	Muss	Muss	Muss
`waehrung`*00340	Währung des Preises	string	Muss	Muss	Muss	Muss
`wert`*00350	Wert	number (float)	Muss	Muss	Muss	Muss
transaktionsdaten*	—	object	Muss	Muss	Muss	Muss
`kategorie`*00360	Qualifier aus dem Beginn der EDIFact Nachricht / BGM	string	Muss	Muss	Muss	Muss
`nachrichtendatum`*00370	Erstellungdatum der EDIFact / DTM+137	string (date-time)	Muss	Muss	Muss	Muss
`pruefidentifikator`*00380	Wird dynamisch im Event-Prozess ermittelt (Entscheidungsgrundlage: kategorie, pruefi). Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 33001, 33002, 33003, 33004.	—	Muss	Muss	Muss	Muss
`sparte`*00390	Enthält Informationen über die Sparte	string	Muss	Muss	Muss	Muss
`STROM`			Muss	Muss	Muss	Muss
`GAS`			Muss	Muss	Muss	Muss
`FERNWAERME`			Muss	Muss	Muss	Muss
`NAHWAERME`			Muss	Muss	Muss	Muss
`WASSER`			Muss	Muss	Muss	Muss
`ABWASSER`			Muss	Muss	Muss	Muss
absender*	—	object	Muss	Muss	Muss	Muss
`rollencodenummer`00400	Gibt die Codenummer der Marktrolle an.	string	Kann	Kann	Kann	Kann
empfaenger*	—	object	Muss	Muss	Muss	Muss
`marktrolle`00410	Gibt im Klartext die Bezeichnung der Marktrolle an.	string	Kann	Kann	Kann	Kann
`NB`			Kann	Kann	Kann	Kann
`LF`			Kann	Kann	Kann	Kann
`MSB`			Kann	Kann	Kann	Kann
`MSBA`			Kann	Kann	Kann	Kann
`GMSB`			Kann	Kann	Kann	Kann
`MDL`			Kann	Kann	Kann	Kann
`DL`			Kann	Kann	Kann	Kann
`BKV`			Kann	Kann	Kann	Kann
`BKO`			Kann	Kann	Kann	Kann
`UENB`			Kann	Kann	Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann	Kann	Kann
`MGV`			Kann	Kann	Kann	Kann
`EIV`			Kann	Kann	Kann	Kann
`RB`			Kann	Kann	Kann	Kann
`KUNDE`			Kann	Kann	Kann	Kann
`INTERESSENT`			Kann	Kann	Kann	Kann
`KN`			Kann	Kann	Kann	Kann
`UBA`			Kann	Kann	Kann	Kann
`BIKO`			Kann	Kann	Kann	Kann
`ESA`			Kann	Kann	Kann	Kann
`rollencodenummer`00420	Gibt die Codenummer der Marktrolle an.	string	Kann	Kann	Kann	Kann
zusatzdaten*	—	object	Muss	Muss	Muss	Muss
`eventname`*00430	—	string	Muss	Muss	Muss	Muss
`prozessId`*00440	—	string	Muss	Muss	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "AVIS": [
      {
        "avisNummer": "avisNummer",
        "avisTyp": "ABGELEHNTE_FORDERUNG",
        "positionen": [
          {
            "gesamtBrutto": {
              "wert": 0
            },
            "istSelbstausgestellt": true,
            "istStorno": true,
            "rechnungsDatum": "2024-08-25T15:00:00Z",
            "rechnungsNummer": "rechnungsNummer",
            "zuZahlen": {
              "wert": 0
            }
          }
        ],
        "zuZahlen": {
          "waehrung": "waehrung",
          "wert": 0
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "nachrichtendatum": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "33001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_ANTWORT_NNA",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_ANTWORT_NNA (LF) › 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_ANTWORT_NNA der Marktrolle LF.

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.

START_VERSAND_ANF_STORNO Bestellung Beendigung einer…

START_VERSAND_ANTWORT_NNA (LF)

POST

https://api.macoapp.de

/inbound

Startet diese Rollensichten (8):

POST/inbound

curl https://api.macoapp.de/inbound \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "stammdaten": {
    "AVIS": [
      {
        "avisNummer": "avisNummer",
        "avisTyp": "ABGELEHNTE_FORDERUNG",
        "positionen": [
          {
            "gesamtBrutto": {
              "wert": 0
            },
            "istSelbstausgestellt": true,
            "istStorno": true,
            "rechnungsDatum": "2024-08-25T15:00:00Z",
            "rechnungsNummer": "rechnungsNummer",
            "zuZahlen": {
              "wert": 0
            }
          }
        ],
        "zuZahlen": {
          "waehrung": "waehrung",
          "wert": 0
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "nachrichtendatum": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "33001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_ANTWORT_NNA",
    "prozessId": "prozessId"
  }
}'

START_VERSAND_ANTWORT_NNA (LF) › Request Body

Struktur (BO4E)	Beschreibung	Format	33001	33002	33003	33004
stammdaten*	—	object	Muss	Muss	Muss	Muss
AVIS[ ]*	—	object[]	Muss	Muss	Muss	Muss
`avisNummer`*00010	Eine im Verwendungskontext eindeutige Nummer für das Avis.	string	Muss	Muss	Muss	Muss
`avisTyp`*00020	Gibt den Typ des Avis an.	string	Muss	Muss	Muss	Muss
`ABGELEHNTE_FORDERUNG`			Muss	Muss	Muss	Muss
`ZAHLUNGSAVIS`			Muss	Muss	Muss	Muss
positionen[ ]*	—	object[]	Muss	Muss	Muss	Muss
`istSelbstausgestellt`*00030	istSelbstausgestellt	boolean	Muss	Muss	Muss	Muss
`istStorno`*00040	istStorno	boolean	Muss	Muss	Muss	Muss
`rechnungsDatum`*00050	rechnungsDatum	string (date-time)	Muss	Muss	Muss	Muss
`rechnungsNummer`*00060	rechnungsNummer	string	Muss	Muss	Muss	Muss
gesamtBrutto*	—	object	Muss	Muss	Muss	Muss
`wert`*00070	Wert	number (float)	Muss	Muss	Muss	Muss
zuZahlen*	—	object	Muss	Muss	Muss	Muss
`wert`*00080	Wert	number (float)	Muss	Muss	Muss	Muss
`referenz`00090	referenz	string		Kann	Kann	Kann
abweichung[ ]*	—	object[]		Muss	Muss
`abweichungsgrundBemerkung1`00100	Abweichungsgrund Bemerkung 1	string		Kann	Kann
`abweichungsgrundBemerkung2`00110	Abweichungsgrund Bemerkung 2	string		Kann	Kann
`abweichungsgrundBemerkung3`00120	Abweichungsgrund Bemerkung 3	string		Kann	Kann
`abweichungsgrundBemerkung4`00130	Abweichungsgrund Bemerkung 4	string		Kann	Kann
`abweichungsgrundBemerkung5`00140	Abweichungsgrund Bemerkung 5	string		Kann	Kann
`abweichungsgrundCode`*00150	Code des Abweichungsgrundes	string		Muss	Muss
`abweichungsgrundCodeliste`*00160	Codeliste des Abweichungsgrund	string		Muss	Muss
`abschlagsrechnungen`[ ]00170	Abschlagsrechnungen	string[]			Kann
`fehlendePositionen1`00180	fehlende Positionen 1	string			Kann
`fehlendePositionen2`00190	fehlende Positionen 2	string			Kann
`fehlendePositionen3`00200	fehlende Positionen 3	string			Kann
`fehlendePositionen4`00210	fehlende Positionen 4	string			Kann
`fehlendePositionen5`00220	fehlende Positionen 5	string			Kann
`zugehoerigeRechnung`00230	Angabe der Rechnungsnummer, auf die sich diese Abweichung bezieht	string			Kann
positionen[ ]*	—	object[]				Muss
`positionsnummer`*00240	Positionsnummer	integer				Muss
abweichung[ ]*	—	object[]				Muss
`abweichungsgrundBemerkung1`00250	Abweichungsgrund Bemerkung 1	string				Kann
`abweichungsgrundBemerkung2`00260	Abweichungsgrund Bemerkung 2	string				Kann
`abweichungsgrundBemerkung3`00270	Abweichungsgrund Bemerkung 3	string				Kann
`abweichungsgrundBemerkung4`00280	Abweichungsgrund Bemerkung 4	string				Kann
`abweichungsgrundBemerkung5`00290	Abweichungsgrund Bemerkung 5	string				Kann
`abweichungsgrundCode`*00300	Code des Abweichungsgrundes	string				Muss
`abweichungsgrundCodeliste`*00310	Codeliste des Abweichungsgrund	string				Muss
`referenz`00320	referenz	string				Kann
`zugehoerigeRechnung`00330	Angabe der Rechnungsnummer, auf die sich diese Abweichung bezieht	string				Kann
zuZahlen*	—	object	Muss	Muss	Muss	Muss
`waehrung`*00340	Währung des Preises	string	Muss	Muss	Muss	Muss
`wert`*00350	Wert	number (float)	Muss	Muss	Muss	Muss
transaktionsdaten*	—	object	Muss	Muss	Muss	Muss
`kategorie`*00360	Qualifier aus dem Beginn der EDIFact Nachricht / BGM	string	Muss	Muss	Muss	Muss
`nachrichtendatum`*00370	Erstellungdatum der EDIFact / DTM+137	string (date-time)	Muss	Muss	Muss	Muss
`pruefidentifikator`*00380	Wird dynamisch im Event-Prozess ermittelt (Entscheidungsgrundlage: kategorie, pruefi). Ein vom Sender mitgegebener Wert wird ignoriert. Im Topic mögliche Prüfis — 33001, 33002, 33003, 33004.	—	Muss	Muss	Muss	Muss
`sparte`*00390	Enthält Informationen über die Sparte	string	Muss	Muss	Muss	Muss
`STROM`			Muss	Muss	Muss	Muss
`GAS`			Muss	Muss	Muss	Muss
`FERNWAERME`			Muss	Muss	Muss	Muss
`NAHWAERME`			Muss	Muss	Muss	Muss
`WASSER`			Muss	Muss	Muss	Muss
`ABWASSER`			Muss	Muss	Muss	Muss
absender*	—	object	Muss	Muss	Muss	Muss
`rollencodenummer`00400	Gibt die Codenummer der Marktrolle an.	string	Kann	Kann	Kann	Kann
empfaenger*	—	object	Muss	Muss	Muss	Muss
`marktrolle`00410	Gibt im Klartext die Bezeichnung der Marktrolle an.	string	Kann	Kann	Kann	Kann
`NB`			Kann	Kann	Kann	Kann
`LF`			Kann	Kann	Kann	Kann
`MSB`			Kann	Kann	Kann	Kann
`MSBA`			Kann	Kann	Kann	Kann
`GMSB`			Kann	Kann	Kann	Kann
`MDL`			Kann	Kann	Kann	Kann
`DL`			Kann	Kann	Kann	Kann
`BKV`			Kann	Kann	Kann	Kann
`BKO`			Kann	Kann	Kann	Kann
`UENB`			Kann	Kann	Kann	Kann
`KUNDE-SELBST-NN`			Kann	Kann	Kann	Kann
`MGV`			Kann	Kann	Kann	Kann
`EIV`			Kann	Kann	Kann	Kann
`RB`			Kann	Kann	Kann	Kann
`KUNDE`			Kann	Kann	Kann	Kann
`INTERESSENT`			Kann	Kann	Kann	Kann
`KN`			Kann	Kann	Kann	Kann
`UBA`			Kann	Kann	Kann	Kann
`BIKO`			Kann	Kann	Kann	Kann
`ESA`			Kann	Kann	Kann	Kann
`rollencodenummer`00420	Gibt die Codenummer der Marktrolle an.	string	Kann	Kann	Kann	Kann
zusatzdaten*	—	object	Muss	Muss	Muss	Muss
`eventname`*00430	—	string	Muss	Muss	Muss	Muss
`prozessId`*00440	—	string	Muss	Muss	Muss	Muss

Example Request Body

{
  "stammdaten": {
    "AVIS": [
      {
        "avisNummer": "avisNummer",
        "avisTyp": "ABGELEHNTE_FORDERUNG",
        "positionen": [
          {
            "gesamtBrutto": {
              "wert": 0
            },
            "istSelbstausgestellt": true,
            "istStorno": true,
            "rechnungsDatum": "2024-08-25T15:00:00Z",
            "rechnungsNummer": "rechnungsNummer",
            "zuZahlen": {
              "wert": 0
            }
          }
        ],
        "zuZahlen": {
          "waehrung": "waehrung",
          "wert": 0
        }
      }
    ]
  },
  "transaktionsdaten": {
    "absender": {
      "rollencodenummer": "rollencodenummer"
    },
    "empfaenger": {
      "marktrolle": "NB",
      "rollencodenummer": "rollencodenummer"
    },
    "kategorie": "kategorie",
    "nachrichtendatum": "2024-08-25T15:00:00Z",
    "pruefidentifikator": "33001",
    "sparte": "STROM"
  },
  "zusatzdaten": {
    "eventname": "START_VERSAND_ANTWORT_NNA",
    "prozessId": "prozessId"
  }
}

json

START_VERSAND_ANTWORT_NNA (LF) › 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_ANTWORT_NNA der Marktrolle LF.

Schema nur dieses Ereignisses herunterladen (OpenAPI, JSON).

Hinweise zu dieser Seite

Feedback zur Dokumentation

Feedback zur Dokumentation

Abrechnung Leistungen des Preisblatts A…

START_VERSAND_ANTWORT_NNA (LF)

START_VERSAND_ANTWORT_NNA (LF) › Request Body

START_VERSAND_ANTWORT_NNA (LF) › Responses

Abrechnung Leistungen des Preisblatts A…

START_VERSAND_ANTWORT_NNA (LF)

START_VERSAND_ANTWORT_NNA (LF) › Request Body

START_VERSAND_ANTWORT_NNA (LF) › Responses