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.bill.Invoice
bill.Invoice
| Field | Test | Validation Code / Message |
|---|---|---|
tax.ext |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-01Tax ext must have a valid UNTDID document type code (BR-DE-17) |
preceding |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-02Preceding documents are required for corrective and credit note invoices (BR-DE-26) |
supplier |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-03Supplier is required |
supplier |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-09Either party.telephones or party.people[0].telephones is required (BR-DE-6) |
supplier |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-10Either party.emails or party.people[0].emails is required (BR-DE-7) |
supplier.people |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-04Supplier people is required (BR-DE-5) |
supplier.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-05Supplier addresses is required (BR-DE-2) |
supplier.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-06Supplier first address must have a locality (BR-DE-3) |
supplier.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-07Supplier first address must have a postal code (BR-DE-4) |
supplier.inboxes |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-08Supplier inboxes are required (PEPPOL-EN16931-R020) |
customer |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-11Customer is required |
customer.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-12Customer addresses are required (BR-DE-8) |
customer.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-13Customer first address must have a locality (BR-DE-9) |
customer.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-14Customer first address must have a postal code (BR-DE-10) |
customer.inboxes |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-15Customer inboxes are required (PEPPOL-EN16931-R010) |
payment |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-16Payment is required (BR-DE-1) |
payment.instructions |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-17Payment instructions are required (BR-DE-1) |
payment.instructions.credit_transfer |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-18Credit transfer is required for credit-transfer payments (BR-DE-23) |
payment.instructions.credit_transfer[*].number |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-19Account number is required when IBAN is not provided (BR-DE-19) |
payment.instructions.card |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-20Card details are required for card payments (BR-DE-24) |
payment.instructions.direct_debit |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-21Direct debit details are required for direct-debit payments (BR-DE-25) |
payment.instructions.direct_debit.ref |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-22Direct debit mandate reference is required (BR-DE-29) |
payment.instructions.direct_debit.creditor |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-23Direct debit creditor identifier is required (BR-DE-30) |
payment.instructions.direct_debit.account |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-24Direct debit account is required (BR-DE-31) |
delivery.receiver |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-25Delivery receiver is required |
delivery.receiver.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-26Delivery receiver addresses are required |
delivery.receiver.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-27Delivery receiver first address must have a locality (BR-DE-11) |
delivery.receiver.addresses |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-28Delivery receiver first address must have a postal code (BR-DE-12) |
ordering |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-29Ordering is required (BR-DE-15) |
ordering.code |
| GOBL-DE-XRECHNUNG-V3-BILL-INVOICE-30Ordering code is required (BR-DE-15) |