PEPPOL-EN16931-R101

On an invoice line the only additional document reference permitted is the object identifier — type code 130. Other document references belong at document level.

Severity: Error
Applies to: CII, UBL
Rule set: v2026-01-31

Official rule text

Element Additional referenced document can only be used for Invoice line object.

Why does PEPPOL-EN16931-R101 happen?

Delivery-note and order numbers are maintained per line and so get written per line. At line level the norm provides only for the object identifier.

How do you fix PEPPOL-EN16931-R101?

Set cbc:DocumentTypeCode to 130 on the line (cac:InvoiceLine/cac:DocumentReference in UBL, the line's ram:AdditionalReferencedDocument in CII). Delivery notes and orders belong in cac:DespatchDocumentReference or cac:OrderReference at document level.

In the XML

A UBL fragment. The CII path is named above — same change, different element names.

Fails

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cac:DocumentReference>
    <cbc:ID>LS-2026-0007</cbc:ID>
    <cbc:DocumentTypeCode>50</cbc:DocumentTypeCode>
  </cac:DocumentReference>
</cac:InvoiceLine>

Fixed

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <cac:DocumentReference>
    <cbc:ID>LS-2026-0007</cbc:ID>
    <cbc:DocumentTypeCode>130</cbc:DocumentTypeCode>
  </cac:DocumentReference>
</cac:InvoiceLine>

NormAPI provides technical validation, not tax or legal advice.