Registrar incidentes e acompanhar a CAT

Acidentes e quase-acidentes costumam ser relatados onde a operação está — um app de campo, um formulário da portaria, o sistema da medicina do trabalho. Esta jornada leva cada ocorrência para o Registro de Incidentes da TAI, registra a CAT quando ela é emitida e lê os indicadores de segurança para o BI. A TAI cuida de lembrar o prazo da CAT.

Quando usar	Incidentes nascem em outro sistema; o BI ou a diretoria quer taxa de frequência, gravidade e dias sem acidentes
Porta	REST · Webhook
Você vai precisar	Módulo GESTAO_RISCOS; permissão RISCO_INCIDENTE (edição para registrar); RISCO_RELATORIO para o PGR em PDF

Como funciona

app de campo ──► POST /incidentes                 (ocorrência, investigação PENDENTE)
                     │
                     ▼
     rotina "Prazo da CAT" ──► e-mail aos donos da conta (prazo e vencimento)
                     │
medicina do trabalho ──► PATCH /incidentes        (CAT emitida: número e data)
BI ◄── GET /incidentes/estatisticas

Na plataforma, o registro fica em Saúde e Segurança → Riscos → Registro de Incidentes.

Passo a passo

1. Registre o incidente. O colaborador é o envolvido; ache o id dele pelo CPF (GET /colaborador/buscar-por-cpf/{cpf}) ou pela matrícula — veja Sincronizar colaboradores.

   curl -X POST https://api.taitecnologia.com/incidentes \
     -H "Authorization: Bearer $TAI_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "tipo": "ACIDENTE_COM_AFASTAMENTO",
       "gravidade": "MODERADA",
       "dataOcorrencia": "2026-10-02",
       "horaOcorrencia": "14:35",
       "localExato": "Doca 3 do centro de distribuição",
       "descricao": "Queda de caixa da prateleira superior atingiu o ombro do conferente.",
       "atividadeRealizada": "Conferência de carga na expedição",
       "diasAfastamento": 5,
       "colaborador": { "id": 1043 }
     }'

   Guarde o id. A investigação nasce PENDENTE e a CAT, não emitida.

2. Registre a CAT quando ela for emitida.

   PATCH /incidentes
   Content-Type: application/json
   
   { "id": 318, "catEmitida": true, "numeroCat": "2026.123.456789-0/01", "dataCat": "2026-10-03" }

3. Atualize a investigação quando a análise andar: statusInvestigacao (PENDENTE, EM_ANALISE, CONCLUIDA), descricaoInvestigacao e acoesCorretivas, também por PATCH. Ligue o incidente ao risco do inventário com "risco": {"id": …}.

4. Leia os indicadores para o BI.

   GET /incidentes/estatisticas?dataInicio=2026-01-01&dataFim=2026-12-31

   A resposta traz totais por tipo e gravidade, com e sem afastamento, dias de afastamento, taxa de frequência, taxa de gravidade, dias sem acidentes e a tendência mensal.

Campo	Valores
tipo	ACIDENTE_COM_AFASTAMENTO, ACIDENTE_SEM_AFASTAMENTO, DOENCA_OCUPACIONAL, QUASE_ACIDENTE
gravidade	LEVE, MODERADA, GRAVE, GRAVISSIMA, FATAL
horaOcorrencia	HH:mm

O inventário de riscos (/riscos), a matriz 5×5 (GET /matriz-riscos) e o PGR em PDF (GET /incidentes/relatorio/pdf) estão na referência de Saúde e segurança.

Automatize

A rotina Prazo da CAT (sst-prazo-cat) roda a cada hora e começa desligada — ligue em Processos › Central de Automações › Rotinas dos módulos. Para cada acidente ou doença ocupacional sem CAT registrada (quase-acidente não entra), ela avisa os donos da conta por e-mail do prazo — o primeiro dia útil seguinte ao acidente — e avisa de novo se o prazo vencer. Incidentes com mais de 30 dias não entram. Ela nunca emite a CAT: o aviso para quando catEmitida fica true.

Para levar à medicina do trabalho ou ao seu sistema de SST as ocorrências registradas na TAI, assine num webhook:

• Um incidente de trabalho é registrado (INCIDENTE_REGISTRADO) — incidenteId, colaboradorId, dataOcorrencia e catEmitida;
• Uma CAT é registrada (INCIDENTE_CAT_EMITIDA) — incidenteId, colaboradorId, numeroCat e dataCat.

{
  "id": "evt_53640",
  "tipo": "INCIDENTE_REGISTRADO",
  "descricao": "Um incidente de trabalho é registrado",
  "versao": 1,
  "ocorridoEm": "2026-10-02T17:51:30.218Z",
  "empresa": { "id": 12, "nome": "Sua Empresa Ltda" },
  "dados": {
    "incidenteId": 318,
    "colaboradorId": 1043,
    "dataOcorrencia": "2026-10-02",
    "catEmitida": false
  }
}

O evento leva só ids e datas; tipo, gravidade e descrição vêm em GET /incidentes/{id} ou no registro, com Enviar também o registro completo. Para cobrar a CAT de alguém com prazo e responsável, um fluxo de Processos pode ouvir Um incidente de trabalho é registrado e abrir um card — veja Da TAI para o seu sistema.

Pelo seu agente de IA

“Quantos acidentes com afastamento tivemos este ano e quantos ainda estão sem CAT?” é uma leitura que o agente conectado por MCP responde. Registrar o incidente é uma escrita: exige credencial com escopo de escrita e a sua aprovação no cliente de IA.

Cuidados

• Validações do servidor. localExato com 3 caracteres ou mais, descricao com 20 ou mais, atividadeRealizada com 10 ou mais; diasAfastamento maior que zero em acidente com afastamento e doença ocupacional. Fora disso, 400 com o motivo.
• CAT emitida pede número e data. Marcar catEmitida: true sem numeroCat e dataCat, nos casos que exigem CAT, responde 400.
• Idempotência. Não há chave externa no incidente: guarde o id da TAI ao lado do registro de origem e não reenvie o POST sem conferir.
• dataOcorrencia e dataCat são datas civis: yyyy-MM-dd (datas e formatos).