Índice

01. Operadores

A continuación se listan los Operadores utilizados en la formulación de los países de Mercado Internacional (MI).

En caso de contar con formulación estándar nativa; solo debe ingresar a la rutina Mnemónicos (GPEA300), de manera que el sistema realice la actualización automática de los Mnemónicos.

Si tiene personalizaciones en la formulación, como lo son Mnemónicos de usuario; realizar los siguientes pasos.

  1. Generar archivos Excel para validación:

    • Ejecutar la rutina “Consultas | Archivos | Genéricos” y Exportar a Excel la información (Opción Exp. CSV”), de las tablas RCA.

    • Guardar los archivos de Excel generados (antes del cambio).

  2. Respaldar las siguientes tablas:
    • Abrir las tablas RCA.
    • Respaldar Mnemónicos (RCA):
      • Respaldar la tabla RCA.
      • Borrar los registros de la tabla RCA.
  3. Carga de Formulación Estándar:
    • Ingresar a la rutina de Mnemónicos, ubicada en "Actualizaciones | Definic. Cálculo | Mnemónicos" (GPEA300); para que se carguen los mnemónicos estándar.
  4. Regresar el respaldo de las tablas del punto 2.
    • Abrir la tabla RCA.
  5. Generar archivos Excel para validación:
    • Ejecutar la rutina “Consultas | Archivos | Genéricos”  y Exportar a Excel la información (Opción Exp. CSV”), de la tabla RCA.
    • Guardar los archivos de Excel generados (después del cambio).
    • Comparar los archivos Excel generados en el Punto 1 contra los generados en el Punto 5, para determinar las diferencias de configuración de los datos.
      • Mnemónicos (RCA)
        • Comparar los archivos antes y después del cambio, para determinar las diferencias.
        • Entrar en la rutina ubicada en "Actualizaciones | Definic. Cálculo | Mnemónicos "; para incluir los mnemónicos del cliente.

Lista de Operadores

OPERADORES

Cod. Mnemon.

Descr. Mnem.

Tipo Mnemon.

Contenido

Tabla

Campo

Proceso

Descripción

Localización

SUMA_GAN_ACUObtiene el valor acumulado del mes (lee concepto de RT3)P - Operador



Obtiene el valor de acumulados del mes de ganancias de la tabla RT3 - Acumulados IAG, a partir del mes indicado en Fch. In. Ganan. (RCH_FCHGAN).ARG
LEE_TRAYRetorna los Reg. de la Trayectoria Laboral de un intervalo de fechP - Operador



Indica el inicio de un ciclo para obtiene los registros existentes en trayectoria laboral del empleado.MEX, COL y PER
SIG_TRAYLee el siguiente registro de la Trayectoria laboral.P - Operador



Se utiliza para realizar el salto de registro en los registros obtenidos por el operador LEE_TRAY.MEX, COL y PER
PRIMER_REG_TRAYLee el primer registro de la Trayectoria Laboral.P - Operador



Se coloca en el primer registro de trayectoria laboral dentro del rango de información obtenida por el operador LEE_TRAY.MEX, COL y PER
ULTIMO_REG_TRAYLee el último registro de la Trayectoria Laboral.P - Operador



Se coloca en el ultimo registro de trayectoria laboral dentro del rango de información obtenida por el operador LEE_TRAY.MEX, COL y PER
SUMA_MOVLIPermite por medio de la fórmula, el cálculo (adición/sustracción) de los valores de los conceptos ya calculados en los Movimientos Mensuales (tabla SRC).P - Operador



Puede sumarse mnemónico de la tabla SRV (tipo F - Archivo), BASE_PENSIÓN, constante que contenga conceptos.
FILTRO_MOVLI

Este operador filtra los movimientos de los conceptos que cumplen con cierto criterio de selección, determinado por un campo de la tabla de Conceptos (SRV).

P - Operador



Funciona en conjunto con el mnemónico reservado TP_SUMA_MOVLI al cual se le asigna”H” ó “D” para la lectura de las Unidades y “V” para Importe; si este no es definido se leen importes.
FILTRO_ACUM

El operador efectúa un filtro de Acumulados (RG7), a partir de un campo de la tabla de Conceptos (SRV).

Este operador funciona en conjunto con los operadores siguientes:

  • SUMA_UNIDADES
  • SUMA_IMPORTES
  • UNIDADES_EMPRESA
  • IMPORTE_EMPRESA
  • UNIDADES_TOTAL
  • IMPORTE_TOTAL
P - Operador



Si la condición del filtro usado en FILTRO_ACUM no existe, el retorno del operador es Cero, ya que se utiliza para limpiar cualquier valor anterior del mismo operador.

En una misma fórmula puede usar varias veces el operador FILTRO_ACUM y se requiere que este sea inicializado (dejando en blanco las columnas de OPERANDO) o de lo contrario considerara una condición ‘AND’ entre ambos filtros.



SUMA_IMPORTES | SUMA_UNIDADES

A través de este operador se obtienen los acumulados en un rango de meses, en unidades e importe del empleado/concepto/proceso del empleado.

P - Operador



En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO).

En caso que los mnemónicos ANO_INI_ACU y ANO_FIN_ACU no fueron informado, se toma el Año de la tabla de Periodos. (RCH.RCH_ANO).

Si ANO_INI_ACU es diferente que ANO_FIN_ACU, Mes inicio puede ser mayor que Mes fin.


UNIDADES_EMPRESA | IMPORTES_EMPRESA

A través de este operador se obtienen los acumulados en un rango de meses, en unidades e importe del empleado/concepto/procesos del empleado pertenecientes a la empresa a la cual está asignado el Proceso calculado.

P - Operador



Idem anterior.


UNIDADES_TOTAL | IMPORTES_TOTAL

A través de este operador se obtienen los acumulados en un rango de meses, en unidades e importe del empleado/concepto/procesos del empleado pertenecientes a la empresa a la cual está asignado el Proceso calculado y de todas las sucursales.

P - Operador



Idem anterior.


*Los operadores que no cuentan con información en la columna Localización se encuentran funcionales para todos los países.

02. Uso de Operadores

SUMA_GAN_ACU

Ejemplo:

Secuencia1a ExpresiónOperador2da ExpresiónResultado
000001#TRACE_ON

000002
MUEVE"2024"ANO_INI_ACU
000003
MUEVE"2024"ANO_FIN_ACU
000004
SUMA_GAN_ACU
UNIDADES
000005FINALETIQUETA

000006#TRACE_OFF

  • Se debe definir antes el rango mediante los mnemónicos ANO_INI_ACU y ANO_FIN_ACU, los cuales son necesarios para posicionarse sobre la tabla RT3 - Acumulados IAG.
  • El operador retornará en formato numérico el valor acumulado en la columna Resultado, en la cual se podrá utilizar variables auxiliares como por ejemplo NAUX_**, Mnemónicos transferibles, UNIDADES.
  • El mes de búsqueda de acumulados, se tomará del campo Fch. In. Ganan (RCH_FCHGAN) del periodo seleccionado.

LEE_TRAY / SIG_TRAY

Ejemplo:

Secuencia1a ExpresiónOperador2da ExpresiónResultado
000001#TRACE_ON

000002PERFECINILEE_TRAYPERFECFIN"01"
000003
MUEVEDIAS_TRAY_SIGNAUX_01
000004
SIG_TRAYGEN_MOV
000005
MUEVENAUX_01UNIDADES
000006FINALETIQUETA

000007#TRACE_OFF

   

LEE_TRAY

  • La 1a Expresión y 2da Expresión del operador LEE_TRAY indican la fecha inicial y final en las cuales se desea consultar la trayectoria laboral:
    • Si se indica alguna de las expresiones, deberá ser en formato dd/mm/yyyy.
    • Si no se indican la 1ra Expresión, se tomara la fecha de inicio del periodo que se esta procesando.
    • Si no se indican la 2da Expresión, se tomara la fecha de fin del periodo que se esta procesando.
  • En el uso del operador LEE_TRAY, en la columna Resultado se deberá indicar el tipo de movimiento a consultar:
    • Si se requiere consultar más de un tipo de movimiento se deberán colocar separados por "," (coma), ejemplo: "01,09"
    • Si no se indica un tipo de movimiento (Resultado vacío) se obtendrán todos los tipos de movimientos, también se puede indicar con '*'.
    • Los códigos a informar, corresponden a los valores del campo RCP_TPMOV. En algunas localizaciones dichos códigos, se encuentran definidos en la opciones del campo o en una Tabla Alfanumérica.
  • El orden de los registros obtenidos será en base a la fecha de movimiento en forma descendente.
  • Podrá acceder a cualquier campo de la tabla de trayectoria por medio de mnemónicos de tipo archivo.
  • En el caso de que no haya ningún registro en ese rango de fechas cargará el último movimiento “no importando su tipo de movimiento”.
  • Si el empleado no tuviera ningún registro en trayectoria laboral, el flujo de la formula saltará hasta la siguiente instrucción SIG_TRAY.
  • Se cuenta con el mnemónico reservado DIAS_TRAY_SIG que contiene los días de efectividad del movimiento que se esta procesando; en resultado se podrá utilizar en variables auxiliares como por ejemplo NAUX_**, Mnemónicos transferibles, UNIDADES.


SIG_TRAY

  • Se cuenta con el mnemónico reservado GEN_MOV, si se informa en la 2da Expresión del operador SIG_TRAY antes de traer el siguiente registro inserta un registro en movimientos de nómina con lo que tenga en los mnemónicos reservados UNIDADES e IMPORTE y los inicializa en ceros. Si no se le indica que genere un movimiento no se inicializa en ceros UNIDADES e IMPORTE y solo generará un movimiento, si al terminar el ciclo trae algo UNIDADES e IMPORTE.
  • Al encontrar este operador si existen más registros en trayectoria laboral, saltará al renglón inmediato inferior de LEE_TRAY y volverá a ejecutar la formula hasta que no haya más registros.

SUMA_MOVLI / FILTRO_MOVLI / FILTRO_ACUM


SecuenciaOperando 1OperadorOperando 2ResultadoObservación
000001 #TRACE_ON


000002NOCALCULASI_IGUAL1FINAL
000003# PRUEBA SUMA_MOVLI



000004
MUEVE'1'CAUX_00Mueve '1' a la variable carácter CAUX_00
000005
MUEVE'V'TP_SUMA_MOVLIAsigna en el operador TP_SUMA_MOVLI valores ('V') que seran tomados para el operador SUMA_MOVLI y FILTRO_MOVLI
000006CAUX_00FILTRO_MOVLICBSECOMPL
La variable carácter se utiliza de filtro para el campo CBSECOMPL, en este caso con el valor '1' anteriormente asignado
000007
SUMA_MOVLI
NAUX_01Sumariza en el operador SUMA_MOVLI, de forma combinada con el operador anterior (FILTRO_MOVLI) y guarda el resultado en la variable numéricoa NAUX_01
000008
MUEVE'H'TP_SUMA_MOVLIAsigna en el operador TP_SUMA_MOVLI unidades ('H') que seran tomados para el operador SUMA_MOVLI y FILTRO_MOVLI
000009'1'FILTRO_MOVLICBSECOMPL
El valor fijo '1' se utiliza de filtro para el campo CBSECOMPL, para comprobar que continúa funcionando también de esa forma, en el operador FILTRO_MOVLI
000010
SUMA_MOVLI
NAUX_02Sumariza en el operador SUMA_MOVLI, de forma combinada con el operador anterior (FILTRO_MOVLI) y guarda el resultado en la variable numéricoa NAUX_02
000011CAUX_00SUMA_MOVLICBSECOMPLNAUX_03Se puede utilizar de esta forma directamente SUMA_MOVLI con el filtro en el mismo operador, tanto con valor fijo (el cual se guarda en la variable NAUX_04) como con un mnemónico o variable (el cual se guarda en la variable NAUX_03)
000012'1'SUMA_MOVLICBSECOMPLNAUX_04
000013# PRUEBA FILTRO_ACUM



000014
ANOPERFECINIANO_INI_ACUSe inicializa el periodo de acumulación inicial y final para el operador FILTRO_ACUM, con las fechas inicial (mnemónico PERFECINI) y final del periodo de liquidación (mnemónico PERFECFIN)
000015
ANOPERFECFINANO_FIN_ACU
000016
MUEVE'1'CAUX_01Mueve '1' a la variable carácter CAUX_01
000017
MUEVE'12'CAUX_02Mueve '12' a la variable carácter CAUX_02
000018
FILTRO_ACUM

Se coloca el operador FILTRO_ACUM sin parámetros para limpiar cualquier acumulado anterior, dentro de la misma fórmula
000019'1'FILTRO_ACUMCBSECOMPL
El valor fijo '1' se utiliza de filtro para el campo CBSECOMPL, para comprobar que continúa funcionando también de esa forma, en el operador FILTRO_ACUM
000020CAUX_01SUMA_IMPORTESCAUX_02NAUX_05Acumula los importes con el operador SUMA_IMPORTES, desde el mes 1 al 12, combinado con las condiciones anteriores indicadas desde la línea 14
000021
FILTRO_ACUM

Se coloca el operador FILTRO_ACUM sin parámetros para limpiar cualquier acumulado anterior, dentro de la misma fórmula
000022CAUX_01FILTRO_ACUMCBSECOMPL
La variable carácter CAUX_01 que contiene el valor '1' se utiliza de filtro para el campo CBSECOMPL, en el operador FILTRO_ACUM
000023CAUX_01SUMA_UNIDADESCAUX_02NAUX_06Acumula los unidades con el operador SUMA_UNIDADES, desde el mes 1 al 12, combinado con las condiciones anteriores indicadas desde la línea 14
000024NAUX_05SUMANAUX_06NAUX_06
000025
MUEVENAUX_03UNIDADES
000026
MUEVENAUX_06IMPORTE
000027FINALETIQUETA


000028#TRACE_OFF


Operando1

Operador

Operando2

Resultado

valor fijo tipo caracter (entre comillas)

mnemónico de tabla SRV (Conceptos)

SUMA_MOVLI

mnemónico de tabla SRV (Conceptos)

BASE_PENSIÓN

Constante que contenga conceptos

N

Permite por medio de la fórmula, el cálculo (adición/sustracción) de los valores de los conceptos ya calculados en los Movimientos Mensuales (tabla SRC), de acuerdo con la lista de conceptos seleccionada. También permite el cálculo para beneficiarios de acuerdo con la definición del operando BASE_PENSION.

1. El posicionamiento para la tabla de beneficiarios debe realizarse en conjunto con el operador SUMA_MOVLI y el Mnemónico reservado BASE_PENSION, identificado en la segunda expresión de la fórmula utilizada. Utiliza el campo “RM_LEEBEN” en la tabla RCM, que identifica los Conceptos por Proceso.

Operando1

Operador

Operando2

Resultado


SUMA_MOVLI

BASE_PENSION                

NAUX_01

2. También es posible utilizar el operador SUMA_MOVLI con un Mnemónico que identifique un campo de la tabla SRV (Conceptos), que tengan el valor en contenido en la variable alfanumérica CAUX_01, se sumarizan en la variable de resultado:

Operando1

Operador

Operando2

Resultado


MUEVE

'1'

CAUX_01

CAUX_01

SUMA_MOVLI

Mnemónico de tabla SRV

NAUX_01

3. También es posible utilizar el operador SUMA_MOVLI con un Mnemónico que identifique un campo de la tabla SRV (Conceptos), que tengan el valor en '1 - Si', se sumarizan en la variable de resultado:

Operando1

Operador

Operando2

Resultado

'1'

SUMA_MOVLI

Mnemónico de tabla SRV

NAUX_01

4. Otra posibilidad es utilizar directamente valores en la expresión de la fórmula, los cuales deben ser los códigos de los conceptos registrados en la tabla “SRV”, en el campo Código (“RV_COD”).

Operando1

Operador

Operando2

Resultado


SUMA_MOVLI

‘001,002,003’

NAUX_01

Suma los importes de los conceptos calculados hasta el momento de acuerdo a la lista de conceptos seleccionados. Respeta el tipo de concepto, es decir si es Percepción o Base Percepción se suma y si es Deducción o Base Deducción se resta.

Operando1

Operador

Operando2

Resultado

valor fijo tipo caracter (entre comillas)

mnemónico de tabla SRV (Conceptos)

FILTRO_MOVLI

mnemónico de tabla SRV (Conceptos)

N

Operando1

Operador

Operando2

Resultado


MUEVE

‘H’TP_SUMA_MOVLI

C (filtro de selección)

FILTRO_MOVLI

Mnemónico de Conceptos (SRV)
C (filtro de selección)

FILTRO_MOVLI

Mnemónico de Conceptos (SRV)

SUMA_MOVLI


N


MUEVE“H”TP_SUMA_MOVLI
“S”SUMA_MOVLIBSECCSSUNIDADES
 MUEVE“V”TP_SUMA_MOVLI
“1”FILTRO_MOVLIBSEISR 
“S”FILTRO_MOVLIBSECCSS

SUMA_MOVLI
IMPORTE

Operando1

Operador

Operando2

Resultado


FILTRO_ACUM



C (filtro de selección)

FILTRO_ACUM

Mnemónico de Conceptos (SRV)


PERMESPER

SUMA_IMPORTES

PERMESPER




FILTRO_ACUM



‘S’

FILTRO_ACUM

BSECSS


PERMESPER

SUMA_IMPORTES

PERMESPER

IMPORTE

   

03. Actualizaciones

A continuación se listan los Documentos Técnicos, que describen las actualizaciones/modificaciones realizadas a los Operadores:

04. Asuntos Relacionados

Documento de Referencia de la Localización de Argentina:
DT Localización Argentina (SIGAGPE) - Protheus 12

Documento de Referencia de la Localización de Colombia:

DT Localización Colombia (SIGAGPE) - Protheus 12