Pular para o conteúdo principal

Atualizar um colaborador

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

Atualiza um colaborador. O e-mail não pode ser alterado: se enviado, é ignorado.

Envie sempre contract, workSchedule e password. Se forem omitidos, a API grava os valores padrão: o contrato passa a começar na data atual, sem data de desligamento (um colaborador desligado volta a ficar ativo), a jornada volta para 08:00:00 às 17:00:00 e a senha é apagada.

Requer os headers X-Api-Key, User-Agent e Content-Type: application/json. Limite: 1 requisição por segundo (saiba mais).

Requisição​

Parâmetros de caminho

idstringobrigatório

Identificador do colaborador.

Exemplo: MTY0MTU6MjI5MTU=.

Headers

User-Agentstringobrigatório

Identificação da sua aplicação.

Exemplo: MinhaIntegracao/1.0.

Corpo da requisição

JSON, enviado com o header Content-Type: application/json.

namestringobrigatório

Nome do colaborador.

De 4 a 150 caracteres.

passwordstring

Senha de acesso do colaborador ao app. Se omitida, a senha gravada é apagada (null).

Aceita: null.

notesstring

Observações do colaborador.

Até 2000 caracteres.

avatarUrlstring

URL da foto do colaborador.

Aceita: null.

contractobject

Contrato do colaborador. Se omitido, a API grava hiredAt com a data atual e firedAt nulo, inclusive na atualização.

Campos de contract
hiredAtstring (data)

Data de contratação (AAAA-MM-DD).

firedAtstring (data)

Data de desligamento (AAAA-MM-DD). A partir dessa data o colaborador fica inativo.

Aceita: null.

workScheduleobject

Jornada de trabalho, em HH:MM:SS. Se omitida, a API grava das 08:00:00 às 17:00:00 com intervalo das 12:00:00 às 13:00:00, inclusive na atualização.

Campos de workSchedule
startstring

Início da jornada.

Exemplo: 08:00:00.

endstring

Fim da jornada.

Exemplo: 17:00:00.

breakobject

Intervalo.

Campos de break
startstring

Início do intervalo.

Exemplo: 12:00:00.

endstring

Fim do intervalo.

Exemplo: 13:00:00.

Respostas

  • 200

    Colaborador atualizado.

  • 401

    Chave de API ausente (Missing API Key) ou inválida (Invalid API Key). Ver Autenticação.

  • 403

    Conta bloqueada (Account blocked), expirada (Account expired) ou com plano que não permite integração (Account plan not allowed). Ver Autenticação.

  • 404

    Recurso não encontrado. O corpo da resposta é vazio.

  • 422

    Corpo inválido (resourceValidationErr). Um identificador inválido ou de outra conta na URL também retorna este erro, com property: '@.id'.

  • 429

    Limite de 1 requisição por segundo excedido. Ver Limite de requisições.

  • 500

    Erro inesperado no servidor.