API Colaboradores (legajo)

mriquelme
Fri, 24 Apr 2026 13:34:17 +0000
API

API Colaboradores

Este documento posee informacion tecnica sobre la API de Colaboradores y esta dirigido a clientes que busquen integrar altas, modificaciones, consultas y eliminaciones de legajos de colaboradores con otro sistema.

Indice

1. Detalle de la integracion

2. Autenticacion y token

3. API Colaboradores con Historial (Alta / Modificacion)

4. API Colaboradores sin Historial (Alta / Modificacion)

5. API Colaboradores con Historial (Consulta)

6. API Colaboradores sin Historial (Consulta)

7. API Colaboradores (Eliminacion)

1. Detalle de la integracion

La integracion permite gestionar legajos de colaboradores en dos modalidades:

Con historial completo de cambios laborales.

Sin historial (solo estado vigente actual).

Incluye operaciones de alta/modificacion (POST), consulta (GET) y eliminacion (DELETE).

2. Autenticacion y token

Todas las APIs requieren el parametro ACCESS_TOKEN en la URL.

El token se obtiene mediante la API Token y debe renovarse periodicamente segun la configuracion de vigencia del sistema.

Cuadro explicativo - Parametros de autenticacion

Parametro | Tipo | Requerido | Descripcion
ACCESS_TOKEN | UUID | Si | Token de acceso obtenido mediante la API de autenticacion.

Obtención de token

Antes de realizar cada solicitud, es necesario obtener un token de autenticación utilizando las credenciales de un usuario API configurado en el maestro de Usuarios.

Este token es requerido para autorizar el consumo de los servicios expuestos por la API de Finnegans.

3. API Colaboradores con Historial (Alta / Modificacion)

Endpoint

POST https://api.finneg.com/api/custom/legajo/conHistorial

Descripcion

Crea o actualiza el legajo completo de un colaborador incluyendo todos sus historiales laborales: remuneracion, alta/baja, puesto, convenio, obra social, sindicato, actividad laboral, tipo de siniestro, zona laboral, condicion laboral, regimen jubilatorio, regimen de contratacion y situacion laboral.

Cuadro explicativo - Parametros de Query (URL)

Parametro | Tipo | Requerido | Descripcion
ACCESS_TOKEN | UUID | Si | Token de acceso obtenido mediante la API de autenticacion.
origenIntegracion | String | No | Origen de la integracion (parametro opcional del endpoint).

Cuadro explicativo - Cuerpo de la solicitud (JSON Body)

Campo | Tipo | Requerido | Descripcion
PersonaCodigo | String | Si | Codigo unico de la persona en el sistema.
EmpresaCodigo | String | Si | Codigo de la empresa a la que pertenece el colaborador.
NumeroLegajo | String | Si | Numero de legajo del colaborador.
Email | String | No | Correo electronico del colaborador.
Apellido | String | Si | Apellido del colaborador.
Nombre | String | Si | Nombre del colaborador.
Activo | Integer | Si | Estado activo: 1 = Activo, 0 = Inactivo.
Descripcion | String | No | Descripcion adicional del colaborador.
IdentificacionTributariaCodigo | String | Si | Codigo del tipo de identificacion tributaria (ej: SINIDENTIFICACION, CUIT, DNI).
IdentificacionTributariaNumero | String | No | Numero de identificacion tributaria (CUIL/DNI).
Sexo | Integer | Si | Sexo: 1 = Masculino, 2 = Femenino.
FechaCumpleanos | Date (YYYY-MM-DD) | No | Fecha de nacimiento del colaborador.
EstadoCivil | Integer | No | Estado civil (segun tabla de referencia del sistema).
PaisNacionalidadCodigo | String | No | Codigo ISO del pais de nacionalidad (ej: ARG).
BancoCodigo | String | No | Codigo del banco para acreditacion de haberes.
BancoSucursal | String | No | Sucursal bancaria para acreditacion de haberes.
TipoCuentaBancaria | Integer | No | Tipo de cuenta bancaria: 1 = Caja de Ahorro, 2 = Cuenta Corriente.
NumeroCuentaBancaria | String | No | Numero de cuenta bancaria para haberes.
ClaveCuentaBancaria | String | No | CBU de la cuenta bancaria.
ExportadoInterbanking | Boolean | No | Indica si el pago se exporta por Interbanking.
CuentaAdicional | String | No | Datos de cuenta bancaria adicional.
BancoCodigoFDesempleo | String | No | Codigo del banco para Fondo de Desempleo.
BancoSucursalFDesempleo | String | No | Sucursal del banco para Fondo de Desempleo.
TipoCuentaBancariaFDesempleo | Integer | No | Tipo de cuenta bancaria para Fondo de Desempleo.
NumeroCuentaBancariaFDesempleo | String | No | Numero de cuenta para Fondo de Desempleo.
ClaveCuentaBancariaFDesempleo | String | No | CBU de la cuenta para Fondo de Desempleo.
ExportadoInterbankingFDesempleo | Boolean | No | Indica si el Fondo de Desempleo se exporta por Interbanking.
DireccionTipo | Integer | No | Tipo de direccion (segun tabla de referencia del sistema).
DireccionCalle | String | No | Nombre de la calle del domicilio.
DireccionNumero | String | No | Numero del domicilio.
DireccionPiso | String | No | Piso del domicilio.
DireccionDpto | String | No | Departamento del domicilio.
DireccionPais | String | No | Codigo del pais del domicilio.
DireccionProvincia | String | No | Codigo de la provincia del domicilio.
DireccionLocalidad | String | No | Codigo de la localidad del domicilio.
CodigoPostal | String | No | Codigo postal del domicilio.
DireccionDescripcion | String | No | Descripcion libre del domicilio.
TelefonoTipo | String | No | Tipo de telefono (ej: Celular, Fijo).
TelefonoNumero | String | No | Numero de telefono.
PerfilLinkedin | String | No | URL del perfil de LinkedIn.
PerfilFacebook | String | No | URL del perfil de Facebook.

Cuadro explicativo - Arrays de historial (JSON Body)

Array | Campos del array
HistorialRemuneracion | RemuneracionFechaDesde (YYYY-MM-DD), RemuneracionBruta (Decimal), RemuneracionTipo (Integer), RemuneracionObservaciones (String).
HistorialAltaBaja | MotivoAltaBajaFechaDesde (YYYY-MM-DD), AntiguedadReconocidaFecha (Date/null), MotivoAltaBajaCodigo (String), MotivoAltaBajaObservaciones (String).
HistorialPuesto | FuncionFechaDesde (YYYY-MM-DD), FuncionCodigo (String), TurnoCodigo (String), PuestoSeniorityCodigo (String), FuncionObservaciones (String).
HistorialConvenio | ConvenioFechaDesde (YYYY-MM-DD), ConvenioCodigo (String), ConvenioCategoriaCodigo (String), ConvenioZonaCodigo (String).
HistorialObraSocial | ObraSocialFechaDesde (YYYY-MM-DD), ObraSocialCodigo (String), Adherentes (Integer).
HistorialSindicato | SindicatoFechaDesde (YYYY-MM-DD), SindicatoCodigo (String).
HistorialActividadLaboral | ActividadLaboralFechaDesde (YYYY-MM-DD), ActividadLaboralCodigo (String).
HistorialTipoSiniestro | TipoSiniestroFechaDesde (YYYY-MM-DD), TipoSiniestroCodigo (String).
HistorialZonaLaboral | ZonaLaboralFechaDesde (YYYY-MM-DD), ZonaLaboralCodigo (String).
HistorialCondicionLaboral | CondicionLaboralFechaDesde (YYYY-MM-DD), CondicionLaboralCodigo (String).
HistorialRegimenJubilatorio | RegimenJubilatorioFechaDesde (YYYY-MM-DD), RegimenJubilatorioCodigo (String).
HistorialRegimenContratacion | RegimenContratacionFechaDesde (YYYY-MM-DD), RegimenContratacionCodigo (String), RegimenContratacionConsultora (String).
HistorialSituacionLaboral | SituacionLaboralFechaDesde (YYYY-MM-DD), SituacionLaboralCodigo (String).

Cuadro explicativo - Respuestas

Codigo | Descripcion
200 | Operacion procesada correctamente.
400 | Solicitud invalida o error de validacion.
404 | Recurso no encontrado (segun validaciones de negocio).
500 | Error interno del servidor.

Ejemplo JSON - Request

{
  "PersonaCodigo": "CLAU16",
  "EmpresaCodigo": "CAGPRUE",
  "NumeroLegajo": "CLAU16",
  "Email": "claudia.ejemplo@empresa.com",
  "Apellido": "EJEMPLO",
  "Nombre": "CLAUDIA",
  "Activo": 1,
  "Descripcion": "Analista senior de RRHH",
  "IdentificacionTributariaCodigo": "CUIL",
  "IdentificacionTributariaNumero": "27123456789",
  "Sexo": 2,
  "FechaCumpleanos": "1990-05-12",
  "EstadoCivil": 2,
  "PaisNacionalidadCodigo": "ARG",
  "BancoCodigo": "017",
  "BancoSucursal": "001",
  "TipoCuentaBancaria": 1,
  "NumeroCuentaBancaria": "1234567890",
  "ClaveCuentaBancaria": "0170000100001234567890",
  "ExportadoInterbanking": true,
  "CuentaAdicional": "Caja ahorro USD",
  "BancoCodigoFDesempleo": "017",
  "BancoSucursalFDesempleo": "002",
  "TipoCuentaBancariaFDesempleo": 1,
  "NumeroCuentaBancariaFDesempleo": "9876543210",
  "ClaveCuentaBancariaFDesempleo": "0170000200009876543210",
  "ExportadoInterbankingFDesempleo": false,
  "DireccionTipo": 1,
  "DireccionCalle": "San Martin",
  "DireccionNumero": "1234",
  "DireccionPiso": "3",
  "DireccionDpto": "B",
  "DireccionPais": "ARG",
  "DireccionProvincia": "SFE",
  "DireccionLocalidad": "ROS",
  "CodigoPostal": "2000",
  "DireccionDescripcion": "Domicilio particular",
  "TelefonoTipo": "Celular",
  "TelefonoNumero": "3415551234",
  "PerfilLinkedin": "https://linkedin.com/in/claudia-ejemplo",
  "PerfilFacebook": "https://facebook.com/claudia.ejemplo",
  "HistorialRemuneracion": [
    {
      "RemuneracionFechaDesde": "2024-01-01",
      "RemuneracionBruta": 700000.0,
      "RemuneracionTipo": 1,
      "RemuneracionObservaciones": "Escala enero 2024"
    },
    {
      "RemuneracionFechaDesde": "2025-01-01",
      "RemuneracionBruta": 850000.0,
      "RemuneracionTipo": 1,
      "RemuneracionObservaciones": "Escala enero 2025"
    }
  ],
  "HistorialAltaBaja": [
    {
      "MotivoAltaBajaFechaDesde": "2020-03-01",
      "AntiguedadReconocidaFecha": "2019-06-01",
      "MotivoAltaBajaCodigo": "ALTA",
      "MotivoAltaBajaObservaciones": "Ingreso inicial"
    }
  ],
  "HistorialPuesto": [
    {
      "FuncionFechaDesde": "2025-01-01",
      "FuncionCodigo": "ANL_SSR",
      "TurnoCodigo": "DIURNO",
      "PuestoSeniorityCodigo": "SSR",
      "FuncionObservaciones": "Equipo de compensaciones"
    }
  ],
  "HistorialConvenio": [
    {
      "ConvenioFechaDesde": "2025-01-01",
      "ConvenioCodigo": "COMERCIO",
      "ConvenioCategoriaCodigo": "ADMIN_A",
      "ConvenioZonaCodigo": "NORTE"
    }
  ],
  "HistorialObraSocial": [
    {
      "ObraSocialFechaDesde": "2025-01-01",
      "ObraSocialCodigo": "300800",
      "Adherentes": 1
    }
  ],
  "HistorialSindicato": [
    {
      "SindicatoFechaDesde": "2025-01-01",
      "SindicatoCodigo": "SEC"
    }
  ],
  "HistorialActividadLaboral": [
    {
      "ActividadLaboralFechaDesde": "2025-01-01",
      "ActividadLaboralCodigo": "620100"
    }
  ],
  "HistorialTipoSiniestro": [
    {
      "TipoSiniestroFechaDesde": "2025-01-01",
      "TipoSiniestroCodigo": "0"
    }
  ],
  "HistorialZonaLaboral": [
    {
      "ZonaLaboralFechaDesde": "2025-01-01",
      "ZonaLaboralCodigo": "NORTE"
    }
  ],
  "HistorialCondicionLaboral": [
    {
      "CondicionLaboralFechaDesde": "2025-01-01",
      "CondicionLaboralCodigo": "1"
    }
  ],
  "HistorialRegimenJubilatorio": [
    {
      "RegimenJubilatorioFechaDesde": "2025-01-01",
      "RegimenJubilatorioCodigo": "1"
    }
  ],
  "HistorialRegimenContratacion": [
    {
      "RegimenContratacionFechaDesde": "2025-01-01",
      "RegimenContratacionCodigo": "301",
      "RegimenContratacionConsultora": null
    }
  ],
  "HistorialSituacionLaboral": [
    {
      "SituacionLaboralFechaDesde": "2025-01-01",
      "SituacionLaboralCodigo": "1"
    }
  ]
}

Ejemplo JSON - Response OK

{
  "status": "updated"
}

Notas y consideraciones

Se admiten multiples entradas por historial para cargar cambios a lo largo del tiempo. Si ya existe el legajo, se actualiza.

4. API Colaboradores sin Historial (Alta / Modificacion)

Endpoint

POST https://api.finneg.com/api/custom/legajo

Descripcion

Crea o actualiza el legajo de un colaborador con un unico registro vigente para cada dato laboral (sin multiples historiales). Los campos de remuneracion, puesto, convenio, etc. se envian como atributos planos del objeto raiz.

Cuadro explicativo - Parametros de Query (URL)

Parametro | Tipo | Requerido | Descripcion
ACCESS_TOKEN | UUID | Si | Token de acceso obtenido mediante la API de autenticacion.
origenIntegracion | String | No | Origen de la integracion (parametro opcional del endpoint).

Cuadro explicativo - Cuerpo de la solicitud (JSON Body)

Campo | Tipo | Requerido | Descripcion
PersonaCodigo | String | Si | Codigo unico de la persona.
EmpresaCodigo | String | Si | Codigo de la empresa del colaborador.
NumeroLegajo | String | Si | Numero de legajo del colaborador.
Email | String | No | Correo electronico del colaborador.
Apellido | String | Si | Apellido del colaborador.
Nombre | String | Si | Nombre del colaborador.
Activo | Integer | Si | Estado activo: 1 = Activo, 0 = Inactivo.
RemuneracionFechaDesde | Date (YYYY-MM-DD) | Si | Vigencia de la remuneracion.
RemuneracionBruta | Decimal | Si | Importe de remuneracion bruta mensual.
RemuneracionTipo | Integer | Si | Tipo de remuneracion (segun tabla de referencia).
RemuneracionObservaciones | String | No | Observaciones sobre la remuneracion.
MotivoAltaBajaFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de alta o baja del colaborador.
MotivoAltaBajaCodigo | String | Si | Codigo del motivo de alta o baja.
AntiguedadReconocidaFecha | Date/null | No | Fecha de antiguedad reconocida para aportes.
MotivoAltaBajaObservaciones | String | No | Observaciones del alta/baja.
FuncionFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia del puesto.
FuncionCodigo | String | Si | Codigo del puesto/funcion del colaborador.
TurnoCodigo | String | Si | Codigo del turno de trabajo.
PuestoSeniorityCodigo | String | No | Codigo de seniority del puesto.
FuncionObservaciones | String | No | Observaciones del puesto.
ConvenioFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia del convenio colectivo.
ConvenioCodigo | String | Si | Codigo del convenio colectivo de trabajo.
ConvenioCategoriaCodigo | String | Si | Codigo de categoria dentro del convenio.
ConvenioZonaCodigo | String | Si | Codigo de zona del convenio.
ObraSocialFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de obra social.
ObraSocialCodigo | String | Si | Codigo RNOS de la obra social.
Adherentes | Integer | No | Cantidad de adherentes a la obra social.
SindicatoFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de afiliacion sindical.
SindicatoCodigo | String | Si | Codigo del sindicato.
ActividadLaboralFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de actividad laboral.
ActividadLaboralCodigo | String | Si | Codigo de actividad laboral (clasificacion AFIP).
CondicionLaboralFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de condicion laboral.
CondicionLaboralCodigo | String | Si | Codigo de condicion laboral (ej: 1 = Empleado).
RegimenJubilatorioFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de regimen jubilatorio.
RegimenJubilatorioCodigo | String | Si | Codigo de regimen jubilatorio (ej: 1 = Dependencia).
RegimenContratacionFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia del regimen de contratacion.
RegimenContratacionCodigo | String | Si | Codigo del regimen de contratacion (ej: 301 = Relacion de dependencia).
RegimenContratacionConsultora | String/null | No | Codigo de consultora para contratacion a traves de terceros.
SituacionLaboralFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de situacion laboral.
SituacionLaboralCodigo | String | Si | Codigo de situacion laboral (ej: 1 = Activo).
TipoSiniestroFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de tipo de siniestro ART.
TipoSiniestroCodigo | String | Si | Codigo del tipo de siniestro para ART.
ZonaLaboralFechaDesde | Date (YYYY-MM-DD) | Si | Fecha de vigencia de zona laboral.
ZonaLaboralCodigo | String | Si | Codigo de zona laboral.

Cuadro explicativo - Respuestas

Codigo | Descripcion
200 | Operacion procesada correctamente.
400 | Solicitud invalida o error de validacion.
404 | Recurso no encontrado (segun validaciones de negocio).
500 | Error interno del servidor.

Ejemplo JSON - Request

{
  "PersonaCodigo": "CLAU16",
  "EmpresaCodigo": "CAGPRUE",
  "NumeroLegajo": "CLAU16",
  "Email": "claudia.ejemplo@empresa.com",
  "Apellido": "EJEMPLO",
  "Nombre": "CLAUDIA",
  "Activo": 1,
  "Descripcion": "Analista senior de RRHH",
  "IdentificacionTributariaCodigo": "CUIL",
  "IdentificacionTributariaNumero": "27123456789",
  "Sexo": 2,
  "FechaCumpleanos": "1990-05-12",
  "EstadoCivil": 2,
  "PaisNacionalidadCodigo": "ARG",
  "BancoCodigo": "017",
  "BancoSucursal": "001",
  "TipoCuentaBancaria": 1,
  "NumeroCuentaBancaria": "1234567890",
  "ClaveCuentaBancaria": "0170000100001234567890",
  "ExportadoInterbanking": true,
  "CuentaAdicional": "Caja ahorro USD",
  "RemuneracionFechaDesde": "2025-01-01",
  "RemuneracionBruta": 850000.0,
  "RemuneracionTipo": 1,
  "RemuneracionObservaciones": "Actualizacion paritaria enero",
  "MotivoAltaBajaFechaDesde": "2020-03-01",
  "AntiguedadReconocidaFecha": "2019-06-01",
  "MotivoAltaBajaCodigo": "ALTA",
  "MotivoAltaBajaObservaciones": "Ingreso inicial",
  "FuncionFechaDesde": "2025-01-01",
  "FuncionCodigo": "ANL_SSR",
  "TurnoCodigo": "DIURNO",
  "PuestoSeniorityCodigo": "SSR",
  "FuncionObservaciones": "Equipo de compensaciones",
  "ConvenioFechaDesde": "2025-01-01",
  "ConvenioCodigo": "COMERCIO",
  "ConvenioCategoriaCodigo": "ADMIN_A",
  "ConvenioZonaCodigo": "NORTE",
  "ObraSocialFechaDesde": "2025-01-01",
  "ObraSocialCodigo": "300800",
  "Adherentes": 1,
  "SindicatoFechaDesde": "2025-01-01",
  "SindicatoCodigo": "SEC",
  "ActividadLaboralFechaDesde": "2025-01-01",
  "ActividadLaboralCodigo": "620100",
  "CondicionLaboralFechaDesde": "2025-01-01",
  "CondicionLaboralCodigo": "1",
  "RegimenJubilatorioFechaDesde": "2025-01-01",
  "RegimenJubilatorioCodigo": "1",
  "RegimenContratacionFechaDesde": "2025-01-01",
  "RegimenContratacionCodigo": "301",
  "RegimenContratacionConsultora": null,
  "SituacionLaboralFechaDesde": "2025-01-01",
  "SituacionLaboralCodigo": "1",
  "TipoSiniestroFechaDesde": "2025-01-01",
  "TipoSiniestroCodigo": "0",
  "ZonaLaboralFechaDesde": "2025-01-01",
  "ZonaLaboralCodigo": "NORTE"
}

Ejemplo JSON - Response OK

{
  "status": "updated"
}

Notas y consideraciones

A diferencia de la version con historial, cada campo laboral admite un unico valor vigente. Ideal para integraciones sin trazabilidad historica completa.

5. API Colaboradores con Historial (Consulta)

Endpoint

GET https://api.finneg.com/api/custom/legajo/conHistorial

Descripcion

Obtiene el legajo completo de un colaborador incluyendo todos sus historiales.

Cuadro explicativo - Parametros de Query (URL)

Parametro | Tipo | Requerido | Descripcion
ACCESS_TOKEN | UUID | Si | Token de acceso obtenido mediante la API de autenticacion.
persona | String | Condicional | Codigo de la persona a consultar.
identificacionTributaria | String | Condicional | Identificacion tributaria de la persona (alternativa a persona).
numeroLegajo | String | Condicional | Numero de legajo (si se informa, debe enviarse empresa).
empresa | String | Condicional | Codigo de empresa. Requerido con numeroLegajo y para resolver legajo en consultas.

Regla funcional: debe enviarse persona o identificacionTributaria, o bien la dupla numeroLegajo + empresa.

Cuadro explicativo - Respuestas

Codigo | Descripcion
200 | Retorna el legajo completo con historiales en JSON.
400 | Falta de parametros requeridos o combinacion invalida de filtros.
404 | La persona o el empleado no existe.
500 | Error interno del servidor.

Ejemplo JSON - Response

{
  "PersonaCodigo": "CLAU16",
  "EmpresaCodigo": "CAGPRUE",
  "NumeroLegajo": "CLAU16",
  "Email": "claudia.ejemplo@empresa.com",
  "Apellido": "EJEMPLO",
  "Nombre": "CLAUDIA",
  "Activo": 1,
  "Descripcion": "Analista senior de RRHH",
  "IdentificacionTributariaCodigo": "CUIL",
  "IdentificacionTributariaNumero": "27123456789",
  "Sexo": 2,
  "FechaCumpleanos": "1990-05-12",
  "EstadoCivil": 2,
  "PaisNacionalidadCodigo": "ARG",
  "BancoCodigo": "017",
  "BancoSucursal": "001",
  "TipoCuentaBancaria": 1,
  "NumeroCuentaBancaria": "1234567890",
  "ClaveCuentaBancaria": "0170000100001234567890",
  "ExportadoInterbanking": true,
  "CuentaAdicional": "Caja ahorro USD",
  "BancoCodigoFDesempleo": "017",
  "BancoSucursalFDesempleo": "002",
  "TipoCuentaBancariaFDesempleo": 1,
  "NumeroCuentaBancariaFDesempleo": "9876543210",
  "ClaveCuentaBancariaFDesempleo": "0170000200009876543210",
  "ExportadoInterbankingFDesempleo": false,
  "DireccionTipo": 1,
  "DireccionCalle": "San Martin",
  "DireccionNumero": "1234",
  "DireccionPiso": "3",
  "DireccionDpto": "B",
  "DireccionPais": "ARG",
  "DireccionProvincia": "SFE",
  "DireccionLocalidad": "ROS",
  "CodigoPostal": "2000",
  "DireccionDescripcion": "Domicilio particular",
  "TelefonoTipo": "Celular",
  "TelefonoNumero": "3415551234",
  "PerfilLinkedin": "https://linkedin.com/in/claudia-ejemplo",
  "PerfilFacebook": "https://facebook.com/claudia.ejemplo",
  "HistorialRemuneracion": [
    {
      "RemuneracionFechaDesde": "2024-01-01",
      "RemuneracionBruta": 700000.0,
      "RemuneracionTipo": 1,
      "RemuneracionObservaciones": "Escala enero 2024"
    },
    {
      "RemuneracionFechaDesde": "2025-01-01",
      "RemuneracionBruta": 850000.0,
      "RemuneracionTipo": 1,
      "RemuneracionObservaciones": "Escala enero 2025"
    }
  ],
  "HistorialAltaBaja": [
    {
      "MotivoAltaBajaFechaDesde": "2020-03-01",
      "AntiguedadReconocidaFecha": "2019-06-01",
      "MotivoAltaBajaCodigo": "ALTA",
      "MotivoAltaBajaObservaciones": "Ingreso inicial"
    }
  ],
  "HistorialPuesto": [
    {
      "FuncionFechaDesde": "2025-01-01",
      "FuncionCodigo": "ANL_SSR",
      "TurnoCodigo": "DIURNO",
      "PuestoSeniorityCodigo": "SSR",
      "FuncionObservaciones": "Equipo de compensaciones"
    }
  ],
  "HistorialConvenio": [
    {
      "ConvenioFechaDesde": "2025-01-01",
      "ConvenioCodigo": "COMERCIO",
      "ConvenioCategoriaCodigo": "ADMIN_A",
      "ConvenioZonaCodigo": "NORTE"
    }
  ],
  "HistorialObraSocial": [
    {
      "ObraSocialFechaDesde": "2025-01-01",
      "ObraSocialCodigo": "300800",
      "Adherentes": 1
    }
  ],
  "HistorialSindicato": [
    {
      "SindicatoFechaDesde": "2025-01-01",
      "SindicatoCodigo": "SEC"
    }
  ],
  "HistorialActividadLaboral": [
    {
      "ActividadLaboralFechaDesde": "2025-01-01",
      "ActividadLaboralCodigo": "620100"
    }
  ],
  "HistorialTipoSiniestro": [
    {
      "TipoSiniestroFechaDesde": "2025-01-01",
      "TipoSiniestroCodigo": "0"
    }
  ],
  "HistorialZonaLaboral": [
    {
      "ZonaLaboralFechaDesde": "2025-01-01",
      "ZonaLaboralCodigo": "NORTE"
    }
  ],
  "HistorialCondicionLaboral": [
    {
      "CondicionLaboralFechaDesde": "2025-01-01",
      "CondicionLaboralCodigo": "1"
    }
  ],
  "HistorialRegimenJubilatorio": [
    {
      "RegimenJubilatorioFechaDesde": "2025-01-01",
      "RegimenJubilatorioCodigo": "1"
    }
  ],
  "HistorialRegimenContratacion": [
    {
      "RegimenContratacionFechaDesde": "2025-01-01",
      "RegimenContratacionCodigo": "301",
      "RegimenContratacionConsultora": null
    }
  ],
  "HistorialSituacionLaboral": [
    {
      "SituacionLaboralFechaDesde": "2025-01-01",
      "SituacionLaboralCodigo": "1"
    }
  ]
}

Notas y consideraciones

Permite verificar estado actual e historico del colaborador luego de altas o modificaciones.

6. API Colaboradores sin Historial (Consulta)

Endpoint

GET https://api.finneg.com/api/custom/legajo

Descripcion

Obtiene el legajo de un colaborador con datos vigentes actuales, sin detalle de historiales.

Cuadro explicativo - Parametros de Query (URL)

Parametro | Tipo | Requerido | Descripcion
ACCESS_TOKEN | UUID | Si | Token de acceso obtenido mediante la API de autenticacion.
persona | String | Si | Codigo de la persona a consultar.
empresa | String | Si | Codigo de la empresa del colaborador.

Cuadro explicativo - Respuestas

Codigo | Descripcion
200 | Retorna datos actuales del colaborador en formato plano.
400 | No se recibieron los datos necesarios o error de validacion.
404 | La persona o el empleado no existe.
500 | Error interno del servidor.

Ejemplo JSON - Response

{
  "PersonaCodigo": "CLAU16",
  "EmpresaCodigo": "CAGPRUE",
  "NumeroLegajo": "CLAU16",
  "Email": "claudia.ejemplo@empresa.com",
  "Apellido": "EJEMPLO",
  "Nombre": "CLAUDIA",
  "Activo": 1,
  "Descripcion": "Analista senior de RRHH",
  "IdentificacionTributariaCodigo": "CUIL",
  "IdentificacionTributariaNumero": "27123456789",
  "Sexo": 2,
  "FechaCumpleanos": "1990-05-12",
  "EstadoCivil": 2,
  "PaisNacionalidadCodigo": "ARG",
  "BancoCodigo": "017",
  "BancoSucursal": "001",
  "TipoCuentaBancaria": 1,
  "NumeroCuentaBancaria": "1234567890",
  "ClaveCuentaBancaria": "0170000100001234567890",
  "ExportadoInterbanking": true,
  "CuentaAdicional": "Caja ahorro USD",
  "BancoCodigoFDesempleo": "017",
  "BancoSucursalFDesempleo": "002",
  "TipoCuentaBancariaFDesempleo": 1,
  "NumeroCuentaBancariaFDesempleo": "9876543210",
  "ClaveCuentaBancariaFDesempleo": "0170000200009876543210",
  "ExportadoInterbankingFDesempleo": false,
  "DireccionTipo": 1,
  "DireccionCalle": "San Martin",
  "DireccionNumero": "1234",
  "DireccionPiso": "3",
  "DireccionDpto": "B",
  "DireccionPais": "ARG",
  "DireccionProvincia": "SFE",
  "DireccionLocalidad": "ROS",
  "CodigoPostal": "2000",
  "DireccionDescripcion": "Domicilio particular",
  "TelefonoTipo": "Celular",
  "TelefonoNumero": "3415551234",
  "PerfilLinkedin": "https://linkedin.com/in/claudia-ejemplo",
  "PerfilFacebook": "https://facebook.com/claudia.ejemplo",
  "RemuneracionFechaDesde": "2025-01-01",
  "RemuneracionBruta": 850000.0,
  "RemuneracionTipo": 1,
  "RemuneracionObservaciones": "Actualizacion paritaria enero",
  "MotivoAltaBajaFechaDesde": "2020-03-01",
  "AntiguedadReconocidaFecha": "2019-06-01",
  "MotivoAltaBajaCodigo": "ALTA",
  "MotivoAltaBajaObservaciones": "Ingreso inicial",
  "FuncionFechaDesde": "2025-01-01",
  "FuncionCodigo": "ANL_SSR",
  "TurnoCodigo": "DIURNO",
  "PuestoSeniorityCodigo": "SSR",
  "FuncionObservaciones": "Equipo de compensaciones",
  "ConvenioCodigo": "COMERCIO",
  "ConvenioFechaDesde": "2025-01-01",
  "ConvenioCategoriaCodigo": "ADMIN_A",
  "ConvenioZonaCodigo": "NORTE",
  "ObraSocialFechaDesde": "2025-01-01",
  "ObraSocialCodigo": "300800",
  "Adherentes": 1,
  "SindicatoFechaDesde": "2025-01-01",
  "SindicatoCodigo": "SEC",
  "ActividadLaboralFechaDesde": "2025-01-01",
  "ActividadLaboralCodigo": "620100",
  "CondicionLaboralFechaDesde": "2025-01-01",
  "CondicionLaboralCodigo": "1",
  "RegimenJubilatorioFechaDesde": "2025-01-01",
  "RegimenJubilatorioCodigo": "1",
  "RegimenContratacionFechaDesde": "2025-01-01",
  "RegimenContratacionCodigo": "301",
  "RegimenContratacionConsultora": null,
  "SituacionLaboralFechaDesde": "2025-01-01",
  "SituacionLaboralCodigo": "1",
  "TipoSiniestroFechaDesde": "2025-01-01",
  "TipoSiniestroCodigo": "0",
  "ZonaLaboralFechaDesde": "2025-01-01",
  "ZonaLaboralCodigo": "NORTE"
}

Notas y consideraciones

Util para validar que los datos vigentes fueron registrados correctamente.

7. API Colaboradores (Eliminacion)

Endpoint

DELETE https://api.finneg.com/api/custom/legajo

Descripcion

Elimina un colaborador por numero de legajo y empresa (integracion Quippos), segun la implementacion en GestionColaboradoresApi.

Cuadro explicativo - Parametros de Query (URL)

Parametro | Tipo | Requerido | Descripcion
ACCESS_TOKEN | UUID | Si | Token de acceso obtenido mediante la API de autenticacion.
numeroLegajo | String | Si | Numero de legajo del colaborador a eliminar.
empresa | String | Si | Codigo de empresa padre del colaborador.

Cuadro explicativo - Respuestas

Codigo | Descripcion
200 | Eliminado correctamente.
400 | Solicitud invalida o error de validacion.
404 | No existia el colaborador a eliminar.
500 | Error interno del servidor.

Ejemplo JSON - Response OK

{
  "status": "deleted"
}

Ejemplo JSON - Response Error

{
  "status": "error",
  "mensaje": "El empleado no existe."
}

Notas y consideraciones

La eliminacion se procesa por la combinacion numeroLegajo + empresa.