Actualizar el contrato activo de un empleado
team:employees.writehttps://api.holded.com/api/v2/employees/{employeeId}/contractUpdates 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
stringobligatorioID del empleado (ObjectId hexadecimal de 24 caracteres)
Cuerpo de la petición
Nombre completo del empleado
NIF/NIE del empleado
Código del tipo de contrato (SEPE)
Tipo de cotización a la Seguridad Social
Código del Real Decreto aplicable
Fecha de inicio del contrato
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
Fecha de fin del contrato (null si indefinido)
Código del nivel educativo
Puesto o cargo del empleado
Categoría profesional
Horas semanales de jornada
Modalidad de jornada (semana, fija, etc.)
Días laborables de la semana
Días de periodo de prueba
Días de vacaciones por año
Indica si el contrato fue activado manualmente
Modalidad de trabajo (presencial, remoto, híbrido)
Salario bruto anual
Periodicidad del salario
Número de pagas anuales
Petición
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 actualizadoRespuestas de error
400Solicitud incorrectaapplication/json401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json404Empleado o contrato activo no encontradoapplication/json429Límite de solicitudes excedidoapplication/json