Esta página no explica la norma. Explica cómo una integración evita tener que implementar su parte más frágil. Tu producto conserva el pedido, la suscripción o el pago; FiscalRail recibe los hechos comerciales y se convierte en el sistema de facturación.
La integración que construyes
Usa una API JSON sobre HTTPS para crear clientes, emitir facturas y recuperar su estado. No implementas autenticación con certificado cliente de la AEAT, peticiones SOAP ni validación de XML. FiscalRail se encarga de ese protocolo y expone objetos estables, errores estructurados e idempotencia (en inglés) para que un timeout no cree una segunda factura.
Los fallos dejan de ser casos especiales
- Antes de emitir: la API valida la factura, los datos requeridos y el formato de identificación. Las verificaciones fiscales se exponen como estado, no como una adivinanza escondida en una respuesta remota.
- Al emitir: FiscalRail asigna el número, calcula los totales y guarda la factura inmutable en una sola operación. Repite una petición perdida con la misma clave de idempotencia y recibe el resultado original.
- Al remitir: una caída temporal de la AEAT no borra la factura ni bloquea tu worker. FiscalRail conserva el registro pendiente y reintenta la entrega.
- Cuando llega el resultado: consulta la factura cuando quieras o recibe un webhook firmado para aceptaciones, incidencias y rechazos. Deduplica por ID de evento y recupera el estado actual.
Prueba el contrato antes de Live
El entorno Test ejecuta la misma forma pública de factura, QR, registro y webhooks sin contactar con la AEAT. Incluye resultados deterministas de aceptación, aceptación con errores, rechazo y reintento transitorio, para que tus jobs y alertas no se estrenen en producción.
Cuando el flujo esté probado, el obligado emisor concede a FiscalRail la representación AEAT necesaria; FiscalRail la verifica antes de habilitar la emisión Live. La guía VERI*FACTU Live, la guía de pruebas y la guía de webhooks contienen el contrato completo.
VERI*FACTU, explicado para equipos de software
Preguntas de integración
¿Debemos mantener una conexión o certificado de la AEAT?
No. Tu integración usa las credenciales de API de FiscalRail. La representación AEAT se configura una vez para la cuenta Live del obligado; consulta el proceso IZ860.
¿Webhook o polling?
Ambos. Usa webhooks firmados para reaccionar al resultado y recupera la factura cuando necesites el estado actual. Las entregas son al menos una vez y sin orden, por lo que se deduplican por ID de evento.
¿Qué tengo que reintentar yo?
Reintenta una emisión cuyo resultado hayas perdido con la misma clave de idempotencia. FiscalRail reintenta por separado los fallos transitorios de remisión a la AEAT; tu integración observa el resultado del registro.