--- title: "Consultar Vinculaciones" method: GET path: "/vinculaciones" tags: ["Archivos"] --- # Consultar Vinculaciones `GET /vinculaciones` ## Request - Base URL: `https://api.loggro.com/apik/loggro-sipe` - URL: `https://api.loggro.com/apik/loggro-sipe/vinculaciones` - Auth: HTTP bearer Retorna las vinculaciones de un empleado, cada una con sus detalles de vinculación y la información de plaza asociada a cada detalle. Las vinculaciones se retornan ordenadas de la más reciente a la más antigua (secuencia descendente). Los filtros por tipo de empleado y clase de tipo de empleado son opcionales; si no se envían, se consultan todas las vinculaciones del empleado. La compañía se obtiene automáticamente de la sesión del usuario autenticado. También se valida la sesión del usuario mediante autenticación Bearer Token. ## Query parameters - `empleado` string, required - `tipoEmpleado` string - `claseTipoEmpleado` string ## Response `200` Vinculaciones encontradas - VinculacionRespuestaConsulta[] - `identificacion` string: Código del empleado consultado. - `operacionExitosa` boolean: Indica si la vinculación fue consultada correctamente. - `data` Vinculacion: Vinculación de un empleado con sus detalles de vinculación. - `compania` string: Código de la compañía. - `empleado` string: Código del empleado. - `nombreEmpleado` string, nullable: Nombre resumido del empleado. - `secuencia` integer: Secuencia de la vinculación. - `tipoEmpleado` string: Código del tipo de empleado. - `nombreTipoEmpleado` string, nullable: Descripción del tipo de empleado. - `claseTipoEmpleado` string: Código de la clase de tipo de empleado. - `nombreClaseTipoEmpleado` string, nullable: Descripción de la clase de tipo de empleado. - `tipoVinculacion` string: Código del tipo de vinculación. - `nombreTipoVinculacion` string, nullable: Descripción del tipo de vinculación. - `fechaInicial` string, dd/MM/yyyy: Fecha inicial de la vinculación (formato dd/MM/yyyy). - `fechaFinal` string, dd/MM/yyyy, nullable: Fecha final de la vinculación (formato dd/MM/yyyy). - `fechaFinalContrato` string, dd/MM/yyyy, nullable: Fecha final del contrato (formato dd/MM/yyyy). - `actaLiquidacionDefinitiva` integer, nullable: Número del acta de liquidación definitiva. - `continuaVinculacion` string: Indica si continúa la vinculación: S: Sí, N: No. - `fechaRetiroContinuaVinculacion` string, dd/MM/yyyy, nullable: Fecha de retiro cuando continúa la vinculación (formato dd/MM/yyyy). - `teletrabajo` string: Indica si el empleado realiza teletrabajo: S: Sí, N: No. - `sucursalAutoliquidacion` string: Código de la sucursal de autoliquidación. - `nombreSucursalAutoliquidacion` string, nullable: Descripción de la sucursal de autoliquidación. - `regimenCesantia` string: Código del régimen de cesantía. - `terceroCesantia` string: Identificación del tercero (fondo) de cesantía. - `nombreTerceroCesantia` string, nullable: Razón social del tercero de cesantía. - `fechaCambioTerceroCesantia` string, dd/MM/yyyy, nullable: Fecha de cambio del tercero de cesantía (formato dd/MM/yyyy). - `numeroCuentaCesantia` string, nullable: Número de cuenta de cesantía. - `estado` string: Estado de la vinculación: I: Inicial, A: Activo, S: Suspendido, C: Cerrado, R: Retirado. - `usuario` string: Usuario que registró o modificó la vinculación. - `fecha` string, dd/MM/yyyy: Fecha de registro o modificación (formato dd/MM/yyyy). - `detallesVinculacion` DetalleVinculacion[]: Detalles de la vinculación. - `secuenciaVinculacion` integer: Secuencia de la vinculación a la que pertenece el detalle. - `secuencia` integer: Secuencia del detalle de vinculación. - `secuenciaPlaza` integer: Secuencia de la plaza asociada. - `centro` string: Código del centro. - `nombreCentro` string, nullable: Descripción corta del centro. - `dependencia` string: Código de la dependencia. - `nombreDependencia` string, nullable: Descripción de la dependencia. - `tipoNomina` string: Código del tipo de nómina. - `nombreTipoNomina` string, nullable: Descripción del tipo de nómina. - `regimenSalarial` string: Código del régimen salarial. - `nombreRegimenSalarial` string, nullable: Descripción del régimen salarial. - `regimenSalarialPagoBasico` string: Código del régimen salarial de pago básico. - `nombreRegimenSalarialPagoBasico` string, nullable: Descripción del régimen salarial de pago básico. - `salarioRegimenOrigen` number: Salario del régimen de origen. - `oficio` string: Código del oficio. - `nombreOficio` string, nullable: Descripción del oficio. - `oficioPagoBasico` string: Código del oficio de pago básico. - `nombreOficioPagoBasico` string, nullable: Descripción del oficio de pago básico. - `auxilioTransporte` string: Indicador de auxilio de transporte: F: Liquidación Por Defecto, S: Si tiene derecho, N: No tiene derecho. - `fechaPosesion` string, dd/MM/yyyy, nullable: Fecha de posesión (formato dd/MM/yyyy). - `fechaInicioLabores` string, dd/MM/yyyy, nullable: Fecha de inicio de labores (formato dd/MM/yyyy). - `fechaFinLabores` string, dd/MM/yyyy, nullable: Fecha de fin de labores (formato dd/MM/yyyy). - `jornada` string: Código de la jornada. - `nombreJornada` string, nullable: Descripción de la jornada. - `modalidadSalario` string: Modalidad del salario: F: Fijo, V: Variable, I: Integral. - `pagoBasico` string: Indica si tiene pago básico: S: Sí, N: No. - `salarioBasico` number: Salario básico. - `salarioBasicoComputable` number: Salario básico computable. - `porcentajeSalarioBasico` number: Porcentaje del salario básico. - `pagoSobresueldoOficio` string: Indica si tiene pago de sobresueldo por oficio: S: Sí, N: No. - `porcentajeSobresueldoOficio` number: Porcentaje del sobresueldo por oficio. - `pagoSobresueldoNocturno` string: Indica si tiene pago de sobresueldo nocturno: S: Sí, N: No. - `porcentajeSobresueldoNocturno` number: Porcentaje del sobresueldo nocturno. - `año` integer: Año. - `periodo` integer: Periodo. - `subperiodo` integer: Subperiodo. - `nivel` integer: Nivel. - `nivelRegimenOrigen` integer: Nivel del régimen de origen. - `motivoDesvinculacion` string, nullable: Código del motivo de desvinculación. - `descripcionMotivoDesvinculacion` string, nullable: Descripción del motivo de desvinculación. - `informacionPlaza` InformacionPlaza, nullable: Información de la plaza asociada al detalle de vinculación. Es nula cuando el detalle no tiene plaza asociada. - `secuencia` integer: Secuencia de la plaza. - `dedicacion` number: Dedicación de la plaza. - `grupoPlantaCargo` string: Código del grupo de planta cargo. - `nombreGrupoPlantaCargo` string, nullable: Descripción del grupo de planta cargo. - `tieneHorasExtra` string: Indica si la plaza tiene horas extra: S: Sí, N: No. - `pagador` string: Código del pagador. - `nombrePagador` string, nullable: Descripción del pagador. - `secuenciaLocalizacionCentro` integer, nullable: Secuencia de la localización del centro. - `ciudadLocalizacionCentro` string, nullable: Código de la ciudad de la localización del centro. - `terceroRiesgo` string, nullable: Identificación del tercero de riesgos laborales (ARL). - `nombreTerceroRiesgo` string, nullable: Razón social del tercero de riesgos laborales. - `codigoRiesgoProfesional` string, nullable: Código del riesgo profesional. - `nombreRiesgoProfesional` string, nullable: Descripción del riesgo profesional. - `porcentajeRiesgoProfesional` number, nullable: Porcentaje del riesgo profesional. - `fechaCambioRiesgoProfesional` string, dd/MM/yyyy, nullable: Fecha de cambio del riesgo profesional (formato dd/MM/yyyy). ## Other responses - `400`: Parámetros inválidos - `404`: No se encontraron vinculaciones para el empleado indicado (con los filtros enviados), o se presentó un error al consultarlas - `500`: Error interno inesperado al consultar las vinculaciones --- [API](https://skmtc.dev/loggro/apis/n-mina-sipe.md) - [All operations](https://skmtc.dev/loggro/apis/n-mina-sipe/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/n-mina-sipe/revisions/9ba6443587a2?raw)