Atualiza dados do colaborador (parcial — só campos enviados)
Atualiza qualquer campo de um colaborador (dados pessoais, vínculo organizacional, configurações de turno, alocação, complemento, foto). Endpoint unificado que substitui os antigos PATCH /dados, /acesso, /alocacao, /complemento, /preferencia, /foto, /definicoes (todos deprecated).
Comportamento PATCH: só os campos enviados são alterados — campos omitidos ficam intactos. Não é PUT, não substitui o objeto inteiro.
Casos de uso comuns:
- Promoção: alterar
cargoIdmantendo o resto - Mudança de departamento:
departamentoId+equipeId - Atualizar contato:
email,telefone - Mudar foto:
fotoem base64 ou URL S3 pré-assinada - Reconfigurar turno:
turnoId(impacta jornada a partir da data informada)
Cuidados:
- Mudança de
departamentoIdpode afetar gestores que veem aquele colaborador na inbox de aprovação de ajustes. - Mudança de
turnoIdretroativa pode recalcular frequências passadas. - Para mudança de status (ATIVO/DEMITIDO/etc.), use
PATCH /:id/status— endpoint específico com auditoria especial.
Audit: toda alteração fica em log auditável vinculado ao usuário do token.
Path Parameters
Id do colaborador
Body
Campos a atualizar (todos opcionais; envie só os que mudarem)
Identificação se será um Colaborador CLT ou Prestador de Serviço
CLT, PRESTADOR_SERVICO CPF ou CNPJ
"71055398712"
Nome ou razão social
"Douglas Vitor"
Nome completo do colaborador
"Douglas Fernandez Coelho"
Data de nascimento
"2026-05-11T13:08:56.492Z"
Estado civil
SOLTEIRO, CASADO, SEPARADO, DIVORCIADO, VIUVO Genero
MASCULINO, FEMININO, OUTRO Nome fantasia
"STW Tecnologia"
Inscrição estadual
"123456789"
Inscrição estadual está isenta?
Inscrição municipal
"987654321"
Inscrição municipal está isenta?
Número do tipo de vínculo previdenciário do empregado (NIS, PIS, etc)
"N586692225"
Matrícula do eSocial
"Douglas Vitor"
Matrícula interna da empresa
"49172594718"
Email do empregado
"douglas@pontua.com.br"
Número do telefone celular do empregado
"62993610391"
Endereço do empregado
Tipo de vínculo
CLT, APRENDIZ, ESTAGIO, AUTONOMO, INTERMITENTE, OUTROS Se o empregado terá adicional de Insalubridade
false
Selecionar o grau de Insalubridade
GRAU_MINIMO_10, GRAU_MEDIO_20, GRAU_MAXIMO_40 Se o empregado terá adicional de Insalubridade
false
ID referente ao cargo
"b5887a64-6aa1-43e8-b233-ffadc7f92ca6"
ID referente ao departamento
"c9f447fe-f97f-4f24-974d-9f92eb3049dc"
ID referente à equipe
"f029e9b4-5943-4650-bb67-8c6f19d78345"
Salário do empregado
7400
Tipo de remuneração do empregado
SALARIO_FIXO, POR_HORA, DIARIAS, PRESTACAO_SERVICO Fuso horário
MANAUS, NORONHA, RIO_BRANCO, SAO_PAULO ID referente ao local de trabalho
"f029e9b4-5943-4650-bb67-8c6f19d78345"
ID referente ao centro de custo
"b5887a64-6aa1-43e8-b233-ffadc7f92ca6"
Data de admissão do colaborador
"2023-11-20T00:00:00.000Z"
Data de inicio do colaborador
"2023-11-20T00:00:00.000Z"
ID referente ao calendário de trabalho da empresa, onde colocorá o colaborador
"b5887a64-6aa1-43e8-b233-ffadc7f92ca6"
ID referente ao turno, onde colocorá o colaborador
"b5887a64-6aa1-43e8-b233-ffadc7f92ca6"
Base64 da foto do colaborador
ID da batida de ponto que o colaborador terá
"b5887a64-6aa1-43e8-b233-ffadc7f92ca6"
ID referente a regra de ponto atribuida ao empregado
"b5887a64-6aa1-43e8-b233-ffadc7f92ca6"
Status sobre o uso das configurações padrões estabelecidas
true
Liberar acesso ao sistema ao colaborador
true
Enviar acesso ao sistema por EMAIL ao colaborador
true
Enviar acesso ao sistema por SMS ao colaborador
true
Solicitar cadastro da Facial ao colaborador
true
Flag para identificar se é um rascunho
false
Etapa de cadastro do colaborador
DADOS, COMPLEMENTO, ALOCACAO, PREFERENCIA, DEFINICOES, ACESSO, CONCLUIDO