BR-ES-01:Spanish NIF/CIF required
Spanish invoices must include the NIF (individuals) or CIF (companies) tax identifier.
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 non-compliant and will be rejected by Peppol access points and national validation services. The sending system receives a rejection response and the invoice does not reach 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. Invoices that trigger this rule are rejected at the access point and never reach the recipient. In Peppol networks, this means your sending system receives an MLR (Message Level Response) with a rejection status. The invoice must be corrected and re-sent, adding delay to your payment cycle.
Validator Behavior
- ·Causes invoice rejection
- ·Rejected by PEPPOL Access Points
- ·Error returned: BR-ES-01
- ·Specification: peppol-bis-3
How to Fix It
Get identifier
NIF for individuals (8 digits + letter), CIF for companies (letter + 7 digits + letter)
Add ES prefix
Format: ES + NIF/CIF
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.
<!-- Missing or empty element triggers cbc:CompanyID error --> <cbc:CompanyID></cbc:CompanyID>
<!-- Provide the required value --> <cbc:CompanyID>VALID_VALUE</cbc:CompanyID>
Technical Reference
XPath: /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyIDCode 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
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 Content
Last updated: 3 March 2026
Resolve BR-ES-01 with Guided Input
The compliance engine detects this error and prompts for the required business data before applying a safe, auditable fix.