Modo test
Prueba tu integración sin tocar producción.
Prueba el flujo real con datos y numeración aislados. Nada llega a Hacienda, FACe ni a tus clientes.
- Mismo contrato en el flujo principal
- Datos y numeración separados
- El prefijo decide el entorno
Integraciones y formatos compatibles
WhatsApp
Anatomía de la clave
El prefijo decide el entorno
Empresa sandbox aislada. Efectos externos bloqueados.
Tu empresa real. Numeración fiscal, AEAT, correos y webhooks reales.
No hay ningún parámetro que pueda enviar por error una petición de test a producción. Lo decide la clave que envías.
Comprueba la conexión
export FACTUAREA_API_KEY='fact_test_…'
curl https://api.factuarea.com/v1/account \
-H 'Authorization: Bearer $FACTUAREA_API_KEY'Guarda tu clave fact_test_ en la variable y ejecuta tu primera llamada.
La frontera
Todo se ejecuta. Nada sale fuera.
Crea la factura, calcula impuestos y recorre sus estados. El sandbox conserva el resultado y neutraliza solo las salidas que tocarían a terceros.
- Prueba respuestas realesValidaciones, totales, estados y errores usan el mismo contrato del flujo principal.
- Aísla cada salidaAEAT queda local, el correo no se entrega, el evento se guarda y FACe devuelve un registro sintético.
- Conoce las dos excepcionesEl ping sí comprueba conectividad y firma. Las operaciones irreversibles siguen siéndolo.
Factura
201 · creada
AEAT
registro solo local
Correo
no entregado
Webhook
livemode: false
Datos separados de verdad
Prueba con tu propia numeración, sin tocar la real
El sandbox es otra empresa con clientes, documentos y series propios. Una clave de producción nunca ve ni consume sus recursos.
- Numeración aparteLa numeración de pruebas usa las series del sandbox. Nunca consume ni altera la secuencia de tus series de producción.
- Aislamiento por empresaNo es un filtro sobre los mismos datos: son dos empresas. Una clave live no ve los recursos de test, ni al revés.
- Recursos independientesLos datos creados en test no pasan a producción. El sandbox sirve para validar la integración, no para preparar el arranque real.
fact_live_…
FRA 2026/0183
FRA 2026/0184
fact_test_…
FRA 2026/0006
FRA 2026/0007
De pruebas a producción
Cambiar de entorno es cambiar una variable
No hay doble implementación para las operaciones disponibles en ambos entornos. La forma de la petición es idéntica: lo que cambia es la clave que envías.
- Crea la clave liveCon los mismos scopes que ya validaste en pruebas. El secreto se devuelve en claro exactamente una vez: guárdalo en ese momento.
- Sustituye la claveDonde la tengas: la variable de entorno, el gestor de secretos, la configuración del despliegue. Nada más.
- No toques el códigoLa forma de la petición es la misma para las operaciones disponibles en ambos entornos, así que no hay nada que adaptar en ese flujo.
24 h
La ventana de gracia al rotar
Secreto anterior
Secreto nuevo
Rotar emite un secreto nuevo y lo devuelve una sola vez. El anterior se sigue aceptando durante 24 horas, así que puedes desplegar sin cortar el servicio. Cuando se cierra la ventana, el anterior deja de valer.
Superficie publicada
Una integración que encaja con tu stack
El contrato OpenAPI, los SDK y el servidor MCP parten de la misma API. Las cifras se revisan contra la superficie publicada para que puedas evaluar alcance y mantenimiento antes de integrar.
- operaciones API
- 413
- recursos
- 37
- herramientas MCP
- 391
- páginas de documentación
- 797
Tecnologías y clientes compatibles
TypeScript
PHP
OpenAPI
Cursor
Los logotipos identifican tecnologías o clientes compatibles; no implican una relación comercial ni un testimonio.
Dudas
Tres dudas antes de empezar
No. Una clave fact_test_ opera sobre la empresa sandbox y usa las series de esa empresa. La secuencia de tus series de producción no se toca ni se consume.
Prueba la integración con datos aislados
Crea una clave fact_test_ y valida el circuito completo antes de activar producción.