AEAT social collaborator

SII API to send your invoices to the AEAT

The Verifacti SII API sends your issued-invoices record book to the Spanish Tax Agency’s (AEAT) Immediate Supply of Information (SII): your software sends each invoice as JSON, Verifacti validates it, submits its record to the AEAT and returns the response by webhook. It is the same provider and the same NIF management you will use for B2B e-invoicing.

Test environment and test NIF included
POST /sii/create
{
  "ejercicio": "2026",
  "periodo": "11",
  "serie": "A",
  "numero": "1",
  "tipo_factura": "F1",
  "importe_total": "242",
  …
}
200 OK
{
  "uuid": "ea6eae92-bac6-48c3-…",
  "estado": "Pendiente"
}

How the SII API works

  1. 1

    You send the issued invoice as JSON

    Your software calls the API with the invoice data and the issuing NIF’s API key, without dealing with the AEAT’s SOAP.

  2. 2

    Verifacti validates it

    We check the data before sending it and, if there is an error, return it with a code.

  3. 3

    It is submitted to the SII and you get the response

    By webhook or by checking the record’s status.

The SII gives four business days to send each issued invoice.

Example: send an invoice to the SII

A full invoice (F1) against the test environment, which submits to the AEAT test environment.

Request · cURL
curl -X POST https://api.verifacti.com/sii/create \
  -H "Authorization: Bearer $VERIFACTI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ejercicio": "2026",
    "periodo": "11",
    "serie": "A",
    "numero": "1",
    "fecha_expedicion": "19-11-2026",
    "tipo_factura": "F1",
    "clave_regimen": ["01"],
    "descripcion": "Factura normal",
    "nombre": "Nombre cliente",
    "nif": "A15022510",
    "desglose": {
      "no_exenta": {
        "tipo_no_exenta": "S1",
        "detalle_iva": [{
          "tipo_impositivo": "21",
          "base_imponible": "200",
          "cuota_repercutida": "42"
        }]
      }
    },
    "importe_total": "242"
  }'
Response · 200
{
  "uuid": "ea6eae92-bac6-48c3-baa4-2bbf6b5ee562",
  "estado": "Pendiente"
}

What the SII API includes

  • Issued invoices record book

    Create, modify and cancel records (/sii/create, /sii/modify, /sii/cancel), also in batches with /sii/create_bulk.

  • Validation before sending

    Every invoice is validated before it is sent, including the recipient’s NIF against the AEAT or their VAT number in VIES, and any error comes back with a code (code catalogue).

  • AEAT response by webhook

    Or by checking the status, listing and export of your records.

  • Many NIFs from your application

    With the NIF management API you register and manage your customers’ NIFs by API, without going through a dashboard.

  • Retries without duplicates

    With the Idempotency-Key header, repeating the same request returns the original response for 24 hours.

  • No digital certificate

    Verifacti is an AEAT social collaborator. Each taxpayer signs the representation form once.

SII and e-invoicing with the same provider

You integrate the NIF management API once: registering, activating and removing NIFs, representation and webhooks. Each regulation then adds its own submission integration, close to the target administration’s API. When the E-invoicing API arrives, you will only add its submission integration.

Why Verifacti for the SII

Proven reliability

Hundreds of companies and software vendors in production with Verifacti. Data hosted in the EU and an SLA in the terms of use.

AEAT social collaborator

Specialists in Spain

Common and foral territory: Verifactu, TicketBAI and SII with one provider.

TicketBAI guarantor software in Álava, Bizkaia and Gipuzkoa

Built for developers

Public documentation with examples for every call, quick start guide, llms.txt and a free account with a test environment.

Typical integration: one to three developer days

SII: who must use it and what B2B e-invoicing adds

The SII applies to large companies (turnover over €6,010,121.04), businesses in the REDEME and VAT groups, and it can be chosen voluntarily. Businesses in the SII are outside Verifactu. B2B e-invoicing comes on top of the SII; it does not replace it. Álava, Bizkaia, Gipuzkoa and Navarre have their own foral SII, which this API does not cover.

SII: large companies (over €6M), REDEME and VAT groupsSince 1 Jul 2017
Since 1 January 2025, also holders of hydrocarbon tax warehouses (RIVA, art. 71.3).
In force
Voluntary SII: any VAT taxpayerAt any time
Opting out is filed in November.
In force
B2B e-invoicing: turnover over €8M6 Oct 2027
Published in the BOE, future date
B2B e-invoicing: all other businesses and professionals6 Oct 2028
Invoice statuses optional until 6 October 2029 for individuals and pass-through entities up to €8M.
Published in the BOE, future date

This is not advice: each taxpayer determines what applies to them with their adviser.

SII API pricing

SII pricing depends on your invoice volume. The test environment is free. Talk to sales.

See pricing

    Questions about the SII API

    More questions about the SII

    I already have an SII provider. Why switch?

    To have the SII and B2B e-invoicing with the same provider and the same NIF management before the obligation arrives: 6 October 2027 for businesses invoicing over €8M.

    Can I have the SII and B2B e-invoicing with the same provider?

    Yes: the SII today and e-invoicing with the E-invoicing API, coming soon, on the same NIF management.

    Is there a JSON REST API for the SII, without dealing with the AEAT’s SOAP?

    Yes. You send JSON and Verifacti generates the record, submits it to the AEAT and returns its response.

    Can I test the SII without sending real data to the AEAT?

    Yes. The free account includes a test environment, which submits to the AEAT test environment. Support gives you the SII test NIF.

    Do I need a digital certificate?

    No. Verifacti is an AEAT social collaborator and submits with its own certificate once the taxpayer signs the representation form, the same one for the AEAT and the foral treasuries. It can be signed online, without a certificate.

    Start integrating today

    Try it for free with the test environment.

    Test environment and test NIF includedSee pricing