​

📡 Monitoramento de Processos

​

🧠 Como funciona

​

🕐 Periodicidades disponíveis

Nenhuma periodicidade executa nos finais de semana.

​

🔍 Busca de processos

• CPF — processos onde o CPF aparece como parte
• CNPJ — processos onde o CNPJ aparece como parte
• CNPJ_RAIZ — processos onde qualquer CNPJ com a mesma raiz aparece como parte

​

📬 Entrega de resultados

[
  {
    "mensagemId": "abc123",
    "recibo": "AQEBwJnK...",
    "conteudo": {
      "termoId": "uuid-do-termo",
      "tipoTermo": "CPF",
      "valorTermo": "12345678901",
      "periodicidade": "DIARIO",
      "dataBuscaDe": "2026-03-29",
      "dataBuscaAte": "2026-04-05",
      "resultados": [
        { "...detalhes do processo..." }
      ]
    }
  }
]

Se não houver novos processos no período, nenhuma mensagem é enviada.

​

🔄 Fluxo recomendado de integração

1. Autenticar (POST /auth)
         |
2. Cadastrar termos (POST /monitoramento/termos)
         |
         |--- busca imediata em background
         |
3. Polling periódico:
   |
   |--- GET /monitoramento/mensagens?limite=10
   |         |
   |         |--- processar cada mensagem
   |         |
   |         |--- POST /monitoramento/mensagens/confirmarRecebimento
   |
   |--- repetir (sugerido: a cada 5-15 minutos)

• Faça polling a cada 5 a 15 minutos para receber mensagens
• Sempre confirme o recebimento após processar a mensagem
• Se a confirmação falhar, a mensagem voltará à fila em 30 segundos — não há perda de dados
• Cada requisição de recebimento retorna no máximo 10 mensagens. Se houver mais, faça múltiplas chamadas até receber uma resposta vazia

​

🛡️ Tolerância a falhas

• Retentativas automáticas — se uma busca falhar (ex: timeout, indisponibilidade temporária), o sistema retenta com intervalos progressivos: 5 min, 15 min, 1 hora, 6 horas
• Máximo de tentativas — 5 tentativas por termo por execução. Após isso, o termo é processado normalmente na próxima execução
• Mensagens grandes — resultados que excedam 256 KB são automaticamente armazenados e entregues sem perda de dados
• Isolamento por cliente — cada cliente possui sua própria fila de mensagens, garantindo total isolamento dos dados

​

💰 Faturamento

• Foi criado antes do fim do mês
• Não foi removido antes do início do mês

Termos criados e removidos dentro do mesmo mês são contabilizados.

​

🚀 Prossiga