Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

PassoDescriçãoImagem
1- Cadastro do Contrato

Para o Faturamento das ocorrências precisamos vincula-la a um contrato.

Os campos abaixo são importantes para o preenchimento dos dados da solicitação ou para o filtro dos dados.

Contrato:

  • Descrição: Descrição do Contrato
  • *Cliente/Loja: Cliente do Contrato. 
  • *Moeda: Moeda que será utilizada na Pré-Fatura. 
  • *Sócio: Sócio responsável do Contrato
  • *Escritório: Escritório vinculado ao Contrato
  • *Tipo de Honorário: Tipo de Honorário vinculado ao Contrato
  • Ativo: Se o contrato está ativo ou não. ( Obrigatório estar ativo )
  • Situação: Situação do Contrato. 1=Provisário;2=Definitivo. ( O Contrato precisa ser definitivo )

Caso:

  • Os casos vinculados não precisam ser necessariamente do mesmo Cliente do Contrato.

Pagadores:

  • Os pagadores informados no Contrato serão utilizados como Pagadores na Fatura Adicional.

Para a Geração de Solicitações de Ocorrência é necessário que o Contrato esteja Ativo e que a Situação seja Definitivo.

Obs: Os campos sinalizados por (*) são utilizados como Filtros na geração da Solicitação.

2- Cadastro das Faixas de Faturamento

Após o cadastro do Contrato o usuário pode vincular o Cadastro de Ocorrência através do botão "Faixa Ocorr." que está no menu "Outras Ações" dentro do Contrato.

Nesse menu o usuário poderá vincular qualquer ocorrência que desejar e vai definir as Faixas de Faturamento para cada ocorrência. As faixas irão refletir diretamente no valor calculado na Fatura Adicional que o sistema irá gerar.

No cabeçalho:

  • Cód. Ocorrên: Código da Ocorrência a ser vinculada
  • Tipo Faixa: Tipo de Calculo que será considerado entre as faixas. 1=Estática;2=Progressiva;
    • Estática: Utiliza o valor individual da faixa para compor o valor final
    • Progressiva: Utiliza o valor das faixas retroativas para compor o valor final
  • Tipo Calculo: Tipo de calculo a ser feito. 1=Quantidade;2=Valor
    • Quantidade: Será considerada a quantidade de registros retornado pelo Sistema Jurídico.
    • Valor: Levará em conta o Valor sinalizado no Campo de Retorno informado na Ocorrência.

Nas faixas:

  • Seq: Sequencial das Faixas
  • Vlr. Inicial: Valor inicial da Faixa
  • Vlr. Final: Valor final da Faixa
  • Tipo Valor: Tipo de calculo da Faixa; 1=Valor Fixo; 2=Valor Unitário; 3=% a Cobrar
    • Valor Fixo: O valor final será o valor da Faixa.
    • Valor Unitário: Para cada ocorrência que se encontra nessa faixa será cobrado o valor; ( Valor x Quantidade Ocorrências)
    • % a Cobrar: Essa faixa irá utilizar o Campo de Retorno para realizar o calculo final. Indicado quando a Ocorrência retorna campos de Valor, como VALOR_CAUSA e VALOR_ENVOLVIDO.
  • Valor: Valor a ser cobrado. Levar em consideração a regra abaixo:
    • Quando o Tipo de Valor for % a Cobrar o Valor informado será convertido em Percentual. Exemplos:
      • Valor = 50.00 → Percentual = 50%
      • Valor = 100.00 → Percentual = 100%
      • Valor = 0.50 → Percentual = 0.5%
    • Levando em consideração esse calculo segue o exemplo abaixo:
      • Caso uma ocorrência tenha VALOR_CAUSA igual a R$ 1000.00 e o Valor for igual a 50.00, o valor final será R$ 500.00. 

Obs: Quando o Tipo de Calculo for Quantidade os Valores Iniciais e Finais devem finalizar sem valores decimais, enquanto o Tipo de Calculo for Valor os intervalos tem que ser complementados com decimais conforme exemplo abaixo:

SequencialTipo CalculoValor inicialValor Final
Faixa_Quant_01Quantidade0.001999.00
Faixa_Quant_02Quantidade2000.009999999.00
Faixa_Valor_01Valor0.001999.98
Faixa_Valor_02Valor1999.999999999.99


Para maiores informações consultar: Faixa de faturamento de Ocorrências - JURA302

Image Added







06. FLUXO DA SOLUÇÃO

PassoDescriçãoImagem
1- Emissão de Ocorrências

Com os contratos previamente cadastrados o usuário irá acessar a rotina de Emissão de Ocorrências

Nesta tela o usuário irá informar as solicitações que deseja criar para o Jurídico e informará o período de referência que deve ser utilizado pelo Sistema Jurídico.

Filtros disponíveis:

  • Sócio: Sócio do Contrato
  • Moeda: Moeda do Contrato
  • Contrato: Código do Contrato
  • Grupo de Clientes: Grupo de Cliente do Contrato
  • Cliente: Cliente do Contrato
  • Escritório: Escritório do Contrato
  • Ocorrência Código da Ocorrência
  • Tipo de Honorários: Tipo de Honorário do Contrato

Referência: O valor representado nos campos de Data são para orientar o Sistema Jurídico do período que precisa ser considerado na extração dos dados

  • Data Inicial: Data inicial de processamento da ocorrência
  • Data Final: Data final de processamento da ocorrência

Para mais informações consultar: Emissão de Ocorrências - JURA305.


Após o processamento dos contratos a partir dos filtros informados as solicitações serão gravadas no Cloud para que o Sistema Jurídico possa consultar as ocorrências.


2 - Monitor das Solicitações

Após a geração das ocorrências e envio das informações para o Cloud, o sistema irá criar os registros correspondentes no Monitor de Solicitações, de modo que permita ao usuário analisar o andamento de cada solicitação.


Para mais informações consultar:  Solicitações de Ocorrências - JURA306

3 - Interação Sistema Jurídico

A partir do momento que o usuário realizar a solicitação o usuário não tem mais ação sobre as Solicitações que abriu.

Com isso entra a parte do Sistema Jurídico que irá buscar os dados das Solicitações e irá enviar os dados que extraiu.

Para demonstrar os passos seguintes iremos usar o registro 000321 que está posicionado no passo anterior.

Para mais informações sobre o conteúdo do JSON consultar:  Serviço de Solicitação de Ocorrência.


Bloco de código
languagejs
themeRDark
titleJSON da Solicitação
collapsetrue
{
  "id":"5257a34f-317a-ed11-abda-b88584fbcf74",
  "entidade":"1",
  "campoRetorno":"1",
  "solicitante":{
    "nome":"Administrador",
    "email":"[email protected]"
  },
  "dataLog":{
    "inclusao":"2022-12-12 15:26:15.344873",
    "processamento":"",
    "conclusao":""
  },
  "contrato":{
    "codigo":"000321",
    "cliente":"WYKPFS",
    "loja":"01"
  },
  "ocorrencia":{
    "codigo":"000001",
    "descricao":"Novos processos no periodo"
  },
  "dataReferencia":{
    "inicial":"20220601",
    "final":"20220701"
  },
  "filtros":[
    {
      "campo":"DATA_ENTRADA",
      "tipo":"1",
      "valor":""
    },
    {
      "campo":"STATUS_PROCESSO",
      "tipo":"2",
      "valor":"1"
    }
  ],
  "casos":[
    {
      "cliente":"WYKPFS",
      "loja":"01",
      "caso":"000001"
    },
    {
      "cliente":"WYKPFS",
      "loja":"01",
      "caso":"000002"
    }
  ]
}
3.1 - Buscando as Solicitações que estão Pendente

Temos disponibilizado uma API para que o Sistema Jurídico consiga receber os dados das solicitações que estão aguardando o processamento.

Abaixo segue um exemplo de requisição para buscar todas as Solicitações pendentes. Onde {{juridicoapi}} é o endereço da API e o {{codigoT}} é o código do cliente que foi gerado na Configuração da Integração.

Abaixo é como fica o retorno da requisição. É possivel notar que o retorno é uma Lista com os dados de cada solicitação que esta como Pendente.

O retorno está descrito na especificação do Serviço de Solicitação de Ocorrência.

Bloco de código
languagejs
themeRDark
titleRetorno das Solicitações
collapsetrue
{
    "response": [
        {
            "id": "18b516da-307a-ed11-abda-b88584fbcf74",
            "entidade": "1",
            "campoRetorno": "1",
            "solicitante": {
                "nome": "Administrador",
                "email": "[email protected]"
            },
            "dataLog": {
                "inclusao": "2022-12-12 15:23:03.465535",
                "processamento": "",
                "conclusao": ""
            },
            "contrato": {
                "codigo": "000321",
                "cliente": "WYKPFS",
                "loja": "01"
            },
            "ocorrencia": {
                "codigo": "000001",
                "descricao": "Novos processos no periodo"
            },
            "dataReferencia": {
                "inicial": "20220501",
                "final": "20220601"
            },
            "filtros": [
                {
                    "campo": "DATA_ENTRADA",
                    "tipo": "1",
                    "valor": ""
                },
                {
                    "campo": "STATUS_PROCESSO",
                    "tipo": "2",
                    "valor": "1"
                }
            ],
            "casos": [
                {
                    "cliente": "WYKPFS",
                    "loja": "01",
                    "caso": "000001"
                },
                {
                    "cliente": "WYKPFS",
                    "loja": "01",
                    "caso": "000002"
                }
            ]
        },
        {
            "id": "19b516da-307a-ed11-abda-b88584fbcf74",
            "entidade": "1",
            "campoRetorno": "VALOR_TOTAL",
            "solicitante": {
                "nome": "Administrador",
                "email": "[email protected]"
            },
            "dataLog": {
                "inclusao": "2022-12-12 15:23:04.277304",
                "processamento": "",
                "conclusao": ""
            },
            "contrato": {
                "codigo": "000321",
                "cliente": "WYKPFS",
                "loja": "01"
            },
            "ocorrencia": {
                "codigo": "000003",
                "descricao": "Valor da causa de processos"
            },
            "dataReferencia": {
                "inicial": "20220501",
                "final": "20220601"
            },
            "filtros": [
                {
                    "campo": "VALOR_CAUSA",
                    "tipo": "2",
                    "valor": "5000"
                },
                {
                    "campo": "PROCESSO",
                    "tipo": "2",
                    "valor": "0000000009"
                }
            ],
            "casos": [
                {
                    "cliente": "WYKPFS",
                    "loja": "01",
                    "caso": "000001"
                },
                {
                    "cliente": "WYKPFS",
                    "loja": "01",
                    "caso": "000002"
                }
            ]
        }
    ]
}
3.2 - Retornando os resultados da Extração

Ao terminar a extração dos dados o Sistema Jurídico irá enviar as informações para que atualizemos a solicitação.

Conforme demonstrado abaixo o Sistema irá mandar uma requisição PUT, onde {{juridicoapi}} é a endereço da API, {{codigoT}} é o código do cliente e {{idSolicitacao}} é o Id da Solicitação que foi enviado na solicitação anterior ( response[n].id ).

 

Abaixo segue um exemplo de resposta do Jurídico a ser enviado no Body da requisição conforme especificação do Serviço de Solicitação de Ocorrência

Bloco de código
languagejs
themeRDark
titleJSON da Requisição
collapsetrue
{
  "resposta":{
    "processos":[
      {
        "id":"84098e43-da2a-4816-b249-ef67f3e61476",
        "cliente":"WYKPFS",
        "loja":"01",
        "caso":"000001",
        "VALOR_CAUSA":100000
      },
      {
        "id":"1fe08ced-72ee-4d6c-8a00-4137a116b1cd",
        "cliente":"WYKPFS",
        "loja":"01",
        "caso":"000001",
        "VALOR_CAUSA":30000
      },
      {
        "id":"305174e5-862b-45af-b6fe-1248debf9f51",
        "cliente":"WYKPFS",
        "loja":"01",
        "caso":"000002",
        "VALOR_CAUSA":5000
      },
      {
        "id":"553c4dd7-f0d5-48bd-9d9b-229cae5ad543",
        "cliente":"WYKPFS",
        "loja":"01",
        "caso":"000001",
        "VALOR_CAUSA":19000
      },
      {
        "id":"45f7ad0d-323e-48e5-97db-4f959f411eb2",
        "cliente":"WYKPFS",
        "loja":"01",
        "caso":"000002",
        "VALOR_CAUSA":7500
      }
    ]
  }
}

Ao enviar os dados, se os dados estiverem no formato esperado pelo sistema, ele irá atualizar os dados na solicitação e retornar a seguinte mensagem.

4 - Processando os as requisições prontas

Uma vez que o Sistema Jurídico atualizou a Solicitação com os Processos/Atos Processuais a solicitação ficará pronta para que o Protheus (SIGAPFS) baixe os dados e inicie o processamento gerando as Faturas adicionais.

O botão está localizado na tela de Solicitações de Ocorrências, ao lado do Visualizar, chamado "Atualizar solicitações". 

Ao clicar no botão o sistema irá procurar todas as solicitações que estão prontas no Cloud e para cada uma irá criar uma Fatura adicional.








...