Crie variáveis de cobrança com parâmetros em modelos de contrato e consulte os retornos disponíveis.
💡
Você vai aprender a acessar o assistente, configurar os parâmetros da variável e identificar o retorno adequado para cada informação financeira que deseja exibir no contrato.
O assistente de Variáveis avançadas tem 3 etapas: Escolha a variável, Configure a variável e Copie para o texto.
Na etapa Configure a variável, preencha os campos abaixo para montar a fórmula:
Campos da etapa "Configure a variável"
Campo
O que indica
Tipo de informação
O campo que será retornado. Ex.: Valor, Vencimento, Dia de vencimento, Número do título, Número da parcela, Quantidade de parcelas, Nome do Serviço, Agrupamento do serviço, Percentual/Valor dos descontos condicionados ou não condicionados, Valor menos descontos, entre outros.
Por extenso
Escolha Sim para o valor retornar escrito por extenso, ou Não para retornar no formato padrão.
Parcela
Selecione uma ou mais parcelas específicas (1, 2, 3...) para retornar os dados correspondentes. Para retornar o total, não selecione nenhuma parcela.
Agrupamento do serviço
Escolha um agrupamento específico ou deixe em Todos os agrupamentos de serviço. Use o link [Consultar serviços] na própria tela para ver os agrupamentos cadastrados.
Como os parâmetros são combinados
Configuração
Resultado
Uma parcela
Selecione o número desejado para retornar somente os dados dessa parcela.
Várias parcelas
Selecione os números desejados para retornar individualmente os dados de cada parcela. Exemplo: ao selecionar as parcelas 1, 2 e 3, a variável de valor apresenta o valor de cada uma delas.
Todas as parcelas
Não selecione nenhuma parcela. O sistema considera todas as parcelas e, nas variáveis de valor, apresenta a soma correspondente.
Um agrupamento de serviço
Selecione o agrupamento desejado para considerar somente os serviços vinculados a ele.
Uma parcela de todos os serviços
Selecione a parcela e mantenha [Todos os agrupamentos de serviço]. O sistema considera essa parcela em todos os serviços vinculados à turma.
Todas as parcelas de todos os serviços
Não selecione uma parcela e mantenha [Todos os agrupamentos de serviço]. O sistema considera todas as parcelas, independentemente do agrupamento.
Na etapa Copie para o texto, o sistema mostra a expressão pronta — por exemplo, [COBRANCA_TURMA('DESCONTO_PERCENTUAL_COND','','')]. Clique em [Copiar variável], feche o assistente e cole o conteúdo no contrato.
O código do retorno escolhido aparece dentro da expressão gerada. Nas tabelas das próximas seções, use a coluna Tipo de informação (código) para identificar o resultado de cada opção.
⚠️
Como o sistema identifica as parcelas: os títulos vinculados à turma são organizados pela data de vencimento. Por isso, o número selecionado no parâmetro [Parcela] representa a posição do título nessa ordem e não, necessariamente, o número registrado no campo [Parcela] da cobrança.
💡
Agrupamento do serviço: utilize a mesma grafia cadastrada no serviço. Diferenças no nome ou caracteres como acento circunflexo (^), acento agudo (´), crase (`), til (~), trema/diérese (¨) e cedilha (ç) podem impedir o retorno das informações.
💡
Não é necessária nenhuma alteração no texto da variável para que ela funcione — a fórmula gerada pelo assistente já vem pronta para uso.
⚠️
Sempre insira a variável diretamente na área de edição do contrato no Activesoft e confira o resultado em [Pré-visualizar contrato] antes de salvar o modelo. Evite copiar a expressão de outros editores, como o Word.
Use os parâmetros do assistente para definir a parcela e o agrupamento considerados no retorno.
Retornos de valor e vencimento
Tipo de informação (código)
O que retorna
VALOR
Valor por parcela ou total, conforme os parâmetros. Exemplo: R$ 1.200,00.
VALOR_EXTENSO
O mesmo valor acima, por extenso. Exemplo: um mil, duzentos reais.
VALOR_MENOSDESCCOND
Valor líquido após o desconto condicional (financeiro), por parcela ou total. Se não houver desconto condicional, retorna o valor principal do título.
VALOR_MENOSDESCCOND_EXTENSO
O mesmo valor acima, por extenso.
VALOR_MENOSDESCNAOCOND
Valor líquido após o desconto incondicional (comercial), por parcela ou total. Se não houver desconto incondicional, retorna o valor principal do título.
VALOR_MENOSDESCNAOCOND_EXTENSO
O mesmo valor acima, por extenso.
VALOR_MENOSTODOSDESC
Valor líquido após todos os descontos do título, combinando condicionais e incondicionais. Se não houver desconto, retorna o valor principal do título.
VALOR_MENOSTODOSDESC_EXTENSO
O mesmo valor acima, por extenso.
VENCIMENTO
Vencimento do título por parcela, conforme os parâmetros. Exemplo: 15/08/2025.
VENCIMENTO_DIA
Apenas o dia do vencimento do título por parcela, conforme os parâmetros. Exemplo: 15.
Comentários
0 comentário
Por favor, entre para comentar.