Actualizar el identificador externo de un empleado

Este endpoint permite cambiar el identificador externo de un empleado (employeeId).

PUT /api/v1/businesses/{businessId}/employees/{employeeId}/new-employee-id/{newEmployeeId}

Además del identificador externo del negocio (businessId), en la URL se debe especificar el identificador actual del empleado (employeeId) y el nuevo (newEmployeeId). La petición no incluye cuerpo ni parámetros de consulta (query params).

Ejemplo de la petición

PUT /api/v1/businesses/BUSINESSID/employees/CURRENTID/new-employee-id/NEWID

Si la petición se realiza correctamente, la respuesta será 204 No Content.

El employeeId es la clave utilizada para referenciar empleados: tras realizar este cambio, las integraciones deben utilizar el nuevo employeeId.

Aspectos que tener en cuenta

Si el empleado actual employeeId indicado no existe, la petición devolverá un error 404 Not Found, con el mensaje Person does not exist.

Si el newEmployeeId indicado ya está en uso en el negocio, la petición devolverá un error 409 Conflict, con el mensaje Employee already exists in business.

Enlaces de interés

¿Qué es un empleado?