Exclui colaborador (soft-delete reversível)
Remove um colaborador da unidade de negócio. Soft-delete — o registro continua no banco para preservar histórico de ponto, folha e fiscalização (Portaria 671 exige retenção de 5 anos).
Comportamento por estado:
- Cadastro incompleto (sem vínculos organizacionais): exclui imediatamente sem precisar de
temCerteza - Cadastro finalizado (com vínculos): exige
?temCerteza=truecomo confirmação explícita. Sem isso, retorna 400 com mensagem instrutiva. Esse “double opt-in” evita exclusões acidentais via integração mal calibrada.
Efeitos:
- Colaborador some de listas filtradas
status=ATIVO(GET /colaborador?status=ATIVO) - Permanece em
GET /colaboradorsem filtro (com statusDEMITIDO) - Frequências e registros de ponto históricos continuam acessíveis em
GET /frequencyeGET /registro-ponto - Folha do mês corrente é recalculada (rescisão proporcional)
Reverter: dentro de janela curta, use PATCH /:id/recuperar (acima) para restaurar o cadastro completo. Após muito tempo, prefira POST /colaborador para recadastrar.
Atenção LGPD: este endpoint não apaga dados pessoais do banco — para “direito ao esquecimento” definitivo, abra ticket em tecnologia@pontua.com.br (anonimização exige procedimento formal de compliance).
Path Parameters
Id do colaborador
"a2f2cbed-e141-465c-a769-f1591be5f35c"
Query Parameters
Quando o colaborador já tem cadastro finalizado (vínculos organizacionais completos), exige true para confirmar. Para cadastros incompletos, é ignorado.
true