Fórmulas da NFSE

Detalhamento sobre os botões Fórmula, Descrição e Discriminação que irão compor a NFSe.

Ao clicar no botão fórmula o sistema abre a tela para definição da expressão que gera o valor da nota fiscal. Nesta tela o sistema disponibiliza um conjunto de campos auxiliares que podem ser usados na montagem da expressão do valor da NFSE, sendo eles:

BRU = valor bruto
DESGER = valor do desconto de geração (sem limite de validade)
ACRGER = valor do acréscimo de geração
ACRBAI = valor do acréscimo na baixa
JUR = valor dos juros cobrado
DESBAI = valor do desconto na baixa
MUL = valor da multa cobrado
PAG = valor pago
IDX = valor do indexador cobrado
VLRPON = Valor do desconto de pontualidade
VALPONAPL = Valor do desconto concedido
SITUAÇÃO = Situação da parcela

Atenção!

O campo coringa $VALPONAPL só poderá ser utilizado quando a “Forma de Envio” for igual a FATURAMENTO. Caso tente-se utilizar o parâmetro com a “Forma de Envio” igual a “Recebimento” então o sistema emitirá a seguinte mensagem de alerta: Na expressão do valor, o campo “VALPONAPL” só pode ser utilizado quando a forma de envio é “Faturamento”.

Ainda referente ao novo campo coringa ($VALPONAPL), este servirá para identificar na nota o valor de um desconto de pontualidade aplicado na parcela. Por exemplo, vamos supor o seguinte cenário:

Fórmula:

#set($VALORNOTA = ($BRU - $VALPONAPL))
$VALORNOTA

Valores:

- Valor (bruto) da parcela: R$ 50.00
- Vencimento da parcela: Todo 5º dia do mês
- Desconto de pontualidade: R$ 20.00
- Validade do desconto: 1º dia útil do mês

Caso o aluno faça o pagamento da mensalidade no 1º dia útil do mês terá direito ao desconto de R$ 20.00, sendo necessário pagar R$ 30.00. Caso esteja utilizando uma fórmula conforme mencionado acima, então na nota deverá constar o valor de R$ 30.00 pois o cálculo está sendo realizado da seguinte forma:

#set ($VALORNOTA = (VALOR BRUTO = R$ 50.00 - DESCONTO PONTUALIDADE CONCEDIDO = 20.00))
$VALORNOTA = R$ 30.00

Importante: Caso seja realizado um pagamento parcial de uma mensalidade que contenha desconto de pontualidade, então o sistema fará um cálculo percentual (%) em cima do valor pago para definir o valor de desconto a ser aplicado naquela parcela para que conste na NFSE.

Estes campos serão substituídos pelos devidos valores constantes no sistema. Criada a expressão do valor da nota, é obrigatório fazer a validação da expressão criada. Para validar a expressão, o usuário precisa apenas informar valores para as caixas de texto da coluna validação e clicar no botão validar fórmula. Abaixo apresenta-se um exemplo de expressão de valor da NFSE já validada:

Da mesma forma que para o valor da NFSE, ao clicar no botão descrição, o sistema abre a tela para definição da expressão que gera descrição da NFSE. Nesta tela também é disponibilizado um conjunto de campos auxiliares que podem ser usados na montagem da descrição da NFSE, sendo eles:

$CODALU = Código de tela do aluno
$NOMALU = Nome do aluno
$NOMCUR = Nome curso
$CODTUR = Código de tela da turma
$TIPDEB = Tipo de debito
$NUMPAR = Numero da parcela
$DATVCT = Data de vencimento no formado dd/mm/aaaa
$MESVCT = Mês de vencimento no formato mm
$ANOVCT = Ano de vencimento no formato aaaa
$TIPDES = Tipo de desconto
$PERDES = % de desconto
$SITUACAO = Situação da parcela
$VALNOT = Valor calculado da nota de serviço conforme configurações definidas no campo “Expressão do valor da nota fiscal”
$CARTRIB = Percentual (%) de carga tributária da Nota Fiscal (%)
$VLRTRIB = Valor de carga tributária da nota fiscal
$QTDALU = Número de alunos
$QTDPAR = Numero de parcelas
$ALUNOS = Lista de alunos
$VALPONAPL = Valor do desconto de pontualidade já aplicado
$Parcelas = Lista de parcelas
$COMPPAR = Mês/Ano de compensação da parcela

Também é necessário que uma validação seja feita preenchendo-se as caixas de texto da coluna validação e clicando no botão validar formula.

Da mesma forma que para o valor da NFSE, ao clicar no botão discriminação, o sistema abre a tela para definição da expressão que gera discriminação da NFSE. Nesta tela também é disponibilizado um conjunto de campos auxiliares que podem ser usados na montagem da discriminação da NFSE, sendo eles:

$CODALU: Código do aluno;
$NOMALU: Nome do aluno;
$NOMCUR: Nome curso;
$CODTUR: Código da turma;
$TIPDEB: Tipo de debito;
$NUMPAR: Numero da parcela;
$DATVCT: Data de vencimento no formado dd/mm/aaaa;
$MESVCT: Mês de vencimento no formato mm;
$ANOVCT: Ano de vencimento no formato aaaa;
$TIPDES: Tipo de desconto;
$PERDES: % de desconto;
$VALDES: Valor do desconto;
$QTDPAR: Numero de parcelas;
$QTDALU: Número de alunos;
$CARTRIB: Carga tributária (%);
$VLRTRIB: Valor dos tributos;
$QTDALU = Número de alunos;
$QTDPAR = Numero de parcelas;
$ALUNOS = Lista de alunos;
$VALPONAPL = Valor do desconto de pontualidade já aplicado;
$Parcelas = Lista de parcelas;
$COMPPAR = Mês/Ano de compensação da parcela;

Também é necessário que uma validação seja feita preenchendo-se as caixas de texto da coluna validação e clicando no botão validar formula.

Na configuração do valor e da discriminação da NFSE é possível usar estruturas de seleção e repetição da linguagem de programação Velocity, por este motivo recomendamos que a configuração do valor e da discriminação da NFSE devem ser feitas por um usuário com conhecimentos em linguagem de programação. Abaixo são apresentados alguns exemplos de descriminação da NFSE usando recursos da linguagem Velocity :

1) Exemplo usando campos auxiliares e variável:

       #set($TOTALADICAO = $VALNOT +$VALDES)\\
       O valor da soma é:  $TOTALADICAO\\

2) Exemplo usando apenas variáveis:

       #set($calculo = (7+7)) \\
       $calculo \\

3) Exemplo usando estrutura de seleção:

        #if($CODALU==1) \\
               #set($TOTAL = $VALNOT - $VALDES) \\
        #elseif($CODALU==2) \\
               #set($TOTAL = $VALNOT + $VALDES) \\
        #elseif($CODALU==3) \\
               #set($TOTAL = $VALNOT * $VALDES) \\
        #elseif($CODALU==4) \\
               #set($TOTAL = $VALNOT / $VALDES) \\
        #end \\
        $TOTAL \\

4) Exemplo usando estrutura de repetição:

        #foreach($umParcela in $LISTA_PARCELAS) \\
             Aluno: $umParcela.nomAlu \\
             Debito: $umParcela.tipDeb \\
             Numero parcela: $umParcela.numPar \\
             Data vencimento: $umParcela.datVctStr \\
             Mês vencimento: $umParcela.mesVct \\
             Ano vencimento: $umParcela.anoVct \\
             Valor nota: $umParcela.valNot \\
             #foreach($umDesconto in $umParcela.listaDesconto) \\
                            Desconto: $umDesconto.tipDes \\
                             % desconto: $umDesconto.perDes \\
                             Valor desconto: $umDesconto.valDes \\
             #end \\
          #end \\

O valor da nota deve sempre ser um valor numérico, pois este valor vai ser exportado posteriormente na nota, ao contrario da discriminação da nota fiscal que pode conter tanto valores numéricos como textuais.

Ainda há dúvidas? Se você preferir retire suas dúvidas com o nosso suporte, clique aqui e abra um chamado para atendimento.

Voltar

Fórmulas da NFSE

Valor da Nota Fiscal

Descrição do Serviço

Discriminação de Serviço