Desligar e avisar os sistemas

Quando alguém sai, três coisas precisam acontecer: o desligamento entra na TAI (para ponto, folha e eSocial tratarem o fim do contrato), o acesso da pessoa é bloqueado, e os outros sistemas — e-mail, VPN, ERP, crachá — ficam sabendo. Esta jornada cobre o desligamento vindo do seu sistema e o aviso que a TAI manda quando ele fica efetivo.

Quando usar	O desligamento é decidido no ERP ou na folha externa; o sistema de acessos precisa saber de quem sai
Porta	REST · Webhook
Você vai precisar	Módulo PESSOAS; permissão COLABORADOR com edição. Para o webhook: acesso a Processos › Central de Automações (dono da conta ou administrador)

Como funciona

seu sistema ──► POST /colaborador/{id}/desligar  (data e motivo)
                    │
        data de hoje ou passada ─► efetivo na hora
        data futura ─► agendado ─► rotina diária efetiva na data
                    │
                    ▼
        usuário bloqueado + evento "Colaborador desligado"
                    │
                    ▼
        webhook assinando COLABORADOR_DESLIGADO ─► sistema de acessos

Passo a passo

1. Desligue o colaborador com a data e o motivo.

   curl -X POST https://api.taitecnologia.com/colaborador/1043/desligar \
     -H "Authorization: Bearer $TAI_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "dataDesligamento": "2026-10-31",
       "motivoDesligamento": "PEDIDO_DEMISSAO",
       "observacao": "Aviso prévio trabalhado"
     }'

   motivoDesligamento aceita DEMISSAO_SEM_JUSTA_CAUSA, DEMISSAO_COM_JUSTA_CAUSA, PEDIDO_DEMISSAO, ACORDO_MUTUO, TERMINO_CONTRATO, APOSENTADORIA, FALECIMENTO, TRANSFERENCIA_EMPRESA e OUTRO.

2. Confira o resultado na resposta, que traz o colaborador:

   Data enviada	O que acontece
   Hoje ou passada	desligado: true na hora; o usuário da pessoa é bloqueado e sai o evento Colaborador desligado
   Futura	Fica agendado: dataDesligamento preenchida e desligado: false. Na data, a rotina Desligamentos agendados efetiva, bloqueia o usuário e publica o evento

3. Se foi engano, desfaça. Vale para o desligamento efetivo e para o agendado; o usuário volta a entrar.

   POST /colaborador/1043/reverter-desligamento

Os desligados saem de GET /colaborador/page e passam a aparecer em GET /colaborador/desligados/page, com o histórico preservado.

Automatize

O que a TAI já faz sozinha. A rotina Desligamentos agendados (rh-processar-desligamentos) roda todo dia e começa ligada. Desligada em Processos › Central de Automações › Rotinas dos módulos, os desligamentos com data futura não ficam efetivos até alguém religá-la.

Modelo pronto “Desligamento organizado”. Em Processos › Central de Automações › Modelos prontos, ele cria o fluxo Desligamento e uma automação que, a cada desligamento efetivo, abre um card nesse fluxo (com o colaborador, o gestor e a data) e avisa o gestor imediato. A automação nasce desligada: revise e ligue.

Avisar o sistema de acessos. Crie um webhook em Processos › Central de Automações › Webhooks com o endereço do seu sistema e marque Um colaborador é desligado (COLABORADOR_DESLIGADO). A cada desligamento efetivo chega, assinado:

{
  "id": "evt_52310",
  "tipo": "COLABORADOR_DESLIGADO",
  "descricao": "Um colaborador é desligado",
  "versao": 1,
  "ocorridoEm": "2026-10-31T03:10:07.512Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "colaboradorId": 1043,
    "colaboradorNome": "Ana Ribeiro",
    "gestorId": 1544,
    "dataDesligamento": "2026-10-31"
  }
}

dataDesligamento sai como yyyy-MM-dd. Com o colaboradorId, o seu sistema lê o cadastro completo em GET /colaborador/{id} — o e-mail corporativo, a matrícula em codigoFuncionario — para saber quais contas fechar; ou marque Enviar também o registro completo no webhook e receba a ficha junto, em registro.

Para abrir um chamado no service desk de TI ou avisar um canal, no formato deles, use um fluxo automatizado com o evento Um colaborador é desligado e o bloco Chamar outro sistema — veja Da TAI para o seu sistema.

Pelo seu agente de IA

“Quem foi desligado este mês?” é uma leitura que o agente conectado por MCP responde. Desligar não: é uma ação de confirmação forte, que o MCP recusa com STRONG_CONFIRMATION_REQUIRED — ela se faz na plataforma, pela Tali, ou pela API REST com o usuário de integração. Veja Escrita e segurança.

Cuidados

• Desligue pela rota /desligar, não por PATCH com desligado: true: o PATCH não bloqueia o usuário nem publica o evento.
• Desligar não é excluir. DELETE /colaborador/{id} é para cadastro feito por engano; o desligado continua existindo para ponto, folha e eSocial.
• Enquanto o desligamento está agendado, chamar /desligar de novo troca a data e o motivo. Depois de efetivo, responde 400 (“Colaborador já está desligado”).
• Reverter não publica evento. Se o seu sistema de acessos já fechou as contas, reabra-as pelo seu lado.
• O evento sai uma vez por desligamento efetivo. Com o seu sistema fora, a TAI tenta de novo por cerca de 21 horas; para quedas mais longas, rode uma conciliação com GET /colaborador/desligados/page — veja a reconciliação.
• Gestor desligado deixa a equipe sem responsável naquele nível: aponte o substituto na estrutura.