Sucursales (multi-tenant)

DueñoSolo Dueño con plan ENTERPRISE

Disponible solo en plan ENTERPRISE

Multi-sucursal es exclusivo del plan ENTERPRISE ($299.900 COP/mes). Una suscripción cubre todas las sucursales que crees — sin pagar otra.

Qué es una sucursal

Una sucursal es un negocio independiente (catálogo, equipo, POS, mesas, pedidos propios) pero administrativamente agrupado bajo un negocio principal. Pensado para:

• Cadenas hoteleras con varios locales
• Franquicias de restaurantes
• Cafés con multiples puntos de venta
• Distribuidoras con tiendas regionales

Cada sucursal opera de forma independiente:

• Productos, precios y categorías propios
• Equipo propio (distintos OWNERs/ADMINs/WORKERs)
• POS, caja, mesas y pedidos separados
• Su propia URL pública (nextapos.com/menu/sucursal-norte)

Pero comparten:

• Una sola suscripción ENTERPRISE — pagas una vez, todas tienen todo ilimitado
• Una vista agregada para ver métricas del conjunto

Vocabulario

• Principal (root): el negocio que paga la suscripción ENTERPRISE. Es el "padre" de las sucursales.
• Sucursal (branch): negocio creado bajo un principal. Hereda el plan automáticamente.
• Independiente: negocio sin sucursales y sin parent (cualquier plan).

Visualmente en el superadmin verás badges:

• Principal · N — tiene N sucursales bajo su paraguas
• Sucursal — con flecha al principal del que depende

Cómo crear una sucursal

1. Inicia sesión como OWNER de un negocio en plan ENTERPRISE.
2. En el sidebar verás un item Sucursales (icono ).
3. Click → llegas a la pantalla con:
   • 4 KPIs agregados de toda la familia (sucursales, miembros totales, pedidos del mes, revenue del mes)
   • Lista de todas las sucursales con sus métricas individuales
4. Click + Nueva sucursal
5. En el modal:
   • Nombre del local (ej. "Sucursal Norte", "Hotel Cartagena Centro")
   • URL pública (slug auto-generado desde el nombre, lo puedes editar)
6. Crear sucursal

La nueva sucursal:

• Aparece en tu lista inmediatamente
• Hereda el plan ENTERPRISE automáticamente — todas las funciones disponibles
• Empieza con catálogo y equipo vacíos
• Es accesible en nextapos.com/app/<slug>/dashboard

Cómo cambiar entre sucursales

Tienes 3 caminos según donde estés:

Desde el sidebar de cualquier sucursal

Si tienes membership en 2+ tenants (sucursales), en la parte superior del sidebar aparece un selector con todas. Eliges y saltas.

Desde el sidebar abajo → "Mis negocios"

Te lleva a /workspaces con todas tus opciones (incluido cualquier rol que tengas en otros tenants, no solo sucursales).

Desde la pantalla "Sucursales" (solo si eres OWNER del principal)

Click directo en cualquier card → vas al dashboard de esa sucursal.

Métricas agregadas

En la pantalla Sucursales (solo OWNER del principal), arriba ves 4 KPIs que suman todas las sucursales:

• Sucursales — total de locales (principal + branches)
• Miembros — suma de equipos de todas las sucursales
• Pedidos / mes — pedidos pagados del mes actual en toda la familia
• Revenue / mes — total facturado por ventas pagadas del mes en COP

Cada card de sucursal individual también muestra sus métricas del mes para comparar.

Roles y permisos

Acción	OWNER del principal	OWNER de sucursal	ADMIN	WORKER
Ver lista de sucursales	Sí	—	—	—
Crear nueva sucursal	Sí	—	—	—
Operar dentro de cada sucursal según su rol	Sí	Sí (solo en la suya)	Sí	Sí
Gestionar facturación de la cuenta ENTERPRISE	Sí	—	—	—
Ver historial de facturas de la cuenta	Sí	—	—	—

Cuando alguien entra a Configuración → Facturación de una sucursal:

• Ve el plan ENTERPRISE heredado
• Ve las cuotas (todas ilimitadas)
• El botón "Gestionar facturación" abre el portal Stripe del principal (donde vive la suscripción real)

Equipo entre sucursales

Cada sucursal tiene su propio equipo. Pero un mismo usuario puede ser miembro de varias sucursales con diferentes roles:

Eduardo Villa es OWNER del principal Hotel Gran Reserva, pero también es ADMIN en la sucursal Hotel Cartagena Centro.

Esto lo gestionas igual que cualquier tenant — desde la sección Equipo de cada sucursal, invitas usuarios por email. Si el usuario ya tiene cuenta Nexta (por estar en otro tenant), se le agrega automáticamente. Si no, recibe email de invitación para crear contraseña.

Qué pasa cuando…

…elimino una sucursal

Solo afecta esa branch. El principal y las demás sucursales no se tocan. Cuidado: se borran todos los productos, pedidos, equipo y datos de esa sucursal.

…cancelo la suscripción ENTERPRISE del principal

Las sucursales pierden el plan heredado al terminar el ciclo. Cada sucursal queda con su plan nominal (FREE por defecto). Las funciones ENTERPRISE dejan de estar disponibles en todas.

Si quieres mantener una sucursal operativa después de cancelar, conviértela en un negocio independiente: contacta soporte para "desvincular" del principal.

…bajo el plan de ENTERPRISE a PRO en el principal

Las sucursales heredan el nuevo plan PRO. Pierden funciones exclusivas de ENTERPRISE (multi-sucursal admin, API access).

…elimino el principal

Las sucursales pierden la relación (parentTenantId queda en null) y mantienen su plan nominal (ENTERPRISE que copiamos al crearlas). En la práctica siguen funcionando con todas las funciones, pero ya no hay un "principal" que las agrupe.

Limitaciones actuales

• Una sola jerarquía: una sucursal no puede tener sub-sucursales. Solo principal → sucursales (1 nivel).
• No hay transferencia de datos entre sucursales (productos, clientes, etc.). Si necesitas eso, contacta soporte.
• No hay reportes consolidados detallados todavía (solo los 4 KPIs agregados). Si necesitas dashboards profundos por sucursal, está en roadmap.

Próximo paso

• Pagos y facturación — gestión de la suscripción ENTERPRISE.
• Equipo — invitar miembros a una sucursal específica.
• Límites y funciones por plan — qué incluye ENTERPRISE.