Variável IdSmartTEF nos Modelos de Impressão da Pré-venda | 136570 | Resulth Windows
1. CONTEXTO
Com o uso do SmartTEF integrado ao Resulth Business, cada transação de pagamento via POS gera um identificador único. Até agora, esse código não estava disponível como variável nos modelos de impressão personalizados da Pré-venda, o que limitava a personalização dos documentos emitidos pelo sistema.
A partir desta versão, a variável IdSmartTEF passa a estar disponível nos relatórios personalizados (FastReport *.FR3) da Pré-venda, permitindo que o identificador da transação seja exibido diretamente no documento impresso.
2. O QUE MUDOU
Nova variável IdSmartTEF: disponível na lista de variáveis do editor FastReport para modelos de Pré-venda.
Preenchimento automático: quando existe transação SmartTEF pendente, a variável é substituída pelo código do identificador da transação no momento da impressão.
Compatibilidade garantida: modelos de impressão existentes continuam funcionando sem necessidade de alterações.
Campo em branco sem erros: se não houver transação SmartTEF vinculada, a variável é impressa em branco, sem interromper ou gerar erros na emissão do relatório.
3. COMO ACESSAR
O recurso está disponível no editor de modelos de impressão configuráveis (FastReport) da Pré-venda. Para utilizar a nova variável, acesse o modelo pelo caminho abaixo:
Caminho: Resulth Business ERP Fatura > Pré-venda > Modelos de Impressão Configuráveis (*.FR3) |
ℹ |
Não é necessário ativar nenhum parâmetro adicional. A variável IdSmartTEF é disponibilizada automaticamente na lista de variáveis do editor FastReport para todos os modelos de Pré-venda. |
4. COMO USAR (PASSO A PASSO)
Adicionando a variável IdSmartTEF ao modelo de impressão
Abra o editor FastReport do modelo de impressão da Pré-venda (arquivo *.FR3).
Na árvore de variáveis disponíveis à direita, localize o grupo Pagamentos e encontre a variável IdSmartTEF.
Figura 1: Variável IdSmartTEF listada dentro do grupo Pagamentos no editor FastReport
Arraste a variável IdSmartTEF para dentro do sub-relatório de pagamentos (Subreport1) no layout do modelo. Este posicionamento é obrigatório para que o valor seja exibido corretamente.
⚠ |
IMPORTANTE: A variável IdSmartTEF deve ser posicionada DENTRO do sub-relatório de pagamentos (Subreport1). Posicioná-la fora deste sub-relatório impedirá a exibição correta do identificador. |
Para posicionar a variável, dê dois cliques rápidos na área do sub-relatório de pagamentos para abri-lo em modo de edição.
Figura 2: Variável [Pagamentos."IdSmartTEF"] posicionada dentro do sub-relatório de pagamentos (MasterData2)
Salve o modelo e realize a impressão de uma Pré-venda com transação SmartTEF para validar o resultado.
Comportamento da variável por situação
Situação da Pré-venda |
Transação SmartTEF Pendente? |
Valor impresso em IdSmartTEF |
Pré-venda com pagamento via SmartTEF |
✔ Sim |
Código do identificador da transação (ex: 0055270726093405) |
Pré-venda sem transação SmartTEF vinculada |
✘ Não |
Campo impresso em branco (sem erros) |
Exemplo: identificador exibido durante a transação
O código exibido pela variável IdSmartTEF corresponde ao mesmo identificador gerado pelo POS no momento do pagamento, conforme exemplos abaixo:
|
Figura 3: Tela Cartão POS com código de transação SmartTEF |
Figura 4: App ATS exibindo o identificador da transação |
5. REGRAS DE NEGÓCIO
Escopo dos modelos: a variável IdSmartTEF está disponível para todos os modelos de impressão configuráveis (*.FR3) da Pré-venda.
Transação pendente: a variável retorna o identificador apenas quando existe transação SmartTEF com status PENDENTE vinculada à Pré-venda no momento da impressão.
Sem transação vinculada: quando não há transação SmartTEF pendente associada ao documento, a variável retorna valor vazio e o relatório é emitido normalmente, sem erros.
Modelos existentes: a inclusão da nova variável não altera o comportamento de modelos de impressão já configurados. Nenhuma alteração é necessária nos modelos existentes.
Posicionamento obrigatório: a variável deve ser inserida dentro do sub-relatório de pagamentos (Subreport1) para funcionar corretamente.
6. BOAS PRÁTICAS E OBSERVAÇÕES
💡 |
Dica: Após adicionar a variável ao modelo, realize um teste de impressão com uma Pré-venda que tenha transação SmartTEF pendente para confirmar que o código está sendo exibido corretamente antes de colocar em produção. |
ℹ |
O identificador da transação SmartTEF exibido pela variável IdSmartTEF é o mesmo código gerado pelo POS no momento do pagamento. Certifique-se de que o layout do modelo reserve espaço suficiente para exibir o código completo (até 16 caracteres). |
Valide sempre o layout após inserir a variável, verificando se o campo não está sobrepondo outros elementos do modelo.
Caso utilize mais de um modelo de impressão para Pré-venda, repita o procedimento de inserção da variável em cada modelo que necessite exibir o identificador SmartTEF.
Modelos que não receberem a variável IdSmartTEF continuarão funcionando normalmente, sem qualquer impacto.