Editar en lote

Descripcion general

Este endpoint aplica actualizaciones parciales a varios empleados en una sola solicitud. El cuerpo es un arreglo de 1 a 100 objetos, y cada objeto identifica al empleado con employee_number y lleva los mismos campos que editar un empleado.

Atómico (todo o nada). Si cualquier fila falla la validación, ningún empleado se actualiza y la respuesta lista los problemas por fila para corregirlos en una sola pasada. Una solicitud exitosa devuelve 200 con un summary y el arreglo updated de empleados (objetos planos, mismo shape que editar).

Mismas reglas que la edición individual, por fila: resolución de códigos/números (LE-scoped para registro patronal, calendario y contrato), colisiones de RFC/CURP, invariante IMSS, datos fijos por historial de nómina, créditos que impiden reclasificar, banco requerido para una cuenta sin CLABE, preparación para nómina (activate / degradación automática), historial de sueldos al cambiar el sueldo y reconciliación de unidades organizacionales. En el lote, esas reglas llegan como problemas de la fila en la respuesta 400, no como 409. La excepción es el alta en periodos cerrados: sin confirm_retro: true en la fila, la respuesta es 409 con RETRO_CONFIRMATION_REQUIRED y retro_periods en esa fila, y ningún empleado se actualiza.

Para editar un solo empleado, usa PATCH /api/v1/employees/{employee_number} — este endpoint siempre espera un arreglo.

Endpoint

[
  { "employee_number": 5, "department_code": "MKT", "job_position_code": null },
  { "employee_number": 7, "daily_base_salary": 666.67 }
]

Cuerpo de la solicitud

El cuerpo es un arreglo de 1 a 100 objetos. Cada objeto:

Forma de las respuestas

200 — actualización exitosa

La respuesta envuelve los resultados en summary + updated[]. Cada elemento de updated es el objeto plano del empleado (datos personales + los de su empleo actual), igual que la respuesta de editar.

{
  "summary": { "total": 2, "updated": 2 },
  "updated": [
    { "employee_number": 5, "...": "campos planos como en editar" },
    { "employee_number": 7, "...": "..." }
  ]
}

Errores

400 — validación fallida

Reporte por fila. Ningún empleado del lote fue actualizado.

{
  "message": "Validation failed for 1 employee(s). No employees were updated.",
  "summary": { "total": 2, "with_errors": 1 },
  "errors": [
    {
      "index": 1,
      "employee_number": 99,
      "issues": [
        {
          "field": "employee_number",
          "code": "EMPLOYEE_NOT_FOUND",
          "message": "No employee with number '99' in this organization."
        }
      ]
    }
  ]
}

• index — posición 0-based de la fila que falló dentro del arreglo enviado.
• employee_number — el número de empleado de esa fila, para identificarla sin contar.
• issues[] — todos los problemas de esa fila juntos.

También devuelve 400 (sin errors[] por fila) cuando el cuerpo no es un arreglo, está vacío o excede 100 elementos.

409 — condición de carrera

Otra solicitud concurrente reclamó un RFC o CURP entre la validación y la escritura. La transacción completa hace rollback — ningún empleado es actualizado. Reintenta.

Vocabulario de códigos de error