Webhooks
Un webhook avisaría a tu sistema cuando pasa algo en Faxtal, sin que tengas que preguntar.
:::info Roadmap La API pública todavía no envía webhooks ni permite registrar URLs de aviso. Esta página resume lo previsto. Todavía no hay fecha. :::
Qué se prevé
- Eventos: aviso a una URL tuya cuando se emite una factura, cambia el estado de un envío VeriFactu o SII, o se envía un email.
- Firma: cada entrega llevará una firma para que compruebes que viene de Faxtal.
- Reintentos: una entrega fallida se reintentará, así que tu receptor tendrá que tolerar recibir el mismo evento más de una vez.
Los nombres de los eventos, el formato del payload y la cabecera de firma se documentarán aquí cuando existan.
Mientras tanto: consulta periódica
Hasta entonces, consulta el estado con estas operaciones:
| Quieres saber | Operación |
|---|---|
| El estado VeriFactu de una factura | GET /api/v1.1/invoices/{invoice_id}/verifactu/records |
| Qué registros VeriFactu ha rechazado la AEAT | GET /api/v1.1/verifactu/incidents |
| El estado SII de una factura | GET /api/v1.1/invoices/{invoice_id}/sii/status |
| Qué le ha pasado a una factura emitida | GET /api/v1.1/issued-invoices/{invoice_id}/events |
Ejemplo: estado VeriFactu de una factura.
curl https://app.faxtal.com/api/v1.1/invoices/00000000-0000-0000-0000-000000000001/verifactu/records \
-H "X-API-Key: fctXXXXXXXX_YYYYYYYYYYYYYYYY"Al consultar de forma periódica:
- Espacia las consultas y deja de preguntar por una factura cuando su estado ya es final.
- Cada API key tiene un límite de peticiones. Si lo superas, la API responde
429(ver errores).
La receta seguir el estado VeriFactu de un lote aplica este patrón a muchas facturas a la vez.