Monitoramento
Monitore documentos ou processos e se mantenha atualizado sobre todos os seus processos
A JUDIT permite que você monitore processos, CPFs, CNPJs, OAB ou Código(CNJ), mantendo-o atualizado sobre qualquer nova movimentação.
O monitoramento é a automatização das consultas processuais do item anterior.
Diariamente, nossa API busca em todos os tribunais do Brasil processos relacionados ao CPF, CNPJ, OAB ou Código(CNJ) que você está monitorando.
Rota de Monitoramento
Para começar a monitorar um processo, CPF, CNPJ, OAB ou Código(CNJ), você deve realizar uma solicitação POST para a rota /tracking
.
Payload da Solicitação
A solicitação POST deve incluir um payload com as seguintes propriedades:
-
recurrence
: A recorrência em dias de atualização dos processos. -
search
: Objeto que vai para a busca.search_type
: Esse campo define o tipo de entidade que você quer buscar. Pode ser “cpf”, “cnpj”, “oab”, “lawsuit_cnj” OU “name” para um número de processo;
Obs:
- O formato da OAB é sempre UF mais 7 digitos do numero da OAB, adicionar zeros a esquerda até atingir 7 dígitos.
Exemplo:
-
search_key
: O número do processo (Código CNJ), CPF, CNPJ, OAB ou NAME que você deseja buscar; -
response_type
(opcional): No contexto de monitoramento esse campo define o tipo de retorno dos dados da busca podendo ser “lawsuit”,“parties”, “attachments”, “steps” ou “lawsuits”; -
with_attachments
(opcional): Esse campo define se você quer trazer anexos referente ao processo buscado podendo ser true ou falseObs:
Os anexos só serão retornados caso o search_type for lawsuit_cnj.
-
search_params
: Um objeto que contém alguns parâmetros da busca como:-
lawsuit_instance
(opcional): Este parâmetro permite definir a instância em que deseja buscar o processo;*Obs
: Caso o parâmetro lawsuit_instance não seja especificado, a busca retornará automaticamente a instância mais recente do processo. Por exemplo, se o processo estiver tramitando tanto na primeira quanto na segunda instância, a busca considerará a segunda instância, por ser a mais atualizada. -
masked_response
Define se a resposta virá minificada. Este parâmetro é aplicável apenas a consultas (simples ou completas) por documento no contexto de busca processual. - masked_response =true
: retornará uma consulta completa - masked_response =false
: retornará uma consulta simples
*Obs
Consulte as condições comerciais desses diferentes tipos de consultas por documento.Para buscas por documento onde o
search_type
seja “cpf”, “cnpj”, “oab” ou “name”. -
-
filter
(opcional): Um objeto que contém alguns filtros da busca como:-
side
(opcional): Este parâmetro permite buscar por tipo de participantes do processo podendo ser ‘Passive’, ‘Active’, ‘Interested’, ‘Unknown’; -
amount_gte
(opcional): Este parâmetro permite buscar por processos com valor da causa maior que o amount_gte; -
amount_lte
(opcional): Este parâmetro permite buscar por processos com valor da causa menor que o amount_lte; -
tribunals
(opcional): Um objeto que contém os filtro de tribunais;keys
(opcional): Este filtro é uma lista de códigos de tribunais inclusos na lista de tribunais. Você pode fornecer uma lista de códigos de tribunais para restringir a busca a processos que tenham ou não tenham esses códigos específicos;not_equal
(opcional): Um valor booleano que define se o filtro será para processos que contenham os valores em keys ou que não contenham os valores em keys
-
subject_codes
(opcional): Um objeto que contém os filtro de assuntos;keys
(opcional): Este filtro é uma lista de códigos assuntos. Você pode fornecer uma lista de códigos de assuntos para restringir a busca a processos que tenham ou não tenham esses códigos específicos;not_equal
(opcional): Um valor booleano que define se o filtro será para processos que contenham os valores em keys ou que não contenham os valores em keys
-
classification_codes
(opcional): Um objeto que contém os filtro de classes processuais;keys
(opcional): Este filtro é uma lista de códigos de classes processuais. Você pode fornecer uma lista de códigos de classes para restringir a busca a processos que tenham ou não tenham esses códigos específicos;not_equal
(opcional): Um valor booleano que define se o filtro será para processos que contenham os valores em keys ou que não contenham os valores em keys
-
distribution_date_gte
(opcional): Este filtro permite que você especifique uma data de distribuição mínima. Ele ajuda a filtrar processos com base na data de distribuição, permitindo que você localize processos distribuídos após uma determinada data.
-
-
credential
(opcional): Objeto para o uso do cofre de credenciais.customer_key
(opcional): Permite passar a chave do usuário que você cadastrou no cofre de credenciais, não seja informado, a API tentará encontrar uma credencial cadastrada para acustomer_key
vazia.
Caso o processo tenha um ou mais processos relacionado ou em alguma outra instância, esses processos serão retornados também.
-
tags
(opcional): Um objeto de valor-chave genérico para armazenar parâmetros de agrupamento.-
cadastrar um monitoramento no dash:
name
: nome do monitoramentodashboard_id
: 238904bd-3b05-4160-bef0-16b329a362f0
Para cadastrar um monitoramento criado via API, é necessário a utilização desse propriedade tag.
Exemplo:
-
Aqui está um exemplo de como um payload pode parecer:
Aqui está um exemplo de retorno esperado ao criar um monitoramento:
Aqui está um exemplo de como usar esses parâmetros de consulta com curl:
Atualizando um Monitoramento
Para atualizar um monitoramento, você pode fazer uma solicitação PATCH para a rota /tracking/{monitoramento}
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja atualizar.
Esta rota campos opcionais para atualização do tracking: recurrence
, tags
e o objeto de search
para a busca com exceção de alguns campos.
Aqui está um exemplo de como fazer isso usando curl:
Note que os campos search_type
e search_key
não são atualizáveis, somente são passados no momento da criação do monitoramento.
Consultando Seus Monitoramentos
Para consultar todos os seus monitoramentos, você pode fazer uma solicitação GET para a rota /tracking
. Esta rota aceita alguns parâmetros de consulta opcionais para paginar e filtrar os resultados:
page
: Define a página dos resultados que você deseja consultar.
page_size
: Define o número máximo de resultados que você deseja receber por página;
search_type
: retorna monitoramentos do tipo de referência especificado “cpf”, “cnpj”, “oab”, “lawsuit_cnj”, name ou rji;
search_key
: retorna monitoramentos com a buscar relacionadas ao número do CPF, CNPJ, OAB ou processo informado;
status
: retorna monitoramentos cujo status podem ser ‘created’, ‘updating’, ‘updated’, ‘paused’ ou ‘deleted’ ou mais de um de status [‘updating’, ‘paused’];
Aqui está um exemplo de como consultar seus monitoramentos usando curl:
Exemplo de notificação de webhook para monitoramento
Obs: Toda movimentação serão notificadas via webhook contendo o processo por completo, incrementando as últimas movimentações.
Obs Para cadastrar seu webhook, entre em contato com a equipe de suporte e solicite a criação.
Consultando Informações de um Monitoramento
Para consultar todas as informações sobre um monitoramento específico, você pode fazer uma solicitação GET para a rota /tracking/{monitoramento}
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja consultar.
Aqui está um exemplo de como fazer isso usando curl:
Aqui está o retorno esperado:
Pausando um Monitoramento
Para pausar um monitoramento, você pode fazer uma solicitação POST para a rota /tracking/{monitoramento}/pause
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja pausar.
Aqui está um exemplo de como pausar o monitoramento usando o curl:
Aqui está um exemplo de retorno do monitoramento pausado:
Reativando um Monitoramento
Para reativar um monitoramento pausado, você pode fazer uma solicitação POST para a rota /tracking/{monitoramento}/resume
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja reativar.
Aqui está um exemplo de como reativar um monitoramento usando curl:
Aqui está um exemplo de retorno do monitoramento ativo
Deletando um Monitoramento
Para deletar um monitoramento, você pode fazer uma solicitação DELETE para a rota /tracking/{monitoramento}
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja deletar.
Aqui está um exemplo de como deletar um monitoramento usando curl:
Aqui está um exemplo do retorno do monitoramento deletado:
E é isso! Com esses recursos, você pode manter-se atualizado sobre qualquer movimentação em processos judiciais de seu interesse. Se você tiver alguma dúvida ou encontrar algum problema, nossa equipe de suporte está à disposição para ajudá-lo. Entre em contato conosco através do nosso portal de suporte.
Não nos responsabilizamos por consulta por documento inválido, cobranças poderão ser efetuadas decorrente de uso indevido.