01. DATOS GENERALES
Producto | TOTVS Backoffice | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Línea de producto: | Línea Protheus | |||||||||||||||||||
Segmento: | Backoffice | |||||||||||||||||||
Módulo: | SIGAGPE - Gestión de Personal. | |||||||||||||||||||
Función: |
| |||||||||||||||||||
País: | Colombia | |||||||||||||||||||
Ticket: | No aplica. | |||||||||||||||||||
Requisito/Story/Issue (informe el requisito vinculado): | DMINA-14596 |
02. SITUACIÓN/REQUISITO
El proceso de Nómina de Novedades está limitado a aplicarse el primer día de un periodo de pago en el mes.
Para que la empresa pueda generar de forma correcta el recibo de novedades, el usuario deberá aplicar todas las novedades del empleado una vez por mes sin importar el día.
Modificar la rutina de Volante de pago electrónico (GPEM884) para que identifique los empleados que contienen novedades dentro del mes y para ellos generar dos archivos XML, uno de Nómina ordinaria y otro de Novedades.
Para éste proceso las Nóminas (Ordinaria y Novedad) deberán informar los valores de devengados, deducciones y totales de forma proporcional como se indica en los siguientes puntos:
- Identificar los conceptos que podrán ser afectados en proporción cuando se generen Novedades.
- La Nómina ordinaria deberá obtener la parte proporcional de los valores calculados mediante el sueldo y el número de días transcurridos entre la fecha inicio del periodo mensual hasta la fecha de afectación de la novedad.
- La Nómina de Novedad deberá obtener la parte proporcional de los valores calculados mediante el sueldo y el número de días transcurridos entre el día después de la fecha de afectación de la novedad hasta el día 30 del mes (aun cuando el mes sea de 28 o 31 días).
- Las sumas de los valores totales generados en las Nóminas (Ordinaria y Novedad) deberán ser igual al total mensual percibido por el Empleado.
03. SOLUCIÓN
En la rutina Volante de pago electrónico (GPEM884) se realizan las siguientes modificaciones:
- Función GM884Proc().
- Se obtienen los campos Categoría de la Función (RA_CATFUNC) y Forma de Pago (RA_FORPAG) de la consulta a la tabla SRA-Empleados y en las funciones AsigValNov() y ObtFchNov() se asignan variables de referencia para obtener los valores que afectarán a la nómina (Fechas y Porcentaje proporcional)
- Se informan los valores de devengados, deducciones y totales calculados mediante el porcentaje proporcional calculado.
- Función GM884MovEm().
- Devengados
- Lo siguientes Conceptos se afectarán con el porcentaje proporcional en la Nómina ordinaria y de Novedades:
Redondeo, Anticipos, Apoyo Sost, Reintegro, Días Trabajados, Sueldo Trabajado, Vacaciones Comunes, Vacaciones compensadas, Horas Extra, Huelgas, Incapacidades, Licencias y Transporte. - Se valida que los siguientes Conceptos se informen sin afectación proporcional y solo en la Nómina de Novedades:
Auxilios, Bonificaciones, Comisión, Pago Terceros, Dotación, Teletrabajo, Bonificación Retiro, Indemnización, Cesantías, Compensaciones, Otros Conceptos, Bonos EPCTV y Primas.
- Lo siguientes Conceptos se afectarán con el porcentaje proporcional en la Nómina ordinaria y de Novedades:
- Deducciones
- Los siguientes Conceptos se afectarán con el porcentaje proporcional en la Nómina ordinaria y de Novedades:
Embargo Fiscal, Reintegro, Retención Fuente, Fondo Pensión, Fondo Seguridad Pensional, Salud, Sanción y Sindicatos. - Se valida que los siguientes Conceptos se informen sin afectación proporcional y solo en la Nómina de Novedades:
Anticipo, Pensión Voluntaria, AFC, Cooperativa, Deuda, Educación, Plan Complementario Salud, Libranzas, Otra deducción y Pago Tercero.
- Los siguientes Conceptos se afectarán con el porcentaje proporcional en la Nómina ordinaria y de Novedades:
- Devengados
- Función GM884HrsEx().
- Se valida la Fecha de referencia de la Hora Extra para verificar si se asignará a la Nómina ordinaria o de Novedades.
- Función GM884Ausen().
- Se validan las Fechas de referencia de las vacaciones (compensadas y en días no hábiles) para verificar si serán asignadas a la Nómina ordinaria o de Novedades.
- Se calculan las Vacaciones comunes obteniendo su parte proporcional mediante el valor total y el número de días transcurridos entre la Fecha Inicio y Fin del Periodo.
- Función GM884General().
- Se asigna las Fechas Inicio y Fin del Periodo de Nómina ordinaria o de Novedades.
- Función GM884Pago().
- Se asigna el valor de Forma de Pago (RA_FORPAG) al Método de Pago del Empleado.
- Se asigna el valor de Forma de Pago (RA_FORPAG) al Método de Pago del Empleado.
- Función GM884Deven().
- Se suman los devengos con afectación proporcional y se almacenan en la variable nDevengT que posteriormente será informada en la Nómina.
- Se suman los devengos con afectación proporcional y se almacenan en la variable nDevengT que posteriormente será informada en la Nómina.
- Función GM884Deduc().
- Se suman las deducciones con afectación proporcional y se almacenan en la variable nDeduccT que posteriormente será informada en la Nómina.
- Se suman las deducciones con afectación proporcional y se almacenan en la variable nDeduccT que posteriormente será informada en la Nómina.
- Función ExsNovedad().
- Obtiene las Novedades del Empleado en el mes y las ordena de mayor a menor tomando la fecha mayor como día de novedad, las Novedades con fechas anteriores las marca para no ser procesadas.
- Obtiene las Novedades del Empleado en el mes y las ordena de mayor a menor tomando la fecha mayor como día de novedad, las Novedades con fechas anteriores las marca para no ser procesadas.
- Función AsigValNov().
- Obtiene el Salario Diario, los Días trabajados, el Salario trabajado y la Fecha de inicio y Fin del Periodo de Nómina ordinaria y de Novedades.
- Obtiene el Salario Diario, los Días trabajados, el Salario trabajado y la Fecha de inicio y Fin del Periodo de Nómina ordinaria y de Novedades.
- Función ObtFchNov().
- Obtiene las Fechas Inicio y Fin de Periodo, adicional calcula y obtiene el porcentaje proporcional que será aplicado a los valores de la Nómina ordinaria y de Novedad.
- Obtiene las Fechas Inicio y Fin de Periodo, adicional calcula y obtiene el porcentaje proporcional que será aplicado a los valores de la Nómina ordinaria y de Novedad.
En la rutina GPEM884 se crean las siguientes funciones:
- La función GM884Incid() las incidencias se asignan a un array.
- La función ValTotVac() obtiene el total del salario pagado por Días Trabajados.
IMPORTANTE
Para ver el proceso de Novedades ir a la sección 02. EJEMPLO DE UTILIZACIÓN en el punto 9. Novedades del documento técnico mencionado en la sección 05. ASUNTOS RELACIONADOS del presente documento técnico.
- Realizar un respaldo del repositorio del ambiente (archivo .RPO).
- Aplicar el parche correspondiente a la issue DMINA-14596.
- Validar que las rutinas actualizadas en el repositorio, coincidan con las descritas en el encabezado del presente Documento Técnico, así como las fechas.
- Contar con la configuración mencionada en el Documento Técnico de la sección 05. ASUNTOS RELACIONADOS.
Al actualizar los campos Tipo de Cotizante (RA_TIPCOT), Subtipo Cotizante PILA (RA_SUBCOT), % Pensión Especial (RA_PORAFP), Tipo de Sueldo (RA_TIPOSAL) y Sueldo Base (RA_SALARIO) se genera una Novedad.
Concepto DIAN
Equivalencia en Protheus
Tipo de trabajador
Sub.Cotiz
RA_TIPCOT
Subtipo de trabajador
SubtipoCot
RA_SUBCOT
Alto riesgo en pensión
% PensiónEsp
RA_PORAFP
Salario integral
Tipo Sueldo
RA_TIPOSAL
Sueldo
Sueldo
RA_SALARIO
Importante
El usuario deberá aplicar todas las Novedades del empleado una vez por mes sin importar el día.
Contar con un Empleados que contengan la siguiente información en los campos :
Empleado A Campos Valor Sueldo
RA_SALARIO
1,300,000.00 Actualizar el salario del empleado A
Fecha modificación Sueldo:
06/09/2021 Empleado A Campos Valor Sueldo
RA_SALARIO
1,350,000.00 Fch Mod Suel RA_FECAUM 06/09/2021 - En la tabla Historial Valores Salariales (SR3), validar que exista el registro del cambio de salario (por ejemplo, el día 06/09/2021 para el empleado A ) y que el Valor modificado (R3_VALOR) y el Valor anterior (R3_ANTEAUM) sean los correctos.
- Si se asignan Novedades para los campos Sub.Cotiz (RA_TIPCOT), SubtipoCot (RA_SUBCOT), % PensiónEsp (RA_PORAFP) y Tipo Sueldo (RA_TIPOSAL) revisar la tabla Historial Datos Empleados (SR9), validar que existan por lo menos dos registros para cada campo. El primer registro indica el valor anterior a la novedad, el segundo registro indica el nuevo valor.
Contar con los Cálculos de los periodos del mes de la nómina para el Proceso, Procedimiento , Periodo del cual se realizará la generación del Volante de Pago Electrónico.
- Volante Electrónico Ordinario
- Ingresar al módulo Gestión de Personal (SIGAGPE).
- Ingresar a la rutina Volante de Pago Electrónico, ubicada en "Informes | Recibos | Volante Electrónico" (GPEM884).
- Informar los parámetros del proceso de acuerdo a lo indicado en las "Pre-condiciones".
- Informar al empleado A .
- Pregunta Tipo XML, definir "Ordinario".
- Pregunta Generar, definir "Transmisión".
- Confirmar el proceso y validar que en respuesta a la transmisión se obtiene el documento Soporte de Pago de Nómina Electrónica (XML y PDF)
- Validar que se hayan generado 4 archivos para el empleado A (Xml y Pdf ordinario y de novedad)
- Validar que se hayan generado 4 archivos para el empleado B (Xml y Pdf ordinario y de novedad)
- Validación de Archivos XML
Empleado A
Nómina Ordinaria
1.1 Revisar que el archivo informe los valores anteriores a la novedad, por ejemplo:Empleado A Campos Valor Sueldo
RA_SALARIO
1,300,000.00
1.2 Revisar que el periodo se informe asignando la fecha inicio del periodo mensual hasta la fecha de aplicación de la novedad (FechaLiquidacionInicio="2021-09-01" FechaLiquidacionFin="2021-09-06")
1.3 Revisar archivo en formato .PDF.Nómina de Novedad
2.1 Revisar que se incluya el elemento "Novedad" y que contenga el CUNE del documento antecesor (documento ordinario)
2.2 Revisar que el archivo informe los valores de la novedad.Empleado A Campos Valor
Sueldo RA_SALARIO 1,350,000.00
2.3 Revisar que el periodo se informe asignando un día después de la fecha de aplicación de la novedad hasta el día 30 del mes (FechaLiquidacionInicio="2021-09-07" FechaLiquidacionFin="2021-09-30")
2.4 Revisar archivo en formato .PDF.- Sumar los totales de devengados, deducciones y el valor neto de las nóminas generadas (ordinaria y novedad).
- Generar los recibos de pago del mes del empleado.
- Sumar los totales de devengados, deducciones y el valor neto de los recibos de pago del mes.
- Los totales obtenidos de las nóminas (ordinaria y novedad) deben ser iguales a los totales obtenidos de los recibos del mes.
04. INFORMACIÓN ADICIONAL
No Aplica.
El usuario deberá aplicar todas las novedades del empleado una vez por mes sin importar el día. Si se aplican varias novedades con diferente fecha en el mes, el sistema tomará la fecha mayor de aplicación y la utilizará como fecha de novedad; esto quiere decir que solo se tomaran las novedades pertenecientes a ésta fecha.¡IMPORTANTE!
05. ASUNTOS RELACIONADOS
Documento de Referencia:
DT Volante de pago electrónico (Documento Soporte de Pago de Nómina Electrónica) COL
- documento_tecnico
- totvs_backoffice
- linea_protheus
- backoffice
- sigagpe
- gestion_de_personal
- gpem884
- volante_electronico_pago_nomina
- wsnominacol
- wsnfecol
- gppdcol
- gptabcol
- gptabcrg
- dmina_14166
- nomina_colombia
- volante_ordinario
- volante_novedades
- novedades
- 12_1_17
- 12_1_27
- 12_1_33
- col
- base_conocimiento
- mercado_internacional
- nomina_electronica_colombia
- dmina_14596