warningcountry ESPubl-2.1

`ES-R-005`:SII reporting reference

Fix: Add SII registration reference after reporting. Provide the required value in the free validator.

Invoices reported to Spanish SII should include reporting reference.

Severity

Warning

Rule set

ubl-2.1

Country

ESP

Fix type

INPUT REQUIRED

Engine Classification

Business data required · Explicit input workflow · No assumptions made

Required input: SII Reporting Reference

What is ES-R-005?

ES-R-005 is a warning validation rule defined in the ubl-2.1 specification (ESP national rules). It validates the Note or extension for SII reference element in the UBL invoice XML.

The invoice may pass transmission, but this non-compliance can cause problems during tax audits or buyer-side processing.

Target path: XPath: //cbc:Note or extension for SII reference

Fix this error

Why This Error Matters

SII reference proves invoice was reported to tax authority.

ES-R-005 is a soft failure that can cause issues at the receiving end — tax audits, ERP processing, or VAT reconciliation mismatches.

Validator Behavior

·Generates validation warning
·Fails UBL schema validation
·Error returned: ES-R-005
·Specification: ubl-2.1

How to Fix It

Report to SII

Via AEAT web service

Add reference

Include CSV or registration number

XML Example

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

Before

<!-- Incorrect value -->
<cbc:Note or extension for SII reference>INVALID</cbc:Note or extension for SII reference>

After

<!-- Corrected value -->
<cbc:Note or extension for SII reference>VALID_VALUE</cbc:Note or extension for SII reference>

Technical Reference

XPathXPath: //cbc:Note or extension for SII reference

Specubl-2.1

Common Causes

·SII reporting not done
·Reference not added after reporting

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

Frequently Asked Questions

Invoices reported to Spanish SII should include reporting reference.

Add SII registration reference after reporting. Invoice Navigator detects this error and prompts for the required business data before applying a safe fix.

ES-R-005 is a warning that may not always cause rejection, but should be addressed for full compliance.

Validate your invoice

Drop your XML here to check for ES-R-005

Upload XML

Fix ES-R-005 with guided input

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

Fix it now Automate via API

ES-R-005:SII reporting reference