VeriFactu y AEAT
No se transmiten registros a la AEAT. Las rutas del módulo VeriFactu directo no están disponibles en sandbox. Una prueba no acredita aceptación fiscal.
Sandbox de facturación
Prueba tus facturas en un entorno separado
Desde la app o con la API, comprueba documentos, totales y estados antes de trabajar con datos reales. Las pruebas tienen su propia empresa y numeración.
- Desde Factuarea
- Datos y numeración separados
- Desde tu integración
FacturaBorrador
Sin número asignadoClienteEstudio Ribera
Consultoría de diseñoCantidad: 2 × 150,00 €300,00 €
- Base imponible
- 300,00 €
- IVA 21 %
- 63,00 €
- Total
- 363,00 €
Documento de prueba sin validez fiscal
Dos empresas, dos numeraciones
Serie de pruebasF-2026-0006
Serie de producciónF-2026-0184
El borrador no consume número. Al emitir, solo avanza la serie de pruebas.
Validaciones y resultados
Comprueba también qué pasa cuando algo falla
El sandbox aplica las validaciones de las operaciones disponibles. Puedes revisar los totales de una factura, corregir datos rechazados y preparar tu integración para responder a los errores.
POST /v1/invoices
fact_test_…Datos de la línea
"lines": [{
"quantity": 2,
"unit_price": 150,
"tax_rate": 21
}]Resultado201 Created
{
"data": {
"status": "draft",
"number": null,
"total": 363,
"currency": "EUR"
}
}Borrador creado: 300,00 € de base y 63,00 € de IVA. Todavía no consume número.
También puedes probar permisos, estados e idempotencia. Usa las capacidades habilitadas por tu plan; el modo test no amplía el acceso ni elimina los límites de la API.
Entender los errores de la APIQué se comprueba de verdad
Prueba el proceso y conoce sus límites
Los datos están separados de producción. Los envíos fiscales y los correos de documentos no llegan a terceros. Los webhooks tienen una excepción concreta: el ping de conexión.
Correo de documentos
Puedes recorrer el envío y sus estados sin entregar el correo al destinatario, tampoco a tu propio buzón.
FacturaE y FACe
La presentación en FACe se simula. El registro FACE-SANDBOX-* no es una presentación real ante la Administración.
Automatizaciones
Puedes revisar disparadores y ejecuciones. Los pasos quedan omitidos con sandbox_neutralized: no se ejecuta el adaptador ni se aplica su acción.
invoice.createdSolo registro internoRegistrado, sin entrega externa
Los eventos de test quedan disponibles para consulta con livemode: false. No se envían al receptor externo.
GET /v1/events "livemode": false
Pasa a producción con lo que has validado
Mismo contrato, recursos distintos
Para las operaciones disponibles en ambos entornos, reutilizas la integración. Preparas los datos reales y utilizas una credencial de producción nueva; editar el prefijo de una clave no la convierte en otra.
Desde Factuarea
Entra en Modo pruebas y comprueba tus documentos. Al volver a Producción, recuperas el contexto de tu empresa real. Los datos de prueba permanecen separados.
Modo pruebasProducción
En la app eliges el entorno desde la cabecera; en móvil, desde el menú de usuario. Una confirmación precede al cambio.Antes de activar producción
0 de 3 puntos revisadosMarca los puntos que ya has comprobado en tu integración.
Elige cómo conectar
Una integración que encaja con tu stack
Trabaja con un SDK, consulta el contrato de la API o conecta tu asistente. Elige tu herramienta para encontrar el punto de partida y la documentación que necesitas.
Tecnologías y clientes compatibles
SDK oficial
Tu integración, en TypeScript
Instala el SDK oficial para trabajar con la API desde Node.js. Incluye reintentos, paginación y verificación de la firma de webhooks.
npm install @factuarea/sdkConectar TypeScript- operaciones API
- 595
- recursos
- 50
- herramientas MCP
- 581
- páginas de documentación
- 1306
Dudas
Dudas sobre el sandbox
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.
Tu negocio, mejor conectadoPrueba la integración con datos aislados
Genera una clave fact_test_ en el panel de desarrolladores. Envíala a la misma URL de la API, con los permisos que necesite tu aplicación.