# Check identifier 31002 — NN invoice
Check identifier **31002** · EDIFACT message type **INVOIC** · Format version **202604**
## Data structure
| Structure (BO4E) | Description | Format |
31002 | Condition |
|---|---|---|---|---|
|
**stammdaten** \* | — | object | Must | — |
|
**MARKTLOKATION** [ ] \* | — | object[] | Must | — |
|
[lokationsadresse](/en/bo4e/202604/bo/Marktlokation#lokationsadresse) \* 00010 | The address at which the energy delivery or feed-in takes place. | [Adresse](/en/bo4e/202604/com/Adresse) | X | — |
|
[marktlokationsId](/en/bo4e/202604/bo/Marktlokation#marktlokationsid) \* 00020 | Identification number of a market location at which energy is either
consumed or generated | string | X | — |
|
**RECHNUNG** [ ] \* | — | object[] | Must | — |
|
[bearbeitungsdatum](/en/bo4e/202604/bo/Rechnung#bearbeitungsdatum) \* 00030 | bearbeitungsdatum | string (date-time) | X | — |
|
[datumVorgaengerrechnung](/en/bo4e/202604/bo/Rechnung#datumvorgaengerrechnung) 00040 | datumVorgaengerrechnung | string (date-time) | X | — |
|
[faelligkeitsdatum](/en/bo4e/202604/bo/Rechnung#faelligkeitsdatum) \* 00050 | Payment is due on this date. | string (date-time) | X | — |
|
[istReverseCharge](/en/bo4e/202604/bo/Rechnung#istreversecharge) 00060 | Indicator whether the reverse charge procedure is applied to the invoice | boolean | Should |
[4] |
|
[originalRechnungsnummer](/en/bo4e/202604/bo/Rechnung#originalrechnungsnummer) 00070 | In the case of a cancellation invoice (storno = true), this contains the invoice number of the cancelled invoice. | string | X | — |
|
[preisNetzbetreiberCodenummer](/en/bo4e/202604/bo/Rechnung#preisnetzbetreibercodenummer) 00080 | preisNetzbetreiberCodenummer | string | X | — |
|
[rechnungsdatum](/en/bo4e/202604/bo/Rechnung#rechnungsdatum) \* 00090 | Issue date of the invoice. | string (date-time) | X | — |
|
[rechnungsstatus](/en/bo4e/202604/bo/Rechnung#rechnungsstatus) \* 00100 | Status of the invoice indicating the processing stage. For details see ENUM invoice status | [Enum Rechnungsstatus](/en/bo4e/202604/enum/Rechnungsstatus) | X | — |
|
`DUPLIKAT` | — | — | X | — |
|
`ORIGINAL` | — | — | X | — |
|
`STORNIERT` | — | — | X | — |
|
[rechnungstyp](/en/bo4e/202604/bo/Rechnung#rechnungstyp) \* 00110 | A context-related invoice type, e.g. grid usage invoice. For details see ENUM Invoice type | [Enum Rechnungstyp](/en/bo4e/202604/enum/Rechnungstyp) | Must | — |
|
`ABSCHLUSSRECHNUNG` | — | — | Must | — |
|
`ABSCHLAGSRECHNUNG` | — | — | Must | — |
|
`TURNUSRECHNUNG` | — | — | Must | — |
|
`MONATSRECHNUNG` | — | — | Must | — |
|
`WIMRECHNUNG` | — | — | Must | — |
|
`ZWISCHENRECHNUNG` | — | — | Must | — |
|
`INTEGRIERTE_13TE_RECHNUNG` | — | — | Must | — |
|
`ZUSAETZLICHE_13TE_RECHNUNG` | — | — | Must | — |
|
`MEHRMINDERMENGENRECHNUNG` | — | — | Must | — |
|
`MSBRECHNUNG` | — | — | Must | — |
|
`KAPAZITAETSRECHNUNG` | — | — | Must | — |
|
`SPERRUNG_INBETRIEBNAHME` | — | — | Must | — |
|
`VERZUGSKOSTEN` | — | — | Must | — |
|
`BLINDARBEIT` | — | — | Must | — |
|
`SONDERRECHNUNG` | — | — | Must | — |
|
`ABRECHNUNG_VON_KONFIGURATIONEN_UNIVERSALBESTELLPROZESS` | — | — | Must | — |
|
`ABRECHNUNG_VON_TECHNIK` | — | — | Must | — |
|
[referenzDokumentennummer](/en/bo4e/202604/bo/Rechnung#referenzdokumentennummer) 00120 | referenzDokumentennummer | string | X | — |
|
[referenzNachrichtendatum](/en/bo4e/202604/bo/Rechnung#referenznachrichtendatum) 00130 | referenzNachrichtendatum | string | X | — |
|
[referenzVorgaengerrechnung](/en/bo4e/202604/bo/Rechnung#referenzvorgaengerrechnung) 00140 | referenzVorgaengerrechnung | string | X | — |
|
[sonderrechnungsarten](/en/bo4e/202604/bo/Rechnung#sonderrechnungsarten) 00150 | Special invoice type | array | X | — |
|
**gemeinderabatt** | — | object | May | — |
|
[wert](/en/bo4e/202604/com/Gemeinderabatt#wert) 00160 | Value | number (float) | X | — |
|
**gesamtbrutto** \* | — | object | Must | — |
|
[wert](/en/bo4e/202604/com/Betrag#wert) \* 00170 | Specifies the amount of the price. | number (float) | X | — |
|
**rechnungsperiode** \* | — | object | Must | — |
|
[enddatum](/en/bo4e/202604/com/Zeitraum#enddatum) \* 00180 | enddatum | string (date-time) | X | — |
|
[startdatum](/en/bo4e/202604/com/Zeitraum#startdatum) \* 00190 | startdatum | string (date-time) | X | — |
|
**rechnungspositionen** [ ] \* | — | object[] | Must | — |
|
[artikelnummer](/en/bo4e/202604/com/Rechnungsposition#artikelnummer) \* 00200 | Identification of the invoice line item with the standard article number of the BDEW. Details
BDEW article number | string | Must | — |
|
[gesamtZuAbschlagsbetrag](/en/bo4e/202604/com/Rechnungsposition#gesamtzuabschlagsbetrag) 00210 | gesamtZuAbschlagsbetrag | number (float) | X | — |
|
[lieferungBis](/en/bo4e/202604/com/Rechnungsposition#lieferungbis) \* 00220 | End of the supply for the billed service. | string (date-time) | X | — |
|
[lieferungVon](/en/bo4e/202604/com/Rechnungsposition#lieferungvon) \* 00230 | Start of supply for the billed service. | string (date-time) | X | — |
|
[positionsnummer](/en/bo4e/202604/com/Rechnungsposition#positionsnummer) \* 00240 | Sequential number for the invoice line item. | integer | Must | — |
|
**abschlag** | — | object | May | — |
|
[prozent](/en/bo4e/202604/com/Abschlag#prozent) 00250 | Percentage details of the surcharge/discount | number (float) | X | — |
|
[typ](/en/bo4e/202604/com/Abschlag#typ) 00260 | AbschlagTyp | [Enum AbschlagTyp](/en/bo4e/202604/enum/AbschlagTyp) | X | — |
|
`GEMEINDERABATT_KAV` | — | — | X | — |
|
`ANPASSUNG_P19_STROM_NEV` | — | — | X | — |
|
**einzelpreis** \* | — | object | Must | — |
|
[bezugswert](/en/bo4e/202604/com/Preis#bezugswert) 00270 | Unit: measurands that can be determined by measurement or by specification | [Enum Mengeneinheit](/en/bo4e/202604/enum/Mengeneinheit) | X | — |
|
`W` | — | — | X | — |
|
`WH` | — | — | X | — |
|
`KW` | — | — | X | — |
|
`KWH` | — | — | X | — |
|
`KVARH` | — | — | X | — |
|
`MW` | — | — | X | — |
|
`MWH` | — | — | X | — |
|
`STUECK` | — | — | X | — |
|
`KUBIKMETER` | — | — | X | — |
|
`STUNDE` | — | — | X | — |
|
`TAG` | — | — | X | — |
|
`MONAT` | — | — | X | — |
|
`JAHR` | — | — | X | — |
|
`PROZENT` | — | — | X | — |
|
`ANZAHL` | — | — | X | — |
|
`VAR` | — | — | X | — |
|
`KVAR` | — | — | X | — |
|
`VARH` | — | — | X | — |
|
`KWHK` | — | — | X | — |
|
`Z16` | — | — | X | — |
|
`KWT` | — | — | X | — |
|
`WATT_PRO_QUADRATMETER` | — | — | X | — |
|
`METER_PRO_SEKUNDE` | — | — | X | — |
|
[wert](/en/bo4e/202604/com/Preis#wert) \* 00280 | wert | number (float) | X | — |
|
**gemeinderabatt** | — | object | May | — |
|
[bemessungsgrundlage](/en/bo4e/202604/com/Gemeinderabatt#bemessungsgrundlage) 00290 | Assessment basis | number (float) | X | — |
|
[wert](/en/bo4e/202604/com/Gemeinderabatt#wert) 00300 | Value | number (float) | X | — |
|
**positionsMenge** \* | — | object | Must | — |
|
[einheit](/en/bo4e/202604/com/Menge#einheit) \* 00310 | Unit: measurands that can be determined by measurement or by specification | [Enum Mengeneinheit](/en/bo4e/202604/enum/Mengeneinheit) | X | — |
|
`W` | — | — | X | — |
|
`WH` | — | — | X | — |
|
`KW` | — | — | X | — |
|
`KWH` | — | — | X | — |
|
`KVARH` | — | — | X | — |
|
`MW` | — | — | X | — |
|
`MWH` | — | — | X | — |
|
`STUECK` | — | — | X | — |
|
`KUBIKMETER` | — | — | X | — |
|
`STUNDE` | — | — | X | — |
|
`TAG` | — | — | X | — |
|
`MONAT` | — | — | X | — |
|
`JAHR` | — | — | X | — |
|
`PROZENT` | — | — | X | — |
|
`ANZAHL` | — | — | X | — |
|
`VAR` | — | — | X | — |
|
`KVAR` | — | — | X | — |
|
`VARH` | — | — | X | — |
|
`KWHK` | — | — | X | — |
|
`Z16` | — | — | X | — |
|
`KWT` | — | — | X | — |
|
`WATT_PRO_QUADRATMETER` | — | — | X | — |
|
`METER_PRO_SEKUNDE` | — | — | X | — |
|
[wert](/en/bo4e/202604/com/Menge#wert) \* 00320 | Value | number (float) | X | — |
|
**teilsummeNetto** \* | — | object | Must | — |
|
[wert](/en/bo4e/202604/com/Betrag#wert) \* 00330 | Specifies the amount of the price. | number (float) | X | — |
|
**teilsummeSteuer** \* | — | object | Must | — |
|
[steuerkennzeichen](/en/bo4e/202604/com/Steuerbetrag#steuerkennzeichen) \* 00340 | Identification of the tax rate or procedure. Details tax code | string | Must | — |
|
**zeitbezogeneMenge** | — | object | May | — |
|
[einheit](/en/bo4e/202604/com/Menge#einheit) 00350 | Unit: measurands that can be determined by measurement or by specification | [Enum Mengeneinheit](/en/bo4e/202604/enum/Mengeneinheit) | X | — |
|
`W` | — | — | X | — |
|
`WH` | — | — | X | — |
|
`KW` | — | — | X | — |
|
`KWH` | — | — | X | — |
|
`KVARH` | — | — | X | — |
|
`MW` | — | — | X | — |
|
`MWH` | — | — | X | — |
|
`STUECK` | — | — | X | — |
|
`KUBIKMETER` | — | — | X | — |
|
`STUNDE` | — | — | X | — |
|
`TAG` | — | — | X | — |
|
`MONAT` | — | — | X | — |
|
`JAHR` | — | — | X | — |
|
`PROZENT` | — | — | X | — |
|
`ANZAHL` | — | — | X | — |
|
`VAR` | — | — | X | — |
|
`KVAR` | — | — | X | — |
|
`VARH` | — | — | X | — |
|
`KWHK` | — | — | X | — |
|
`Z16` | — | — | X | — |
|
`KWT` | — | — | X | — |
|
`WATT_PRO_QUADRATMETER` | — | — | X | — |
|
`METER_PRO_SEKUNDE` | — | — | X | — |
|
[wert](/en/bo4e/202604/com/Menge#wert) 00360 | Value | number (float) | X | — |
|
**zuschlag** | — | object | May | — |
|
[prozent](/en/bo4e/202604/com/Zuschlag#prozent) 00370 | prozent | number (float) | X | — |
|
[typ](/en/bo4e/202604/com/Zuschlag#typ) 00380 | Surcharge type | [Enum ZuschlagTyp](/en/bo4e/202604/enum/ZuschlagTyp) | X | — |
|
`UMSPANNUNGSZUSCHLAG` | — | — | X | — |
|
`BETRIEBSMITTEL_P19_STROM_NEV` | — | — | X | — |
|
`ANPASSUNG_P19_STROM_NEV` | — | — | X | — |
|
`ANPASSUNG_PAUSCHALE_NETZENTGELTREDUZIERUNG_NACH_P14A_ENWG_AUF_HOEHE_DER_NNE` | — | — | X | — |
|
**steuerbetraege** [ ] \* | — | object[] | Must | — |
|
[basiswert](/en/bo4e/202604/com/Steuerbetrag#basiswert) \* 00390 | Net amount on which the tax was calculated. E.g. 200 | number (float) | X | — |
|
[basiswertVorausbezahlt](/en/bo4e/202604/com/Steuerbetrag#basiswertvorausbezahlt) 00400 | basiswertVorausbezahlt | number (float) | X | — |
|
[steuerkennzeichen](/en/bo4e/202604/com/Steuerbetrag#steuerkennzeichen) \* 00410 | Identification of the tax rate or procedure. Details tax code | string | Must | — |
|
[steuerwert](/en/bo4e/202604/com/Steuerbetrag#steuerwert) \* 00420 | Tax calculated from the base value. E.g. 38 (at UST_19) if the base value is 200. | number (float) | X | — |
|
[steuerwertVorausbezahlt](/en/bo4e/202604/com/Steuerbetrag#steuerwertvorausbezahlt) 00430 | steuerwertVorausbezahlt | number (float) | X | — |
|
**vorausgezahlt** | — | object | May | — |
|
[wert](/en/bo4e/202604/com/Betrag#wert) 00440 | Specifies the amount of the price. | number (float) | X | — |
|
**zuZahlen** \* | — | object | Must | — |
|
[wert](/en/bo4e/202604/com/Betrag#wert) \* 00450 | Specifies the amount of the price. | number (float) | X | — |
|
**transaktionsdaten** \* | — | object | Must | — |
|
[dokumentennummer](/en/bo4e/202604/cdoc/Transaktionsdaten#dokumentennummer) \* 00460 | EDIFACT reference from the BGM segment / BGM | string | X | — |
|
[nachrichtenreferenznummer](/en/bo4e/202604/cdoc/Transaktionsdaten#nachrichtenreferenznummer) \* 00470 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
|
[pruefidentifikator](/en/bo4e/202604/cdoc/Transaktionsdaten#pruefidentifikator) \* 00480 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
|
**absender** \* | — | object | Must | — |
|
[name1](/en/bo4e/202604/bo/Marktteilnehmer#name1) \* 00490 | First part of the name. This can hold the company name or, for private individuals,
the surname, for example. Examples: Yellow Strom GmbH
or Hagen | string | X | — |
|
[rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#rollencodenummer) \* 00500 | Specifies the code value of the market role. | string | X | — |
|
[rollencodetyp](/en/bo4e/202604/bo/Marktteilnehmer#rollencodetyp) \* 00510 | Indicates the type of the code. | [Enum Rollencodetyp](/en/bo4e/202604/enum/Rollencodetyp) | X | — |
|
`BDEW` | — | — | X | — |
|
`GS1` | — | — | X | — |
|
`GLN` | — | — | X | — |
|
`DVGW` | — | — | X | — |
|
[steuernummer](/en/bo4e/202604/bo/Marktteilnehmer#steuernummer) 00520 | The tax number ID of the business partner. Example: 30120345678 | string | Must | — |
|
[umsatzsteuerId](/en/bo4e/202604/bo/Marktteilnehmer#umsatzsteuerid) 00530 | The VAT ID of the business partner. Example: DE 813281825 | string | Must | — |
|
**ansprechpartner** | — | object | May | — |
|
[nachname](/en/bo4e/202604/bo/Ansprechpartner#nachname) 00540 | Surname (family name) of the contact person | string | X | — |
|
**empfaenger** \* | — | object | Must | — |
|
[name1](/en/bo4e/202604/bo/Marktteilnehmer#name1) \* 00550 | First part of the name. This can hold the company name or, for private individuals,
the surname, for example. Examples: Yellow Strom GmbH
or Hagen | string | X | — |
|
[rollencodenummer](/en/bo4e/202604/bo/Marktteilnehmer#rollencodenummer) \* 00560 | Specifies the code value of the market role. | string | X | — |
|
[rollencodetyp](/en/bo4e/202604/bo/Marktteilnehmer#rollencodetyp) \* 00570 | Indicates the type of the code. | [Enum Rollencodetyp](/en/bo4e/202604/enum/Rollencodetyp) | X | — |
|
`BDEW` | — | — | X | — |
|
`GS1` | — | — | X | — |
|
`GLN` | — | — | X | — |
|
`DVGW` | — | — | X | — |
|
[steuernummer](/en/bo4e/202604/bo/Marktteilnehmer#steuernummer) 00580 | The tax number ID of the business partner. Example: 30120345678 | string | Must | — |
|
[umsatzsteuerId](/en/bo4e/202604/bo/Marktteilnehmer#umsatzsteuerid) 00590 | The VAT ID of the business partner. Example: DE 813281825 | string | Must | — |
| Structure (EDIFACT) | Description | Format | 31002 | Condition |
|---|---|---|---|---|
| **UNH** | — | — | Must | — |
| `0062`00010 | Message reference number | — | X | — |
| `0065 INVOIC`00020 | Invoice | — | X | — |
| `0052 D`00030 | Draft version | — | X | — |
| `0054 06A`00040 | Edition 2006 - A | — | X | — |
| `0051 UN`00050 | UN/CEFACT | — | X | — |
| `0057 2.8e`00060 | — | — | X | — |
| **BGM** | — | — | Must | — |
| `1001 380`00070 | Commercial invoice | — | X | — |
| `1004`00080 | Document number | — | X | — |
| `1225 7`00090 | Duplicate | — | X | — |
| `1225 9`00100 | Original | — | X | — |
| **DTM** | — | — | Must | — |
| `2005 137`00110 | Document/message date/time | — | X | — |
| `2380`00120 | Date or time or time span, value | — | X | [931] |
| `2379 303`00130 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **DTM** | — | — | Must | — |
| `2005 9`00140 | Handling / processing date / time | — | X | — |
| `2380`00150 | Date or time or time span, value | — | X | [931] |
| `2379 303`00160 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **DTM** | — | — | Must | — |
| `2005 155`00170 | Invoicing period, start date | — | X | — |
| `2380`00180 | Date or time or time span, value | — | X | [UB3] |
| `2379 303`00190 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **DTM** | — | — | Must | — |
| `2005 156`00200 | Invoicing period, end date | — | X | — |
| `2380`00210 | Date or time or time span, value | — | X | [UB3] |
| `2379 303`00220 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **IMD** | — | — | Must | — |
| `7081 ABR`00230 | Final invoice | — | X | — |
| `7081 JVR`00240 | Periodic invoice | — | X | — |
| `7081 MVR`00250 | Monthly invoice | — | X | — |
| `7081 ZVR`00260 | Interim invoice | — | X | — |
| `7081 13I`00270 | Integrated 13th invoice | — | X | — |
| `7081 13R`00280 | 13. Invoice | — | X | [493] ∨ [57] |
| `7081 SOR`00290 | Special invoice | — | X | [492] ∧ [56] |
| **FTX** | — | — | Should | [4] |
| `4451 REG`00300 | Notification information | — | X | — |
| `4441 RCH`00310 | Reverse Charge in accordance with §13b UStG / tax liability of the service recipient | — | X | — |
| **GEI** | — | — | Must | [41] |
| `9649 Z01`00320 | Type of special invoice | — | X | — |
| `7365 Z01`00330 | Concession levy (attestation) | — | X | [78] ∧ [83] |
| `7365 Z02`00340 | Individual agreement for atypical and energy-intensive grid usage | — | X | — |
| `7365 Z03`00350 | Individual agreement for singular grid usage | — | X | — |
| `7365 Z04`00360 | KWKG levy | — | X | [79] |
| `7365 Z05`00370 | Offshore grid levy | — | X | [79] |
| `7365 Z06`00380 | § 19 StromNEV levy | — | X | — |
| `7365 Z07`00390 | §18 AbLaV | — | X | — |
| `7365 Z08`00400 | Concession levy (switch to load curve metering) | — | X | [80] ∧ [83] |
| `7365 Z09`00410 | Privileging under the EnFG | — | X | [81] ∧ [82] |
| `7365 Z10`00420 | Concession levy (forwarded quantities) | — | X | [78] ∧ [80] |
| **SG1.RFF** | — | — | Must | — |
| `1153 Z13`00430 | Check identifier | — | X | — |
| `1154 31002`00440 | NN invoice | — | X | — |
| **SG1.RFF** | — | — | Must | — |
| `1153 OI`00450 | Original invoice number | — | X | — |
| `1154`00460 | Reference, identification | — | X | — |
| **SG1.DTM** | — | — | Must | — |
| `2005 171`00470 | Reference date/time | — | X | — |
| `2380`00480 | Date or time or time span, value | — | X | — |
| `2379 303`00490 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **SG1.RFF** | — | — | Must | — |
| `1153 ACE`00500 | Number of the associated document | — | X | — |
| `1154`00510 | Reference, identification | — | X | [514] |
| **SG1.RFF** | — | — | Must | — |
| `1153 Z56`00520 | Prices of the grid operator | — | X | — |
| `1154`00530 | MP-ID | — | X | — |
| **SG2.NAD** | — | — | Must | — |
| `3035 MS`00540 | Document-/ message sender or sender | — | X | — |
| `3039`00550 | MP-ID | — | X | — |
| `3055 9`00560 | GS1 | — | X | — |
| `3055 293`00570 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| `3055 332`00580 | DE, DVGW Service & Consult GmbH | — | X | — |
| `3036`00590 | Party involved | — | X | — |
| `3045 Z01`00600 | Structure of person names | — | X | — |
| `3045 Z02`00610 | Structure of the company name | — | X | — |
| `3042`00620 | Street and house number or PO box | — | — | S [7] |
| `3164`00630 | City | — | — | — |
| `3251`00640 | Postal code, code | — | X | — |
| `3207`00650 | Country name, code | — | X | — |
| **SG3.RFF** | — | — | Must | — |
| `1153 VA`00660 | Value added tax number | — | X | — |
| `1153 FC`00670 | Tax number | — | X | [6] |
| `1154`00680 | Reference, identification | — | X | — |
| **SG5.CTA** | — | — | Must | — |
| `3139 IC`00690 | Information contact | — | X | — |
| `3412`00700 | Contact | — | X | — |
| **SG5.COM** | — | — | Must | — |
| `3148`00710 | Communication address, identification | — | X | (([939] [74]) ∨ ([940][75])) ∧ [524] |
| `3155 EM`00720 | Electronic mail | — | X | [1P0..1] |
| `3155 FX`00730 | Fax number | — | X | [1P0..1] |
| `3155 TE`00740 | Telephone | — | X | [1P0..1] |
| `3155 AJ`00750 | further telephone | — | X | [1P0..1] |
| `3155 AL`00760 | Mobile phone | — | X | [1P0..1] |
| **SG2.NAD** | — | — | Must | — |
| `3035 MR`00770 | Message recipient | — | X | — |
| `3039`00780 | MP-ID | — | X | — |
| `3055 9`00790 | GS1 | — | X | — |
| `3055 293`00800 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
| `3055 332`00810 | DE, DVGW Service & Consult GmbH | — | X | — |
| `3036`00820 | Party involved | — | X | — |
| `3045 Z01`00830 | Structure of person names | — | X | — |
| `3045 Z02`00840 | Structure of the company name | — | X | — |
| `3042`00850 | Street and house number or PO box | — | — | S [7] |
| `3164`00860 | City | — | — | — |
| `3251`00870 | Postal code, code | — | X | — |
| `3207`00880 | Country name, code | — | X | — |
| **SG3.RFF** | — | — | Must | — |
| `1153 VA`00890 | Value added tax number | — | X | — |
| `1153 FC`00900 | Tax number | — | X | [6] |
| `1154`00910 | Reference, identification | — | X | — |
| **SG2.NAD** | — | — | Must | — |
| `3035 DP`00920 | Supply address | — | X | — |
| `3124`00930 | Additional information for identification | — | — | — |
| `3042`00940 | Street and house number or PO box | — | — | S [22] M [23] |
| `3164`00950 | City | — | — | — |
| `3251`00960 | Postal code, code | — | X | — |
| `3207`00970 | Country name, code | — | X | — |
| **SG2.LOC** | — | — | Must | — |
| `3227 172`00980 | Reporting point | — | X | — |
| `3225`00990 | Location, number | — | X | [950] [509] |
| **SG7.CUX** | — | — | Must | — |
| `6347 2`01000 | Reference currency | — | X | — |
| `6345 EUR`01010 | Euro | — | X | — |
| `6343 4`01020 | Currency of the invoice | — | X | — |
| **SG8.PYT** | — | — | Must | — |
| `4279 3`01030 | Fixed date | — | X | — |
| **SG8.DTM** | — | — | Must | — |
| `2005 265`01040 | Due date | — | X | — |
| `2380`01050 | Date or time or time span, value | — | X | [UB1] ∧ (([493] ∧ [20] ∧ [24]) ⊻ ([493] ∧ [21] ∧ [25]) ⊻ [492]) |
| `2379 303`01060 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **SG26.LIN** | — | — | Must | — |
| `1082`01070 | Line item number | — | X | [911] |
| `7140`01080 | Product/service number | — | X | ([50] ∧ ([67] ⊻ [68])) ⊻ ([41] ∧ ([67] ⊻ [68] ⊻ [69])) |
| `7143 Z01`01090 | Article number | — | X | [493] ⊻ ([492] ∧ [51]) |
| `7143 Z09`01100 | Article ID | — | X | [492] ∧ [59] |
| **SG26.QTY** | — | — | Must | — |
| `6063 47`01110 | Calculated (invoiced) quantity | — | X | — |
| `6060`01120 | Quantity | — | X | [910] ∧ [906] |
| `6411 KWH`01130 | Kilowatt hour | — | X | — |
| `6411 KWT`01140 | Kilowatt | — | X | — |
| `6411 KVR`01150 | kilovar | — | X | [492] ∧ [51] |
| `6411 K3`01160 | kilovolt ampere reactive hour | — | X | [492] ∧ [51] |
| `6411 H87`01170 | Piece | — | X | — |
| **SG26.QTY** | — | — | Should | [8] |
| `6063 136`01180 | Quantity reached in the time interval | — | X | — |
| `6060`01190 | Quantity | — | X | [908] [85] ⊻ [914] [86] |
| `6411 DAY`01200 | Day | — | X | — |
| `6411 MON`01210 | Month | — | X | [51] ∨ [493] |
| `6411 ANN`01220 | Year | — | X | [51] ∨ [493] |
| **SG26.DTM** | — | — | Must | — |
| `2005 155`01230 | Invoicing period, start date | — | X | — |
| `2380`01240 | Date or time or time span, value | — | X | [UB3] |
| `2379 303`01250 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **SG26.DTM** | — | — | Must | — |
| `2005 156`01260 | Invoicing period, end date | — | X | — |
| `2380`01270 | Date or time or time span, value | — | X | [UB3] |
| `2379 303`01280 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **SG27.MOA** | — | — | Must | — |
| `5025 203`01290 | Line item amount (excluding VAT) | — | X | — |
| `5004`01300 | Monetary amount | — | X | [930] |
| **SG27.MOA** | — | — | Must | — |
| `5025 131`01310 | Total surcharge or discount amount | — | X | — |
| `5004`01320 | Monetary amount | — | X | [930] |
| **SG29.PRI** | — | — | Must | — |
| `5125 CAL`01330 | Calculation price | — | X | — |
| `5118`01340 | Price, amount | — | X | [946] |
| `6411 DAY`01350 | Day | — | X | [12] |
| `6411 MON`01360 | Month | — | X | [12] ∧ ([51] ∨ [493]) |
| `6411 ANN`01370 | Year | — | X | [12] ∧ ([51] ∨ [493]) |
| **SG34.TAX** | — | — | Must | — |
| `5283 7`01380 | Tax | — | X | — |
| `5153 VAT`01390 | Value added tax | — | X | — |
| `5278`01400 | Duty/tax/fee rate | — | X | [902] ∧ [930] |
| `5305 S`01410 | Standard rate (standard) | — | X | — |
| `5305 O`01420 | not controllable | — | X | — |
| `5305 AE`01430 | Reverse Charge / tax liability of the service recipient | — | X | — |
| **SG39.ALC** | — | — | Must | — |
| `5463 A`01440 | Instalment payment | — | X | — |
| `5189 Z01`01450 | Municipal discount under the Concession Levy Ordinance | — | X | — |
| `5189 Z04`01460 | Adjustment under § 19, paragraph 2 Stromnetzentgeltver ordnung | — | X | — |
| **SG41.PCD** | — | — | Must | — |
| `5245 3`01470 | Surcharge or discount | — | X | — |
| `5482`01480 | Percentage | — | X | [914] ∧ [930] |
| **SG42.MOA** | — | — | Must | — |
| `5025 25`01490 | Surcharge/discount basis | — | X | — |
| `5004`01500 | Monetary amount | — | X | [930] [512] |
| **SG42.MOA** | — | — | Must | — |
| `5025 Z01`01510 | Municipal discount | — | X | — |
| `5004`01520 | Monetary amount | — | X | [930] [513] |
| **SG39.ALC** | — | — | Must | — |
| `5463 C`01530 | Surcharge | — | X | — |
| `5189 Z02`01540 | Transformation surcharge | — | X | [29] |
| `5189 Z03`01550 | equipment used exclusively pursuant to § 19, paragraph 3 Stromnetzentgeltverordnung | — | X | — |
| `5189 Z04`01560 | Adjustment under § 19, paragraph 2 Stromnetzentgeltver ordnung | — | X | — |
| `5189 Z05`01570 | Adjustment of the flat-rate grid fee reduction under § 14a EnWG to the level of the NNE | — | X | [525] |
| **SG41.PCD** | — | — | Must | — |
| `5245 3`01580 | Surcharge or discount | — | X | — |
| `5482`01590 | Percentage | — | X | [914] ∧ [930] |
| **UNS** | — | — | Must | — |
| `0081 S`01600 | Separation of detail and summary section | — | X | — |
| **SG50.MOA** | — | — | Must | — |
| `5025 77`01610 | Invoice amount | — | X | — |
| `5004`01620 | Monetary amount | — | X | [930] |
| **SG50.MOA** | — | — | Must | — |
| `5025 113`01630 | Prepaid amount (incl. VAT) | — | X | — |
| `5004`01640 | Monetary amount | — | X | [930] ∧ [526] |
| **SG51.RFF** | — | — | Must | — |
| `1153 AFL`01650 | Associated invoices | — | X | — |
| `1154`01660 | Reference, identification | — | X | — |
| **SG51.DTM** | — | — | Must | — |
| `2005 3`01670 | Invoice date/time | — | X | — |
| `2380`01680 | Date or time or time span, value | — | X | — |
| `2379 303`01690 | CCYYMMDDHHMMZ ZZ | — | X | — |
| **SG50.MOA** | — | — | Must | — |
| `5025 Z01`01700 | Municipal discount | — | X | — |
| `5004`01710 | Monetary amount | — | X | [930] |
| **SG50.MOA** | — | — | Must | — |
| `5025 9`01720 | Amount due (incl. VAT) | — | X | — |
| `5004`01730 | Monetary amount | — | X | [930] |
| **SG52.TAX** | — | — | Must | — |
| `5283 7`01740 | Tax | — | X | — |
| `5153 VAT`01750 | Value added tax | — | X | — |
| `5278`01760 | Duty/tax/fee rate | — | X | [902] ∧ [930] |
| `5305 S`01770 | Standard rate (standard) | — | X | — |
| `5305 O`01780 | not controllable | — | X | — |
| `5305 AE`01790 | Reverse Charge / tax liability of the service recipient | — | X | — |
| **SG52.MOA** | — | — | Should | [13] |
| `5025 113`01800 | Prepaid amount (incl. VAT) | — | X | — |
| `5004`01810 | Monetary amount | — | X | [930] |
| **SG52.MOA** | — | — | Must | [58] |
| `5025 115`01820 | Prepaid taxes (VAT share of the prepaid amount) | — | X | — |
| `5004`01830 | Monetary amount | — | X | [930] |
| **SG52.MOA** | — | — | Must | — |
| `5025 125`01840 | Taxable amount | — | X | — |
| `5004`01850 | Monetary amount | — | X | [930] |
| **SG52.MOA** | — | — | Must | — |
| `5025 161`01860 | Tax/fee/levy amount | — | X | — |
| `5004`01870 | Monetary amount | — | X | [930] |
| **UNT** | — | — | Must | — |
| `0074`01880 | Number of segments in a message | — | X | — |
| `0062`01890 | Message reference number | — | X | — |
### Conditions of this table
The free text of the 57 conditions referenced by the rows above. All conditions of the message type are listed in the [condition index INVOIC](/en/referenz/202604/ahb-bedingungen/INVOIC).
| Marker | Condition |
|---|---|
| **[4]** | If the tax liability of the service recipient applies |
| **[6]** | If NAD+MR DE3207 = „DE“ |
| **[7]** | Provided that no large-customer postcode is used |
| **[8]** | For time-dependent prices |
| **[12]** | If SG26 QTY+136 is present |
| **[13]** | If a prepaid amount exists |
| **[20]** | If amount due (SG50 MOA+9) ≥ 0 |
| **[21]** | If amount due (SG50 MOA+9) < 0 |
| **[22]** | If present |
| **[23]** | If DE3124 is not present in the same NAD |
| **[24]** | Value must be at least 10 WT after the value from DTM+137 DE2380 |
| **[25]** | Value must be no more than 10 WT after the value from DTM+137 DE2380 |
| **[29]** | [If DTM+155 (billing period start) not greater than 31.12.2015 |
| **[41]** | If IMD++SOR present |
| **[50]** | If IMD++SOR not present |
| **[51]** | If SG26 DTM+156 (item-related billing period end) ≤ 1.1.2023 0:00 German legal time |
| **[56]** | If DTM+137 (message date ≥ 1.1.2023 0: 00 German statutory time |
| **[57]** | If DTM+156 (billing period end) ≤ 1.1.2023 0:00 German statutory time |
| **[58]** | If MOA+113 is present in this SG52 |
| **[59]** | If SG26 DTM+155 (item-related billing period start) ≥ 1.1.2023 0: 00 German statutory time |
| **[67]** | Only the article numbers are permitted that have an „X“ for the corresponding check identifier in chapter 2 „Code list of article numbers“ of the code list of article numbers and article IDs. |
| **[68]** | Only the article IDs are permitted that have an „X“ in the column „INVOIC code usage“ in chapter 3 „Code list of group article IDs and article IDs“ of the code list of article numbers and article IDs. |
| **[69]** | Only the article IDs are permitted that have a „SOR“ in the column „INVOIC code usage“ in chapter 3 „Code list of group article IDs and article IDs“ of the code list of article numbers and article IDs. |
| **[74]** | if the code EM is present in DE3155 in the same COM |
| **[75]** | if the code TE / FX / AJ / AL is present in DE3155 in the same COM |
| **[78]** | If GEI+Z08 not present |
| **[79]** | If GEI+Z09 not present |
| **[80]** | If GEI+Z01 not present |
| **[81]** | If GEI+Z04 not present |
| **[82]** | If GEI+Z05 not present |
| **[83]** | If GEI+Z10 not present |
| **[85]** | If in this segment DE6411 = DAY |
| **[86]** | If in this segment DE6411 = MON/ANN |
| **[492]** | If MP-ID in NAD+MR (message recipient) from the Electricity division |
| **[493]** | If MP-ID in NAD+MR (message recipient) from the Gas division |
| **[509]** | Note: Use of the ID of the market location |
| **[512]** | Note: State here either the amount from MOA+203 or the amount from MOA+203 increased by the applicable tax amount. |
| **[513]** | Note: State here the result of the multiplication of MOA+25 by PCD+3. |
| **[514]** | Note: Document number of the delivery note MSCONS |
| **[524]** | Note: Only one piece of information may be transmitted in DE3148 |
| **[525]** | Note: Use if grid fees are lower than the flat-rate grid fee reduction |
| **[526]** | Note: The monetary amount specified here must be identical to the one stated in SG50 MOA+77 in DE5004 of the instalment invoice that has the invoice number named in this SG50 in SG51-RFF+AFL in DE1154. |
| **[902]** | Format: Possible value: ≥ 0 |
| **[906]** | Format: max. 3 decimal places |
| **[908]** | Format: possible values: 1 to n |
| **[910]** | Format: Possible value: < 0 or ≥ 0 |
| **[911]** | Format: Possible values: 1 to n, starting at 1 for each message or segment group and ascending consecutively |
| **[914]** | Format: Possible value: > 0 |
| **[930]** | Format: max. 2 decimal places |
| **[931]** | Format: ZZZ = +00 |
| **[939]** | Format: the character string must contain the characters @ and . |
| **[940]** | Format: the character string must begin with the character + and may only be followed by digits |
| **[946]** | Format: max. 11 decimal places |
| **[950]** | Format: market location ID |
| **[UB3]** | ([931] ∧ [932] [492] ∧ [490]) ⊻ ([931] ∧ [933] [492] ∧ [491]) ⊻ ([931] ∧ [934] [493] ∧ [490]) ⊻ ([931] ∧ [935] [493] ∧ [491]) |
| **[1P0..1]** | Note: This is the standard package if no condition applies, e.g. in the COM segment. |
| **[UB1]** | ([931] ∧ [932] [490]) ⊻ ([931] ∧ [933] [491]) |
## Example message
### Example 1
```text title="EDIFACT"
UNA:+.? '
UNB+UNOC:3+9900321000005:500+9903790000002:500+{{date}}:{{time}}+152012'
UNH+806158+INVOIC:D:06A:UN:2.8e'
BGM+380+806158BGM+9'
DTM+137:202506050648?+00:303'
DTM+9:202305160648?+00:303'
DTM+155:202302282300?+00:303'
DTM+156:202303312200?+00:303'
IMD++ABR'
RFF+Z13:31002'
RFF+ACE:REF12345678910'
NAD+MS+9900321000005::293++Stadtwerke:::::Z02+Str.::9+Ort++11111+DE'
RFF+FC:12345678910'
CTA+IC+:Max Mustermann'
COM+max@mustermann.de:EM'
COM+?+02345678930:AJ'
COM+?+02345678910:FX'
COM+?+02345678920:TE'
COM+?+02345678940:AL'
NAD+MR+9903790000002::293++Lieferant:::::Z02+Str.::1+Ort++33333+DE'
NAD+DP++++Str.::1+Ort++12345+DE'
LOC+172+50074561188'
CUX+2:EUR:4'
PYT+3'
DTM+265:202306052200?+00:303'
LIN+1++1-02-0-001:Z09'
QTY+47:1:H87'
QTY+136:30:DAY'
DTM+155:202302282300?+00:303'
DTM+156:202303312200?+00:303'
MOA+203:1000'
PRI+CAL:30::::DAY'
TAX+7+VAT+++:::19+S'
LIN+2++1-02-0-001:Z09'
QTY+47:1:H87'
DTM+155:202302282300?+00:303'
DTM+156:202303312200?+00:303'
MOA+203:1000'
PRI+CAL:30'
TAX+7+VAT+++:::19+S'
ALC+A+:Z01'
PCD+3:10'
MOA+25:1000'
MOA+Z01:100'
UNS+S'
MOA+77:2000'
MOA+Z01:10'
MOA+9:2400'
TAX+7+VAT+++:::19+S'
MOA+125:2000'
MOA+161:400'
UNT+50+806158'
UNZ+1+152012'
```
```json title="BO4E-JSON"
[
{
"businessKey": "",
"processDate": null,
"dataSource": "OUTBOUND",
"version": 1,
"edifactVersion": 202604,
"data": {
"stammdaten": {
"MARKTLOKATION": [
{
"boTyp": "MARKTLOKATION",
"versionStruktur": "1",
"marktlokationsId": "50074561188",
"sparte": "STROM",
"lokationsadresse": {
"postleitzahl": "12345",
"ort": "Ort",
"strasse": "Str.",
"hausnummer": "1",
"landescode": "DE"
}
}
],
"RECHNUNG": [
{
"boTyp": "RECHNUNG",
"versionStruktur": "1",
"rechnungsstatus": "ORIGINAL",
"storno": false,
"rechnungsdatum": "2025-06-05T06:48:00Z",
"istSelbstausgestellt": false,
"bearbeitungsdatum": "2023-05-16T06:48:00Z",
"referenzDokumentennummer": "REF12345678910",
"rechnungsperiode": {
"startdatum": "2023-02-28T23:00:00Z",
"enddatum": "2023-03-31T22:00:00Z"
},
"faelligkeitsdatum": "2023-06-05T22:00:00Z",
"rechnungspositionen": [
{
"positionsnummer": 1,
"artikelnummer": "1-02-0-001",
"positionsMenge": {
"wert": 1,
"einheit": "STUECK"
},
"zeitbezogeneMenge": {
"wert": 30,
"einheit": "TAG"
},
"lieferungVon": "2023-02-28T23:00:00Z",
"lieferungBis": "2023-03-31T22:00:00Z",
"teilsummeNetto": {
"wert": 1000,
"waehrung": "EUR"
},
"einzelpreis": {
"wert": 30,
"waehrung": "EUR",
"bezugswert": "TAG"
},
"teilsummeSteuer": {
"steuerkennzeichen": "UST_19"
}
},
{
"positionsnummer": 2,
"artikelnummer": "1-02-0-001",
"positionsMenge": {
"wert": 1,
"einheit": "STUECK"
},
"lieferungVon": "2023-02-28T23:00:00Z",
"lieferungBis": "2023-03-31T22:00:00Z",
"teilsummeNetto": {
"wert": 1000,
"waehrung": "EUR"
},
"einzelpreis": {
"wert": 30,
"waehrung": "EUR",
"bezugswert": "TAG"
},
"teilsummeSteuer": {
"steuerkennzeichen": "UST_19"
},
"abschlag": {
"typ": "GEMEINDERABATT_KAV",
"prozent": 10
},
"gemeinderabatt": {
"wert": 100,
"bemessungsgrundlage": 1000
}
}
],
"zuZahlen": {
"wert": 2400,
"waehrung": "EUR"
},
"steuerbetraege": [
{
"steuerkennzeichen": "UST_19",
"basiswert": 2000,
"steuerwert": 400,
"waehrung": "EUR"
}
],
"gesamtbrutto": {
"wert": 2000,
"waehrung": "EUR"
},
"rechnungstyp": "ABSCHLUSSRECHNUNG",
"gemeinderabatt": {
"wert": 10
}
}
]
},
"transaktionsdaten": {
"datenaustauschreferenz": "152012",
"sparte": "STROM",
"pruefidentifikator": "31002",
"absender": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"gewerbekennzeichnung": true,
"rollencodenummer": "9900321000005",
"rollencodetyp": "BDEW",
"name1": "Stadtwerke",
"steuernummer": "12345678910",
"partneradresse": {
"postleitzahl": "11111",
"ort": "Ort",
"strasse": "Str.",
"hausnummer": "9",
"landescode": "DE"
},
"ansprechpartner": {
"boTyp": "ANSPRECHPARTNER",
"versionStruktur": "1",
"nachname": "Max Mustermann",
"eMailAdresse": "max@mustermann.de",
"rufnummern": [
{
"nummerntyp": "RUF_ZENTRALE",
"rufnummer": "+02345678930"
},
{
"nummerntyp": "FAX_DURCHWAHL",
"rufnummer": "+02345678910"
},
{
"nummerntyp": "RUF_DURCHWAHL",
"rufnummer": "+02345678920"
},
{
"nummerntyp": "MOBIL_NUMMER",
"rufnummer": "+02345678940"
}
]
}
},
"empfaenger": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"gewerbekennzeichnung": true,
"rollencodenummer": "9903790000002",
"rollencodetyp": "BDEW",
"name1": "Lieferant",
"partneradresse": {
"postleitzahl": "33333",
"ort": "Ort",
"strasse": "Str.",
"hausnummer": "1",
"landescode": "DE"
}
},
"dokumentennummer": "806158BGM",
"kategorie": "380",
"nachrichtenreferenznummer": "806158"
},
"zusatzdaten": {}
}
}
]
```
*Source: [`1.edi`](https://github.com/conuti-gmbh/maco-edi-testfiles/blob/main/inbound/v202604/invoic/31002/1.edi) · [`1.json`](https://github.com/conuti-gmbh/maco-edi-testfiles/blob/main/outbound/v202604/invoic/31002/1.json)*
### Example 2
```text title="EDIFACT"
UNA:+.? '
UNB+UNOC:3+9900321000005:500+9903790000002:500+{{date}}:{{time}}+156260'
UNH+332496+INVOIC:D:06A:UN:2.8e'
BGM+380+332496BGM+9'
DTM+137:202506051157?+00:303'
DTM+9:202402070648?+00:303'
DTM+155:202302282300?+00:303'
DTM+156:202303312200?+00:303'
IMD++SOR'
GEI+Z01+Z01'
RFF+Z13:31002'
RFF+OI:ABC12345678910'
DTM+171:202401012300?+00:303'
NAD+MS+9900321000005::293++Stadtwerke:::::Z02+Str::1+Ort++12345+DE'
RFF+FC:12345678910'
CTA+IC+:Max Mustermann'
COM+max@mustermann.de:EM'
COM+?+02345678930:FX'
NAD+MR+9903790000002::293++Lieferant:::::Z02+Str::1+Ort++12345+DE'
NAD+DP++Mustermann++Str::1+Ort++55555+DE'
LOC+172+50074561188'
CUX+2:EUR:4'
PYT+3'
DTM+265:202404042200?+00:303'
LIN+1++1-10-1-002:Z09'
QTY+47:1:H87'
QTY+136:30:DAY'
DTM+155:202302282300?+00:303'
DTM+156:202303312200?+00:303'
MOA+203:1000'
MOA+131:10'
PRI+CAL:1000::::DAY'
TAX+7+VAT+++:::19+S'
ALC+A+:Z01'
PCD+3:10'
MOA+25:1000'
MOA+Z01:10'
ALC+C+:Z05'
UNS+S'
MOA+77:1000'
MOA+Z01:10'
MOA+9:1000'
TAX+7+VAT+++:::19+S'
MOA+113:1000'
MOA+115:1000'
MOA+125:1000'
MOA+161:1000'
UNT+46+332496'
UNZ+1+156260'
```
```json title="BO4E-JSON"
[
{
"businessKey": "",
"processDate": null,
"dataSource": "OUTBOUND",
"version": 1,
"edifactVersion": 202604,
"data": {
"stammdaten": {
"MARKTLOKATION": [
{
"boTyp": "MARKTLOKATION",
"versionStruktur": "1",
"marktlokationsId": "50074561188",
"sparte": "STROM",
"lokationsadresse": {
"postleitzahl": "55555",
"ort": "Ort",
"strasse": "Str",
"hausnummer": "1",
"landescode": "DE",
"zusatzInformation": {
"zusatz1": "Mustermann"
}
}
}
],
"RECHNUNG": [
{
"boTyp": "RECHNUNG",
"versionStruktur": "1",
"rechnungsstatus": "ORIGINAL",
"storno": false,
"rechnungsdatum": "2025-06-05T11:57:00Z",
"faelligkeitsdatum": "2024-04-04T22:00:00Z",
"bearbeitungsdatum": "2024-02-07T06:48:00Z",
"originalRechnungsnummer": "ABC12345678910",
"referenzNachrichtendatum": "2024-01-01T23:00:00Z",
"rechnungsperiode": {
"startdatum": "2023-02-28T23:00:00Z",
"enddatum": "2023-03-31T22:00:00Z"
},
"gesamtbrutto": {
"wert": 1000,
"waehrung": "EUR"
},
"zuZahlen": {
"wert": 1000,
"waehrung": "EUR"
},
"steuerbetraege": [
{
"steuerkennzeichen": "UST_19",
"basiswert": 1000,
"steuerwert": 1000,
"waehrung": "EUR",
"basiswertVorausbezahlt": 1000,
"steuerwertVorausbezahlt": 1000
}
],
"sonderrechnungsarten": [
"KONZESSIONSABGABE_TESTAT"
],
"rechnungspositionen": [
{
"positionsnummer": 1,
"artikelnummer": "1-10-1-002",
"lieferungVon": "2023-02-28T23:00:00Z",
"lieferungBis": "2023-03-31T22:00:00Z",
"positionsMenge": {
"wert": 1,
"einheit": "STUECK"
},
"zeitbezogeneMenge": {
"wert": 30,
"einheit": "TAG"
},
"einzelpreis": {
"wert": 1000,
"waehrung": "EUR",
"bezugswert": "TAG"
},
"teilsummeNetto": {
"wert": 1000,
"waehrung": "EUR"
},
"teilsummeSteuer": {
"steuerkennzeichen": "UST_19"
},
"gesamtZuAbschlagsbetrag": 10,
"abschlag": {
"typ": "GEMEINDERABATT_KAV",
"prozent": 10
},
"zuschlag": {
"typ": "ANPASSUNG_PAUSCHALE_NETZENTGELTREDUZIERUNG_NACH_P14A_ENWG_AUF_HOEHE_DER_NNE"
},
"gemeinderabatt": {
"wert": 10,
"bemessungsgrundlage": 1000
}
}
],
"istSelbstausgestellt": false,
"rechnungstyp": "SONDERRECHNUNG",
"vorauszahlungen": {
"betrag": {
"wert": 1000,
"waehrung": "EUR"
}
},
"gemeinderabatt": {
"wert": 10
}
}
]
},
"transaktionsdaten": {
"datenaustauschreferenz": "156260",
"sparte": "STROM",
"pruefidentifikator": "31002",
"absender": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9900321000005",
"rollencodetyp": "BDEW",
"name1": "Stadtwerke",
"gewerbekennzeichnung": true,
"steuernummer": "12345678910",
"partneradresse": {
"postleitzahl": "12345",
"ort": "Ort",
"strasse": "Str",
"hausnummer": "1",
"landescode": "DE"
},
"ansprechpartner": {
"boTyp": "ANSPRECHPARTNER",
"versionStruktur": "1",
"nachname": "Max Mustermann",
"eMailAdresse": "max@mustermann.de",
"rufnummern": [
{
"nummerntyp": "FAX_DURCHWAHL",
"rufnummer": "+02345678930"
}
]
}
},
"empfaenger": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"rollencodenummer": "9903790000002",
"rollencodetyp": "BDEW",
"name1": "Lieferant",
"gewerbekennzeichnung": true,
"partneradresse": {
"postleitzahl": "12345",
"ort": "Ort",
"strasse": "Str",
"hausnummer": "1",
"landescode": "DE"
}
},
"dokumentennummer": "332496BGM",
"kategorie": "380",
"nachrichtenfunktion": "9",
"nachrichtenreferenznummer": "332496"
},
"zusatzdaten": {}
}
}
]
```
*Source: [`2.edi`](https://github.com/conuti-gmbh/maco-edi-testfiles/blob/main/inbound/v202604/invoic/31002/2.edi) · [`2.json`](https://github.com/conuti-gmbh/maco-edi-testfiles/blob/main/outbound/v202604/invoic/31002/2.json)*
### Example 3
```text title="EDIFACT"
UNA:+.? '
UNB+UNOC:3+9900683000008:500+9979052000006:500+{{date}}:{{time}}+ML8O8CII'
UNH+UNHMLKD41XU+INVOIC:D:06A:UN:2.8e'
BGM+380+BGMMLPQOZ7X+9'
DTM+137:202510010357?+00:303'
DTM+9:202506051157?+00:303'
DTM+155:202602282300?+00:303'
DTM+156:202603312200?+00:303'
IMD++SOR'
GEI+Z01+Z10'
GEI+Z01+Z02'
RFF+Z13:31002'
RFF+OI:ABC12345678910'
DTM+171:202401012300?+00:303'
RFF+Z56:9907165000001'
NAD+MS+9900683000008::293++Stadtwerke:::::Z02+Str::1+Ort++12345+DE'
RFF+FC:12345678910'
CTA+IC+:Max Mustermann'
COM+max@mustermann.de:EM'
NAD+MR+9979052000006::293++Lieferant:::::Z02+Str::1+Ort++12345+DE'
NAD+DP++Mustermann++Str::1+Ort++55555+DE'
LOC+172+50074561188'
CUX+2:EUR:4'
PYT+3'
DTM+265:202404042200?+00:303'
LIN+1++1-10-1-002:Z09'
QTY+47:1:H87'
QTY+136:30:DAY'
DTM+155:202602282300?+00:303'
DTM+156:202603312200?+00:303'
MOA+203:1000'
MOA+131:10'
PRI+CAL:1000::::DAY'
TAX+7+VAT+++:::19+S'
ALC+A+:Z01'
PCD+3:10'
MOA+25:1000'
MOA+Z01:10'
ALC+C+:Z05'
UNS+S'
MOA+77:1000'
MOA+Z01:10'
MOA+9:1000'
TAX+7+VAT+++:::19+S'
MOA+113:1000'
MOA+115:1000'
MOA+125:1000'
MOA+161:1000'
UNT+47+UNHMLKD41XU'
UNZ+1+ML8O8CII'
```
```json title="BO4E-JSON"
[
{
"businessKey": "",
"processDate": null,
"dataSource": "OUTBOUND",
"version": 1,
"edifactVersion": 202604,
"data": {
"stammdaten": {
"MARKTLOKATION": [
{
"boTyp": "MARKTLOKATION",
"versionStruktur": "1",
"marktlokationsId": "50074561188",
"marktlokationsTyp": [
{
"typ": "STANDARD_MARKTLOKATION"
}
],
"sparte": "STROM",
"lokationsadresse": {
"postleitzahl": "55555",
"ort": "Ort",
"strasse": "Str",
"hausnummer": "1",
"landescode": "DE",
"zusatzInformation": {
"zusatz1": "Mustermann"
}
}
}
],
"RECHNUNG": [
{
"boTyp": "RECHNUNG",
"versionStruktur": "1",
"rechnungsstatus": "ORIGINAL",
"storno": false,
"rechnungsdatum": "2025-10-01T03:57:00Z",
"faelligkeitsdatum": "2024-04-04T22:00:00Z",
"bearbeitungsdatum": "2025-06-05T11:57:00Z",
"originalRechnungsnummer": "ABC12345678910",
"referenzNachrichtendatum": "2024-01-01T23:00:00Z",
"rechnungsperiode": {
"startdatum": "2026-02-28T23:00:00Z",
"enddatum": "2026-03-31T22:00:00Z"
},
"gesamtbrutto": {
"wert": 1000,
"waehrung": "EUR"
},
"zuZahlen": {
"wert": 1000,
"waehrung": "EUR"
},
"steuerbetraege": [
{
"steuerkennzeichen": "UST_19",
"basiswert": 1000,
"steuerwert": 1000,
"waehrung": "EUR",
"basiswertVorausbezahlt": 1000,
"steuerwertVorausbezahlt": 1000
}
],
"sonderrechnungsarten": [
"KONZESSIONSABGABE_WEITERGELEITETE_MENGEN",
"INDIVIDUELL_ATYPISCH"
],
"rechnungspositionen": [
{
"positionsnummer": 1,
"artikelnummer": "1-10-1-002",
"lieferungVon": "2026-02-28T23:00:00Z",
"lieferungBis": "2026-03-31T22:00:00Z",
"positionsMenge": {
"wert": 1,
"einheit": "STUECK"
},
"zeitbezogeneMenge": {
"wert": 30,
"einheit": "TAG"
},
"einzelpreis": {
"wert": 1000,
"waehrung": "EUR",
"bezugswert": "TAG"
},
"teilsummeNetto": {
"wert": 1000,
"waehrung": "EUR"
},
"teilsummeSteuer": {
"steuerkennzeichen": "UST_19"
},
"gesamtZuAbschlagsbetrag": 10,
"abschlag": {
"typ": "GEMEINDERABATT_KAV",
"prozent": 10
},
"zuschlag": {
"typ": "ANPASSUNG_PAUSCHALE_NETZENTGELTREDUZIERUNG_NACH_P14A_ENWG_AUF_HOEHE_DER_NNE"
},
"gemeinderabatt": {
"wert": 10,
"bemessungsgrundlage": 1000
}
}
],
"istSelbstausgestellt": false,
"rechnungstyp": "SONDERRECHNUNG",
"vorauszahlungen": {
"betrag": {
"wert": 1000,
"waehrung": "EUR"
}
},
"gemeinderabatt": {
"wert": 10
},
"preisNetzbetreiberCodenummer": "9907165000001"
}
]
},
"transaktionsdaten": {
"datenaustauschreferenz": "ML8O8CII",
"sparte": "STROM",
"pruefidentifikator": "31002",
"absender": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"gewerbekennzeichnung": true,
"rollencodenummer": "9900683000008",
"rollencodetyp": "BDEW",
"name1": "Stadtwerke",
"steuernummer": "12345678910",
"partneradresse": {
"postleitzahl": "12345",
"ort": "Ort",
"strasse": "Str",
"hausnummer": "1",
"landescode": "DE"
},
"ansprechpartner": {
"boTyp": "ANSPRECHPARTNER",
"versionStruktur": "1",
"nachname": "Max Mustermann",
"eMailAdresse": "max@mustermann.de"
}
},
"empfaenger": {
"boTyp": "MARKTTEILNEHMER",
"versionStruktur": "1",
"gewerbekennzeichnung": true,
"rollencodenummer": "9979052000006",
"rollencodetyp": "BDEW",
"name1": "Lieferant",
"partneradresse": {
"postleitzahl": "12345",
"ort": "Ort",
"strasse": "Str",
"hausnummer": "1",
"landescode": "DE"
}
},
"dokumentennummer": "BGMMLPQOZ7X",
"kategorie": "380",
"nachrichtenfunktion": "9",
"nachrichtendatum": "2025-10-01T03:57:00Z",
"nachrichtenreferenznummer": "UNHMLKD41XU"
},
"zusatzdaten": {}
}
}
]
```
*Source: [`3.edi`](https://github.com/conuti-gmbh/maco-edi-testfiles/blob/main/inbound/v202604/invoic/31002/3.edi) · [`3.json`](https://github.com/conuti-gmbh/maco-edi-testfiles/blob/main/outbound/v202604/invoic/31002/3.json)*
## Belongs to these role views
The check identifier itself carries no market role. This assignment is derived back from the role views in whose process steps it occurs — affected are **LF** and **NB**.
| Role | Party involved | Process | Rulebook | Division | Step |
|---|---|---|---|---|---|
| LF | LF | [Grid usage settlement](/en/prozessdoku/202604/LF/GPKE-Teil2-netznutzungsabrechnung) | GPKE part 2 | Electricity | Step 1 |
| LF | LF | [Billing of grid usage](/en/prozessdoku/202604/LF/geli-gas-2-0-abrechnung-der-netznutzung) | GeLi Gas 2.0 | Gas | Step 2 |
| NB | NB | [Grid usage settlement](/en/prozessdoku/202604/NB/GPKE-Teil2-netznutzungsabrechnung) | GPKE part 2 | Electricity | Step 1 |
| NB | NB | [Billing of grid usage](/en/prozessdoku/202604/NB/geli-gas-2-0-abrechnung-der-netznutzung) | GeLi Gas 2.0 | Gas | Step 2 |
## Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | NN invoice |
| AHB | INVOIC AHB |
| Transmission channel | AS4 |
:::caution{title="This check identifier is used in 3 contexts"}
Regulatory determination and communication direction depend on the process in which the message is sent. A single entry would be misleading — all placements are therefore listed here.
:::
| Process description / rulebook | Process step | Communication | Action |
|---|---|---|---|
| GPKE part 2 | Grid usage settlement | NB → LF | Grid usage invoice |
| GeLi Gas 2.0 | Billing of grid usage | NB → LF | Grid usage invoice |
| GeLi Gas | Ch. D 4.3 No. 2 | NB → LF | Billing of grid usage |
## Transaction and responses
**Role of this check identifier: request.** Basis: the transaction data carry neither `antwortstatus` nor `antwortstatusCodeliste`, and neither the title nor the action of the Prüfi table begins with “response” or “response message”.
### Which messages respond to this
| Role | Check identifier | Use case | Message type | Origin of supply |
|---|---|---|---|---|
| Response | [33001](/schnittstellen/202604/pruefi/REMADV/PI_33001) | Confirmation | REMADV | from the step sequence |
| Response | [33002](/schnittstellen/202604/pruefi/REMADV/PI_33002) | Refusal | REMADV | from the step sequence |
| Response | [33003](/schnittstellen/202604/pruefi/REMADV/PI_33003) | Electricity refusal header and total | REMADV | from the step sequence |
| Response | [33004](/schnittstellen/202604/pruefi/REMADV/PI_33004) | Electricity refusal line item | REMADV | from the step sequence |
This column is the **inverse** of the assignment on the response pages — not the next step of a list. The process source says of its own steps that they are »possible messages, not a sequence«.
**Check identifiers of the same AHB table:** No other check identifier of message type INVOIC has the same row structure in this version.
:::note{title="Editorial — not derived from a source"}
**How an invoice names earlier documents.** A correcting invoice cites the original one via `RFF+OI` (original invoice number), in the JSON `originalRechnungsnummer` (`SG1.RFF+OI`); its date is in `referenzNachrichtendatum` (`SG1.RFF+OI.DTM+171`). The number of a related document is in `referenzDokumentennummer` (`SG1.RFF+ACE`); earlier invoices whose prepaid amounts the invoice offsets are in `referenzVorgaengerrechnung` (`SG50.MOA+113.SG51.RFF+AFL`). Examples from the test set: `RFF+ACE:REF12345678910` (31002, test case 1), `RFF+OI:ABC12345678910` with `MOA+113:1000` (31002, test case 2). The cancellation invoice (31004) names the cancelled invoice the same way: in the test case `31004_eingehend_Testfall1` there is `RFF+OI:REF12345678910`, in the JSON `storno` is set to `true` and `originalRechnungsnummer` to `REF12345678910`.
**Source:** INVOIC AHB (Knowledge Collection ahb/202604/INVOIC/31002.json, SG1 RFF+OI, SG1 RFF+ACE and SG51 RFF+AFL); specification PI_31002; test set maco-edi-testfiles, inbound/v202404/INVOIC: 31002_eingehend_Testfall1.edi and Testfall2.edi, 31004_eingehend_Testfall1.edi and .json · **As of:** 2026-09-23 · **Applies to format version:** 202604 · **To be reviewed by:** 2027-04-01
:::
An **\*** after a field or group name marks a **mandatory field** or a mandatory group. The type is beside it; where the value ends up in the EDIFACT segment is shown by the info icon next to the field name.
The status column carries two vocabularies because the manual answers two questions: on a **group row**, *Muss*, *Soll* or *Kann* states whether the EDIFACT segment must be present; on a **field row**, *X* states that this qualifier is used in this check identifier. Both are kept exactly as the source records them.
For this check identifier, the application handbook lists **242 rows**. They appear in the order of the handbook, indented by segment: a row without a data element opens a segment, the rows below it are its data elements.
The **Condition** column names the markers under which the handbook ties a row to a prerequisite; their free text is below the table.
The test data contains 3 transactions for this check identifier under the message type `invoic`. Each is stored twice — as a EDIFACT message and as a BO4E JSON. That both representations show the same transaction has been recalculated, not assumed: interchange control reference, message reference number, document number, message date, sender and recipient match in all 517 pairs of the format version; check identifier, transaction number and location ID wherever both representations carry them. Not a single attribute contradicts.
:::note{title="Placeholder from the test data set"}
The test data set carries placeholders instead of valid values: `{{date}}` and `{{time}}` in the UNB interchange envelope of every EDIFACT file. **The page replaces these on call with the current date and the current time** — in the format that applies at the respective position: in the envelope year, month and day as well as hour and minute, two digits each.
`` stays in place. It is not a time value, and an invented key would look like a valid one.
:::