Árvore de páginas

01. DATOS GENERALES


Producto

TOTVS Backoffice

Línea de producto: 

Línea Protheus

Segmento:

Backoffice

Módulo:SIGAGPE - Gestión de Personal.
Función:

   

Rutina(s)

Nombre Técnico

Fecha

GPPDCOL.PRX

Conceptos estándar19/01/2022
GPEM884.PRWVolante de pago electrónico20/01/2022

   

Rutina(s) Relacionada(s)Nombre Técnico
WSNOMINACOL.PRWCliente de servicio web de nómina
WSNFECOL.PRWCliente de servicio web de facturación
GPTABCRG.PRWPRX's de Carga de Mantenimiento de Tablas Estándar de Nómina
GPTABCOL.PRXPRX's de Carga de Definición de Tablas Estándar de Nómina

   

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:

  1.  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.
  2. Función GM884MovEm().
    1. Devengados
      1. 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.
      2. Se valida que los siguientes Conceptos se informen sin afectación proporcional y solo en la Nómina de Novedades:
        AuxiliosBonificaciones, Comisión, Pago TercerosDotación, Teletrabajo, Bonificación Retiro, Indemnización, Cesantías, Compensaciones, Otros Conceptos, Bonos EPCTV y Primas.
    2. Deducciones
      1. 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.
      2. 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.
  1. Función GM884HrsEx().
    1. Se valida la Fecha de referencia de la Hora Extra para verificar si se asignará a la Nómina ordinaria o de Novedades.
  1. Función GM884Ausen().
    1. 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.
    2. 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.
  1. Función GM884General().
    1. Se asigna las Fechas Inicio y Fin del Periodo de Nómina ordinaria o de Novedades.
  1. Función GM884Pago().
    1. Se asigna el valor de Forma de Pago (RA_FORPAG) al Método de Pago del Empleado.

  2. Función GM884Deven().
    1. Se suman los devengos con afectación proporcional y se almacenan en la variable nDevengT que posteriormente será informada en la Nómina.

  3. Función GM884Deduc().
    1. Se suman las deducciones con afectación proporcional y se almacenan en la variable nDeduccT que posteriormente será informada en la Nómina.

  4. Función ExsNovedad().
    1. 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.

  5. Función AsigValNov().
    1. 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.

  6. Función ObtFchNov().
    1. 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:

  1. La función GM884Incid() las incidencias se asignan a un array.

  2. 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.

  1. Realizar un respaldo del repositorio del ambiente (archivo .RPO).
  2. Aplicar el parche correspondiente a la issue DMINA-14596.
  3. Validar que las rutinas actualizadas en el repositorio, coincidan con las descritas en el encabezado del presente Documento Técnico, así como las fechas.
  4. Contar con la configuración mencionada en el Documento Técnico de la sección 05. ASUNTOS RELACIONADOS.
  5. 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.

  6. Contar con un Empleados que contengan la siguiente información en los campos :

    Empleado A       CamposValor 

    Sueldo

    RA_SALARIO

    1,300,000.00
  7. Actualizar el salario del empleado A 

    Fecha modificación Sueldo: 

    06/09/2021
    Empleado A       CamposValor 

    Sueldo

    RA_SALARIO

    1,350,000.00
    Fch Mod SuelRA_FECAUM06/09/2021
  8. 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.
  9. 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.
  10. Contar con los Cálculos de los periodos del mes de la nómina para el ProcesoProcedimiento , Periodo del cual se realizará la generación del Volante de Pago Electrónico.

  • Volante Electrónico Ordinario
    1. Ingresar al módulo Gestión de Personal (SIGAGPE).
    2. Ingresar a la rutina Volante de Pago Electrónico, ubicada en "Informes | Recibos | Volante Electrónico" (GPEM884).
    3. Informar los parámetros del proceso de acuerdo a lo indicado en las "Pre-condiciones".
    4. Informar al empleado A .
    5. Pregunta Tipo XML, definir "Ordinario".
    6. Pregunta Generar, definir "Transmisión".
    7. 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) 
    8. Validar que se hayan generado 4 archivos para el empleado A (Xml y Pdf ordinario y de novedad)
    9. 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

    1. Nómina Ordinaria

      1.1 Revisar que el archivo informe los valores anteriores a la novedad, por ejemplo:

      Empleado A          CamposValor 

      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.


    2. 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

      SueldoRA_SALARIO1,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.

    3. Sumar los totales de devengados, deducciones y el valor neto de las nóminas generadas (ordinaria y novedad).
    4. Generar los recibos de pago del mes del empleado.
    5. Sumar los totales de devengados, deducciones y el valor neto de los recibos de pago del mes.
    6. 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.


¡IMPORTANTE!

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.

05. ASUNTOS RELACIONADOS

Documento de Referencia:

DT Volante de pago electrónico (Documento Soporte de Pago de Nómina Electrónica) COL