1
Criação do monitoramento
Payload da Solicitação
A solicitação POST deve incluir um payload com as seguintes propriedades:search_type: Este campo define o tipo de entidade que será buscada. Os valores possíveis são:cpf
, cnpj
, oab
, name
, lawsuit_cnj
ou lawsuit_id
. Para buscas processuais, utilizaremos especificamente cpf
, cnpj
ou oab
, que correspondem ao número do processo.-
search_key
: O número do processo (Código CNJ), CPF, CNPJ, OAB ou Name que você deseja buscar; -
cache_ttl_in_days
(opcional): Número inteiro que define até quantos dias o resultado da busca pode considerar um cache válido; -
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; -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.
filter
deve ser incluído dentro de search_params
, com os seguintes filtros disponíveis:-
filter
(opcional): Um objeto que contém os filtros para a busca, como: -
side
(opcional): Permite buscar por tipos de participantes do processo, podendo ser: ‘Passive’, ‘Active’, ‘Interested’, ‘Unknown’; -
amount_gte
(opcional): Filtra processos com valor da causa maior ou igual ao especificado emamount_gte
; -
amount_lte
(opcional): Filtra processos com valor da causa menor ou igual ao especificado emamount_lte
; -
tribunals
(opcional): Um objeto que contém os filtros de tribunais:keys
(opcional): Lista de códigos de tribunais disponíveis na lista de tribunais. Este filtro permite restringir a busca a processos que tenham ou não esses códigos específicos;not_equal
(opcional): Valor booleano que define se o filtro incluirá ou excluirá os valores especificados emkeys
.
-
subject_codes
(opcional): Um objeto que contém os filtros de assuntos:contains
(opcional): Lista de códigos de assuntos. Restringe a busca a processos que incluam os códigos especificados.not_contains
(opcional): Lista de códigos de assuntos. Exclui processos que contenham os códigos especificados.
-
classification_codes
(opcional): Um objeto que contém os filtros de classes processuais:keys
(opcional): Lista de códigos de classes processuais. Este filtro permite restringir a busca a processos que tenham ou não esses códigos específicos;not_equal
(opcional): Valor booleano que define se o filtro incluirá ou excluirá os valores especificados emkeys
.
-
distribution_date_gte
(opcional): Permite especificar uma data mínima de distribuição. Este filtro localiza processos distribuídos após a data informada. -
credential
(opcional): Objeto para o uso do cofre de credenciais: -
customer_key
(opcional): Permite passar a chave do usuário cadastrada no cofre de credenciais. Caso não seja informada, a API tentará encontrar uma credencial cadastrada para umacustomer_key
vazia. -
last_step_date_gte
(opcional): Restringe a busca a processos cuja data da última movimentação seja maior que à data fornecida. -
last_step_date_lte
(opcional): Restringe a busca a processos cuja data da última movimentação seja menor que à data fornecida. -
party_names
(opcional): Lista de nomes que restringe a busca a processos que os contenham em alguma das partes.Obs
Ao utilizar esse filtro em conjunto com o filtro deSide
, o filtro deSide
não será considerado para a restrição dessas partes, já que o filtro deSide
é utilizado para filtrar processos onde a parte principal buscada esteja no lado especificado. -
party_documents
(opcional): Lista de documentos que restringe a busca a processos que os contenham em alguma das partes.Obs
Ao utilizar esse filtro em conjunto com o filtro deSide
, o filtro deSide
não será considerado para a restrição desses documentos, já que o filtro deSide
é utilizado para filtrar processos onde a parte principal buscada esteja no lado especificado. -
notification_emails
(opcional): Array de strings fora dosearch
que podem ser adicionados emails para os quais deseja receber notificação a cada atualização do monitoramento cadastrado.
O monitoramento irá ser iniciado a primeira vez, na melhor janela de
concorrência de requisição ao tribunal, dentro das próximas 24 horas
da data de criação.
Todas os monitoramentos de novas ações processuais cadastradas são realizadas on-demand. Recomendamos verificar as condições de custo associadas a este serviço antes de sua utilização.
Na resposta da criação do monitoramento, é retornado o campo
hour_range
, que indica o horário em que a consulta aos tribunais serão realizada pela primeira vez. No exemplo acima, a primeira consulta está programada para ocorrer às 21 horas.2
Consultar o status do monitoramento
Na URL vai o tracking_id retornado na primeira requisição:Retorno:A propriedade status informa a situação atual do monitoramento,
podendo ser:
- created: Monitoramento criado, porém nunca executado.
- updating: Está com uma requisição em processamento.
- updated: Monitoramento atualizado já com alguma resposta disponível. O campo updated_at pode informar a data de última atualização do monitoramento e a propriedade request_id o id da última request feita pelo monitoramento.
- paused: Monitoramento pausado, podendo ainda ser reativado.
- deleted: Monitoramento cancelado e não pode mais ser reativado.
3
Consultar o conteúdo da resposta (nova ação encontrada)
Na URL vai o request_id retornado na primeira requisição:
O parâmetro page e page_size são opcionais, porém necessários para
percorrer as páginas com os processos, caso venham mais de uma, o
que é comum no caso de consulta por documento.
O significado de cada campo pode ser encontrado no glossário:https://docs.judit.io/essentials/glossary
Exemplo de retorno da Request
Exemplo de retorno da Request
As propriedades de paginação:
As propriedades de paginação:
No caso de monitoramento de documento, ele sempre será de novas
ações, ou seja, as requisições só gerarão respostas caso um novo
processo seja distribuído.
4
Consultando histórico de um monitoramento
Para consultar o histórico de respostas geradas por um monitoramento específico, faça uma solicitação GET para a rota /tracking/, substituindo pelo ID do monitoramento desejado.Você pode filtrar os resultados usando os parâmetros Aqui está o retorno esperado:
created_at_gte
e created_at_lte
, onde:created_at_gte
: define a data inicial da consulta.
created_at_lte
: define a data final da consulta.Aqui está um exemplo de como fazer isso usando curl:5
Pausando um Monitoramento
Para pausar um monitoramento, você pode fazer uma solicitação POST para a rota Aqui está um exemplo de retorno do monitoramento pausado:
/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:6
Reativando um Monitoramento
Para reativar um monitoramento pausado, você pode fazer uma solicitação POST para a rota Aqui está um exemplo de retorno do monitoramento ativo
/tracking/{monitoramento}/resume
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja reativar.Aqui está um exemplo de como reativar um monitoramento usando curl:7
Deletando um Monitoramento
Para deletar um monitoramento, você pode fazer uma solicitação DELETE para a rota Aqui está um exemplo do retorno do monitoramento deletado:
/tracking/{monitoramento}
, substituindo {monitoramento}
pelo ID do monitoramento que você deseja deletar.Aqui está um exemplo de como deletar um monitoramento usando curl: