F
MANUAL
DE
CONFIGURAÇÕES ESPECIAIS
Cliente SiTef Modular
Versão 1.05b – 14/11/2011
"Este documento possui informações e tecnologia de propriedade exclusiva da Software Express, não podendo, a não ser quando de autorização previa e escrita fornecida unicamente pela Software Express, ser reproduzido, utilizado ou divulgado por qualquer meio ou modo total ou parcialmente para outro fim que não seja o de servir de interface entre um sistema de processamento de dados e o Cliente SiTef".
1. APRESENTAÇÃO ... 3
2. CLIENTETRN.INI ... 3
3. CLIENTE.INI ... 15
4. CONFIGURAÇÃO DE NOME DE REDE PARA DETERMINADO BIN ... 20
5. MÓDULO.INI ... 21
1. Apresentação
Este documento tem como objetivo descrever as configurações especiais do Client SiTef Modular.
2. ClienteTrn.ini
As configurações possíveis neste arquivo são: [BOTOES_HABILITADOS] btFininvest=1 btPrivateLabel=1 btReimpressao=1 btChequeGarantia=1 btCorrespBancario=1 btPagtoFatura=1 btPagtoBanrisul=1 btRedecardAdm=1 btVisanetOutros=1 btCargaCelular=1 btRecargaBilheteUnico=1 btTrocoSurpresa=1 btDebito=1 btCredito=1 btCartao=1 btPagtoIBI=1 btTrnEspeciais=1 btCombustivel=1 btProduto=1 btPaggo=1 btStarFiche=1 btCompreMax=1 btVendaPinJogos=1 btHabilitaBotaoValidata=1 btOutrasFuncoesAdmArgentina=1 btResgatePromocionalCielo=1 btOutrasFuncoesAdmPlatco=1 btVendaPinRecarga=1 btGift=1 [RecargaCelular] PagamentoTEFDebito=1 PagamentoTEFCredito=1 PagamentoCheque=1 ConfirmaNumeroCelularValorPinpad=0
ConsultaValores=1 [CorrespondenteBancario] AberturaConta=1 AlteracaoCestaServicos=1 ConsultaBeneficioINSS=1 ConsultaExtratoCB=1 ConsultaSaldoCB=1 DepositoCB=1 DesbloqueioTalonario=1 DemonstrativoCreditoBeneficios=1 EmprestimoCB=1 FechamentoRepasse=1 OutrasFuncoes=1 PagamentoCBFininvest=1 PagamentoContas=1 PagamentoContaFininvest=1 PagamentoDARFPreto=1 PagamentoDARFSimples=1 PagamentoDiversosCB=1 PagamentoFaturaFinivest=1 PagamentoGPS=1 PagueFacilCB=1 PedidoCartaoDebito=1 RecargaCelularBradesco=1 RecargaCelularCorbanSE=1 RecargaCelularHSBC=1 RevalidacaoSenhaCartaoINSS=1 SaqueCB=1 SimuladorPinpadCBBradesco=1 TransferenciaentreContas=1 [CONFIGURACOES] CapturaValorTotalPCB=Sim ReimpressaoUltimoComprovante=0 [Amex] ConfirmaValorPinpad=1 VerificaSomente1OpcaoMenu=0 [BilheteUnico] PortaLeitor=2 [CodigoBarrasComoCartaoDigitado] TrnCredito=1 CodigoRede=0163
[RedeEspecial] ModuloCartaoTamMinInferior=1 [Inicializacao] TempoEspera=120 [Ticket] ImportaArquivoPrecos=1 [RedesEspeciais] Libercard=1 Cartesys=1 Repom=1 Somarcard=1 [RedesEspeciaisPBM] Fidelize=1 DrogaRaia=1 [ListaProdutosCombustivel] StandBy=1 SmartN=1 ValeShop=1 StandByDup=1 SenffNet=1 GCard=1 [ATP] Dispositivo=0 TamPacoteImagem=1024
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
Seção BOTOES_HABILITADOS:
Todas as opções desta seção tem valor 0 (zero) ou 1, para desabilitar ou habilitar a funcionalidade respectivamente.
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- btFininvest btPrivateLabel -> Habilita as transações de Private Label para Redecard (a partir da
especificação L0205, as transações Fininvest (Transação 0xf0) para Redecard passam a se chamar Private Label) para qualquer rede (Redecard, GetNetLac etc). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btReimpressao -> Serve para desabilitar a opção de Reimpressão. Esta funcionalidade é utilizada apenas
na Venezuela. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- btChequeGarantia -> Habilita as transações de Garantia de Cheque no menu administrativo do Client
Modular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btCorrespBancario -> Habilita as transações de Correspondente Bancário pelo Menu Adm do Client
Modular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btPagtoFatura -> Habilita as transações de Pagamento de Fatura pelo Menu Adm do Client Modular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Nas versões anteriores esta opção
ficava sempre habilitada.
- btPagtoBanrisul -> Habilita as transações de Pagamento de Encargos Banrisul pelo Menu Adm do Client
Modular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btRedecardAdm -> Habilita o botão RedecardAdm pelo Menu Adm do Client Modular, para realizar
transações específicas da Redecard. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- btVisanetOutros -> Habilita o botão VisanetOutros pelo Menu Adm do Client Modular, para realizar
transações do Menu Outros da Visanet. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btCargaCelular -> Habilita o botão Carga de Celular pelo Menu Adm – Outras Funções – Trn Especiais do Client Modular, para realizar transações de Recarga de Celular Pré-Pago. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- btRecargaBilheteUnico -> Habilita o botão Bilhete Único pelo Menu Adm – Outras Funções – Trn Especiais do Client Modular, para realizar transações de Consulta Saldo/Recarga de Cartão Bilhete Único. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btTrocoSurpresa -> Habilita o botão Troco Surpresa pelo Menu Adm – Outras Funções – Trn Especiais do Client Modular, para realizar transação de Troco Surpresa com o Módulo GetNet. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btCartao -> Habilita as transações Outras Funções no menu administrativo do Client Modular. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado). Para não mostrar o menu administrativo deve estar habilitado o botão e enviar o campo 501-001 no arquivo intpos.001 com posição 79 habilitada, conforme documento Especificacao do ClientSitef.pdf.
- btDebito -> Habilita as transações Débito no menu administrativo do Client Modular. Por Default, se não
existir este parâmetro, o valor assumido é 1 (Habilitado).
- btCredito -> Habilita as transações Crédito no menu administrativo do Client Modular. Por Default, se não
existir este parâmetro, o valor assumido é 1 (Habilitado).
- btPagtoIBI -> Habilita as transações de Pagamento de Fatura IBI pelo Menu Adm do Client Modular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btTrnEspeciais -> Habilita o botão TrnEspeciais pelo Menu de Venda e Menu Adm do Client Modular,
para realizar transações especiais. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- btRedecardOutros -> Habilita o botão Crédito ao Consumidor(Parcele Mais) para as transações do Menu
Outros do Client Modular, para realizar transação Parcele Mais. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btCombustivel -> Habilita o botão Combustível pelo Intpos.001 enviando o campo 507-001=1. Por Default, se não existir este parâmetro, o valor assumido é 0 (Não Habilitado).
- btPaggo -> Habilita as transações de Venda e Cancelamento da administradora Paggo, desde que o botão
de transações especiais esteja habilitado (parâmetro btTrnEspeciais). Por Default, se não existir este parâmetro, o valor assumido é 0 (Não Habilitado).
- btStarFiche -> Habilita as transações de Venda e Cancelamento da administradora StarFiche, desde que o
botão de transações especiais esteja habilitado (parâmetro btTrnEspeciais). Por Default, se não existir este parâmetro, o valor assumido é 0 (Não Habilitado).
- btCompreMax -> Habilita as transações de Venda e Cancelamento da administradora CompreMax, desde
que o botão de transações especiais esteja habilitado (parâmetro btTrnEspeciais). Por Default, se não existir este parâmetro, o valor assumido é 0 (Não Habilitado).
- btVendaPinJogos -> Habilita as transações de Venda de Pin de Jogos efetuados pelo GwCel, desde que o
botão de transações especiais esteja habilitado (parâmetro btTrnEspeciais). Por Default, se não existir este parâmetro, o valor assumido é 0 (Não Habilitado).
- btHabilitaBotaoValidata -> Habilita nas transações de Pagamento de Fatura pelo Menu Adm do Client
Modular o botão Validata para selecionar as opções de Pagamento com CPF ou Nosso Número. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btOutrasFuncoesAdmArgentina -> Habilita nas transações de Funções Administrativas pelo Menu Adm do Client Modular, Outras Funções – Trn Especiais, o botão Outras Funções Adm Argentina para poder realizar Consulta Status de Lote Corrente, Fechamento de Lote Corrente, Consulta Totais de Compras e Consulta Dados de Compras . Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). - btResgatePromocionalCielo -> Permite, se estiver habilitado na tabela da Cielo, a habilitação do botão de Resgate Plataforma Promocional no Menu Outros Cielo (acessado pelas funções administrativas) para realização de Resgate Promocional Não Monetário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btOutrasFuncoesAdmPlatco -> Habilita nas transações de Funções Administrativas pelo Menu Adm do Client Modular, Outras Funções – Trn Especiais, o botão Outras Funções Adm Platco para poder realizar Fechamento de Lote Corrente. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- btVendaPinRecarga -> Habilita as transações de Venda de Pin de Recarga efetuados pelo GwCel, desde
que o botão de transações especiais esteja habilitado (parâmetro btTrnEspeciais). Por Default, se não existir este parâmetro, o valor assumido é 0 (Não Habilitado).
- btGift -> Habilita a transação de Venda Débito à Vista com cartão GIFT(Presente) no menu do Client
Modular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
Seção RecargaCelular:
Todas as opções desta seção tem valor 0 (zero) ou 1, para desabilitar ou habilitar a funcionalidade respectivamente.
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- PagamentoTEFDebito -> Habilita/desabilita a forma de Pagamento TEF Débito para as transações de
Recarga de Celular. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- PagamentoTEFCredito -> Habilita/desabilita a forma de Pagamento TEF Crédito para as transações de
Recarga de Celular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- PagamentoCheque -> Habilita/desabilita a forma de Pagamento Cheque para as transações de Recarga de
Celular. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- ConfirmaNumeroCelularValorPinpad -> Habilita/desabilita a Confirmação do Número do Celular e
- ConsultaValores -> Habilita/desabilita a nova transação de Consulta de Valores implementada a princípio
para a Claro (SitGWCel). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado), sendo realizada então a transação de Consulta de Recarga, mantendo compatibilidade com a versão que roda hoje em produção.
Seção CorrespondenteBancario:
Todas as opções desta seção tem valor 0 (zero) ou 1, para desabilitar ou habilitar a funcionalidade respectivamente.
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- AberturaConta -> Habilita/desabilita a opção Abertura de Conta, do menu Administrativo de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). - AlteracaoCestaServicos -> Habilita/desabilita a opção Alteração (Manutenção) de Cesta de Serviços do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é
0 (Desabilitado).
- ConsultaBeneficioINSS -> Habilita/desabilita a opção Consulta de Benefício do INSS do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). - ConsultaExtratoCB -> Habilita/desabilita a opção Consulta Extrato, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- ConsultaSaldoCB -> Habilita/desabilita a opção Consulta de Saldo, do menu de opções do Correspondente
Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- DemonstrativoCreditoBeneficios -> Habilita/desabilita a opção Demonstrativo Crédito Benefícios do
menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é
0 (Desabilitado).
- DepositoCB -> Habilita/desabilita a opção Depósito, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- DesbloqueioTalonario -> Habilita/desabilita a opção Desbloqueio Talonário, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). - EmprestimoCB -> Habilita/desabilita a opção Empréstimo, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- FechamentoRepasse -> Habilita/desabilita a opção Fechamento de Repasse, do menu Administrativo de
opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Observação: Esta função não está habilitada para qualquer CB; deve-se verificar se o CB em questão possui esta funcionalidade.
- OutrasFuncoes -> Habilita/desabilita a opção Outras Funções(Revalidação Senha Cartão INSS e Transferência entre Contas), do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- PagamentoContas -> Habilita/desabilita a opção Pagamento de Contas do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- PagamentoCBFininvest -> Habilita/desabilita a opção Pagamento de CB Fininvest, do menu Pagamentos
do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado). - PagamentoDARFPreto -> Habilita/desabilita a opção PagamentoDARFPreto, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). - PagamentoDARFSimples -> Habilita/desabilita a opção PagamentoDARFSimples, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). - PagamentoDiversosCB -> Habilita/desabilita as opções de Pagamentos diversos de DARF e GPS, do menu Pagamentos do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- PagamentoFaturaFinivest -> Habilita/desabilita a opção Pagamento de Fatura Fininvest, do menu
Pagamentos do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 1 (Habilitado).
- PagamentoGPS -> Habilita/desabilita a opção PagamentoGPS, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- PagueFacilCB -> Habilita/desabilita a opção pague Fácil, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- PedidoCartaoDebito -> Habilita/desabilita a opção Pedido de Cartão de Débito (Pedido de Segunda Via do Cartão de Débito), do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- RecargaCelularBradesco -> Habilita/desabilita a opção Recarga Bradesco (Recarga de Celular via
Correspondente Bancário Bradesco), do menu de opções do Correspondente Bancário -> Pagamentos -> Recarga Celular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- RecargaCelularCorbanSE -> Habilita/desabilita a opção Recarga Corban SE (Recarga de Celular via
Correspondente Bancário Genérico), do menu de opções do Correspondente Bancário -> Pagamentos -> Recarga Celular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- RecargaCelularHSBC -> Habilita/desabilita a opção Recarga Corban HSBC (Recarga de Celular via
Correspondente Bancário HSBC), do menu de opções do Correspondente Bancário -> Pagamentos -> Recarga Celular. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- RevalidacaoSenhaCartaoINSS -> Habilita/desabilita a opção Revalidação Senha Cartão INSS, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- SaqueCB -> Habilita/desabilita a opção Saque, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- SimuladorPinpadCBBradesco -> Habilita/desabilita o simulador de Pinpad Bradesco. Esta função serve para os clientes que estiverem desenvolvendo o Correspondente Bancário para o Bradesco, em ambinete simulado (SitDemo) poderem utilizar o pinpad normal (o pinpad do Bradesco só é disponibilizado em produção, não para desenvolvimento dos clientes). Observação: para segurança dos clientes, quando habilitada esta opção, os dados coletados pelo pinpad são trocados por dados zerados (Trilha, Senha, Número de Série do Pinpad), para não haver problemas em produção, caso esta opção venha a ser habilitada por engano. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
- TransferenciaentreContas -> Habilita/desabilita a opção Transferência Entre Contas, do menu de opções do Correspondente Bancário. Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado).
Seção CONFIGURACOES:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- CapturaValorTotalPCB -> Habilita/desabilita a opção de Captura de Valor Total para o Correspondente Bancário. Se o valor retornado pelo Autorizador do Correspondente Bancário para um dado documento, na Consulta de Pagamento, for diferente do valor total informado, o Cliente Modular abre uma tela com o valor retornado pelo Autorizador para ser confirmado (recálculo automático do valor do documento). Os valores possíveis para esta opção são Sim (Habilitado) ou Nao (Desabilitado). O valor Default para esta opção é
Sim (Habilitado), caso o mesmo não esteja configurado.
- ReimpressaoUltimoComprovante -> Habilita/desabilita a opção de Reimpressão do Último Comprovante, permitindo apenas a reimpressão específica por rede. Os valores possíveis para esta opção são
1 (Habilitado) ou 0 (Desabilitado). O valor Default para esta opção é 1 (Habilitado), caso o mesmo não
esteja configurado.
Seção Amex:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- ConfirmaValorPinpad -> Habilita/desabilita a opção de Captura de Valor no Pinpad para transações de venda Crédito com Cartão Amex. Os valores possíveis para esta opção são 1 (Habilitado) ou 0 (Desabilitado). O valor Default para esta opção é 0 (Desabilitado), caso o mesmo não esteja configurado.
- VerificaSomente1OpcaoMenu -> Habilita/desabilita o clique automático nos Menus quando não existem opções habilitadas ou quando existe apenas 1 opção habilitada (Consulta AVS, Consulta Parcelas etc). Os valores possíveis para esta opção são 1 (Habilitado) ou 0 (Desabilitado). O valor Default para esta opção é 1 (Habilitado), caso o mesmo não esteja configurado.
Seção BilheteUnico:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- PortaLeitor -> Define a porta serial em que o Leitor de Cartões Bilhete Único está configurado. O valor a ser informado é somente o número da porta serial. Por Default, se não houver este parâmetro configurado, o valor assumido é 1 (Porta Com 1).
Seção CodigoBarrasComoCartaoDigitado:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- TrnCredito -> Habilita/desabilita a funcionalidade de realizar transações via Código de Barras como se fosse cartão digitado (não magnético) como Crédito. Os valores possíveis para esta opção são 1 (Habilitado) ou 0 (Desabilitado). Por Default, se não houver este parâmetro configurado, o valor assumido é 0 (Desabilitado).
- CodigoRede -> Define qual será a rede de destino a ser enviada na consulta de bins para a transação via Código de Barras como cartão digitado. Por enquanto somente a Fidelize utilizará esta opção (Rede 0163).
Seção RedeEspecial:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- ModuloCartaoTamMinInferior -> Habilita/Desabilita a opção para poder ler cartões com tamanho menor
ou maior do que o padrão. Esta opção é usada, por exemplo, para o cartão Omnion (cartão de tamanho fixo – 10 bytes) ou Givex (cartão de tamanho fixo – 21 bytes) . Por Default, se não houver este parâmetro configurado, o valor assumido é 0 (Desabilitado).
- TamanhoMaximoCartao -> Configura o tamanho máximo do cartão nas transações digitadas. Está opção
é usada no cartão givex com tamanho máximo de 21 bytes. Por Default, se não houver este parâmetro configurado, o valor assumido é 19.
- TamanhoMinimoCartao -> Configura o tamanho mínimo do cartão nas transações digitadas. Está opção é
usada no cartão Omnion com tamanho mínimo de 10 bytes. Por Default, se não houver este parâmetro configurado, o valor assumido é 11.
Seção Inicializacao:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- TempoEspera -> Parâmetro em segundos para que o Cliente SiTef Modular espere antes de inicializar, sendo que o máximo permitido para essa espera é de 600 segundos. Qual o uso deste parâmetro ? Este parâmetro é utilizado para que o Cliente SiTef Modular espere um tempo antes de ser inicializado, pois ocorreram problemas em um dado cliente que se o Cliente SiTef Modular iniciasse pelo inicializar do Windows, ocorriam exceptions; porém se fosse inicializado manualmente funcionava normalmente. O valor
Default para esta opção é 0 segundos, ou seja, não há tempo de espera para inicializar, caso o mesmo não
esteja configurado.
Seção Ticket:
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- ImportaArquivoPrecos -> Habilita/Desabilita a opção para poder ler um arquivo de cadastro preços da Ticket – INTPRC.001 (utilizado pelos TEFs Discados da Ticket atualmente). Por Default, se não houver este parâmetro configurado, o valor assumido é 0 (Desabilitado).
Seção RedesEspeciais:
- Libercard -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que sejam habilitadas as transações a serem realizadas com a Rede Libercard. O valor Default para este parâmetro é 0 (desabilitado).
- Repom -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que sejam habilitadas as transações a serem realizadas com a Rede Repom. O valor Default para este parâmetro é 0 (desabilitado).
- Somarcard -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que sejam habilitadas as transações a serem realizadas com a Rede Somarcard. O valor Default para este parâmetro é 0 (desabilitado).
Seção RedesEspeciaisPBM:
- Fidelize -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que sejam habilitadas as transações a serem realizadas com a Rede Fidelize PBM. O valor Default para este parâmetro é 0 (desabilitado).
- DrogaRaia -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que sejam habilitadas as transações a serem realizadas com a Rede Droga Raia PBM. O valor Default para este parâmetro é 0 (desabilitado).
Seção ListaProdutosCombustivel:
- Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que sejam habilitadas as transações a serem realizadas com a Rede de Cartões Combustível. O valor Default para este parâmetro é 0 (desabilitado). Código Rede 0017 Repom 0018 StandBy 0043 SenffNet 0077 ValeCard 0130 GCard 0171 ValeShop 0175 StandByDup 0199 SmartN Seção ATP:
Esta seção deve ser adicionada caso haja necessidade de configuração da Consulta de Cheques ATP. Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
- Dispositivo -> Pode assumir os seguintes valores, conforme o tipo de scanner que estiver conectado ao terminal:
• 0 - DIGITALCHECK_CX30 ; • 1 - PERTECH_6100_TWAIN; • 2 - REINER_RS900_TWAIN.
- TamPacoteImagem -> É o tamanho do pacote da imagem do cheque, tanto da frente quanto do verso, que será fragmentado para envio ao servidor SiTef. Deve ser configurado conforme os limites abaixo:
• Mínimo de 256 (bytes) • Máximo de 1024 (bytes)
3. Cliente.ini
As configurações possíveis neste arquivo são: [Todos] PermiteDebitoDigitado=1 PermiteDebitoDigitadoCancelandoMagnetico=1 PermiteCombustivelDigitado =1 [ClientSiTef] NomeDLLCapturaCP=LibTrilhaSE.dll ServClient=NAO NumViasCupom=2 ConexaoSiTefPorTrn=0 PortaPinCB=2 TecladoVirtualHabilitado=0 HabilitaTraceDetalhado=1 IATA=1 PermiteAcessoMultiplosSiTefs=1 PortaPinSmartNet=1 [Credito] Vista=1 ParcLoja=1 ParcAdm=1 ProRataVista=1 ProRataParc=1 Cancelamento=1 PreAutorizacao=1 ConsultaParc=1 CancPreAut=1 CancCaptPreAut=1 ConsAVS=1 [Debito] Vista=1 PreDatado=1 ParcVista=1 ParcSemEntrada=1 VistaForcada=1 VendaCDC=1 ParcComJuros=1 ParcSemJuros=1 Cancelamento=1
ConsultaCDC=1 [DadosPinpad] IntervaloEmMinutosBaixaTecnica=0 [Pinpad] HabilitaBotaoConfirmaTrnDigitada=1 [PONTEPPCLIENT] PonteEnderecoIPPinpad= PonteEnderecoPortaPinpad= [EstatisticaPinpad] Realiza=Nao [MODOENTRADAPAYPASS] PortaPayPass= VelocidadePayPass= [CSeg] HabilitaCriptografiaCSeg=1
Abaixo seguem as descrições das funcionalidades habilitadas/desabilitadas para cada parâmetro:
Seção Todos:
- PermiteDebitoDigitado -> Possui valores 0 ou 1 (desabilitado ou habilitado, respectivamente). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Este parâmetro foi criado para as
transações da Visa 4.1, pois a especificação prevê transações de Débito Digitado. Deve-se habilitar com critério esta funcionalidade nos clientes.
- PermiteDebitoDigitadoCancelandoMagnetico -> Possui valores 0 ou 1 (desabilitado ou habilitado, respectivamente). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Este parâmetro foi criado para as transações de Débito Digitado do Módulo Validata. Quando o usuário cancela a passagem de cartão no Pinpad ou no botão Cancela, aparece uma pergunta se quer digitar cartão. Em seguida é solicitada a validação com Senha de Supervisor. Deve-se habilitar com critério esta funcionalidade nos clientes.
- PermiteCombustivelDigitado -> Possui valores 0 ou 1 (desabilitado ou habilitado, respectivamente). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Este parâmetro foi criado para os
módulos que utilizam as transações de FUELCTRL Digitado. Deve-se habilitar com critério esta funcionalidade nos clientes.
- PermiteDigitarCartaoGift -> Possui valores 0 ou 1 (desabilitado ou habilitado, respectivamente). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Este parâmetro foi criado para os
módulos que utilizam as transações(0xF7) com cartão GIFT(Presente) Digitado. Deve-se habilitar com critério esta funcionalidade nos clientes.
As transações que permitirão ou não a digitação do número do cartão são: . Venda Débito à Vista com Cartão Gift
. Recarga de Cartão Gift . Consulta Saldo de Cartão Gift
. Cancelamento de Venda com Cartão Gift . Cancelamento de Recarga de Cartão Gift
Seção ClientSiTef:
- NomeDLLCapturaCP -> Este parâmetro serve para configurar o nome da dll a ser utilizada para captura
de trilha de cartão proprietário, dll esta que é fornecida pela Software Express, com os bins específicos do cartão proprietário do cliente que irá utilizar esta funcionalidade. Por Default, se não existir este parâmetro, o nome assumido para a dll em questão é LibTrilhaSE.dll.
- ServClient -> Este parâmetro tem valores Sim ou Nao. Ele é utilizado no cliente Fast Shop, onde o Client SiTef Modular inicializa o executável ServClient.exe, que deve ser colocado na pasta \Client. Por Default, se não existir este parâmetro, o valor assumido é Nao.
- NumViasCupom -> Por causa da especificação Visa 4.1, onde os cupons TEF da rede Visanet são impressos em 2 vias, alteramos o Client Modular para imprimir sempre os cupons em 2 vias (sendo desta forma 2 o valor Default para este parâmetro, caso o mesmo não exista). Se o cliente necessitar que seja impressa em 1 via, pode-se alterar este valor para 1.
- ConexaoSiTefPorTrn -> Este parâmetro serve para que o Cliente SiTef Modular conecte e desconecte a cada transação enviada ao SiTef. Pode assumir os valores 0 (desabilitado) ou 1 (habilitado). O valor Default para este parâmetro, caso o mesmo não exista, é 0 (desabilitado). Envia uma tentativa de conexão antes de enviar a trn., isto evita que ocorra problemas no envio da trn. qdo. existe problemas de conectividade no link entre o Pdv e o Sitef.
- PortaPinCB -> Este parâmetro serve para configurarmos a porta do Pinpad para o Correspondente
Bancário (Bradesco). Essa configuração foi criada pois o Bradesco exige que as transações que envolvam leitura de Cartão e de Senha que eles capturam e tratam sejam coletadas por um pinpad exclusivo para uso do Bradesco. Caso este parâmetro não esteja configurado, a porta utilizada é a Default (do pinpad principal). - TecladoVirtualHabilitado -> Este parâmetro assume valores 0 (desabilitado) ou 1 (habilitado), e permite a utilização do teclado virtual para telas touch screen. Para tanto, é necessário instalar à parte o Teclado Virtual (VK.EXE) na pasta do Cliente SiTef Modular. O valor Default para este parâmetro, caso não exista, é 0 (desabilitado).
- TraceDetalhadoHabilitado -> Este parâmetro assume valores 0 (desabilitado) ou 1 (habilitado), e permite a habilitação de um trace mais detalhado (gravado no audit do Client Modular) para verificação de possíveis problemas em um dado cliente. O valor Default para este parâmetro, caso não exista, é 0 (desabilitado). - IATA -> Este parâmetro assume valores 0 (desabilitado) ou 1 (habilitado), e permite a habilitação de transação de Crédito IATA (International Air Transport Association), onde será permitido ser informado o valor da entrada. O valor Default para este parâmetro, caso não exista, é 0 (desabilitado).
- PermiteAcessoMultiplosSiTefs -> Este parâmetro assume valores 0 (desabilitado) ou 1 (habilitado), e com esta configuração habilitada, no menu administrativo (função ADM), opção Configuração, Guia Estabelecimento, Endereço SiTef, irá aparecer mais 2 campos (Endereço SiTef 2 e Endereço SiTef 3). Não são obrigatórios estes 2 campos a mais serem preenchidos. Se forem preenchidos, caso haja indisponibilidade do IP principal, irá chavear para o IP 2 e se não houver disponibilidade do IP 2 para o IP 3, retornando ao IP principal caso não consiga conexão com o IP principal. O valor Default para este parâmetro, caso não exista, é 0 (desabilitado).
- PortaPinSmartNet -> Este parâmetro serve para configurarmos a porta serial da leitora SmartNet, para que
seja possível a realização de transações com cartões da SmartNet (Benefício, Voucher, etc). Caso este parâmetro não esteja configurado, a porta utilizada é a 1.
Seções Credito e Debito:
Estas seções foram criadas no intuito de poder desabilitar certas transações em um dado cliente, onde este não utiliza certas transações. Os valores assumidos são 0 ou 1 (desabilitado ou habilitado, respectivamente). Se o parâmetro não existe, o valor Default é 1 (habilitado). Desta forma o Client Modular vai validar o que retornar no Serviço C (Abertura de Terminal) e na consulta de Bins. Se o valor for 0 (desabilitado), a transação não irá aparecer como opção para se efetuar a venda.
Por exemplo em um dado cliente, onde utiliza-se apenas transações de Crédito à vista e Parcelado pela Loja, neste caso, seria desabilitada a opção para Crédito Parcelado pela Administradora, desta forma:
[Credito] ParcAdm=0
Observação importante: Para o Visa 4.1 esta configuração não funciona, porque para o Visa 4.1 o Client Modular não utiliza o Serviço 2 e sim o Serviço W, que seria muito complexo de fazer esta implementação. Em compensação, o Visa 4.1 possui carga de tabelas, bastando apenas o cliente entrar em contato com a Administradora para desabilitar as transações que não são utilizadas no dado estabelecimento.
Seção DadosPinpad:
- IntervaloEmMinutosBaixaTecnica -> Este parâmetro possui valores em minutos. Ele é utilizado para que a verificação dos dados do Pinpad, para realização de baixa técnica, caso o pinpad tenha sido alterado (podem ter mudado o pinpad, alterando assim o número de série ou tipo de Pinpad, ou colocado/retirado/alterado um
Módulo Sam), seja feita em um dado intervalo. Por Default, se não existir este parâmetro, o valor assumido é 0, ou seja, a verificação dos dados do Pinpad é feita a cada transação realizada com a Visanet, quando o Módulo Visa41.bpl é acionado, demandando um certo tempo há mais em cada transação, pois o Client tem que acessar o pinpad para coletar as informações do Pinpad (Modelo, Número de Série, Número do Módulo Sam se possuir, dentre outras informações). Este parâmetro tem que ser utilizado com critério, pois na homologação da Visanet, a verificação sempre é realizada (utilizando o valor Default 0).
Seção Pinpad:
- HabilitaBotaoConfirmaTrnDigitada -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que na tela do módulo Pinpad, para transações digitadas, apareça um botão Confirma, para que o cliente possa clicá-lo, quando por exemplo não existir a tecla Enter na interface com o usuário. No caso do cliente que solicitou essa alteração, ele possuía um monitor Touch Screen, sem possibilidade de utilização da tecla Enter. Ao solicitar o número de cartão digitado e a data de validade do cartão, o botão confirma emula o Enter. O valor Default para este parâmetro é 0 (desabilitado).
Seção EstatisticaPinpad:
- EstatisticaPinpad -> Pode assumir valores Nao (desabilitado) ou Sim (habilitado). Este parâmetro faz com que seja enviado ao SiTef a estatística do Pinpad quando realizada uma transação, no máximo 1 por dia, conforme for o módulo (Redecard realiza). O valor Default para este parâmetro é Nao (desabilitado).
Seção ModoEntradaPayPass:
- PortaPayPass -> Define a porta serial em que o Leitor de Cartões PayPass está configurado. O valor a ser informado é somente o número da porta serial.
- VelocidadePayPass -> Define a velocodade em que o Leitor de Cartões PayPass está configurado. O valor a ser informado é somente a velocidade do leitor.
Seção CSeg:
- HabilitaCriptografiaCSeg -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Por Default, se não existir este parâmetro, o valor assumido é 0 (Desabilitado). Este parâmetro faz com que na tela do módulo Consulta Bin, para transações digitadas ou magnéticas, na coleta do código de segurança os dados apareçam criptografados.
4. Configuração de nome de Rede para determinado Bin
Existe uma forma de se configurar para que retorne no arquivo de Resposta (IntPos.001) um campo com o nome de determinados Bins (até 5), no campo 010-002. Abaixo segue um exemplo de como efetuar esta configuração.
Estas configurações são realizadas no arquivo ClientTrn.ini. [IDENTCARTAO] Bin01=123456 Bin02=234567 Bin03=345678 Bin04=456789 Bin05=567890 [Bin01] 123456=NomeRede01 [Bin02] 234567=NomeRede02 [Bin03] 345678=NomeRede03 [Bin04] 456789=NomeRede04 [Bin05] 567890=NomeRede05 Seção IDENTCARTAO:
- Bin01; Bin02; Bin03; Bin04; Bin05 -> Configura-se o determinado bin que se deseja que retorne o nome do cartão/rede desejado. Este bin deve conter até 6 bytes.
Seções Bin01; Bin02; Bin03; Bin04; Bin05:
- O nome da variável será o bin que se configurou em IDENTCARTAO, para a determinada variável
(por exemplo : para Bin01 o bin é 123456; atribui-se para este bin o nome desejado) -> O nome do
5. Módulo.ini
Seção Codigo da Rede:
- TrataSomenteOperacaoEspecial -> Pode assumir valores 0 (desabilitado) ou 1 (habilitado). Este parâmetro faz com que a operação seja direcionada para o módulo genérico(Genérico.bpl). O valor Default para este parâmetro é 0 (desabilitado).
6. Histórico de Atualizações
Versão Data Descrição
1.04f 04/03/2010 Versão com histórico.
Adicionada a opção btOutrasFuncoesAdmArgentina na seção BOTOES_HABILITADOS
1.04g 08/04/2010 Inclusão de configuração para transação de Crédito IATA
1.04h 03/05/2010 Configuração Leitor PayPass - Redecard
1.04i 10/05/2010 Adicionada a opção de Configuração PagamentoCheque na seção
RecargaCelular no arquivo ClienteTrn.ini
1.04j 17/05/2010 Adicionada a opção de configuração btResgatePromocionalCielo na seção
BOTOES_HABILITADOS no arquivo ClienteTrn.ini.
1.04l 26/07/2010 Alteração em Cliente.ini seção EstatisticaPinpad, parâmetro Realiza, para
o envio de estatística automática do pinpad. Estava como valores 0 ou 1, porém o correto é Nao e Sim.
1.04m 20/08/2010 Inclusão da configuração para habilitar a transação de Venda de Pin de Recarga.
1.04n 30/09/2010 Adicionada a opção de Configuração Fidelize e Droga Raia na seção
RedesEspeciaisPBM no arquivo ClienteTrn.ini
1.04q 23/03/2011 Alteração da configuração de RecargaCelularHSBC para
RecargaCelularCorbanSE.
1.04r 23/03/2011 Inclusão de opção PagamentoContas na seção CorrespondenteBancario.
1.04s 26/04/2011 Inclusão de opções referente a transação com cartão Gift(Presente).
- btGift na seção [BOTOES_HABILITADOS] de ClientTrn.ini - PermiteDigitarCartaoGift na seção [Todos] de Cliente.ini
1.04t 18/05/2011 Retirado opção “PermiteDigitarCartaoGift” do Cliente.ini para transações
Gift(0xF7). Para permitir digitado será utilizado a opção “PermiteDebitoDigitadoCancelandoMagnetico”.
1.04y 08/09/2011 Inclusão das opções DemonstrativoCreditoBeneficios e PedidoCartaoDebito da configuração de CorrespondenteBancario.
1.04z 14/09/2011 Inclusão da opção PermiteAcessoMultiplosSiTefs na seção ClientSiTef.
1.05 14/09/2011 Alteração do parâmetro da seção [BOTOES_HABILITADOS] de btFininvest
para btPrivateLabel, para deixar este parâmetro genérico. Observação: o parâmetro btFininvest continuará também habilitando o botão para manter compatibilidade com configurações antigas.
1.05a 26/10/2011 Inclusão da rede Somarcard na seção [RedesEspeciais].
1.05b 14/11/2011 Inclusão de parâmetro para configuração da leitora SmartNet, com a variável