Contratos laborales

GET https://api.afer.pro/api/v1/employees/contracts

También disponible en: GET /api/v1/employees/{id}/contract

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

Los contratos de la plantilla: tipo, fechas, período de prueba y jornada pactada.

Por defecto solo los vigentes: sin fecha de baja o con baja igual o posterior a hoy. Con vigentes: false se devuelve el histórico completo, útil para reconstruir la evolución de la plantilla.

minimo_horas_dia_laborable es la jornada mínima pactada por día laborable, y modo_turno indica si la persona trabaja por turno fijo, por patrón semanal o con horario propio del contrato.

No se devuelven importes: ni salario, ni pluses, ni retenciones.

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.

`empleadoId`string opcional	Solo los contratos de esta persona. También disponible como `GET /api/v1/employees/{id}/contract`.
`vigentes`bool opcional	Por defecto `true`. Con `false`, el histórico completo.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/employees/contracts?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/contracts?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/contracts?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": {
        "total_contratos": 1,
        "contratos": [
            {
                "contratoId": "cTr555…",
                "empleado": {
                    "empleadoId": "eMp001…",
                    "nombre": "Ana",
                    "apellidos": "Pons Ferrer"
                },
                "tipo_contrato": {
                    "tipoContratoId": "tPo1…",
                    "titulo": "Indefinido a tiempo completo"
                },
                "departamento": {
                    "departamentoId": "dEp123…",
                    "titulo": "Producción"
                },
                "fecha_alta": "2023-09-01",
                "fecha_baja": null,
                "fecha_fin_periodo_pruebas": "2023-12-01",
                "vigente": true,
                "minimo_horas_dia_laborable": 8,
                "modo_turno": "turno",
                "turnoId": "tRn9…",
                "firmado": true
            }
        ]
    }
}

Notas

firmado refleja si el contrato está firmado digitalmente en Afer, no su validez laboral.