Spain - VeriFactu

Introduction

VeriFactu 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 VeriFactu invoicing:

Connect the VeriFactu app

Navigate to Configuration > Apps.
Locate VeriFactu in the app discovery list.
Click Connect to activate.

No additional configuration is needed.

Configure invoice workflow

First, review our workflows guide to understand the basics.

Create an Invoices workflow with these essential steps:

Sign Envelope - Signs the VeriFactu document. Can be substituted with Add Sequential Code with the Sign Document option enabled.
Generate VeriFactu (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.
Send VeriFactu (Spain) - Submits the generated XML to AEAT gateway and returns a response.
Generate PDF - Generates the PDF invoice with the required QR code.

VeriFactu does not allow document modifications after submission. If a document is rejected, you must create a new document with corrections and submit again.

You can copy and paste the following JSON while editing a Workflow in “developer” mode. This example adds support for setting states on silo entries, which we strongly recomend.

{
    "name": "VeriFactu Invoice",
    "description": "Convert to VeriFactu, send to AEAT and generate PDF",
    "steps": [
        {
            "id": "59f4dee0-bc8f-11ef-8ca1-573cbe7db4cd",
            "name": "Set State",
            "config": {
                "state": "processing"
            },
            "summary": "Set state to `processing`{.state .processing}",
            "provider": "silo.state"
        },
        {
            "id": "4efb9330-bc8f-11ef-8ca1-573cbe7db4cd",
            "name": "Sign Envelope",
            "next": [
                {
                    "status": "KO",
                    "step_id": "798b1d00-bc8f-11ef-8ca1-573cbe7db4cd"
                }
            ],
            "provider": "silo.close"
        },
        {
            "id": "ef2ce710-bc8e-11ef-8ca1-573cbe7db4cd",
            "name": "Generate Verifactu (Spain)",
            "next": [
                {
                    "status": "KO",
                    "step_id": "798b1d00-bc8f-11ef-8ca1-573cbe7db4cd"
                }
            ],
            "provider": "verifactu.generate"
        },
        {
            "id": "61661540-bc8f-11ef-8ca1-573cbe7db4cd",
            "name": "Send Verifactu (Spain)",
            "next": [
                {
                    "status": "KO",
                    "step_id": "798b1d00-bc8f-11ef-8ca1-573cbe7db4cd"
                }
            ],
            "provider": "verifactu.send"
        },
        {
            "id": "65312700-bc8f-11ef-8ca1-573cbe7db4cd",
            "name": "Generate PDF",
            "next": [
                {
                    "status": "KO",
                    "step_id": "798b1d00-bc8f-11ef-8ca1-573cbe7db4cd"
                }
            ],
            "config": {
                "locale": "es",
                "date_format": "%Y-%m-%d",
                "logo_height": 40
            },
            "summary": "Spanish",
            "provider": "pdf"
        },
        {
            "id": "6abb4de0-bc8f-11ef-8ca1-573cbe7db4cd",
            "name": "Set State",
            "next": [
                {
                    "stop": true,
                    "status": "NA"
                }
            ],
            "config": {
                "state": "sent"
            },
            "summary": "Set state to `sent`{.state .sent}",
            "provider": "silo.state"
        },
        {
            "id": "798b1d00-bc8f-11ef-8ca1-573cbe7db4cd",
            "name": "Set State",
            "config": {
                "state": "error"
            },
            "summary": "Set state to `error`{.state .error}",
            "provider": "silo.state"
        }
    ]
}

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

{
		"$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": "billing@example.com"
				}
			]
		},
		"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"
			}
		]
	}

{
		"$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": "billing@example.com"
				}
			]
		},
		"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"
			}
		]
	}

Introduction

API

Guides

Spain - VeriFactu

Introduction

Prerequisites

Setup

Running

Example Invoices

FAQ

Introduction

API

Guides

​Introduction

​Prerequisites

​Setup

​Running

​Example Invoices

​FAQ

Introduction

Prerequisites

Setup

Running

Example Invoices

FAQ