Entorno de pruebas (Sandbox)
Un sandbox es una empresa de prueba aislada de tu empresa real. Puedes usarlo para experimentar con FacturaDirecta, probar integraciones, formar a tu equipo o preparar demostraciones sin riesgo para los datos productivos.
Lo que haces en el sandbox no afecta a tu empresa real. Tiene sus propios datos, su propio identificador de empresa y su propio acceso.
Puedes usarlo para:
crear facturas, gastos y documentos de prueba;
probar plantillas, temas y configuración;
ensayar integraciones y flujos nuevos;
formar a nuevos usuarios;
hacer demostraciones profesionales con datos ficticios;
probar la API sin tocar datos reales.
Cuando estás dentro de un sandbox, FacturaDirecta muestra el modo de prueba para recordarte que estás usando datos simulados y que no se procesarán transacciones reales.
Qué necesitas para crear un sandbox
Para crear un entorno de pruebas necesitas:
un usuario de FacturaDirecta;
una empresa real creada en FacturaDirecta, aunque sea con plan gratuito;
permisos suficientes en esa empresa.
Solo el propietario de la cuenta puede crear sandboxes. Los usuarios de soporte también pueden hacerlo en tareas internas de asistencia. Si tu usuario no puede crear uno, FacturaDirecta muestra el aviso Solo el usuario propietario de la cuenta puede crear entornos de prueba.
Cada empresa puede tener un número máximo de sandboxes. Si alcanzas ese límite, verás Ya has alcanzado el número máximo de entornos de prueba disponibles.
Cómo abrir Entorno de pruebas
Entra en Ajustes.
Abre API e Integraciones.
Selecciona Entorno de pruebas (Sandbox).
Desde una empresa real, este apartado permite crear sandboxes y consultar los ya existentes. Desde dentro de un sandbox, permite eliminar el sandbox actual.
Crear un sandbox
Desde tu empresa real, pulsa Crear nuevo entorno de pruebas.
Antes de continuar, FacturaDirecta muestra un diálogo de confirmación. El diálogo explica que se creará un entorno aislado y recuerda las integraciones deshabilitadas y los límites del sandbox.
Al confirmar, FacturaDirecta abre el asistente de alta de empresa en modo sandbox. El sistema puede usar la configuración de tu empresa real como punto de partida, pero no copia los documentos reales de tu empresa principal.
Durante la creación se revisan datos como:
nombre de la empresa de prueba;
usuarios que tendrán acceso;
país;
configuración fiscal;
tipo de negocio.
Al terminar, el sistema te redirige al nuevo sandbox.
Consultar sandboxes existentes
Si ya tienes sandboxes asociados a la empresa real, el apartado muestra el aviso Tienes N entornos de prueba asociados a esta empresa y una tabla con:
Nombre — nombre del sandbox o Sin nombre si no tiene uno;
Usuarios asignados — número de usuarios con acceso o Sin usuarios.
Pulsa una fila para entrar en ese sandbox. El menú de tres puntos permite abrir la acción Eliminar entorno de pruebas.
Limitaciones del sandbox
Los sandboxes tienen limitaciones por seguridad y para evitar acciones reales no intencionadas.
Integraciones deshabilitadas
En un sandbox no funcionan como en producción:
Enlace con bancos — no puedes conectar cuentas bancarias reales ni importar movimientos de entidades financieras.
Google Drive — no se suben documentos a Google Drive.
Envío real de emails — los correos no se envían al destinatario real. Se redirigen al correo del usuario para que puedas revisar el resultado sin escribir a clientes reales.
Tareas recurrentes automáticas — puedes configurarlas y probarlas manualmente, pero no se ejecutan automáticamente en el horario configurado.
PDFs con marca de agua — los PDFs incluyen marcas de agua que los invalidan como facturas reales.
VeriFactu — apunta siempre al entorno de pruebas de la AEAT.
Límites de datos
El diálogo de creación recuerda estos límites:
Recurso | Límite en sandbox |
Clientes | 100 |
Productos | 100 |
También puede haber límites operativos adicionales para mantener el rendimiento y evitar usos productivos del entorno de pruebas.
Qué puedes hacer en un sandbox
Dentro del sandbox puedes trabajar como en una empresa independiente, con las limitaciones anteriores. Por ejemplo:
crear facturas, presupuestos, albaranes, compras o gastos de prueba;
revisar previsualizaciones de PDF;
probar plantillas;
configurar datos fiscales y de empresa;
probar usuarios y permisos;
preparar pruebas de API;
ensayar procesos antes de aplicarlos en la empresa real.
Recuerda que los documentos del sandbox son datos de prueba y no deben usarse como documentos reales.
Eliminar un sandbox desde la empresa real
Desde la empresa real:
Entra en Ajustes → API e Integraciones → Entorno de pruebas (Sandbox).
Busca el sandbox que quieres eliminar.
Abre el menú de tres puntos de la fila.
Selecciona Eliminar entorno de pruebas.
Confirma la eliminación.
La eliminación es permanente: se borran los datos del sandbox y no se puede deshacer.
Eliminar el sandbox desde dentro
Cuando estás trabajando dentro de un sandbox, el apartado Entorno de pruebas (Sandbox) cambia y muestra la opción Eliminar este entorno de pruebas.
FacturaDirecta muestra un aviso: Estás trabajando en un entorno de pruebas (sandbox). También recuerda que, si lo eliminas, se borrarán permanentemente todos sus datos.
Solo el propietario del sandbox puede eliminarlo. Si no eres propietario, el botón aparece deshabilitado con el mensaje Solo el propietario ({email}) puede eliminar este sandbox.
El diálogo de eliminación tiene confirmación reforzada:
Te pregunta si quieres eliminar el entorno de prueba, mostrando su nombre e identificador.
Te pide escribir el nombre del sandbox para confirmar.
Si el nombre no coincide, muestra El nombre no coincide y no permite continuar.
Tras confirmar, FacturaDirecta elimina el sandbox y te redirige a la pantalla de selección de empresas.
Sandbox y API
Los sandboxes son útiles para probar integraciones y llamadas a la API sin usar los datos reales de tu empresa. Para crear un sandbox no se parte de una cuenta independiente de API: primero necesitas una empresa de FacturaDirecta y luego creas el entorno de pruebas desde sus ajustes.
Si vas a probar la API:
crea el sandbox desde la empresa real;
entra en el sandbox;
configura ahí las claves o integraciones que necesites;
ten en cuenta las limitaciones del entorno de pruebas.
Recursos relacionados
Roles y permisos — el propietario de la cuenta es quien puede crear o eliminar sandboxes.
API keys — crea claves para tus integraciones.
Eliminar una empresa — diferencias entre eliminar una empresa real y eliminar un sandbox.