Ejemplos de envío de facturas al SII con la API
Aquí tienes 27 ejemplos de envío de facturas expedidas al SII, uno por tipo de factura o clave (completas, simplificadas, rectificativas, intracomunitarias, exportaciones, exentas, IGIC o IPSI, asiento resumen, arrendamientos, grupo de entidades, modificación y anulación), con la petición JSON a la API SII de Verifacti lista para copiar.
Tipos de factura y claves del SII
| Caso | Tipo de factura o clave | Cuándo se usa |
|---|---|---|
| Factura completa | F1 · clave 01 | Factura ordinaria a un cliente con NIF español. |
| Factura simplificada | F2 · clave 01 | Tiques y facturas simplificadas, sin datos del destinatario. |
| Varios tipos de IVA | F1 · S1 con varios tipos | Factura con líneas al 21 %, 10 % y 4 %. |
| Intracomunitaria B2B de bienes | F1 · entrega exenta E5 | Venta de bienes a una empresa de otro Estado miembro. |
| Intracomunitaria B2B de servicios | F1 · prestacion_servicios no sujeta | Servicio a una empresa de otro Estado miembro. |
| Intracomunitaria B2C bajo el umbral | F1 · entrega S1 | Venta a distancia a un consumidor de otro Estado miembro mientras no se superan los 10.000 € anuales de ventas a distancia y servicios TBE en la UE. |
| Intracomunitaria B2C con OSS | F1 · clave 17 | Venta a un consumidor de otro Estado miembro declarada en la ventanilla única (OSS). |
| Exportación de bienes | F1 · clave 02 · exenta E2 | Venta de bienes a un cliente fuera de la UE. |
| Servicios fuera de la UE | F1 · prestacion_servicios no sujeta | Servicio a un cliente de un país no UE. |
| Factura exenta | F1 · exenta E1 | Operación sujeta y exenta, como las del art. 20 LIVA. |
| Operación no sujeta | F1 · no sujeta | Operación fuera del ámbito del IVA. |
| IGIC o IPSI | F1 · clave 08 | Operaciones que se localizan en Canarias, Ceuta o Melilla y tributan por IGIC o IPSI, no por IVA (por ejemplo, servicios que se entienden prestados allí). Los envíos de bienes desde la península a esos territorios son exportaciones: clave 02 y exenta E2. |
| Factura de abono | F1 con importes negativos | Una factura nueva con importe negativo que no corrige otra factura. Las devoluciones y los descuentos posteriores sobre una factura ya emitida van en una rectificativa R1. |
| Factura de canje | F3 · facturas_sustituidas | Cuando el cliente pide una factura completa en lugar del tique. |
| Rectificativas | R1–R5 | Corregir una factura ya emitida. |
| ↳ Por sustitución | R1 · tipo_rectificativa S | La rectificativa sustituye entera a la factura original. |
| ↳ Por diferencias | R1 · tipo_rectificativa I | Se corrige solo la diferencia de importes. |
| Recargo de equivalencia | F1 · S1 con recargo | Venta a un comerciante minorista en recargo de equivalencia. |
| Emitida por terceros o destinatario | especial.emitida_por_tercero_o_destinatario S | Facturación por terceros o autofacturación. |
| REBU | F1 · clave 03 | Venta de bienes usados, objetos de arte, antigüedades u objetos de colección. |
| Inversión del sujeto pasivo | F1 · S2 | Operaciones en las que el cliente es el sujeto pasivo. |
| Asiento resumen | F4 · numero_fin | Muchos tiques del mismo día, numerados de forma correlativa. |
| Criterio de caja | F1 · clave 07 | Quien aplica el régimen especial del criterio de caja. |
| Arrendamiento de local | F1 · clave 12 · inmuebles | Alquiler de un local de negocio. |
| Grupo de entidades | F1 · clave 06 · base_imponible_a_coste | Operaciones entre entidades de un grupo de IVA en nivel avanzado. |
| Modificación | A1 | Corregir una factura Correcto, Aceptado con errores o Duplicado. |
| Anulación | — | Dar de baja una factura registrada en el SII. |
Cómo es un ejemplo de SII
Cada caso trae la petición JSON a la API SII, con pestañas para cURL, Python, JavaScript, Node.js, PHP, Go, Java, C# y VB6. Las fechas, el ejercicio y el periodo ya son los de hoy: cópiala y pruébala con la API key de test del NIF de prueba del SII, que pides a soporte@verifacti.com desde tu cuenta gratuita.
Las altas se envían con POST /sii/create. Una factura que la AEAT ya tiene registrada se corrige con PUT /sii/modify y se anula con POST /sii/cancel.
La API SII envía el libro registro de facturas expedidas: los ejemplos son todos de facturas emitidas.
Preguntas sobre los ejemplos
Preguntas frecuentes SII¿Qué libro envía la API SII?
El libro registro de facturas expedidas, y solo ese. La API SII no envía facturas recibidas ni los demás libros del SII. Qué libros existen y quién los lleva está en libros registro del SII.
¿Puedo probar el SII sin enviar datos reales?
Sí. La cuenta gratuita incluye el entorno de test del SII; el NIF de prueba del SII se pide a soporte@verifacti.com. Tienes peticiones listas para copiar en los ejemplos del SII.
¿Cómo recibo la respuesta de la AEAT?
Por webhook o consultando el estado. Cuando la AEAT responde, Verifacti actualiza el estado del registro: lo recibes en tus webhooks o lo consultas con GET /sii/status. Los estados posibles (Correcto, Aceptado con errores, Incorrecto…) están en la documentación.
¿Cómo modifico o anulo un registro?
Con PUT /sii/modify para modificar un registro (por ejemplo, uno Aceptado con errores) y con POST /sii/cancel para anularlo. Si la AEAT lo rechazó (Incorrecto), no quedó registrado: corrige los datos y vuelve a enviarlo con /sii/create. Ejemplos en modificación y anulación.
Prueba los ejemplos en el entorno de test
Crea tu cuenta gratuita, pide a soporte@verifacti.com el NIF de test del SII y envía cualquiera de estas peticiones con su API key de test.