[LF] START_VERSAND_ANTWORT_NNA
Marktrolle LF · Formatversion 202604 · BO4E-Schema 1.7.8
Master data
Exactly one of the following 4 check identifiers is permitted under this topic — which one is decided by the event process.
| Prüfi | Scope | Use case | Regulatory determination | Communication |
|---|---|---|---|---|
| PI_33001 | REMADV | Confirmation | WiM gas | NB → MSBA |
| PI_33002 | REMADV | Refusal | WiM gas | NB → MSBA |
| PI_33003 | REMADV | Electricity refusal header and total | GPKE part 2 | LF → NB |
| PI_33004 | REMADV | Electricity refusal line item | GPKE part 2 | LF → NB |
The master data of the 4 check identifiers in one structure — one column per check identifier, as in the application handbook. A value in the column means that the field belongs to this check identifier: Must where its specification requires it, otherwise May. An empty cell means »not part of it«, not »unknown«. The first one is preselected; the bar above the table adds the others.
| Structure (BO4E) | Description | Format | 33001 | 33002 | 33003 | 33004 | Condition |
|---|---|---|---|---|---|---|---|
| stammdaten | — | object | May | May | May | May | — |
| AVIS [ ] * | — | object[] | Must | Must | Must | Must | — |
| avisNummer *00010 | A number for the remittance advice that is unique in the context of use. | string | Must | Must | Must | Must | — |
| avisTyp *00020 | Indicates the type of the remittance advice. | Enum AvisTyp | Must | Must | Must | Must | — |
ABGELEHNTE_FORDERUNG | — | — | Must | Must | Must | Must | — |
ZAHLUNGSAVIS | — | — | Must | Must | Must | Must | — |
| positionen [ ] * | — | object[] | Must | Must | Must | Must | — |
| istSelbstausgestellt *00030 | istSelbstausgestellt | boolean | Must | Must | Must | Must | — |
| istStorno *00040 | istStorno | boolean | Must | Must | Must | Must | — |
| rechnungsDatum *00050 | rechnungsDatum | string (date-time) | Must | Must | Must | Must | — |
| rechnungsNummer *00060 | rechnungsNummer | string | Must | Must | Must | Must | — |
| gesamtBrutto * | — | object | Must | Must | Must | Must | — |
| wert *00070 | Specifies the amount of the price. | number (float) | Must | Must | Must | Must | — |
| zuZahlen * | — | object | Must | Must | Must | Must | — |
| wert *00080 | Specifies the amount of the price. | number (float) | Must | Must | Must | Must | — |
| referenz00090 | referenz | string | — | May | May | May | — |
| abweichung [ ] * | — | object[] | — | Must | Must | — | — |
| abweichungsgrundBemerkung100100 | Deviation reason remark 1 | string | — | May | May | — | — |
| abweichungsgrundBemerkung200110 | Deviation reason remark 2 | string | — | May | May | — | — |
| abweichungsgrundBemerkung300120 | Deviation reason remark 3 | string | — | May | May | — | — |
| abweichungsgrundBemerkung400130 | Deviation reason remark 4 | string | — | May | May | — | — |
| abweichungsgrundBemerkung500140 | Deviation reason remark 5 | string | — | May | May | — | — |
| abweichungsgrundCode *00150 | Code of the reason for deviation | string | — | Must | Must | — | — |
| abweichungsgrundCodeliste *00160 | Code list of the deviation reason | string | — | Must | Must | — | — |
| abschlagsrechnungen00170 | Instalment invoices | array | — | — | May | — | — |
| fehlendePositionen100180 | missing line items 1 | string | — | — | May | — | — |
| fehlendePositionen200190 | missing line items 2 | string | — | — | May | — | — |
| fehlendePositionen300200 | missing line items 3 | string | — | — | May | — | — |
| fehlendePositionen400210 | missing line items 4 | string | — | — | May | — | — |
| fehlendePositionen500220 | missing line items 5 | string | — | — | May | — | — |
| zugehoerigeRechnung00230 | Specification of the invoice number to which this deviation refers | string | — | — | May | — | — |
| positionen [ ] * | — | object[] | — | — | — | Must | — |
| positionsnummer *00240 | positionsnummer | integer | — | — | — | Must | — |
| abweichung [ ] * | — | object[] | — | — | — | Must | — |
| abweichungsgrundBemerkung100250 | Deviation reason remark 1 | string | — | — | — | May | — |
| abweichungsgrundBemerkung200260 | Deviation reason remark 2 | string | — | — | — | May | — |
| abweichungsgrundBemerkung300270 | Deviation reason remark 3 | string | — | — | — | May | — |
| abweichungsgrundBemerkung400280 | Deviation reason remark 4 | string | — | — | — | May | — |
| abweichungsgrundBemerkung500290 | Deviation reason remark 5 | string | — | — | — | May | — |
| abweichungsgrundCode *00300 | Code of the reason for deviation | string | — | — | — | Must | — |
| abweichungsgrundCodeliste *00310 | Code list of the deviation reason | string | — | — | — | Must | — |
| referenz00320 | referenz | string | — | — | — | May | — |
| zugehoerigeRechnung00330 | Specification of the invoice number to which this deviation refers | string | — | — | — | May | — |
| zuZahlen * | — | object | Must | Must | Must | Must | — |
| waehrung *00340 | Currency of the price | string | Must | Must | Must | Must | — |
| wert *00350 | Specifies the amount of the price. | number (float) | Must | Must | Must | Must | — |
Chain of this trigger
The event triggers the message.
| Message | Responses | Write call after the response |
|---|---|---|
| 33001 | — | — |
| 33002 | — | — |
| 33003 | — | — |
| 33004 | — | — |
This event triggers steps in these role views:
| Process | Party involved | Rulebook | Division |
|---|---|---|---|
| Billing of services of price sheet B of the MSB between MSB and LF | LF | AWH processes for changing the technology at locations | Electricity |
| Billing of another service | LF | AWH disconnection processes gas | Gas |
| Billing of another service | LF | GPKE part 2 | Electricity |
| Grid usage settlement | LF | GPKE part 2 | Electricity |
| Billing of services of price sheet A of the MSB between MSB and LF | LF | GPKE part 3 | Electricity |
| Billing of grid usage | LF | GeLi Gas 2.0 | Gas |
| Excess/shortfall quantity settlement between NB and LF | LF | Processes for the determination and billing of excess/shortfall volumes for electricity and gas | Electricity and gas |
| Billing of metering point operation to the LF | LF | WiM electricity part 1 | Electricity |
Transaction data
The interchange envelope of the message. Mandatory fields must be set on the trigger call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
| kategorie | string | yes | Qualifier from the beginning of the EDIFACT message / BGM |
| nachrichtendatum | string (date-time) | yes | Creation date of the EDIFact / DTM+137 |
pruefidentifikator | — | yes | Determined dynamically in the event process (decision basis: kategorie, pruefi). A value supplied by the sender is ignored. Check identifiers possible in the topic — 33001, 33002, 33003, 33004. Possible values: 33001, 33002, 33003, 33004 |
| sparte | Enum Sparte | yes | Contains information about the division Values: STROM, GAS, FERNWAERME, NAHWAERME, WASSER, ABWASSER |
| absender › rollencodenummer | string | no | Specifies the code value of the market role. |
| empfaenger › marktrolle | Enum Marktrolle | no | Specifies the designation of the market role as free text. Values: NB, LF, MSB, MSBA, GMSB, MDL, DL, BKV, UENB, KUNDE-SELBST-NN … (+9) |
| empfaenger › rollencodenummer | string | no | Specifies the code value of the market role. |
Additional data
eventname is fixed to START_VERSAND_ANTWORT_NNA. This value stays German in the English version as well, because Camunda correlates on it.
| Field | Type | Mandatory | Description |
|---|---|---|---|
prozessId | string | yes | — |
eventname | const START_VERSAND_ANTWORT_NNA | yes | — |
Response
The trigger assigns its own businessKey. The MACO APP adopts neither the businessKey nor the prozessId of the calling system as the identifier of the process instance. The businessKey of the response is created when the process starts and is new. The body of this call carries no businessKey field; there is thus no place where a key of your own could be passed in. The prozessId passed in (a mandatory field of this call) remains the document number of the backend: it comes back in zusatzdaten.prozessId of the callbacks — mandatory there only for MaloIdent (03002/03003), otherwise optional.
201 — Success. Success message for the process data API call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
businessKey | string (uuid) | yes | Unique identifier of the business process |
message | string | yes | Message with details of the triggered event — example from the source: received event XXXXXXXXXXXX with id at 2024-08-08T12:58:22Z and started process with businessKey 4c7170ed-3518-41ee-8582-39ab65b00107 |
400 — Error. Error message for the process data API call.
| Field | Type | Mandatory | Description |
|---|---|---|---|
errorCode | string | no | Error identifier — example from the source: 400 |
message | string | no | Technical message — example from the source: Validation Failed |
Which body the callbacks updateProcessData and createProcessData send is measured against the NiFi flow of the MACO APP: {stammdaten, transaktionsdaten, zusatzdaten} without an interchange envelope, the businessKey inside zusatzdaten. This is not measured against a recorded call, and not for MaloIdent (03002/03003).
What distinguishes businessKey, prozessId and targetBusinessKey is explained on Keys and assignment.