DS_ADICIONAISTEF — Parâmetros Adicionais do TEF

Tela de configuração: ADM012 — Parâmetros do Usuário
Localização: Aba "Parâmetros TEF", campo "Parâmetros TEF"
Tabela: PARMUSUARIO.DS_ADICIONAISTEF
Tipo: DOM_VARCHAR255 (texto livre, campo memo)
Valor padrão: Nenhum (campo vazio por padrão)
Dependência de visibilidade: Controlado pelo campo TP_MODELOTEF (mesma tela, mesma aba)

Visibilidade do campo

O campo DS_ADICIONAISTEF tem visibilidade condicional conforme o valor de TP_MODELOTEF (campo "Modelo TEF" na mesma aba):

Valor de TP_MODELOTEF	Comportamento
0 (vazio/sem modelo)	Campo oculto
1 (outro modelo)	Campo oculto
2 (POS)	Campo visível — permite informar parâmetros adicionais

Telas impactadas

• ADM012 — Parâmetros do Usuário (configuração)
• Qualquer tela/operação que utilize TEF (pagamento com cartão) — consumo do valor

Campos envolvidos

Campo/Componente	Tabela	Tipo	Descrição
DS_ADICIONAISTEF	PARMUSUARIO	DOM_VARCHAR255	Parâmetros adicionais do TEF (texto livre)
TP_MODELOTEF	PARMUSUARIO	DOM_INTEGER	Modelo TEF — controla visibilidade deste campo

Comportamento do parâmetro

O que faz

Armazena configurações/texto adicional que é repassado para o módulo TEF durante a inicialização do sistema (InicializaTEF). O conteúdo é atribuído diretamente à propriedade sessao.TEF.ParmAdicionalTEF.Text.

O que faz	Detalhe
Armazena parâmetros livres	Texto livre de até 255 caracteres
Visível apenas para modelo 2	TP_MODELOTEF = 2 (POS) torna o campo visível
Repassado ao TEF na inicialização	Valor lido na procedure InicializaTEF e aplicado a sessao.TEF.ParmAdicionalTEF.Text

Simulação passo a passo

1. Acesse ADM012 — Parâmetros do Usuário.
2. Na aba "Parâmetros TEF", localize o campo "Modelo TEF" (TP_MODELOTEF) e selecione a opção POS (valor 2).
3. Observe que o campo "Parâmetros TEF" (DS_ADICIONAISTEF) passa a ficar visível abaixo, rotulado como "Adicionais".
4. Digite os parâmetros adicionais necessários (ex.: configurações específicas do POS, IPs adicionais, chaves, etc.).
5. Clique em Salvar para persistir os dados.

Resultado esperado: O texto digitado será salvo na coluna DS_ADICIONAISTEF da tabela PARMUSUARIO e, ao abrir o sistema, será repassado ao componente TEF durante a inicialização da sessão do usuário.

Importante: O campo só aparece quando TP_MODELOTEF = 2 (modelo POS). Para outros modelos de TEF, o campo permanece oculto pois não é utilizado.

Utilização na inicialização do TEF

Quando o usuário faz login no sistema, a procedure InicializaTEF lê o valor de DS_ADICIONAISTEF junto com os demais parâmetros TEF:

SELECT P.TP_MODELOTEF, P.CD_EMPRESATEF, P.CD_FILIALTEF, P.CD_TERMINALTEF,
       P.DS_ENDSERVIDORTEF, IM.DS_PORTAWIN, DS_ADICIONAISTEF
FROM PARMUSUARIO P
LEFT JOIN IMPRESSORA IM ON (P.CD_IMPEXTRATO = IM.CD_IMPRESSORA)
WHERE P.CD_EMPRESA = :CD_EMPRESA
  AND P.CD_USUARIO = :CD_USUARIO

O valor retornado é então atribuído:

sessao.TEF.ParmAdicionalTEF.Text := iDS_ADICIONALTEF;

O que faz	Detalhe
Leitura no login	Valor buscado por CD_EMPRESA e CD_USUARIO do usuário logado
Atribuição ao TEF	Texto é atribuído a sessao.TEF.ParmAdicionalTEF.Text
Sem validação no load	O valor é repassado "como está", sem validação de formato

Importante: Este parâmetro é por usuário. Cada usuário pode ter uma configuração TEF diferente na tabela PARMUSUARIO. Se dois usuários operam no mesmo caixa mas com configurações TEF distintas, o sistema respeitará o parâmetro do usuário logado.

Referências no código fonte (Delphi)

Arquivo	Rotina	Uso
source/ADM012/UADM012.pas:578-579	TfrmADM012.cmbTP_MODELOTEFChange	Torna campo visível quando TP_MODELOTEF = '2'
source/ADM012/UADM012.pas:585-586	TfrmADM012.cmbTP_MODELOTEFChange	Oculta campo para demais modelos
source/Junsoft/UmainDataModule.pas:310	TmainDataModule.InicializaTEF	Lê DS_ADICIONAISTEF do banco
source/Junsoft/UmainDataModule.pas:337	TmainDataModule.InicializaTEF	Atribui valor a sessao.TEF.ParmAdicionalTEF.Text

Schema da tabela

DS_ADICIONAISTEF DOM_VARCHAR255