Como mapear e sincronizar campos de publicações judiciais com seu ERP ou CRM
Um guia prático para transformar publicações judiciais em registros confiáveis, tarefas acionáveis e contexto preservado no ERP ou CRM.
Conheça o fluxo de publicações organizado
Neste artigo8 seções
- Por que o mapeamento de campos é o ponto crítico da integração
- Quais campos de uma publicação judicial devem ser sincronizados
- Como mapear e sincronizar campos de publicações judiciais em 7 etapas
- Como evitar registros duplicados quando há várias fontes
- Como reconciliar diferenças entre o feed e o ERP ou CRM
- Como levar o modelo para Salesforce, TOTVS e outras plataformas
- Erros comuns no mapeamento de publicações judiciais e roteiro de implantação
- Checklist final para uma sincronização confiável
Por que o mapeamento de campos é o ponto crítico da integração
O mapeamento de campos de publicações judiciais define se a integração com ERP ou CRM vai reduzir trabalho ou apenas transferir a confusão de uma tela para outra. Quando número do processo, partes, foro, evento e prazo chegam em estruturas diferentes, a equipe perde tempo corrigindo cadastros, revisando alertas repetidos e tentando reconstruir o contexto original.
Uma publicação pode aparecer no diário, no tribunal, em um sistema de correspondente e em uma plataforma de monitoramento. Essas fontes nem sempre usam o mesmo formato, horário ou descrição para o evento. Sem uma chave de correspondência e regras de atualização, o mesmo processo pode gerar três registros, duas tarefas e nenhum responsável claramente definido.
O primeiro passo é separar três objetos que costumam ser misturados: o processo, a publicação e a ação decorrente da publicação. O processo é o cadastro relativamente estável. A publicação é um evento documental, com origem, data e conteúdo próprios. A ação é o trabalho que alguém precisa executar, como analisar uma decisão, preparar manifestação ou controlar um prazo.
Essa separação evita um erro frequente: sobrescrever o cadastro do processo a cada nova movimentação. O ERP ou CRM deve receber a atualização necessária, mas também preservar o histórico do evento que motivou a mudança. Para interpretar corretamente o conteúdo antes de criar tarefas, consulte o guia prático para interpretar publicações judiciais.
A escala torna o problema mais visível. O relatório Justiça em Números, do Conselho Nacional de Justiça mostra a dimensão do acervo processual brasileiro e ajuda a entender por que controles baseados em conferência manual se tornam frágeis em operações com milhares de casos. A integração precisa ser desenhada para lidar com volume, reprocessamento e auditoria, não apenas com o cenário ideal de um único processo.
Quais campos de uma publicação judicial devem ser sincronizados
Um modelo útil começa pelo identificador do processo, mas não termina nele. O número CNJ, normalizado sem pontuação para comparação e armazenado também no formato de exibição, deve ser acompanhado por tribunal, unidade judiciária, foro, comarca, instância e classe processual. Esses atributos ajudam a confirmar que duas entradas realmente pertencem ao mesmo caso.
No objeto publicação, mantenha pelo menos: identificador único da publicação, número do processo, data de disponibilização, data de publicação, origem do diário ou tribunal, tipo de evento, texto integral, trecho resumido, endereço de origem quando disponível e horário de captura. A diferença entre disponibilização e publicação pode ser relevante para a conferência operacional de prazos.
O campo de prazo merece tratamento próprio. Armazene o prazo extraído, a unidade de contagem, a data inicial sugerida, a data final calculada, o nível de confiança da extração e a pessoa responsável pela validação. Uma data calculada por automação não deve ser confundida com uma decisão jurídica definitiva, especialmente quando o início da contagem depende de leitura do ato ou de circunstâncias do processo.
Para o cadastro processual, use uma referência externa estável, como "processo_erp_id", além do número CNJ. No CRM, relacione o processo ao cliente, contrato, unidade de negócio, escritório terceirizado e advogado responsável. Isso permite que a mesma publicação seja exibida em uma linha do tempo jurídica sem criar uma nova oportunidade, caso ou atendimento.
Um payload inicial pode seguir esta estrutura: {"id_publicacao":"pub_8f31","numero_processo":"0000000-00.2026.8.26.0100","numero_normalizado":"000000000020268260100","tribunal":"TJSP","foro":"São Paulo","instancia":"1ª instância","tipo_evento":"intimacao","data_publicacao":"2026-09-23","origem":"Diário da Justiça","resumo":"Intimação para manifestação","prazo":{"dias":5,"unidade":"dias úteis","data_final":null,"confianca":0.91},"processo_externo_id":"ERP-45821"}. O nome exato dos campos pode variar, mas a semântica deve permanecer estável.
Para evitar que o ERP vire um depósito de texto, defina quais campos são estruturados e quais devem permanecer como documento ou histórico. Status, responsável, prioridade e prazo precisam ser pesquisáveis. O conteúdo integral, anexos e evidências de origem devem permanecer vinculados à publicação, com controle de acesso e retenção compatíveis com a política do jurídico.
Como mapear e sincronizar campos de publicações judiciais em 7 etapas
- 1
Desenhe o fluxo atual
Liste como uma publicação nasce, é revisada, vira tarefa e é encerrada. Registre sistemas, planilhas, caixas de e-mail, responsáveis e pontos em que o mesmo dado é digitado novamente.
- 2
Crie um dicionário de dados
Para cada campo, documente nome, formato, obrigatoriedade, origem, regra de preenchimento e sistema proprietário. Inclua exemplos reais, como número CNJ com e sem máscara, para eliminar interpretações diferentes.
- 3
Escolha a chave de correspondência
Use o identificador único da publicação para impedir reprocessamento do evento e o número de processo normalizado para localizar o cadastro principal. Nunca dependa apenas do título, do nome da parte ou de uma descrição livre.
- 4
Defina o comportamento de cada evento
Classifique publicações como informativas, operacionais, urgentes ou potencialmente geradoras de prazo. Uma movimentação sem ação pode atualizar a linha do tempo, enquanto uma intimação validada pode criar tarefa com responsável e vencimento.
- 5
Configure transformações e validações
Padronize datas para um único fuso, normalize tribunal e instância, limite tamanhos de campos e valide referências antes de gravar. Quando um campo obrigatório faltar, envie a entrada para uma fila de exceção em vez de criar um registro incompleto.
- 6
Faça uma implantação controlada
Comece com uma carteira, um tribunal ou um tipo de evento. Compare os resultados por pelo menos duas semanas, medindo duplicidades, registros não vinculados, latência e tarefas criadas indevidamente.
- 7
Audite e refine continuamente
Mantenha um registro de entrada, transformação, resposta do ERP ou CRM e eventual reprocessamento. Revise mensalmente as exceções e altere as regras somente com versionamento e aprovação do responsável pelo processo.
Como evitar registros duplicados quando há várias fontes
A deduplicação deve acontecer em camadas. Primeiro, compare o identificador da publicação fornecido pela fonte. Depois, use uma combinação de número do processo normalizado, data de publicação, tipo de evento, órgão julgador e uma impressão digital do texto. Essa combinação reduz o risco de duplicar uma publicação quando o mesmo conteúdo chega com identificadores diferentes.
Uma impressão digital, ou hash, é uma representação calculada a partir do texto normalizado. Antes de calculá-la, remova espaços repetidos, diferenças de caixa, cabeçalhos técnicos e caracteres que não alteram o conteúdo. Não remova a versão original: ela é necessária para auditoria e para demonstrar exatamente o que foi recebido.
A regra de decisão pode ser simples. Se a chave idêntica já existir, atualize metadados e registre uma nova tentativa de entrega, sem criar evento. Se a chave do processo coincidir, mas o conteúdo for diferente, crie uma nova publicação vinculada ao mesmo processo. Se não houver correspondência segura, envie para revisão ou crie uma pendência de vinculação, nunca um processo definitivo automaticamente.
A prioridade também precisa ser explícita. Uma intimação com prazo confirmado deve superar uma movimentação meramente informativa. Uma decisão urgente, tutela, audiência ou determinação de pagamento pode exigir tarefa imediata, enquanto uma alteração de classe processual pode apenas atualizar o histórico.
Um mapa de decisão prático funciona assim: publicação informativa, anexar ao histórico; movimentação sem prazo, atualizar status e notificar apenas se houver regra de negócio; intimação com prazo extraído e confiança alta, criar tarefa; intimação com prazo incerto, criar tarefa de validação; evento urgente ou marcado pelo jurídico, criar tarefa prioritária e alerta adicional.
O erro mais perigoso é usar a prioridade da fonte como verdade absoluta. A origem ajuda, mas a regra deve considerar tipo de ato, conteúdo, cliente, valor envolvido, fase processual e prazo. Para reduzir o risco de decisões automáticas equivocadas, combine extração tecnológica com revisão humana nos casos de baixa confiança, como orienta o material sobre validação automática e revisão humana no monitoramento.
Como reconciliar diferenças entre o feed e o ERP ou CRM
- ✓Compare diariamente a quantidade de publicações recebidas, processadas, rejeitadas, vinculadas e pendentes. Uma diferença persistente aponta para falha de cobertura, credencial expirada, erro de transformação ou regra excessivamente restritiva.
- ✓Mantenha estados técnicos separados dos estados jurídicos. "Recebida", "validada" e "sincronizada" descrevem o fluxo da integração; "em análise", "prazo criado" e "encerrada" descrevem o trabalho do jurídico.
- ✓Registre a origem de cada valor. Se o responsável foi alterado no ERP, o histórico deve informar quando, por quem e por qual evento. Isso evita que uma sincronização posterior substitua silenciosamente uma decisão operacional.
- ✓Use reconciliação por amostragem e por exceção. Revise todos os registros não vinculados, duplicados ou com prazo extraído abaixo do nível de confiança definido, além de uma amostra aleatória dos casos considerados normais.
- ✓Crie uma fila de correção segura. O usuário deve conseguir vincular uma publicação ao processo correto, desfazer uma associação e reprocessar o evento sem gerar uma segunda tarefa ou perder os dados originais.
- ✓Defina métricas objetivas: percentual de publicações vinculadas, taxa de duplicidade, tempo entre captura e entrega, falhas por campo, quantidade de tarefas criadas e percentual de prazos revisados dentro do SLA.
- ✓Proteja conteúdo e credenciais. A integração deve usar permissões mínimas, autenticação adequada, logs sem exposição desnecessária de dados sensíveis e políticas de retenção aprovadas pelo jurídico. A ANPD apresenta orientações e referências oficiais sobre a LGPD, que devem ser consideradas na governança dos dados pessoais.
Como levar o modelo para Salesforce, TOTVS e outras plataformas
Em uma integração com Salesforce, o processo pode ser representado por um objeto jurídico customizado, relacionado à conta ou ao cliente, enquanto publicação e tarefa ficam em objetos filhos. A operação deve usar uma chave externa para permitir atualização idempotente, isto é, repetir a mesma mensagem sem criar um novo registro. A documentação da API REST do Salesforce ajuda a validar limites, autenticação e padrões de consulta da plataforma.
Em ambientes TOTVS ou em um ERP proprietário, a mesma lógica pode ser implementada por entidades de processo, ocorrências, atividades ou documentos, conforme o módulo contratado. O ponto central não é reproduzir todos os campos do feed, mas criar uma correspondência documentada entre o modelo jurídico e o modelo operacional do sistema de destino.
Uma chamada de atualização deve carregar a chave idempotente, a versão do evento e a origem. Um exemplo conceitual seria: {"chave_idempotencia":"pub_8f31:intimacao:v1","processo_externo_id":"ERP-45821","evento":"intimacao","prioridade":"alta","tarefa":{"titulo":"Validar prazo da intimação","responsavel_id":"USR-19","data_limite":null},"origem":"pocket_juridico","versao_schema":1}. Se a mesma mensagem for reenviada após uma falha de rede, o destino deve reconhecer a chave e retornar o registro já criado.
Webhooks são úteis para entregar eventos próximos do tempo real, mas precisam de confirmação, retentativas e fila de mensagens. Para uma visão mais ampla sobre esse desenho, consulte o conteúdo sobre como projetar webhooks e APIs para integrar publicações judiciais. A escolha entre entrega por evento, consulta periódica ou combinação das duas deve considerar disponibilidade, limites da plataforma e necessidade de recuperação.
O MCP pode complementar a integração ao permitir que uma IA autorizada consulte processos e publicações, explique o contexto ou proponha uma ação sem transformar a IA em fonte autônoma de verdade. O sistema deve expor somente os dados permitidos, registrar a solicitação e exigir confirmação antes de alterar prazo, responsável ou status. Veja como estruturar esse uso no guia sobre MCP jurídico e conexão com processos e publicações.
No Pocket Jurídico, o feed 360º pode reunir capa, histórico, movimentações, documentos e publicação em uma mesma visão antes da sincronização. Essa camada reduz o risco de enviar ao ERP apenas um trecho isolado, sem o contexto necessário para que o advogado decida o próximo passo.
Erros comuns no mapeamento de publicações judiciais e roteiro de implantação
O primeiro erro é começar pela tela do ERP. O time escolhe campos porque eles existem no sistema, sem verificar quais decisões o jurídico precisa tomar. O resultado costuma ser um cadastro cheio de texto e pobre em informações operacionais, como origem, confiança do prazo, evento e vínculo com o responsável.
Outro problema é tratar número do processo como único identificador de tudo. O mesmo processo recebe muitas publicações ao longo do tempo. Se a integração atualiza apenas o registro principal, o jurídico perde a trilha de eventos e não consegue provar qual informação gerou determinada tarefa.
Também é arriscado criar tarefa para cada notificação. Em uma carteira de alto volume, isso provoca fadiga de alertas e leva os usuários a ignorarem justamente a intimação relevante. Antes de automatizar, classifique eventos, defina exceções e estabeleça um limite de confiança para datas extraídas.
Um roteiro de 30 dias pode começar com três dias de inventário e desenho do dicionário. Na primeira semana, valide chaves, campos obrigatórios e regras de deduplicação com exemplos reais. Na segunda, faça testes em ambiente controlado; na terceira, rode uma carteira-piloto; na quarta, compare indicadores, corrija exceções e documente a operação.
O Pocket Jurídico pode ser usado como camada de monitoramento e contexto, integrado ao gestor já adotado pelo escritório ou pela empresa. A plataforma monitora publicações e movimentações em mais de 490 diários e tribunais, oferece API e permite conectar recursos de IA para resumir publicações e extrair prazos, sempre com a necessidade de definir regras de validação e responsabilidade no fluxo.
A equipe também pode começar sem integração bidirecional. Uma primeira fase pode entregar eventos estruturados ao ERP, mantendo alterações jurídicas sensíveis sob validação humana. Depois, com métricas de qualidade e reconciliação estáveis, o escopo pode incluir criação de tarefas, atualização de responsáveis e consultas assistidas por IA.
Checklist final para uma sincronização confiável
Antes de liberar a integração para toda a carteira, confirme se cada publicação possui identificador, origem, data, processo vinculado e conteúdo preservado. Verifique também se o ERP ou CRM consegue diferenciar atualização de processo, novo evento, tarefa e documento. Essa distinção é a base para evitar duplicidade e perda de contexto.
Teste cenários de falha: mensagem repetida, resposta lenta do ERP, token expirado, processo inexistente, publicação com número inválido, evento sem prazo e prazo extraído com baixa confiança. Uma integração madura não é aquela que nunca falha, mas a que falha de forma visível, recuperável e auditável.
Por fim, atribua donos. O jurídico define o significado dos eventos e a prioridade; tecnologia define segurança, disponibilidade e reprocessamento; operações acompanha métricas e exceções. Quando essas responsabilidades ficam documentadas, o mapeamento deixa de ser uma planilha esquecida e se torna parte governada do processo.
Se a equipe ainda faz consultas manuais todos os dias, compare o esforço atual com o custo de uma implantação gradual. O guia para reduzir horas gastas checando diários pode ajudar a estimar o trabalho repetitivo e a selecionar o primeiro fluxo a automatizar.
Perguntas Frequentes
Quais campos são essenciais em uma publicação judicial integrada ao ERP?▼
Os campos essenciais são identificador da publicação, número do processo, número normalizado, tribunal, foro, instância, tipo de evento, datas, origem, texto integral e resumo. Para gerar trabalho, acrescente prazo extraído, confiança da extração, responsável, prioridade e status da validação. Também é recomendável manter o identificador externo do processo no ERP, pois ele permite atualizar o cadastro sem depender apenas do número CNJ.
Como evitar que a mesma publicação crie registros duplicados?▼
Use uma chave idempotente baseada no identificador da publicação e, quando necessário, complemente a verificação com processo normalizado, data, órgão, tipo de evento e impressão digital do texto. A repetição da mesma mensagem deve atualizar o registro existente, não criar outro. Quando fontes diferentes apresentarem o mesmo conteúdo sem uma chave comum, envie o caso para uma regra de similaridade ou revisão, preservando a origem de cada entrada.
É melhor criar uma tarefa no CRM para toda movimentação processual?▼
Não. Movimentações informativas podem apenas atualizar a linha do tempo, enquanto intimações, decisões e eventos com prazo podem gerar tarefas. A regra deve considerar o tipo de ato, a confiança da data extraída, a fase do processo, o cliente e a prioridade definida pelo jurídico. Criar tarefas indiscriminadamente aumenta o volume de alertas e reduz a atenção dada aos eventos realmente urgentes.
Como sincronizar prazos extraídos por IA sem aumentar o risco jurídico?▼
Armazene a data sugerida, o trecho que fundamentou a extração e o nível de confiança, sem apresentar o resultado como uma decisão definitiva. Estabeleça revisão humana para baixa confiança, eventos sensíveis e situações em que a contagem dependa de interpretação processual. A IA pode acelerar triagem e cálculo preliminar, mas a responsabilidade pelo controle do prazo precisa estar atribuída a uma pessoa ou equipe.
Como reconciliar o feed de publicações com o cadastro do processo no ERP?▼
Compare identificadores, status, datas de última atualização, quantidade de eventos e referências externas. Registros sem correspondência devem entrar em uma fila de exceção, e não ser descartados ou transformados automaticamente em novos processos. Mantenha logs de entrada, transformação, resposta e correção manual para descobrir se a diferença veio da fonte, do mapeamento ou do próprio cadastro.
O que fazer quando Salesforce ou TOTVS não têm um campo equivalente?▼
Não force informações diferentes no mesmo campo apenas para completar o mapeamento. Crie um campo customizado, use uma entidade relacionada ou mantenha o dado como documento e metadado vinculado, conforme a governança da plataforma. O dicionário deve registrar a decisão, a transformação aplicada e o que acontece quando o campo não puder ser gravado no destino.
É possível integrar publicações judiciais sem trocar o software jurídico já utilizado?▼
Sim. Uma camada de monitoramento pode entregar eventos por API, webhook, arquivos estruturados ou outros mecanismos compatíveis com o sistema existente. A implantação pode começar com uma carteira-piloto e apenas leitura, avançando depois para atualização de processos e criação de tarefas. O ponto decisivo é definir chaves, regras de propriedade dos dados e tratamento de falhas antes de ampliar o volume.