API Colaboradores (legajo)

mriquelme · 24 Abril, 2026 13:34

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

Detalle de la integracion
Autenticacion y token
API Colaboradores con Historial (Alta / Modificacion)
API Colaboradores sin Historial (Alta / Modificacion)
API Colaboradores con Historial (Consulta)
API Colaboradores sin Historial (Consulta)
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.