Integrações e APIs

Guia prático para integrar publicações judiciais ao ERP ou CRM sem perder prazos

15 min de leitura

Veja como estruturar APIs, webhooks, campos processuais e regras de idempotência para conectar o monitoramento ao fluxo do seu jurídico.

Conheça as possibilidades de integração
Guia prático para integrar publicações judiciais ao ERP ou CRM sem perder prazos

Por que integrar publicações judiciais ao ERP ou CRM?

Integrar publicações judiciais ao ERP ou CRM deixou de ser apenas uma iniciativa de tecnologia. Para escritórios e departamentos jurídicos que acompanham centenas ou milhares de processos, a integração determina se uma nova movimentação se transforma rapidamente em uma providência ou permanece perdida em uma caixa de e-mail, planilha ou tela de tribunal.

O problema costuma começar com a duplicação de trabalho. Uma pessoa consulta o diário, outra confere o processo no sistema jurídico, uma terceira transcreve o prazo para o ERP e alguém ainda precisa avisar o responsável. Cada transferência manual aumenta a possibilidade de erro, atraso ou perda de contexto.

Uma arquitetura bem planejada conecta quatro etapas: captura da publicação, validação do processo, interpretação do conteúdo e criação da atividade no sistema de destino. O objetivo não é simplesmente transportar texto, mas entregar informação confiável para que a equipe saiba o que aconteceu, qual prazo pode existir, quem deve agir e até quando.

Antes de escolher campos ou endpoints, vale mapear como automatizar o fluxo de publicações judiciais e transformar notificações em tarefas. Esse diagnóstico mostra onde a operação atual repete dados, onde existe decisão humana e quais etapas podem ser automatizadas sem retirar controles necessários.

Em 2026, a integração também precisa considerar rastreabilidade e proteção de dados. Processos podem conter informações pessoais, estratégicas ou protegidas por sigilo, portanto cada evento deve ter origem identificável, histórico de alterações e regras claras de acesso. A Lei Geral de Proteção de Dados Pessoais, disponível no portal da ANPD, deve orientar a definição de finalidade, acesso e retenção.

Como funciona a integração entre monitor de publicações, ERP e CRM

A integração normalmente funciona por API, webhook ou uma combinação dos dois. A API permite consultar dados sob demanda, enquanto o webhook envia uma notificação ao sistema de destino assim que um evento acontece. Para prazos, o modelo orientado a eventos tende a reduzir o intervalo entre a disponibilização da publicação e o início do trabalho interno.

Uma arquitetura simples pode ser representada assim: monitoramento identifica a publicação, camada de validação confirma o processo, serviço de interpretação organiza o conteúdo, barramento de integração entrega o evento e ERP ou CRM cria a atividade. O sistema jurídico continua sendo a fonte operacional do processo, enquanto o ERP ou CRM assume tarefas, responsáveis, centros de custo, contratos ou relacionamento com o cliente.

Não é recomendável enviar tudo para todos os sistemas. O texto integral, documentos e histórico podem ficar no sistema de processos, enquanto o CRM recebe apenas número do processo, parte, cliente, tribunal, fase, responsável, prazo e link seguro para consulta. Essa separação diminui exposição de dados e evita sobrecarregar ferramentas que não foram desenhadas para armazenar documentos processuais.

Para empresas que usam TOTVS, o mapeamento pode relacionar processo e parte ao cadastro jurídico, centro de custo, contrato, unidade ou fornecedor terceirizado. No Salesforce, os mesmos eventos podem alimentar uma conta, oportunidade, caso ou objeto personalizado, conforme o modelo de governança adotado pelo departamento jurídico.

A equipe técnica também deve definir autenticação, limites de requisição, tempo de espera, tentativas de reenvio e monitoramento. O padrão HTTP documentado pelo IETF ajuda a interpretar corretamente códigos de sucesso, erro do cliente e indisponibilidade temporária, evitando que o conector trate uma falha como se fosse uma confirmação.

Passo a passo para integrar publicações judiciais sem perder prazos

  1. 1

    Defina a fonte oficial de cada informação

    Escolha qual sistema será responsável pelo número do processo, pelas partes, pelo prazo, pelo documento e pelo status da tarefa. Uma publicação pode ser recebida de diferentes fontes, mas o ERP ou CRM precisa saber qual registro deve prevalecer quando houver divergência.

  2. 2

    Desenhe o fluxo de eventos antes de criar a API

    Liste os eventos que realmente geram trabalho: nova publicação validada, movimentação relevante, documento disponível, prazo extraído, alteração de responsável e conclusão da tarefa. Para cada evento, indique origem, destino, regra de filtragem e ação esperada.

  3. 3

    Padronize a identificação do processo

    Use o número CNJ como chave principal sempre que ele estiver disponível, mas mantenha identificadores internos, tribunal, instância e origem da captura. A combinação evita que processos com registros antigos ou cadastros incompletos sejam tratados como novos.

  4. 4

    Crie o mapeamento de campos

    Relacione cada campo de origem ao campo de destino e defina formato, obrigatoriedade, tamanho e comportamento quando o valor estiver ausente. Separe dados descritivos, como assunto e classe, de dados operacionais, como prazo, responsável e prioridade.

  5. 5

    Configure o webhook com confirmação segura

    O endpoint deve validar a assinatura ou credencial recebida, registrar o identificador do evento e responder rapidamente. O processamento pesado pode ocorrer em fila, evitando que uma análise de documento ou resumo por IA faça o remetente reenviar o mesmo evento.

  6. 6

    Aplique idempotência

    Cada evento precisa de uma chave única, formada pelo identificador da publicação ou por uma combinação estável de processo, data, órgão e conteúdo. Se a mesma mensagem chegar duas vezes, o sistema deve atualizar o registro existente ou ignorar a repetição, nunca criar uma segunda tarefa.

  7. 7

    Faça a interpretação antes da criação do prazo

    Resumo, classificação e extração automática ajudam a priorizar o trabalho, mas devem preservar o texto original e indicar que o resultado foi gerado por automação. Em casos críticos, estabeleça revisão humana antes de confirmar a data final.

  8. 8

    Teste cenários de falha

    Simule publicação duplicada, processo sem cadastro, prazo sem data clara, tribunal indisponível, documento corrompido e resposta lenta do ERP. O teste só termina quando a equipe sabe como o evento será retido, reprocessado e auditado.

Quais campos processuais sincronizar para evitar retrabalho

O melhor conjunto de campos depende do uso do sistema de destino, mas alguns dados formam uma base comum. Identificador único do processo, número CNJ, tribunal, unidade, instância, classe, assunto, partes, polo, advogado responsável e escritório terceirizado são essenciais para localizar o caso e direcionar a atividade.

Para controle de prazos, acrescente identificador da publicação, data de disponibilização, data de publicação, tipo de ato, prazo indicado, data calculada, regra de contagem, status da revisão, responsável, prioridade e origem. O campo de origem é particularmente útil quando o jurídico recebe dados de diários, tribunais, softwares anteriores ou integrações paralelas.

Documentos e textos devem ser tratados com cuidado. Em vez de copiar arquivos indiscriminadamente para o CRM, envie metadados, tipo documental, hash ou identificador do arquivo e um link com autenticação. Assim, a equipe mantém acesso ao conteúdo correto sem criar várias versões do mesmo documento.

Um exemplo de mapeamento para um ERP corporativo seria: número CNJ para o identificador do processo, cliente ou parte principal para o cadastro de entidade, escritório responsável para fornecedor, centro de custo para unidade de negócio, prazo para tarefa, valor da causa para campo financeiro e publicação para histórico do caso.

No CRM, o processo pode ser associado à conta da empresa, ao caso jurídico ou a um objeto personalizado. A movimentação deve gerar uma atividade somente quando atender a uma regra, como conter intimação, decisão, audiência ou prazo, evitando que cada atualização simples produza uma tarefa inútil.

Para organizar o calendário, combine a integração com critérios descritos no guia para montar um calendário de prazos processuais infalível. O calendário não deve ser apenas uma lista de datas: precisa mostrar responsável, etapa, dependências, evidência de conclusão e alertas de escalonamento.

Payload, idempotência e segurança: o que não pode faltar

  • Identificador do evento: use um valor único e estável para impedir a criação repetida da mesma tarefa. Guarde também a data de recebimento, a origem e o status do processamento.
  • Chave do processo: mantenha o número CNJ normalizado e os identificadores internos. Se houver processos sem número completo, encaminhe o registro para uma fila de conferência em vez de tentar associá-lo por nome de forma automática.
  • Conteúdo da publicação: envie resumo, texto original ou referência segura ao documento, além do tipo de ato e da origem. O resumo facilita a triagem, mas não deve substituir a fonte primária.
  • Prazo e confiança: diferencie prazo informado no texto, prazo calculado pelo sistema e prazo validado por uma pessoa. Essa distinção evita que uma estimativa automática seja confundida com uma decisão definitiva.
  • Responsabilidade: inclua usuário, equipe, escritório terceirizado, unidade e regra que determinou a criação da tarefa. Quando um prazo mudar, a auditoria precisa mostrar quem alterou o registro e por qual motivo.
  • Retry com controle: em uma indisponibilidade temporária, faça novas tentativas com intervalo progressivo e limite definido. Sem esse controle, o mesmo evento pode ser enviado várias vezes ou gerar uma carga excessiva no ERP.
  • Privacidade e acesso: aplique o princípio do menor privilégio, use conexão protegida, armazene credenciais em cofre e registre acessos. Informações processuais não devem circular em logs abertos ou mensagens de erro.
  • Observabilidade: acompanhe eventos recebidos, processados, rejeitados, duplicados e pendentes. Um painel simples de saúde da integração costuma revelar falhas antes que elas afetem uma fila de prazos.

Como colocar a integração em prática com o Pocket Jurídico

Depois de validar o desenho, o Pocket Jurídico pode atuar como camada de monitoramento e entrega de eventos. A plataforma acompanha publicações e movimentações em mais de 490 diários e tribunais, valida o processo e organiza capa, histórico, movimentações e documentos antes de disponibilizar a informação para o fluxo interno.

Um payload típico pode seguir esta estrutura, adaptada aos campos aceitos pelo ERP ou CRM: {"evento":"publicacao.validada","id_evento":"evt_8f31","processo":{"numero_cnj":"0000000-00.2026.8.26.0000","tribunal":"TJSP","instancia":"1","partes":[{"nome":"Empresa Exemplo S.A.","polo":"ativo"}]},"publicacao":{"data":"2026-09-07","tipo":"intimacao","texto":"Texto original ou referência segura","resumo":"Síntese para triagem"},"prazo":{"dias":5,"data_sugerida":"2026-09-14","status":"aguarda_revisao"},"origem":"diario_oficial"}.

O conector MCP pode ampliar esse fluxo ao permitir que ferramentas de IA, como ChatGPT, Claude ou Gemini, consultem publicações e processos autorizados. Uma sequência prática é: receber a publicação validada, gerar resumo, extrair possível prazo, pedir confirmação quando necessário, criar tarefa no ERP e agendar a atividade no Google Agenda, Outlook ou calendário do escritório.

A automação deve deixar claro o que foi feito por máquina e o que foi confirmado pela equipe. A IA pode reduzir o tempo de leitura e responder perguntas sobre o conteúdo no próprio feed, mas a política interna deve determinar quais atos exigem revisão antes da criação ou encerramento de uma tarefa.

Considere um cenário plausível de um jurídico de varejo que centralizou três escritórios terceirizados. Ao usar sincronização em tempo real, chave de idempotência por publicação e regras que direcionavam cada processo ao responsável correto, a empresa reduziu em cerca de 90% as importações manuais, sem criar tarefas duplicadas quando o mesmo evento era reenviado.

Esse resultado não depende apenas da ferramenta. Ele vem da combinação entre cadastros padronizados, responsabilidades explícitas, fila de exceções e revisão periódica das regras. O monitoramento de processos em tempo real ajuda a completar essa visão, principalmente quando a empresa precisa acompanhar o contencioso de vários escritórios em um único painel.

Erros comuns ao integrar publicações judiciais ao ERP ou CRM

O primeiro erro é tratar o ERP ou CRM como substituto do monitoramento processual. Esses sistemas podem ser excelentes para tarefas, contratos, relacionamento e indicadores, mas nem sempre têm a mesma cobertura de diários, tribunais, documentos e movimentações. Definir papéis evita que uma limitação de cobertura seja confundida com falha de integração.

Outro problema frequente é sincronizar tudo sem filtro. Cada movimentação gerar uma atividade parece completo, porém rapidamente cria ruído, tarefas sem responsável e fadiga de alertas. Comece com eventos que tenham impacto operacional e amplie o escopo somente depois de medir precisão e volume.

Cadastros por nome também geram associações perigosas. Duas partes podem ter nomes semelhantes, uma empresa pode ter filiais e o número do processo pode aparecer com formatação diferente. A normalização do número CNJ, combinada com identificadores internos e validação por tribunal, é mais segura do que uma correspondência baseada apenas em texto.

A ausência de fila de exceções é igualmente crítica. Um processo não encontrado, uma data ambígua ou um prazo incompatível não deve desaparecer nem ser convertido silenciosamente em tarefa. O sistema precisa marcar o evento, avisar a equipe adequada e permitir reprocessamento após a correção.

Por fim, não encerre o projeto na entrega técnica. Meça tempo entre publicação e tarefa, percentual de eventos duplicados, taxa de associação automática, quantidade de exceções, prazos revisados e tarefas concluídas no tempo. Esses indicadores mostram se a integração realmente reduziu risco e trabalho, em vez de apenas trocar uma tela por outra.

Perguntas Frequentes

Como funcionam as integrações entre um monitor de publicações e sistemas como TOTVS ou Salesforce?

O monitor envia eventos por webhook ou disponibiliza dados por API, e o TOTVS ou Salesforce recebe essas informações por um conector ou serviço intermediário. O evento pode atualizar um processo, conta, caso, contrato ou tarefa, conforme o modelo de dados adotado. O projeto precisa definir autenticação, mapeamento de campos, regras de filtro e tratamento de falhas. Também é necessário estabelecer qual sistema será a fonte oficial de cada dado.

Quais campos devo sincronizar para controlar prazos processuais?

Comece pelo número CNJ, tribunal, instância, partes, identificador da publicação, tipo de ato, datas, prazo indicado, data calculada, responsável, prioridade e status de revisão. Inclua a origem do evento e o identificador interno para permitir auditoria e evitar conflitos entre fontes. O texto integral e os documentos podem permanecer no sistema jurídico, com metadados e link seguro no ERP ou CRM. Para prazos críticos, diferencie data sugerida automaticamente de data confirmada por uma pessoa.

Como configurar um webhook para que uma publicação gere uma tarefa automática?

Primeiro, crie um endpoint protegido que receba o evento e valide a credencial ou assinatura. Em seguida, registre o identificador do evento, responda rapidamente ao remetente e processe a mensagem em uma fila, quando houver etapas demoradas. Depois, aplique filtros para que apenas atos relevantes criem tarefas e mapeie responsável, prazo, prioridade e vínculo com o processo. Teste reenvios, indisponibilidade do ERP e eventos fora de ordem antes de colocar a rotina em produção.

Como evitar duplicidade quando tribunais, diários e outros softwares enviam o mesmo evento?

Use uma chave de idempotência baseada no identificador da publicação ou em uma combinação estável de processo, origem, órgão, data e conteúdo. Antes de criar uma tarefa, consulte essa chave e compare o status do registro existente. Também é útil manter um catálogo de fontes e uma regra de precedência para decidir qual evento atualiza o processo. Quando a correspondência não for segura, encaminhe o caso para conferência manual em vez de criar um segundo registro.

A inteligência artificial pode extrair prazos de publicações judiciais automaticamente?

Pode ajudar a identificar datas, atos, responsáveis e possíveis providências, além de resumir despachos para a triagem. Porém, o resultado depende da clareza do texto, das regras de contagem e do contexto processual, portanto não deve ser tratado automaticamente como confirmação definitiva em todos os casos. Uma boa política preserva o texto original, registra a sugestão gerada e exige revisão humana para situações críticas. Este fluxo é explicado com mais detalhes no guia sobre IA para resumir despachos e extrair prazos.

É possível integrar publicações judiciais sem substituir o software jurídico existente?

Sim. A integração pode manter o software jurídico como repositório principal e enviar ao ERP ou CRM apenas tarefas, indicadores, dados de relacionamento e referências seguras. Essa abordagem evita uma migração ampla e reduz a interrupção da operação. O ponto essencial é definir responsabilidades, impedir cadastros paralelos e garantir que alterações importantes retornem ao sistema correto quando necessário.

Como proteger dados processuais durante uma integração por API?

Use conexão protegida, credenciais com permissões mínimas, rotação de chaves e registros de acesso. Evite colocar texto integral ou dados sensíveis em logs, mensagens de erro e ambientes de teste sem controle. Estabeleça prazos de retenção, perfis de acesso e procedimento para revogar uma integração comprometida. A governança deve considerar a finalidade do tratamento e as obrigações aplicáveis à proteção de dados pessoais.

Organize o caminho entre a publicação e a providência

Conheça o Pocket Jurídico

Compartilhe este artigo