Empleados

GET /v1/employees

Devuelve los empleados de tu empresa. Úsalo para resolver el employee_id de Uvicuo que necesitas al crear un plan de gasto.

Ejemplo

curl https://api.sandbox.partner.uvicuo.com/v1/employees \
  -H "X-API-Key: $UVICUO_API_KEY"

Respuesta

200 OK — un arreglo de empleados:

[
  {
    "id": 42,
    "name": "Juan",
    "lastName": "Pérez",
    "email": "juan.perez@empresa.com",
    "phoneNumber": "+521234567890",
    "status": "ACCEPTED",
    "identifier": "EMP-0042",
    "department": "Logística",
    "companyLocationName": "CDMX"
  }
]

Campo	Tipo	Descripción
`id`	número	El `employee_id` de Uvicuo. Úsalo al crear un plan de gasto.
`name` / `lastName`	string	Nombre y apellido.
`email`	string	Correo del empleado (si existe).
`status`	enum	`PENDING`, `ACCEPTED` o `CREATED`.
`identifier`	string	Tu código de empleado (para correlacionar con tu ERP).
`department`	string	Departamento.
`companyLocationName`	string	Ubicación/sucursal.

Errores comunes

HTTP / `code`	Situación
`401 unauthorized`	Falta o es inválida la `X-API-Key`.