O que sincronizar e o que manter no jurídico ao integrar publicações judiciais
Aprenda a decidir quais dados de uma publicação judicial devem chegar ao ERP ou CRM e quais precisam permanecer no repositório jurídico.
Conheça boas práticas para estruturar seu fluxo
Neste artigo9 seções
- Por que sincronizar publicações judiciais ao ERP ou CRM exige mais do que uma API
- Como dividir responsabilidades entre o ERP, o CRM e o sistema jurídico
- Matriz prática: o que sincronizar e o que manter no jurídico
- Como projetar a sincronização de publicações judiciais sem duplicar trabalho
- Payload mínimo, idempotência e novas tentativas: a parte técnica que evita tarefas repetidas
- Dois cenários de integração: varejo e escritório com correspondentes
- Como controlar inconsistências, segurança e reconciliação dos dados
- Checklist para começar sem interromper a operação
- A regra central: sincronize a ação, preserve a evidência
Por que sincronizar publicações judiciais ao ERP ou CRM exige mais do que uma API
Sincronizar publicações judiciais ao ERP ou CRM não significa copiar tudo de um sistema para outro. O objetivo é levar ao fluxo operacional apenas o que exige ação, preservando documentos, contexto processual e histórico no ambiente jurídico que consegue tratá-los com mais profundidade.
Quando essa fronteira não é definida, surgem dois problemas opostos. O ERP fica cheio de textos, anexos e movimentações que ninguém consulta, enquanto o sistema jurídico continua dependendo de planilhas e digitação manual para criar tarefas e controlar prazos.
Uma publicação pode conter identificação do processo, órgão julgador, partes, data de disponibilização, data de publicação, teor, documento associado, prazo sugerido e indicação de urgência. Cada campo tem uma finalidade diferente, portanto não deve ser enviado automaticamente para todos os sistemas.
Um departamento jurídico de varejo, por exemplo, talvez precise apenas de uma tarefa com responsável, prazo, prioridade e número do processo no ERP corporativo. O documento integral, o histórico de movimentações e os comentários da equipe podem permanecer no repositório jurídico, acessíveis por um link seguro.
Antes de escolher endpoints ou definir o formato do webhook, vale mapear o fluxo humano. O que acontece depois que uma publicação chega? Quem valida o prazo? Onde a atividade é executada? Qual sistema será consultado em uma auditoria? As respostas determinam o que deve ser sincronizado.
Como dividir responsabilidades entre o ERP, o CRM e o sistema jurídico
A divisão mais segura costuma seguir três camadas: fonte, execução e evidência. O sistema de monitoramento ou repositório jurídico captura e organiza a publicação; o ERP ou CRM distribui a tarefa e acompanha a operação; o documento original e o histórico detalhado continuam preservados na fonte especializada.
O ERP é adequado para dados que precisam conversar com outras áreas. Centro de custo, unidade de negócio, contrato, cliente, fornecedor, responsável interno e status da atividade são exemplos de informações que podem conectar o contencioso ao planejamento corporativo.
O sistema jurídico deve continuar sendo a referência para o conteúdo da publicação. Isso inclui o texto integral, documentos baixados, capa processual, histórico de movimentações, validações, comentários jurídicos e evidências de quando a informação foi capturada e disponibilizada.
Essa abordagem evita transformar o CRM em um segundo repositório de processos. Também reduz o risco de alguém editar uma cópia antiga do documento no ERP e tratá-la como se fosse a versão oficial.
Para aprofundar a escolha entre eventos, consultas periódicas e sincronização híbrida, consulte o guia sobre arquitetura de integração de publicações judiciais com ERP e CRM. A decisão deve considerar volume, criticidade dos prazos, disponibilidade do fornecedor e capacidade de reconciliação.
A integração também precisa respeitar a finalidade e a necessidade de cada dado pessoal. A Lei Geral de Proteção de Dados Pessoais é uma referência essencial para revisar acesso, retenção, compartilhamento e segurança das informações processuais.
Matriz prática: o que sincronizar e o que manter no jurídico
- ✓Identificador externo da publicação: sincronize. Ele permite rastrear o evento original, impedir duplicidades e localizar a informação no sistema jurídico.
- ✓Número CNJ do processo: sincronize. É a chave mais útil para relacionar a tarefa a um caso existente, mas valide formatação e instância antes de criar um novo registro.
- ✓Tribunal, comarca, vara e órgão julgador: sincronize como metadados. Esses campos ajudam na distribuição, nos relatórios e na conferência da origem.
- ✓Data de disponibilização e data de publicação: sincronize. Não substitua uma pela outra, pois a equipe pode precisar comprovar quando a informação foi disponibilizada e publicada.
- ✓Prazo sugerido, prazo final calculado e tipo de prazo: sincronize com status de validação. O cálculo automático deve orientar o trabalho, mas não eliminar a revisão responsável quando o teor exigir interpretação.
- ✓Prioridade, urgência e ação recomendada: sincronize. Esses campos transformam uma publicação em trabalho executável e permitem ordenar a fila do ERP ou CRM.
- ✓Responsável, equipe, unidade e correspondente: sincronize quando houver regra confiável de distribuição. Se a atribuição depender da leitura do documento, mantenha o evento como pendente de triagem.
- ✓Resumo da publicação: sincronize de forma resumida e identificável. Inclua a indicação de que o resumo pode exigir validação humana, especialmente em decisões com impacto processual.
- ✓Texto integral da publicação: mantenha no sistema jurídico e envie, no máximo, um trecho controlado ou um link seguro. Replicar o conteúdo aumenta volume, exposição e risco de versões divergentes.
- ✓PDF, documentos, capas e anexos: mantenha no repositório jurídico. O ERP pode armazenar o endereço seguro, o identificador do arquivo e a data de captura, sem duplicar o binário.
- ✓Histórico completo de movimentações: mantenha no sistema jurídico. No ERP, sincronize apenas a movimentação que originou a tarefa ou um resumo operacional.
- ✓Comentários, decisões internas e justificativas: mantenha no ambiente jurídico colaborativo, salvo quando uma informação específica precisar alimentar uma aprovação corporativa.
- ✓Dados financeiros e centros de custo: sincronize quando forem necessários ao processo corporativo. Eles normalmente pertencem ao ERP, não à publicação judicial.
- ✓Versão do evento, data de atualização e origem: sincronize sempre. Esses campos são fundamentais para auditoria, reconciliação e tratamento de reprocessamentos.
Como projetar a sincronização de publicações judiciais sem duplicar trabalho
- 1
Desenhe o processo antes do payload
Liste as etapas desde a captura da publicação até a conclusão da tarefa. Identifique quem valida o prazo, quem executa a providência e qual sistema será consultado quando houver divergência.
- 2
Classifique os campos por finalidade
Separe cada campo em quatro grupos: identificação, execução, evidência e contexto. Os dois primeiros tendem a seguir para o ERP ou CRM; evidências e contexto detalhado devem permanecer no sistema jurídico.
- 3
Defina a chave de correlação
Use uma combinação estável de identificador da publicação, origem, número do processo e versão do evento. Não use apenas o texto da publicação, porque pequenas alterações de formatação podem criar registros repetidos.
- 4
Crie regras para atualização
Estabeleça quais mudanças atualizam a tarefa existente e quais geram uma nova atividade. Uma correção de metadado pode atualizar o registro, enquanto uma nova determinação judicial normalmente exige uma nova ação.
- 5
Faça uma implantação em etapas
Comece com identificação, prazo, urgência, responsável e link seguro. Depois de medir duplicidades, falhas e tempo de processamento, avalie incluir resumos, centros de custo ou integrações com calendários.
- 6
Valide com casos reais
Teste intimações, atos ordinatórios, publicações sem prazo, processos em segredo de justiça, múltiplas instâncias e retificações. Um piloto de 30 dias com amostra acompanhada costuma revelar exceções que o desenho teórico não captura.
Payload mínimo, idempotência e novas tentativas: a parte técnica que evita tarefas repetidas
Um webhook de publicação precisa ser pequeno o suficiente para ser processado rapidamente e completo o suficiente para permitir correlação. O conteúdo integral e os arquivos podem ser consultados por uma API segura depois, evitando que cada evento carregue grandes anexos.
Um payload inicial pode seguir esta estrutura:
{ "evento_id": "pub_8f31", "versao": 2, "tipo": "publicacao_criada", "origem": "diario_tj", "processo": { "numero_cnj": "0000000-00.2026.8.26.0100", "tribunal": "TJSP" }, "publicacao": { "disponibilizada_em": "2026-09-21T08:10:00Z", "publicada_em": "2026-09-22", "resumo": "Intimação para manifestação", "urgencia": "alta" }, "prazo": { "dias": 5, "data_final_sugerida": "2026-09-29", "validacao": "pendente" }, "documento_url": "https://exemplo.com/documento/seguro", "schema": "1.0" }
A chave de idempotência deve ser persistida pelo sistema receptor. Se o mesmo evento_id e a mesma versao chegarem duas vezes, o ERP deve responder como processado sem criar outra tarefa. Se a versão mudar, a aplicação precisa decidir se atualiza o registro ou registra uma nova ocorrência.
As tentativas automáticas também precisam de limites. Use espera progressiva, por exemplo, após 1, 5 e 15 minutos, registre o último erro e envie o evento para uma fila de exceções quando o limite for atingido. O padrão HTTP define códigos de resposta que ajudam a separar falhas temporárias de erros que exigem correção de dados, conforme a especificação oficial do HTTP.
Não confirme o recebimento antes de gravar o identificador do evento. Caso contrário, uma falha entre a resposta do endpoint e a persistência local pode fazer o produtor considerar o evento entregue, embora o ERP nunca tenha criado ou atualizado a tarefa.
Também é recomendável incluir correlation_id, horário de captura, horário de envio, origem, versão do esquema e status de processamento. Esses campos tornam possível responder perguntas como: a publicação foi capturada, enviada, recebida, convertida em tarefa e concluída?
Dois cenários de integração: varejo e escritório com correspondentes
Imagine um departamento jurídico de varejo com milhares de processos distribuídos por lojas, estados e escritórios terceirizados. O ERP precisa receber somente a tarefa, o prazo sugerido, a prioridade, o responsável, a unidade de negócio, o número do processo e o link para consulta do documento original.
Nesse fluxo, o sistema jurídico conserva a publicação, os anexos, o histórico e os comentários. A equipe pode discutir a providência no próprio processo, enquanto o ERP acompanha volume de tarefas, custos, responsáveis e indicadores para a gestão corporativa.
Em um escritório com vários correspondentes, a necessidade é diferente. O gestor pode enviar ao sistema de cada correspondente apenas os metadados necessários, como número do processo, comarca, ato, prazo, instrução e endereço seguro do documento, mantendo no repositório central as evidências e a comunicação completa.
O correspondente atualiza o resultado da diligência por meio de um status controlado, como aceita, em_execucao, concluida ou impedimento. A integração devolve essa atualização ao sistema jurídico sem copiar e-mails, arquivos e conversas para várias plataformas.
O Pocket Jurídico se encaixa nessa lógica ao capturar publicações e movimentações em mais de 490 diários e tribunais, organizar uma visão 360º do processo e disponibilizar dados para integração por API. A equipe pode usar o evento como gatilho operacional e manter documentos, histórico e contexto no feed, sem transformar o ERP em uma réplica do contencioso.
Para equipes que precisam resumir despachos ou extrair prazos antes do envio ao ERP, a automação da triagem e priorização de publicações com IA ajuda a estruturar a etapa de validação. O resumo deve ser tratado como apoio à decisão, não como substituto da conferência jurídica.
Como controlar inconsistências, segurança e reconciliação dos dados
Uma integração confiável não termina quando o evento chega ao ERP. É preciso comparar periodicamente a quantidade de publicações capturadas, eventos enviados, tarefas criadas, atualizações rejeitadas e registros pendentes de tratamento.
Defina indicadores simples para o primeiro ciclo: percentual de eventos processados, tempo entre captura e criação da tarefa, número de duplicidades, falhas por tipo, eventos sem processo correspondente e prazo médio de resolução das exceções. A referência sobre indicadores de integração por API pode ajudar a organizar esse painel.
A reconciliação deve ser orientada por identificadores, não por contagem total. Se existem 1.000 publicações na fonte e 1.000 tarefas no ERP, isso não prova que os registros correspondem. Compare evento_id, número do processo, versão, status e data de processamento.
Controle também a permissão de acesso. Um usuário do financeiro pode precisar ver centro de custo e status de tarefa, mas não necessariamente o teor integral de uma publicação. Links para documentos devem exigir autenticação, expirar quando apropriado e registrar quem acessou a informação.
Entre os erros mais comuns estão usar o número do processo como única chave, criar uma tarefa para toda movimentação, sobrescrever prazos validados por novos cálculos, enviar anexos sem necessidade e deixar a fila de falhas sem responsável. Cada um desses padrões aumenta retrabalho ou risco operacional.
Uma política de mudança completa deve definir versões de API, prazo de suporte, campos obrigatórios, regras de exclusão, tratamento de retificação e responsável por aprovar novos eventos. A documentação precisa ser acessível ao jurídico e à tecnologia, porque a regra de negócio não pode ficar escondida apenas no código.
Checklist para começar sem interromper a operação
- ✓Escolha um fluxo de baixo risco para o piloto, como publicações que geram tarefas internas com prazo e responsável claramente definidos.
- ✓Cadastre uma chave externa no ERP ou CRM para armazenar o identificador da publicação e impedir a criação de tarefas repetidas.
- ✓Envie primeiro cinco grupos de dados: processo, ato, datas, prioridade e link seguro. Adie documentos e histórico integral até comprovar a necessidade.
- ✓Mantenha o prazo sugerido com um indicador de validação. A equipe deve distinguir cálculo automático, prazo conferido e prazo concluído.
- ✓Defina o comportamento para publicação sem prazo, processo não localizado, retificação, duplicidade, indisponibilidade do endpoint e evento fora de ordem.
- ✓Crie uma fila de exceções com responsável, prazo de tratamento e motivo legível. Erros silenciosos são mais perigosos do que falhas visíveis.
- ✓Monitore o custo por volume de nomes e termos monitorados, além do consumo de chamadas de API. A expansão deve acompanhar a capacidade real de tratamento da equipe.
- ✓Faça uma revisão semanal no primeiro mês e compare horas economizadas, tarefas duplicadas, eventos pendentes e prazos que exigiram correção.
- ✓Depois do piloto, avalie integrações com calendário, comentários, IA ou MCP. Cada nova conexão deve resolver uma etapa concreta, não apenas aumentar a quantidade de dados replicados.
A regra central: sincronize a ação, preserve a evidência
A melhor integração de publicações judiciais não é a que envia mais campos. É a que entrega rapidamente a informação necessária para agir, conserva a fonte original e permite provar como o evento foi tratado.
Na prática, isso significa sincronizar identificadores, datas, prazo sugerido, urgência, responsável, status e link seguro. O texto integral, os documentos, o histórico de movimentações e o contexto das decisões permanecem no sistema jurídico, onde podem ser pesquisados e auditados.
O Pocket Jurídico permite operar com essa separação: publicações e movimentações chegam em tempo real, podem ser analisadas no feed e conectadas a ERPs, CRMs ou ferramentas de IA por API e MCP. Como a cobrança considera o volume de nomes e termos monitorados, o desenho da integração pode crescer de acordo com a necessidade operacional, sem obrigar a equipe a replicar todo o acervo.
Para estruturar o projeto, comece por um fluxo, documente a chave de idempotência, valide os prazos e acompanhe a reconciliação. A tecnologia reduz o trabalho repetitivo, mas a clareza sobre responsabilidades é o que impede que o retrabalho apenas mude de lugar.
Perguntas Frequentes
Quais campos de uma publicação judicial devem ser enviados ao ERP ou CRM?▼
Os campos mais úteis são identificador do evento, número CNJ, tribunal, órgão julgador, datas de disponibilização e publicação, tipo de ato, prioridade, prazo sugerido, responsável, status e link seguro para o documento. Resumo e ação recomendada também podem ser enviados, desde que indiquem quando dependem de validação humana. O texto integral, anexos e histórico completo normalmente devem permanecer no sistema jurídico.
Como evitar que uma publicação judicial gere duas tarefas no ERP?▼
Use uma chave de idempotência formada pelo identificador da publicação, origem e versão do evento. O ERP deve armazenar essa chave e tratar uma nova entrega com os mesmos valores como reprocessamento, não como uma nova tarefa. Também é necessário definir como retificações serão tratadas, pois uma versão diferente pode atualizar a tarefa existente ou gerar uma nova ação.
O documento PDF da publicação deve ser copiado para o CRM?▼
Na maioria dos projetos, não. É mais seguro manter o PDF no repositório jurídico e enviar ao CRM apenas um identificador e um link seguro, com autenticação e registro de acesso. Essa decisão reduz duplicidade, facilita a aplicação de políticas de retenção e diminui o risco de equipes consultarem uma cópia desatualizada.
Qual é o payload mínimo para um webhook de publicação judicial?▼
O payload mínimo deve conter identificador do evento, versão, tipo de evento, origem, número do processo, tribunal, datas principais, resumo operacional, prazo sugerido, prioridade, link seguro e versão do esquema. Inclua também um identificador de correlação e horário de captura para facilitar auditoria. Arquivos e texto integral podem ser obtidos por consulta autenticada à API.
Como lidar com falhas e novas tentativas na integração de publicações?▼
Separe falhas temporárias, como indisponibilidade do receptor, de erros permanentes, como campo obrigatório ausente. Para falhas temporárias, use novas tentativas com espera progressiva e limite definido; para erros permanentes, envie o evento a uma fila de exceções. O sistema receptor deve persistir a chave de idempotência antes de confirmar o recebimento.
O prazo extraído automaticamente pode ser criado diretamente no ERP?▼
Pode, desde que o fluxo diferencie prazo sugerido de prazo validado. Publicações simples e regras já conhecidas podem seguir uma aprovação automática controlada, enquanto decisões complexas devem aguardar revisão de um profissional. Registrar quem validou, quando validou e qual fonte foi usada é essencial para reduzir risco e permitir auditoria.
Como integrar publicações judiciais a Salesforce ou TOTVS sem duplicar o contencioso?▼
Comece usando o Salesforce ou TOTVS para tarefas, responsáveis, unidades, custos e indicadores, enquanto o sistema jurídico mantém documentos, histórico e contexto. Crie uma chave externa para cada evento, defina regras de atualização e envie um link seguro para a fonte. Depois do piloto, acompanhe duplicidades, falhas, latência e registros sem correspondência antes de ampliar o escopo.