Skip to main content

Empleados

GET: Obtener empleados

Descripción del API
Obtiene una lista de empleados según su equipo y, si se proporciona, filtra por fecha de actualización.

Parámetros de entrada

AtributoRequeridoTipoDescripciónEjemplo
updatedAfterOpcionalfechaFecha a partir de la cual se filtran los resultados.2024-01-01
costCenterNameOpcionalcadenaFecha a partir de la cual se filtran los resultados.FM003
workerTypeOpcionalcadenaTipo de trabajador.workman
isActiveOpcionalbooleanoIndica si el empleado está activo.true

JSON de ejemplo (entrada)

  • Ejemplo de solicitud con parámetro de entrada:
{
"updatedAfter": "2025-01-01",
"costCenterName": "FM003",
"workerType": "workman",
"isActive": true
}

Método HTTP

GET /api/employees

Parámetros de salida

AtributoTipoDescripciónEjemplo
namecadenaNombre del empleado."Carlos"
first_lastnamecadenaPrimer apellido del empleado."Gómez"
second_lastnamecadenaSegundo apellido del empleado."Gómez"
emailcadenaCorreo electrónico del empleado."carlos.gomez@example.com"
profilecadenaNombre del perfil asignado al empleado."Fiscalizable"
companycadenaNombre de la empresa a la que pertenece el empleado."Constructora Delta SAC"
costcentercadenaCentro de costos al que está asignado el empleado."FM003"
positioncadenaCargo del empleado."SUPERVISOR DE RRHH EN OBRA"
activebooleanoIndica si el empleado está activo.true
worker_typecadenaTipo de trabajador."workman"
updated_atfechaFecha de la última actualización del empleado."2025-01-21T04:05:59.000Z"

JSON de ejemplo (salida)

  • Respuesta 200 OK:
[
{
"name": "Carlos",
"first_lastname": "Gómez",
"second_lastname": "Gómez",
"document_number": "0501199307541",
"email": "carlos.gomez@example.com",
"profile": "Fiscalizable",
"company": "Constructora Delta SAC",
"costcenter": "FM003",
"position": "SUPERVISOR DE RRHH EN OBRA",
"active": true,
"worker_type": "workman",
"updated_at": "2025-01-21T04:05:59.000Z"
},
{
"name": "Sofía",
"first_lastname": "López",
"second_lastname": "López",
"document_number": "0402198806543",
"email": "sofia.lopez@example.com",
"profile": "No Fiscalizable",
"company": "Ingeniería y Obras S.A.",
"costcenter": "FM003",
"position": "SUPERVISOR DE RRHH EN OBRA",
"active": true,
"worker_type": "workman",
"updated_at": "2025-01-20T10:15:30.500Z"
}
]