> ## 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. # VERI*FACTU Spain > Convert and send invoices to the Spanish tax authorities using the VERI*FACTU system.
View implementation guide › View implementation guide ›
| | | | --------- | ------------------------------ | | Developer | [Invopop](https://invopop.com) | | Category | Government | | Scope | B2B, B2C | | Country | [Spain](/compliance/spain) | Invopop's **VERI\*FACTU app** is designed to support full compliance with Spain’s VERI\*FACTU e-invoicing regulation. It provides endpoints and workflows to automate supplier onboarding, document upload, identity verification, and invoice generation, enabling businesses and intermediaries to issue e-invoices in accordance with Spanish law. **Key Features** 1. **Workflow Automation:** this app makes several workflow actions available to issue invoices and onboard suppliers. 2. **Legally compliant PDF invoices:** VERI\*FACTU requires QR codes to consult the status of a document with the AEAT. This app will automatically generate compliant PDF invoices. 3. **VERI\*FACTU XML generation:** this app will generate a legally compliant XML which is included as an attachment in the Silo Entry and sent to the tax agency when issuing an invoice. 4. **Supplier Registration & Verification:** this app will generate a registration link where suppliers will upload their identity documents and sign an agreement to issue invoices under their name (also available through the API). 5. **White-Label:** the process allows issuance on behalf of clients (white-label) or directly as an organization, according to user needs. 6. **QR Code:** Generates the VERI\*FACTU QR code according to the AEAT specifications. Make sure to check out our VERI\*FACTU implementation guides for instructions on how to [issue invoices](/guides/es-verifactu)) and [onboard suppliers](/guides/es-verifactu-supplier). ## FAQ Invoicing questions You should send the credit note with the same sign as the original invoice. In Spain, unlike other countries, credit notes must be submitted to Hacienda with inverse values. Invopop handles this conversion automatically before transforming the credit note into a "factura rectificativa" (corrective invoice). This means you only need to send the credit note following international standards (with same sign as the invoice). Invopop will automatically adapt it when submitting to Hacienda. For reference, see the [GOBL Invoice](https://docs.gobl.org/draft-0/bill/invoice) documentation with `type` set to `credit-note`. See the [Spain tax regime in GOBL](https://docs.gobl.org/regimes/es) for tax categories, NIF rules, and Spanish-specific extensions. Subsystem-specific addons live alongside: [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1), [`es-tbai-v1`](https://docs.gobl.org/addons/es-tbai-v1), [`es-facturae-v3`](https://docs.gobl.org/addons/es-facturae-v3). In VERI\*FACTU, 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. The response from VERI\*FACTU should contain all the details you need to be able to decide what changes need to be made to the [GOBL](https://docs.gobl.org) 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 substitution document is generated by checking previous attempts and including the correct codes in the new request. We do not provide the QR code image itself. The QR code is a visual representation of a URL that you need to generate on your own if you're creating custom PDFs or need it for any other purpose. The full requirements are in the AEAT [VERI\*FACTU QR specification](https://www.agenciatributaria.es/static_files/AEAT_Desarrolladores/EEDD/IVA/VERI-FACTU/DetalleEspecificacTecnCodigoQRfactura.pdf) PDF document in Spanish. Here you can read that: > The "QR" code must have a size between 30x30 and 40x40 millimeters and follow the specifications of the ISO/IEC 18004:2015 standard. For the generation of the "QR" code, the M (medium) error correction level shall be used. Generate your own QR code image as follows: * **API**: fetch the entry and get `data -> head -> stamps -> verifactu-qr`. * **Console**: in the invoice entry click on the kebab `···` menu and select **View Headers**. Use the VERI\*FACTU URL in a library capable of generating ISO/IEC 18004:2015 QR images (Invopop uses [go-qr](https://github.com/piglig/go-qr)) Store or embed the image in your PDF. You can [see how we generate QR images](https://github.com/invopop/gobl.html/blob/main/components/images/images.go) in our open source gobl.html library. 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 request. Its important to understand the VERI\*FACTU focuses 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. The most common errors are related to format issues or invalid extensions, which are already handled in Invopop through the [`es-verifactu-v1`](https://docs.gobl.org/addons/es-verifactu-v1) addon validations. These prevent most of the typical problems before they reach the submission stage. Among the errors that aren't yet validated on our side, the five most frequent ones are: * `4104: Error en la cabecera: el valor del campo NIF del bloque ObligadoEmision no está identificado.` → The issuer's name must match what's registered for that NIF (tax ID). * `4102: El XML no cumple el esquema. Falta informar campo obligatorio.` → Usually occurs when a required field is missing in the XML, often within the Desglose (taxes) section. * `1110: El NIF no está identificado en el censo de la AEAT.` → The provided NIF (tax ID) isn't found in the AEAT registry (often due to typos or testing data). * `3000: Registro de facturación duplicado.` → Triggered when issuing the same invoice series/code twice. * `2001: El NIF del bloque Destinatarios no está identificado en el censo de la AEAT.` → Similar to 1110, but applies to the NIF (tax ID) of the customer. You can set your own description using the notes object in the invoice. The key used for the description needs to be set to general. For example: ``` "notes": [ { "key": "general", "text": "This will appear as DescripcionOperacion" } ] ``` We generate a default description if the note is not provided which is what you are currently seeing. This default description will neatly cut off before it reaches a length of 500 characters as that is the limit the AEAT imposes. | Key | Text | | ------------------- | ------------------------------------------------------------ | | `reverse-charge` | Reverse Charge / Inversión del sujeto pasivo. | | `simplified-scheme` | Factura expedida por contribuyente en régimen simplificado. | | `self-billed` | Facturación por el destinatario. | | `travel-agency` | Régimen especial de las agencias de viajes. | | `second-hand-goods` | Régimen especial de los bienes usados. | | `art` | Régimen especial de los objetos de arte. | | `antiques` | Régimen especial de las antigüedades y objetos de colección. | | `cash-basis` | Régimen especial del criterio de caja. | Registering supplier questions We reject agreements when: * The uploaded document is not signed (they upload the unsigned template). * Users upload a handwritten signature without and ID. * The electronic signature is made with an FNMT certificate. * The agreement is missing a date or location. * The name is entered as an email address. The job will state the reason for rejection. A KO will be triggered and the supplier will be labelled with the `Error` state. We currently recommend sending a reminder to the supplier through a webhook. The registration link will not expire and the entity will still be able to upload their registration documents which will be validated. Should you choose to run this workflow again using this supplier, the supplier will be accepted or rejected immediately because the required documentation has already been provided and validated. If the uploaded agreement documents were rejected, a KO will be triggered and the supplier will be labelled with the `Error` state. We currently recommend sending a notification to the supplier through a webhook within the **Error Handling** section. Afterwards, if you wish to re-register the supplier with new documents, you must: 1. Unregister the supplier using the **Unregister Supplier workflow**. 2. Re-run the Register supplier workflow. This will restart the entire registration process. When uploading documents, the previously submitted agreement will appear selected by default. Simply choose a new file and click `Continue` to override the old one. See the image below for reference: Overriding the previously submitted agreement In order to complete the representation agreement you will need to provide the following information: **Company** 1. Name 2. NIF 3. Address **Legal representative** 1. Full name 2. Government ID type and number 3. Address ```json Spain supplier example theme={"system"} { "$schema": "https://gobl.org/draft-0/org/party", "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "people": [ { "name": { "given": "Juan", "surname": "Pérez González" }, "identities": [ { "key": "national", "code": "123456789A" } ], "addresses": [ { "num": "10", "street": "Calle Ejemplo", "locality": "Madrid", "region": "Madrid", "code": "28020", "country": "ES" } ] } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] } ``` If the entity is an self-employed individual (*autónomo*), only the information requested in in the **Legal representative** section is required. ```json Spain autónomo supplier example theme={"system"} { "$schema": "https://gobl.org/draft-0/org/party", "name": "Juan Pérez González", "tax_id": { "country": "ES", "code": "B85905495" }, "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "autonomo@example.com" } ] } ``` The supplier can add their electronic signature to the PDF document ([instructions](https://helpx.adobe.com/acrobat/using/signing-pdfs.html)), or sign with a handwritten signature (we recommend using [Adobe's online service](https://www.adobe.com/acrobat/online/sign-pdf.html). Individual documents are limited to a maximum size of 10MB. Uploads exceeding this size will result in an error. Run the VERI\*FACTU Register Supplier workflow. The legal representative signs the PDF agreement (electronic or handwritten signature with ID) and Invopop registers the supplier with AEAT for invoicing on their behalf. More answers in our [Spain FAQ](/faq/spain) section The following workflow actions will be available once you install and enable this app:
1
Convert GOBL Invoices into VERI\*FACTU XML format used in Spain.
1
Send a previously generated VERI\*FACTU document to the tax agency in Spain. Send a cancel request for previously sent VERI\*FACTU Invoice. Register VERI\*FACTU parties before issuing invoices on their behalf. Block the job while waiting for the end-user to complete their registration steps. Wait for a approval that the uploaded documentation is correct. Disables a previously registered party from issuing invoices . Invoice workflows ```json Example VERI*FACTU invoice workflow theme={"system"} { "name": "VERI*FACTU issue invoice", "description": "Issue a VERI*FACTU invoice and generate PDF with QR", "schema": "bill/invoice", "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 · VERI*FACTU · 000001", "config": { "name": "Verifactu", "padding": 6, "start": 1 } }, { "id": "fc75e4f0-8721-11ef-a962-73e3f2037a52", "name": "Sign envelope", "provider": "silo.close" }, { "id": "ef2ce710-bc8e-11ef-8ca1-573cbe7db4cd", "name": "Generate VERI*FACTU XML", "provider": "verifactu.generate" }, { "id": "61661540-bc8f-11ef-8ca1-573cbe7db4cd", "name": "Send invoice to VERI*FACTU", "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 } }, { "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" } } ] } ``` ```json Example VERI*FACTU cancel workflow theme={"system"} { "name": "VERI*FACTU cancel invoice", "description": "Cancel an invoice via VERI*FACTU", "schema": "bill/invoice", "steps": [ { "id": "2f897e30-3c9c-11f0-8690-a921c0418914", "name": "Cancel invoice in VERI*FACTU", "provider": "verifactu.cancel" }, { "id": "334ffc10-3c9c-11f0-8690-a921c0418914", "name": "Set state", "provider": "silo.state", "summary": "Set state to `void`{.state .void}", "config": { "state": "void" } } ], "rescue": [ { "id": "384cfe20-3c9c-11f0-8690-a921c0418914", "name": "Set state", "provider": "silo.state", "summary": "Set state to `error`{.state .error}", "config": { "state": "error" } } ] } ``` Party workflows ```json Example VERI*FACTU register supplier workflow theme={"system"} { "name": "VERI*FACTU register supplier", "description": "Register a supplier with VERI*FACTU", "schema": "org/party", "steps": [ { "id": "74b9cf20-da92-11f0-864b-8d842f7d4ab2", "name": "Verify Spanish Tax ID", "provider": "gov-es.lookup.verify" }, { "id": "554c7040-66d7-11f0-a392-dfb6c99d6698", "name": "Register supplier with VERI*FACTU", "provider": "verifactu.register", "next": [] }, { "id": "62148880-66d7-11f0-a392-dfb6c99d6698", "name": "Set state", "provider": "silo.state", "summary": "Set state to `processing`{.state .processing}", "config": { "state": "processing" }, "next": [] }, { "id": "5b924600-66d7-11f0-a392-dfb6c99d6698", "name": "Wait for VERI*FACTU supplier agreement upload", "provider": "verifactu.wait.upload", "next": [] }, { "id": "6bec1080-66d7-11f0-a392-dfb6c99d6698", "name": "Set state", "provider": "silo.state", "summary": "Set state to `registered`{.state .registered}", "config": { "state": "registered" }, "next": [] }, { "id": "670d1dc0-66d7-11f0-a392-dfb6c99d6698", "name": "Wait for VERI*FACTU supplier approval", "provider": "verifactu.wait.approval", "next": [] } ], "rescue": [ { "id": "4be625f0-da6d-11f0-864b-8d842f7d4ab2", "name": "Unregister supplier from VERI*FACTU", "provider": "verifactu.unregister" }, { "id": "535bf030-da6d-11f0-864b-8d842f7d4ab2", "name": "Set state", "provider": "silo.state", "summary": "Set state to `rejected`{.state .rejected}", "config": { "state": "rejected" } } ] } ``` ```json Example VERI*FACTU unregister supplier workflow theme={"system"} { "name": "VERI*FACTU unregister supplier", "description": "Unregister a supplier from VERI*FACTU", "schema": "org/party", "steps": [ { "id": "8a613610-67ba-11f0-bcaf-170efff782a9", "name": "Unregister supplier from VERI*FACTU", "provider": "verifactu.unregister" }, { "id": "96a6b0d0-67ba-11f0-bcaf-170efff782a9", "name": "Set state", "provider": "silo.state", "summary": "Set state to `void`{.state .void}", "config": { "state": "void" } } ], "rescue": [ { "id": "e8d2a6b0-67bb-11f0-bcaf-170efff782a9", "name": "Set state", "provider": "silo.state", "summary": "Set state to `error`{.state .error}", "config": { "state": "error" } } ] } ``` Invoices: 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" } } ``` Suppliers: To register a company supplier in Spain you must provide: * **Company information**: name, NIF (tax identification number), and address * **Legal representative information**: full name, government ID type and number (DNI, NIE, or passport), and address The legal representative is the person authorized to sign the representation agreement on behalf of the company. The supplier must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority before invoices can be issued on their behalf. ```json Spain supplier example theme={"system"} { "$schema": "https://gobl.org/draft-0/org/party", "name": "Invopop S.L.", "tax_id": { "country": "ES", "code": "B85905495" }, "people": [ { "name": { "given": "Juan", "surname": "Pérez González" }, "identities": [ { "key": "national", "code": "123456789A" } ], "addresses": [ { "num": "10", "street": "Calle Ejemplo", "locality": "Madrid", "region": "Madrid", "code": "28020", "country": "ES" } ] } ], "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "billing@example.com" } ] } ``` An *autónomo* is self-employed individuals in Spain who operate as sole proprietors. To register them, a NIF (tax id number) with the corresponding full name and address must be provided. Unlike company suppliers, autónomos do not require separate legal representative information since the individual is the authorized signatory. The supplier must be [previously registered](https://docs.invopop.com/guides/es-verifactu-supplier#create-a-supplier-entry) with the tax authority before invoices can be issued on their behalf. ```json Spain autónomo supplier example theme={"system"} { "$schema": "https://gobl.org/draft-0/org/party", "name": "Juan Pérez González", "tax_id": { "country": "ES", "code": "B85905495" }, "addresses": [ { "num": "42", "street": "Calle Pradillo", "locality": "Madrid", "region": "Madrid", "code": "28002", "country": "ES" } ], "emails": [ { "addr": "autonomo@example.com" } ] } ``` *** | | | | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 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) | Ask and answer questions about the VERI\*FACTU Spain App →