Obtener empleado

GET https://api.afer.pro/api/v1/employees/{id}

Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/obtenerEmpleado

La ficha de una persona con su departamento y su contrato vigente.

Además de los datos de consultarEmpleados, devuelve el bloque contrato_vigente: el contrato sin fecha de baja o con baja futura, el más reciente si hay varios. Es el mismo criterio con el que el módulo interno decide qué contrato aplica a una fecha.

Si la persona no tiene contrato vigente, contrato_vigente llega como null. No se devuelven importes de nómina: para eso está el módulo interno de RRHH.

Autenticación

Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →

Este endpoint requiere autenticación con API key: sin credenciales responde 401.

Parámetros del cuerpo

El cuerpo de la petición es un objeto JSON con Content-Type: application/json.

empleadoIdstring

obligatorio

Identificador de la persona. Viaja en la ruta. Acepta el id cifrado de consultarEmpleados o el numérico legacy.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/employees/aBc123XyZ?empleadoId=eMp001' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET'

<?php

$ch = curl_init('https://api.afer.pro/api/v1/employees/aBc123XyZ?empleadoId=eMp001');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: afer_tk_TU_TOKEN',
    'X-API-SECRET: afer_sk_TU_SECRET',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);

const respuesta = await fetch('https://api.afer.pro/api/v1/employees/aBc123XyZ?empleadoId=eMp001', {
  method: 'GET',
  headers: {
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  }
});

const resultado = await respuesta.json();

Respuesta

200 · application/json

{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "empleado": {
            "empleadoId": "eMp001…",
            "nombre": "Ana",
            "apellidos": "Pons Ferrer",
            "email": "ana.pons@acmeobras.com",
            "activo": true,
            "departamento": {
                "departamentoId": "dEp123…",
                "titulo": "Producción"
            },
            "contrato_vigente": {
                "contratoId": "cTr555…",
                "tipo_contrato": {
                    "tipoContratoId": "tPo1…",
                    "titulo": "Indefinido a tiempo completo"
                },
                "fecha_alta": "2023-09-01",
                "fecha_baja": null,
                "minimo_horas_dia_laborable": 8,
                "modo_turno": "turno",
                "turnoId": "tRn9…",
                "firmado": true
            }
        }
    }
}

Notas

Si la persona no pertenece a tu cuenta responde 404.
El histórico completo de contratos está en consultarContratos con vigentes: false.