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:
| Campo | Para que serve |
|---|---|
| identificador único | Evitar gravar a mesma publicação duas vezes |
| número do processo | Ligar a publicação ao caso do cliente |
| tribunal e órgão | Saber de onde veio e filtrar no painel |
| data de disponibilização | Base para o cálculo do prazo |
| OAB consultada | Saber de qual advogado é a publicação |
| texto | Leitura completa e classificação |
| prioridade | Ordenar o que o advogado vê primeiro |
| lida por / lida em | Registro 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
- Às 6h de cada dia útil, o agendador chama a sua rotina.
- A rotina percorre as OABs cadastradas e consulta a API.
- Cada publicação recebida é comparada com o banco; as novas são gravadas.
- As novas recebem uma classificação de prioridade.
- Cada advogado recebe um resumo com as suas publicações do dia.
- O painel mostra o que ainda não foi lido.
- 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.