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>