Histórico da Página

...

Os serviços especificados neste documento serão consumidos na integração de ocorrências Ocorrências do Jurídico com o SIGAPFS.

02.

...

DEFINIÇÕES DO SERVIÇO

Os serviços demonstrados neste documentão nesta documentação serão consumidos pelo Sistema Jurídico.

...

02.1 Método de Busca Solicitações Aguardando Processamento

GET - /api/ocorrencia/pending/{codigoT}

Retorna uma lista com os dados das Solicitações que estão aguardando processamento.

02.1.1 Parâmetros da requisição

...

codigoT: Código da Configuração do Cliente Encodado em Base64. (vide configuração).

02.1.2 Response da

...

requisição

Abaixo seguem as possíveis respostas do serviço:

02.1.2.1 Sucesso - 200

A requisição irá retornar uma Lista lista com os dados da Solicitação para que o Sistema Jurídico comece a coletar as informações.

Bloco de código

language	js
theme	RDark
title	request.json
collapse	true

{
    "response": [
        {
            "id": "93109f2f1a4b5ffe-b075448d-ed114d11-abd9bbdf-b88584fbcf74",
            "entidade": "1",
            "campoRetorno": "VALOR_TOTAL1",
            "solicitante": {
                "nome": "Usuário TesteAdministrador",
                "email": "teste@totvswellington.machado@totvs.com.br"
            },
            "dataLog": {
                "inclusao": "20222023-1201-0605 2122:5105:5501.298104193688",
                "processamento":"2022-12-06 22:29:06.494160 "",
                "conclusao": ""
            },
            "contrato": {
                "codigo": "000322000323",
                "cliente": "OCORREWYKPFS",
                "loja": "01"
            },
            "ocorrencia": {
                "codigo": "000003000001",
                "descricao": "ValorNovos daprocessos causano de processosperiodo"
            },
            "dataReferencia": {
                "inicial": "2022010120200201",
                "final": "2022020120200301"
            },
            "filtros": [
                {
                    "campo": "VALORDATA_CAUSAENTRADA",
                    "tipo": "21",
                    "valor": "5000"
                },
                {
                    "campo": "STATUS_PROCESSO",
          "tipo":"2",
          "valortipo": "00000000092",
        }
      ],
      "casosvalor":[ "1"
        {
        }
  "cliente":"JLP001",
          "loja":"01"],
            "casocasos":"000044" [
        },
        {
                    "cliente": "JUR219WYKPFS",
                    "loja": "1901",
                    "caso": "000003"
                }
            ]
        }
    ]
}

Descrição das propriedades da solicitação

...

:

response: Array com os dados das Solicitações;
response[n].id: Identificação da Solicitação

;

(Formato UUIDv4);
response[n].entidade: Entidade jurídica da Solicitação

;

(vide dicionário);
response[n].campoRetorno: Tag para o

calculo

cálculo de valor para

Faturamento;

faturamento (vide dicionário);
response[n].solicitante: Agrupamento de dados do Solicitante;
response[n].solicitante.nome: Nome do Solicitante;
response[n].solicitante.email: E-mail do Solicitante;
response[n].dataLog: Agrupamento de Log da Solicitação;
response[n].dataLog.inclusao: Data/Hora da inclusão da Solicitação;
response[n].dataLog.processamento: Data/Hora

do

da resposta de processamento da Solicitação;
response[n].dataLog.conclusao: Data/Hora da conclusão da Solicitação;
response[n].contrato: Agrupamento dos dados do Contrato;
response[n].contrato.codigo: Código do Contrato;
response[n].contrato.cliente: Código do Cliente do Contrato;
response[n].contrato.loja: Loja do Cliente do Contrato;
response[n].ocorrencia: Agrupamento da Ocorrência;
response[n].ocorrencia.codigo: Código da Ocorrência;
response[n].ocorrencia.descricao: Descrição da Ocorrência;
response[n].dataReferencia: Agrupamento da Data de Referência;
response[n].dataReferencia.inicial: Data inicial para filtro dos registros;
response[n].dataReferencia.final: Data final para filtro dos registros;
response[n].filtros: Array de filtros adicionais;
response[n].filtros[i].campo: Campo a ser filtrado

;

(vide dicionário);
response[n].filtros[i].tipo: Tipo do Filtro

;

(vide dicionário);
response[n].filtros[i].valor: Valor a ser filtrado;
response[n].casos: Array de Casos do Contrato;
response[n].casos[i].cliente: Código do Cliente do Caso;
response[n].casos[i].loja: Loja do Cliente do Caso;
response[n].casos[i].caso: Código do Caso;

02.1.2.2 Erro Autenticação - 401

Retornará este erro quando o header de Authorization não for válido.

Bloco de código

language	js
theme	RDark
title	Response - 401
collapse	true

{
	"mensagem": "Falha na autenticação!"
}

...

02.2 Método de Movimentação da Solicitação para "Em Processamento"

PUT - /api/ocorrencia/pending/{codigoT}/{codigoSolicitacao}

...

Retorna uma lista com os dados das Solicitações que estão aguardando processamento

...

/progress

Movimenta a solicitação que está em "aguardando processamento" para "em processamento".

Ao realizar a chamada deste endpoint o sistema irá atualizar o status da solicitação, evitando que a Solicitação apareça em uma próxima consulta da Busca de Solicitações Aguardando Processamento

02.2.1 Parâmetros da requisição

codigoT: Código da Configuração do Cliente Encodado em Base64. (vide configuração);
codigoSolicitacao: ID da Solicitação a ser atualizada;

02.2.2 Body da requisição

Não há body para esta requisição no momento

02.2.3 Response da requisição

Abaixo seguem as possíveis respostas do serviço:

02.2.3.1 Sucesso - 200

Bloco de código

language	js
theme	RDark
title	Response - 200
collapse	true

{
	"mensagem": "A solicitação <id_solicitação> foi atualizada com sucesso!"
}

02.2.3.2 Erro Autenticação - 401

Retornará este erro quando o header de Authorization não for válido.

Bloco de código

language	js
theme	RDark
title	Response - 401
collapse	true

{
	"mensagem": "Falha na autenticação!"
}

02.2.3.3 Erro na atualização da solicitação - 404

Retornará este erro quando ocorrer erro na atualização dos dados da Solicitação.

Bloco de código

language	js
theme	RDark
title	Response - 404
collapse	true

{
    "mensagem": "Arquivo não foi encontrado!"
}

...

02.3 Método de Atualização da Solicitação com dados Jurídicos

PUT - /api/ocorrencia/progress/{codigoT}/{codigoSolicitacao}

Atualiza a Solicitação com os dados internos do Sistema Jurídico.

Obs: A solicitação precisa ter sido movimentada pelo método 'Movimentação da Solicitação para "Em Processamento"'.

02.3.1 Parâmetros da requisição

codigoT: Código da Configuração do Cliente Encodado em Base64. (vide configuração);
codigoSolicitacao: ID da Solicitação a ser atualizada;

02.

...

3.2 Body da requisição

...

O Body deve conter os registros que serão contabilizados para a geração da Fatura, respeitando a Entidade informada na Solicitação.

02.

...

3.2.1 Body da requisição - Processos

Bloco de código

language	js
theme	RDark
title	Body Processos
collapse	true

{
    "resposta": {
        "processos": [
            {
                "id": "84098e43-da2a-4816-b249-ef67f3e61476",
                "cliente": "JLP001",
                "loja": "01",
                "caso": "000044",
                "processo": {
                    "autor": "TOTVS SA",
                    "reu": "João da Silva",
                    "processo": "0014332-49.2011.4.01.4000"
                }, 
                <CAMPO_RETORNO>: 100000
            }
        ]
    }
}

Descrição das propriedades da solicitação

...

:

resposta: Agrupador da resposta;
resposta.processos: Array com os dados

processos

dos Processos a serem processados;
resposta.processos[n].id: Código do Processo;
resposta.processos[n].cliente: Código do Cliente;
resposta.processos[n].loja: Loja do Cliente;
resposta.processos[n].caso: Caso em que o Processo está vinculado;
resposta.processos[n].processo: Agrupamento do Processo;
resposta.processos[n].processo.autor: Autor do Processo;
resposta.processos[n].processo.reu: Réu do Processo;
resposta.processos[n].processo.processo: Numero do Processo;
* resposta.processos[n].<CAMPO_RETORNO>: Valor do campo de retorno (vide dicionário);

* Obs: Campo só será necessário se na Solicitação a chave "campoRetorno" estiver preenchido, caso contrário não deve ser enviado.

02.

...

3.2.2 Body da requisição - Atos Processuais

Bloco de código

language	js
theme	RDark
title	Body Atos Processuais
collapse	true

{
    "resposta": {
        "atosProcessuais": [
            {
                "id": "84098e43-da2a-4816-b249-ef67f3e61476",
                "cliente": "JLP001",
                "loja": "01",
                "caso": "000044",
                "processo": {
                    "autor": "TOTVS SA",
                    "reu": "João da Silva",
                    "processo": "0014332-49.2011.4.01.4000"
                },
                "ato": {
                    "descricao": "Petição inicial",
                 <CAMPO_RETORNO>:100000
   "data": "20230223"
                }
            }
        ]
    }
}

Descrição das propriedades da solicitação:

resposta: Agrupador da resposta;
resposta.atosProcessuais: Array com os dados dos Atos Processuais a serem processados;
resposta.atosProcessuais[n].id: Código do Ato Processual;
resposta.atosProcessuais[n].cliente: Código do Cliente;
resposta.atosProcessuais[n].loja: Loja do Cliente;
resposta.atosProcessuais[n].caso: Caso em que o Ato Processual está vinculado;
resposta.atosProcessuais[n].processo: Agrupamento do Processo;
resposta.atosProcessuais[n].processo.autor: Autor do Processo;
resposta.atosProcessuais[n].processo.reu: Réu do Processo;
resposta.atosProcessuais[n].processo.processo: Numero do Processo;
resposta.atosProcessuais[n].ato: Agrupamento do Ato processual;
resposta.atosProcessuais[n].ato.descricao: Descrição do Ato Processual;
resposta.atosProcessuais[n].ato.data: Data do Ato Processual;

02.3.3 Response da requisição

Abaixo seguem as possíveis respostas do serviço:

02.3.3.1 Sucesso - 200

Bloco de código

language	js
theme	RDark
title	Response - 200
collapse	true

{
	"mensagem": "A solicitação <id_solicitação> foi atualizada com sucesso!"
}

02.3.3.2 Erro Autenticação - 401

Retornará este erro quando o header de Authorization não for válido.

Bloco de código

language	js
theme	RDark
title	Response - 401
collapse	true

{
	"mensagem": "Falha na autenticação!"
}

02.3.3.3Erro no Body da Requisição- 400

Retornará este erro quando o Body passado para a requisição contiver erros de Encode ou não respeitar a estrutura esperada.

Bloco de código

language	js
theme	RDark
title	Response - 400
collapse	true

{
	"mensagem": "Body não encontrado!"
}

02.3.3.4Erro na atualização da solicitação - 404

Retornará este erro quando ocorrer erro na atualização dos dados da Solicitação.

Bloco de código

language	js
theme	RDark
title	Response - 404
collapse	true

{
	"mensagem": "Erro na atualização do arquivo da solicitação!"
}

03. TABELAS UTILIZADAS

04.

...

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 19

Nova versão Atual

Chave

02.

DEFINIÇÕES DO SERVIÇO

02.1 Método de Busca Solicitações Aguardando Processamento

GET - /api/ocorrencia/pending/{codigoT}

02.1.1 Parâmetros da requisição

codigoT: Código da Configuração do Cliente Encodado em Base64. (vide configuração).

02.1.2 Response da

requisição

02.1.2.1 Sucesso - 200

02.1.2.2 Erro Autenticação - 401

02.2 Método de Movimentação da Solicitação para "Em Processamento"

PUT - /api/ocorrencia/pending/{codigoT}/{codigoSolicitacao}

/progress

02.2.1 Parâmetros da requisição

02.2.2 Body da requisição

02.2.3 Response da requisição

02.2.3.1 Sucesso - 200

02.2.3.2 Erro Autenticação - 401

02.2.3.3 Erro na atualização da solicitação - 404

02.3 Método de Atualização da Solicitação com dados Jurídicos

PUT - /api/ocorrencia/progress/{codigoT}/{codigoSolicitacao}

02.3.1 Parâmetros da requisição

02.

3.2 Body da requisição

O Body deve conter os registros que serão contabilizados para a geração da Fatura, respeitando a Entidade informada na Solicitação.

02.

3.2.1 Body da requisição - Processos

02.

3.2.2 Body da requisição - Atos Processuais

02.3.3 Response da requisição

02.3.3.1 Sucesso - 200

02.3.3.2 Erro Autenticação - 401

02.3.3.3Erro no Body da Requisição- 400

02.3.3.4Erro na atualização da solicitação - 404

03. TABELAS UTILIZADAS

04.

DOCUMENTOS DE REFERÊNCIA