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.

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.

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

reason

string

Descreve qual foi a falha, sendo que os tipos mais comuns são:
  • “Muitas variacoes de nome”

  • “Muitas distribuicoes recentes”

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

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": "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."
            }
        }
    ]