errorcountryESPpeppol-bis-3

BR-ES-01:Spanish NIF/CIF required

Fix: Add NIF/CIF with ES prefix. Provide the required value in the free validator.

Spanish invoices must include the NIF (individuals) or CIF (companies) tax identifier.

Severity
Fatal
Rule set
peppol-bis-3
Country
ESP
Fix type
INPUT REQUIRED

Engine Classification

Business data required · Explicit input workflow · No assumptions made

Required input: Spanish Tax ID (NIF/CIF)

What is BR-ES-01?

BR-ES-01 is a fatal validation rule defined in the peppol-bis-3 specification (ESP national rules). It validates the CompanyID element under Party > PartyTaxScheme in the UBL invoice XML.

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

Target path: XPath: /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID

Why This Error Matters

NIF/CIF is required for all Spanish invoicing and tax reporting.

BR-ES-01 is a hard failure — the invoice must be corrected and re-sent before it can reach the recipient.

Validator Behavior

  • ·Causes invoice rejection
  • ·Rejected by PEPPOL Access Points
  • ·Error returned: BR-ES-01
  • ·Specification: peppol-bis-3

How to Fix It

1.

Get identifier

NIF for individuals (8 digits + letter), CIF for companies (letter + 7 digits + letter)

2.

Add ES prefix

Format: ES + NIF/CIF

3.

Validate checksum

NIF/CIF has control digit/letter

XML Example

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

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

Technical Reference

XPathXPath: /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
Specpeppol-bis-3

Code Example

<cac:PartyTaxScheme>
  <cbc:CompanyID>ESA12345678</cbc:CompanyID>
  <cac:TaxScheme>
    <cbc:ID>VAT</cbc:ID>
  </cac:TaxScheme>
</cac:PartyTaxScheme>

Common Causes

  • ·Missing ES prefix
  • ·Invalid format
  • ·Wrong control digit

Seeing this in production? The API handles BR-ES-01 automatically. See the fix response →

Commonly Seen In

HoldedContasolA3innuvaSage

Frequently Asked Questions

Spanish invoices must include the NIF (individuals) or CIF (companies) tax identifier.

Add NIF/CIF with ES prefix. Invoice Navigator detects this error and prompts for the required business data before applying a safe fix.

Yes, BR-ES-01 is a critical error that will cause invoice rejection. It must be fixed before submission to ensure your invoice is accepted by the recipient's system.

BR-ES-01 requires specific business data to resolve. Invoice Navigator detects the error and guides you through providing the needed information, then applies the fix with full audit documentation.

BR-ES-01 is commonly seen in exports from Holded, Contasol, A3innuva, Sage. These software packages sometimes generate invoices that need adjustment to meet full compliance standards.

Related Errors

Related Content

Last updated: 3 March 2026

Share this guide:

Validate your invoice

Drop your XML here to check for BR-ES-01

Fix BR-ES-01 with guided input

Upload your invoice and we'll ask for the missing data, then apply a safe, auditable fix.