Saltar al contenido principal

Actualizar un colaborador

PUThttps://carchost.fieldcontrol.com.br/employees/{id}

Actualiza un colaborador. El correo electrónico no se puede cambiar: si se envía, se ignora.

Envíe siempre contract, workSchedule y password. Si se omiten, la API guarda los valores predeterminados: el contrato pasa a comenzar en la fecha actual, sin fecha de desvinculación (un colaborador desvinculado vuelve a quedar activo), la jornada vuelve a 08:00:00 a 17:00:00 y la contraseña se borra.

Requiere los headers X-Api-Key, User-Agent y Content-Type: application/json. Límite: 1 solicitud por segundo (más información).

Solicitud​

Parámetros de ruta

idstringobligatorio

Identificador del colaborador.

Ejemplo: MTY0MTU6MjI5MTU=.

Headers

User-Agentstringobligatorio

Identificación de su aplicación.

Ejemplo: MinhaIntegracao/1.0.

Cuerpo de la solicitud

JSON, enviado con el header Content-Type: application/json.

namestringobligatorio

Nombre del colaborador.

De 4 a 150 caracteres.

passwordstring

Contraseña de acceso del colaborador a la app. Si se omite, la contraseña guardada se borra (null).

Acepta: null.

notesstring

Observaciones del colaborador.

Hasta 2000 caracteres.

avatarUrlstring

URL de la foto del colaborador.

Acepta: null.

contractobject

Contrato del colaborador. Si se omite, la API guarda hiredAt con la fecha actual y firedAt nulo, incluso en la actualización.

Campos de contract
hiredAtstring (fecha)

Fecha de contratación (AAAA-MM-DD).

firedAtstring (fecha)

Fecha de desvinculación (AAAA-MM-DD). A partir de esa fecha el colaborador queda inactivo.

Acepta: null.

workScheduleobject

Jornada de trabajo, en HH:MM:SS. Si se omite, la API guarda de 08:00:00 a 17:00:00 con descanso de 12:00:00 a 13:00:00, incluso en la actualización.

Campos de workSchedule
startstring

Inicio de la jornada.

Ejemplo: 08:00:00.

endstring

Fin de la jornada.

Ejemplo: 17:00:00.

breakobject

Descanso.

Campos de break
startstring

Inicio del descanso.

Ejemplo: 12:00:00.

endstring

Fin del descanso.

Ejemplo: 13:00:00.

Respuestas

  • 200

    Colaborador actualizado.

  • 401

    Clave de API ausente (Missing API Key) o inválida (Invalid API Key). Consulte Autenticación.

  • 403

    Cuenta bloqueada (Account blocked), vencida (Account expired) o con un plan que no permite integración (Account plan not allowed). Consulte Autenticación.

  • 404

    Recurso no encontrado. El cuerpo de la respuesta está vacío.

  • 422

    Cuerpo inválido (resourceValidationErr). Un identificador inválido o de otra cuenta en la URL también devuelve este error, con property: '@.id'.

  • 429

    Se superó el límite de 1 solicitud por segundo. Consulte Límite de solicitudes.

  • 500

    Error inesperado en el servidor.