UBL-CR-412: Move the due date from the payment instructions to the invoice header

The short answer

UBL-CR-412 is a warning raised when an invoice has cbc:PaymentDueDate in its payment instructions (cac:PaymentMeans). An invoice states its due date (BT-9) in the header, in cbc:DueDate: move the date there.

The warning on its own does not make the document invalid, though other rules still check what is there.

What the rule checks

The rule checks whether an invoice has cac:PaymentMeans/cbc:PaymentDueDate. Its value is not read, and a credit note is not checked.

It runs once against the whole document, so it is reported once however many times the document has the element, and the finding points at the document root rather than at the element: look for cac:PaymentMeans/cbc:PaymentDueDate in the XML.

How an integration ends up here

Possible causes, from the shape of the rule rather than from measured usage:

• The source system holds the value, and the mapping writes it because UBL 2.1 has a place for it.
• A general UBL 2.1 library writes every element and attribute it has a value for, whether or not EN 16931 uses it.
• A mapping built for another UBL-based document, such as an order, a despatch advice or a national profile, is reused for Peppol BIS Billing.

How to fix it

1. Move the date from cac:PaymentMeans/cbc:PaymentDueDate to cbc:DueDate in the header.
2. The due date (BT-9) is cbc:DueDate in a UBL invoice; only a credit note, which has no cbc:DueDate, states it in the payment means.
3. Validate again: the warning goes.

Validate your corrected invoice

Before and after

These are fragments, not complete documents. The complete synthetic documents they come from are linked below.

Fragment of the invoice with the warning: PaymentDueDate in the payment instructions

<cac:PaymentMeans>
  <cbc:PaymentMeansCode>30</cbc:PaymentMeansCode>
  <cbc:PaymentDueDate>2026-10-08</cbc:PaymentDueDate>
  <cbc:PaymentID>PAYMENT-001</cbc:PaymentID>

Fragment of the corrected invoice: the same date in cbc:DueDate in the header

<cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>
<cbc:ID>EXAMPLE-INV-002</cbc:ID>
<cbc:IssueDate>2026-09-08</cbc:IssueDate>
<cbc:DueDate>2026-10-08</cbc:DueDate>
<cbc:InvoiceTypeCode>380</cbc:InvoiceTypeCode>
<cbc:Note>Example only. Terms &amp; references &lt;must&gt; be preserved. Café 🐺</cbc:Note>
<cbc:TaxPointDate>2026-09-07</cbc:TaxPointDate>

The invoice with the warning has <cbc:PaymentDueDate>2026-10-08</cbc:PaymentDueDate> in the payment instructions and no cbc:DueDate; the corrected invoice has the same date in cbc:DueDate in the header instead. It reports only this warning and is valid on every layer, so it would be accepted as it stands.

Where it applies

• Applies only to a UBL Invoice: the rule skips credit notes, because the UBL 2.1 credit note has no cbc:DueDate and states its due date (BT-9) in cac:PaymentMeans/cbc:PaymentDueDate.
• The warning comes from the EN 16931 layer's rules for the UBL syntax. In the recorded example the schema layer passes: the element is valid UBL 2.1 and is only outside the EN 16931 model.

Related rules

• UBL-CR-411: ID in the payment instructions
• UBL-CR-413: PaymentChannelCode in the payment instructions
• UBL-CR-414: InstructionID in the payment instructions
• Browse every rule in the reference
• Background: Understanding EN 16931 validation errors

Scope and source

Written for Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, as applied to UBL 2.1 Invoice and CreditNote documents. Other profiles, syntaxes and releases can define this identifier differently. Guidance version 2026-09-29.1: source checked 2026-09-29, explanation last updated 2026-09-29.

The official definition of UBL-CR-412 carries the normative wording and test. This page is our explanation of it, not a copy.

Guidance does not change the engine verdict. Fixing this finding does not mean the document passes every layer, and validation does not certify legal or tax compliance or transmit a document over Peppol.