Eventos

Dados de um evento

Para o envio de eventos de monitoramento, pedidos de peticionamento, relatórios, etc, a API Digesto realiza uma chamada HTTP POST a um endereço seu (webhook), cujo conteúdo é um JSON.

O endereço de webhook pode ser configurado no Digesto Operações, em Configurações - Integração via API. Cada user_company (empresa dentro da API Digesto) tem seu endereço de webhook próprio. Nesta tela é possível simular chamadas de diversos tipos.

Para testes iniciais, uma sugestão é o webhook.site que gera um endereço temporário para onde podemos fazer as chamadas com os dados de monitoramento, e você pode inspecionar o conteúdo das chamadas.

O JSON enviado pela Digesto para este endereço de webhook do cliente é sempre uma lista de eventos. Colocamos em média 12 eventos por chamada HTTP ao endereço webhook configurado.

Por questões técnicas de desempenho, uma mesma chamada da nossa API para o servidor do cliente pode ser feita mais de uma vez. É um evento bem raro, mas a recomendação é implementar a recepção do HTTP POST que fazemos de forma idempotente em relação ao atributo id ou target_url de cada evento dentro da chamada. Ou seja, duas chamadas avisando sobre o exato mesmo evento devem ser tratadas pelo cliente para evitar duplicidade.

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

• id: (number) - id numérico que identifica unicamente o evento.

• evt_type: (number) - Pode assumir os seguintes valores numéricos:

  • 1: movimentação processual: verificado diretamente no site do Tribunal, para cada processo.
  • 2: publicação processual: detectada em diários oficiais da Justiça.
  • 3: publicação geral: publicação envolvendo palavras quaisquer, não associado a um processo judicial.
  • 4: nova distribuição: novo processo judicial distribuido recentemente nos tribunais.
  • 7: mudanças em processo monitorado, exceto publicações e movimentações: por exemplo novas audiências, novos advogados para réus etc.
  • 8: aviso sobre falha no monitoramento.
  • 10: nova CIP PROCON (carta de informação preliminar)
  • 13: retorno de uma solicitação de atualização de um processo específico por demanda.
  • 14: relatório de due diligence (busca por nome) concluído.
  • 15: relatório prévio de saneamento de base disponível.
  • 16: relatório de saneamento de base concluído.

• created_at: (string) - data do evento. Ex.: “2015-03-13T11:48:34”

• target_url: (string) - endereço da entidade à qual o evento se refere.

  • Nos eventos de tipo 1 e 7 (movimentação processual e mudanças em processo) é o endereço dos dados completos do processo na API e que sofreu alguma modificação. Ex.: “https://op.digesto.com.br/api/tribproc/1111”.
  • No tipo 2 (publicação processual) é a URL única da publicação.
  • No tipo 3 (publicação geral) é o ID da página em Diário Oficial onde a informação foi encontrada. Mais detalhes sobre a página podem ser obtidas numa chamada à API de Diários Oficiais.
  • No tipo 4 (distribuição) é a URL na API dos detalhes do processo distribuído.
  • No tipo 6 (protocolização em massa), quando a protocolização é bem sucedida, enviamos o endereço com dos dados completos do processo na API.
  • No tipo 7 (mudanças em processo) é a URL na API dos detalhes do processo distribuído, com um hash único da mudança no final da URL.

• target_number: (string) - numero que identifica a entidade à qual o evento se refere.

  • Nos eventos de tipo 1, 2, 4, 6 e 8 é o número do processo (CNJ ou não). Este campo não é o ID do processo na base Digesto. O ID pode ser obtido no campo target_url.
  • Nos eventos de tipo 3, é o identificador Digesto do documento (página) de Diário Oficial onde a expressão monitorada foi detectada.
  • Nos eventos de tipo 10, é o número da FA concatenado pela data de geração da reclamação.

• source_url: (array) - lista de endereços das entidades monitoradas que originaram o evento. A API agrupa todos os eventos de várias fontes para evitar notificações duplicadas. Assim por exemplo se um recorte de publicação recem-obtido menciona um processo monitorado e também um advogado monitorado, enviamos um único evento, listando aqui o monitored_person e proc mencionados.

  • Nos eventos de tipo 1 cada valor da lista é o endereço do monitored_person ou do proc na API. Ex.: “https://op.digesto.com.br/api/monitored_person/1111”.
  • Nos do tipo 2 é o endereço do proc monitorado na API.
  • Nos do tipo 3 é o endereço do monitored_term.
  • Nos do tipo 4 é o endereço do monitored_person.

• source_user_custom: (string) - valor do campo user_custom para o objeto que originou o evento.

  Quando se define um processo ou pessoa para ser monitorada é possivel especificar o campo user_custom (por exemplo um ID interno da base do cliente). Então quando este processo gera um evento (publicação, movimentação), este campo é enviado junto do evento, para facilitar o rastreamento. Quando houver múltiplos objetos que originaram o evento, enviamos neste campo 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, pode ser:

  • tipo 1: é uma lista de movimentos, conforme schema do campo movs dos detalhes de um processo.
  • tipo 2: é uma lista de publicações judiciais, onde cada publicação é um JSON com os campos descritos em publicacoes.
  • tipo 3: é uma lista de publicações de termos gerais, onde cada publicação é um JSON com os campos descritos em diarios.
  • tipo 4: uma lista de processos, onde cada elemento da lista segue o schema Detalhes de um processo judicial (/api/tribproc).
  • tipo 7: um objeto JSON, ver mudanças nos atributos de processos.
  • tipo 8: um objeto JSON, ver detalhes sobre evento de quebra do SLA de monitoramento.
  • tipo 10: um objeto JSON, com o schema procon_cip.
  • tipo 12: uma lista de intimações, onde cada elemento da lista segue o schema intimacao.
  • tipo 13: um objeto JSON com os dados do processo recem-atualizado. Segue o schema Detalhes de um processo judicial (/api/tribproc).
  • tipo 14: um objeto JSON com os dados do relatório concluído. Segue o schema Detalhes de um processo judicial (/api/tribproc).

Exemplo de retorno webhook com eventos descrevendo novos processos distribuídos

O exemplo abaixo notifica sobre dois novos processos distribuídos, referentes a partes monitoradas (monitored_person).

Repare que são 2 loops na chamada: 1 loop externo com algo entre 1 a 12 eventos, e dentro de cada evento, no campo data há outro loop com detalhes de processos. Nesse loop interno, em condições normais, enviamos apenas 1 detalhe de processo.

Cada elemento da lista de processos segue o schema Detalhes de um processo judicial (/api/tribproc).

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

[
  {
    "target_url": "https://op.digesto.com.br/api/tribproc/92569840",
    "source_user_custom": null,
    "created_at": "2016-05-25T08:38:32.941264",
    "source_url": ["https://op.digesto.com.br/api/monitored_person/53"],
    "target_number": "1000692-33.2016.5.02.0036",
    "evt_type": 4,
    "id": 127886752,
    "data": [{
      "numeroAlternativo": "10006923320165020036",
      "anexos": [
        [
          9336822,
          "http://anexos.radaroficial.com.br/13215f30dbea58866498332e2caa0284.pdf",
          3,
          null
        ]
      ],
      "publicacoes": [],
      "vara": 36,
      "vara_original": "36a vara civel",
      "classeNatureza": "ACAO TRABALHISTA - RITO ORDINARIO",
      "movs": [
        [
          "2016-04-28",
          "DISTRIBUIDO SORTEIO",
          "\nDistribuído por sorteio",
          null,
          "DISTRIBUIÇÃO",
          null
        ]
      ],
      "distribuicaoTipo": "DISTRIBUICAO SORTEIO",
      "situacao_situacaoID": null,
      "area": "Trabalhista",
      "assuntoExtra": null,
      "audiencias": [
        [
          "2017-02-06 15:20:00",
          "36ª Vara do Trabalho de São Paulo",
          "una"
        ]
      ],
      "extinto": "false",
      "sentencaData": null,
      "alteradoEm": "2016-05-25T02:50:21",
      "foro": "SAO PAULO",
      "situacao": null,
      "valor": null,
      "numero": "1000692-33.2016.5.02.0036",
      "customs": {
        "source_algo_amplitude": "10",
        "source_algo_dias": "60",
        "source_proc_source": "2",
        "source_algo_scan": "Gaps"
      },
      "comarca": "SAO PAULO",
      "tribunalID": 14,
      "tribunal": "TRT2",
      "processoID": 92569840,
      "distribuicaoData": "2016-04-28",
      "arquivado": false,
      "classes": [
        "ADICIONAL DE HORAS EXTRAS"
      ],
      "acessos": "2016-05-25 02:50:21",
      "uf": "SP",
      "criadoEm": "2016-05-25T02:50:20",
      "partes": [
        [
          540998043,
          69194,
          "COMPANHIA BRASILEIRA DE DISTRIBUICAO",
          "COMPANHIA BRASILEIRA DE DISTRIBUICAO",
          47508411061023,
          61148164804,
          "47508411061023",
          103,
          "RECLAMADO",
          [],
          false,
          false,
          true,
          false
        ],
        [
          540998042,
          9726222,
          "Fabiana de Lima Freitas",
          "FABIANA DE LIMA FREITAS",
          null,
          33551023859,
          "335.510.238-59",
          115,
          "RECLAMANTE",
          [
            [
              "1889792",
              "FERNANDO ZANELLATO",
              "",
              "",
              ""
            ]
          ],
          true,
          false,
          false,
          false
        ]
      ]
    }]
  },
  {
    "target_url": "https://op.digesto.com.br/api/tribproc/92569901",
    "source_user_custom": null,
    "created_at": "2016-05-25T08:38:32.941264",
    "source_url": ["https://op.digesto.com.br/api/monitored_person/53"],
    "target_number": "1000795-25.2016.5.02.0720",
    "evt_type": 4,
    "id": 127886752,
    "data": [{
      "numeroAlternativo": "10007952520165020720",
      "anexos": [],
      "publicacoes": [],
      "vara": 20,
      "vara_original": "20a vara civel",
      "classeNatureza": "ACAO TRABALHISTA - RITO ORDINARIO",
      "movs": [
        [
          "2016-05-13",
          "AUDIENCIA UNA",
          "\nAudiência una designada (19/10/2016 11:20 - 20ª Vara do Trabalho de São Paulo - Zona Sul)",
          null,
          null,
          null
        ],
        [
          "2016-05-13",
          "DISTRIBUIDO SORTEIO",
          "\nDistribuído por sorteio",
          null,
          "DISTRIBUIÇÃO",
          null
        ]
      ],
      "distribuicaoTipo": "DISTRIBUICAO SORTEIO",
      "situacao_situacaoID": null,
      "area": "Trabalhista",
      "assuntoExtra": null,
      "audiencias": [
        [
          "2016-10-19 11:20:00",
          "20ª Vara do Trabalho de São Paulo - Zona Sul",
          "una"
        ]
      ],
      "extinto": "false",
      "sentencaData": null,
      "alteradoEm": "2016-05-25T02:51:32",
      "foro": "SAO PAULO - ZONA SUL",
      "situacao": null,
      "valor": null,
      "numero": "1000795-25.2016.5.02.0720",
      "customs": {
        "source_algo_amplitude": "10",
        "source_algo_dias": "60",
        "source_proc_source": "2",
        "source_algo_scan": "Gaps"
      },
      "comarca": "SAO PAULO - ZONA SUL",
      "tribunalID": 14,
      "tribunal": "TRT2",
      "processoID": 92569901,
      "distribuicaoData": "2016-05-13",
      "arquivado": false,
      "classes": [
        "AVISO PREVIO",
        "LIBERACAO ENTREGA DAS GUIAS"
      ],
      "acessos": "2016-05-25 02:51:32",
      "uf": "SP",
      "criadoEm": "2016-05-25T02:51:30",
      "partes": [
        [
          540998206,
          69194,
          "COMPANHIA BRASILEIRA DE DISTRIBUICAO",
          "COMPANHIA BRASILEIRA DE DISTRIBUICAO",
          47508411061023,
          61148164804,
          "47508411061023",
          103,
          "RECLAMADO",
          [],
          false,
          false,
          true,
          false
        ],
        [
          540998205,
          36481265,
          "MARCIA OLIVEIRA GABRIEL",
          "MARCIA OLIVEIRA GABRIEL",
          null,
          null,
          null,
          115,
          "RECLAMANTE",
          [
            [
              "169206",
              "PEDRO JUNIOR",
              "",
              "",
              ""
            ]
          ],
          true,
          false,
          false,
          false
        ]
      ]
    }]
  }
]

Exemplo de retorno webhook com evento descrevendo que um processo judicial foi atualizado

O exemplo abaixo notifica sobre a atualização com sucesso de um processo no site do tribunal.

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

[
  {
    "target_url": "https://op.digesto.com.br/api/tribproc/92569840",
    "source_user_custom": "id_cliente_pedido_update_333",
    "created_at": "2016-05-25T08:38:32.941264",
    "source_url": ["https://op.digesto.com.br/api/user_company/53"],
    "target_number": "0011468-49.2017.8.26.0071",
    "evt_type": 13,
    "id": 127886752,
    "data": {
      "numeroAlternativo": "10006923320165020036",
      "anexos": [
        [
          9336822,
          "http://anexos.radaroficial.com.br/13215f30dbea58866498332e2caa0284.pdf",
          3,
          null
        ]
      ],
      "publicacoes": [],
      "vara": 36,
      "vara_original": "36a vara civel",
      "classeNatureza": "ACAO TRABALHISTA - RITO ORDINARIO",
      "movs": [
        [
          "2016-04-28",
          "DISTRIBUIDO SORTEIO",
          "\nDistribuído por sorteio",
          null,
          "DISTRIBUIÇÃO",
          null
        ]
      ],
      "distribuicaoTipo": "DISTRIBUICAO SORTEIO",
      "situacao_situacaoID": null,
      "area": "Trabalhista",
      "assuntoExtra": null,
      "audiencias": [
        [
          "2017-02-06 15:20:00",
          "36ª Vara do Trabalho de São Paulo",
          "una"
        ]
      ],
      "extinto": "false",
      "sentencaData": null,
      "alteradoEm": "2016-05-25T02:50:21",
      "foro": "SAO PAULO",
      "situacao": null,
      "valor": null,
      "numero": "1000692-33.2016.5.02.0036",
      "customs": {
        "source_algo_amplitude": "10",
        "source_algo_dias": "60",
        "source_proc_source": "2",
        "source_algo_scan": "Gaps"
      },
      "comarca": "SAO PAULO",
      "tribunalID": 14,
      "tribunal": "TRT2",
      "processoID": 92569840,
      "distribuicaoData": "2016-04-28",
      "arquivado": false,
      "classes": [
        "ADICIONAL DE HORAS EXTRAS"
      ],
      "acessos": "2016-05-25 02:50:21",
      "uf": "SP",
      "criadoEm": "2016-05-25T02:50:20",
      "partes": [
        [
          540998043,
          69194,
          "COMPANHIA BRASILEIRA DE DISTRIBUICAO",
          "COMPANHIA BRASILEIRA DE DISTRIBUICAO",
          47508411061023,
          61148164804,
          "47508411061023",
          103,
          "RECLAMADO",
          [],
          false,
          false,
          true,
          false
        ],
        [
          540998042,
          9726222,
          "Fabiana de Lima Freitas",
          "FABIANA DE LIMA FREITAS",
          null,
          33551023859,
          "335.510.238-59",
          115,
          "RECLAMANTE",
          [
            [
              "1889792",
              "FERNANDO ZANELLATO",
              "",
              "",
              ""
            ]
          ],
          true,
          false,
          false,
          false
        ]
      ]
    }
  }
]

Exemplo de retorno webhook com eventos de publicações de processos e partes

O exemplo abaixo traz uma chamada contendo uma publicação detectada envolvendo o processo monitorado de id 684 (numeração CNJ 1040985-29.2016.8.26.0100).

Informação semelhante é enviada quando a publicação se refere a uma monitored_person. A diferença é que o campo source_url mencionará o endereço da pessoa monitorada na API.

No campo data há uma lista de publicações, onde cada publicação pode conter os campos descritos em recorte.

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

[
  {
    "target_url": "https://op.digesto.com.br/api/proc_publication/132312",
    "source_user_custom": null,
    "created_at": "2016-05-25T08:38:32.941264",
    "source_url": [
      "https://op.digesto.com.br/api/proc/684"
    ],
    "target_number": "0204832-87.2012.8.04.0001",
    "evt_type": 2,
    "id": 127886752,
    "data": [
      {
          "periodico_caderno": "II - Suplemento",
          "processo_id": 1,
          "texto": "NR.PROCESSO : 5157525-43.2021.8.09.0051\nCLASSE PROCESSUAL : PROCESSO CÍVEL E DO TRABALHO -> Processo de Conhecimento ->\nProcedimento de Conhecimento -> Procedimentos Especiais",
          "periodico_orgao_slug": "tjgo",
          "published_at": {
              "$date": 1624406400000
          },
          "partes": null,
          "proc_alt": null,
          "detected_at": {
              "$date": 1624464679000
          },
          "secoes_texto_completo": "INTIMAÇÃO EFETIVADA REF. À MOV. Intimação Efetivada a Ser Publicada No Diário\nEletrônico Nos Próximos 2 (Dois) Dias Úteis - Data da Movimentação 22/06/2021\n18:29:37\nLOCAL : GOIÂNIA - 8ª VARA CÍVEL",
          "proc_apens": null,
          "snippet": "NR.PROCESSO : 5157525-43.2021.8.09.0051\nCLASSE PROCESSUAL : PROCESSO CÍVEL E DO TRABALHO -> Processo de Conhecimento ->\nProcedimento de Conhecimento -> Procedimentos Especiais -> Procedimentos...",
          "entities": [
              [
                  "cnj",
                  {
                      "prefixo": null,
                      "cnj": "5157525-43.2021.8.09.0051",
                      "sufixo": null
                  }
              ]
          ],
          "sections": [
              {
                  "secao_titulo": "INTIMAÇÃO EFETIVADA REF. À MOV. Intimação Efetivada a Ser Publicada No Diário",
                  "secao_id": 15309658,
                  "secao_texto": "INTIMAÇÃO EFETIVADA REF. À MOV. Intimação Efetivada a Ser Publicada No Diário\nEletrônico Nos Próximos 2 (Dois) Dias Úteis - Data da Movimentação 22/06/2021\n18:29:37\nLOCAL : GOIÂNIA - 8ª VARA CÍVEL\n",
                  "secao_nivel": 3
              }
          ],
          "available_at": {
              "$date": 1624406400000
          },
          "periodico_diario_slug": "dje-tjgo",
          "recorte_id": 4550307464893370000,
          "assunto": null,
          "secao_diario": "INTIMAÇÃO EFETIVADA REF. À MOV. Intimação Efetivada a Ser Publicada No Diário",
          "docurl": "http://tjdocs.tjgo.jus.br/documentos/585205/download",
          "num_pag_original": 7623,
          "periodico_orgao": "TJGO",
          "periodico_diario": "DJe-TJGO",
          "periodico_caderno_slug": "ii-suplemento",
          "periodico_id": 135,
          "advs": null,
          "proc": "5157525-43.2021.8.09.0051",
          "source_id": 611,
          "cached_docurl": "https://storage.googleapis.com/dg-diario-split/split-diario-oficial-dje-tjgo-tjgo-ii-suplemento-3257-2021-06-23-7623.pdf",
          "doc_id": 1
      }
    ]
  }
]

Exemplo de retorno webhook com eventos de movimentações em processos

Neste caso, o campo data é uma lista de movimentos, conforme schema do campo movs dos detalhes de um processo.

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

[
  {
    "target_url": "https://op.digesto.com.br/api/tribproc/81190062#mov-7936440138",
    "source_user_custom": null,
    "created_at": "2016-05-27T21:41:07.664945",
    "source_url": ["https://op.digesto.com.br/api/proc/9999998"],
    "target_number": "0009843-63.2016.8.13.0301",
    "evt_type": 1,
    "data": [
      [
        "2016-05-30",
        "AUDIENCIA CONCILIACAO DESIGNADA",
        "14:00 JUIZ(A) PRESIDENTE(A) 30070722",
        null,
        7936440138,
        [[2,3]]
      ]
    ]
  },
  {
    "target_url": "https://op.digesto.com.br/api/tribproc/81035332#mov-7935511654",
    "source_user_custom": null,
    "created_at": "2016-05-27T21:41:07.664945",
    "source_url": ["https://op.digesto.com.br/api/proc/9999999"],
    "target_number": "0010580-25.2016.8.13.0153",
    "evt_type": 1,
    "data": [
      [
        "2016-07-07",
        "AUDIENCIA CONCILIACAO DESIGNADA",
        "15:15 JUIZ(A) PRESIDENTE(A) 74310",
        null,
        7935511654,
        [[2,4]]
      ]
    ]
  }
]

Exemplo de retorno webhook com eventos de publicações de termos em diários oficiais

O exemplo abaixo notifica sobre uma publicação em Diário Oficial envolvendo um termo monitorado em diários oficiais (monitored_term).

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

[
  {
    "target_url": "https://op.digesto.com.br/api/diario_doc/68089126",
    "source_user_custom": "custom1",
    "created_at": null,
    "source_url": [
      "https://op.digesto.com.br/api/monitored_term/684"
    ],
    "target_number": "68089126",
    "evt_type": 3,
    "id": 127886752,
    "data": [
      {
        "monitored_term": 1,
        "snippet": "JOAO RICARDO VIANA COSTA Juiz de Direito Substituto CERTIDAO N. 0704523-43.2017.8.07.0003 - TUTELA CAUTELAR ANTECEDENTE - A: NOTRE DAME COMERCIO E IMPORTACAO LIMITADA. Adv(s).: DF47953 - FABIO DE ALBUQUERQUE MAIA. R: RODO DANNY TRANSPORTES E LOGISTICA EIRELI - ME. Adv(s).: DF20219 - RAPHAEL MESQUITA CARNEIRO. Poder Judiciario da Uniao TRIBUNAL DE JUSTICA DO DISTRITO FEDERAL E DOS TERRITORIOS 1421 Edicao no 116/2017 Brasilia -",
        "published_at": {
          "$date": 13123123
        },
        "docurl": "http://www.dje.tj.sp.gov.br/cdje/downloadCaderno.do?dtDiario=24/07/2013&cdCaderno=12",
        "cached_docurl": "https://radaroficial_downloads.s3.amazonaws.com/71886983942aca1ce58d3aa9ab67e0b2.pdf",
        "source_id": 4,
        "detected_at": {
          "$date": 13123123
        },
        "doc_id": 68089126
      }
    ]
  }
]

Listando eventos

Eventos históricos podem ser consultados e filtrados (ver intro).

Esta forma de obter os eventos seria uma alternativa ao uso de webhooks. Faria sentido por exemplo quando o sistema a ser integrado com a API Digesto não pode receber chamadas HTTP externas (por exemplo, quando é hospedado em ambiente de rede do cliente final).

Esta forma de obter eventos não seria recomendada, já que todo o controle de saber o que é novidade ficaria a cargo do sistema cliente.

GET https://op.digesto.com.br/api/monitored_event

Retorna lista de eventos da empresa.

Exemplo de resposta:

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

[
    {
        "$uri": "/api/monitored_event/4060",
        "created_at": {
            "$date": 1474560290000
        },
        "data": [
            {
                "acessos": "2016-09-01 08:42:50",
                "alteradoEm": "2016-09-01T08:42:50",
                "anexos": [],
                "area": "C\u00edvel",
                "arquivado": false,
                "assuntoExtra": "Rescis\u00e3o do contrato e devolu\u00e7\u00e3o do dinheiro",
                "audiencias": [
                    [
                        "2016-11-22 00:00:00",
                        "",
                        "Concilia\u00e7\u00e3o"
                    ]
                ],
                "classeNatureza": "PROCEDIMENTO DO JUIZADO ESPECIAL CIVEL",
                "classes": [],
                "comarca": "FORO DE RIBEIRAO BONITO"
            }
          ]
    }
]

Request Headers:  

• Authorization – token da API. Ver Autenticação.

Response Headers:  

• Content-Type – application/json

Listando chamadas webhook

Todas as chamadas via webhook realizadas ou pendentes podem ser consultadas e filtrados (ver intro).

Esta chamada pode ser usada para debugar o conteúdo das chamadas HTTP que a Digesto agendou.

GET https://op.digesto.com.br/api/webhook_call

Retorna uma lista JSON com todas as chamadas (feitas ou não) da empresa. Em cada chamada há um campo request_body com o conteúdo que estamos tentando enviar ao cliente.

Exemplo de resposta:

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


[
  {
    "$uri": "/api/webhook_call/2389613",
    "called": false,
    "created_at": {
      "$date": 1543494164000
    },
    "request_body": "...",
    "retries": 0,
    "url": "https://www.abc.com/webhook_digesto/input",
    "user_company": {
      "$ref": "/api/user_company/83"
    }
  }
]

Request Headers:  

• Authorization – token da API. Ver Autenticação.

Response Headers:  

• Content-Type – application/json

Descrição de eventos de problemas em monitoramentos

Sempre que ocorrer algo inesperado nos monitoramentos configurados via API, reportamos detalhes do ocorrido, referenciando a entidade monitorada afetada. Geramos então eventos de monitoramento (evt_type = 8) via webhook ou para consulta direta à API de monitored_event os seguintes tipos de problemas:

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. Em caso de dúvidas entre em contato conosco. 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.

Para reabilitar o monitoramento, entre em contato conosco em digesto@digesto.com.br informando o ID da parte monitorada.

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:

reason

Campo texto, descreve qual foi a falha. Os tipos comuns são “Muitas variacoes de nome.” e “Muitas distribuicoes recentes”.

Exemplo completo do 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/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/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 em cada um - principalmente a obtenção das iniciais digitais - é bastante dinâmica pois os sites tribunais com frequência estão lentos, fora do ar, ou colocam bloqueios para robôs (captchas, limite de acessos, bloqueio de login etc). O funcionamento das telas também passa por mudanças frequentes que fazem o robô não funcionar mais.

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.

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 user_company. 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:

reason

Campo texto, descreve qual foi a falha. Os tipos mais comuns são: “Mais de 24h desde último acesso.” ou “Processo não encontrado no tribunal”. Estes podem ser causados por indisponibilidade temporária do tribunal, ou novos bloqueios a consultas automatizadas impostas pelo tribunal. O segundo tipo de falha 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 completo do 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/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/proc/81190062"],
    "data": {
      "reason": "Mais de 24h desde último acesso."
    }
  }
]

Descrição de mudanças nos atributos de processos

O campo data de um evento (evt_type 7) descrevendo mudanças sofridas nos dados do processo é composto da lista de mudanças (changes) e também de uma cópia dos dados do processo no campo old.

É possível configurar a empresa para que nestes eventos os dados novos completos do processo sejam enviados também no campo new.

Os dados do processo no campo old e new seguem o schema Detalhes de um processo judicial (/api/tribproc).

A lista de mudanças (changes) é um dicionário de campos que sofreram alterações. A chave é o nome do campo e o valor é o novo valor que o campo do processo assumiu. Quando o campo modificado é uma lista, e a mudança ocorrida foi que um elemento foi adicionado a ela, trazemos um campo $insert com o conteúdo inserido. Quando uma tupla é inserida numa lista de tuplas (por exemplo nos campos audiencias, anexos), a mudança dentro dessa chave $insert é uma tupla de duas posições, uma com o índice no array original e a segunda posição é o dado inserido.

Veja um Exemplo completo de mudanças nos atributos de processos e também a seguir mais exemplos do campo data para mudanças típicas em processos judiciais.

Mudança em campo cadastral simples

{
  "new": ...,
  "changes": {"valor": 1000000.0}
}

Nova audiencia quando não havia nenhuma antes

{
  "new": ...,
  "changes": {
     "audiencias": [
      [
       "2019-04-03 14:55:00",
       "46a Vara do Trabalho de São Paulo",
       "inicial"
      ],
      [
       "2018-07-19 13:30:00",
       "46a Vara do Trabalho de São Paulo",
       "inicial"
      ],
      [
       "2018-01-22 09:00:00",
       "",
       "Audiencia Inicial"
      ]
     ]
    }
}

Novo anexo, quando já haviam anexos

{
  "new": ...,
  "changes": {
     "anexos": {
      "$insert": [
       [
        23,
        [
         16036841,
         "http://anexos.radaroficial.com.br/180387bf31b20d24f328293f1aaac02e.html",
         3,
         "2016-08-12T00:00:00",
         "Novo texto ... Poder Judici"
        ]
       ]
      ]
     }
    }
}

Novo advogado para uma parte e mudança de um campo simples

{
  "new": ...,
  "changes":{
     "partes": {
      "114": {
       "9": {
        "$insert": [
         [
          0,
          [
           "111984",
           "JEFFERSON FRANCISCO ALVES",
           "",
           "",
           ""
          ]
         ]
        ]
       }
      }
     },
     "valor": 1000000.0
  }
}

Nova parte incluída quando já existiam partes

{
  "new": ...,
  "changes":{
    "partes": {
      "$insert": [
        [
          115,
          [
            150981658,
            2122664,
            "Nivaldo Tavares",
            "NIVALDO TAVARES",
            null,
            17757925878,
            "177.579.258-78",
            74,
            "REQTE",
            [],
            true,
            false,
            false,
            false
          ]
        ]
      ]
    }
  }
}

Parte excluída

O número que aparece na chave $delete é o índice que a parte removida ocupava na lista original das partes.

De maneira geral, em relação aos avisos de mudanças em dados de processos (evt_type 7), o mais prático, é olhar o campo new, que é uma copia dos dados do processo atualizados.

O campo changes serve como resumo do que mudou, caso ele queira avisar os usuários de alguma forma. Nesse caso ai, ele poderia exibir “A 114a. parte do processo foi removida, e a lista de partes agora é…”.

{
  "new": ...,
  "changes": {"partes":
    {
      "$delete": [114]
    }
  }
}