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

Configure your Invopop Workspace for VERI*FACTU invoicing by following these steps:

1. Connect the VERI*FACTU app

   1. Go to Configuration → Apps in the Console.
   2. Find VERI*FACTU Spain in the app list.
   3. Click Connect to activate the app.

   After connecting, you’ll see VERI*FACTU listed in the Enabled Apps section.

   
2. Configure the Supplier Registration Workflow

   Add a new workflow to your workspace for registering suppliers. You can start with the template below.

   Template

   VERI*FACTU supplier registration workflow

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

   Add to my workspace

   Keep the Workflow ID at hand, you’ll use it later.

3. Configure invoice workflow

   Add a new workflow to your workspace for issuing invoices. You can start with the template below.

   Template

   VERI*FACTU invoice workflow

   This workflow will issue an invoice through VERI*FACTU.

   Add to my workspace

   Keep the Workflow ID at hand, you’ll use it later.

   VERI*FACTU allows for document modifications after submission. If a document is rejected or contains errors, update the GOBL details and resubmit to the same workflow.

Running

Learn how to register a business entity (supplier) and issue VERI*FACTU invoices:

Register a Supplier

Invopop has a collaboration agreement with the Spanish tax agency (AEAT) that lets us issue invoices on behalf of any entity using our certificate. This eliminates the need for you to request the entity’s certificate.

However, we need the supplier to provide the following documents:

1. An agreement where the entity allows Invopop to submit invoices to AEAT on its behalf
2. A copy of signatory’s fiscal ID (DNI/NIE)
3. Documentation proving that signatory is authorized to represent the entity, such as extract from commercial registry, company bylaws or power of attorney

This is handled by the Supplier Registration Workflow we created during setup. Let’s see how.

1. Upload a Supplier

   Use the Create an entry endpoint to upload a new supplier. Include a party (you can copy the example below) object in the data field. The following fields are required:

   • name

   • tax_id

   • address

   • email

     Example supplier

     VeriFactu supplier example

     {
       "$schema": "https://gobl.org/draft-0/org/party",
       "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]"
         }
       ]
     }
     

   After successful upload, you’ll see the supplier in the Contacts section with status Empty.

   
2. Send the Supplier to the registration workflow

   Send the supplier to the registration workflow using the Create a job endpoint. Use:

   • The Silo Entry ID of the supplier you uploaded on the previous step
   • The Supplier Registration Workflow ID from the Setup section

   The supplier’s status will change to Registered when the workflow completes successfully.

   

This feature is currently in beta. The Registration Workflow assumes the agreement and necessary documents have been provided outside the system and simply marks the supplier as registered. We’ll soon provide a new workflow to manage signatures and documentation. Contact us at [e-mail] if you’re interested in using this feature.

Issue an Invoice

1. Upload an Invoice

   Use the Create an entry endpoint to upload the invoice details. Include an invoice object in the data field with these required fields:

   • regime: ES
   • Add the 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.

   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"
   			}
   		]
   	}
   

   After successful upload, you’ll see the invoice in the Invoices section with status Empty.

   
2. Send the Invoice to the VERI*FACTU invoice workflow

   Send the invoice to the VERI*FACTU workflow using the Create a job endpoint. Use:

   • workflow_id: use the Workflow ID of the _VERI*FACTU invoice: workflow we created during setup
   • silo_entry_id: use the The Silo Entry ID of the invoice you’ve just uploaded.

   The invoice’s status will change to Sent when the workflow completes successfully.

   

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 but later realized it should have been €80, you can either:

• Issue a credit note for €20, or
• Issue a corrective invoice for €80.

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.

1. Upload a Credit Note

   A credit note in Invopop is an invoice of the type credit note. So the process is very similar to uploading an invoice. Use the Create an entry endpoint to upload a credit note. Include an invoice object in the data, with these required fields:

   • regime: ES
   • Add the 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 one of the example credit notes below as a reference.

   Credit Note

   VERI*FACTU Credit Note

   {
       "$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"
               }
           ],
           "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"
           }
       ]
   }
   

   After successful upload, you’ll see the credit note in the Invoices section with status Empty. If you’ve included the uuid of the invoice in preceding, you’ll see a link to the credit note we’ve just created in the Related tab of the invoice.

   
2. Send the Credit Note to the VERI*FACTU invoice workflow

   Send the credit note to the VERI*FACTU workflow using the Create a job endpoint. Use:

   • workflow_id: use the Workflow ID of the _VERI*FACTU invoice _workflow we created during setup
   • silo_entry_id: use the The Silo Entry ID of the credit note you’ve just uploaded.

   The credit note’s status will change to Sent when the workflow completes successfully.

Issue a Corrective Invoice (Rectificativa por Sustitución)

1. Upload a Corrective Invoice

   A corrective invoice in Invopop is an invoice of the type corrective. So the process is very similar to uploading an invoice. Use the Create an entry endpoint to upload a corrective invoice. Include an invoice object in the data, with these required fields:

   • regime: ES
   • Add the 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 one of the example corrective invoices below as a reference.

   Corrective Invoice

   VERI*FACTU Corrective Invoice

   {
       "$schema": "https://gobl.org/draft-0/bill/invoice",
       "$regime": "ES",
       "$addons": [
           "es-verifactu-v1"
       ],
       "uuid": "01971bcb-dd09-7001-b5c0-95e72f3f1a8c",
       "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"
               }
           ],
           "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"
           }
       ]
   }
   

   After successful upload, you’ll see the corrective invoice in the Invoices section with status Empty. If you’ve included the uuid of the invoice in preceding, you’ll see a link to the corrective invoice we’ve just created in the Related tab of the invoice.

   
2. Send the Corrective Invoice to the VERI*FACTU invoice workflow

   Send the corrective invoice to the VERI*FACTU workflow using the Create a job endpoint. Use:

   • workflow_id: use the Workflow ID of the VERI*FACTU invoice workflow we created during setup
   • silo_entry_id: use the The Silo Entry ID of the corrective invoice you’ve just uploaded.

   The corrective invoice’s status will change to Sent when the workflow completes successfully.

Cancel an Invoice

VERI*FACTU also allows you to cancel an invoice. In general, you should only cancel an invoice if it hasn’t been handed to the customer nor accepted by the tax authority.

Different from a credit note or a corrective, canceling an invoice doesn’t produce a second document, which means you don’t have a paper to hand to your customer to show the cancellation. That’s why, if the invoice has been handed to the customer, we recommend issuing a credit note instead.

1. Add a cancel invoice workflow (only once)

   To cancel an invoice, you need a workflow with the Cancel VERI*FACTU (Spain) step. You can start with the template below.

   Template

   VERI*FACTU cancel invoice workflow

   This workflow will cancel a VERI*FACTU document.

   Add to my workspace
2. Send to cancellation workflow

   To cancel an invoice, simply send it to the VERI*FACTU cancel invoice workflow we just created using the Create a job endpoint.

   The invoice’s status will change to Void when the workflow completes successfully.

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.