Documentación

Entorno de pruebas

El entorno de pruebas es un despliegue gemelo de producción conectado alportal de preproducción oficial de la AEAT. Todo el flujo es real —huellas encadenadas, XML, QR, respuestas de la Agencia— pero sin trascendencia tributaria: puedes emitir, anular y equivocarte sin consecuencias. No es un simulador: cada llamada llega a la preproducción oficial de la AEAT y responde como lo hará producción.

URL base y credenciales

# Sandbox (AEAT preproducción)
https://sandbox.factubridge.es/v1

En los ejemplos, $BASE_URL es esta URL del sandbox. La URL base de producción es https://api.factubridge.es/v1; suAPI key te la entregamos cuando la integración está validada, la del sandbox, al empezar.

Qué es idéntico y qué no

Aspecto	En pruebas
Endpoints, schemas y validaciones	Idénticos a producción.
Encadenamiento, huella y QR	Reales. El QR apunta al cotejo de preproducción de la AEAT.
Respuestas AEAT (`Correcto`, `AceptadoConErrores`, `Incorrecto`)	Reales, emitidas por la preproducción de la Agencia.
Validación del destinatario (censo/VIES)	Servicios de producción: no existe censo de pruebas. Con `validar_destinatario=true` los NIF deben estar realmente censados; en pruebas suele convenir dejarlo en `false`.
Datos	Sin efecto fiscal. Usa NIFs de destinatario ficticios pero con formato válido.

Verificación de extremo a extremo

Los cuatro pasos que validan una integración completa:

# 1. La API key responde
curl "$BASE_URL/health" -H "Authorization: Bearer $API_KEY"

# 2. Alta de una factura de prueba
curl -X POST "$BASE_URL/create" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "serie": "TEST", "numero": "1",
    "fecha_expedicion": "02-07-2026",
    "tipo_factura": "F1",
    "descripcion": "Factura de prueba de integración",
    "nif": "B87654321", "nombre": "CLIENTE PRUEBA SL",
    "lineas": [{"base_imponible": "100.00",
                "tipo_impositivo": "21.00",
                "cuota_repercutida": "21.00"}],
    "importe_total": "121.00"
  }'

# 3. Estado del registro
curl "$BASE_URL/status?serie=TEST&numero=1" \
  -H "Authorization: Bearer $API_KEY"

# 4. Anulación
curl -X POST "$BASE_URL/cancel" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serie": "TEST", "numero": "1",
       "fecha_expedicion": "02-07-2026"}'

Lista de comprobación antes de producción

Alta (F1 y, si emites tickets, F2) con el QR incrustado en el documento final a 30–40 mm.
Anulación y al menos una rectificativa del tipo que use tu negocio.
Resultado AEAT recogido por webhook o consulta de estado.
Manejo del 409 de duplicado como reintento seguro.
Series separadas para pruebas y producción en tu SIF (evita colisiones de clave natural al migrar).

Cuando esa verificación está en verde, el paso a producción es cambiar URL base y API key. Si quieres, lo revisamos juntos antes de activar:contacto.