Qué hace la API, en detalle
Enviar, consultar y anular facturas, con validación previa, huella encadenada y claves con permisos.
Tres llamadas cubren el ciclo completo
Enviar, anular y consultar, con la respuesta de cada una.
Envía la factura a la AEAT. La respuesta trae el QR, el CSV (código seguro de verificación) y la huella encadenada.
# respuesta { "data": { "estado_registro": "Correcto", "csv": "A7K2-9QX1-M4TD", "huella": "9c1e…a7f3", "qr_url": "https://…" } }
Devuelve el estado de la factura ante la AEAT y, si se rechazó, el motivo.
# respuesta { "data": { "num_registros": 1, "registros": [{ "num_serie": "2026-0142", "estado_registro": "Correcto" }] } }
Deja constancia ante la AEAT de que una factura queda anulada, con su propio registro encadenado. Para corregir importes, se envía una rectificativa.
# respuesta { "data": { "estado_registro": "Correcto", "huella": "d41b…6c20", "huella_anterior": "9c1e…a7f3" } }
Respuestas de ejemplo
Todos los tipos de factura: completas, simplificadas, sustitutivas, rectificativas R1 a R5 y exentas E1 a E8.
Ver la guía de integraciónTu clave, con sus propias reglas
Cada integración tiene su clave, y cada clave decide qué puede hacer y por quién.
- Permisos por clave. Una clave de solo lectura no puede enviar ni anular.
- Varios NIF con una sola integración. Útil para un ERP o una gestoría que envía por sus clientes.
- Límite de ritmo. Hasta 120 peticiones por minuto, para que un error en un programa no afecte a los demás.
- Solo guardamos su huella. La clave no se puede recuperar, solo sustituir por otra.
Lo que funciona hoy
Todo esto ya lo hace la API.
- Enviar, anular y consultarCon todos los tipos de factura de Verifactu.
- Validación previaLos errores vuelven con un mensaje legible antes de llegar a la AEAT.
- Huella y registro de eventosEncadenados, como pide la norma.
- QR y CSV en cada respuestaPara que tu programa los imprima.
- Varios NIF con una clavePara ERPs y gestorías que envían por sus clientes.
- OpenAPI 3 en vivoUn contrato versionado en
/api/v1.
¿Y si algo sale mal?
Las dudas que más nos plantean antes de integrar.
Integra la API con tu programa
Solicita el alta y te acompañamos en la integración.
- Alta de factura
- Anulación
- Rectificativas
- Consulta de estado
- Validación previa
- OpenAPI 3