Editar

Descripcion general

Este endpoint permite actualizar parcialmente un empleado. Todos los campos del cuerpo son opcionales y operan en tres capas dentro de la misma transacción: datos personales del empleado, datos laborales (puesto, departamento, sucursal, registro patronal, etc.), y valores de campos personalizados. Omitir una clave significa que ese campo no se toca; null la limpia (cuando aplica).

El identificador en la URL es el employee_number. Una solicitud exitosa devuelve 200 con el objeto plano del empleado (datos personales + los de su empleo actual, mismo shape que POST en modo single). Los empleados eliminados se tratan como no encontrados (404).

Sobre los datos laborales. Solo pueden modificarse cuando el empleado está activo (no dado de baja). Si el empleado está dado de baja, tocar cualquier campo laboral devuelve 400 con NO_OPEN_EMPLOYMENT — primero debes reactivarlo.

Invariante IMSS. Cuando el valor efectivo de contributes_to_imss queda en true, el employer_registration efectivo debe estar puesto. Si no, la respuesta es 400.

Datos fijos por historial. Cuando el empleado ya tiene una nómina cerrada en la que se le pagó, o su alta ante el IMSS ya se presentó (desde la plataforma o fuera de ella), worker_type, contributes_to_imss y employer_registration ya no pueden cambiar: la respuesta es 409 con LOCKED_BY_PAYROLL_HISTORY en el campo. Esos datos cambian con una baja y un reingreso. payroll_calendar_number no puede cambiar mientras el empleado está en una nómina abierta (409 con LOCKED_BY_OPEN_PAYROLL). Reenviar el valor guardado no cuenta como cambio.

Tipo de trabajador. Cuando el worker_type efectivo no es subordinate, el contributes_to_imss efectivo debe ser false y los valores efectivos de imss_number y employer_registration deben quedar vacíos (sino, 400): para reclasificar a un subordinado, envía esos campos en null en la misma solicitud. Reclasificar a asimilado u honorarios borra la fecha de antigüedad del empleado. Reclasificar a un trabajador no altera ninguna corrida cerrada: cada corrida congela el tipo con el que se calculó. Un subordinate con créditos INFONAVIT o FONACOT activos o suspendidos no puede pasar a asimilado ni a honorarios (409 con WORKER_TYPE_HAS_CREDITS).

Compensación y estatus. El endpoint acepta también la compensación (daily_base_salary, regimen_fiscal, payroll_calendar_number, contract_number), el horario de trabajo (work_schedule_number o work_schedule_bundle_number) y las unidades organizacionales (organizational_units) del empleado. Cambiar el sueldo registra una nueva fila con fecha efectiva en el historial de sueldos. activate: true da de alta al empleado solo si el estado fusionado queda listo para nómina (sino, 400 ACTIVATION_INCOMPLETE); si su fecha de ingreso cae en periodos cerrados, exige confirm_retro: true (sino, 409 RETRO_CONFIRMATION_REQUIRED) y paga esos periodos con ajustes retroactivos; activate: false lo deja en pending; si omites activate, un empleado active se degrada automáticamente a pending cuando una edición elimina un dato requerido para nómina. El arreglo organizational_units reemplaza el conjunto actual (un arreglo vacío lo limpia).

Endpoint

Path param: employee_number — entero positivo, el número de empleado dentro de la organización.

{ "first_name": "María José", "notes": "Promovida en marzo." }

{ "department_code": "MKT", "job_position_code": null }

{ "contributes_to_imss": false }

{
  "department_code": "MKT",
  "shirt_size": "L",
  "allergens": null
}

Campos del cuerpo — datos personales

Campos del cuerpo — datos laborales

Aplican solo cuando el empleado está activo (no dado de baja). Si el empleado está dado de baja, cualquier campo de esta sección produce 400 NO_OPEN_EMPLOYMENT.

Campos del cuerpo — valores de campos personalizados

Los valores de campos personalizados se envían como claves planas en la raíz del cuerpo, junto a los campos nativos del empleado. Cada key enviada se guarda (sobrescribe el valor anterior si existía); null limpia ese campo; las key omitidas del payload no se tocan. Los tipos aceptados son los mismos que en crear (text/select → string, number → número, boolean → true/false, date → string YYYY-MM-DD).

No aceptados

• legal_entity_number — la razón social del empleado activo es inmutable. Para cambiarla, primero da de baja al empleado y reactívalo contra una nueva razón social.
• hire_date, seniority_date — se fijan al crear/reactivar.
• termination_date — se fija vía /terminate.
• employee_number — identificador en la URL.

Forma de la respuesta

200 OK — el objeto plano del empleado (datos personales + los de su empleo actual), misma forma que la respuesta de crear en modo single.

Errores