Pular para o conteúdo
Escola Ninja WP Blog

API Jurídica · · 6 min de leitura

API de publicações do diário oficial: como receber as intimações do escritório no seu sistema

Por Flávio Henrique, CEO da Escola Ninja WP, à frente da escola desde 2009.

Resumo

Uma API de publicações judiciais consulta as intimações publicadas nos diários oficiais eletrônicos e devolve os dados organizados, por OAB ou por número do processo. A API responde quando é chamada: o sistema do escritório agenda a consulta diária, guarda o que é novo e avisa o advogado responsável. Como o prazo começa a contar a partir da publicação, a rotina precisa rodar todo dia útil.

Para um escritório de advocacia, perder uma intimação é perder um prazo. Por isso a leitura do diário oficial é uma das rotinas mais importantes do dia, e também uma das mais repetitivas. Uma API de publicações judiciais permite trazer essas intimações direto para o sistema do escritório, organizadas por advogado e por processo, prontas para virar tarefa.

Este guia explica como funciona, como montar a rotina diária e o que observar para não deixar nada passar.

Por que as publicações importam tanto

Pelo artigo 272 do Código de Processo Civil, quando a intimação não é feita por meio eletrônico, ela se considera feita pela publicação do ato no órgão oficial. E a Lei nº 11.419/2006, que trata do processo eletrônico, define no artigo 4º como os diários eletrônicos funcionam:

  • considera-se data da publicação o primeiro dia útil seguinte ao da disponibilização da informação no diário eletrônico;
  • os prazos começam a correr no primeiro dia útil seguinte ao da publicação.

Some a isso o artigo 219 do CPC, que manda contar os prazos processuais em dias úteis. Resultado: a rotina de leitura das publicações precisa acontecer todo dia útil, sem falha.

O que uma API de publicações judiciais entrega

A API consulta as bases públicas oficiais onde os tribunais publicam as comunicações processuais e devolve os dados estruturados em JSON. Normalmente você recebe:

  • número do processo, no padrão da numeração única;
  • tribunal e órgão julgador;
  • data de disponibilização;
  • texto da intimação ou da publicação;
  • advogados e OAB mencionados;
  • tipo de comunicação, quando a fonte informa.

Formas de consulta

  • Por OAB: traz tudo o que foi publicado em nome do advogado. É a consulta principal da rotina diária.
  • Por número do processo: útil para conferir um caso específico ou montar o histórico.

A API responde, o seu sistema faz a rotina

Este é o ponto que mais gera confusão. Uma API não fica vigiando os diários e não manda mensagem por conta própria. Ela responde quando o seu sistema pergunta. Toda a inteligência de "consultar todo dia e avisar" fica no sistema que você integra a ela.

Na prática, isso é uma vantagem: você decide o horário, a frequência, quem recebe o aviso e por qual canal.

Como montar a rotina diária de intimações

1. Cadastre as OABs do escritório

Guarde, para cada advogado, o número da OAB com a UF (por exemplo, 123456/SP) e as inscrições suplementares em outros estados. Sem a suplementar, as publicações daquele estado podem ficar de fora.

2. Agende a consulta

Use o agendador do seu servidor (como o cron, no Linux) ou a fila de tarefas do seu sistema para rodar a consulta todo dia útil, de manhã cedo. Se quiser segurança extra, rode uma segunda vez no fim da tarde.

3. Guarde só o que é novo

Cada publicação deve ter um identificador único no seu banco, montado por exemplo com processo, data de disponibilização e um resumo (hash) do texto. Antes de gravar, confira se ela já existe. Isso evita avisos repetidos quando a mesma consulta roda duas vezes.

4. Classifique

Com o texto em mãos, o seu sistema pode marcar palavras como "prazo", "audiência", "sentença" ou "manifeste-se" e dar prioridade a elas. A classificação ajuda, mas não substitui a leitura do advogado.

5. Avise o responsável

Dispare o aviso pelo canal que o escritório usa: e-mail, painel, WhatsApp ou tarefa no software jurídico. O aviso deve trazer o processo, o tribunal, a data de disponibilização e o link para o texto completo.

6. Registre a leitura

Guarde quem leu e quando. Se um prazo for questionado depois, esse registro mostra que a publicação chegou e foi tratada.

Como guardar as publicações no banco

Uma estrutura simples resolve a maior parte dos casos. Sugestão de campos para a tabela de publicações:

CampoPara que serve
identificador únicoEvitar gravar a mesma publicação duas vezes
número do processoLigar a publicação ao caso do cliente
tribunal e órgãoSaber de onde veio e filtrar no painel
data de disponibilizaçãoBase para o cálculo do prazo
OAB consultadaSaber de qual advogado é a publicação
textoLeitura completa e classificação
prioridadeOrdenar o que o advogado vê primeiro
lida por / lida emRegistro de quem tratou e quando

Com essa tabela, o painel do escritório consegue mostrar, por exemplo, "publicações de hoje ainda não lidas", "publicações por advogado" e "processos com publicação nos últimos sete dias".

E as publicações antigas?

Na primeira vez que você cadastra uma OAB, vale fazer uma carga inicial dos últimos dias para o advogado conferir se nada ficou para trás. Depois disso, a rotina diária busca só o período recente. Guardar o histórico também ajuda a montar a linha do tempo de cada processo, que o cliente final costuma valorizar.

Quem pode ver o quê

Num sistema usado por vários escritórios, cada escritório só pode enxergar as suas próprias publicações. Faça esse filtro no servidor, na consulta ao banco, e não só na tela. Se a troca de um identificador na URL mostrar dados de outro escritório, o controle de acesso não existe.

Cuidados para não perder nenhuma intimação

  • Monitore a própria rotina. Se a consulta falhar num dia, alguém precisa saber. Um alerta de "rotina não rodou" vale tanto quanto o aviso de intimação.
  • Trate falhas temporárias. Bases públicas podem ficar lentas. Programe novas tentativas com intervalo, em vez de desistir na primeira.
  • Use servidor no Brasil. Algumas bases recusam acessos de fora do país. Um datacenter brasileiro e um proxy bem configurado evitam bloqueio.
  • Não confie só no nome. Homônimos e grafias diferentes atrapalham. A OAB com UF é o filtro principal.
  • Cuide dos dados. Publicações trazem nomes de partes. A LGPD (Lei nº 13.709/2018) se aplica: restrinja o acesso ao painel e guarde só o necessário.
  • Deixe a responsabilidade clara. A ferramenta organiza, mas o controle do prazo é do advogado. Diga isso ao cliente desde o início.

API de publicações ou serviço de recorte pronto?

Os serviços de recorte de publicações entregam a lista pronta, geralmente por assinatura e muitas vezes por advogado acompanhado. Uma API própria exige integração, mas permite que o seu sistema faça exatamente o que o escritório precisa, sem custo por OAB ou por consulta. Para quem desenvolve para vários escritórios, a diferença na margem é grande. Fizemos essa conta em detalhe no artigo API jurídica com código-fonte: quanto custa ter a sua.

Exemplo de fluxo completo

  1. Às 6h de cada dia útil, o agendador chama a sua rotina.
  2. A rotina percorre as OABs cadastradas e consulta a API.
  3. Cada publicação recebida é comparada com o banco; as novas são gravadas.
  4. As novas recebem uma classificação de prioridade.
  5. Cada advogado recebe um resumo com as suas publicações do dia.
  6. O painel mostra o que ainda não foi lido.
  7. Se a rotina não terminar até um horário limite, o responsável técnico é avisado.

Conclusão

Uma API de publicações judiciais tira a leitura do diário oficial do trabalho manual e coloca as intimações dentro do sistema do escritório. O segredo não está só na API, mas na rotina em volta dela: consulta todo dia útil, controle do que é novo, aviso ao responsável e alerta quando algo falha. Montada assim, ela reduz o risco de perder prazo e libera tempo da equipe para o que importa.

Perguntas frequentes

O que é uma API de publicações judiciais?

É um serviço que o seu sistema consulta para buscar as intimações e publicações dos diários oficiais eletrônicos dos tribunais, filtradas por número da OAB ou por número do processo, e recebê-las em formato estruturado.

A API de publicações avisa sozinha quando sai uma intimação?

Não. A API responde quando é chamada. O sistema do escritório precisa agendar a consulta, por exemplo todo dia útil de manhã, comparar com o que já foi recebido e então avisar o advogado.

A partir de quando conta o prazo de uma intimação publicada no diário eletrônico?

Pela Lei nº 11.419/2006, considera-se data da publicação o primeiro dia útil seguinte ao da disponibilização no diário eletrônico, e o prazo começa no primeiro dia útil seguinte ao da publicação. Pelo CPC, os prazos processuais contam em dias úteis. A conferência final do prazo é sempre do advogado.

Dá para buscar publicações pelo nome do advogado?

A forma mais confiável é pelo número da OAB com a UF, porque nomes se repetem e aparecem escritos de formas diferentes. O nome pode servir como filtro complementar.

Preciso de um servidor no Brasil para consultar publicações?

É o recomendado. Algumas bases públicas recusam acessos vindos de fora do país. Um servidor com datacenter no Brasil evita bloqueios.

Leia também