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{
"ejercicio": "2026",
"periodo": "11",
"serie": "A",
"numero": "1",
"tipo_factura": "F1",
"importe_total": "242",
…
}{
"uuid": "ea6eae92-bac6-48c3-…",
"estado": "Pendiente"
}How the SII API works
- 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
Verifacti validates it
We check the data before sending it and, if there is an error, return it with a code.
- 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.
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"
}'{
"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-Keyheader, 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 collaboratorSpecialists in Spain
Common and foral territory: Verifactu, TicketBAI and SII with one provider.
TicketBAI guarantor software in Álava, Bizkaia and GipuzkoaBuilt 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 daysSII: 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.
| Who | Date | Status | Rule |
|---|---|---|---|
| SII: large companies (over €6M), REDEME and VAT groups Since 1 January 2025, also holders of hydrocarbon tax warehouses (RIVA, art. 71.3). | Since 1 Jul 2017 | In force | RD 596/2016 |
| Voluntary SII: any VAT taxpayer Opting out is filed in November. | At any time | In force | Art. 68 bis RIVA |
| B2B e-invoicing: turnover over €8M | 6 Oct 2027 | Published in the BOE, future date | RD 238/2026 · Orden HAC/1028/2026 |
| B2B e-invoicing: all other businesses and professionals Invoice statuses optional until 6 October 2029 for individuals and pass-through entities up to €8M. | 6 Oct 2028 | Published in the BOE, future date | RD 238/2026 · Orden HAC/1028/2026 |
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 pricingEverything you need to integrate the SII
Questions about the SII API
More questions about the SIII already have an SII provider. Why switch?
Can I have the SII and B2B e-invoicing with the same provider?
Is there a JSON REST API for the SII, without dealing with the AEAT’s SOAP?
Can I test the SII without sending real data to the AEAT?
Do I need a digital certificate?
Start integrating today
Try it for free with the test environment.