Histórico da Página
...
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 ter matrícula nas disciplinas para que o cálculo das parcelas sejam feitosseja 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 "Calcular valores simulados" 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
Dúvidas para configuração do host podem ser esclarecidas através do link:
Ajuda na configuração do Host.
Método SimularValoresContratoTurmaDisc
O método SimularValoresContratoTurmaDisc presente no webservice do Educacional (wsEdu) realiza a simulação dos valores de parcelas de contratos baseados em turmas disciplinas e um status de matrícula a ser considerado. Como informações obrigatórias no XML, devem ser informados o contexto do TOTVS Educacional a ser considerado, lista de parcelas, lista de turmas disciplinas e código do status de matrícula.
Aviso | ||
---|---|---|
| ||
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). |
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
Dúvidas para configuração do host podem ser esclarecidas através do link:
Ajuda na configuração do Host.
Método SimularValoresContratoTurmaDisc
O método SimularValoresContratoTurmaDisc presente no webservice do TOTVS Educacional (wsEdu) realiza a simulação dos valores de parcelas de contratos baseados em turmas disciplinas e um status de matrícula a ser considerado. Como informações obrigatórias no XML, devem ser informados o contexto do TOTVS Educacional a ser considerado, lista de parcelas, lista de turmas disciplinas e código do status de matrícula.
Segue abaixo uma descrição dos parâmetros a serem passados para a simulação de valores de parcelas:
...
- Identificador da Parcela: 19335
- Valor calculado por número de créditos: 600,00
- Número da Parcela: 1
- Cota: 1
- Código do Serviço: 1
- Nome do Serviço: Mensalidade
- Id. do período letivo: 104
- Código do período letivo: 2018/2
- Data de vencimento: 30/11/2018
- Valor automático: N (Parcela fixa)
- Data de competência: 11/2018
(BOLSA)
- Código da Bolsa: 37
- Nome: Desconto Incondicional
- Valor: 10%
...
Bloco de código | ||||
---|---|---|---|---|
| ||||
<SIMULACAO> <PARCELA> <CODCOLIGADA>1</CODCOLIGADA> <IDPARCELA>19335</IDPARCELA> <PARCELA>1</PARCELA> <COTA>1</COTA> <VALORORIGINAL>600,00</VALORORIGINAL> <VLRDESCONTO>0,00</VLRDESCONTO> <VLRLIQUIDO>240,00</VLRLIQUIDO> <VLRBOLSACONDICIONAL>0</VLRBOLSACONDICIONAL> <VLRBOLSAINCONDICIONAL>60,00</VLRBOLSAINCONDICIONAL> <IDPERLET>104</IDPERLET> <CODPERLET>2018/2</CODPERLET> <CODSERVICO>1</CODSERVICO> <NOMESERVICO>Mensalidade</NOMESERVICO> <DTVENCIMENTO>30/11/2018</DTVENCIMENTO> <VALORAUTOMATICO>N</VALORAUTOMATICO> <DTCOMPETENCIA>01/11/2018</DTCOMPETENCIA> <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> |
...
<SIMULACAO>Contém a marcação inicial e a marcação final do XML de retorno do serviço de simulação.</SIMULACAO>
<PARCELA>Contém a marcação inicial e a marcação final para os dados simulados de cada parcela</PARCELA>
- <CODCOLIGADA>Código da coligada</CODCOLIGADA>
- <IDPARCELA>Identificador da parcela</IDPARCELA>
- <PARCELA>Número da parcela</PARCELA>
- <COTA>Número da cota</COTA>
<VALORORIGINAL>Valor original calculado para a parcela</VALORORIGINAL>
- <VLRDESCONTO>Valor calculado do desconto informado na parcela</VLRDESCONTO>
- <VLRLIQUIDO>Valor líquido a ser pago pelo aluno. (Considera o valor original subtraindo todos os descontos e bolsas calculadas)</VLRLIQUIDO>
- <VLRBOLSACONDICIONAL>Valor total das bolsas condicionais</VLRBOLSACONDICIONAL>
- <VLRBOLSAINCONDICIONAL>Valor total das bolsas incondicionais</VLRBOLSAINCONDICIONAL>
- <IDPERLET>Id. do período letivo</IDPERLET>
- <CODPERLET>Código do período letivo</CODPERLET>
- <CODSERVICO>Código do Serviço</CODSERVICO>
- <NOMESERVICO>Nome do Serviço</NOMESERVICO>
- <DTVENCIMENTO>Data de vencimento</DTVENCIMENTO>
- <VALORAUTOMATICO>Indica se a parcela é calculada por número de créditos (S: Calculada por número de créditos, N: Parcela Fixa)</VALORAUTOMATICO>
- <DTCOMPETENCIA>Data de competência da parcela no formato (dd/mm/yyyy)</DTCOMPETENCIA>
<VLRCREDRETROATIVO>Valor de crédito retroativo da parcela</VLRCREDRETROATIVO>
Aviso Essa tag VLRCREDRETROATIVO só estará visível se a base do cliente estiver parametrizada para utilizar o modelo de bolsa retroativa sem alteração de parcelas baixadas utilizando devolução para os créditos retroativos.
- <BOLSAS>Contém a marcação inicial e a marcação final do XML para os dados de bolsas de cada parcela</BOLSAS>
- <BOLSA>Contém a marcação inicial e a marcação final para cada bolsa da parcela</BOLSA>
- <CODBOLSA>Código da bolsa</CODBOLSA>
- <VALORBOLSA>Valor da bolsa</VALORBOLSA>
Aviso Essa Tag BOLSAS exibirá os valores da bolsa referente ao primeiro vencimento do desconto por antecipação quando o desconto por calculado pelo sistema conforme as parametrizações realizadas
- <BOLSA>Contém a marcação inicial e a marcação final para cada bolsa da parcela</BOLSA>
<DESCONTOPORANTECIPACAO>Contém a marcação inicial e a marcação final do XML para os dados de descontos por antecipação</DESCONTOPORANTECIPACAO>
<ITEMDESCONTO>Contém a marcação inicial e a marcação final para cada item de desconto por antecipação calculado para a parcela<ITEMDESCONTO>
<IDDESCONTO>Identificador do item de desconto</IDDESCONTO>]
<VLRPGTOPORDESCPONTUAL>Valor a ser pago para esse item de desconto (vencimento por antecipação)</VLRPGTOPORDESCPONTUAL>
<DTDESCPONTUAL>Data limite calculada para o item de desconto com base no dia informado no formato (dd/mm/yyyy)</DTDESCPONTUAL>
<VALORDESCPONTUAL>Valor do desconto calculado para o item de desconto</VALORDESCPONTUAL>
...