Saltar al contenido principal
PUT

Actualizar el contrato activo de un empleado

Scope:team:employees.write
https://api.holded.com/api/v2/employees/{employeeId}/contract

Updates the active contract of an employee. This is a full-replacement operation — ALL fields must be provided. Workflow: (1) Call GET /api/v2/employees/{employeeId}/contract to get current contract data. (2) Send ALL fields from that response back here, modifying only the ones you want to change. Use when the user asks to update "puesto", "cargo", "salario", "jornada", or any contract field. Does not modify salary history — use the salary-increase endpoints for that.

Parámetros

Parámetros de ruta

employeeIdstringobligatorio

ID del empleado (ObjectId hexadecimal de 24 caracteres)

Cuerpo de la petición

object
employeestring | nulloptional

Nombre completo del empleado

nifstring | nulloptional

NIF/NIE del empleado

contractTypeintegerrequired

Código del tipo de contrato (SEPE)

contributionTypestring | nulloptional

Tipo de cotización a la Seguridad Social

royalDecreestring | nulloptional

Código del Real Decreto aplicable

startDatestring<date-time>required

Fecha de inicio del contrato

seniorityDatestring<date-time> | nulloptional

Fecha de antigüedad real del empleado (debe ser anterior o igual a startDate). Omitirla (o enviar null) conserva la fecha de antigüedad guardada en el contrato, así que para adelantar startDate por delante de ella hay que enviar también seniorityDate. Para corregir startDate, envía también seniorityDate: no se mueve con ella. Los contratos sin fecha guardada la leen igual a startDate

endDatestring<date-time> | nulloptional

Fecha de fin del contrato (null si indefinido)

educationalLevelstring | nulloptional

Código del nivel educativo

jobTitlestring | nulloptional

Puesto o cargo del empleado

professionalCategorystring | nulloptional

Categoría profesional

scheduleHoursnumber | nulloptional

Horas semanales de jornada

scheduleModestring | nulloptional

Modalidad de jornada (semana, fija, etc.)

workingDays[]string[] | nulloptional

Días laborables de la semana

probationPeriodDaysinteger | nulloptional

Días de periodo de prueba

vacationDaysnumber | nulloptional

Días de vacaciones por año

isManuallyActivatedboolean | nulloptional

Indica si el contrato fue activado manualmente

workModalitystring | nulloptional

Modalidad de trabajo (presencial, remoto, híbrido)

salarynumberoptional

Salario bruto anual

salaryIntervalstringoptional

Periodicidad del salario

salaryPaymentsnumber | nulloptional

Número de pagas anuales

Petición

python
import requests

url = "https://api.holded.com/api/v2/employees/{employeeId}/contract"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "employee": "string",
    "nif": "string",
    "contractType": 421,
    "contributionType": "string",
    "royalDecree": "string",
    "startDate": "2024-01-15T10:30:00Z",
    "seniorityDate": "2024-01-15T10:30:00Z",
    "endDate": "2024-01-15T10:30:00Z",
    "educationalLevel": "string",
    "jobTitle": "string",
    "professionalCategory": "string",
    "scheduleHours": 0,
    "scheduleMode": "string",
    "workingDays": [
        "string"
    ],
    "probationPeriodDays": 0,
    "vacationDays": 0,
    "isManuallyActivated": false,
    "workModality": "string",
    "salary": 20000,
    "salaryInterval": "string",
    "salaryPayments": 0
}
response = requests.put(url, headers=headers, json=payload)
print(response.json())

Respuestas

Respuestas exitosas

204Contrato actualizado

Respuestas de error

400Solicitud incorrectaapplication/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
404Empleado o contrato activo no encontradoapplication/json
429Límite de solicitudes excedidoapplication/json