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 * 00010 | The address at which the energy delivery or feed-in takes place. | Adresse | X | — |
| marktlokationsId * 00020 | Identification number of a market location at which energy is either consumed or generated | string | X | — |
| RECHNUNG [ ] * | — | object[] | Must | — |
| bearbeitungsdatum * 00030 | bearbeitungsdatum | string (date-time) | X | — |
| datumVorgaengerrechnung 00040 | datumVorgaengerrechnung | string (date-time) | X | — |
| faelligkeitsdatum * 00050 | Payment is due on this date. | string (date-time) | X | — |
| istReverseCharge 00060 | Indicator whether the reverse charge procedure is applied to the invoice | boolean | Should | [4] |
| originalRechnungsnummer 00070 | In the case of a cancellation invoice (storno = true), this contains the invoice number of the cancelled invoice. | string | X | — |
| preisNetzbetreiberCodenummer 00080 | preisNetzbetreiberCodenummer | string | X | — |
| rechnungsdatum * 00090 | Issue date of the invoice. | string (date-time) | X | — |
| rechnungsstatus * 00100 | Status of the invoice indicating the processing stage. For details see ENUM invoice status | Enum Rechnungsstatus | X | — |
DUPLIKAT | — | — | X | — |
ORIGINAL | — | — | X | — |
STORNIERT | — | — | X | — |
| rechnungstyp * 00110 | A context-related invoice type, e.g. grid usage invoice. For details see ENUM Invoice type | 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 00120 | referenzDokumentennummer | string | X | — |
| referenzNachrichtendatum 00130 | referenzNachrichtendatum | string | X | — |
| referenzVorgaengerrechnung 00140 | referenzVorgaengerrechnung | string | X | — |
| sonderrechnungsarten 00150 | Special invoice type | array | X | — |
| gemeinderabatt | — | object | May | — |
| wert 00160 | Value | number (float) | X | — |
| gesamtbrutto * | — | object | Must | — |
| wert * 00170 | Specifies the amount of the price. | number (float) | X | — |
| rechnungsperiode * | — | object | Must | — |
| enddatum * 00180 | enddatum | string (date-time) | X | — |
| startdatum * 00190 | startdatum | string (date-time) | X | — |
| rechnungspositionen [ ] * | — | object[] | Must | — |
| artikelnummer * 00200 | Identification of the invoice line item with the standard article number of the BDEW. Details BDEW article number | string | Must | — |
| gesamtZuAbschlagsbetrag 00210 | gesamtZuAbschlagsbetrag | number (float) | X | — |
| lieferungBis * 00220 | End of the supply for the billed service. | string (date-time) | X | — |
| lieferungVon * 00230 | Start of supply for the billed service. | string (date-time) | X | — |
| positionsnummer * 00240 | Sequential number for the invoice line item. | integer | Must | — |
| abschlag | — | object | May | — |
| prozent 00250 | Percentage details of the surcharge/discount | number (float) | X | — |
| typ 00260 | AbschlagTyp | Enum AbschlagTyp | X | — |
GEMEINDERABATT_KAV | — | — | X | — |
ANPASSUNG_P19_STROM_NEV | — | — | X | — |
| einzelpreis * | — | object | Must | — |
| bezugswert 00270 | Unit: measurands that can be determined by measurement or by specification | 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 * 00280 | wert | number (float) | X | — |
| gemeinderabatt | — | object | May | — |
| bemessungsgrundlage 00290 | Assessment basis | number (float) | X | — |
| wert 00300 | Value | number (float) | X | — |
| positionsMenge * | — | object | Must | — |
| einheit * 00310 | Unit: measurands that can be determined by measurement or by specification | 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 * 00320 | Value | number (float) | X | — |
| teilsummeNetto * | — | object | Must | — |
| wert * 00330 | Specifies the amount of the price. | number (float) | X | — |
| teilsummeSteuer * | — | object | Must | — |
| steuerkennzeichen * 00340 | Identification of the tax rate or procedure. Details tax code | string | Must | — |
| zeitbezogeneMenge | — | object | May | — |
| einheit 00350 | Unit: measurands that can be determined by measurement or by specification | 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 00360 | Value | number (float) | X | — |
| zuschlag | — | object | May | — |
| prozent 00370 | prozent | number (float) | X | — |
| typ 00380 | Surcharge type | 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 * 00390 | Net amount on which the tax was calculated. E.g. 200 | number (float) | X | — |
| basiswertVorausbezahlt 00400 | basiswertVorausbezahlt | number (float) | X | — |
| steuerkennzeichen * 00410 | Identification of the tax rate or procedure. Details tax code | string | Must | — |
| steuerwert * 00420 | Tax calculated from the base value. E.g. 38 (at UST_19) if the base value is 200. | number (float) | X | — |
| steuerwertVorausbezahlt 00430 | steuerwertVorausbezahlt | number (float) | X | — |
| vorausgezahlt | — | object | May | — |
| wert 00440 | Specifies the amount of the price. | number (float) | X | — |
| zuZahlen * | — | object | Must | — |
| wert * 00450 | Specifies the amount of the price. | number (float) | X | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00460 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| nachrichtenreferenznummer * 00470 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00480 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| absender * | — | object | Must | — |
| 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 * 00500 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00510 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| steuernummer 00520 | The tax number ID of the business partner. Example: 30120345678 | string | Must | — |
| umsatzsteuerId 00530 | The VAT ID of the business partner. Example: DE 813281825 | string | Must | — |
| ansprechpartner | — | object | May | — |
| nachname 00540 | Surname (family name) of the contact person | string | X | — |
| empfaenger * | — | object | Must | — |
| 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 * 00560 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00570 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| steuernummer 00580 | The tax number ID of the business partner. Example: 30120345678 | string | Must | — |
| umsatzsteuerId 00590 | The VAT ID of the business partner. Example: DE 813281825 | string | Must | — |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 31002 | Condition |
|---|---|---|---|---|
| UNH | — | — | Must | — |
006200010 | Message reference number | — | X | — |
0065 INVOIC00020 | Invoice | — | X | — |
0052 D00030 | Draft version | — | X | — |
0054 06A00040 | Edition 2006 - A | — | X | — |
0051 UN00050 | UN/CEFACT | — | X | — |
0057 2.8e00060 | — | — | X | — |
| BGM | — | — | Must | — |
1001 38000070 | Commercial invoice | — | X | — |
100400080 | Document number | — | X | — |
1225 700090 | Duplicate | — | X | — |
1225 900100 | Original | — | X | — |
| DTM | — | — | Must | — |
2005 13700110 | Document/message date/time | — | X | — |
238000120 | Date or time or time span, value | — | X | [931] |
2379 30300130 | CCYYMMDDHHMMZ ZZ | — | X | — |
| DTM | — | — | Must | — |
2005 900140 | Handling / processing date / time | — | X | — |
238000150 | Date or time or time span, value | — | X | [931] |
2379 30300160 | CCYYMMDDHHMMZ ZZ | — | X | — |
| DTM | — | — | Must | — |
2005 15500170 | Invoicing period, start date | — | X | — |
238000180 | Date or time or time span, value | — | X | [UB3] |
2379 30300190 | CCYYMMDDHHMMZ ZZ | — | X | — |
| DTM | — | — | Must | — |
2005 15600200 | Invoicing period, end date | — | X | — |
238000210 | Date or time or time span, value | — | X | [UB3] |
2379 30300220 | CCYYMMDDHHMMZ ZZ | — | X | — |
| IMD | — | — | Must | — |
7081 ABR00230 | Final invoice | — | X | — |
7081 JVR00240 | Periodic invoice | — | X | — |
7081 MVR00250 | Monthly invoice | — | X | — |
7081 ZVR00260 | Interim invoice | — | X | — |
7081 13I00270 | Integrated 13th invoice | — | X | — |
7081 13R00280 | 13. Invoice | — | X | [493] ∨ [57] |
7081 SOR00290 | Special invoice | — | X | [492] ∧ [56] |
| FTX | — | — | Should | [4] |
4451 REG00300 | Notification information | — | X | — |
4441 RCH00310 | Reverse Charge in accordance with §13b UStG / tax liability of the service recipient | — | X | — |
| GEI | — | — | Must | [41] |
9649 Z0100320 | Type of special invoice | — | X | — |
7365 Z0100330 | Concession levy (attestation) | — | X | [78] ∧ [83] |
7365 Z0200340 | Individual agreement for atypical and energy-intensive grid usage | — | X | — |
7365 Z0300350 | Individual agreement for singular grid usage | — | X | — |
7365 Z0400360 | KWKG levy | — | X | [79] |
7365 Z0500370 | Offshore grid levy | — | X | [79] |
7365 Z0600380 | § 19 StromNEV levy | — | X | — |
7365 Z0700390 | §18 AbLaV | — | X | — |
7365 Z0800400 | Concession levy (switch to load curve metering) | — | X | [80] ∧ [83] |
7365 Z0900410 | Privileging under the EnFG | — | X | [81] ∧ [82] |
7365 Z1000420 | Concession levy (forwarded quantities) | — | X | [78] ∧ [80] |
| SG1.RFF | — | — | Must | — |
1153 Z1300430 | Check identifier | — | X | — |
1154 3100200440 | NN invoice | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 OI00450 | Original invoice number | — | X | — |
115400460 | Reference, identification | — | X | — |
| SG1.DTM | — | — | Must | — |
2005 17100470 | Reference date/time | — | X | — |
238000480 | Date or time or time span, value | — | X | — |
2379 30300490 | CCYYMMDDHHMMZ ZZ | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 ACE00500 | Number of the associated document | — | X | — |
115400510 | Reference, identification | — | X | [514] |
| SG1.RFF | — | — | Must | — |
1153 Z5600520 | Prices of the grid operator | — | X | — |
115400530 | MP-ID | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00540 | Document-/ message sender or sender | — | X | — |
303900550 | MP-ID | — | X | — |
3055 900560 | GS1 | — | X | — |
3055 29300570 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
3055 33200580 | DE, DVGW Service & Consult GmbH | — | X | — |
303600590 | Party involved | — | X | — |
3045 Z0100600 | Structure of person names | — | X | — |
3045 Z0200610 | Structure of the company name | — | X | — |
304200620 | Street and house number or PO box | — | — | S [7] |
316400630 | City | — | — | — |
325100640 | Postal code, code | — | X | — |
320700650 | Country name, code | — | X | — |
| SG3.RFF | — | — | Must | — |
1153 VA00660 | Value added tax number | — | X | — |
1153 FC00670 | Tax number | — | X | [6] |
115400680 | Reference, identification | — | X | — |
| SG5.CTA | — | — | Must | — |
3139 IC00690 | Information contact | — | X | — |
341200700 | Contact | — | X | — |
| SG5.COM | — | — | Must | — |
314800710 | Communication address, identification | — | X | (([939] [74]) ∨ ([940][75])) ∧ [524] |
3155 EM00720 | Electronic mail | — | X | [1P0..1] |
3155 FX00730 | Fax number | — | X | [1P0..1] |
3155 TE00740 | Telephone | — | X | [1P0..1] |
3155 AJ00750 | further telephone | — | X | [1P0..1] |
3155 AL00760 | Mobile phone | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00770 | Message recipient | — | X | — |
303900780 | MP-ID | — | X | — |
3055 900790 | GS1 | — | X | — |
3055 29300800 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
3055 33200810 | DE, DVGW Service & Consult GmbH | — | X | — |
303600820 | Party involved | — | X | — |
3045 Z0100830 | Structure of person names | — | X | — |
3045 Z0200840 | Structure of the company name | — | X | — |
304200850 | Street and house number or PO box | — | — | S [7] |
316400860 | City | — | — | — |
325100870 | Postal code, code | — | X | — |
320700880 | Country name, code | — | X | — |
| SG3.RFF | — | — | Must | — |
1153 VA00890 | Value added tax number | — | X | — |
1153 FC00900 | Tax number | — | X | [6] |
115400910 | Reference, identification | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00920 | Supply address | — | X | — |
312400930 | Additional information for identification | — | — | — |
304200940 | Street and house number or PO box | — | — | S [22] M [23] |
316400950 | City | — | — | — |
325100960 | Postal code, code | — | X | — |
320700970 | Country name, code | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200980 | Reporting point | — | X | — |
322500990 | Location, number | — | X | [950] [509] |
| SG7.CUX | — | — | Must | — |
6347 201000 | Reference currency | — | X | — |
6345 EUR01010 | Euro | — | X | — |
6343 401020 | Currency of the invoice | — | X | — |
| SG8.PYT | — | — | Must | — |
4279 301030 | Fixed date | — | X | — |
| SG8.DTM | — | — | Must | — |
2005 26501040 | Due date | — | X | — |
238001050 | Date or time or time span, value | — | X | [UB1] ∧ (([493] ∧ [20] ∧ [24]) ⊻ ([493] ∧ [21] ∧ [25]) ⊻ [492]) |
2379 30301060 | CCYYMMDDHHMMZ ZZ | — | X | — |
| SG26.LIN | — | — | Must | — |
108201070 | Line item number | — | X | [911] |
714001080 | Product/service number | — | X | ([50] ∧ ([67] ⊻ [68])) ⊻ ([41] ∧ ([67] ⊻ [68] ⊻ [69])) |
7143 Z0101090 | Article number | — | X | [493] ⊻ ([492] ∧ [51]) |
7143 Z0901100 | Article ID | — | X | [492] ∧ [59] |
| SG26.QTY | — | — | Must | — |
6063 4701110 | Calculated (invoiced) quantity | — | X | — |
606001120 | Quantity | — | X | [910] ∧ [906] |
6411 KWH01130 | Kilowatt hour | — | X | — |
6411 KWT01140 | Kilowatt | — | X | — |
6411 KVR01150 | kilovar | — | X | [492] ∧ [51] |
6411 K301160 | kilovolt ampere reactive hour | — | X | [492] ∧ [51] |
6411 H8701170 | Piece | — | X | — |
| SG26.QTY | — | — | Should | [8] |
6063 13601180 | Quantity reached in the time interval | — | X | — |
606001190 | Quantity | — | X | [908] [85] ⊻ [914] [86] |
6411 DAY01200 | Day | — | X | — |
6411 MON01210 | Month | — | X | [51] ∨ [493] |
6411 ANN01220 | Year | — | X | [51] ∨ [493] |
| SG26.DTM | — | — | Must | — |
2005 15501230 | Invoicing period, start date | — | X | — |
238001240 | Date or time or time span, value | — | X | [UB3] |
2379 30301250 | CCYYMMDDHHMMZ ZZ | — | X | — |
| SG26.DTM | — | — | Must | — |
2005 15601260 | Invoicing period, end date | — | X | — |
238001270 | Date or time or time span, value | — | X | [UB3] |
2379 30301280 | CCYYMMDDHHMMZ ZZ | — | X | — |
| SG27.MOA | — | — | Must | — |
5025 20301290 | Line item amount (excluding VAT) | — | X | — |
500401300 | Monetary amount | — | X | [930] |
| SG27.MOA | — | — | Must | — |
5025 13101310 | Total surcharge or discount amount | — | X | — |
500401320 | Monetary amount | — | X | [930] |
| SG29.PRI | — | — | Must | — |
5125 CAL01330 | Calculation price | — | X | — |
511801340 | Price, amount | — | X | [946] |
6411 DAY01350 | Day | — | X | [12] |
6411 MON01360 | Month | — | X | [12] ∧ ([51] ∨ [493]) |
6411 ANN01370 | Year | — | X | [12] ∧ ([51] ∨ [493]) |
| SG34.TAX | — | — | Must | — |
5283 701380 | Tax | — | X | — |
5153 VAT01390 | Value added tax | — | X | — |
527801400 | Duty/tax/fee rate | — | X | [902] ∧ [930] |
5305 S01410 | Standard rate (standard) | — | X | — |
5305 O01420 | not controllable | — | X | — |
5305 AE01430 | Reverse Charge / tax liability of the service recipient | — | X | — |
| SG39.ALC | — | — | Must | — |
5463 A01440 | Instalment payment | — | X | — |
5189 Z0101450 | Municipal discount under the Concession Levy Ordinance | — | X | — |
5189 Z0401460 | Adjustment under § 19, paragraph 2 Stromnetzentgeltver ordnung | — | X | — |
| SG41.PCD | — | — | Must | — |
5245 301470 | Surcharge or discount | — | X | — |
548201480 | Percentage | — | X | [914] ∧ [930] |
| SG42.MOA | — | — | Must | — |
5025 2501490 | Surcharge/discount basis | — | X | — |
500401500 | Monetary amount | — | X | [930] [512] |
| SG42.MOA | — | — | Must | — |
5025 Z0101510 | Municipal discount | — | X | — |
500401520 | Monetary amount | — | X | [930] [513] |
| SG39.ALC | — | — | Must | — |
5463 C01530 | Surcharge | — | X | — |
5189 Z0201540 | Transformation surcharge | — | X | [29] |
5189 Z0301550 | equipment used exclusively pursuant to § 19, paragraph 3 Stromnetzentgeltverordnung | — | X | — |
5189 Z0401560 | Adjustment under § 19, paragraph 2 Stromnetzentgeltver ordnung | — | X | — |
5189 Z0501570 | Adjustment of the flat-rate grid fee reduction under § 14a EnWG to the level of the NNE | — | X | [525] |
| SG41.PCD | — | — | Must | — |
5245 301580 | Surcharge or discount | — | X | — |
548201590 | Percentage | — | X | [914] ∧ [930] |
| UNS | — | — | Must | — |
0081 S01600 | Separation of detail and summary section | — | X | — |
| SG50.MOA | — | — | Must | — |
5025 7701610 | Invoice amount | — | X | — |
500401620 | Monetary amount | — | X | [930] |
| SG50.MOA | — | — | Must | — |
5025 11301630 | Prepaid amount (incl. VAT) | — | X | — |
500401640 | Monetary amount | — | X | [930] ∧ [526] |
| SG51.RFF | — | — | Must | — |
1153 AFL01650 | Associated invoices | — | X | — |
115401660 | Reference, identification | — | X | — |
| SG51.DTM | — | — | Must | — |
2005 301670 | Invoice date/time | — | X | — |
238001680 | Date or time or time span, value | — | X | — |
2379 30301690 | CCYYMMDDHHMMZ ZZ | — | X | — |
| SG50.MOA | — | — | Must | — |
5025 Z0101700 | Municipal discount | — | X | — |
500401710 | Monetary amount | — | X | [930] |
| SG50.MOA | — | — | Must | — |
5025 901720 | Amount due (incl. VAT) | — | X | — |
500401730 | Monetary amount | — | X | [930] |
| SG52.TAX | — | — | Must | — |
5283 701740 | Tax | — | X | — |
5153 VAT01750 | Value added tax | — | X | — |
527801760 | Duty/tax/fee rate | — | X | [902] ∧ [930] |
5305 S01770 | Standard rate (standard) | — | X | — |
5305 O01780 | not controllable | — | X | — |
5305 AE01790 | Reverse Charge / tax liability of the service recipient | — | X | — |
| SG52.MOA | — | — | Should | [13] |
5025 11301800 | Prepaid amount (incl. VAT) | — | X | — |
500401810 | Monetary amount | — | X | [930] |
| SG52.MOA | — | — | Must | [58] |
5025 11501820 | Prepaid taxes (VAT share of the prepaid amount) | — | X | — |
500401830 | Monetary amount | — | X | [930] |
| SG52.MOA | — | — | Must | — |
5025 12501840 | Taxable amount | — | X | — |
500401850 | Monetary amount | — | X | [930] |
| SG52.MOA | — | — | Must | — |
5025 16101860 | Tax/fee/levy amount | — | X | — |
500401870 | Monetary amount | — | X | [930] |
| UNT | — | — | Must | — |
007401880 | Number of segments in a message | — | X | — |
006201890 | 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.
| 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
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'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"MARKTLOKATION": [1 item
{5 fields
"lokationsadresse": {5 fields
"RECHNUNG": [1 item
{16 fields
"rechnungsperiode": {2 fields
"rechnungspositionen": [2 items
{9 fields
"positionsMenge": {2 fields
"zeitbezogeneMenge": {2 fields
"teilsummeNetto": {2 fields
"einzelpreis": {3 fields
"teilsummeSteuer": {1 field
{10 fields
"positionsMenge": {2 fields
"teilsummeNetto": {2 fields
"einzelpreis": {3 fields
"teilsummeSteuer": {1 field
"abschlag": {2 fields
"gemeinderabatt": {2 fields
"zuZahlen": {2 fields
"steuerbetraege": [1 item
{4 fields
"gesamtbrutto": {2 fields
"gemeinderabatt": {1 field
"transaktionsdaten": {8 fields
"absender": {9 fields
"partneradresse": {5 fields
"ansprechpartner": {5 fields
"rufnummern": [4 items
{2 fields
{2 fields
{2 fields
{2 fields
"empfaenger": {7 fields
"partneradresse": {5 fields
Download: EDIFACT file · BO4E JSON
Example 2
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'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"MARKTLOKATION": [1 item
{5 fields
"lokationsadresse": {6 fields
"zusatzInformation": {1 field
"RECHNUNG": [1 item
{19 fields
"rechnungsperiode": {2 fields
"gesamtbrutto": {2 fields
"zuZahlen": {2 fields
"steuerbetraege": [1 item
{6 fields
"sonderrechnungsarten": [1 item
"rechnungspositionen": [1 item
{13 fields
"positionsMenge": {2 fields
"zeitbezogeneMenge": {2 fields
"einzelpreis": {3 fields
"teilsummeNetto": {2 fields
"teilsummeSteuer": {1 field
"abschlag": {2 fields
"zuschlag": {1 field
"gemeinderabatt": {2 fields
"vorauszahlungen": {1 field
"betrag": {2 fields
"gemeinderabatt": {1 field
"transaktionsdaten": {9 fields
"absender": {9 fields
"partneradresse": {5 fields
"ansprechpartner": {5 fields
"rufnummern": [1 item
{2 fields
"empfaenger": {7 fields
"partneradresse": {5 fields
Download: EDIFACT file · BO4E JSON
Example 3
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'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"MARKTLOKATION": [1 item
{6 fields
"marktlokationsTyp": [1 item
{1 field
"lokationsadresse": {6 fields
"zusatzInformation": {1 field
"RECHNUNG": [1 item
{20 fields
"rechnungsperiode": {2 fields
"gesamtbrutto": {2 fields
"zuZahlen": {2 fields
"steuerbetraege": [1 item
{6 fields
"sonderrechnungsarten": [2 items
"rechnungspositionen": [1 item
{13 fields
"positionsMenge": {2 fields
"zeitbezogeneMenge": {2 fields
"einzelpreis": {3 fields
"teilsummeNetto": {2 fields
"teilsummeSteuer": {1 field
"abschlag": {2 fields
"zuschlag": {1 field
"gemeinderabatt": {2 fields
"vorauszahlungen": {1 field
"betrag": {2 fields
"gemeinderabatt": {1 field
"transaktionsdaten": {10 fields
"absender": {9 fields
"partneradresse": {5 fields
"ansprechpartner": {4 fields
"empfaenger": {7 fields
"partneradresse": {5 fields
Download: EDIFACT file · BO4E 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 | GPKE part 2 | Electricity | Step 1 |
| LF | LF | Billing of grid usage | GeLi Gas 2.0 | Gas | Step 2 |
| NB | NB | Grid usage settlement | GPKE part 2 | Electricity | Step 1 |
| NB | NB | Billing of grid usage | GeLi Gas 2.0 | Gas | Step 2 |
Business classification
| Attribute | Value |
|---|---|
| Use case (AHB) | NN invoice |
| AHB | INVOIC AHB |
| Transmission channel | AS4 |
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 | Confirmation | REMADV | from the step sequence |
| Response | 33002 | Refusal | REMADV | from the step sequence |
| Response | 33003 | Electricity refusal header and total | REMADV | from the step sequence |
| Response | 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.
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
Notes on this page
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.
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.
<businessKey> stays in place. It is not a time value, and an invented key would look like a valid one.