SUMÁRIO

1. JUSAPI

• 1.1. Boas-vindas
• 1.2. Nossos Produtos
• 1.3. Suporte

2. INTEGRAÇÃO

• 2.1. RESTful API
• 2.2. Funções NOTIFICA
• 2.2.1. GET importaNotas
• 2.2.2. POST confirmaNotas
• 2.3. Tipos
• 2.4. Acesso: Usuário e Senha

3. ERROS FREQUENTES

• 3.1. Notifica

1.1. Boas-vindas

Primeiramente, obrigado por escolher a JusAPI, temos muito orgulho em ser seu parceiro nessa jornada tecnológica! Conte conosco para solicitar novas funcionalidades que farão a diferença em sua rotina. Nossa missão é auxiliar na realização dos seus sonhos, trazendo leveza, facilidade e tranquilidade à sua vida.

1.2. Nossos Produtos

Conheça todos os serviços inovadores prestados pela JusAPI:

• INTERPRETA: API para interpretação de Notas de Expediente. Provemos API para desenvolvedores integrarem Inteligência Artificial em qualquer software jurídico já existente. Permitimos também, a interpretação automatizada de perguntas personalizadas.
• NOTIFICA: Fornecimento de Notas de Expediente e Andamentos Processuais. Entregamos para o cliente os andamentos e publicações de seus processos dos Diários Oficiais da Justiça de todo o país.
• PREDITA: Data Mining preditivo para tomada de decisões. Identificamos comportamentos processuais, gerando insights que tragam capacidade de planejamento e novas oportunidades de faturamento.
• RASTREA: Big Data Judicial para rastreio de dados pretéritos. Realizamos a busca por informações retroativas, permitindo também, a reconstituição histórica de uma base de processos.

1.3. Suporte

Em caso de dúvidas ou problemas, não exite em nos contatar por WhatsApp, email ou telefone!

2.1. RESTful API

API é o acrônimo inglês para “Interface de Programação de Aplicações”, como uma plataforma de micro-serviços para sistemas de informação. O fornecimento de serviços via API tem crescido exponencialmente, liderado por empresas como Google, Amazon, IBM… pois empoderam softwares, com tecnologias disruptivas, facilitando acessos e integrações.

REST é o acrônimo inglês para “Transferência de Estado Representacional”, uma arquitetura que ignora detalhes de sintaxe de protocolo e implementação de componentes, com o objetivo de focar nos componentes e na interpretação de elementos significantes. O cumprimento dos itens abaixo classifica formalmente a arquitetura como RESTful. Embora muitos não se apeguem ao formalismo.

• Usa o protocolo HTTP (verbos, accept headers, códigos de estado HTTP, Content-Type) de forma explícita e representativa para se comunicar. URIs são usados para expor a estrutura do serviço. Utiliza uma notação comum para transferência de dados como XML ou JSON.
• Não possui estado entre essas comunicações, ou seja, cada comunicação é independente e uniforme (padronizada) precisando passar toda informação necessária.
• Deve facilitar o cache de conteúdo do cliente.
• Deve ter clara definição do que faz parte do cliente e do servidor. O cliente não precisa saber como o servidor armazena dados, por exemplo. Assim, cada implementação não depende da outra e se torna facilmente escalável.
• Permite o uso em camadas, facilitando a escalabilidade, confiabilidade e segurança.
• Frequentemente é criado com alguma forma de extensibilidade.

A integração com a nossa API é realizada através do envio de requisições para o seguinte endereço que hospeda nossa RESTful API:

https://www.sijur.com.br/api/{função}/{tipo}?usuario={usuario}&senha={senha}

Obedecendo as seguintes reposições:

• {função} : Função da API que deseja executar.
• {tipo} : xml ou json.
• {usuário} : Nome de usuário fornecido pela JusAPI.
• {senha} : Senha de acesso fornecida pela JusAPI.

2.2. Funções NOTIFICA

A JusAPI deu um passo além dos outros sistemas, que apenas executam busca e entrega de publicações. Para facilitar a vida dos operadores do direito, prestamos um serviço que consiste em pesquisar em todos os Diários da Justiça dos: Estados, União, Distrito Federal e Instâncias Superiores, em busca das Notas de Expediente endereçadas aos nossos clientes. Reunimos e repassamos diariamente as informações das Notas, juntamente com a interpretação realizada por nossa Inteligência Artificial.

2.2.1. GET importaNotas

https://www.sijur.com.br/api/importaNotas/{tipo}?usuario={usuario}&senha={senha}

1. Comandos do tipo GET trazem informações.
2. Esta função realiza a importação de até 100 Notas de Expediente disponíveis e não confirmadas (função confirmaNotas) no sistema.
3. A pesquisa pelas Notas de Expediente a serem importadas é baseada em termos predefinidos pelo cliente.
4. Ao importar e confirmar todas as Notas de Expediente disponíveis no sistema, a função importaNotas retornará null.

Retornos da função importaNotas:

• records : Quantia de Notas de Expediente importadas.
• data : Coleção de registros.
• id : Código identificador da Nota de Expediente.
• siglaDiario : Sigla do Diário da Justiça de onde saiu a publicação.
• data : Data que recebemos a Nota de Expediente.
• dataDisponibilizacao : Data de publicação da Nota de Expediente.
• nota : Texto da Nota de Expediente.
• processo : Número do processo.
• orgao : Órgão julgador.
• escritorioid : ID do escritório que importou a Nota de Expediente.
• esferaDiario : Federal ou Estadual.
• numEdicao : Número da edição do diário.
• termoPesquisado : Termo que retornou esta Nota de Expediente.
• oab : Registro OAB pesquisado.
• estado : Estado de origem da publicação.
• classificacao : Classificação realizada pelo JusAPI.

<data>
    <sucesso>1</sucesso>
    <data>
        <records>1</records>
        <data>
            <id>{id}</id>
            <siglaDiario>{siglaDiario}</siglaDiario>
            <data>{data}</data>
            <dataDisponibilizacao>{dataDisponibilizacao}</dataDisponibilizacao>
            <nota>{nota}</nota>
            <processo>{processo}</processo>
            <orgao>{orgao}</orgao>
            <escritorioid>{escritorioid}</escritorioid>
            <esferaDiario>{esferaDiario}</esferaDiario>
            <numEdicao>{numEdicao}</numEdicao>
            <termoPesquisado>{termoPesquisado}</termoPesquisado>
            <oab>{oab}</oab>
            <estado>{estado}</estado>
            <classificacao>{classificacao}</classificacao>
        </data>
    </data>
</data>

{
    "sucesso": true,
    "data": {
        "records": 1,
        "data": {
            "id": |id|,
            "siglaDiario": |siglaDiario|,
            "data": |data|,
            "dataDisponibilizacao": |dataDisponibilizacao|,
            "nota": |nota|,
            "processo": |processo|,
            "orgao": |orgao|,
            "escritorioid": |escritorioid|,
            "esferaDiario": |esferaDiario|,
            "numEdicao": |numEdicao|,
            "termoPesquisado": |termoPesquisado|,
            "oab": |oab|,
            "estado": |estado|,
            "classificacao": |classificacao|
        }
    }
}

2.2.2. POST confirmaNotas

https://www.sijur.com.br/api/confirmaNotas/{tipo}?usuario={usuario}&senha={senha}

1. Body Parameters : JSON com Array de IDs das Notas Importadas. Exemplo:

• [123654,159756,3215,32548]

2. Comandos do tipo POST criam/adicionam informações.
3. Esta função realiza a confirmação da importação de cada Nota de Expediente, cujos dados forem enviados pela função confirmaNotas.
4. A função confirmaNotas confirmará apenas as Notas de Expediente cujos dados forem enviados.
5. As Notas de Expediente importadas pela função importaNotas atualiza conforme a quantia retornada pela confirmaNotas.

Retornos da função confirmaNotas:

• confirmadas : IDs das Notas de Expediente queforam confirmadas o recebimento com sucesso.
• nao_confirmadas : IDs das Notas de Expediente cujos valores informados são inválidos ou já tenham sido registradas como “confirmadas”, não gerando alteração no sistema.

<data>
    <sucesso>1<sucesso>
    <data>
        <confirmadas>{confirmadas}</confirmadas>
        <nao_confirmadas>{nao_confirmadas}</nao_confirmadas>
    </data>
</data>

{
    "sucesso": true,
    "data": {
        "confirmadas": |confirmadas|,
        "nao_confirmadas": |nao_confirmadas|
    }
}

2.3. Tipos

O retorno pode se dar tanto em XML quanto JSON, de acordo com a preferência utilizada pelo sistema a ser integrado. Caso ainda não trabalhe com nenhuma, recomendamos JSON por ser uma tecnologia mais recente, a definição como visto é dada preenchendo {tipo}.

<data>
    <sucesso>1</sucesso>
    <data>{conteudo retornado conforme função}</data>
</data>

{
    "sucesso": true,
    "data": {conteudo retornado conforme função}
}

2.4. Acesso: Usuário e Senha

As definições de Usuário e Senha, assim como demais opções de recebimento de dados, são definidas em reunião, para agilizar o início do processo de integração.

3.1. Notifica

1. Página carregada mas em branco pode ser causada pelo seguinte erro:

1. Tipo (XML ou JSON) incorreto.
2. Função importaNotas ou confrmaNotas inexistente.

2. Mensagem: “Credenciais informadas não correspondem a nenhum usuário de API.”pode ser causada pelos seguintes erros:

1. Nome de usuário incorreto.
2. Senha de acesso incorreta.

3. Mensagem: “Requisição sem credenciais.” pode ser causada pelos seguintes erros:

1. Função “usuario=” incorreto ou inexistente.
2. Função “senha=” incorreta ou inexistente.

4. Mensagem: “Função (XXXX) não válida para esse objeto.” pode ser causada pelos seguintes erros:

1. Função importaNotas ou confrmaNotas incorreta.