✏️ Atualizar Funcionário

📖 Descrição

Atualiza um funcionário existente.

🔄 Atualizações de Document (CPF)

Dependência do identify_key da empresa:

✅ Se empresa usa DOCUMENT como chave:

Campo document é obrigatório, NÃO pode ser NULL

Possível alterar para outro CPF válido (respeitando unicidade)

// ✅ Válido - alterar CPF
{
  "document": "98765432100"  // Novo CPF válido
}

// ❌ Inválido - tentar limpar CPF
{
  "document": null  // Será rejeitado
}

🔄 Se empresa usa EMAIL/PHONE como chave:

Campo document é opcional (nullable)

Porém, update() ignora valores nulos - campo NÃO será atualizado para NULL

// ⚠️ Será ignorado (não atualiza para NULL)
{
  "document": null  // Sistema ignora este valor
}

// ✅ Válido - alterar CPF
{
  "document": "98765432100"  // CPF será atualizado
}

🔄 Diferenças do POST

Campo	POST	PUT
`include_campaign`	Obrigatório	Opcional
`remove_campaign`	Não existe	Obrigatório

🎯 Gestão de Campanhas

{
  "remove_campaign": false,  // Mantém nas campanhas atuais
  // OU
  "remove_campaign": true    // Remove de todas campanhas
}

⚠️ Importante: include_campaign e remove_campaign são mutuamente excludentes.

🏁 Firing Date vs Soft Delete

📅 firing_date - Desligamento com Histórico

Para: Desligamento mantendo funcionário no sistema

Permite datas retroativas (data real do desligamento)

Funcionário permanece ativo para pesquisas de offboarding

Entrevistas de desligamento ainda possíveis

EmployeeObserver dispara soft delete automático

{
  "firing_date": "15/11/2024",  // Data real (pode ser passada)
  "is_voluntary_firing": false,  // Obrigatório quando firing_date preenchido
  "reason_firing": "Reestruturação",
  "remove_campaign": true  // Se quiser remover de campanhas
}

Resultado: Funcionário é soft-deleted automaticamente mas NÃO é removido de campanhas (exceto se remove_campaign: true)

🗑️ DELETE - Remoção Definitiva

Para: Remoção completa do sistema

Soft delete imediato

Some das consultas normais

Remove de campanhas automaticamente

Apaga fields/relacionamentos

Histórico preservado no banco

🔄 Processo Completo de Desligamento

// 1. Primeiro: registrar desligamento
PUT /v1/employees/{id}
{
  "firing_date": "31/12/2024",
  "is_voluntary_firing": true,
  "reason_firing": "Pedido de demissão",
  "remove_campaign": true,
  "fields": [
    {"id": "uuid-status", "value": "Desligado"}
  ]
}

// 2. Depois: exclusão definitiva (opcional)
DELETE /v1/employees/{id}

🔗 Links Relacionados

Excluir Funcionário - Para remoção definitiva

Listar Empresas - Para verificar identify_key

Visualizar Funcionário

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Atualização simples de dadosMudança de departamentoColocar em licençaProcesso de desligamento

{
    "name": "João Silva Santos",
    "email": "joao.santos@empresa.com",
    "phone": "11999888777",
    "remove_campaign": false,
    "is_on_leave": false,
    "id_leader_key": "98765432108"
}

Exemplos de Requisição

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

✅ Funcionário atualizado com sucesso

Body

Exemplo

{
    "id": "not-found-uuid",
    "status": 404,
    "title": "Not Found",
    "detail": "Funcionário não encontrado"
}

📖 Descrição#

🔄 Atualizações de Document (CPF)#

✅ Se empresa usa DOCUMENT como chave:#

🔄 Se empresa usa EMAIL/PHONE como chave:#

🔄 Diferenças do POST#

🎯 Gestão de Campanhas#

🏁 Firing Date vs Soft Delete#

📅 firing_date - Desligamento com Histórico#

🗑️ DELETE - Remoção Definitiva#

🔄 Processo Completo de Desligamento#

🔗 Links Relacionados#