Processos
Os processos serão utilizados para atualizar um cnj
Campos
Campo | Tipo | Obrigatório | Descrição |
---|---|---|---|
numero | string | Sim | Número CNJ que representa o processo |
instancia | string | Não | Instância em que o processo está tramitando |
assuntos | list | Não | Assunto(s) encontrado(s) do processo |
detalhes | dict | Não | Detalhes do processo. Pode conter qualquer informação econtrada do processo que não seja os demais campos aqui descritos |
orgao_julgador | string | Não | Órgão julgador do processo |
tribunal | string | Não | Nome do tribunal em que o processo está tramitando |
comarca | string | Não | Comarca do processo |
orgao_julgador | string | Não | Órgão julgador do processo |
andamentos | list | Não | Lista de todos os andamentos encontrados para o processo. Cada andamento contém um campo de texto, data, complemento e um campo novo que indica se o andamento encontrado é novo. |
partes | list | Não | Lista das partes encontradas para o processo |
Cadastro de Processos
O cadastro de processos será realizado por uma requisição POST
enviando o valor do CNJ do processo
Requisição
O formato da requisição deve ser:
curl -v -X POST \
-H "Authorization: Token <token>" \
"https://homologacao.ws.justicafacil.com.br/processos/" \
--data "numero=<numero_cnj>"
O dado será enviado segundo o dicionário:
data={
numero: '<numero_cnj>'
}
Resposta
Em caso de sucesso a resposta será o processo criado em formato XML com HTTP Status 200.
<?xml version="1.0" encoding="utf-8"?>
<root>
<id>1</id>
<numero>Número CNJ</numero>
<instancia>0</instancia>
<assuntos></assuntos>
<detalhes></detalhes>
<orgao_julgador></orgao_julgador>
<tribunal></tribunal>
<comarca></comarca>
<partes></partes>
<andamentos></andamentos>
</root>
Obs.: Essa requisição irá iniciar uma busca pelas informações deste CNJ nos sites dos devidos tribunais.
Erros
Abaixo serão listados os possíveis erros com um HTTP Status 400
- Número CNJ inválido
O cadastro de processos somente aceitará números de CNJ válidos.
<?xml version="1.0" encoding="utf-8"?>
<root>
<numero>
<list-item>O numero (numero) não é um padrão CNJ</list-item>
</numero>
</root>
- Número CNJ em branco
O cadastro de processos não aceitará número CNJ em branco.
<?xml version="1.0" encoding="utf-8"?>
<root>
<numero>
<list-item>Este campo não pode ser em branco.</list-item>
</numero>
</root>
Consulta de processos
Os processos criados poderão ser consultados. Para consultar um processo é necessário enviar uma requisição GET
.
Consulta processos ativos
Para receber a listagem dos processos ativos
vinculados ao usuário é necessário fazer uma requisição GET
sem informar o CNJ.
Requisição
O formato da requisição deve ser:
curl -v -X GET \
-H "Authorization: Token <token>" \
"https://homologacao.ws.justicafacil.com.br/processos/?itens=<valor>&pagina=<valor>" \
Atributos query string
Opção | Tipo | Formato | Padrão | Descrição |
---|---|---|---|---|
pagina | Inteiro | Numerico | 1 | Número da página requisitada |
itens | Inteiro | Numerico | 20 | Número de itens por página |
Resposta
Em caso de sucesso a resposta será os processos ativos e vinculados ao usuário que fez a requisição em formato XML com HTTP Status 200.
<?xml version="1.0" encoding="utf-8"?>
<root>
<paginacao>
<pagina_atual>1</pagina_atual>
<itens>2</itens>
<itens-por-pagina>20</itens-por-pagina>
</paginacao>
<processos>
<list-item>
<id>1</id>
<numero>Número CNJ</numero>
<instancia>0</instancia>
<assuntos></assuntos>
<detalhes></detalhes>
<orgao_julgador></orgao_julgador>
<tribunal></tribunal>
<comarca></comarca>
<partes></partes>
<andamentos></andamentos>
</list-item>
<list-item>
<id>2</id>
<numero>Número CNJ</numero>
<instancia>0</instancia>
<assuntos></assuntos>
<detalhes></detalhes>
<orgao_julgador></orgao_julgador>
<tribunal></tribunal>
<comarca></comarca>
<partes></partes>
<andamentos></andamentos>
</list-item>
</processos>
</root>
Caso não existam processos a serem exibidos o resultado será:
<?xml version="1.0" encoding="utf-8"?>
<root></root>
Consulta de processo por CNJ
Para consultar um processo específico é necessário enviar uma requisição GET
informando o número CNJ
.
Requisição
O formato da requisição deve ser:
curl -v -X GET \
-H "Authorization: Token <token>" \
"https://homologacao.ws.justicafacil.com.br/processos/<cnj>/?itens=<valor>&pagina=<valor>" \
Atributos query string
Opção | Tipo | Formato | Padrão | Descrição |
---|---|---|---|---|
pagina | Inteiro | Numerico | 1 | Número da página requisitada |
itens | Inteiro | Numerico | 20 | Número de itens por página |
Resposta
Em caso de sucesso a resposta será o(s) processo(s) consultado(s) em formato XML com HTTP Status 200.
<?xml version="1.0" encoding="utf-8"?>
<root>
<paginacao>
<pagina_atual>1</pagina_atual>
<itens>1</itens>
<itens-por-pagina>20</itens-por-pagina>
</paginacao>
<processos>
<list-item>
<id>1</id>
<numero>Número CNJ</numero>
<instancia>0</instancia>
<assuntos></assuntos>
<detalhes></detalhes>
<orgao_julgador></orgao_julgador>
<tribunal></tribunal>
<comarca></comarca>
<partes></partes>
<andamentos></andamentos>
</list-item>
</processos>
</root>
Obs.: Podem existir mais de um processo para um mesmo CNJ quando este processo existe em mais de uma instância.
Caso nenhum processo com o CNJ informado for encontrado a resposta será vazia com HTTP Status 200:
<?xml version="1.0" encoding="utf-8"?>
<root></root>