Check identifier 31001 — Instalment invoice
Check identifier 31001 · EDIFACT message type INVOIC · Format version 202610
Data structure
| Structure (BO4E) | Description | Format | 31001 | 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 | — |
| faelligkeitsdatum * 00040 | Payment is due on this date. | string (date-time) | X | — |
| istReverseCharge 00050 | Indicator whether the reverse charge procedure is applied to the invoice | boolean | Should | [4] |
| rechnungsdatum * 00060 | Issue date of the invoice. | string (date-time) | X | — |
| rechnungsstatus * 00070 | Status of the invoice indicating the processing stage. For details see ENUM invoice status | Enum Rechnungsstatus | X | — |
DUPLIKAT | — | — | X | — |
ORIGINAL | — | — | X | — |
STORNIERT | — | — | X | — |
| rechnungstyp * 00080 | 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 | — |
| gesamtbrutto * | — | object | Must | — |
| wert * 00090 | Specifies the amount of the price. | number (float) | X | — |
| rechnungspositionen [ ] * | — | object[] | Must | — |
| artikelnummer * 00100 | Identification of the invoice line item with the standard article number of the BDEW. Details BDEW article number | string | Must | — |
| lieferungBis * 00110 | End of the supply for the billed service. | string (date-time) | X | — |
| lieferungVon * 00120 | Start of supply for the billed service. | string (date-time) | X | — |
| positionsnummer * 00130 | Sequential number for the invoice line item. | integer | Must | — |
| einzelpreis * | — | object | Must | — |
| wert * 00140 | wert | number (float) | X | — |
| positionsMenge * | — | object | Must | — |
| einheit * 00150 | 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 * 00160 | Value | number (float) | X | — |
| teilsummeNetto * | — | object | Must | — |
| wert * 00170 | Specifies the amount of the price. | number (float) | X | — |
| teilsummeSteuer * | — | object | Must | — |
| steuerkennzeichen * 00180 | Identification of the tax rate or procedure. Details tax code | string | Must | — |
| steuerbetraege [ ] * | — | object[] | Must | — |
| basiswert * 00190 | Net amount on which the tax was calculated. E.g. 200 | number (float) | X | — |
| steuerkennzeichen * 00200 | Identification of the tax rate or procedure. Details tax code | string | Must | — |
| steuerwert * 00210 | Tax calculated from the base value. E.g. 38 (at UST_19) if the base value is 200. | number (float) | X | — |
| vorlaeufigerAbrechnungszeitraum * | — | object | Must | — |
| enddatum * 00220 | enddatum | string (date-time) | X | — |
| startdatum * 00230 | startdatum | string (date-time) | X | — |
| zuZahlen * | — | object | Must | — |
| wert * 00240 | Specifies the amount of the price. | number (float) | X | — |
| transaktionsdaten * | — | object | Must | — |
| dokumentennummer * 00250 | EDIFACT reference from the BGM segment / BGM | string | X | — |
| nachrichtenreferenznummer * 00260 | EDIFACT reference from the UNT segment / UTILMD UNT+21 | string | Must | — |
| pruefidentifikator * 00270 | Contains the check identifier from the EDIFact communication / RFF+Z13 | string | X | — |
| absender * | — | object | Must | — |
| name1 * 00280 | 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 * 00290 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00300 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| steuernummer 00310 | The tax number ID of the business partner. Example: 30120345678 | string | Must | [527] |
| umsatzsteuerId 00320 | The VAT ID of the business partner. Example: DE 813281825 | string | Must | [527] |
| ansprechpartner | — | object | May | — |
| nachname 00330 | Surname (family name) of the contact person | string | X | — |
| empfaenger * | — | object | Must | — |
| name1 * 00340 | 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 * 00350 | Specifies the code value of the market role. | string | X | — |
| rollencodetyp * 00360 | Indicates the type of the code. | Enum Rollencodetyp | X | — |
BDEW | — | — | X | — |
GS1 | — | — | X | — |
GLN | — | — | X | — |
DVGW | — | — | X | — |
| steuernummer 00370 | The tax number ID of the business partner. Example: 30120345678 | string | Must | [527] |
| umsatzsteuerId 00380 | The VAT ID of the business partner. Example: DE 813281825 | string | Must | [527] |
Application handbook (AHB)
| Structure (EDIFACT) | Description | Format | 31001 | 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 | CCYYMMDDHHMMZZZ | — | X | — |
| DTM | — | — | Must | — |
2005 900140 | Handling/processing date/time | — | X | — |
238000150 | Date or time or time span, value | — | X | [931] |
2379 30300160 | CCYYMMDDHHMMZZZ | — | X | — |
| DTM | — | — | Must | — |
2005 Z4200170 | preliminary billing period start | — | X | — |
238000180 | Date or time or time span, value | — | X | [UB3] |
2379 30300190 | CCYYMMDDHHMMZZZ | — | X | — |
| DTM | — | — | Must | — |
2005 Z4300200 | preliminary billing period end | — | X | — |
238000210 | Date or time or time span, value | — | X | [UB3] |
2379 30300220 | CCYYMMDDHHMMZZZ | — | X | — |
| IMD | — | — | Must | — |
7081 ABS00230 | Instalment invoice | — | X | — |
| FTX | — | — | Should | [4] |
4451 REG00240 | Notification information | — | X | — |
4441 RCH00250 | Reverse Charge in accordance with §13b UStG / tax liability of the service recipient | — | X | — |
| SG1.RFF | — | — | Must | — |
1153 Z1300260 | Check identifier | — | X | — |
1154 3100100270 | Instalment invoice | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 MS00280 | Document-/message sender or sender | — | X | — |
303900290 | MP-ID | — | X | — |
3055 900300 | GS1 | — | X | — |
3055 29300310 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
3055 33200320 | DE, DVGW Service & Consult GmbH | — | X | — |
303600330 | Party involved | — | X | — |
3045 Z0100340 | Structure of person names | — | X | — |
3045 Z0200350 | Structure of the company name | — | X | — |
304200360 | Street and house number or PO box | — | — | S [7] |
316400370 | City | — | — | — |
325100380 | Postal code, code | — | X | — |
320700390 | Country name, code | — | X | — |
| SG3.RFF | — | — | Must | [527] |
1153 VA00400 | Value added tax number | — | X | — |
1153 FC00410 | Tax number | — | X | [6] |
115400420 | Reference, identification | — | X | — |
| SG5.CTA | — | — | Must | — |
3139 IC00430 | Information contact | — | X | — |
341200440 | Contact | — | X | — |
| SG5.COM | — | — | Must | — |
314800450 | Communication address, identification | — | X | (([939][74]) ⊻ ([940][75])) ∧ [524] |
3155 EM00460 | Electronic mail | — | X | [1P0..1] |
3155 FX00470 | Fax number | — | X | [1P0..1] |
3155 TE00480 | Telephone | — | X | [1P0..1] |
3155 AJ00490 | further telephone | — | X | [1P0..1] |
3155 AL00500 | Mobile phone | — | X | [1P0..1] |
| SG2.NAD | — | — | Must | — |
3035 MR00510 | Message recipient | — | X | — |
303900520 | MP-ID | — | X | — |
3055 900530 | GS1 | — | X | — |
3055 29300540 | DE, BDEW (Bundesverband der Energie- und Wasserwirtschaft e.V.) | — | X | — |
3055 33200550 | DE, DVGW Service & Consult GmbH | — | X | — |
303600560 | Party involved | — | X | — |
3045 Z0100570 | Structure of person names | — | X | — |
3045 Z0200580 | Structure of the company name | — | X | — |
304200590 | Street and house number or PO box | — | — | S [7] |
316400600 | City | — | — | — |
325100610 | Postal code, code | — | X | — |
320700620 | Country name, code | — | X | — |
| SG3.RFF | — | — | Must | — |
1153 VA00630 | Value added tax number | — | X | — |
1153 FC00640 | Tax number | — | X | [6] |
115400650 | Reference, identification | — | X | — |
| SG2.NAD | — | — | Must | — |
3035 DP00660 | Supply address | — | X | — |
312400670 | Additional information for identification | — | — | — |
304200680 | Street and house number or PO box | — | — | S [22] M [23] |
316400690 | City | — | — | — |
325100700 | Postal code, code | — | X | — |
320700710 | Country name, code | — | X | — |
| SG2.LOC | — | — | Must | — |
3227 17200720 | Reporting point | — | X | — |
322500730 | Location, number | — | X | [950] [509] |
| SG7.CUX | — | — | Must | — |
6347 200740 | Reference currency | — | X | — |
6345 EUR00750 | Euro | — | X | — |
6343 400760 | Currency of the invoice | — | X | — |
| SG8.PYT | — | — | Must | — |
4279 300770 | Fixed date | — | X | — |
| SG8.DTM | — | — | Must | — |
2005 26500780 | Due date | — | X | — |
238000790 | Date or time or time span, value | — | X | [UB1] ∧ (([493] ∧ [20] ∧ [24]) ⊻ ([493] ∧ [21] ∧ [25]) ⊻ [492]) |
2379 30300800 | CCYYMMDDHHMMZZZ | — | X | — |
| SG26.LIN | — | — | Must | — |
108200810 | Line item number | — | X | [903] |
714000820 | Product/service number | — | X | [40] |
7143 Z0100830 | Article number | — | X | — |
| SG26.QTY | — | — | Must | — |
6063 4700840 | Calculated (invoiced) quantity | — | X | — |
606000850 | Quantity | — | X | [902] ∧ [906] |
6411 H8700860 | Piece | — | X | — |
| SG26.DTM | — | — | Must | — |
2005 15500870 | Invoicing period, start date | — | X | — |
238000880 | Date or time or time span, value | — | X | [UB3] |
2379 30300890 | CCYYMMDDHHMMZZZ | — | X | — |
| SG26.DTM | — | — | Must | — |
2005 15600900 | Invoicing period, end date | — | X | — |
238000910 | Date or time or time span, value | — | X | [UB3] |
2379 30300920 | CCYYMMDDHHMMZZZ | — | X | — |
| SG27.MOA | — | — | Must | — |
5025 20300930 | Line item amount (excluding VAT) | — | X | — |
500400940 | Monetary amount | — | X | [930] |
| SG29.PRI | — | — | Must | — |
5125 CAL00950 | Calculation price | — | X | — |
511800960 | Price, amount | — | X | [912] |
| SG34.TAX | — | — | Must | — |
5283 700970 | Tax | — | X | — |
5153 VAT00980 | Value added tax | — | X | — |
527800990 | Duty/tax/fee rate | — | X | [902] ∧ [930] |
5305 S01000 | Standard rate (standard) | — | X | — |
5305 O01010 | not controllable | — | X | — |
5305 AE01020 | Reverse Charge / tax liability of the service recipient | — | X | — |
| UNS | — | — | Must | — |
0081 S01030 | Separation of detail and summary section | — | X | — |
| SG50.MOA | — | — | Must | — |
5025 7701040 | Invoice amount | — | X | — |
500401050 | Monetary amount | — | X | [930] |
| SG50.MOA | — | — | Must | — |
5025 901060 | Amount due (incl. VAT) | — | X | — |
500401070 | Monetary amount | — | X | [930] |
| SG52.TAX | — | — | Must | — |
5283 701080 | Tax | — | X | — |
5153 VAT01090 | Value added tax | — | X | — |
527801100 | Duty/tax/fee rate | — | X | [902] ∧ [930] |
5305 S01110 | Standard rate (standard) | — | X | — |
5305 O01120 | not controllable | — | X | — |
5305 AE01130 | Reverse Charge / tax liability of the service recipient | — | X | — |
| SG52.MOA | — | — | Must | — |
5025 12501140 | Taxable amount | — | X | — |
500401150 | Monetary amount | — | X | [930] |
| SG52.MOA | — | — | Must | — |
5025 16101160 | Tax/fee/levy amount | — | X | — |
500401170 | Monetary amount | — | X | [930] |
| UNT | — | — | Must | — |
007401180 | Number of segments in a message | — | X | — |
006201190 | Message reference number | — | X | — |
Conditions of this table
The free text of the 29 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 |
| [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 |
| [40] | Only the article numbers are permitted that are marked with the corresponding check identifier in the code list of article numbers and article IDs, or article IDs from 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 |
| [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 |
| [524] | Note: Only one piece of information may be transmitted in DE3148 |
| [527] | Note: The VAT number or tax number that was previously exchanged via PARTIN must be specified. |
| [902] | Format: Possible value: ≥ 0 |
| [903] | Format: Possible value: 1 |
| [906] | Format: max. 3 decimal places |
| [912] | Format: max. 6 decimal places |
| [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 |
| [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
UNA:+.? '
UNB+UNOC:3+9900321000005:500+9903790000002:500+{{date}}:{{time}}+168546'
UNH+NIK KIRS714669+INVOIC:D:06A:UN:2.8e'
BGM+380+714669BGM+9'
DTM+137:202610011100?+00:303'
DTM+9:202305160648?+00:303'
DTM+Z42:202302282300?+00:303'
DTM+Z43:202303312200?+00:303'
IMD++ABS'
RFF+Z13:31001'
NAD+MS+9900321000005::293++Stadtwerke:::::Z02+Str.::9+Ort++12345+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++54321+DE'
NAD+DP++++Str.::123+Ort++75395+DE'
LOC+172+50074561188'
CUX+2:EUR:4'
PYT+3'
DTM+265:202306052200?+00:303'
LIN+1++9990001000376:Z01'
QTY+47:1:H87'
DTM+155:202302282300?+00:303'
DTM+156:202303312200?+00:303'
MOA+203:1000'
PRI+CAL:1000'
TAX+7+VAT+++:::19+S'
UNS+S'
MOA+77:1000'
MOA+9:1000'
TAX+7+VAT+++:::19+S'
MOA+125:1000'
MOA+161:190'
UNT+36+NIK KIRS714669'
UNZ+1+168546'[1 item
{6 fields
"data": {3 fields
"stammdaten": {2 fields
"MARKTLOKATION": [1 item
{5 fields
"lokationsadresse": {5 fields
"RECHNUNG": [1 item
{14 fields
"gesamtbrutto": {2 fields
"zuZahlen": {2 fields
"steuerbetraege": [1 item
{4 fields
"rechnungspositionen": [1 item
{8 fields
"positionsMenge": {2 fields
"einzelpreis": {2 fields
"teilsummeNetto": {2 fields
"teilsummeSteuer": {1 field
"vorlaeufigerAbrechnungszeitraum": {2 fields
"transaktionsdaten": {8 fields
"absender": {10 fields
"partneradresse": {5 fields
"ansprechpartner": {5 fields
"rufnummern": [4 items
{2 fields
{2 fields
{2 fields
{2 fields
"empfaenger": {8 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) | Instalment 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”.
Responses: No response of this format version names this check identifier as a reference — neither explicitly in the Prüfi table nor via the step sequence. That does not mean there is none; it means that the sources do not record one.
Check identifiers of the same AHB table: No other check identifier of message type INVOIC has the same row structure in this version.
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 153 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 one transaction 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.