Variables-Centro-de-Costo-y-Zona
Variables de centro de costo y zona
Introducción
Las variables de centro de costo y zona permiten utilizar dentro de una fórmula datos asociados al centro de costo, obra, zona, localidad AFIP o contexto de cálculo por centro de costo.
Estas variables son útiles cuando el cálculo depende de la obra o centro de costo que se está procesando, del valor de bolsillo correspondiente, de auxiliares asociados a la obra o de códigos de zona utilizados en distintos procesos.
Variables disponibles
| Variable | Tipo | Grupo | Descripción breve |
|---|---|---|---|
| @LIQCC | Lógico | Contexto CC | Indica si el cálculo se ejecuta en contexto de centro de costo u obra. |
| @CODCC | Texto | Contexto CC | Número del centro de costo activo. Vacío fuera de contexto CC. |
| @CODTURNO | Texto | Contexto CC | Código de turno laboral del centro de costo activo. "000" si no hay turno válido. |
| @VALORCC | Numérico | Valor de bolsillo | Valor de bolsillo del centro de costo o contexto actual. |
| @VALORBOLS | Numérico | Valor de bolsillo | Alias de @VALORCC. Devuelve el mismo valor. |
| @CODZONA | Texto | Zona AFIP | Código de zona AFIP global del empleado o contexto. |
| @CODZONACC | Texto | Zona AFIP | Código de zona AFIP del centro de costo activo. Equivale a @CODZONA fuera de contexto CC. |
| @CODZONACONV | Numérico | Zona de convenio | Código de zona regional de 04-glosario > Convenio |
| @CODLOCAFIP | Numérico | Localidad AFIP | Identificador interno de la localidad AFIP. |
| @AUXILIAR1CC–@AUXILIAR12CC | Numérico | Auxiliares CC | Valores auxiliares configurables del centro de costo u obra. |
| @VALORAUX1 | Numérico | Valores auxiliares | Primer valor auxiliar del historial de categoría/convenio. |
| @VALORAUX2 | Numérico | Valores auxiliares | Valores auxiliares | Segundo valor auxiliar del historial de |
| @VALORAUX3 | Numérico | Valores auxiliares | Tercer valor auxiliar del historial de categoría/convenio. |
Contexto de centro de costo
@LIQCC
Tipo de dato: Lógico
Descripción:
Indica si el cálculo se está ejecutando en contexto de centro de costo u obra. Devuelve verdadero cuando el concepto se evalúa dentro de una liquidación por centro de costo.
Origen:
Contexto de ejecución del proceso de liquidación.
Ejemplo de uso:
if(@LIQCC, @VALORCC, @VALORHORA)
Tip
Usá @LIQCC para condicionar fórmulas que deban comportarse distinto cuando se evalúan en contexto de centro de costo.
@CODCC
Tipo de dato: Texto
Descripción:
Devuelve el número del centro de costo activo.
Origen:
Centro de costo asociado al contexto de liquidación por obra o centro de costo.
Ejemplo de uso:
@CODCC
@CODTURNO
Tipo de dato: Texto
Descripción:
Devuelve el código del turno laboral asociado al centro de costo activo.
Origen:
Relación entre el empleado, el centro de costo y el período laboral correspondiente.
Ejemplo de uso:
@CODTURNO
Valores de bolsillo
@VALORCC
Tipo de dato: Numérico
Descripción:
Devuelve el valor de bolsillo aplicable al centro de costo o contexto actual.
Origen:
Valor asociado al centro de costo, historial de valores o contexto de liquidación correspondiente.
Ejemplo de uso:
@HORASNORMALES * @VALORCC
Consideraciones:
En contexto de centro de costo, toma el valor correspondiente al centro de costo activo.
Fuera de contexto de centro de costo, puede tomar el valor asociado al centro de costo con mayor cantidad de horas o un valor de referencia según la configuración disponible.
@VALORBOLS
Tipo de dato: Numérico
Descripción:
Devuelve el mismo valor que @VALORCC. Funciona como alias de la variable de valor de bolsillo del centro de costo.
Origen:
Mismo origen que @VALORCC.
Ejemplo de uso:
@HORASNORMALES * @VALORBOLS
Variables de zona y localidad
@CODZONA
Tipo de dato: Texto
Descripción:
Devuelve el código de zona AFIP global resuelto para el empleado o contexto de liquidación.
Origen:
Localidad AFIP asociada al contexto del empleado, obra con mayor cantidad de horas o configuración por defecto del sistema, según corresponda.
Ejemplo de uso:
@CODZONA
Consideraciones:
No depende necesariamente del centro de costo activo. Para obtener la zona AFIP del centro de costo activo, utilizar @CODZONACC.
@CODZONACC
Tipo de dato: Texto
Descripción:
Devuelve el código de zona AFIP correspondiente al centro de costo activo.
Origen:
Localidad AFIP asociada al centro de costo activo.
Ejemplo de uso:
@CODZONACC
Consideraciones:
Cuando la fórmula no se evalúa en contexto de centro de costo, devuelve el mismo valor que @CODZONA.
Es útil cuando se necesita diferenciar la zona AFIP general de la zona correspondiente al centro de costo que se está liquidando.
@CODZONACONV
Tipo de dato: Numérico
Descripción:
Devuelve el código de zona regional de convenio.
Origen:
Zona regional asociada al empleado, liquidación u obra según el contexto disponible.
Ejemplo de uso:
@CODZONACONV
Consideraciones:
No debe confundirse con @CODZONA ni con @CODZONACC. @CODZONACONV corresponde a zona regional de convenio, mientras que @CODZONA y @CODZONACC se relacionan con zona AFIP.
Si no existe una zona regional aplicable, puede devolver 0.
@CODLOCAFIP
Tipo de dato: Numérico
Descripción:
Devuelve el identificador interno de la localidad AFIP resuelta para el contexto de liquidación.
Origen:
Localidad AFIP asociada al empleado, obra o configuración por defecto del sistema, según corresponda.
Ejemplo de uso:
@CODLOCAFIP
Consideraciones:
No devuelve el código de zona AFIP visible, sino el identificador interno de la localidad AFIP.
Para obtener el código de zona AFIP, utilizar @CODZONA o @CODZONACC, según el contexto.
Valores auxiliares de convenio/categoría
@VALORAUX1
Tipo de dato: Numérico
Descripción:
Devuelve el primer valor auxiliar disponible del historial de valores asociado al empleado.
Origen:
Historial de valores de la categoría/convenio correspondiente al empleado, considerando la zona o configuración aplicable a la liquidación.
Ejemplo de uso:
@VALORAUX1
Consideraciones:
No debe confundirse con @AUXILIAR1CC.
@VALORAUX1 pertenece al historial de valores de categoría/convenio, mientras que @AUXILIAR1CC corresponde a auxiliares asociados a centro de costo u obra.
@VALORAUX2
Tipo de dato: Numérico
Descripción:
Devuelve el segundo valor auxiliar disponible del historial de valores asociado al empleado.
Origen:
Historial de valores de la categoría/convenio correspondiente al empleado, considerando la zona o configuración aplicable a la liquidación.
Ejemplo de uso:
@VALORAUX2
Consideraciones:
Debe interpretarse como un valor auxiliar contractual o de convenio, no como auxiliar de centro de costo.
@VALORAUX3
Tipo de dato: Numérico
Descripción:
Devuelve el tercer valor auxiliar disponible del historial de valores asociado al empleado.
Origen:
Historial de valores de la categoría/convenio correspondiente al empleado, considerando la zona o configuración aplicable a la liquidación.
Ejemplo de uso:
@VALORAUX3
Consideraciones:
Debe utilizarse únicamente cuando la fórmula requiera un valor auxiliar definido en el historial de valores correspondiente.
Si no existe un valor aplicable, puede devolver 0.
Auxiliares de centro de costo
@AUXILIAR1CC a @AUXILIAR12CC
Tipo de dato: Numérico
Descripción:
Devuelven valores auxiliares configurables asociados al centro de costo u obra. Permiten utilizar en fórmulas importes, cantidades o valores auxiliares definidos para el contexto de centro de costo.
Origen:
Auxiliares asociados a las horas, jornadas o configuración del centro de costo dentro de la liquidación.
Variables disponibles:
| Variable | Descripción |
|---|---|
| @AUXILIAR1CC | Auxiliar 1 del centro de costo. |
| @AUXILIAR2CC | Auxiliar 2 del centro de costo. |
| @AUXILIAR3CC | Auxiliar 3 del centro de costo. |
| @AUXILIAR4CC | Auxiliar 4 del centro de costo. |
| @AUXILIAR5CC | Auxiliar 5 del centro de costo. |
| @AUXILIAR6CC | Auxiliar 6 del centro de costo. |
| @AUXILIAR7CC | Auxiliar 7 del centro de costo. |
| @AUXILIAR8CC | Auxiliar 8 del centro de costo. |
| @AUXILIAR9CC | Auxiliar 9 del centro de costo. |
| @AUXILIAR10CC | Auxiliar 10 del centro de costo. |
| @AUXILIAR11CC | Auxiliar 11 del centro de costo. |
| @AUXILIAR12CC | Auxiliar 12 del centro de costo. |
Ejemplo de uso:
@AUXILIAR1CC * @VALORCC
Consideraciones:
Cuando existe un centro de costo activo, devuelven el valor auxiliar correspondiente a ese centro de costo.
Cuando no existe un centro de costo activo, pueden devolver la suma de los auxiliares de todas las obras o centros de costo del empleado dentro de la liquidación.
Diferencias importantes
@VALORCC, @VALORBOLS y @VALORHORA
| Variable | Qué representa |
|---|---|
| @VALORCC | Valor de bolsillo del centro de costo o contexto actual. |
| @VALORBOLS | Alias de @VALORCC. Devuelve el mismo valor. |
| @VALORHORA | Valor hora de liquidación. En liquidación general puede tomar el valor de convenio; en contexto CC puede tomar el valor de bolsillo. |
@CODZONA, @CODZONACC, @CODZONACONV y @CODLOCAFIP
| Variable | Qué representa |
|---|---|
| @CODZONA | Código de zona AFIP global del empleado o contexto. |
| @CODZONACC | Código de zona AFIP del centro de costo activo. |
| @CODZONACONV | Código de zona regional de convenio. |
| @CODLOCAFIP | Identificador interno de la localidad AFIP (no es un código de zona). |
@CODZONA y @CODZONACC están relacionadas con zona AFIP.
@CODZONACONV corresponde a zona regional de convenio.
@CODLOCAFIP no devuelve un código de zona, sino un identificador interno de localidad AFIP.
Estas variables no deben utilizarse como equivalentes.
@VALORAUX* y @AUXILIAR*CC
@VALORAUX1, @VALORAUX2 y @VALORAUX3 toman valores auxiliares del historial de categoría/convenio.
@AUXILIAR1CC a @AUXILIAR12CC toman auxiliares asociados al centro de costo u obra.
Aunque los nombres son parecidos, no representan el mismo origen de datos.
Variables relacionadas documentadas en otras páginas
Algunas variables tienen relación con centro de costo, obra o zona, pero se documentan en otras páginas porque su uso principal pertenece a otro contexto.
| Variable | Página recomendada | Motivo |
|---|---|---|
| @VALORHORA | 🟢Variables de horas y novedades | Representa el valor hora de liquidación. En contexto CC puede tomar el valor de bolsillo, pero no es exclusivamente una variable de centro de costo. |
| @TOTHACC | 🟢Variables de liquidación | Total remunerativo por centro de costo. |
| @TOTASCC | 🟢Variables de liquidación | Total de asignaciones familiares por centro de costo. |
| @TOTNRCC | 🟢Variables de liquidación | Total no remunerativo por centro de costo. |
| @TOTNRAOSCC | 🟢Variables de liquidación | Total no remunerativo que aporta a obra social por centro de costo. |
| @TOTAPCC | 🟢Variables de liquidación | Total de aportes patronales por centro de costo. |
| @TOTRECC | 🟢Variables de liquidación | Total de retenciones por centro de costo. |
| @HORASCONVERTIDASOBRA | 🟢Variables de horas y novedades | Horas convertidas por obra. |
| @HORASFISICASOBRA | 🟢Variables de horas y novedades | Horas físicas por obra. |
Esta separación permite mantener esta página enfocada en variables propias del centro de costo, obra, zona y localidad, sin duplicar variables de totales u horas ya documentadas en otras páginas.
Funciones relacionadas
Además de las variables documentadas en esta página, existen funciones que permiten trabajar con obras, zonas, auxiliares o valores asociados utilizando parámetros. Estas funciones requieren argumentos para devolver un resultado y no deben confundirse con variables.
| Función | Uso general |
|---|---|
| EVALFORMULAOBRA(...) | Evalúa una fórmula por obra o centro de costo. |
| EVALFORMULAZONA(...) | Evalúa una fórmula por zona. |
| VALORZONA(...) | Obtiene valores asociados a una zona. |
| VALORZONACONVENIO(...) | Obtiene valores de zona asociados al convenio. |
| VALORCONVENIOCC(...) | Obtiene valores de convenio asociados a centro de costo. |
| SUMAUXILIAR1(...) a SUMAUXILIAR12(...) | Suman auxiliares filtrando por parámetros. |
| VAROBRA(...) | Consulta valores asociados a obra. |
| DIASTRABOBRA(...) | Consulta días trabajados asociados a obra. |
Estas funciones se documentan en las páginas correspondientes dentro de la carpeta funciones.
Consideraciones
Las variables de centro de costo y zona deben interpretarse según el contexto de cálculo en que se evalúa la fórmula.
- Cuando existe un centro de costo activo, @CODCC, @CODTURNO, @VALORCC, @VALORBOLS, @CODZONACC y @AUXILIAR1CC–@AUXILIAR12CC toman valores asociados a ese centro de costo u obra.
- Cuando no existe un centro de costo activo, algunas variables devuelven valores por defecto, valores vacíos o acumulados generales, según el caso.
- @LIQCC permite identificar si la fórmula se está evaluando en contexto de centro de costo. Puede utilizarse en expresiones condicionales para adaptar el cálculo.
- @VALORCC y @VALORBOLS son equivalentes. No deben utilizarse esperando resultados distintos.
- @VALORHORA no es equivalente permanente a @VALORCC. En liquidación general puede tomar el valor de convenio, mientras que en contexto de centro de costo puede tomar el valor de bolsillo.
- Las variables de zona no representan todas el mismo dato: @CODZONA y @CODZONACC corresponden a zona AFIP; @CODZONACONV a zona regional de convenio; @CODLOCAFIP al identificador interno de localidad AFIP.
- Las variables auxiliares @AUXILIAR1CC–@AUXILIAR12CC dependen de la configuración y carga de auxiliares asociada al centro de costo u obra.
Las reglas generales de escritura de fórmulas se encuentran en 🟢02-operadores-y-sintaxis, y los tipos de valores utilizados se describen en 🟢01-tipos-de-dato.