Como usar la API de Verifactu
El plugin Verifactu incluye una API para enviar facturas 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.
📤 Enviar factura
Hay dos formas de enviar facturas a la AEAT:
- Configurar un estado de factura para que, cuando la factura alcance ese estado, se envíe automáticamente. Se explica cómo hacerlo aquí. En este flujo se utiliza el endpoint crearFacturaCliente; después solo tienes que actualizar la factura y cambiar el idestado por el que dispare el envío.
- Llamar directamente al endpoint verifactu, pasando el idfactura y action = alta. Con esto indicas explícitamente qué factura quieres enviar a Hacienda.
🛠️ Subsanar factura
Funciona igual que la opción 2 de "Enviar factura", pero usando action = subsanacion.
🗑️ Anular factura
Funciona igual que la opción 2 de "Enviar factura", pero usando action = anulacion.
📷 Obtener QR
Si la factura ya fue enviada, puedes obtener su QR llamando al endpoint verifactu con action = qr. Recibirás la imagen del QR codificada en base64.
Acciones soportadas (resumen):
- alta — enviar factura
- subsanacion — subsanar factura
- anulacion — anular factura
- qr — obtener QR en base64
Si necesitas ejemplos de llamadas al endpoint o respuestas esperadas, dímelo y te los preparo.