errorformatEN16931

UBL-SR-27:Payment means text shall occur maximum once

Fix: Your invoice contains multiple Payment means text elements (PaymentMeans/InstructionNote). EN16931 allows only one instruction note. Upload your invoice to fix this automatically.

Your invoice contains multiple Payment means text elements (PaymentMeans/InstructionNote). EN16931 allows only one instruction note.

Severity
Fatal
Rule set
EN16931
Country
All EU
Fix type
AUTO-FIX
Confidence
92%
Category
structural

Engine Classification

Remove duplicate payment means codes within a payment means block, keeping the first occurrence

Confidence: 92% · Applied automatically in pipeline

What is UBL-SR-27?

UBL-SR-27 is a fatal validation rule defined in the EN16931 specification. It validates the PaymentMeansCode 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: //cac:PaymentMeans/cbc:PaymentMeansCode

Why This Error Matters

Invoice will be rejected by EN16931 validators. These structural constraints ensure consistent processing by receiving systems.

UBL-SR-27 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
  • ·Fails EN 16931 business rule validation
  • ·Error returned: UBL-SR-27
  • ·Specification: EN16931

How to Fix It

1.

Locate the duplicate entries

Search for multiple cbc:PaymentMeansCode elements at //cac:PaymentMeans/cbc:PaymentMeansCode. Only one instance is allowed per the specification.

2.

Remove the duplicates

Your invoice contains multiple Payment means text elements (PaymentMeans/InstructionNote). EN16931 allows only one instruction note.

3.

Re-validate your invoice

Upload the corrected invoice to confirm UBL-SR-27 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:PaymentMeansCode error -->
<cbc:PaymentMeansCode></cbc:PaymentMeansCode>
After
<!-- Provide the required value -->
<cbc:PaymentMeansCode>VALID_VALUE</cbc:PaymentMeansCode>

Technical Reference

XPath//cac:PaymentMeans/cbc:PaymentMeansCode
SpecEN16931
Operationremove_duplicates
StrategyRemove duplicate payment means codes within a payment means block, keeping the first occurrence

Common Causes

  • ·ERP system exports multiple values where EN16931 only allows one
  • ·Data consolidation merged records without deduplicating
  • ·Template or mapping incorrectly configured to output duplicate elements
  • ·Manual editing introduced extra elements
  • ·Invoice conversion from another format did not merge duplicate entries

Seeing this in production? The API handles UBL-SR-27 automatically. See the fix response →

Frequently Asked Questions

Your invoice contains multiple Payment means text elements (PaymentMeans/InstructionNote). EN16931 allows only one instruction note.

Your invoice contains multiple Payment means text elements (PaymentMeans/InstructionNote). EN16931 allows only one instruction note. You can also use Invoice Navigator's compliance engine to correct this automatically in your pipeline.

Yes, UBL-SR-27 is a critical error that will cause invoice rejection. It must be fixed before submission.

Many instances of UBL-SR-27 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 UBL-SR-27

Auto-fix UBL-SR-27 in seconds

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