Empleado por documento

Consultar un empleado por tipo y número de documento.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Reglas de negocio

  • No exige un permiso de rol específico: basta con un token válido para la organización.
  • Devuelve únicamente información de la organización asociada al token; no recibe identificador de compañía.
  • tipoDocumento, identificacion acotan el resultado.
  • Si el identificador consultado no corresponde a un registro existente, se responde 404.
  • Resuelve únicamente empleados con contrato vigente: para una persona ya desvinculada responde 404, aunque exista en la organización.
  • tipoDocumento acepta el código del documento (CC, TI, CE, NIT, PS, DE, SIDIAN, PEP) y no distingue mayúsculas de minúsculas.

Campos de la respuesta

CampoTipoDescripción
vinculadoUuidstringUuid de la vinculación laboral (contrato). Es el identificador que esperan los endpoints de información laboral, salarial y adicional.
identificacionstringNúmero de documento (cédula) del empleado.
empleadostringNombre completo del empleado.
empleadoUuidstringUuid de la persona (empleado). Es el mismo valor que llega como uuidEmpleado en Conceptos acumulados.
⚠️

No confundir empleadoUuid con vinculadoUuid. La mayoría de los endpoints de empleado esperan el uuid del vinculado, no el del empleado.

Para resolver cédula → uuid de todos los empleados en un solo llamado, ver Listar empleados.

Path Params
string
required
string
required
Headers
string
required

Bearer token para la autorización. Consulte la documentación inicial del módulo de nómina para obtener instrucciones sobre cómo generar el token de autenticación.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json