Listar processos do escritório

Listar processos

Devolve a página de processos do seu escritório. É a coleção do recurso — diferente de GET /v2/processos/opcoes, que existe só para preencher um campo de seleção.

Campos: os mesmos da rota de seleção (id, numero, tribunal, grau, partes) mais encerrado e monitoramentoAtivo — a captura automática do tribunal. Os dois estados são independentes: um processo pode estar encerrado e monitorado ao mesmo tempo. monitoramentoAtivo é o mesmo nome aceito no cadastro/edição, então o valor lido aqui pode ser reenviado sem tradução.

Cada um dos dois tem o filtro de mesmo nome — o que a listagem devolve é exatamente o que o filtro seleciona.

Tribunal: tribunal vem sempre preenchido — todo processo aponta para uma linha de tribunais, inclusive quando não há tribunal de fato: nesses casos vem Sem Tribunal, ou Processo Administrativo no administrativo. grau pode vir nulo, porque não é toda linha de tribunais que o define — o administrativo é um desses casos.

Nulos: partes vem nulo em processo que nunca foi capturado.

Ordenação: por número do processo, crescente.

Escopo: só processos não excluídos do escritório do token.

Filtros

Omitir um filtro não filtra por ele — nenhum tem valor padrão que restrinja o resultado. Sem nenhum parâmetro, a rota devolve todos os processos do escritório. Se a tela abre pré-filtrada por ativos, é ela que envia encerrado=false.

Filtro	Efeito
q	Barra de pesquisa — casa pelo começo do número do processo. Vazio ou omitido, não filtra.
encerrado	true só encerrados; false só não encerrados; omitido, os dois.
monitoramentoAtivo	true só com captura automática ligada; false só desligada; omitido, os dois.
cpfCnpjCliente	CPF/CNPJ exato, com ou sem máscara, da pessoa vinculada ao processo como cliente.

Filtros combinam por E. ?encerrado=true&monitoramentoAtivo=true devolve os processos que são encerrados e monitorados — são eixos independentes, não opções de uma mesma lista. A busca entra na mesma conjunção: ?q=2024&encerrado=false procura "2024" dentro dos não encerrados.

Sobre a busca (q)

Casa pelo começo do número, não por trecho no meio. 1011214 acha o processo 1011214-58.2024.8.26.0477; 0477 (o final) e 2024 (o ano, no meio) não acham nada. É uma escolha deliberada: buscar por trecho arbitrário impede o uso de índice e fazia esta listagem levar dez segundos num escritório grande.

A máscara é indiferente. 1011214-58.2024 e 1011214582024 acham o mesmo processo. O número pode estar gravado com ou sem máscara — as duas formas são procuradas.

Hoje procura só no número do processo. O parâmetro é uma barra de pesquisa, não um filtro por número: conforme a tela evoluir ele passará a procurar também em outros campos (partes, pasta, número interno). Se você precisa de correspondência exata e estável por um campo específico, não use q — ele é melhor-esforço por definição.