Skip to main content

Documentation Index

Fetch the complete documentation index at: https://gobl-correction-definitions.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Spain’s tax system is administered by the Agencia Tributaria (AEAT). As an EU member state, Spain follows the EU VAT Directive with locally adapted rates. IVA (Impuesto sobre el Valor Añadido) applies at general, reduced, and super-reduced rates. The Canary Islands use IGIC (Impuesto General Indirecto Canario) instead of IVA, while Ceuta and Melilla use IPSI (Impuesto sobre la Producción, los Servicios y la Importación). Businesses are identified by their NIF (Número de Identificación Fiscal) or CIF for companies. IRPF (Impuesto sobre la Renta de las Personas Físicas) retention taxes apply to freelancer invoices at varying rates. According to Real Decreto 1619/2012, only rectified (rectificativa) invoices are recognized in Spanish law. GOBL maps corrective invoices to “rectificación modelo íntegro” (complete replacement) and credit notes to “rectificación por diferencias” (correction by differences, with quantities inverted during conversion). The FacturaE format is used for B2G e-invoicing, with TicketBAI required in the Basque Country, VeriFactu being rolled out nationally, and the SII (Suministro Inmediato de Información) system providing near-real-time reporting of invoicing data to the AEAT.

Base Details

KeyValue
Tax Country CodeES
CurrencyEUR
Base Time ZoneEurope/Madrid

Tax Categories

CodeNameTitle
VATVATValue Added Tax
IGICIGICCanary Island General Indirect Tax
IPSIIPSIProduction, Services, and Import Tax
IRPFIRPFPersonal income tax.

VAT Rates

Known in Spanish as “Impuesto sobre el Valor Añadido” (IVA), is a consumption tax applied to the purchase of goods and services. It’s a tax on the value added at each stage of production or distribution. Spain, as a member of the European Union, follows the EU’s VAT Directive, but with specific rates and exemptions tailored to its local needs.
RateKeysNamePercentsDescription
generalstandardStandard Rate21.0%
general+eqsstandardStandard Rate + Equivalence Surcharge21.0% (+5.2%)
reducedstandardReduced Rate10.0%
reduced+eqsstandardReduced Rate + Equivalence Surcharge10.0% (+1.4%)
super-reducedstandardSuper-Reduced Rate4.0%
super-reduced+eqsstandardSuper-Reduced Rate + Equivalence Surcharge4.0% (+0.5%)

IGIC Rates

RateKeysNamePercentsDescription
generalstandardGeneral Rate7.0%
reducedstandardReduced Rate3.0%

IRPF Rates

RateKeysNamePercentsDescription
proProfessional Rate15.0%
pro-startProfessional Starting Rate7.0%
capitalRental or Interest Capital19.0%
modulesModules Rate1.0%

Correction Definitions

Auto-generation of corrective invoices or credit and debit notes is supported.

Invoice Types

The types of invoices that can be created with a preceding definition:
  • credit-note
  • corrective
  • debit-note

Scenarios

bill/invoice

Filters:
  • Tags: reverse-charge
Output:
  • Note: Reverse Charge / Inversión del sujeto pasivo. (reverse-charge)
Filters:
  • Tags: reverse-charge
Output:
  • Note: Reverse Charge / Inversión del sujeto pasivo. (reverse-charge)
Filters:
  • Tags: simplified-scheme
Output:
  • Note: Factura expedida por contribuyente en régimen simplificado. (simplified-scheme)
Filters:
  • Tags: self-billed
Output:
  • Note: Facturación por el destinatario. (self-billed)
Filters:
  • Tags: travel-agency
Output:
  • Note: Régimen especial de las agencias de viajes. (travel-agency)
Filters:
  • Tags: travel-agency
Output:
  • Note: Régimen especial de las agencias de viajes. (travel-agency)
Filters:
  • Tags: second-hand-goods
Output:
  • Note: Régimen especial de los bienes usados. (second-hand-goods)
Filters:
  • Tags: second-hand-goods
Output:
  • Note: Régimen especial de los bienes usados. (second-hand-goods)
Filters:
  • Tags: art
Output:
  • Note: Régimen especial de los objetos de arte. (art)
Filters:
  • Tags: art
Output:
  • Note: Régimen especial de los objetos de arte. (art)
Filters:
  • Tags: antiques
Output:
  • Note: Régimen especial de las antigüedades y objetos de colección. (antiques)
Filters:
  • Tags: antiques
Output:
  • Note: Régimen especial de las antigüedades y objetos de colección. (antiques)
Filters:
  • Tags: cash-basis
Output:
  • Note: Régimen especial del criterio de caja. (cash-basis)
Filters:
  • Tags: cash-basis
Output:
  • Note: Régimen especial del criterio de caja. (cash-basis)

Validation Rules

FieldTestValidation Code / Message
supplier
  • Context: regime in [ES]
  • Present
GOBL-ES-BILL-INVOICE-01
Invoice supplier in Spain is required
supplier.tax_id
  • Context: regime in [ES]
  • Present
GOBL-ES-BILL-INVOICE-02
Invoice supplier tax ID in Spain is required
supplier.tax_id.code
  • Context: regime in [ES]
  • Present
GOBL-ES-BILL-INVOICE-03
Invoice supplier tax ID code in Spain is required
FieldTestValidation Code / Message
code
  • Code in [ES]
  • Valid
GOBL-ES-TAX-IDENTITY-01
Invalid Spanish VAT identity code format or checksum