Roles y permisos del dashboard

Catálogo de perfiles, matriz de permisos y recomendaciones para gestionar el acceso de tu equipo en el dashboard de Shinkansen.

El dashboard de Shinkansen usa un modelo de perfiles para controlar qué puede hacer cada persona de tu equipo. Cada usuario puede tener uno o varios perfiles asignados dentro de tu organización y obtiene la unión de los permisos correspondientes.

Esta guía describe los perfiles disponibles, lo que habilita cada uno y las recomendaciones de buenas prácticas para asignarlos.

Entornos: producción y pruebas

Shinkansen opera en dos entornos completamente separados:

• Producción: donde ocurren las operaciones reales con dinero.
• Pruebas (sandbox): un entorno aislado, basado en Simulated Bank, donde puedes integrar y validar tu implementación sin mover fondos reales.

Cada perfil está ligado a un entorno específico, con la única excepción de Admin y Security, que son transversales a ambos.

Catálogo de perfiles

Perfiles transversales

Se aplican tanto en producción como en pruebas.

Perfil	Descripción
Admin	Puede hacer todo lo que los otros perfiles pueden. También puede crear, actualizar y eliminar usuarios y asignarles perfiles.
Security	Puede ver y cambiar la configuración de la organización: api keys, certificados, webhooks, entre otros.

Perfiles de producción

Habilitan funciones dentro del entorno de producción.

Perfil	Descripción
Operations	Puede ver todos los reportes y todos los datos de transacciones del entorno de producción.
Account validator	Puede acceder a los reportes del Validator y realizar validaciones de cuentas desde el entorno de producción.
Treasury viewer	Puede ver reportes de tesorería en el entorno de producción.
Treasury submitter	Puede ver y crear órdenes de pago de tesorería desde el entorno de producción.
Treasury approver	Puede ver y aprobar órdenes de pago de tesorería desde el entorno de producción.
Treasury rule editor	Puede ver órdenes de pago de tesorería, y crear y editar reglas de automatización desde el entorno de producción.
Treasury reconciliator	Puede ver y subir cuentas por cobrar, configurar reglas de conciliación y conciliar o desconciliar movimientos desde el entorno de producción.

Perfiles de pruebas (sandbox)

Habilitan funciones dentro del entorno de pruebas.

Perfil	Descripción
Sandbox Admin	Puede hacer todo lo que los otros perfiles pueden, pero solo en el entorno de pruebas. No puede acceder a producción. Además, habilita el acceso del usuario a Simulated Bank y recibe automáticamente su invitación.
Developer	Puede acceder al entorno de pruebas.
Treasury tester	Desde el entorno de pruebas: puede ver, crear y aprobar órdenes de pago, crear y editar reglas de automatización, y conciliar o desconciliar movimientos.

Matriz de permisos en producción

La siguiente tabla resume lo que cada perfil de producción permite hacer dentro de la organización.

Leyenda: ✓ puede hacerlo · — no tiene acceso

Acción	Admin	Operations	Security	Account validator	Treasury viewer	Treasury submitter	Treasury approver	Treasury rule editor	Treasury reconciliator
Invitar, editar o eliminar usuarios	✓	—	—	—	—	—	—	—	—
Ver órdenes de pago (listado y detalle)	✓	—	—	—	✓	✓	✓	✓	—
Crear órdenes de pago desde el dashboard	✓	—	—	—	—	✓	—	—	—
Aprobar o rechazar lotes pendientes	✓	—	—	—	—	—	✓	—	—
Crear y editar reglas de automatización	✓	—	—	—	—	—	—	✓	—
Validar cuentas bancarias de destinatarios	✓	—	—	✓	—	—	—	—	—
Ver movimientos bancarios y extractos	✓	✓	—	—	✓	—	—	—	—
Ver transacciones y notificaciones de cobros (payins)	✓	✓	—	—	—	—	—	—	—
Cargar cuentas por cobrar y conciliar movimientos	✓	—	—	—	—	—	—	—	✓
Administrar configuración de la organización (webhooks, certificados, api keys)	✓	—	✓	—	—	—	—	—	—

En el entorno de pruebas aplican las mismas acciones, pero habilitadas mediante los perfiles Sandbox Admin, Developer y Treasury tester, según la descripción de cada uno.

Segregación de funciones en pagos

Los perfiles Treasury submitter y Treasury approver son independientes a propósito. Aunque el sistema permite que una misma persona tenga ambos, se recomienda no combinarlos en producción. Mantenerlos separados garantiza el control de "cuatro ojos" que exige cualquier auditoría seria y reduce el riesgo operativo.

Aunque una persona tenga ambos perfiles, por defecto su aprobación no cuenta en las órdenes que ella misma creó y esas órdenes no aparecen en su bandeja de aprobación. Esto cambia solo si tu empresa tiene habilitada la autoaprobación. El detalle está en Cómo se aprueba una orden.

En integraciones vía API, el creador efectivo de las órdenes es el sistema del cliente. El aprobador es el control humano que autoriza lo que llega al dashboard.

Recomendaciones de asignación

• Mínimo privilegio: asigna únicamente los perfiles estrictamente necesarios para la función de cada persona.
• Más de un administrador: mantén al menos dos personas con perfil Admin activas en la organización, para evitar quedar sin capacidad de gestionar al equipo si una se ausenta o pierde acceso.
• Admin no es un perfil operativo: aunque puede realizar todas las acciones de la organización, conviene reservarlo para la gestión del equipo. Para el día a día, combina perfiles específicos (por ejemplo, Treasury approver + Treasury viewer).
• Separa producción y pruebas: los perfiles de cada entorno son independientes. Un integrador técnico que trabaja en sandbox no necesita perfiles de producción, y viceversa.

Organizaciones con varias entidades

Si tu empresa opera con Shinkansen a través de varias entidades (por ejemplo, varias razones sociales o unidades de negocio), los perfiles son independientes por entidad. Una misma persona puede ser Admin en una entidad y únicamente Treasury viewer en otra.

En el dashboard hay un selector de entidad. Al cambiar, se recarga el contexto con los usuarios, órdenes y movimientos de la entidad seleccionada, aplicando los perfiles correspondientes.

Inicio de sesión y sincronización con el directorio corporativo

El dashboard se integra con los proveedores de identidad que tu organización ya utiliza, ofreciendo dos capacidades clave:

• Inicio de sesión único (SSO) con Microsoft Entra ID, Google Workspace, Okta y cualquier proveedor SAML u OIDC. Tus usuarios entran con sus credenciales corporativas y se respetan las políticas de tu empresa (MFA corporativo, restricciones por IP, duración de sesión).
• Sincronización automática del directorio para que las altas, bajas y cambios de grupo en tu directorio corporativo se reflejen automáticamente en el dashboard. Dar de baja a alguien en tu directorio revoca su acceso a Shinkansen sin intervención manual.

Cuando se utiliza sincronización automática, los grupos de tu directorio corporativo se mapean a los perfiles descritos en esta guía. El mapeo se acuerda durante el onboarding con el equipo de Shinkansen.

Preguntas frecuentes

¿Los perfiles son acumulables? Sí. Una persona puede tener varios perfiles en una misma entidad y obtiene la unión de los permisos.

¿Puedo crear perfiles personalizados? No. El catálogo de perfiles es fijo y está diseñado para cubrir los controles estándar del flujo de pagos. Si necesitas un corte de permisos que hoy no existe, contacta al equipo de Shinkansen para evaluarlo.

¿Qué pasa si un usuario pierde el dispositivo con el código 2FA? Contacta al equipo de soporte de Shinkansen para restablecer el segundo factor del usuario.

¿Puedo exigir 2FA obligatoria para todo el equipo? La activación es por usuario. No hace falta para entrar al dashboard, pero sí para realizar las operaciones sensibles descritas arriba, como aprobar, rechazar o cancelar órdenes de pago. Si tu organización necesita forzarla para todo el equipo, contáctanos.