Skip to main content

​
Introduction

SII (Suministro Inmediato de Información) is a fiscal initiative by the Spanish Tax Agency (AEAT) that requires large businesses to report invoices through certified software. The system submits invoices in the SII format to the tax authorities.
SII is mandatory for companies that meet certain requirements. Companies reporting with VERI*FACTU or TicketBAI are exempt from reporting with SII.

​
Prerequisites

To issue your first SII invoice, you must have had registered at least one supplier. Make sure you read and implemented the SII supplier registration guide before continuing with this guide.

​
Setup

Add a new workflow to your workspace for issuing invoices. You can start with the template below. Keep the Workflow ID at hand, you’ll use it later.
SII allows for document modifications after submission. If a document is rejected or contains errors, update the GOBL details and resubmit to the same workflow.

​
Issue an Invoice

1

Upload an Invoice

Use the Create an entry endpoint to upload the invoice details. Include an invoice object in the data field with these required fields:
  • regime: ES
  • Add the es-sii-v1 addon
  • supplier: Use the details of the supplier you’ve registered before.
You can copy one of the example invoices below as a reference.
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 SII invoice, include the es-sii-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 previsouly registered with the tax authority and the customer NIF or VAT ID must be valid.
SII B2B Invoice
{
    "$schema": "https://gobl.org/draft-0/bill/invoice",
    "$regime": "ES",
    "$addons": [
        "es-sii-v1"
    ],
    "type": "standard",
    "series": "SAMPLE",
    "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"
            }
        ],
        "emails": [
            {
                "addr": "[email protected]"
            }
        ]
    },
    "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%"
                }
            ]
        }
    ]
}
After uploading you’ll see the document in the Invoices section with status Empty.
Empty invoice

Empty invoice

2

Send the Invoice to the SII invoice workflow

Send the invoice to the SII workflow using the Create a job endpoint. Use:
  • workflow_id: use the Workflow ID of the SII invoice workflow created on setup.
  • silo_entry_id: use the Silo Entry ID of the invoice you’ve just uploaded.
The invoice’s status will change to Sent when the workflow completes successfully.
Sent invoice

Sent invoice

You can verify that the PDF was generated by clicking on the invoice and selecting the PDF from the “Files” tab.

Spain FAQ

Find answers to frequently asked questions about invoicing in Spain →

Participate in our community

Ask and answer questions about invoicing in Spain →