Dados e tipos de eventos#

Dados de um evento#

Cada evento da lista de eventos é um objeto JSON com os seguintes atributos:

Parâmetro	Tipo	Descrição
id	integer (64 bits)	id numérico que identifica unicamente o evento. É um inteiro de 64 bits: veja o aviso sobre o tamanho do id.
evt_type	number	Valor numérico que informa o tipo de evento.
created_at	string	Data do evento, no formato ISO 8601.
target_url	string	Endereço da entidade à qual o evento se refere
target_number	string	numero que identifica a entidade à qual o evento se refere.
source_url	array	lista de endereços das entidades monitoradas que originaram o evento.
source_user_custom	string	valor do campo `user_custom` para o objeto que originou o evento. Se houver múltiplos objetos, enviamos o valor do campo `user_custom` de cada um, concatenado por `;`.
api_name	string	Quando fornecido nos dados de uma user_company, este texto é enviado em todas as chamadas web-hook desta empresa. Pode ser usado como forma de autenticação, garantindo que quem fez a chamada a seu servidor realmente foi a API Digesto.
data	json	Dados do evento, conforme valor do `evt_type`.

Importante

Aviso de 09/11/2026: o id do evento é um inteiro de 64 bits e vai ultrapassar 2.147.483.647 (2³¹ − 1), o maior valor de um inteiro de 32 bits, por volta de meados de dezembro de 2026. Se o seu sistema guarda ou converte o id como inteiro de 32 bits (por exemplo, int em Java ou C#, INTEGER no PostgreSQL ou INT no MySQL), troque para um inteiro de 64 bits (long, BIGINT) ou para texto antes dessa data. O aviso vale para o id recebido via webhook e para o retornado pela API de monitored_event.

Tipos#

Os seguintes tipos de monitoramento estão disponíveis:

Tipo de evento (evt_type) = 1 (mov.), 7(outros)

Nota

Requer módulo “(API) Monitorar andamentos e mudanças cadastrais de processos”. Para mais informações entre em contato com o suporte.

Critério de Monitoramento: número de processo monitorado (proc)

Fonte de Monitoramento: Tribunais

Resposta da API: novas movimentações ou mudanças, que podem ser sobre audiências, novos advogados, novos anexos e outros.
Tipo de evento (evt_type) = 2

Nota

Requer módulo “(API) Monitorar publicações judiciais”. Para mais informações entre em contato com o suporte.

Critério de Monitoramento: palavras, nome, OAB, CPF, CNPJ de parte (pessoa física, jurídica, advogado). (monitored_person)

Fonte de Monitoramento: Publicações em Diários Oficiais Judiciais

Resposta da API: compreenderia qualquer menção aos nomes monitorados nos recortes judiciais, que pode indicar tanto novos processos distribuídos
Tipo de evento (evt_type) = 2

Nota

Requer módulo “(API) Monitorar andamentos e mudanças cadastrais de processos”. Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: número de processo monitorado(proc)

Fonte de Monitoramento: Publicações em Diários Oficiais Judiciais

Resposta da API: novas publicações dos processos pre-existentes/conhecidos.
Tipo de evento (evt_type) = 3

Nota

Requer módulo “(IP) Diários Oficiais: buscar”. Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: palavras (monitored_term)

Fonte de Monitoramento: Diários Oficiais judiciais, administrativos, legislativos, executivos.

Resposta da API: trecho do diário oficial que menciona a palavra monitorada. Por se tratar de publicações judiciais ou não, nesta modalidade o resultado não vem estruturado como recorte com campos.
Tipo de evento (evt_type) = 4

Nota

Requer módulo “(API) Monitorar distribuições”. Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: palavras, nome, OAB, CPF, CNPJ de parte (pessoa física, jurídica, advogado) (monitored_person)

Fonte de Monitoramento: Tribunais

Resposta da API: detalhes completos dos processos recém-distribuídos, frequentemente antes de qualquer publicação em diários oficiais e bem antes da citação física via correio.
Tipo de evento (evt_type) = 10

Nota

Requer módulo “(API) Monitorar Procon” (cad.procon). Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: cadastro de fornecedores (ProconFornecedor) no sistema Procon com monitoramento ativo.

Fonte de Monitoramento: Base de dados Procon com extração de Cartas de Informação Preliminar (CIPs).

Resposta da API: eventos de CIP capturados do sistema Procon, incluindo número FA e data de geração. O campo target_number contém o formato “{numero_fa} {data_geracao}” (ex: “FA12345 03/11/2017”).
Tipo de evento (evt_type) = 13

Nota

Requer módulo “(API) Monitorar andamentos e mudanças cadastrais de processos”. Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: Um pedido de atualização de processo no tribunal.

Fonte de Monitoramento: Tribunais

Resposta da API: dados completos do processo atualizado.
Tipo de evento (evt_type) = 18

Nota

Requer módulo “(API) OAB: Cadastro e monitoramento de processos por advogados” (api.oab). Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: cadastro de OABs (modelo OAB) com MonitoredPerson ativo (is_advogado=True, is_active=True, is_monitored_tribunal=True).

Fonte de Monitoramento: Base 2ª instância (proc2a) - processos indexados no Elasticsearch, buscando por número/nome da OAB nos processos distribuídos.

Resposta da API: processos vinculados a advogados/OABs monitoradas, incluindo dados como nome do advogado, número da OAB, região (UF) e letra suplementar quando aplicável.
Tipo de evento (evt_type) = 20

Nota

Requer módulo “(API) Monitorar andamentos e mudanças cadastrais de processos”. Funcionalidade configurável por cliente. Para habilitar esse módulo, entre em contato com o suporte.

Critério de Monitoramento: número de processo monitorado (proc) com verificação diária configurada.

Fonte de Monitoramento: Tribunais (verificação direta).

Resposta da API: confirmação de que o processo monitorado foi verificado no tribunal com sucesso, mesmo sem novas movimentações. A frequência de verificação respeita as regras de instância: diariamente para 1ª e 2ª instâncias, a cada 7 dias para 3ª e 4ª instâncias. Este evento fornece segurança ao cliente de que o monitoramento está ativo.

Descrição de eventos de problemas em monitoramentos#

Os eventos de monitoramento (evt_type = 8) reportam detalhes de problemas, referenciando a entidade monitorada afetada. Podem ser recebidos via webhook ou consultados diretamente na API de monitored_event. As condições de geração dependem do tipo de monitoramento, conforme descrito abaixo:

Problemas no monitoramento de pessoas/advogados#

Para manter o bom funcionamento dos demais monitoramentos e para provisionarmos a infraestrutura necessária, desabilitamos automaticamente as partes monitoradas com muitas variações de nomes ou volume muito alto de resultados, e que precisam ter sua expressão de busca (campo rex) revisada O campo source_url do evento identificará a parte monitorada afetada.

Nestes casos, recomendamos verificar se a expressão de monitoramento entrada não é genérica demais. Experimente adicionar mais palavras na expressão regular, restringir o monitoramento a alguns tribunais e entrar uma expressão regular negativa de busca para remover algumas variações indesejadas.

Estes eventos são gerados e enviados alguns minutos após a criação ou edição de uma monitored_person. Também notificamos eventos deste tipo para o e-mail do administrador da empresa.

O campo data de um evento deste tipo é composto dos seguintes campos:

Parâmetro	Tipo	Descrição
`reason`	string	Descreve qual foi a falha, sendo que os tipos mais comuns são: “Muitas variacoes de nome” “Muitas distribuicoes recentes” “Não foi possível atualizar o seu processo.” “Não foi possível atualizar o seu processo. Estamos em manutenção para esse sistema.” “Não foi possível atualizar o seu processo. Indisponibilidade temporária ao acessar esse sistema.” “Processo não atualizado. Número de processo inválido.” “Não foi possível atualizar o seu processo. Sistema indisponível no momento.” “Não foi possível atualizar o seu processo. Processo indisponível no momento.” “Processo atualizado com sucesso. O processo está em segredo de justiça.” “Processo atualizado com sucesso. O processo está arquivado.”

Nota

Para reabilitar o monitoramento ou solicitar ajuda, entre em contato com o nosso suporte informando o ID da parte monitorada.

Exemplo do retorno de um HTTP POST com um evento de parte suspensa por ter muitas variações de nome:

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "target_url": "https://op.digesto.com.br/api/monitoramento/monitored_person/811",
        "evt_type": 8,
        "target_number": "nome parte",
        "source_user_custom": null,
        "created_at": "2016-05-27T21:41:07.664945",
        "source_url": ["https://op.digesto.com.br/api/monitoramento/monitored_person/811"],
        "data": {
        "reason": "Muitas variacoes de nome."
        }
    }
]

Problemas no monitoramento de processos#

Importante

Desde a mudança implantada em 20/10/2026, novas empresas começam com estes avisos desativados por padrão. Para recebê-los, solicite a ativação ao suporte ou configure trib_monitor_config.enable_erro_monitor_proc_event = true na empresa. As empresas anteriores mantêm a configuração que já possuíam.

A chave antiga disable_erro_monitor_proc_event, quando verdadeira, continua impedindo os avisos; para ativá-los, ela deve estar ausente ou ser false.

Ao atualizar trib_monitor_config via PATCH /api/user_company/<id>, envie um objeto JSON com a configuração completa, preservando as demais chaves: este campo é substituído por inteiro. Use valores booleanos true e false, sem aspas. A ativação vale para os próximos avisos gerados.

Esta configuração se aplica aos erros de monitoramento de processos. Os avisos de suspensão de pessoas/advogados descritos acima têm regras próprias.

A consulta única (atualização de processo no tribunal por demanda) não segue esta configuração: o pedido recebe o evento 8 em toda empresa, quando o processo não é encontrado, está arquivado ou em segredo de justiça, ou a coleta falha, independentemente de enable_erro_monitor_proc_event e de disable_erro_monitor_proc_event.

Quando sistemas diferentes do mesmo tribunal respondem de forma diferente para a mesma instância, cada resposta distinta gera um evento 8. Para receber no máximo um evento por instância, solicite ao suporte ou configure trib_monitor_config.enable_single_erro_monitor_proc_event_per_instance = true na empresa. O agrupamento vale para o monitoramento e para a consulta única.

Vasculhamos e extraímos diariamente os processos no momento da distribuição para os tribunais de nossa cobertura. Os total de tribunais alcançados e a assertividade é bastante dinâmica, pois os sites tribunais com frequência estão lentos, fora do ar ou colocam bloqueios para robôs. Verifique o Coberturas e fontes para mais detalhes.

Empregamos diversas técnicas para contornar estas dificuldades e garantir a melhor cobertura possível, porém nos casos onde há indisponibilidade do site do tribunal ou bloqueios temporários que afetem o monitoramento de processos específicos, enviamos via API/Webhook os eventos descritos abaixo.

Nota

Estes eventos não se aplicam ao monitoramento de publicações.

No monitoramento frequente de processos diretamente nos sites de tribunais, o evento 8 gerado pela tentativa de atualização é enviado uma vez por instância do processo e só é reenviado quando o motivo da falha muda ou depois de uma atualização bem-sucedida.
Na consulta única, o evento 8 é enviado a cada pedido, para cada instância do processo que não pôde ser atualizada.

O campo data de um evento descrevendo falhas no monitoramento de um processo junto aos tribunais é composto dos seguintes campos:

Parâmetro	Tipo	Descrição
`reason`	string	Descreve qual foi a falha, sendo que os tipos mais comuns são: “Mais de 24h desde último acesso”. Estes podem ser causados por indisponibilidade temporária do tribunal, ou novos bloqueios a consultas automatizadas impostas pelo tribunal. “Processo não encontrado no tribunal”. Significa que ainda não conseguimos obter no tribunal detalhes do processo informado. Isto pode ser causado por um tribunal ou instância não cobertos pelo nosso monitoramento, ou um número inválido fornecido pelo usuário.

Exemplo do retorno de um HTTP POST com um evento de erro ao monitorar processo no tribunal:

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "target_url": "https://op.digesto.com.br/api/monitoramento/proc/81190062",
        "evt_type": 8,
        "target_number": "98436320168130301",
        "source_user_custom": null,
        "created_at": "2016-05-27T21:41:07.664945",
        "source_url": ["https://op.digesto.com.br/api/monitoramento/proc/81190062"],
        "data": {
            "reason": "Mais de 24h desde último acesso."
        }
    }
]

Formato do número do processo no evento de tipo 8#

No evento de tipo 8, o campo target_number traz o número CNJ normalizado: só dígitos, sem pontuação e sem zeros à esquerda. É um formato diferente do evento de tipo 13 (consulta única), que traz o número como ele foi enviado na consulta, em geral com pontuação.

Número do processo	`target_number` no evento de tipo 8
`0009843-63.2016.8.13.0301`	`98436320168130301`
`3037490-52.2026.8.06.0001`	`30374905220268060001`

Para relacionar o evento de tipo 8 ao processo do seu sistema, normalize os dois números antes de comparar: mantenha só os dígitos e remova os zeros à esquerda. Exemplo em Python:

import re

def normaliza_cnj(numero):
    return re.sub(r'\D', '', numero).lstrip('0')

normaliza_cnj('0009843-63.2016.8.13.0301')  # '98436320168130301'

# evento recebido no webhook
if normaliza_cnj(evento['target_number']) == normaliza_cnj(cnj_do_meu_sistema):
    ...

Para buscar na API os eventos de um processo, incluindo os de tipo 8, veja o exemplo de filtro por número CNJ em eventos monitorados.

Problemas no monitoramento Procon#

Para o monitoramento de fornecedores no sistema Procon (evento tipo 10), podem ocorrer falhas relacionadas à integração com a API externa do Procon ou problemas de configuração.

O campo source_url do evento identificará o fornecedor Procon afetado.

Estes eventos são gerados quando há problemas na captura de CIPs (Cartas de Informação Preliminar) ou na integração com o sistema Procon.

O campo data de um evento deste tipo é composto dos seguintes campos:

Parâmetro	Tipo	Descrição
`reason`	string	Descreve qual foi a falha, sendo que os tipos mais comuns são: Erros de integração com API externa do Procon Problemas de configuração de empresa Falhas na captura de CIPs

Nota

Para resolver problemas de monitoramento Procon, entre em contato com o nosso suporte informando o ID do fornecedor monitorado.

Problemas no monitoramento por OAB#

Para o monitoramento de processos por OAB (evento tipo 18), podem ocorrer falhas relacionadas à busca no Elasticsearch, validação de número/região da OAB ou limites de processos excedidos.

O campo source_url do evento identificará a OAB monitorada afetada.

Estes eventos são gerados quando há problemas na busca de processos vinculados a advogados/OABs monitoradas na Base 2ª instância.

O campo data de um evento deste tipo é composto dos seguintes campos:

Parâmetro	Tipo	Descrição
`reason`	string	Descreve qual foi a falha, sendo que os tipos mais comuns são: Erros específicos de busca Problemas de validação de número/região OAB Limites de processos excedidos

Nota

Para resolver problemas de monitoramento por OAB, entre em contato com o nosso suporte informando o ID da OAB monitorada.