API, seguridad y errores
Sandbox de Verifactu: probar sin mezclar producción
Cómo validar una integración Verifactu en el entorno de pruebas de la AEAT y qué datos deben permanecer separados de producción.
Contenido de la guía
Respuesta rápida
El sandbox permite comprobar el formato, la autenticación de la remisión, el envío y la respuesta técnica antes de activar un flujo real. No convierte una prueba en una factura de producción ni sustituye las comprobaciones fiscales del negocio.
La AEAT publica WSDL, esquemas, validaciones y servicios de pruebas en su portal técnico.
Qué conviene validar
Una prueba útil no consiste únicamente en obtener un HTTP correcto. El recorrido mínimo debería comprobar:
- generación del registro de alta con los datos obligatorios;
- cálculo de la huella y referencia al registro anterior;
- autenticación de la remisión;
- interpretación de la respuesta por registro;
- tratamiento de rechazos, subsanaciones y reintentos;
- idempotencia cuando una plataforma repite el mismo evento;
- rectificación de una devolución total o parcial.
Qué debe quedar separado de producción
El diseño objetivo de VeriFactu Fácil modela sandbox y producción como espacios distintos. Antes de abrir las altas deberá verificarse que cada uno mantiene por separado:
| Elemento | Motivo del aislamiento |
|---|---|
| Certificado y credenciales | Evitar que una prueba utilice material destinado a producción |
| API keys y webhooks | Impedir que un evento test dispare una factura real |
| Series y numeración | No mezclar el historial de pruebas con la numeración comercial |
| Registros y respuestas | Conservar una trazabilidad inequívoca por entorno |
| Conexiones de plataforma | Diferenciar, por ejemplo, Stripe test de Stripe live |
Copiar la configuración inicial puede ahorrar tiempo, pero el estado fiscal y la numeración deben continuar aislados.
Una operación de prueba determinista
Para saber si la integración funciona de verdad conviene utilizar siempre el mismo caso controlado: una operación pequeña, con importes y tipo de factura conocidos, un identificador externo irrepetible y una respuesta esperada documentada.
Después hay que repetir el evento. La segunda llamada no debería crear otra factura ni otro registro. Esa repetición valida una propiedad esencial en eCommerce: un webhook reintentado no puede duplicar una venta.
Cuándo pasar a producción
El salto debería producirse solo cuando:
- el negocio y el domicilio fiscal están completos;
- el certificado de producción está vigente y corresponde al entorno correcto;
- la operación determinista ha sido aceptada en sandbox;
- el canal de venta está conectado en el modo correcto;
- el equipo sabe cómo actuar ante un rechazo o una respuesta ambigua.
La web de VeriFactu Fácil está actualmente en prelanzamiento. Las altas y la compra se habilitarán cuando este recorrido pueda completarse de extremo a extremo.
Siguiente paso
Cuéntanos qué sistema necesitas conectar
El servicio está en prelanzamiento. Revisamos el canal, el volumen y los datos fiscales antes de abrir una integración.
Hablar sobre tu integración →