Acompanhar a admissão e baixar documentos

O RH conduz a admissão na TAI, mas o seu sistema precisa saber em que pé ela está — e, no fim, guardar os documentos que a pessoa enviou (RG, CPF, comprovante de residência, CTPS…) no seu GED, no sistema de folha ou no dossiê do funcionário.

Quando usar	Painel de admissões no seu sistema; cópia dos documentos para outro repositório
Porta	REST · Webhook · Agente (MCP) para consultas
Você vai precisar	módulo CONTRATACOES; permissão ADMISSAO (leitura basta); JWT de um usuário de integração

Como funciona

seu sistema ──► GET /admissao/processo/{id}                 situação e contadores
            ──► GET /admissao/processo/{id}/documentos      checklist, status de cada item
            ──► GET /admissao/processo/{id}/documento/{documentoId}/arquivo   bytes do arquivo
            ──► GET /admissao/processo/{id}/dados-cadastrais o que a pessoa preencheu

Passo a passo

1. Liste os processos. Paginado, com busca, ou filtrado por situação:

   curl "https://api.taitecnologia.com/admissao/processo/por-status/EM_ANALISE/page?page=0&size=50" \
     -H "Authorization: Bearer $TAI_TOKEN"

   GET /admissao/processo/page?search=… busca pelo nome e e-mail de quem foi convidado e pelas observações. Para os contadores do painel (quantos em cada situação), use GET /admissao/processo/estatisticas.

2. Leia um processo. GET /admissao/processo/{id} traz status, nomePessoa, emailPessoa, dataAdmissaoPrevista, dataExpiracaoToken, totalDocumentos, documentosEnviados, documentosAprovados, documentosRejeitados, percentualConclusao e dadosPreenchidos (se a pessoa já preencheu o passo de dados).

3. Liste os documentos.

   curl https://api.taitecnologia.com/admissao/processo/311/documentos \
     -H "Authorization: Bearer $TAI_TOKEN"

   Cada item traz id, nome, tipoDocumentoGed (RG, CPF, CTPS, COMPROVANTE_RESIDENCIA…), obrigatorio, status (PENDENTE, ENVIADO, EM_ANALISE, APROVADO, REJEITADO), dataEnvio, dataAprovacao, motivoRejeicao e gedDocumento (o documento guardado no GED).

4. Baixe os arquivos. Para cada item com arquivo — normalmente os APROVADO:

   curl https://api.taitecnologia.com/admissao/processo/311/documento/5120/arquivo \
     -H "Authorization: Bearer $TAI_TOKEN" \
     -o rg-bruno-lima.pdf

   A resposta é o arquivo, com o Content-Type dele (PDF ou imagem). O nome do arquivo não vem no cabeçalho: monte o seu a partir de tipoDocumentoGed e do processo.

5. Leve o cadastro, se precisar. GET /admissao/processo/{id}/dados-cadastrais devolve os dados pessoais, o endereço estruturado, os documentos (PIS, CTPS, título, CNH, reservista) e os contatos de emergência que a pessoa informou. Volta vazio enquanto ela não preencher.

Documentos que a empresa manda assinar

Contrato de trabalho, termo de benefícios e políticas que o RH envia para o admitido assinar são outra lista: GET /admissao/processo/{id}/assinaturas traz cada um com status (ANEXADO, AGUARDANDO_ASSINATURA, PARCIALMENTE_ASSINADO, ASSINADO, RECUSADO, CANCELADO, EXPIRADO) e os signatários. O arquivo sai em GET /admissao/processo/{id}/assinaturas/{documentoId}/arquivo.

Depois da finalização

Quando o RH finaliza a admissão, os documentos passam a pertencer ao colaborador no GED e aparecem na aba Documentos do perfil dele. A partir daí, leia-os como documentos do colaborador — veja Documentos.

Automatize

Em vez de consultar todos os processos o tempo todo:

• Guarde o id de cada processo que o seu sistema iniciou e consulte só os que ainda não terminaram. O acompanhamento encerra com a finalização (evento abaixo) ou com o processo CANCELADO; um EXPIRADO volta para AGUARDANDO_DOCUMENTOS se o RH renovar o link.

• Receba cada passo por webhook. Crie um webhook que assine os eventos da admissão — ou Tudo de Contratações — e baixe o arquivo na hora em que ele fica pronto:

  Evento	O que fazer
  Um documento da admissão é aprovado (ADMISSAO_DOCUMENTO_APROVADO)	Baixar aquele documento (documentoId)
  Um documento da admissão é rejeitado (ADMISSAO_DOCUMENTO_REJEITADO)	Descartar a versão anterior; o motivo vem junto
  Uma admissão é concluída (ADMISSAO_CONCLUIDA)	Fechar o dossiê com o colaboradorId criado
  O prazo de uma admissão vence (ADMISSAO_EXPIRADA)	Avisar quem acompanha a contratação
  Uma admissão é cancelada (ADMISSAO_CANCELADA)	Encerrar o acompanhamento

  {
    "id": "evt_55310",
    "tipo": "ADMISSAO_DOCUMENTO_APROVADO",
    "descricao": "Um documento da admissão é aprovado",
    "versao": 1,
    "ocorridoEm": "2026-10-09T18:12:05.730Z",
    "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
    "dados": {
      "processoId": 311,
      "candidaturaId": 9412,
      "vagaId": 128,
      "nomePessoa": "Bruno Lima",
      "documentoId": 5120,
      "documentoNome": "RG"
    }
  }

  Com o processoId e o documentoId, baixe o arquivo pela rota do passo 4.

Pelo seu agente de IA

“Quais admissões estão esperando documentos há mais de uma semana?”

Leitura livre: o agente lista os processos e os documentos pendentes de cada um, com as mesmas permissões da pessoa que o conectou. Para copiar os arquivos para outro sistema, use a API REST.

Cuidados

• Documentos são dados pessoais. Dê ao usuário de integração só a permissão ADMISSAO em leitura e guarde os arquivos com o mesmo cuidado no seu lado.
• Item REJEITADO não é o documento final: a pessoa vai reenviar. Baixe depois de APROVADO.
• GET /admissao/processo/{id}/documentos e o download pedem o processo da mesma conta do token; id de outra conta responde como inexistente.
• Datas na resposta em horário de Brasília — veja Datas e formatos.