> ## Documentation Index
> Fetch the complete documentation index at: https://docs.invopop.com/llms.txt
> Use this file to discover all available pages before exploring further.
# NO VERI*FACTU Invoicing Guide
> Issue invoices in Spain with NO VERI*FACTU.
## Introduction
NO VERI\*FACTU is one of the two compliance modalities defined by Spain's Real Decreto 1007/2023. In this modality, invoicing records are **not** sent to the AEAT in real time. Instead, they are digitally signed using XAdES Enveloped Signature and stored locally to guarantee integrity and inalterability. Records are only submitted to the AEAT upon explicit requirement.
## Prerequisites
To issue your first NO VERI\*FACTU invoice, you must have registered at least one supplier. Make sure you read and implemented the [NO VERI\*FACTU supplier onboarding guide](/guides/es-noverifactu-supplier) before continuing with this guide.
## Setup
Add a new workflow to your workspace for issuing invoices. You can start with the template below.
This workflow will generate, sign, and store an invoice record locally, then produce a PDF.
Copy and paste into a new [Empty Invoice workflow](https://console.invopop.com/redirect/workflows/new?template=empty-invoice) code view.
```json Example NO VERI*FACTU invoice workflow with states expandable theme={"system"}
{
"name": "NO VERI*FACTU issue invoice",
"description": "Issue an invoice via NO VERI*FACTU and generate PDF",
"schema": "bill/invoice",
"steps": [
{
"id": "a1b2c3d0-0001-11f1-a000-000000000001",
"name": "Set state",
"provider": "silo.state",
"summary": "Set state to `processing`{.state .processing}",
"config": {
"state": "processing"
},
"next": []
},
{
"id": "a1b2c3d0-0001-11f1-a000-000000000002",
"name": "Add sequential code",
"provider": "sequence.enumerate",
"summary": "Dynamic · NO VERI*FACTU · 000001",
"config": {
"name": "NoVerifactu",
"padding": 6,
"start": 1
},
"next": []
},
{
"id": "a1b2c3d0-0001-11f1-a000-000000000003",
"name": "Sign envelope",
"provider": "silo.close",
"next": []
},
{
"id": "5bb35ae0-3ca4-11f1-90b7-0d81b4010093",
"name": "Generate invoice for NO VERI*FACTU",
"provider": "gov-es.noverifactu.generate.invoice",
"next": []
},
{
"id": "64c2d7f0-3ca4-11f1-90b7-0d81b4010093",
"name": "Record for NO VERI*FACTU",
"provider": "gov-es.noverifactu.record",
"next": []
},
{
"id": "a1b2c3d0-0001-11f1-a000-000000000006",
"name": "Generate PDF",
"provider": "pdf",
"summary": "Spanish · A4",
"config": {
"date_format": "%Y-%m-%d",
"layout": "A4",
"locale": "es",
"logo_height": 60
},
"next": []
},
{
"id": "a1b2c3d0-0001-11f1-a000-000000000007",
"name": "Set state",
"provider": "silo.state",
"summary": "Set state to `registered`{.state .registered}",
"config": {
"state": "registered"
},
"next": []
}
],
"rescue": [
{
"id": "a1b2c3d0-0001-11f1-a000-000000000008",
"name": "Set state",
"provider": "silo.state",
"summary": "Set state to `error`{.state .error}",
"config": {
"state": "error"
},
"next": []
}
]
}
```
In [Console](https://console.invopop.com) create a new workflow and select [Empty Invoice workflow](https://console.invopop.com/redirect/workflows/new?template=empty-invoice) in the template selector, then add the following steps:
1. **Set state** — select "Processing".
2. **Sign envelope** — Signs the GOBL envelope.
3. **Generate Invoice Record** — Generates the XML record from the GOBL invoice and digitally signs it using XAdES Enveloped Signature.
4. **Store Record** — Persists the signed record in the database for regulatory compliance.
5. **Generate PDF** — Creates the PDF invoice with the required QR code.
6. **Set state** — select "Registered".
In the Error Handling section, add the **Set state** action and select `Error`.
Keep the `Workflow ID` at hand, you'll use it later.
NO VERI\*FACTU allows for document modifications after recording. If a document contains errors, update the GOBL details and resubmit to the same workflow.
## Issue an Invoice
The GOBL invoice format for NO VERI\*FACTU is identical to VERI\*FACTU — both use the same [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon. The difference is in how the records are processed: NO VERI\*FACTU signs and stores them locally rather than sending them to the AEAT.
Use the [Create an entry](/api-ref/silo/entries/create-an-entry-put) endpoint to upload the invoice details. Include an [invoice](https://docs.gobl.org/draft-0/bill/invoice) object in the [data](/api-ref/silo/entries/create-an-entry-put#body-data) field with these required fields:
* `regime`: `ES`
* Add the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon
* `supplier`: Use the details of the supplier you've registered before.
You can copy one of the example invoices below as a reference.
Simplified invoices are used for B2C transactions when the customer is not a business. The transaction amount should be under €400 (VAT included) with some [exceptions](https://sede.agenciatributaria.gob.es/Sede/iva/facturacion-registro/facturacion-iva/tipos-factura.html) in which this threshold is increased to €3,000.
To create a simplified VERI\*FACTU invoice, include the `simplified` tag in your GOBL document with the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon.
```json B2C Invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"$tags": [
"simplified"
],
"type": "standard",
"series": "SAMPLE",
"issue_date": "2024-11-13",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"rate": "general"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a standard tax"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"$tags": [
"simplified"
],
"type": "standard",
"series": "SAMPLE",
"issue_date": "2024-11-13",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F2"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a standard tax"
}
]
}
```
Regular invoices are used for B2B transactions. Regular invoices must be issued when:
* The customer is a registered business (has a tax identification number).
* The transaction amount is €400 VAT included or above, or the customer requires a full invoice.
* The customer needs a complete invoice with all tax details for accounting or tax purposes.
To create a regular VERI\*FACTU invoice, include the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon and ensure the `customer` field contains valid tax identification details. The addon will automatically set the document type to `F1` when the silo entry is built (which happens automatically when saving a silo entry through the API or console).
The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` NIF or VAT ID must be valid.
```json B2B Invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "004",
"issue_date": "2024-11-13",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"rate": "general"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a exempt tax"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "004",
"issue_date": "2024-11-13",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a exempt tax"
}
]
}
```
Reverse charge invoices are used for B2B services provided to customers in other EU member states. Reverse charge must be applied when:
* The customer is a registered business in another EU member state (has a valid EU VAT ID).
* The service is provided to a business customer (B2B), not a consumer.
* The service is subject to VAT but the customer accounts for the VAT in their own country.
To create a reverse charge VERI\*FACTU invoice, use the tax key `reverse-charge` in your invoice lines. The [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon will automatically set the operation class to `S2` (Subject and Not Exempt - With reverse charge) when the silo entry is built.
With reverse charge, no VAT is charged by the supplier. The customer accounts for VAT in their own country. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid and registered in the EU VIES system.
```json B2B Intra-community Services invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000001",
"issue_date": "2024-11-13",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "DE",
"code": "111111125"
}
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "reverse-charge"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with reverse charge"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000001",
"issue_date": "2024-11-13",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "DE",
"code": "111111125"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "reverse-charge",
"ext": {
"es-verifactu-op-class": "S2",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "reverse-charge",
"ext": {
"es-verifactu-op-class": "S2",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"amount": "0.00"
}
],
"amount": "0.00"
}
],
"sum": "0.00"
},
"tax": "0.00",
"total_with_tax": "1800.00",
"payable": "1800.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with reverse charge"
}
]
}
```
Intra-community supply invoices are used for B2B goods delivered to customers in other EU member states. Intra-community supplies must be applied when:
* The customer is a registered business in another EU member state (has a valid EU VAT ID).
* Goods are physically delivered to another EU member state.
* The supply is exempt from VAT in the origin country (Spain) and subject to VAT in the destination country.
To create an intra-community supply VERI\*FACTU invoice, use the tax key `intra-community` in your invoice lines. The [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon will automatically set the exemption code to `E5` ([Artículo 25 Ley de IVA](https://www.boe.es/eli/es/l/1992/12/28/37/con#a25)) when the silo entry is built.
With intra-community supplies, no VAT is charged in Spain. The customer accounts for VAT in their destination country. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and the `customer` VAT ID must be valid and registered in the EU VIES system.
```json Intra-community goods invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000003",
"issue_date": "2024-11-13",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "DE",
"code": "111111125"
}
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Goods",
"price": "90.00"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "intra-community"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a intra-community"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000003",
"issue_date": "2024-11-13",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "DE",
"code": "111111125"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Goods",
"price": "90.00"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "intra-community",
"ext": {
"es-verifactu-exempt": "E5",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "intra-community",
"ext": {
"es-verifactu-exempt": "E5",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"amount": "0.00"
}
],
"amount": "0.00"
}
],
"sum": "0.00"
},
"tax": "0.00",
"total_with_tax": "1800.00",
"payable": "1800.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a intra-community"
}
]
}
```
Outside scope invoices are used for B2B services provided to customers outside the EU.
To create an outside scope VERI\*FACTU invoice, use the tax key `outside-scope` in your invoice lines. The [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon will automatically set the operation class to `N2` (Not Subject - Due to location rules) when the silo entry is built.
Services provided to non-EU customers are generally outside the scope of Spanish VAT. The `supplier` must be previously registered with the tax authority. Customer tax identification is optional but recommended for record-keeping purposes.
```json B2B International Services invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000002",
"issue_date": "2025-11-17",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "SG",
"code": "201312345A"
}
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "outside-scope"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a outside-scope tax"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000002",
"issue_date": "2025-11-17",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "SG",
"code": "201312345A"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "outside-scope",
"ext": {
"es-verifactu-op-class": "N2",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "outside-scope",
"ext": {
"es-verifactu-op-class": "N2",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"amount": "0.00"
}
],
"amount": "0.00"
}
],
"sum": "0.00"
},
"tax": "0.00",
"total_with_tax": "1800.00",
"payable": "1800.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a outside-scope tax"
}
]
}
```
Export invoices are used for B2B goods delivered to customers outside the EU.
To create an export VERI\*FACTU invoice, use the tax key `export` in your invoice lines. The [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon will automatically set the exemption code to `E2` ([Artículo 21 Ley de IVA](https://www.boe.es/eli/es/l/1992/12/28/37/con#a21)) and regime code to `02` (Export) when the silo entry is built.
Exported goods are exempt from Spanish VAT. The `supplier` must be previously registered with the tax authority. Customer tax identification is optional but recommended for record-keeping purposes.
```json B2B International Goods invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000004",
"issue_date": "2025-11-17",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "SG",
"code": "201312345A"
}
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Goods",
"price": "90.00"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "export"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a export"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "sett/000004",
"issue_date": "2025-11-17",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "SG",
"code": "201312345A"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Goods",
"price": "90.00"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "export",
"ext": {
"es-verifactu-exempt": "E2",
"es-verifactu-regime": "02"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "export",
"ext": {
"es-verifactu-exempt": "E2",
"es-verifactu-regime": "02"
},
"base": "1800.00",
"amount": "0.00"
}
],
"amount": "0.00"
}
],
"sum": "0.00"
},
"tax": "0.00",
"total_with_tax": "1800.00",
"payable": "1800.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a export"
}
]
}
```
Exempt `E1` invoices are used for B2B transactions that are exempt from VAT pursuant ([Artículo 20 Ley de IVA](https://www.boe.es/eli/es/l/1992/12/28/37/con#a20)), which covers exemptions in internal operations.
To create an exempt E1 VERI\*FACTU invoice, use the tax key `exempt` in your invoice lines. The [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon will automatically set the exemption code to `E1` when the silo entry is built.
Exempt operations are not subject to VAT but must still be reported. The `supplier` must be previously registered with the tax authority and the `customer` NIF must be valid.
```json B2B Exempt E1 Invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "004",
"issue_date": "2024-11-13",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "exempt"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a exempt tax"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"series": "SAMPLE",
"code": "004",
"issue_date": "2024-11-13",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "exempt",
"ext": {
"es-verifactu-exempt": "E1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "exempt",
"ext": {
"es-verifactu-exempt": "E1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"amount": "0.00"
}
],
"amount": "0.00"
}
],
"sum": "0.00"
},
"tax": "0.00",
"total_with_tax": "1800.00",
"payable": "1800.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a exempt tax"
}
]
}
```
One-Stop-Shop (OSS) invoices are used for B2C distance sales of goods and services to consumers in other EU member states when the supplier is registered under the OSS scheme.
To create an OSS VERI\*FACTU invoice, include the `simplified` tag in your GOBL document with the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon. The invoice will be treated as a simplified invoice (document type `F2`) and VAT is accounted for through the OSS scheme in the destination country.
OSS allows suppliers to register for VAT in one EU member state and account for VAT on all EU distance sales through that single registration. The `supplier` must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority and enrolled in the OSS scheme.
```json B2C One Stop Shop Invoice theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"$tags": [
"simplified"
],
"type": "standard",
"series": "SAMPLE",
"code": "004",
"issue_date": "2024-11-13",
"currency": "EUR",
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"lines": [
{
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"rate": "standard"
}
],
"total": "1800.00"
}
],
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a standard tax"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"$tags": [
"simplified"
],
"type": "standard",
"series": "SAMPLE",
"code": "004",
"issue_date": "2024-11-13",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F2"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
},
"notes": [
{
"key": "general",
"text": "This is a sample invoice with a standard tax"
}
]
}
```
```json Rectificativa por diferencias theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"uuid": "01971bb1-1499-7001-81ea-26f51cf396e1",
"type": "credit-note",
"series": "CN",
"issue_date": "2025-05-29",
"currency": "EUR",
"preceding": [
{
"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
"type": "standard",
"issue_date": "2024-11-13",
"series": "SAMPLE",
"code": "004"
}
],
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"rate": "general"
}
],
"total": "1800.00"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"uuid": "01971bb1-1499-7001-81ea-26f51cf396e1",
"type": "credit-note",
"series": "CN",
"issue_date": "2025-05-29",
"currency": "EUR",
"preceding": [
{
"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
"type": "standard",
"issue_date": "2024-11-13",
"series": "SAMPLE",
"code": "004"
}
],
"tax": {
"ext": {
"es-verifactu-correction-type": "I",
"es-verifactu-doc-type": "R1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
}
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "corrective",
"series": "CO",
"issue_date": "2025-05-29",
"currency": "EUR",
"preceding": [
{
"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
"type": "standard",
"issue_date": "2024-11-13",
"series": "SAMPLE",
"code": "004",
"tax": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
}
}
],
"tax": {
"ext": {
"es-verifactu-correction-type": "S",
"es-verifactu-doc-type": "R1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
}
}
```
```json Factura de canje theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"tax": {
"tags": [
"replacement"
]
},
"series": "FC",
"issue_date": "2026-02-26",
"currency": "EUR",
"preceding": [
{
"type": "standard",
"issue_date": "2026-02-20",
"series": "FS",
"code": "001"
}
],
"supplier": {
"name": "Easor Software Solutions S.L.",
"tax_id": {
"country": "ES",
"code": "B24830515"
},
"addresses": [
{
"num": "532",
"street": "Avenida Diagonal",
"locality": "Barcelona",
"region": "Barcelona",
"code": "08006",
"country": "ES"
}
]
},
"customer": {
"name": "Cliente Ejemplo S.L.",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"quantity": "1",
"item": {
"name": "Servicio de consultoría",
"price": "500.00"
},
"taxes": [
{
"cat": "VAT",
"rate": "general"
}
]
}
]
}
```
The Catalan tourist tax (IEET, *Impost sobre les Estades en Establiments Turístics*) is a regional tax administered by the Agència Tributària de Catalunya — not the AEAT — so it is **not** classified as a tax in the VERI\*FACTU record. Hotels declare it directly to the Generalitat through the quarterly Modelo 950.
Model the IEET as a document-level [`charge`](https://docs.gobl.org/draft-0/bill/invoice#charge) with `key: "tax"`. This keeps it outside the VAT base (Art. 35 of Llei 5/2017 requires it to be shown separately from the consideration) and lets it flow into the invoice's `ImporteTotal` for VERI\*FACTU without being reported as a tax category.
Do not model the IEET as a `VAT` tax line — it is a fixed amount per night, not a percentage, and should not be reported to the AEAT. The `reason` field on the charge is what appears on the guest's invoice, so include the establishment type, location, nights, and rate for a clear breakdown.
```json B2C Hotel + IEET (Catalonia tourist tax) theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$addons": [
"es-verifactu-v1"
],
"$tags": [
"simplified"
],
"series": "SAMPLE",
"issue_date": "2026-05-06",
"supplier": {
"name": "Hotel Barcelona Example SL",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"locality": "Barcelona",
"code": "08001",
"country": "ES"
}
]
},
"customer": {
"name": "John Smith",
"addresses": [
{
"locality": "London",
"country": "GB"
}
]
},
"lines": [
{
"quantity": "3",
"item": {
"name": "Double room — 3 nights",
"price": "180.00",
"unit": "day"
},
"taxes": [
{
"cat": "VAT",
"rate": "reduced"
}
]
}
],
"charges": [
{
"key": "tax",
"reason": "IEET — Hotel 4★, Barcelona city — 3 nights × 1 guest × €3.40",
"amount": "10.20"
}
]
}
```
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"$tags": [
"simplified"
],
"type": "standard",
"series": "SAMPLE",
"issue_date": "2026-05-06",
"currency": "EUR",
"tax": {
"ext": {
"es-verifactu-doc-type": "F2"
}
},
"supplier": {
"name": "Hotel Barcelona Example SL",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"locality": "Barcelona",
"code": "08001",
"country": "ES"
}
]
},
"customer": {
"name": "John Smith",
"addresses": [
{
"locality": "London",
"country": "GB"
}
]
},
"lines": [
{
"i": 1,
"quantity": "3",
"item": {
"name": "Double room — 3 nights",
"price": "180.00",
"unit": "day"
},
"sum": "540.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "reduced",
"percent": "10.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "540.00"
}
],
"charges": [
{
"i": 1,
"key": "tax",
"reason": "IEET — Hotel 4★, Barcelona city — 3 nights × 1 guest × €3.40",
"amount": "10.20"
}
],
"totals": {
"sum": "540.00",
"charge": "10.20",
"total": "550.20",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "540.00",
"percent": "10.0%",
"amount": "54.00"
}
],
"amount": "54.00"
}
],
"sum": "54.00"
},
"tax": "54.00",
"total_with_tax": "604.20",
"payable": "604.20"
}
}
```
After uploading you'll see the document in the **Invoices** section with status `Empty`.
Send the invoice to the NO VERI\*FACTU workflow using the [Create a job](/api-ref/transform/jobs/create-a-job-post) endpoint. Use:
* `workflow_id`: use the Workflow ID of the *NO VERI\*FACTU invoice* workflow we created during setup
* `silo_entry_id`: use the Silo Entry ID of the invoice you've just uploaded.
The invoice's status will change to `Recorded` when the workflow completes successfully. The signed XML record will be available in the "Files" section of the silo entry, and the generated PDF will include the required QR code.
## Issue a Credit Note (Rectificativa por Diferencias)
In Spain, one way to correct an invoice is by issuing a credit note, known as a *Rectificativa por Diferencias*.
An alternative method is to issue a *Rectificativa por Sustitución*, which involves creating a new invoice with the type corrective.
The difference between the two is subtle but important:
* A credit note adjusts the value of the original invoice.
* A corrective invoice replaces the original invoice entirely.
For example, if you issued an invoice for 100 EUR but later realized it should have been 80 EUR, you can either:
* Issue a credit note for 20 EUR, or
* Issue a corrective invoice for 80 EUR.
Unless you have a specific requirement to use a corrective invoice we recommend only using credit notes. They're more widely supported across countries, while corrective invoices are specific to a few jurisdictions like Spain.
A credit note in Invopop is an invoice of the type credit note. The process is very similar to uploading an invoice, use the [Create an entry](/api-ref/silo/entries/create-an-entry-put) endpoint to upload a credit note. Include an [invoice](https://docs.gobl.org/draft-0/bill/invoice) object in the [data](/api-ref/silo/entries/create-an-entry-put#body-data), with these required fields:
* `regime`: `ES`
* Add the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon
* `supplier`: use the same supplier details as in the original invoice
* `type`: `credit-note`
* `preceding`: references the original invoice, within it, you must include:
* `uuid`: the UUID of the original invoice (optional but recommended)
* `type`: type of the original invoice
* `issue_date`: the date of the original invoice
* `series`: the series of the original invoice
* `code`: the code of the original invoice
You can copy the example credit note below as a reference.
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"uuid": "01971bb1-1499-7001-81ea-26f51cf396e1",
"type": "credit-note",
"series": "CN",
"issue_date": "2025-05-29",
"currency": "EUR",
"preceding": [
{
"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
"type": "standard",
"issue_date": "2024-11-13",
"series": "SAMPLE",
"code": "004"
}
],
"tax": {
"ext": {
"es-verifactu-correction-type": "I",
"es-verifactu-doc-type": "R1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
}
}
```
After successful upload, you'll see the credit note in the **Invoices** section with status `Empty`.
Send the credit note to the NO VERI\*FACTU workflow using the [Create a job](/api-ref/transform/jobs/create-a-job-post) endpoint. Use:
* `workflow_id`: use the Workflow ID of the *NO VERI\*FACTU invoice* workflow we created during setup
* `silo_entry_id`: use the Silo Entry ID of the credit note you've just uploaded.
The credit note's status will change to `Recorded` when the workflow completes successfully.
## Issue a Corrective Invoice (Rectificativa por Sustitución)
A corrective invoice in Invopop is an invoice of the type `corrective`. The process is very similar to uploading an invoice, use the [Create an entry](/api-ref/silo/entries/create-an-entry-put) endpoint to upload a corrective invoice. Include an [invoice](https://docs.gobl.org/draft-0/bill/invoice) object in the [data](/api-ref/silo/entries/create-an-entry-put#body-data), with these required fields:
* `regime`: `ES`
* Add the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon
* `supplier_id`: use the same supplier details as in the original invoice
* `type`: `corrective`
* `preceding`: references the original invoice, within it, you must include:
* `uuid`: the UUID of the original invoice (optional but recommended)
* `type`: type of the original invoice
* `issue_date`: the date of the original invoice
* `series`: the series of the original invoice
* `code`: the code of the original invoice
* `tax`: the tax section of the original invoice, you can copy it from the original invoice
You can copy the example corrective invoice below as a reference.
```json Built version theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "corrective",
"series": "CO",
"issue_date": "2025-05-29",
"currency": "EUR",
"preceding": [
{
"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
"type": "standard",
"issue_date": "2024-11-13",
"series": "SAMPLE",
"code": "004",
"tax": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
}
}
],
"tax": {
"ext": {
"es-verifactu-correction-type": "S",
"es-verifactu-doc-type": "R1"
}
},
"supplier": {
"name": "Invopop S.L.",
"tax_id": {
"country": "ES",
"code": "B85905495"
},
"addresses": [
{
"num": "42",
"street": "Calle Pradillo",
"locality": "Madrid",
"region": "Madrid",
"code": "28002",
"country": "ES"
}
]
},
"customer": {
"name": "Sample Consumer",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"i": 1,
"quantity": "20",
"item": {
"name": "Development services",
"price": "90.00",
"unit": "h"
},
"sum": "1800.00",
"taxes": [
{
"cat": "VAT",
"key": "standard",
"rate": "general",
"percent": "21.0%",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
}
}
],
"total": "1800.00"
}
],
"totals": {
"sum": "1800.00",
"total": "1800.00",
"taxes": {
"categories": [
{
"code": "VAT",
"rates": [
{
"key": "standard",
"ext": {
"es-verifactu-op-class": "S1",
"es-verifactu-regime": "01"
},
"base": "1800.00",
"percent": "21.0%",
"amount": "378.00"
}
],
"amount": "378.00"
}
],
"sum": "378.00"
},
"tax": "378.00",
"total_with_tax": "2178.00",
"payable": "2178.00"
}
}
```
After successful upload, you'll see the corrective invoice in the **Invoices** section with status `Empty`.
Send the corrective invoice to the NO VERI\*FACTU workflow using the [Create a job](/api-ref/transform/jobs/create-a-job-post) endpoint. Use:
* `workflow_id`: use the Workflow ID of the *NO VERI\*FACTU invoice* workflow we created during setup
* `silo_entry_id`: use the Silo Entry ID of the corrective invoice you've just uploaded.
The corrective invoice's status will change to `Recorded` when the workflow completes successfully.
## Issue a Replacement Invoice (Factura de Canje)
A replacement invoice (*Factura de Canje*) is used to replace a simplified invoice with a full invoice. This is common when a customer who originally received a simplified invoice (e.g., a receipt) later requests a full invoice with their tax identification details.
A replacement invoice is a standard invoice with the `replacement` tag. Use the [Create an entry](/api-ref/silo/entries/create-an-entry-put) endpoint to upload the replacement invoice. Include an [invoice](https://docs.gobl.org/draft-0/bill/invoice) object in the [data](/api-ref/silo/entries/create-an-entry-put#body-data), with these required fields:
* `regime`: `ES`
* Add the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon
* `type`: `standard`
* `tax.tags`: include `replacement`
* `supplier`: use the same supplier details as in the original invoice
* `preceding`: references the original simplified invoice, within it, you must include:
* `type`: type of the original invoice
* `issue_date`: the date of the original invoice
* `series`: the series of the original invoice
* `code`: the code of the original invoice
You can copy the example replacement invoice below as a reference.
```json Factura de canje theme={"system"}
{
"$schema": "https://gobl.org/draft-0/bill/invoice",
"$regime": "ES",
"$addons": [
"es-verifactu-v1"
],
"type": "standard",
"tax": {
"tags": [
"replacement"
]
},
"series": "FC",
"issue_date": "2026-02-26",
"currency": "EUR",
"preceding": [
{
"type": "standard",
"issue_date": "2026-02-20",
"series": "FS",
"code": "001"
}
],
"supplier": {
"name": "Easor Software Solutions S.L.",
"tax_id": {
"country": "ES",
"code": "B24830515"
},
"addresses": [
{
"num": "532",
"street": "Avenida Diagonal",
"locality": "Barcelona",
"region": "Barcelona",
"code": "08006",
"country": "ES"
}
]
},
"customer": {
"name": "Cliente Ejemplo S.L.",
"tax_id": {
"country": "ES",
"code": "B63272603"
}
},
"lines": [
{
"quantity": "1",
"item": {
"name": "Servicio de consultoría",
"price": "500.00"
},
"taxes": [
{
"cat": "VAT",
"rate": "general"
}
]
}
]
}
```
After successful upload, you'll see the replacement invoice in the **Invoices** section with status `Empty`.
Send the replacement invoice to the NO VERI\*FACTU workflow using the [Create a job](/api-ref/transform/jobs/create-a-job-post) endpoint. Use:
* `workflow_id`: use the Workflow ID of the *NO VERI\*FACTU invoice* workflow we created during setup
* `silo_entry_id`: use the Silo Entry ID of the replacement invoice you've just uploaded.
The replacement invoice's status will change to `Recorded` when the workflow completes successfully.
## Cancel an Invoice
NO VERI\*FACTU allows you to cancel an invoice by generating a cancellation record. Unlike VERI\*FACTU, the cancellation is not sent to the AEAT — it is signed and stored locally.
In general, you should only cancel an invoice if it hasn't been handed to the customer. Canceling an invoice doesn't produce a second document to hand to your customer. If the invoice has already been delivered, we recommend issuing a credit note instead.
To cancel an invoice, you need a workflow with the *Generate Cancellation Record* and *Store Record* steps. You can start with the template below.
This workflow will generate and store a cancellation record.
Copy and paste into a new [Empty Invoice workflow](https://console.invopop.com/redirect/workflows/new?template=empty-invoice) code view.
```json Example NO VERI*FACTU cancel workflow with states expandable theme={"system"}
{
"name": "NO VERI*FACTU cancel invoice",
"description": "Cancel an invoice via NO VERI*FACTU",
"schema": "bill/invoice",
"steps": [
{
"id": "b2c3d4e0-0002-11f1-a000-000000000005",
"name": "Set state",
"provider": "silo.state",
"summary": "Set state to `processing`{.state .processing}",
"config": {
"state": "processing"
}
},
{
"id": "9f500280-3ca4-11f1-90b7-0d81b4010093",
"name": "Generate cancellation for NO VERI*FACTU",
"provider": "gov-es.noverifactu.generate.cancel"
},
{
"id": "a6eeb180-3ca4-11f1-90b7-0d81b4010093",
"name": "Record for NO VERI*FACTU",
"provider": "gov-es.noverifactu.record"
},
{
"id": "b2c3d4e0-0002-11f1-a000-000000000003",
"name": "Set state",
"provider": "silo.state",
"summary": "Set state to `void`{.state .void}",
"config": {
"state": "void"
}
}
],
"rescue": [
{
"id": "b2c3d4e0-0002-11f1-a000-000000000004",
"name": "Set state",
"provider": "silo.state",
"summary": "Set state to `error`{.state .error}",
"config": {
"state": "error"
}
}
]
}
```
Before starting, review the [workflows guide](/guides/features/workflows) to understand the general setup process.
In [Console](https://console.invopop.com), create a new workflow and choose [Empty Invoice workflow](https://console.invopop.com/redirect/workflows/new?template=empty-invoice) as the base. Then name the workflow with a descriptive label such as "NO VERI\*FACTU Cancel Invoice".
We recommend adding the following steps:
1. **Set state** — select "Processing".
2. **Generate Cancellation Record** — Generates and signs the cancellation XML record.
3. **Store Record** — Persists the signed cancellation record.
4. **Set state** — select *Void* in the step configuration.
In the Error Handling area, **Set state** — select `Error`.
To cancel an invoice, simply send it to the NO VERI\*FACTU cancel invoice workflow created earlier using the [Create a job](/api-ref/transform/jobs/create-a-job-post) endpoint.
The invoice's status will change to `Void` when the workflow completes successfully.
***
| | |
| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Compliance | [Invoicing compliance in Spain](/compliance/spain)
[Compliance timeline](/timelines/spain) |
| Apps | [Spain](/apps/spain)
[VERI\*FACTU Spain](/apps/verifactu-spain)
[TicketBAI Spain](/apps/ticketbai-spain) |
| Guides | [Facturae Guide](/guides/es-facturae)
[VERI\*FACTU Invoicing Guide](/guides/es-verifactu)
[VERI\*FACTU Supplier Onboarding](/guides/es-verifactu-supplier)
[SII Invoicing Guide](/guides/es-sii)
[SII Supplier Onboarding](/guides/es-sii-supplier)
[TicketBAI Guide](/guides/es-ticketbai) |
| FAQ | [Spain FAQ](/faq/spain) |
| GOBL | [Spain Tax Regime](https://docs.gobl.org/regimes/es)
[VERI\*FACTU Addon](https://docs.gobl.org/addons/es-verifactu-v1)
[Facturae Addon](https://docs.gobl.org/addons/es-facturae-v3)
[SII Addon](https://docs.gobl.org/addons/es-sii-v1) |
| GitHub | [gobl.facturae](https://github.com/invopop/gobl.facturae)
[gobl.verifactu](https://github.com/invopop/gobl.verifactu)
[gobl.ticketbai](https://github.com/invopop/gobl.ticketbai) |
Find answers to frequently asked questions about invoicing in Spain →
Ask and answer questions about invoicing in Spain →