Sandbox

¿Qué es el modo Sandbox?

Sandbox es un entorno de pruebas aislado que te permite probar B2Brouter — emitir facturas, enviar documentos, ejercitar la API — sin tocar datos reales, destinatarios reales ni el contador de transacciones de tu suscripción.

Cada sandbox es un espacio de trabajo autónomo con sus propios datos: facturas, contacts, productos, plantillas y claves API, todos separados de tu cuenta de producción. Todo lo que creas en sandbox se queda en sandbox; todo lo que creas en producción se queda en producción.

Para qué sirve Sandbox:

Probar B2Brouter de extremo a extremo antes de comprometerte con un plan de pago.
Validar tu integración de API antes de apuntarla a producción.
Realizar formación, demos o trabajo de prueba de concepto sin afectar a tus datos reales.
Llevar documentos a través de su ciclo de vida (draft → sent → registered) para que tu código de integración pueda ejercitar la ruta exitosa de la máquina de estados.

Nota. Por el momento Sandbox simula únicamente el happy path. Las operaciones de envío siempre tienen éxito y los documentos siempre alcanzan su estado final — sandbox no reproduce respuestas de rechazo, fallos de red u otras condiciones de error. Prueba esas situaciones contra tu propia infraestructura de staging, no contra B2Brouter Sandbox.

Lo que Sandbox no es:

No es una versión de staging o prelanzamiento de B2Brouter. Ejecuta el mismo código que producción — solo difieren los datos y las integraciones salientes.
No es una copia de seguridad ni una copia de tus datos de producción. Los sandboxes comienzan vacíos (salvo unos pocos registros iniciales extraídos de tu cuenta) y son independientes.

Primeros pasos

Crear un sandbox (interfaz web)

Inicia sesión en B2Brouter.
Haz clic en el botón Developers (icono de rayo) en la cabecera.
- Si aún no tienes una suscripción eDocExchange, esto abre directamente el banner de integración — tu primer sandbox se crea desde ahí.
- Si ya tienes eDocExchange, el área de Developers incluye una sección dedicada a Sandbox (icono de caja); ábrela.
Haz clic en Crear Sandbox.
En el modal, asigna un nombre a tu sandbox. El nombre predeterminado es el nombre de tu cuenta seguido de “Sandbox” — cámbialo si quieres gestionar varios a la vez.
Haz clic en Crear. Tu nuevo sandbox aparece en la lista.

Tras crear tu primer sandbox, el punto de entrada a Developers se convierte en la lista de Sandboxes para todos — mostrando cada sandbox asociado a tu cuenta o grupo de integración, con filas para abrir, renombrar o eliminar cada uno.

Puedes tener hasta 5 sandboxes por cuenta o grupo de integración. El botón Crear se desactiva una vez alcanzado el límite; elimina un sandbox existente para liberar un slot.

Abrir un sandbox

En la lista de Sandboxes, haz clic en el icono de abrir (↗) junto al sandbox que quieres usar. B2Brouter te cambia al modo sandbox y te lleva a la página de Claves API de ese sandbox.

Mientras estás en modo sandbox, una franja morada recorre la parte superior de cada página recordándote en qué entorno estás. Cada página que visitas, cada acción que realizas — facturación, contacts, configuración — opera contra el sandbox hasta que salgas.

Salir de un sandbox

Haz clic en Salir del Sandbox en la franja morada. Vuelves a tu cuenta de producción y la franja desaparece.

Puedes volver a entrar en el mismo sandbox en cualquier momento desde la lista de Sandboxes — los sandboxes persisten hasta que los eliminas.

Eliminar o renombrar un sandbox

Desde la lista de Sandboxes:

Renombrar: haz clic en el icono de renombrar, edita el nombre en línea.
Eliminar: haz clic en el icono de eliminar. Todos los datos de ese sandbox (facturas, contacts, claves API, etc.) se eliminan permanentemente.

Usar la API en Sandbox

El enrutamiento a Sandbox se controla completamente por la clave API. No hay una URL separada para sandbox, no hay subdominio sandbox. y no hay cabecera de entorno que configurar. Usa la URL base estándar de la API de B2Brouter — https://api.b2brouter.net/ — y:

Las claves de producción empiezan con prod_ (o sin prefijo para claves legacy).
Las claves de sandbox empiezan con test_.

Cuando llamas a un endpoint con una clave test_…, tu solicitud se sirve automáticamente desde el entorno sandbox. Cuando llamas con una clave de producción, va a producción. El mismo endpoint, el mismo cuerpo de solicitud — el enrutamiento ocurre en la clave.

Obtener una clave API de sandbox

Abre el sandbox que quieres usar (interfaz web, ver §2.2).
Llegas automáticamente a su página de Claves API. Si no, navega allí desde el menú.
Genera o copia la clave API. Empezará con test_.

Pasa esa clave en la cabecera X-B2B-API-Key (o el parámetro de consulta api_key, si tu cliente solo admite parámetros de consulta) en cada solicitud que quieras enrutar a sandbox.

Qué funciona

Cada endpoint de la API que llamarías en producción también funciona en sandbox: crear facturas, contacts, grupos de integración, enviar documentos, obtener estados, webhooks, exportar XML, etc. El comportamiento es idéntico excepto por las llamadas salientes simuladas descritas a continuación.

Webhooks

Los webhooks sí se disparan desde sandbox. Esto es intencional — la entrega de webhooks es algo que los integradores necesitan probar. Configura una URL de webhook en un grupo de integración de sandbox y recibirás llamadas allí a medida que cambien los estados de los documentos. Los webhooks de producción y sandbox son independientes: se configuran por separado y no se cruzarán.

Implicaciones del uso de Sandbox

Identidad compartida, datos separados

Tu identidad de usuario se comparte entre producción y sandbox: el mismo inicio de sesión, contraseña, configuración 2FA y códigos de recuperación funcionan en ambos. Inicias sesión una vez y puedes moverte libremente entre entornos.

Todo lo demás está aislado entre los dos entornos:

Independiente en cada entorno — facturas, presupuestos, contacts, productos, plantillas, grupos de integración y su configuración, claves API, webhooks, participantes PEPPOL del sandbox. Crear cualquiera de estos en un entorno no los hace visibles en el otro.
Solo en producción — tu suscripción real y datos de facturación, participantes PEPPOL reales (registrados en el Directorio PEPPOL / SML / SMP), conectores reales (SFTP, B2Bconnector).
Solo en sandbox — datos de prueba que creas mientras estás en modo sandbox. Nada de esto se publica, factura ni transmite nunca.

Las integraciones salientes son simuladas

Cuando envías un documento desde sandbox (emites una factura, envías un aviso de expedición, generas un informe fiscal), B2Brouter simula el envío y hace avanzar el documento a su estado final — sin contactar ningún sistema externo.

Concretamente:

No se envían emails. Entrega de documentos por email, emails de restablecimiento de contraseña, notificaciones de error: ninguno de estos sale del sandbox.
No hay tráfico PEPPOL. Tus documentos de sandbox no se transmiten por la red PEPPOL. Tus participantes de sandbox no están registrados en el Directorio PEPPOL, SML ni SMP.
No hay envíos reales a autoridades fiscales. SII, TicketBAI, Verifactu, Chorus, ZATCA y similares enrutan a los endpoints de prueba propios de la autoridad o se omiten completamente — nada de lo que hagas en sandbox llega a una autoridad fiscal de producción.
No hay pagos. Las llamadas a Stripe y otras pasarelas de pago están desactivadas.

El documento sigue transitando por su ciclo de vida normal (draft → sent → registered, etc.) para que tu código de integración pueda ejercitar la máquina de estados completa.

Marca de agua en los documentos descargados

Las facturas y presupuestos descargados desde sandbox llevan una marca de agua clara — “No vàlida — Factura de proves generada des de B2Brouter Sandbox” — en cada vista previa HTML y PDF. Esto hace imposible confundir los documentos de prueba con los reales.

Sin restricciones de suscripción

En sandbox, todas las funciones del nivel eDocExchange están disponibles independientemente de tu suscripción real. Los límites de recuento de transacciones, límites de usuarios y comprobaciones de derechos de producto se eliminan. El uso de sandbox no cuenta contra la cuota de transacciones de tu suscripción de producción.

Los sandboxes son desechables

Puedes eliminar y recrear sandboxes libremente. No hay coste por usarlos. Trátalos como temporales — el único límite es el de sandboxes activos simultáneamente por propietario (ver §5.3).

Limitaciones

Qué no está disponible en Sandbox

Entrega real de documentos — los destinos PEPPOL, email, B2Bconnector y SFTP no están conectados. Los envíos salientes son solo simulados.
Pagos reales — sandbox no puede procesar pagos de suscripción. Las secciones de Suscripción / Pago / Facturación están ocultas dentro del sandbox.
Verificación de autoridades fiscales — las comprobaciones de NIF/censo contra la AEAT y autoridades similares se omiten.
Conexiones (Transport) — la pestaña de Conexiones está desactivada en sandbox. Añade y configura los transportes desde producción.
B2Bconnector y SFTP — estos canales no funcionan contra un entorno sandbox. Usa la API o la interfaz web para las pruebas.
Cierre de cuenta — no puedes cerrar ni degradar tu cuenta desde dentro del sandbox. Sal a producción primero.

Los cambios de perfil ocurren en producción

Para cambiar tu nombre, contraseña, idioma, zona horaria, dirección de email o la configuración 2FA, sal del sandbox primero. Estas acciones están desactivadas intencionalmente mientras estás dentro del sandbox: tu identidad es compartida, por lo que los cambios siempre se aplican globalmente y deben realizarse desde el entorno de producción para mayor claridad.

Cuota: 5 sandboxes por propietario

Puedes tener hasta 5 sandboxes activos por cuenta o grupo de integración. Elimina uno para liberar un slot.

Las claves API no cruzan entornos

Una clave test_… solo es válida contra el entorno sandbox, y una clave de producción solo es válida contra producción. Si envías una clave de sandbox a un endpoint que resuelve datos de producción (o viceversa), la solicitud se rechaza.

Esto también significa: no confirmes claves de sandbox en tu configuración de producción, y no pegues claves de producción en tus herramientas de sandbox. Mantenlas separadas.

Preguntas frecuentes

¿El uso de sandbox afectará a mi cuota de suscripción o al recuento de facturas? No. El tráfico de sandbox está completamente separado de la facturación de producción. Los documentos que creas en sandbox no cuentan para los límites de transacciones, y las solicitudes de la API de sandbox no aparecen en tus informes de uso de producción.

¿Puedo importar datos de producción en un sandbox? No como clonación con un clic. Cada nuevo sandbox comienza con la estructura básica de tu cuenta (proyecto, empresa, membresía del propietario) y por lo demás está vacío. Para poblarlo con datos realistas, usa la API o los flujos de importación de la interfaz web igual que harías en producción.

¿Cómo distingo los documentos de sandbox de los reales? Tres señales:

La franja de Sandbox morada es visible en la parte superior de cada página en modo sandbox.
Cada factura o presupuesto descargado lleva una clara marca de agua “No vàlida”.
Las claves API de sandbox empiezan con test_; las claves de producción no.

¿Puedo compartir un sandbox con un compañero de equipo? Sí. Cualquier persona que sea miembro de la cuenta propietaria o del grupo de integración ve el sandbox en su lista de Sandboxes y puede abrirlo. No hay permisos separados por sandbox que gestionar.

¿Qué le pasa a mi sandbox si cancelo mi suscripción? Los sandboxes están vinculados a tu cuenta de B2Brouter, no a un nivel de suscripción de pago. Permanecen disponibles independientemente del estado de tu suscripción.

¿Puedo tener una clave API de sandbox con permisos restringidos? Sí — las claves API de sandbox admiten el mismo alcance de permisos (claves restringidas, capacidades de sección, etc.) que las claves de producción.

¿A dónde ir después?

Referencia de la API: consulta la documentación de la API en el portal de desarrolladores.
¿Encontraste un problema en sandbox? Abre un ticket de soporte desde dentro del sandbox — llegará a nuestro equipo.