Spain

Manage all Spanish tax-agency integrations.

We’re progressively moving towards a country-based approach to our apps, which is why you will find these steps under the “Spain” app. You can expect our current VERI*FACTU functionality to be grouped under this app in the future. We will ensure no changes will be required for your existing workflows.

Description

TicketBAI Invoicing

View guide ›

SII Invoicing

View guide ›

NO VERI*FACTU Invoicing Guide

View guide ›

Facturae

View guide ›

TicketBAI Suppliers

View guide ›

SII Suppliers

View guide ›

Tax ID Lookup

View guide ›

NO VERI*FACTU Suppliers

View guide ›

Developer	Invopop
Category	Government
Scope	B2B
Country	Spain

Invopop’s Spain app provides comprehensive integration with Spanish tax agencies, centralizing all compliance requirements for electronic invoicing and tax reporting in Spain.

Feature	TicketBAI	SII
Scope	Basque Country (Álava, Gipuzkoa, Bizkaia)	Rest of Spain (AEAT)
Workflow automation	Issue invoices and onboard suppliers	Report invoices and onboard suppliers
Compliant documents	XML generation and PDF with QR codes	Invoice reporting to AEAT via SII API (with limitations)
Supplier registration	Registration wizard and agreement signing	Registration wizard and agreement signing
White-label	Issue on behalf of clients or directly	Report on behalf of clients or directly
Tax ID verification	Via AEAT Lookup	Via AEAT Lookup

Check out the guides below to get started:

• TicketBAI invoicing guide · TicketBAI supplier onboarding
• NO VERI*FACTU invoicing guide · NO VERI*FACTU supplier onboarding
• SII invoicing guide · SII supplier onboarding
• Spanish Tax ID Lookup guide · Facturae guide

Limitations

SII implementation scope

Our SII implementation is under active development and focuses on core functionality for the most common use cases. If these limitations affect your business requirements, please contact us to discuss your specific needs and our implementation roadmap.

The current SII integration provides a foundational implementation covering the primary VAT registry books required for most businesses operating in Spain. Understanding what is and isn’t supported will help you determine if this solution meets your compliance needs.

Supported Registry Books

We currently support the two most commonly used VAT registry books:

• Libro de Registro de Facturas Expedidas (Issued Invoices Registry)
• Libro de Registro de Facturas Recibidas (Received Invoices Registry) - with specific limitations

Unsupported Registry Books

The following VAT registry books are not supported at the moment:

• Libro de Registro de Bienes de Inversión (Investment Goods Registry)
• Libro de Registro de Determinadas Operaciones Intracomunitarias (Specific Intra-Community Operations Registry)
• Other registries such as cash payments (pagos en metálico), travel agency operations (operaciones de agencias de viajes), etc.

Received Invoices Limitations

When reporting to the Libro de Registro de Facturas Recibidas, the following key limitations apply:

1. Deductible VAT matching: The deductible VAT amount (cuota deducible) always equals the charged VAT amount (cuota repercutida). Invoices where the deductible VAT is lower than the charged VAT cannot be reported.

2. Investment goods flag: Invoices cannot be marked as investment goods (bienes de inversión) within the received invoices registry.

3. Deduction period alignment: The deduction period must match the settlement period. Deduction periods that differ from the liquidation periods cannot be specified.

These represent the primary limitations in the current implementation.

Regional Endpoints

Currently, only the AEAT (Agencia Estatal de Administración Tributaria) endpoint is supported for SII reporting. This covers businesses operating under the standard Spanish tax framework.

Support for the Canary Islands, Navarra and the Basque Country regional endpoints is coming soon.

Actions

The following workflow actions will be available once you install and enable this app:

AEAT Lookup actions

Verify Spanish Tax ID (NIF/CIF)

Verify & Correct Tax Details

Facturae actions

Generate Facturae XML

TicketBAI actions

Send TicketBAI (Spain)

Generate TicketBAI (Spain)

Cancel TicketBAI Invoice

Send a cancel request for a previously sent TicketBAI invoice.

Register with TicketBAI

Register TicketBAI parties before issuing invoices on their behalf.

Wait for Upload TicketBAI

Block the job while waiting for the end-user to complete their registration steps.

Wait for Approval TicketBAI

Wait for approval that the uploaded documentation is correct.

Unregister with TicketBAI

Disables a previously registered party from issuing invoices.

SII actions

Record Issued Invoice with SII

Record Received Invoice with SII

Register with SII

Register SII parties before reporting invoices on their behalf.

Wait for Upload SII

Block the job while waiting for the end-user to complete their registration steps.

Wait for Approval SII

Wait for approval that the uploaded documentation is correct.

Unregister with SII

Disables a previously registered party from reporting invoices.

NO VERI*FACTU actions

Generate NO VERI*FACTU Invoice Record

Generate and digitally sign an invoicing record XML from a GOBL invoice.

Generate NO VERI*FACTU Cancellation Record

Generate and digitally sign a cancellation record for a previously recorded invoice.

Generate NO VERI*FACTU Event Record

Generate and digitally sign an event record XML from a GOBL status.

Store NO VERI*FACTU Record

Persist a signed record in the database for regulatory compliance.

Build NO VERI*FACTU Status Event

Build a GOBL status event document and upload it as a silo entry.

Register with NO VERI*FACTU

Register a party for NO VERI*FACTU mode.

Unregister NO VERI*FACTU

Remove a party’s NO VERI*FACTU registration.

Workflows

TicketBAI invoice workflows

TicketBAI issue invoice

Example TicketBAI invoice workflow

{
  "name": "TicketBAI issue invoice",
  "description": "Send TicketBAI invoice and generate PDF with QR",
  "schema": "bill/invoice",
  "steps": [
    {
      "id": "dd319d60-8bc1-11ef-96af-b55bf69bb0b8",
      "name": "Add Sequential Code",
      "config": {
        "name": "TicketBAI Invoice",
        "start": 1,
        "prefix": "F",
        "padding": 6
      },
      "summary": "Dynamic · TicketBAI Invoice · F000001",
      "provider": "sequence.enumerate"
    },
    {
      "id": "ba77d5b0-7b3a-11ef-bffc-d9a10ebf9f89",
      "name": "Set State",
      "config": {
        "state": "processing"
      },
      "summary": "Set state to `processing`{.state .processing}",
      "provider": "silo.state"
    },
    {
      "id": "fc75e4f0-8721-11ef-a962-73e3f2037a52",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "fc618ea0-a757-11ef-8377-c15ac3014ffb",
      "name": "Generate TicketBAI (Spain)",
      "provider": "gov-es.ticketbai.generate"
    },
    {
      "id": "0448df60-a758-11ef-8377-c15ac3014ffb",
      "name": "Send TicketBAI (Spain)",
      "provider": "gov-es.ticketbai.send"
    },
    {
      "id": "c61adaa0-7b55-11ef-bffc-d9a10ebf9f89",
      "name": "Generate PDF",
      "config": {
        "locale": "es",
        "date_format": "%Y-%m-%d",
        "logo_height": 40
      },
      "summary": "Spanish",
      "provider": "pdf"
    },
    {
      "id": "d8693d70-7b3a-11ef-bffc-d9a10ebf9f89",
      "name": "Set State",
      "config": {
        "state": "sent"
      },
      "summary": "Set state to `sent`{.state .sent}",
      "provider": "silo.state"
    }
  ],
  "rescue": [
    {
      "id": "dd889490-7b3a-11ef-bffc-d9a10ebf9f89",
      "name": "Set State",
      "config": {
        "state": "error"
      },
      "summary": "Set state to `error`{.state .error}",
      "provider": "silo.state"
    }
  ]
}

TicketBAI cancel invoice

Example cancel TicketBAI workflow

{
    "name": "TicketBAI cancel document",
    "description": "Cancel a TicketBAI document and report it to the tax authority",
    "schema": "bill/invoice",
    "steps": [
        {
            "id": "2f897e30-3c9c-11f0-8690-a921c0418914",
            "name": "Cancel TicketBAI (Spain)",
            "provider": "gov-es.ticketbai.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"
            }
        }
    ]
}

TicketBAI party workflows

TicketBAI register party

Example TicketBAI supplier registration

{
    "name": "TicketBAI supplier registration",
    "description": "Enables suppliers to register for TicketBAI invoice generation",
    "schema": "org/party",
    "steps": [
        {
            "id": "554c7040-66d7-11f0-a392-dfb6c99d6698",
            "name": "Register with TicketBAI",
            "provider": "gov-es.ticketbai.register"
        },
        {
            "id": "62148880-66d7-11f0-a392-dfb6c99d6698",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "5b924600-66d7-11f0-a392-dfb6c99d6698",
            "name": "Wait for Upload TicketBAI",
            "provider": "gov-es.ticketbai.wait.upload"
        },
        {
            "id": "6bec1080-66d7-11f0-a392-dfb6c99d6698",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `registered`{.state .registered}",
            "config": {
                "state": "registered"
            }
        },
        {
            "id": "670d1dc0-66d7-11f0-a392-dfb6c99d6698",
            "name": "Wait for Approval TicketBAI",
            "provider": "gov-es.ticketbai.wait.approval"
        }
    ],
    "rescue": [
        {
            "id": "76c13260-66d7-11f0-a392-dfb6c99d6698",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

TicketBAI unregister party

Example unregister TicketBAI supplier

{
    "name": "TicketBAI unregister supplier",
    "description": "Revokes invoice issuing entitlement for a TicketBAI supplier",
    "schema": "org/party",
    "steps": [
        {
            "id": "8a613610-67ba-11f0-bcaf-170efff782a9",
            "name": "Unregister TicketBAI",
            "provider": "gov-es.ticketbai.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"
            }
        }
    ]
}

Facturae workflows

Facturae generate invoice

Example Facturae invoice workflow

{
    "name": "Facturae Generate Invoice",
    "description": "Generate a Facturae XML invoice",
    "schema": "bill/invoice",
    "steps": [
        {
            "id": "dc2d4780-0be4-11f1-99f1-2d47ed7bc202",
            "name": "Add Sequential Code",
            "provider": "sequence.enumerate",
            "summary": "Dynamic · Facturae · 000001",
            "config": {
                "name": "Facturae",
                "padding": 6,
                "start": 1
            }
        },
        {
            "id": "e2d8e3f0-0be4-11f1-99f1-2d47ed7bc202",
            "name": "Sign Envelope",
            "provider": "silo.close"
        },
        {
            "id": "ef9897c0-0be4-11f1-99f1-2d47ed7bc202",
            "name": "Generate Facturae XML",
            "provider": "gov-es.facturae.generate"
        }
    ],
    "rescue": []
}

SII invoice workflows

SII issue invoice

Example SII issue invoice workflow

{
  "name": "SII issue invoice",
  "description": "Report a SII record for an issued invoice to the AEAT and generate a PDF",
  "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 · SII · 000001",
      "config": {
        "name": "SII",
        "padding": 6,
        "start": 1
      }
    },
    {
      "id": "fc75e4f0-8721-11ef-a962-73e3f2037a52",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "61661540-bc8f-11ef-8ca1-573cbe7db4cd",
      "name": "Record issued invoice in SII",
      "provider": "gov-es.sii.record.issued"
    },
    {
      "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"
      }
    }
  ]
}

SII record received invoice

Example SII received invoice workflow

{
  "name": "SII record received invoice",
  "description": "Generate SII record for a received invoice and send it to the AEAT",
  "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 · SII · 000001",
      "config": {
        "name": "SII",
        "padding": 6,
        "start": 1
      }
    },
    {
      "id": "fc75e4f0-8721-11ef-a962-73e3f2037a52",
      "name": "Sign Envelope",
      "provider": "silo.close"
    },
    {
      "id": "61661540-bc8f-11ef-8ca1-573cbe7db4cd",
      "name": "Record received invoice in SII",
      "provider": "gov-es.sii.record.received"
    },
    {
      "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"
      }
    }
  ]
}

SII party workflows

SII register party

Example SII register party

{
    "name": "SII register party",
    "description": "Registers a party for SII reporting",
    "schema": "org/party",
    "steps": [
        {
            "id": "52f5d190-831c-11f0-9ba3-7d4deb7b9d0e",
            "name": "Register party for SII reporting",
            "provider": "gov-es.sii.register"
        },
        {
            "id": "5bfc9c10-831c-11f0-9ba3-7d4deb7b9d0e",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "627c94a0-831c-11f0-9ba3-7d4deb7b9d0e",
            "name": "Wait for party upload for SII reporting",
            "provider": "gov-es.sii.wait.upload"
        },
        {
            "id": "6f84ea30-831c-11f0-9ba3-7d4deb7b9d0e",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `registered`{.state .registered}",
            "config": {
                "state": "registered"
            }
        },
        {
            "id": "78dabf10-831c-11f0-9ba3-7d4deb7b9d0e",
            "name": "Wait for party approval for SII reporting",
            "provider": "gov-es.sii.wait.approval"
        }
    ],
    "rescue": [
        {
            "id": "846415c0-831c-11f0-9ba3-7d4deb7b9d0e",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `rejected`{.state .rejected}",
            "config": {
                "state": "rejected"
            }
        },
        {
            "id": "d0e996c0-d9db-11f0-9b9a-5143ba8c831d",
            "name": "Unregister party from SII reporting",
            "provider": "gov-es.sii.unregister"
        }
    ]
}

SII unregister party

Example SII party registration

{
    "name": "SII unregister party",
    "description": "Revokes entitlement to report invoices to SII for a party",
    "schema": "org/party",
    "steps": [
        {
            "id": "8a613610-67ba-11f0-bcaf-170efff782a9",
            "name": "Unregister party from SII reporting",
            "provider": "gov-es.sii.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"
            }
        }
    ]
}

NO VERI*FACTU invoice workflows

NO VERI*FACTU issue invoice

Example NO VERI*FACTU invoice workflow with states

{
    "name": "NO VERI*FACTU issue invoice",
    "description": "Generate, sign, and store a NO VERI*FACTU invoice record locally, then generate PDF",
    "schema": "bill/invoice",
    "steps": [
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000001",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            },
            "next": []
        },
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000002",
            "name": "Add Sequential Code",
            "provider": "sequence.enumerate",
            "summary": "Dynamic · NoVerifactu · 000001",
            "config": {
                "name": "NoVerifactu",
                "padding": 6,
                "start": 1
            },
            "next": []
        },
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000003",
            "name": "Sign Envelope",
            "provider": "silo.close",
            "next": []
        },
        {
            "id": "5bb35ae0-3ca4-11f1-90b7-0d81b4010093",
            "name": "Generate NO VERI*FACTU Invoice Record (Spain)",
            "provider": "gov-es.noverifactu.generate.invoice",
            "next": []
        },
        {
            "id": "64c2d7f0-3ca4-11f1-90b7-0d81b4010093",
            "name": "Record for NO VERI*FACTU (Spain)",
            "provider": "gov-es.noverifactu.record",
            "next": []
        },
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000006",
            "name": "Generate PDF",
            "provider": "pdf",
            "summary": "Spanish - A4",
            "config": {
                "date_format": "%Y-%m-%d",
                "layout": "A4",
                "locale": "es",
                "logo_height": 60
            },
            "next": []
        },
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000007",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `registered`{.state .registered}",
            "config": {
                "state": "registered"
            },
            "next": []
        }
    ],
    "rescue": [
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000008",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            },
            "next": []
        }
    ]
}

NO VERI*FACTU cancel invoice

Example NO VERI*FACTU cancel workflow with states

{
    "name": "NO VERI*FACTU cancel invoice",
    "description": "Generate, sign, and store a NO VERI*FACTU cancellation record",
    "schema": "bill/invoice",
    "steps": [
        {
            "id": "b2c3d4e0-0002-11f1-a000-000000000005",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "9f500280-3ca4-11f1-90b7-0d81b4010093",
            "name": "Generate NO VERI*FACTU Cancellation Record (Spain)",
            "provider": "gov-es.noverifactu.generate.cancel"
        },
        {
            "id": "a6eeb180-3ca4-11f1-90b7-0d81b4010093",
            "name": "Record for NO VERI*FACTU (Spain)",
            "provider": "gov-es.noverifactu.record"
        },
        {
            "id": "b2c3d4e0-0002-11f1-a000-000000000003",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `void`{.state .void}",
            "config": {
                "state": "void"
            }
        }
    ],
    "rescue": [
        {
            "id": "b2c3d4e0-0002-11f1-a000-000000000004",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

NO VERI*FACTU party workflows

NO VERI*FACTU register supplier

Example NO VERI*FACTU supplier registration

{
    "name": "NO VERI*FACTU supplier registration",
    "description": "Register a supplier for NO VERI*FACTU, generate the start-of-mode event, and subscribe to periodic summary events",
    "schema": "org/party",
    "steps": [
        {
            "id": "c21b4130-3a65-11f1-a475-db4c42dd4e99",
            "name": "Set Silo Entry State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            },
            "next": []
        },
        {
            "id": "78e845e0-3ca3-11f1-90b7-0d81b4010093",
            "name": "Register for NO VERI*FACTU (Spain)",
            "provider": "gov-es.noverifactu.register",
            "next": []
        },
        {
            "id": "8857fe80-3ca3-11f1-90b7-0d81b4010093",
            "name": "Build NO VERI*FACTU Status (Spain)",
            "provider": "gov-es.noverifactu.build.status",
            "next": [],
            "summary": "Build status: 01 - Start of NO VERI*FACTU mode",
            "config": {
                "event_type": "01"
            }
        },
        {
            "id": "d16d34a0-3a91-11f1-a472-21be9722e465",
            "name": "Create a Job",
            "provider": "transform.job.create",
            "summary": "Send to NO VERI*FACTU process event (bill/status)",
            "config": {
                "silo_entry_meta_key": "",
                "workflow_id": ""
            },
            "next": []
        },
        {
            "id": "03cb3000-3a92-11f1-a472-21be9722e465",
            "name": "Subscribe to Periodic Execution",
            "provider": "cron.subscribe",
            "summary": "Every 6 hours → no workflow",
            "config": {
                "workflow_id": "",
                "interval": "hourly",
                "factor": 6
            },
            "next": []
        },
        {
            "id": "c3d4e5f0-0003-11f1-a000-000000000002",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `registered`{.state .registered}",
            "config": {
                "state": "registered"
            },
            "next": []
        }
    ],
    "rescue": [
        {
            "id": "c3d4e5f0-0003-11f1-a000-000000000005",
            "name": "Unregister supplier",
            "provider": "gov-es.noverifactu.unregister",
            "next": []
        },
        {
            "id": "c3d4e5f0-0003-11f1-a000-000000000006",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `rejected`{.state .rejected}",
            "config": {
                "state": "rejected"
            },
            "next": []
        }
    ]
}

NO VERI*FACTU unregister supplier

Example NO VERI*FACTU unregister supplier

{
    "name": "NO VERI*FACTU unregister supplier",
    "description": "Unsubscribe from summary events, unregister a NO VERI*FACTU supplier, and generate the end-of-mode event",
    "schema": "org/party",
    "steps": [
        {
            "id": "d4e5f6a0-0004-11f1-a000-000000000007",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "3e4bd770-3a92-11f1-a472-21be9722e465",
            "name": "Unsubscribe from Periodic Execution",
            "provider": "cron.unsubscribe"
        },
        {
            "id": "f46dfa20-3ca3-11f1-90b7-0d81b4010093",
            "name": "Build NO VERI*FACTU Status (Spain)",
            "provider": "gov-es.noverifactu.build.status",
            "summary": "Build status: 02 - End of NO VERI*FACTU mode",
            "config": {
                "event_type": "02"
            }
        },
        {
            "id": "2fbe2590-3caf-11f1-ae77-65667068cb42",
            "name": "Create a Job",
            "provider": "transform.job.create",
            "summary": "Send to NO VERI*FACTU process event (bill/status)",
            "config": {
                "silo_entry_meta_key": "",
                "workflow_id": ""
            }
        },
        {
            "id": "9a9235e0-3cb0-11f1-ae77-65667068cb42",
            "name": "Unregister from NO VERI*FACTU (Spain)",
            "provider": "gov-es.noverifactu.unregister"
        },
        {
            "id": "d4e5f6a0-0004-11f1-a000-000000000004",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `void`{.state .void}",
            "config": {
                "state": "void"
            }
        }
    ],
    "rescue": [
        {
            "id": "d4e5f6a0-0004-11f1-a000-000000000006",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

NO VERI*FACTU event workflows

NO VERI*FACTU process event

Example NO VERI*FACTU event processing workflow

{
    "name": "NO VERI*FACTU process event",
    "description": "Generate, sign, and store a NO VERI*FACTU event record",
    "schema": "bill/status",
    "steps": [
        {
            "id": "e5f6a7b0-0005-11f1-a000-000000000004",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `processing`{.state .processing}",
            "config": {
                "state": "processing"
            }
        },
        {
            "id": "bbf19740-3a6b-11f1-9a44-6748aa5d4a91",
            "name": "Modify Silo Entry",
            "provider": "silo.modify",
            "summary": "Modifications configured",
            "config": {
                "jq": ".series //= \"NVF\"",
                "merge_type": "application/jq",
                "scope": "doc"
            }
        },
        {
            "id": "a1b2c3d0-0001-11f1-a000-000000000002",
            "name": "Add Sequential Code",
            "provider": "sequence.enumerate",
            "summary": "Dynamic · NoVerifactu · 000001",
            "config": {
                "name": "NoVerifactu",
                "padding": 6,
                "start": 1
            }
        },
        {
            "id": "e5f6a7b0-0005-11f1-a000-000000000006",
            "name": "Sign Envelope",
            "provider": "silo.close"
        },
        {
            "id": "f8df5470-3c97-11f1-8c73-6dd226144d30",
            "name": "Generate NO VERI*FACTU Event Record (Spain)",
            "provider": "gov-es.noverifactu.generate.event"
        },
        {
            "id": "050b05a0-3c98-11f1-8c73-6dd226144d30",
            "name": "Record for NO VERI*FACTU (Spain)",
            "provider": "gov-es.noverifactu.record"
        },
        {
            "id": "e5f6a7b0-0005-11f1-a000-000000000005",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `registered`{.state .registered}",
            "config": {
                "state": "registered"
            }
        }
    ],
    "rescue": [
        {
            "id": "e5f6a7b0-0005-11f1-a000-000000000003",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

NO VERI*FACTU summary event

Example NO VERI*FACTU summary event cron workflow

{
    "name": "NO VERI*FACTU summary event",
    "description": "Build and process a NO VERI*FACTU summary event every 6 hours",
    "schema": "org/party",
    "steps": [
        {
            "id": "f6a7b8c0-0006-11f1-a000-000000000001",
            "name": "Build NO VERI*FACTU Status (Spain)",
            "provider": "gov-es.noverifactu.build.status",
            "summary": "Build status: 10 - Summary event",
            "config": {
                "event_type": "10"
            }
        },
        {
            "id": "4f527c60-3a95-11f1-a472-21be9722e465",
            "name": "Create a Job",
            "provider": "transform.job.create",
            "summary": "Send to NO VERI*FACTU process event (bill/status)",
            "config": {
                "silo_entry_meta_key": "",
                "workflow_id": ""
            }
        }
    ],
    "rescue": [
        {
            "id": "f6a7b8c0-0006-11f1-a000-000000000003",
            "name": "Set State",
            "provider": "silo.state",
            "summary": "Set state to `error`{.state .error}",
            "config": {
                "state": "error"
            }
        }
    ]
}

Documents

Supplier

Spain supplier example

{
  "$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": "[e-mail]"
    }
  ]
}

TicketBAI example documents

B2B Invoice

In this example, we’re issuing a standard B2B invoice from a Basque supplier to a customer in Madrid.

Scenario details:

• The supplier is based out of Bilbao in Bizkaia, using the sandbox data provided by TicketBAI.
• The customer is in Madrid.
• They’re selling software development services with standard VAT.
• The series for the invoice is “F1”.

Notice:

• the minimal version (ticketbai-b2b.min.mdx) contains only the essential fields required to create the invoice,
• we’re applying the es-tbai-v1 addon to ensure GOBL’s TicketBAI validation checks are applied,
• there is no currency nor issue_date, as these will be assigned automatically,
• there is no invoice code as this will be assigned by the workflow,
• TicketBAI requires a general note, so we’ve added one at the bottom,
• when running gobl build, the system automatically calculates totals, assigns the $regime to ES, sets the es-tbai-region extension to BI (Bizkaia) based on the supplier’s address, applies the standard VAT rate (21%), and assigns the es-tbai-product extension to services based on the item unit,
• the built version (ticketbai-b2b.mdx) shows the normalized document with calculated totals, line item sums, tax breakdowns, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

TicketBAI B2B Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": ["es-tbai-v1"],
  "series": "F1",
  "supplier": {
    "name": "HFPn5yhXZ9tdD4pHRbvwymaVPrGZQr",
    "tax_id": {
      "country": "ES",
      "code": "A99805194"
    },
    "addresses": [
      {
        "num": "42",
        "street": "San Frantzisko",
        "locality": "Bilbo",
        "region": "Bizkaia",
        "code": "48003",
        "country": "ES"
      }
    ],
    "emails": [
      {
        "addr": "[e-mail]"
      }
    ]
  },
  "customer": {
    "name": "Receive One S.L.",
    "tax_id": {
      "country": "ES",
      "code": "B98602642"
    },
    "emails": [
      {
        "addr": "[e-mail]"
      }
    ],
    "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"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "standard"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "Invoice for development services"
    }
  ]
}

B2C Simplified Invoice

In this example, we’re issuing a simplified B2C invoice from a Basque supplier for an in-person sale.

Scenario details:

• The supplier is based out of Bilbao in Bizkaia, using the sandbox data provided by TicketBAI.
• There is no customer.
• Physical goods are being sold with a standard VAT rate.
• The series for the invoice is “FS1”.

Notice:

• the minimal version (ticketbai-b2c.min.mdx) contains only the essential fields required to create the simplified invoice,
• there is no customer object,
• the tax object contains the prices_include value set to VAT, which will ensure all totals will be calculated assuming that prices include VAT,
• the line item includes a es-tbai-product extension with the value goods,
• TicketBAI requires a general note, in this case we’ve added a generic message,
• when running gobl build, the system automatically calculates the tax-included totals (splitting the €25.10 price into €20.74 base + €4.36 VAT), assigns the $regime to ES, sets the es-tbai-region extension to BI (Bizkaia), applies the standard VAT rate (21%), and normalizes all fields,
• the built version (ticketbai-b2c.mdx) shows the normalized document with calculated totals including tax-included calculations, line item sums, tax breakdowns, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

TicketBAI B2C Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": ["es-tbai-v1"],
  "series": "FS1",
  "tax": {
    "prices_include": "VAT"
  },
  "supplier": {
    "name": "HFPn5yhXZ9tdD4pHRbvwymaVPrGZQr",
    "tax_id": {
      "country": "ES",
      "code": "A99805194"
    },
    "addresses": [
      {
        "num": "42",
        "street": "San Frantzisko",
        "locality": "Bilbo",
        "region": "Bizkaia",
        "code": "48003",
        "country": "ES"
      }
    ],
    "emails": [
      {
        "addr": "[e-mail]"
      }
    ]
  },
  "lines": [
    {
      "quantity": "1",
      "item": {
        "name": "Advanced screwdriver set",
        "price": "25.10",
        "ext": {
          "es-tbai-product": "goods"
        }
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "standard"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "In person sale"
    }
  ]
}

Facturae example documents

Facturae B2B Invoice

A standard Facturae invoice from a Spanish supplier to a Spanish business customer.

Notice:

• the es-facturae-v3 addon is required,
• the es-facturae-doc-type and es-facturae-invoice-class tax extensions must be set,
• both supplier and customer must have full address details and valid Spanish tax IDs.

Facturae B2G Invoice

{
	"$schema": "https://gobl.org/draft-0/bill/invoice",
	"$regime": "ES",
	"$addons": [
		"es-facturae-v3"
	],
	"uuid": "01922b1e-e288-7ab9-82f3-0c8c8c7956bc",
	"type": "standard",
	"code": "TEST01001F",
	"issue_date": "2021-12-08",
	"currency": "EUR",
	"tax": {
		"ext": {
			"es-facturae-doc-type": "FC",
			"es-facturae-invoice-class": "OO"
		}
	},
	"supplier": {
		"name": "Hypeprop Sl",
		"alias": "Hypeprop",
		"tax_id": {
			"country": "ES",
			"code": "B23103039"
		},
		"people": [
			{
				"name": {
					"given": "Paloma",
					"surname": "Araujo"
				}
			}
		],
		"addresses": [
			{
				"num": "74",
				"street": "Campo Real",
				"locality": "Torrejón De La Calzada",
				"region": "Madrid",
				"code": "28023",
				"country": "ES"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		],
		"telephones": [
			{
				"label": "office",
				"num": "[phone]"
			}
		]
	},
	"customer": {
		"name": "Moniward Sl",
		"tax_id": {
			"country": "ES",
			"code": "B77436020"
		},
		"addresses": [
			{
				"num": "35",
				"street": "Plaza Horno",
				"locality": "Nombela",
				"region": "Toledo",
				"code": "45083",
				"country": "ES"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		]
	},
	"lines": [
		{
			"i": 1,
			"quantity": "20",
			"item": {
				"name": "Operations and development - day rate",
				"price": "200.00"
			},
			"sum": "4000.00",
			"taxes": [
				{
					"cat": "VAT",
					"rate": "standard",
					"percent": "21.0%"
				}
			],
			"total": "4000.00"
		},
		{
			"i": 2,
			"quantity": "2",
			"item": {
				"name": "Additional Overtime",
				"price": "101.00"
			},
			"sum": "202.00",
			"taxes": [
				{
					"cat": "VAT",
					"rate": "standard",
					"percent": "21.0%"
				}
			],
			"total": "202.00"
		}
	],
	"payment": {
		"terms": {
			"key": "due-date",
			"due_dates": [
				{
					"date": "2021-12-30",
					"amount": "5084.42",
					"percent": "100%"
				}
			],
			"notes": "Some kind of payment term note"
		},
		"instructions": {
			"key": "credit-transfer",
			"credit_transfer": [
				{
					"iban": "ES25 0188 2570 7185 4470 4761",
					"name": "Bankrandom"
				}
			]
		}
	},
	"totals": {
		"sum": "4202.00",
		"total": "4202.00",
		"taxes": {
			"categories": [
				{
					"code": "VAT",
					"rates": [
						{
							"key": "standard",
							"base": "4202.00",
							"percent": "21.0%",
							"amount": "882.42"
						}
					],
					"amount": "882.42"
				}
			],
			"sum": "882.42"
		},
		"tax": "882.42",
		"total_with_tax": "5084.42",
		"payable": "5084.42"
	},
	"notes": [
		{
			"key": "general",
			"text": "Thank you for your custom!"
		}
	]
}

Facturae Credit Note

A corrective invoice (credit note) referencing a previous Facturae invoice.

Notice:

• the type is set to credit-note,
• a preceding entry references the original invoice with the es-facturae-correction code,
• the es-facturae-invoice-class is set to OR (rectificativa).

Facturae Credit Note

{
	"$schema": "https://gobl.org/draft-0/bill/invoice",
	"$regime": "ES",
	"$addons": [
		"es-facturae-v3"
	],
	"uuid": "01922b1e-e283-7860-96aa-c57af9ffe67b",
	"type": "credit-note",
	"code": "TEST01001R",
	"issue_date": "2021-12-08",
	"currency": "EUR",
	"preceding": [
		{
			"type": "standard",
			"issue_date": "2021-12-08",
			"code": "TEST01001F",
			"ext": {
				"es-facturae-correction": "01"
			}
		}
	],
	"tax": {
		"ext": {
			"es-facturae-doc-type": "FC",
			"es-facturae-invoice-class": "OR"
		}
	},
	"supplier": {
		"name": "Hypeprop Sl",
		"alias": "Hypeprop",
		"tax_id": {
			"country": "ES",
			"code": "B23103039"
		},
		"people": [
			{
				"name": {
					"given": "Paloma",
					"surname": "Araujo"
				}
			}
		],
		"addresses": [
			{
				"num": "74",
				"street": "Campo Real",
				"locality": "Torrejón De La Calzada",
				"region": "Madrid",
				"code": "28023",
				"country": "ES"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		],
		"telephones": [
			{
				"label": "office",
				"num": "[phone]"
			}
		]
	},
	"customer": {
		"name": "Moniward Sl",
		"tax_id": {
			"country": "ES",
			"code": "B77436020"
		},
		"addresses": [
			{
				"num": "35",
				"street": "Plaza Horno",
				"locality": "Nombela",
				"region": "Toledo",
				"code": "45083",
				"country": "ES"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		]
	},
	"lines": [
		{
			"i": 1,
			"quantity": "20",
			"item": {
				"name": "Operations and development - day rate",
				"price": "200.00"
			},
			"sum": "4000.00",
			"taxes": [
				{
					"cat": "VAT",
					"rate": "standard",
					"percent": "21.0%"
				}
			],
			"total": "4000.00"
		},
		{
			"i": 2,
			"quantity": "2",
			"item": {
				"name": "Additional Overtime",
				"price": "101.00"
			},
			"sum": "202.00",
			"taxes": [
				{
					"cat": "VAT",
					"rate": "standard",
					"percent": "21.0%"
				}
			],
			"total": "202.00"
		}
	],
	"totals": {
		"sum": "4202.00",
		"total": "4202.00",
		"taxes": {
			"categories": [
				{
					"code": "VAT",
					"rates": [
						{
							"key": "standard",
							"base": "4202.00",
							"percent": "21.0%",
							"amount": "882.42"
						}
					],
					"amount": "882.42"
				}
			],
			"sum": "882.42"
		},
		"tax": "882.42",
		"total_with_tax": "5084.42",
		"payable": "5084.42"
	},
	"notes": [
		{
			"key": "general",
			"text": "Thank you for your custom!"
		}
	]
}

Facturae FACe Invoice (with Administrative Centers)

An invoice addressed to a public administration via the FACe platform, including the three required DIR3 administrative centers.

Notice:

• the customer includes an identity with scope: "tax" for the Oficina Contable (DIR3 code 01),
• delivery.receiver includes the Órgano Gestor identity (DIR3 code 02),
• ordering.buyer includes the Unidad Tramitadora identity (DIR3 code 03),
• each public body publishes their DIR3 codes — look them up in the DIR3 directory.

Facturae FACe Invoice (B2G with Admin Centers)

{
	"$schema": "https://gobl.org/draft-0/bill/invoice",
	"$regime": "ES",
	"$addons": [
		"es-facturae-v3"
	],
	"type": "standard",
	"code": "TEST01002F",
	"issue_date": "2021-12-08",
	"currency": "EUR",
	"tax": {
		"ext": {
			"es-facturae-doc-type": "FC",
			"es-facturae-invoice-class": "OO"
		}
	},
	"supplier": {
		"name": "Hypeprop Sl",
		"alias": "Hypeprop",
		"tax_id": {
			"country": "ES",
			"code": "B23103039"
		},
		"people": [
			{
				"name": {
					"given": "Paloma",
					"surname": "Araujo"
				}
			}
		],
		"addresses": [
			{
				"num": "74",
				"street": "Campo Real",
				"locality": "Torrejón De La Calzada",
				"region": "Madrid",
				"code": "28023",
				"country": "ES"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		],
		"telephones": [
			{
				"label": "office",
				"num": "[phone]"
			}
		]
	},
	"customer": {
		"name": "Ayuntamiento de Madrid",
		"tax_id": {
			"country": "ES",
			"code": "P2807900B"
		},
		"identities": [
			{
				"scope": "tax",
				"code": "L01280796"
			}
		],
		"addresses": [
			{
				"num": "4",
				"street": "Plaza de la Villa",
				"locality": "Madrid",
				"region": "Madrid",
				"code": "28005",
				"country": "ES"
			}
		],
		"emails": [
			{
				"addr": "[e-mail]"
			}
		]
	},
	"delivery": {
		"receiver": {
			"name": "Concejalía de Hacienda",
			"identities": [
				{
					"code": "LA0007407"
				}
			],
			"addresses": [
				{
					"num": "3",
					"street": "Calle Alcalá",
					"locality": "Madrid",
					"region": "Madrid",
					"code": "28014",
					"country": "ES"
				}
			]
		}
	},
	"ordering": {
		"buyer": {
			"name": "Departamento de Compras",
			"identities": [
				{
					"code": "LA0007408"
				}
			],
			"addresses": [
				{
					"num": "10",
					"street": "Gran Vía",
					"locality": "Madrid",
					"region": "Madrid",
					"code": "28013",
					"country": "ES"
				}
			]
		}
	},
	"lines": [
		{
			"quantity": "20",
			"item": {
				"name": "Services rendered",
				"price": "200.00"
			},
			"taxes": [
				{
					"cat": "VAT",
					"rate": "standard"
				}
			]
		}
	],
	"payment": {
		"terms": {
			"key": "due-date",
			"due_dates": [
				{
					"date": "2021-12-30",
					"amount": "4840.00",
					"percent": "100%"
				}
			]
		},
		"instructions": {
			"key": "credit-transfer",
			"credit_transfer": [
				{
					"iban": "ES25 0188 2570 7185 4470 4761",
					"name": "Bankrandom"
				}
			]
		}
	}
}

SII example documents

B2C Standard Invoice

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 in which this threshold is increased to €3,000.

Notice:

• the minimal version (sii-b2c.min.mdx) contains only the essential fields required to create the simplified invoice,
• to create a simplified SII invoice, include the simplified tag in your GOBL document with the es-sii-v1 addon,
• when running gobl build, the system automatically calculates totals, assigns the $regime to ES, sets the es-sii-doc-type extension to F2 (Simplified invoice), applies the standard VAT rate (21%), and normalizes all fields,
• the built version (sii-b2c.mdx) shows the normalized document with calculated totals, line item sums, tax breakdowns, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2C Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "$tags": [
    "simplified"
  ],
  "series": "SAMPLE",
  "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": [
    {
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a standard tax"
    }
  ]
}

B2B Standard Invoice

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.

Notice:

• the minimal version (sii-b2b.min.mdx) contains only the essential fields required to create the standard B2B invoice,
• to create a regular SII invoice, include the es-sii-v1 addon and ensure the customer field contains valid tax identification details,
• the supplier must be previously registered with the tax authority and the customer NIF or VAT ID must be valid,
• when running gobl build, the system automatically calculates totals, assigns the $regime to ES, sets the es-sii-doc-type extension to F1 (Standard invoice), applies the standard VAT rate (21%), and normalizes all fields,
• the built version (sii-b2b.mdx) shows the normalized document with calculated totals, line item sums, tax breakdowns, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2B Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "series": "SAMPLE",
  "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": [
    {
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ]
}

B2B Services EU Client (Reverse Charge)

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.

Notice:

• the minimal version (sii-b2b-services-eu.min.mdx) contains only the essential fields required to create the reverse charge invoice,
• to create a reverse charge SII invoice, use the tax key reverse-charge in your invoice lines,
• you also need to set the items key to services, which will generate a breakdown by operation type required for this type of invoices,
• 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 with the tax authority and the customer VAT ID must be valid and registered in the EU VIES system,
• when running gobl build, the system automatically sets the operation type to S2 (Subject and Not Exempt - With reverse charge) when reporting the document to SII, applies the reverse charge tax treatment, and normalizes all fields,
• the built version (sii-b2b-services-eu.mdx) shows the normalized document with the reverse charge configuration, operation type breakdown, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2B Invoice Services (EU)

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "series": "SAMPLE",
  "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": "DE",
      "code": "111111125"
    }
  },
  "lines": [
    {
      "quantity": "20",
      "item": {
        "key": "services",
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "key": "reverse-charge"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with reverse charge"
    }
  ]
}

B2B Goods EU Client (Intra-Community)

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.

Notice:

• the minimal version (sii-b2b-goods-eu.min.mdx) contains only the essential fields required to create the intra-community supply invoice,
• to create an intra-community supply SII invoice, use the tax key intra-community in your invoice lines,
• you also need to set the items key to goods, which will report to SII a breakdown by operation type required for this type of invoices,
• 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 with the tax authority and the customer VAT ID must be valid and registered in the EU VIES system,
• when running gobl build, the es-sii-v1 addon automatically sets the es-sii-exempt extension to E5 (Artículo 25 Ley de IVA) and the es-sii-regime extension to 02 (Export),
• the built version (sii-b2b-goods-eu.mdx) shows the normalized document with the intra-community configuration, exemption codes, operation type breakdown, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2B Invoice Goods (EU)

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "series": "SAMPLE",
  "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": "DE",
      "code": "111111125"
    }
  },
  "lines": [
    {
      "quantity": "20",
      "item": {
        "key": "goods",
        "name": "Goods",
        "price": "90.00"
      },
      "taxes": [
        {
          "cat": "VAT",
          "key": "intra-community",
          "ext": {
            "es-sii-regime": "02"
          }
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a intra-community"
    }
  ]
}

B2B Services No EU Client (Outside Scope)

Outside scope invoices are used for B2B services provided to customers outside the EU.

Notice:

• the minimal version (sii-b2b-services-no-eu.min.mdx) contains only the essential fields required to create the outside scope invoice,
• to create an outside scope SII invoice, use the tax key outside-scope in your invoice lines,
• 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,
• when running gobl build, the es-sii-v1 addon automatically sets the es-sii-oot extension to location and normalizes all fields,
• the built version (sii-b2b-services-no-eu.mdx) shows the normalized document with the outside scope configuration and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

Built example

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "series": "SAMPLE",
  "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": "SG",
      "code": "201312345A"
    }
  },
  "lines": [
    {
      "quantity": "20",
      "item": {
        "key": "services",
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "key": "outside-scope"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a outside-scope tax"
    }
  ]
}

B2B Goods No EU Client (Export)

Export invoices are used for B2B goods delivered to customers outside the EU.

Notice:

• the minimal version (sii-b2b-goods-no-eu.min.mdx) contains only the essential fields required to create the export invoice,
• to create an export SII invoice, use the tax key export in your invoice lines,
• 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,
• when running gobl build, the es-sii-v1 addon automatically sets the es-sii-exempt extension to E2 (Artículo 21 Ley de IVA) and the es-sii-regime extension to 02 (Export),
• the built version (sii-b2b-goods-no-eu.mdx) shows the normalized document with the export configuration, exemption codes, and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2B Invoice Goods (No EU)

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "series": "SAMPLE",
  "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": "SG",
      "code": "201312345A"
    }
  },
  "lines": [
    {
      "quantity": "20",
      "item": {
        "key": "goods",
        "name": "Goods",
        "price": "90.00"
      },
      "taxes": [
        {
          "cat": "VAT",
          "key": "export"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with an export"
    }
  ]
}

B2B Exempt E1 Invoice

Exempt E1 invoices are used for B2B transactions that are exempt from VAT pursuant (Artículo 20 Ley de IVA), which covers exemptions in internal operations.

Notice:

• the minimal version (sii-exempt-E1.min.mdx) contains only the essential fields required to create the exempt E1 invoice,
• to create an exempt E1 SII invoice, use the tax key exempt in your invoice lines,
• 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,
• when running gobl build, the es-sii-v1 addon automatically sets the es-sii-exempt extension to E1 and normalizes all fields,
• the built version (sii-exempt-E1.mdx) shows the normalized document with the exempt E1 configuration and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2B Exempt E1 Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "series": "SAMPLE",
  "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": [
    {
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "key": "exempt"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a exempt tax"
    }
  ]
}

B2C One-Stop-Shop Invoice

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.

Notice:

• the minimal version (sii-b2c-oss.min.mdx) contains only the essential fields required to create the OSS invoice,
• to create an OSS SII invoice, include the simplified tag in your GOBL document with the es-sii-v1 addon,
• 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 with the tax authority and enrolled in the OSS scheme,
• when running gobl build, the invoice will be treated as a simplified invoice (es-sii-doc-type extension set to F2) and VAT is accounted for through the OSS scheme in the destination country,
• the built version (sii-b2c-oss.mdx) shows the normalized document with the OSS configuration and automatically generated fields, and,
• there are no totals or calculations in the minimal version; all these will be made automatically when uploading.

SII B2C One Stop Shop Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "$tags": [
    "simplified"
  ],
  "series": "SAMPLE",
  "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": [
    {
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a standard tax"
    }
  ]
}

B2C Hotel + IEET (Catalonia tourist tax)

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 reported as a tax to SII. Hotels declare it directly to the Generalitat through the quarterly Modelo 950.

Notice:

• model the IEET as a document-level charge with key: "tax", which keeps it out of the VAT base while still appearing as a separate line on the guest’s invoice as required by Art. 35 of Llei 5/2017,
• do not model the IEET as a VAT tax line — it is a fixed amount per night, not a percentage, and the AEAT does not collect it,
• the reason field on the charge is what the guest sees on the invoice; include the establishment type, location, nights, and rate so the breakdown is unambiguous,
• accommodation is invoiced with reduced VAT (10%) on the room base; the IEET charge is added on top of total_with_tax to produce payable,
• the quarterly Modelo 950 to the Generalitat is independent of individual invoices, but structuring the IEET as a typed charge lets hotels query their GOBL invoices for the data they need to file it.

B2C Hotel + IEET (Catalonia tourist tax)

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-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"
      }
    ]
  },
  "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"
    }
  ]
}

Credit Note

SII Credit Note

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "type": "credit-note",
  "series": "CN",
  "preceding": [
    {
      "type": "standard",
      "issue_date": "2025-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"
      }
    ],
    "emails": [
      {
        "addr": "[e-mail]"
      }
    ]
  },
  "customer": {
    "name": "Sample Consumer",
    "tax_id": {
      "country": "ES",
      "code": "B63272603"
    }
  },
  "lines": [
    {
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a standard tax"
    }
  ]
}

Corrective Invoice

SII Corrective Invoice

{
  "$schema": "https://gobl.org/draft-0/bill/invoice",
  "$addons": [
    "es-sii-v1"
  ],
  "type": "corrective",
  "series": "CO",
  "preceding": [
    {
      "type": "standard",
      "issue_date": "2024-11-13",
      "series": "SAMPLE",
      "code": "004",
      "tax": {
        "categories": [
          {
            "code": "VAT",
            "rates": [
              {
                "key": "standard",
                "ext": {
                  "es-sii-regime": "01"
                },
                "base": "1800.00",
                "percent": "21.0%"
              }
            ]
          }
        ]
      }
    }
  ],
  "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": [
    {
      "quantity": "20",
      "item": {
        "name": "Development services",
        "price": "90.00",
        "unit": "h"
      },
      "taxes": [
        {
          "cat": "VAT",
          "rate": "general"
        }
      ]
    }
  ],
  "notes": [
    {
      "key": "general",
      "text": "This is a sample invoice with a standard tax"
    }
  ]
}

Copy and paste these documents into the GOBL builder in order to preview and verify them.

API Endpoints

The following API Endpoints are available when you enable this app:

• Generate Agreement PDF
• Upload Agreement PDF
• Upload Identity Image
• Confirm

---

🇪🇸 Invopop resources for Spain

Compliance	Invoicing compliance in Spain Compliance timeline
Apps	Spain VERI*FACTU Spain TicketBAI Spain
Guides	Facturae Guide VERI*FACTU Invoicing Guide VERI*FACTU Supplier Onboarding SII Invoicing Guide SII Supplier Onboarding TicketBAI Guide
FAQ	Spain FAQ
GOBL	Spain Tax Regime VERI*FACTU Addon Facturae Addon SII Addon
GitHub	gobl.facturae gobl.verifactu gobl.ticketbai

Spain FAQ

Frequently asked questions about invoicing compliance in Spain →

Participate in our community

Ask and answer questions about the Spain App →