Versões comparadas

Chave

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

...

Esse serviço possibilita ao usuário do mesmo simular os valores a serem pagos pelo aluno antes de efetuarem a matrícula nas disciplinas de determinadas turmas, ou seja, não é necessário se ter matrícula nas disciplinas para que o cálculo das parcelas seja feito.

O cálculo dos valores de parcelas segue a mesma regra da simulação de parcelas de contratos ao selecionar uma determinada parcela na visão de parcela e clicar no botão para cálculo.

Dúvidas para exposição de webservices podem ser esclarecidas através do link:
Como Expor os Web Services do RM através do Host

...

  • A tag "contextoSrv" contém a informação 1,1,1 que significa:
    • Código da coligada igual a 1
    • Código da filial igual a 1
    • Código do nível de ensino (codtipocurso) igual a 1
  • A tag "strListaIdParcela" contém a informação:
    • Parcelas a serem processadas com idparcela1 = 19335 e idparcela2 = 19339

      Informações

      Parcelas com valor fixo retornarão o seu próprio valor desconsiderando quaisquer valores de créditos ou informações contidas nas turmas disciplinas.

  • A tag "strListaIdTurmaDisc" contém as informações 2575,2576,2580 que significa que:
    • Serão consideradas as três turmas disciplinas com os respectivos ids "idTurmaDiscs" informados 2575, 2576 e 2580

  • A tag "codStatusMatriculaDisc" contém a informação:
    • Código do status de matrícula na disciplina igual a 1.

      Informações

      O status ou situação de matrícula na disciplina, no caso de simulação de parcelas calculadas por valor de crédito, deverão ter a opção de contar como créditos financeiros (cobrança por crédito) marcada. Vide imagem abaixo:

Seguem abaixo alguns resultados possíveis do Validações feitas pelo serviço:

  1. Sistema não encontra as parcelas informadas: Caso não sejam encontradas parcelas com os ids de parcelas informados para o serviço será exibida a seguinte mensagem "Não foram encontrados registros a serem simulados" conforme abaixo


  2. Contexto do Educacional não informado: Caso o contexto do Totvs Educacional não tenha sido informado será exibida a mensagem "String de contexto do serviço não pode ser nula" conforme abaixo:
  3. Lista de parcelas não informada: Caso não seja informada a lista de parcelas, será exibida a mensagem "Lista de parcelas não pode ser nula" conforme abaixo:
    CONTINUAR *****
  4. Código da situação de matrícula nas disciplinas (status) não informado: Será exibida a mensagem "Status de matrícula na disciplina deve ser informado." conforme abaixo:
    Image Added
  5. Erros devido a inconsistências diversas. Será exibida a mensagem conforme abaixo:
    Image Added

XML de retorno do serviço de simulação:

Conforme foi dito acima, o serviço SimularValoresContratoTurmaDisc de wsEdu retorna os valores simulados conforme regra de simulação de valores de parcelas de contratos da visão de parcelas Image Added sem dependência de quaisquer matrículas em disciplinas.

Abaixo seguem alguns dados utilizados em uma simulação utilizando o serviço:

(CONTRATO)

  • ID Matriz Aplicada (IdHabilitacaoFilial): 21
  • Considera desconto por antecipação: Marcado
  • Considerar o valor do desconto por antecipação no valor base para calcular o valor da(s) bolsa(s): Desmarcado
  • Tipo da Bolsa: Somar Bolsas

(PARCELA)

  • IdParcela: 19335
  • Valor calculado por número de créditos: 600,00

(BOLSA)

  • Código da Bolsa: 37
  • Nome: Desconto Incondicional
  • Valor: 10%

(DESCONTO POR ANTECIPAÇÃO)

(ITEM DE DESCONTO 1)

  • ID. do Desconto: 62
  • Descrição: PRIMEIRO VENCIMENTO
  • Valor do desconto: 50%
  • Dia Fixo: 5

(ITEM DE DESCONTO 2)

  • ID. do Desconto: 63
  • Descrição: SEGUNDO VENCIMENTO
  • Valor do desconto: 10%
  • Dia Fixo: 10

(ITEM DE DESCONTO 3)

  • ID. do Desconto: 64
  • Descrição: TERCEIRO VENCIMENTO
  • Valor do desconto: 5%
  • Dia Fixo: 20


Parâmetros passados para o serviço:

Image Added

Após execução do serviço, o sistema retorna o seguinte XML:

Bloco de código
languagexml
themeMidnight
titleXML de retorno
<SIMULACAO>
  <PARCELA>
    <CODCOLIGADA>1</CODCOLIGADA>
    <IDPARCELA>19335</IDPARCELA>
    <VALORORIGINAL>600,00</VALORORIGINAL>
    <VLRDESCONTO>0,00</VLRDESCONTO>
    <VLRLIQUIDO>240,00</VLRLIQUIDO>
    <VLRBOLSACONDICIONAL>0</VLRBOLSACONDICIONAL>
    <VLRBOLSAINCONDICIONAL>60,00</VLRBOLSAINCONDICIONAL>
    <VLRCREDRETROATIVO>0</VLRCREDRETROATIVO>
    <BOLSAS>
      <BOLSA>
        <CODBOLSA>37</CODBOLSA>
        <VALORBOLSA>60,00</VALORBOLSA>
      </BOLSA>
    </BOLSAS>
    <DESCONTOPORANTECIPACAO>
      <ITEMDESCONTO>
        <IDDESCONTO>62</IDDESCONTO>
        <VLRPGTOPORDESCPONTUAL>240,00</VLRPGTOPORDESCPONTUAL>
        <DTDESCPONTUAL>06/08/2018</DTDESCPONTUAL>
        <VALORDESCPONTUAL>300,00</VALORDESCPONTUAL>
      </ITEMDESCONTO>
      <ITEMDESCONTO>
        <IDDESCONTO>63</IDDESCONTO>
        <VLRPGTOPORDESCPONTUAL>480,00</VLRPGTOPORDESCPONTUAL>
        <DTDESCPONTUAL>10/08/2018</DTDESCPONTUAL>
        <VALORDESCPONTUAL>60,00</VALORDESCPONTUAL>
      </ITEMDESCONTO>
      <ITEMDESCONTO>
        <IDDESCONTO>64</IDDESCONTO>
        <VLRPGTOPORDESCPONTUAL>510,00</VLRPGTOPORDESCPONTUAL>
        <DTDESCPONTUAL>20/08/2018</DTDESCPONTUAL>
        <VALORDESCPONTUAL>30,00</VALORDESCPONTUAL>
      </ITEMDESCONTO>
    </DESCONTOPORANTECIPACAO>
  </PARCELA>
</SIMULACAO>


Abaixo segue uma explicação de cada tag do XML de retorno do serviço.




Aviso
titleImportante

A simulação de parcelas de contratos vinculados a uma matriz aplicada e contratos de matrícula livre (sem vínculo com matriz aplicada) poderá retornar valores diferentes para uma mesma turma disciplina com o parâmetro "Usar valor do crédito financeiro da matriz curricular do aluno", isto porque, se a simulação estiver sendo feita para a parcela do contrato com vínculo à matriz aplicada, o sistema buscará os valores de créditos da disciplina da matriz curricular do aluno e, no segundo caso (contrato sem vínculo à matriz aplicada), o sistema poderá buscar o valor de créditos da matriz curricular da turma disciplina (se a mesma estiver vinculada a uma matriz aplicada) ou da turma disciplina (caso seja uma turma livre - sem vínculo a uma matriz aplicada).

...