El plugin Verifactu incluye una API para generar registros de facturación y gestionar su envío a la AEAT y realizar otras acciones relacionadas. A continuación te explico los ejemplos más comunes y cómo usar el endpoint.
El plugin añade un endpoint llamado "verifactu", que siempre requiere que pases el idfactura y un action.
Hay dos formas de enviar facturas a la AEAT:
Funciona igual que la opción 2 de "Enviar factura", pero usando action = subsanacion.
Funciona igual que la opción 2 de "Enviar factura", pero usando action = anulacion.
Si la factura tiene registros de Verifactu y no está anulada, puedes obtener su QR llamando al endpoint verifactu con action = qr. Recibirás la imagen del QR codificada en base64.
El endpoint verifactu requiere idfactura y action como parámetros de la URL:
| Acción | Método HTTP |
|---|---|
alta |
POST |
subsanacion |
POST |
anulacion |
POST |
qr |
GET |
Por ejemplo, para un alta utiliza POST /api/3/verifactu?idfactura=123&action=alta, con la autenticación de la API de tu instalación. Para obtener el QR, utiliza GET /api/3/verifactu?idfactura=123&action=qr.
El QR requiere que la factura tenga registros de Verifactu y no esté anulada. Una respuesta correcta al alta no sustituye la comprobación del estado del registro: el envío a la AEAT se procesa mediante el cron en modo VERIFACTU. En modo NO VERIFACTU los registros se conservan en la instalación.