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 |
number |
id numérico que identifica unicamente o evento. |
number |
Valor numérico que informa o tipo de evento. |
|
created_at |
string |
Data do evento, no formato ISO 8601. |
string |
Endereço da entidade à qual o evento se refere |
|
string |
numero que identifica a entidade à qual o evento se refere. |
|
array |
lista de endereços das entidades monitoradas que originaram o evento. |
|
source_user_custom |
string |
valor do campo |
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 |
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 distribuições”. 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 andamentos e mudanças cadastrais de processos”. 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) = 11
Critério de Monitoramento: Web site (Endereço HTTP/URL)
Fonte de Monitoramento: Conteúdo texto das páginas
Resposta da API: palavras e linhas modificadas no site monitorado após acessá-lo diversas vezes ao dia.
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.
Descrição de eventos de problemas em monitoramentos#
Sempre que ocorrer algo inesperado nos monitoramentos configurados via API, reportamos os detalhes do ocorrido, referenciando a entidade monitorada afetada.
Então, geramos eventos de monitoramento (evt_type
= 8) via webhook ou para consulta direta à API de monitored_event.
Os tipos de problemas são:
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 |
---|---|---|
|
string |
|
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#
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 se aplicam somente ao monitoramento frequente de processos diretamente nos sites de tribunais. Não se aplicam ao monitoramento de publicações.
Estes eventos são enviados somente uma vez por dia, para cada empresa. Entretanto a API fica enviando este evento de tipo 8 indefinidamente. Isto é, enquanto não conseguirmos atualizar o processo no tribunal, vamos continuar mandando diariamente, para cada processo com problema.
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 |
---|---|---|
|
string |
|
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": "0009843-63.2016.8.13.0301", "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." } } ]