errorformatPEPPOL_BIS

PEPPOL-EN16931-CL002:Reason code MUST be according to subset of UNCL 5189 D.16B.

Fix: The allowance reason code must be from the UNCL 5189 D.16B subset. This code explains why a discount or allowance is being applied. Upload your invoice to fix this automatically.

The allowance reason code must be from the UNCL 5189 D.16B subset. This code explains why a discount or allowance is being applied.

Severity
Fatal
Rule set
PEPPOL_BIS
Country
All EU
Fix type
AUTO-FIX
Confidence
90%
Category
identifier

Engine Classification

Set Peppol BIS 3.0 profile identifier

Confidence: 90% · Applied automatically in pipeline

What is PEPPOL-EN16931-CL002?

PEPPOL-EN16931-CL002 is a fatal validation rule defined in the PEPPOL_BIS specification. It validates the ProfileID element in the UBL invoice XML.

When this rule fires, the invoice is rejected by Peppol access points and never reaches the buyer.

Target path: /Invoice/cbc:ProfileID

Why This Error Matters

Invoice will be rejected by PEPPOL validation. Allowance reasons must use standard codes for interoperability.

PEPPOL-EN16931-CL002 is a hard failure — the invoice must be corrected and re-sent before it can reach the recipient.

Invoice Navigator can automatically correct this error in your pipeline. The fix is applied with full audit evidence, so your compliance trail remains intact.

Validator Behavior

  • ·Causes invoice rejection
  • ·Rejected by PEPPOL Access Points
  • ·Error returned: PEPPOL-EN16931-CL002
  • ·Specification: PEPPOL_BIS

How to Fix It

1.

Locate the field

Check cbc:ProfileID at /Invoice/cbc:ProfileID. The current value does not meet the rule requirements for PEPPOL-EN16931-CL002.

2.

Set the correct value

The allowance reason code must be from the UNCL 5189 D.16B subset. This code explains why a discount or allowance is being applied.

3.

Re-validate your invoice

Upload the corrected invoice to confirm PEPPOL-EN16931-CL002 is resolved.

XML Example

Generic example based on the rule's target XPath. Your actual XML structure may differ.

Before
<!-- Missing or empty element triggers cbc:ProfileID error -->
<cbc:ProfileID></cbc:ProfileID>
After
<!-- Provide the required value -->
<cbc:ProfileID>VALID_VALUE</cbc:ProfileID>

Technical Reference

XPath/Invoice/cbc:ProfileID
SpecPEPPOL_BIS
Operationset_value
StrategySet Peppol BIS 3.0 profile identifier

Common Causes

  • ·Invalid or unknown allowance reason code
  • ·Using old version of code list
  • ·Custom code not in standard list
  • ·Typo in reason code
  • ·Code from wrong code list used

Seeing this in production? The API handles PEPPOL-EN16931-CL002 automatically. See the fix response →

Frequently Asked Questions

The allowance reason code must be from the UNCL 5189 D.16B subset. This code explains why a discount or allowance is being applied.

The allowance reason code must be from the UNCL 5189 D.16B subset. This code explains why a discount or allowance is being applied. You can also use Invoice Navigator's compliance engine to correct this automatically in your pipeline.

Yes, PEPPOL-EN16931-CL002 is a critical error that will cause invoice rejection. It must be fixed before submission.

Many instances of PEPPOL-EN16931-CL002 can be automatically corrected using Invoice Navigator's compliance engine. The fix is applied in your pipeline with full audit evidence.

Related Content

Last updated: 14 April 2026

Share this guide:

Validate your invoice

Drop your XML here to check for PEPPOL-EN16931-CL002

Auto-fix PEPPOL-EN16931-CL002 in seconds

Upload your invoice and we fix this error automatically. Financial fields are never touched.