Configuración de Legislaciones en el Admin
1. Qué es y para qué existe
Es la configuración de nivel maestro que define el alcance legal del Tenant. Actúa como un filtro global de identidadque habilita los motores de cálculo, estructuras de contratos y reportes regulatorios específicos para cada país en el que el cliente opera.
2. Cuándo usarlo / cuándo no
- Cuándo usarlo: Durante el onboarding de un nuevo cliente o cuando un cliente existente expande sus operaciones a un nuevo país.
- Cuándo NO usarlo: No debe usarse para "limpiar" la vista de un usuario. Si existen datos históricos, la desactivación debe ser una acción excepcional y coordinada.
3. Tipo de acción y nivel de riesgo
- Tipo de acción: Configuración base / Acción masiva (afecta a todos los usuarios del Tenant).
- Nivel de riesgo: Crítico. Aunque no elimina datos, invalida la operación del módulo de Nómina y Contratos para el mercado desmarcado.
4. Impacto y dependencias entre módulos
La selección de una legislación activa una cascada de dependencias:
- Módulo de Contratos: Habilita campos específicos (ej. RUT en CL, RFC en MX, DNI en PE).
- Módulo de Nómina: Activa el motor de cálculo (fórmulas legales) y el selector de periodos.
- Reportería: Disponibiliza los archivos para entes gubernamentales de ese país.
- UI/UX: Habilita el selector de país ("flags") en el header de la plataforma.
5. Estados del sistema involucrados
- Activo (Marcado): Toda la data es visible y los procesos de cálculo están disponibles.
- Inactivo (Desmarcado): La data existe en DB pero entra en un estado de ocultamiento (shadowing). El selector de país desaparece del frontend.
6. Procedimiento (Solo para Admin)
- Acceder al panel de configuración del Tenant.
- Localizar la sección "Payroll".
- En el campo "Legislaciones habilitadas para gestión de contratos", seleccionar o remover los países requeridos.
- Guardar cambios (la propagación es inmediata en el frontend).

7. Alertas críticas ⚠️
IMPORTANTE: Desmarcar una legislación no genera una advertencia de "Datos existentes" en el Admin. Si se desactiva un país con nóminas en curso, los administradores de ese cliente perderán acceso total a los periodos y contratos de forma instantánea.
8. Checklist antes / después
[ ] Antes: Verificar si el cliente tiene nóminas abiertas o contratos activos en el país a desactivar.
[ ] Antes: Confirmar si el cambio es por error de configuración inicial o por cese de operaciones.
[ ] Después: Validar que el selector de "banderas" en el ambiente del cliente refleje solo los países deseados.
9. Errores comunes
- Confusión de "Global": Marcar solo "Global" pensando que incluye a todos, cuando "Global" suele ser para Contratos Globales o pre-nómina, sin legislación específica.
- Desactivación por error: Remover un país para "probar" y causar reportes de soporte por "pérdida de información" (la cual solo está oculta).
10. FAQ de Producto
- ¿Si desmarco un país se borran los contratos? No, la data permanece en la base de datos, pero el sistema bloquea su renderización y acceso.
- ¿Puedo re-activarlo? Sí, al marcarlo nuevamente, toda la información previa vuelve a ser visible exactamente como estaba.