Rectificativa
Corrige importes o datos de una factura emitida. Todos los tipos, de R1 a R5.
Cuándo: un descuento posterior, una devolución, un error en la base.
Antes de empezar
Lo que necesita quien integra.
- Un programa que puedas modificar Propio, un ERP o a medida: tiene que llamar a la API al emitir cada factura.
- El NIF por el que facturas Y, si facturas por varios, la lista de todos.
- Tu firma, no un certificado Enviamos en tu nombre con la autorización del paso 2. No necesitas certificado digital.
1
Solicita el alta
Una persona del equipo revisa cada alta, porque enviaremos facturas en tu nombre.
- Envías la solicitudRazón social, NIF, contacto y el plan que te interesa.
- La revisamosSi falta algo, te escribimos. Si no la aprobamos, te decimos el motivo.
- Recibes un correoCon un enlace para crear tu contraseña, válido 72 horas.
- Entras al panelSigues con el paso 2.
2
Tu clave y la documentación
En el panel tienes la clave de tu programa y la documentación con tus datos ya puestos.
- Genera tu clave de APICópiala al crearla y guárdala en la configuración de tu programa, no en el código. Después solo verás su principio.
- Abre la documentaciónEn OpenAPI 3, con los tres servicios (enviar, anular y consultar), los errores y ejemplos con tu NIF.
- Firma el Anexo ILa autorización de representación viene rellena en Autorización: la firmas y la subes con tu DNI. No bloquea la integración.
- Una clave, tus NIFSolo envía por los NIF que tiene autorizados, hasta 120 peticiones por minuto.
3
Envía una factura
Una petición por factura, al emitirla. Si algo falta o está mal, la respuesta te lo dice antes de que llegue a la AEAT.
Ejemplo simplificado
POST /api/v1/verifactu/enviar{ "factura": { "IDEmisorFactura": "B00000000", "NumSerieFactura": "2026-0142", "Destinatarios": [{ "NIF": "B11111111" }], "ImporteTotal": "1210.00" } }
200 · la AEAT ha aceptado el registro{ "data": { "estado_registro": "Correcto", "csv": "A7K2-9QX1-M4TD", "huella": "3F9A0B…7D2C21E", "qr_url": "https://…" } }
La petición completa y la cabecera con tu clave están en la documentación del panel.
- Validamos antes de enviarSi falta un dato, recibes un
400con el motivo y no se envía nada a la AEAT. - Reenviar no duplicaSi tu programa envía dos veces la misma factura, se registra una sola vez.
- Consulta cuando quierasCon
/consultarpreguntas por el estado de una factura. En el panel ves cada envío con su respuesta.
Qué guardar de cada respuesta
- estado_registro
- Si la AEAT la aceptó o la rechazó, y el motivo.
- csv
- El justificante de la AEAT. Va impreso en la factura.
- qr_url
- La dirección del código QR que imprime tu programa.
- huella
- Identifica el registro en la cadena y demuestra que no se ha modificado.
4
El QR en la factura
El PDF lo sigue generando tu programa. Solo añade tres datos que le devolvemos.
1
El código QRLo generas con la dirección que te devolvemos en
qr_url. Sirve para comprobar la factura en la sede de la AEAT.2
La leyenda VERI*FACTUIndica que es una factura verificable. Va junto al QR.
3
El código seguro de verificaciónEl
csv de la respuesta: el justificante de que la AEAT recibió el registro.Compruébalo con el móvilEscanea el QR de tu primera factura: se abre la sede de la AEAT con la factura registrada.
5
Corrige sin borrar
Una factura registrada no se modifica ni se borra: se corrige con otro registro, y los dos quedan en la cadena.
Sustitutiva
Sustituye a una o varias facturas anteriores, por ejemplo simplificadas por una completa.
Cuándo: tu cliente te pide la factura completa de un ticket.
Anulación
Deja sin efecto un registro con /anular. La factura original no se borra.
Cuándo: una factura emitida por error que no debió existir.
6
Cuando algo sale mal
Lo que hacemos nosotros y lo que hace tu programa.
Si…Qué pasaQué haces tú
Falta un dato o está mal
400Te devolvemos el motivo y no enviamos nada a la AEAT.
Corriges el dato y la envías de nuevo.
Envías dos veces la misma factura
Una sola vezSe registra una vez; el reenvío no la duplica.
Nada.
La AEAT falla un momento
ReintentoRepetimos el envío por ti.
Nada.
La AEAT está caída
503Dejamos de insistir y te respondemos con el error. No queda registrada.
La reenvías más tarde. No se duplica.
La AEAT la rechaza
RechazadaRecibes el motivo en la respuesta y en el panel.
Nos escribes y lo resolvemos contigo.
Pasas de 120 peticiones por minuto
LímiteLas siguientes se rechazan hasta que pasa el minuto.
Espacias los envíos o los repites pasado el minuto.
7
Antes del primer envío real
Lo que marques se guarda en este navegador.
¿Listo para conectar tu programa?
Solicita el alta y tendrás en el panel la documentación con tu NIF ya puesto.
Si te atascas, te ayuda una persona del equipo.
