Spain · VERI*FACTU Guide

🇪🇸 Issue invoices in Spain with VERI*FACTU.

Introduction

VERI*FACTU is a fiscal initiative by the Spanish Tax Agency (AEAT) that requires businesses to report invoices through certified software. The system generates unique identifiers for each invoice and creates digitally signed XML files that are submitted to the tax authorities.

Prerequisites

To register a supplier and issue invoices, you need:

• Supplier details:
  • Company name
  • Spanish tax ID (NIF)
• For B2B sales, customer details including:
  • Tax ID (for Spanish/EU entities)
• Invoice line items with
  • Price
  • VAT rates

Setup

Follow these steps to configure your Invopop Workspace for VERI*FACTU invoicing:

1. Connect the VERI*FACTU app

   1. Navigate to Configuration → Apps.
   2. Locate VERI*FACTU in the app discovery list.
   3. Click Connect to activate.

   No additional configuration is needed.

2. Configure the supplier registration workflow

   Template

   Register Supplier workflow

   This workflow will issue a registration request for a supplier to complete.

   Select a workspace to use this template

   Register Supplier workflow

   This workflow will issue a registration request for a supplier to complete.

   Select a workspace to use this template

   Copy and paste into a new Empty Party workflow code view.

   Before starting, review the workflows guide to understand the general setup process.

   In Console, create a new workflow and choose Empty Party workflow as the base. Then name the workflow with a descriptive label such as “VERI*\FACTU Supplier Registration”.

   The new workflow will need to perform a single step:

   1. Register for VERI\FACTU* - Prepares the system so that provided supplier can send invoices.

   Finally, in the Error Handling area, add the Set State action and select Error.

   Add any additional steps you may need, and save the new workflow.

3. Configure invoice workflow

   Template

   VERI*FACTU Invoice Workflow

   This workflow will issue an invoice through VERI*\FACTU.

   Select a workspace to use this template

   VERI*FACTU Invoice Workflow

   This workflow will issue an invoice through VERI*\FACTU.

   Select a workspace to use this template

   Copy and paste into a new Empty Invoice workflow code view.

   {
       "name": "VERI*FACTU Invoice",
       "description": "Convert to VERI*FACTU, send to AEAT and generate PDF",
       "steps": [
           {
               "id": "59f4dee0-bc8f-11ef-8ca1-573cbe7db4cd",
               "name": "Set State",
               "provider": "silo.state",
               "summary": "Set state to `processing`{.state .processing}",
               "config": {
                   "state": "processing"
               }
           },
           {
               "id": "ec41cce0-0fc3-11f0-8a81-7911b3ecee3c",
               "name": "Add Sequential Code",
               "provider": "sequence.enumerate",
               "summary": "Dynamic · Verifactu · 000001",
               "config": {
                   "name": "Verifactu",
                   "padding": 6,
                   "sign": true,
                   "start": 1
               }
           },
           {
               "id": "ef2ce710-bc8e-11ef-8ca1-573cbe7db4cd",
               "name": "Generate Verifactu (Spain)",
               "provider": "verifactu.generate"
           },
           {
               "id": "61661540-bc8f-11ef-8ca1-573cbe7db4cd",
               "name": "Send Verifactu (Spain)",
               "provider": "verifactu.send"
           },
           {
               "id": "65312700-bc8f-11ef-8ca1-573cbe7db4cd",
               "name": "Generate PDF",
               "provider": "pdf",
               "summary": "Spanish - A4",
               "config": {
                   "date_format": "%Y-%m-%d",
                   "layout": "A4",
                   "locale": "es",
                   "logo_height": 60,
                   "logo_url": "https://ams3.digitaloceanspaces.com/invopop-console-files-dev/bebac1f29c0b782421bec81f518860200f17379da7a003a238eca16e8e5ede82"
               }
           },
           {
               "id": "6abb4de0-bc8f-11ef-8ca1-573cbe7db4cd",
               "name": "Set State",
               "provider": "silo.state",
               "summary": "Set state to `sent`{.state .sent}",
               "config": {
                   "state": "sent"
               }
           }
       ],
       "rescue": [
           {
               "id": "798b1d00-bc8f-11ef-8ca1-573cbe7db4cd",
               "name": "Set State",
               "provider": "silo.state",
               "summary": "Set state to `error`{.state .error}",
               "config": {
                   "state": "error"
               }
           }
       ]
   }
   

   In Console create a new workflow and select Empty Invoice workflow in the template selector, then add the following steps:

   1. Sign Envelope - Signs the VERI*FACTU document. Can be substituted with Add Sequential Code with the Sign Document option enabled.
   2. Generate VERI*FACTU (Spain) - Creates the required XML document, adding it to the chain and fingerprinting it. It can be seen in the Files section of the console.
   3. Send VERI*FACTU (Spain) - Submits the generated XML to AEAT gateway and returns a response.
   4. Generate PDF - Generates the PDF invoice with the required QR code.

   Finally, in the Error Handling area, add the Set State action and select “Error” in the State dropdown.

   VERI*FACTU allows for document modifications after submission. If a document is rejected or contains invalid information, make the modifications to the GOBL details and send again to the same workflow.

Running

Invopop uses the GOBL library to process conversions. Some example invoices are provided below, along with an example workflow to send the invoices to. We also recommend using the GOBL Builder to create your own invoices.

Be sure to set the regime field to ES in your invoices and add the es-verifactu-v1 addon. This will add some extra validations and normalizations to ensure the document is compliant, and automatically add the necessary extensions, details of which can be found here.

Example Invoices

B2C Standard Invoice

VERI*FACTU B2C Invoice

{
		"$schema": "https://gobl.org/draft-0/bill/invoice",
		"$regime": "ES",
		"$addons": [
			"es-verifactu-v1"
		],
    "$tags": [
      "simplified"
    ],
		"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
		"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"
				}
			],
			"emails": [
				{
					"addr": "[e-mail]"
				}
			]
		},
		"lines": [
			{
				"i": 1,
				"quantity": "20",
				"item": {
					"name": "Development services",
					"price": "90.00",
					"unit": "h"
				},
				"sum": "1800.00",
				"taxes": [
					{
						"cat": "VAT",
						"rate": "standard",
						"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"
			}
		]
	}

B2B Standard Invoice

VERI*FACTU B2B Invoice

{
		"$schema": "https://gobl.org/draft-0/bill/invoice",
		"$regime": "ES",
		"$addons": [
			"es-verifactu-v1"
		],
		"uuid": "3aea7b56-59d8-4beb-90bd-f8f280d852a0",
		"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"
				}
			],
			"emails": [
				{
					"addr": "[e-mail]"
				}
			]
		},
		"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": "standard",
						"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"
			}
		]
	}

FAQ

Is VERI*FACTU compliance mandatory in Spain?

VERI*FACTU is currently scheduled to be mandatory for businesses in Spain from July 1st, 2025. However, it is likely that the deadline will be extended to January 1st, 2026 for companies and to July 1st, 2026 for self-employed individuals. Refer to the proposal for more details.

How can I correct an invoice?

There are three ways to correct an invoice:

1. The recommended approach is to issue a GOBL Invoice with the type credit-note or debit-note, which in VERI*FACTU translates to a “Factura Rectificativa por Diferencias”.
2. If the above approach does not apply, you can issue an invoice of type corrective, which in VERI*FACTU translates to a “Factura Rectificativa por Sustitución”.
3. Lastly, you can use the Cancel VERI\*FACTU (Spain) step, which will void the invoice in the tax authority. This should only be used under special circumstances and not as part of a regular workflow.

What should I do if an invoice is rejected by VERI*FACTU?

The response from VERIFACTU should contain all the details you need to be able to decide what changes need to be made to the GOBL document in order to be processed correctly. Make the changes either via the Invopop API or console directly on the same document, and simply resend to the VERI\FACTU workflow.

Invopop will ensure that the correct substition document is generated by checking previous attempts and including the correct codes in the new request.

What is the VERI*FACTU chain?

VERI*FACTU requires every request to be linked with a fingerprint or hash. During the “Generate VERI*FACTU” and “Cancel VERI*FACTU” actions, Invopop will automatically find the last request made for the same supplier, and incorporate the chained data into the new reuqest.

Its important to understand the VERI*FACTU focusses on requests, and not individual documents; a single invoice may have multiple entries in the chain if it has been processed multiple times due to incorrect details, cancellations, or substitutions.

Invopop guarantees the chain is never broken using database transactions and retries in the case of collisions.