Selector de contratos en reportes bancarios (Global Payroll)
Descripción general
👥 [Todos los perfiles]
El Selector de contratos en reportes bancarios es una mejora funcional integrada dentro del módulo de Global Payroll. Permite delimitar de forma precisa el alcance de los reportes bancarios predefinidos y de los flujos de transferencias asociadas, permitiendo que el archivo bancario final se construya únicamente a partir de los contratos seleccionados de manera explícita. Su principal objetivo es flexibilizar los cierres de nómina, la gestión de reprocesos puntuales, bajas, suspensiones o pagos diferidos, evitando tener que recurrir a la creación de grupos de pago artificiales o modificaciones manuales en archivos externos a la plataforma.
Requisitos previos
⚙️ [Administrador] / 🔧 [Implementador]
Antes de utilizar o visualizar esta funcionalidad, deben cumplirse las siguientes condiciones:
- Habilitación del módulo:El cliente o tenant debe contar con el módulo de reportes bancarios predefinidospreviamente habilitado y activo en su plataforma.
- Ubicación geográfica (Legislaciones válidas): El sistema debe operar bajo alguna de las legislaciones vigentes que soportan reportes predefinidos: Chile (CL), México (MX), Perú (PE) o Colombia (CO).
- Permisos del Administrador/Usuario:Para ejecutar el flujo, es un requisito que el usuario cuente con los permisos de nómina habituales para acceder al período de nóminacorrespondiente y generar reportes bancarios en los flujos de transferencias.
- Visibilidad del Período: El usuario solo podrá interactuar con los contratos que formen parte de su alcance de visibilidad asignado (según empresa, grupo de nómina, segmento o legislación).
Funcionamiento
👥 [Todos los perfiles]
El funcionamiento del selector opera de la siguiente manera dentro del flujo de transferencias bancarias:
Guía de uso (usuario final)
Generar un reporte bancario por contratos
- Entra al período de nómina y abre Resúmenes y reportes → Transferencias bancarias → Reportes bancarios.
- Elige el reporte predefinido (layout/banco) que corresponda.
- En «Seleccione por», selecciona Contratos.
- El modal se amplía para mostrar la tabla de contratos del período con columnas como nombre, número de contrato, identificador/RUT, cargo, área y empresa.
- Busca o filtra contratos:
- Usa el buscador y el botón Filtrar (misma lógica que en la pestaña Contratos del período).
- Abre Filtros para reglas por columna (número de contrato, identificador, RUT, etc.).
- Para varios identificadores o contratos a la vez, agrega varias reglas «igual a» sobre la misma columna en el modal de filtros.
- Marca los checkboxes de las filas que deben entrar al archivo. La selección se mantiene al cambiar de página en la tabla (mismo comportamiento que en Contratos del período).
- Revisa el contador de contratos seleccionados.
- Completa el resto del formulario (fecha de pago, banco, formato y opciones de omisión que aplique tu país).
- Confirma Generar. El archivo incluirá solo las nóminas de los contratos marcados y elegibles para el reporte.
Consejos operativos
- Si necesitas validar quién entra, filtra primero por identificador o número de contrato y revisa nombre y empresa en la tabla antes de generar.
- Si cambias la selección de contratos, el listado de bancos puede actualizarse: vuelve a elegir banco si el anterior ya no aplica.
- Los contratos sin datos bancarios o con monto neto cero pueden quedar fuera del archivo o mostrar un mensaje de error según las reglas del layout; corrige la ficha del colaborador o exclúyelos de la selección.
- Para incluir todos los contratos de una empresa, sigue usando Empresas o Grupo de pago; no es obligatorio usar Contratos.
Configuración
⚙️ [Administrador]
La administración de este parámetro no añade paneles adicionales de configuración:
- Feature Flags / Parámetros:No existe un feature flag de activación por tenant. La alternativa se muestra de forma nativa e inmediata en todas las cuentas que ya posean reportes bancarios predefinidos en las legislaciones cubiertas.
- Opciones del Selector: El parámetro clave a vigilar en el modal es «Seleccione por». Si se opta por Empresas o Grupo de pago, el sistema retiene su comportamiento histórico. Al cambiar a Contratos, el alcance queda estrictamente definido por los contratos marcados.
- Tipos de pago permitidos: La selección por contratos está vinculada a los tipos de pago soportados por el modal del país, tales como nómina ordinaria, finiquito/liquidación, CTS (en el caso de Perú), beneficiarios, conceptos de nómina y nómina consolidada.
🔧 [Implementador]
Para los despliegues y adaptaciones por cliente, se deben tener en cuenta las siguientes directrices técnicas:
- Estructura en Bases de Datos / APIs:No se requiere ejecutar ninguna migración de datos para dar soporte a este cambio. La API de backend procesa una colección explícita de identificadores denominada contract_ids[].
- Alineación del Pipeline: Los flujos tradicionales (Legacy) y los flujos predefinidos de reportes bancarios operan bajo un mismo componente de alcance común (ContractScope) en el backend, garantizando que el archivo final no sufra discrepancias lógicas entre un canal y otro.
- Eficiencia de Implementación:Se reduce la necesidad de parametrizar o segmentar grupos de pago artificiales que antes se creaban únicamente con el fin de acotar la dispersión bancaria de un subconjunto de trabajadores.
Casos de uso frecuentes
🧑 [Usuario final]
- Pago de nómina para un subconjunto específico: El colaborador de nómina necesita emitir transferencias solo para un grupo selecto de empleados dentro de un período grande, seleccionándolos directamente desde la tabla mediante su RUT o identificador.
- Exclusión de colaboradores:Situaciones donde se requiera dejar fuera de la nómina bancaria actual a personas con bajas recientes, suspensiones laborales vigentes o cuyos pagos hayan sido diferidos por acuerdos internos.
- Generación de reprocesos puntuales:Cuando un banco rechaza un pago o se debe rectificar la dispersión de un grupo acotado de contratos confirmados, generando un archivo limpio sin alterar ni volver a pagar al resto de la empresa.
⚙️ [Administrador]
- Gestión de Cierres de Nómina Flexibles: El administrador utiliza el selector para generar archivos de dispersión parciales de manera rápida durante cierres complejos, asegurando que tesorería y operaciones obtengan layouts limpios y precisos.
Restricciones y consideraciones
👥 [Todos los perfiles]
- Sin Selección Masiva Completa:No se incluye un botón o checkbox en el encabezado de la tabla para «seleccionar todos» los elementos con un solo clic en esta versión; la selección es estrictamente por fila o acotando el universo mediante filtros de columna.
- Validación de Selección Vacía:Intentar procesar o hacer clic en generar con cero contratos seleccionados provocará un bloqueo inmediato en la interfaz con un mensaje de alerta.
- Restricción Exclusiva de Flujo: Esta tercera dimensión de alcance aplica única y exclusivamente para los flujos de transferencias y reportes bancarios predefinidos dentro del período. No tiene efecto ni se extiende a reportes como Previred, libros de remuneraciones u otros consolidados de nómina.
- Datos Críticos de Negocio:Los colaboradores seleccionados que posean un monto neto menor o igual a cero (neto ≤ 0) o que no registren una cuenta bancaria configurada en su ficha, podrían quedar fuera del archivo final o gatillar advertencias según las especificaciones del layout bancario del país.
- Sin Operaciones de Ficha:No está permitido dar de baja, crear o editar información contractual desde el modal de reportes bancarios.
Preguntas frecuentes (Q&A)
🧑 [Usuario final]
P: ¿El buscador del modal funciona de la misma forma que el de la pestaña principal de Contratos del período?
R: Sí. El buscador y las reglas de filtrado operan con la misma lógica que ya conoces en la pestaña de Contratos del período, permitiéndote buscar por columnas específicas, de forma global o añadir múltiples reglas "igual a" para ingresar varios identificadores simultáneamente.
P: ¿Puedo seleccionar contratos de distintas empresas y meterlos en un mismo archivo de reporte bancario?
R: Sí, siempre y cuando marques esos contratos en la tabla. No obstante, toma en cuenta que al hacerlo, el campo "Banco" se actualizará dinámicamente para mostrarte solo aquellas instituciones bancarias que sean válidas y compatibles para todas las empresas a las que pertenecen los contratos que seleccionaste.
⚙️ [Administrador]
P: ¿Se eliminaron o cambiaron los comportamientos de las opciones previas de filtrado por Empresa o Grupo de pago?
R: No. Las opciones anteriores de selección por "Empresas" y "Grupo de pago" siguen estando totalmente disponibles en el sistema y mantienen intacto su comportamiento original.
P: ¿Por qué cuando elijo la opción de "Contratos" ya no puedo ver el menú desplegable para seleccionar empresas?
R: Este es el comportamiento diseñado para el sistema. Al activar la opción por "Contratos", el alcance de la generación queda definido directamente por las filas individuales que marques en la tabla, por lo que el selector de empresas deja de ser necesario y se oculta automáticamente.
🔧 [Implementador]
P: ¿Se requiere ejecutar scripts de migración en las bases de datos de payroll-app o payroll-apipara implementar este cambio?
R: No. Esta mejora funcional no requiere ninguna clase de migración de datos ni de activaciones manuales específicas por cliente o tenant en el backend.
P: ¿Cómo procesa el backend la información de los contratos seleccionados en el modal?
R: El backend unifica el procesamiento de datos utilizando un componente común llamado ContractScopepara los pipelines tradicionales y predefinidos, y la API está orientada a recibir un arreglo explícito de identificadores bajo el parámetro contract_ids[].
Glosario de términos clave
👥 [Todos los perfiles]
- Reporte bancario predefinido:Archivo de transferencia estructurado bajo un formato o layout específico exigido por una institución financiera para procesar pagos masivos.
- contract_ids[]:Colección o lista técnica de identificadores únicos correspondientes a los contratos seleccionados por el usuario que se envía al servidor para acotar un proceso.
- ContractScope:Componente de software en el backend de Rankmi encargado de validar y unificar las reglas de alcance de contratos para la generación de reportes.
- Tenant:Instancia de software o entorno asignado a un cliente corporativo específico dentro de la plataforma SaaS de Rankmi.
- Layout bancario:Estructura técnica de datos (columnas, posiciones, caracteres) que requiere el archivo bancario según las normativas de cada entidad financiera y país.