Skip to main content
Key: de-xrechnung-v3 Support for the German XRechnung version 3.X standard for electronic invoicing. XRechnung is based on the European Norm (EN) 16931 and is mandatory for business-to-government (B2G) invoices in Germany. This addon provides the necessary structures and validations to ensure compliance with the XRechnung specifications. For more information on XRechnung, visit www.xrechnung.de.

​
Validation Rules

Validation rules check each struct against a set of assertions and report any failures with a unique code and message. Read more about validation.
FieldTestValidation Code / Message
tax.ext
  • Ext ‘untdid-tax-category’ in [326, 380, 384, 389, 381, 875, 876, 877]
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-01
Tax ext must have a valid UNTDID document type code (BR-DE-17)
preceding
  • Invoice type in [corrective, credit-note]
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-02
Preceding documents are required for corrective and credit note invoices (BR-DE-26)
supplier
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-03
Supplier is required
supplier
  • Has telephones
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-09
Either party.telephones or party.people[0].telephones is required (BR-DE-6)
supplier
  • Has emails
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-10
Either party.emails or party.people[0].emails is required (BR-DE-7)
supplier.people
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-04
Supplier people is required (BR-DE-5)
supplier.addresses
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-05
Supplier addresses is required (BR-DE-2)
supplier.addresses
  • Has locality
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-06
Supplier first address must have a locality (BR-DE-3)
supplier.addresses
  • Has code
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-07
Supplier first address must have a postal code (BR-DE-4)
supplier.inboxes
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-08
Supplier inboxes are required (PEPPOL-EN16931-R020)
customer
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-11
Customer is required
customer.addresses
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-12
Customer addresses are required (BR-DE-8)
customer.addresses
  • Has locality
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-13
Customer first address must have a locality (BR-DE-9)
customer.addresses
  • Has code
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-14
Customer first address must have a postal code (BR-DE-10)
customer.inboxes
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-15
Customer inboxes are required (PEPPOL-EN16931-R010)
payment
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-16
Payment is required (BR-DE-1)
payment.instructions
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-17
Payment instructions are required (BR-DE-1)
payment.instructions.credit_transfer
  • Has credit-transfer key
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-18
Credit transfer is required for credit-transfer payments (BR-DE-23)
payment.instructions.credit_transfer[*].number
  • No IBAN
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-19
Account number is required when IBAN is not provided (BR-DE-19)
payment.instructions.card
  • Has card key
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-20
Card details are required for card payments (BR-DE-24)
payment.instructions.direct_debit
  • Has direct-debit key
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-21
Direct debit details are required for direct-debit payments (BR-DE-25)
payment.instructions.direct_debit.ref
  • Has direct-debit key
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-22
Direct debit mandate reference is required (BR-DE-29)
payment.instructions.direct_debit.creditor
  • Has direct-debit key
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-23
Direct debit creditor identifier is required (BR-DE-30)
payment.instructions.direct_debit.account
  • Has direct-debit key
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-24
Direct debit account is required (BR-DE-31)
delivery.receiver
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-25
Delivery receiver is required
delivery.receiver.addresses
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-26
Delivery receiver addresses are required
delivery.receiver.addresses
  • Has locality
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-27
Delivery receiver first address must have a locality (BR-DE-11)
delivery.receiver.addresses
  • Has code
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-28
Delivery receiver first address must have a postal code (BR-DE-12)
ordering
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-29
Ordering is required (BR-DE-15)
ordering.code
  • Present
GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-30
Ordering code is required (BR-DE-15)