Introducción
Modelo multi-tenant

Modelo multi-tenant

FinMova está construido sobre un modelo multi-tenant: cada empresa es un tenant independiente con sus propios datos, certificado, usuarios y reportes. Una misma cuenta de usuario puede pertenecer a uno o varios tenants.

Este capítulo explica qué significa eso para ti y por qué importa para escenarios comunes (grupo empresarial, contador externo).

En una frase

Tenant = empresa. Cuenta de usuario ≠ empresa. Un usuario puede tener acceso a varias empresas; cada empresa vive aislada de las demás.

Cómo se ven los datos

DatoÁmbito
Tu RNC, razón social, direcciónPor tenant
Tu certificado .p12 y secuencias NCFPor tenant
Tus clientes, productos, facturas, gastosPor tenant
Tu plan y facturaciónPor tenant
Tu email + contraseña de FinMovaPor usuario
Tu lista de tenants a los que pertenecesPor usuario

Cuando entras a FinMova, primero estás logueado como usuario; después seleccionas (o se elige automáticamente) el tenant sobre el que vas a trabajar.

Aislamiento técnico

Cada operación que haces lleva implícito el tenant_id del tenant activo. La base de datos usa Row-Level Security (RLS): aunque la consulta intentara leer datos de otro tenant, el motor los bloquea.

Importante. La regla aplica a todo: clientes, productos, facturas, pagos, reportes. Incluso un administrador interno de FinMova no puede ver datos de un tenant que no le corresponda.

Escenarios típicos

Contador externo con varios clientes

Un contador puede tener una sola cuenta de FinMova y ser miembro de N tenants (uno por cliente):

  • Al entrar, elige el tenant del cliente con el que va a trabajar.
  • Cada cliente es invisible para los demás.
  • El contador puede ser admin en algunos, accountant en otros.

Grupo empresarial con varias empresas

Si tu grupo tiene varias razones sociales con RNC distinto, cada una es un tenant separado:

  • Cada empresa tiene su propio certificado (la persona autorizada puede ser la misma o distinta).
  • Cada empresa lleva sus propios reportes 606/607/608.
  • Los reportes consolidados de grupo no son nativos hoy; se manejan exportando CSV y consolidando en Excel.

Una empresa, varios empleados

Caso más común. Un tenant, varios usuarios con roles distintos: dueño (owner), administrador (admin), contador (accountant), vendedor (sales), consultor que solo mira (viewer).

Detalle: Invitar usuarios y roles.

Crear un segundo tenant

Si necesitas administrar otra empresa desde tu misma cuenta:

  • En el selector de tenant (esquina superior del dashboard), elige Crear nueva empresa.
  • Pasas por el mismo flujo de onboarding (RNC + razón social).
  • A partir de ahí, el menú de FinMova actúa solo sobre ese tenant.

Cuidado. Cada tenant consume su propio plan y tiene su propia facturación. No es una opción gratis para "probar varias cosas a la vez".

Cambiar entre tenants

El selector de tenant está en la barra superior del dashboard. Cambias y todo el menú (clientes, productos, facturas) cambia con él inmediatamente, sin necesidad de cerrar sesión.

Limitaciones a saber

  • No hay merge de tenants. Si creaste dos por error con datos parecidos, hay que decidir cuál se queda y exportar/importar manualmente.
  • El cambio de tenant no cambia tu rol. En cada tenant tu rol es el que te asignaron.
  • La sesión activa es por usuario, no por tenant. Si cierras sesión en uno, sales de todos.

Quién decide los miembros de un tenant

El owner del tenant (típicamente quien lo creó). Ese rol no se puede quitar a uno mismo si es el único owner; primero debe nombrar a otro.

¿Y los datos personales del usuario?

Tu email y nombre de usuario los administras tú desde el perfil. No pertenecen a un tenant; son personales.

Siguientes pasos

Manifiesto de capturas

  • assets/onboarding/05-selector-tenant.png — selector de empresa en la barra superior con varias opciones.
  • assets/onboarding/06-crear-nuevo-tenant.png — flujo "Crear nueva empresa" desde el selector.
¿Te resultó útil este artículo?

Última actualización: