Você está na página 1de 29

EASYTEF TEAM

DOCUMENTAÇÃO EASYTEFDISCADO VERSÃO DO DOCUMENTO – 2.1

2010

SUMÁRIO

1. 2. 3. 4.

INTRODUÇÃO .....................................................................................................1 PRIMEIROS PASSOS .........................................................................................2 INSTALANDO E TESTANDO INFRA-ESTRUTURA PARA TEF DISCADO ........4 EASYTEFDISCADO.............................................................................................5 4.1. Instalação da versão COM (VB, VB.NET, C# e etc.) ....................................5 4.2. Instalação da versão sem código fonte para Delphi e C++ Builder...............6 4.3. Instalação da versão com código fonte para Delphi e C++ Builder...............6 4.4. Propriedades.................................................................................................7 4.4.1. autoVerificarTEF ....................................................................................7 4.4.2. autoAtivarGerenciador ...........................................................................8 4.4.3. formMsgOperador..................................................................................8 4.4.4. gerenciador ............................................................................................9 4.4.5. imprimirComprovante.............................................................................9 4.4.6. multiplosCartoes ....................................................................................9 4.4.7. numeroDeCartoes................................................................................10 4.4.8. operacaoTEFAtual ...............................................................................10 4.4.9. timeOutGerenciador.............................................................................10 4.4.10. transacaoAprovada..............................................................................11 4.4.11. transacaoNegada.................................................................................11 4.4.12. valorCampoXXX-XXX ..........................................................................11 4.4.13. usouCartaoDebito ................................................................................11 4.4.14. usouCartaoCredito...............................................................................12 4.5. Métodos ......................................................................................................12 4.5.1. cancelarVenda .....................................................................................12 4.5.2. cancelarVenda .....................................................................................13 4.5.3. confirmacaoVendaImpressaoCupom...................................................13 4.5.4. consultarCheque..................................................................................13 4.5.5. fazerRequisicaoAdministrativa.............................................................14 4.5.6. gerenciadorInstalado ...........................................................................15 4.5.7. gerenciadorAtivo ..................................................................................15 4.5.8. imagemCupomTef ...............................................................................15 4.5.9. imprimirCupomECF .............................................................................15 4.5.10. imprimirCuponsECF.............................................................................15 4.5.11. mostrarExcecoesECF (Delphi / C++ Builder).......................................16 4.5.12. naoConfirmacaoVendaImpressaoCupom ............................................16 4.5.13. pagarNoCartao ....................................................................................16 4.5.14. solicitarPagamentoContas ...................................................................17 4.5.15. tratarConsultaCheque..........................................................................18 4.5.16. tratarCupomFiscal................................................................................18 4.6. Eventos .......................................................................................................19 4.6.1. OnAbrirComprovanteNaoFiscalVinculado ...........................................20 4.6.2. OnEfetuarFormaPagamento ................................................................20 4.6.3. OnEfetuarFormaPagamentoDescricaoForma......................................20 4.6.4. OnEncerrarCupomFiscal .....................................................................21 4.6.5. OnFecharComprovanteNaoFiscalVinculado ........................................21 4.6.6. OnFecharRelatorioGerencial ...............................................................21 4.6.7. OnGerarIdentificacao...........................................................................21

.....................24 5....22 4.....21 4...........................10............. OnTerminarCancelamentoMultiplosCartoes ....... OnGuilhotinar2aViaCupomTEF ........................... OnImprimirRelatorioGerencial..............................8............................25 5........11................................... O processo de certificação................................. OnIniciarFechamentoCupomFiscal........6.... OnUsarComprovanteNaoFiscalVinculado ...................4....................12..............................................6............15......23 4.............................................9........................................2.......................6. OnSubTotalizarCupom .6....22 4.......................................6.6....23 4................................14.............................................................6.........6...... OnImpressoraTemPapel ............................ ÚLTIMOS PASSOS .1.....22 4.............. OnValorPersonalizadoReq .....22 4......25 5............... Instalação em seu cliente............................................16..23 4.....13..............6.............................25 ......... OnTerminarFechamentoCupom ..

Uma AC que faz pagamentos via cartões de débito e crédito por TEF discado reúne pelo menos três conhecimentos específicos: A AC em si. ficando a cargo do programador conhecer estas outras áreas. o que aumenta ainda mais suas chances de certificar sua AC. . rápida e de baixo custo de aprovar sua Aplicação Comercial (AC) no processo de certificação TEF discado. Desta forma. © 2009 – EasyTEF Team – Todos os direitos reservados. TEF discado e Impressora Fiscal (ECF).1 1. por adquirir o componente EasyTEFDiscado. desenvolvedor de automação comercial. eventos e propriedades do componente. mas também traz nossa base de conhecimento no processo de certificação. INTRODUÇÃO Parabéns. o conhecimento sobre a AC e ECF não são cobertos pelo componente. O EasyTEFDiscado trabalha diretamente com o conhecimento relacionado ao TEF discado e traz métodos e eventos que ajudam na parte de ECF. Este documento não apenas explica os métodos. a maneira mais fácil.

banrisul. Agende. Para a rede Banrisul. baixe todo o conteúdo de download da página pós-cadastro.com. Redecard. a certificação é feita somente pela Software Express. Visanet) e dos documentos complementares. acessar: http://www. então.softwareexpress. o site possui os links para download de todos os programas e documentos necessários. É necessário viajar a São Paulo para certificar seu software. Para ter acesso ao módulo da REDECARD e os documentos adicionais. é preciso viajar para Porto Alegre – RS.Guia Técnico da Solução TEF Discado / Dedicado para entender como o EasyTEFDiscado © 2009 – EasyTEF Team – Todos os direitos reservados. cujos endereços eletrônicos de cadastro são respectivamente: http://www. ou seja.br/new/conteudo/dnld.sevenpdv. PRIMEIROS PASSOS Para as redes padrão de cartão. Porto Alegre-RS. será necessário o envio dos cupons fiscais. existem apenas duas empresas certificadoras habilitadas pelas redes de cartão no Brasil: SevenPDV e Software Express. será necessário entrar em contato com a Software Express e cadastrar-se com eles. a certificação em uma dessas duas empresas.com. então será enviado o módulo e os documentos via email. Para a rede Banrisul. dos módulos para pagamento via Cartão de Débito e Crédito (Amex.htm http://www.br/tefdial. Depois de terminar a implementação do TEF discado em sua AC com o EasyTEFDiscado. a homologação é feita na cidade sede do banco. Para as redes Hipercard e Tecban. sem necessidade de cadastro prévio. O primeiro passo a ser tomado para começar a programar o TEF Discado em sua AC é cadastrar-se nos sites das empresas certificadoras. você deverá fazer o download do Gerenciador Padrão (GP).asp?secao_id=1462 Após o cadastro. Para Banrisul. resultados dos roteiros de teste. e aprovação dos mesmos por parte da certificadora. Ambas estão localizadas na cidade de São Paulo. Para a rede Banrisul. O mesmo serve para as redes Hipercard e Tecban. .br/BOB/link/BOBW09HW_banricompras_produto_d etalhe_novo. É importante estudar o Guia Técnico do Gerenciador Padrão .2 2.com.

© 2009 – EasyTEF Team – Todos os direitos reservados.3 interage com o GP. via troca de arquivos texto. assinados pelo dono da Software House e ter firma reconhecida em cartório para sua AC constar na lista de ACs certificadas para TEF discado. . Os Certificados de Compatibilidade do seu software com TEF discado devem ser preenchidos. e para entender o significado de algumas das propriedades do componente.

Acesse o site da certificadora de sua preferência para saber o endereço de envio dos cupons e o telefone para eventuais contatos. e os cupons fiscais gerados devem ser enviados por correio para uma certificadora. porém. e o PinPad. é trazida nos manuais do módulo de cada rede. possui métodos e eventos que podem ser programados para outras ECFs. As certificadoras oferecem suporte gratuito aos gerenciadores e aos módulos de cada rede. Você também deverá adquirir três equipamentos para continuar o desenvolvimento: um Fax/Modem (de preferência da marca Trellis com chipset próprio para TEF discado). a rede Redecard é utilizada pelas bandeiras Mastercard. Basta ligar e pedir pelo suporte. Cada rede é utilizada por bandeiras diferentes. Cada rede possui seu roteiro de testes. Por exemplo. . Maestro e etc. por parte da certificadora. de que os cupons estão corretos. primeiro deve-se instalar os gerenciadores e depois cada módulo em qualquer ordem. visto que sua impressão é muito mais rápida que das matriciais. INSTALANDO E TESTANDO INFRA-ESTRUTURA PARA TEF DISCADO Depois de baixar os gerenciadores das redes e os módulos de cada rede. com GP. Lembrando que a certificação das redes Hipercard e Tecban é feita apenas pela Software Express e a certificação Banrisul é feita pelo próprio banco. É necessário também ter uma Impressora Fiscal. o tempo de discagem e comunicação entre o modem e o GP é um fator que influencia bastante o tempo gasto entre um teste e outro e esse é o modem recomendado pela própria SevenPDV. já que se deve adquirir o número de terminal o qual somente a certificadora disponibiliza.4 3. alem da configuração destes módulos com o PinPad e Fax/Modem. na hora da certificação. © 2009 – EasyTEF Team – Todos os direitos reservados. O componente EasyTEFDiscado certificou AC com a ECF (Emissor de Cupom Fiscal) Bematech MP 20 FI II. dispositivo que será usado para passar os cartões e digitar a senha pessoal. deve-se agendar a data para a certificação da AC. Redeshop. Todos os check-lists e roteiros de teste devem ser executados. O mesmo serve para as redes Hipercard e Tecban. o que é obrigatório na hora de configurar o módulo da Visanet. A configuração dos módulos de cada rede. Após a confirmação. A marca Trellis foi citada porque. Impressoras fiscais térmicas agilizam o resultado dos testes.

Junto com o componente.1. por isso. 4. O componente troca mensagens com o gerenciador via arquivos texto. No dia da certificação. o certificador não permite o uso do mouse para interagir com a AC. EASYTEFDISCADO O EasyTEFDiscado funciona como uma interface entre a AC e os gerenciadores. C# e etc. cada form Delphi poderá ter somente um componente EasyTEFDiscado. métodos e eventos do componente. propriedades.5 4. VB. possibilitando o não uso do mouse.zip em qualquer diretório. já que a especificação de impressora fiscal é a mesma para todas elas. © 2009 – EasyTEF Team – Todos os direitos reservados. Como o exemplo já traz os métodos e em qual parte da AC eles devem ser implementados. Instalação da versão COM (VB.bat. Executar o arquivo de lote registrar componente. Este exemplo pode ser usado como base para adaptar sua AC a outras ECFs. . será gerada uma exceção não permitindo que este seja colocado sobre o form. O gerenciador processa apenas uma requisição por vez. Se for colocado um segundo componente. pois as certificadoras exigem isso dos softwares. Repare também que todas as ações do exemplo possuem teclas de atalho.) • • • Descompactar o arquivo EasyTEFCOM. é importante ter apenas uma instância do objeto COM EasyTEFDiscado. Adicionar a referência da type library do EasyTEF (EasyTEF. o Visual Studio -> Menu Project -> Add References -> Aba COM -> EasyTEF Library. Para as outras linguagens de programação. vejamos uma explicação da instalação. Este é outro requerimento que sua AC deve ter. vem um exemplo completo de tela de frente de caixa utilizando TEF discado e ECF Bematech.NET.tlb) em seu ambiente de programação: o VB: Menu Project -> Add References -> EasyTEF Library.

campo “Library Path”).0\Bpl No Delphi. Menu “File”. feche todos os projetos (“Menu File”. é necessário adicionar o Path $(BDSCOMMONDIR)\Bpl no Library Path do Delphi (Menu “Tools”. Para Delphi 5.6 4. opção “Environment Options”. 4. 7 e C++ Builder 6 o Descompacte o arquivo EasyTEF.zip no diretório “Projects\bpl” do Delphi ou C++ Builder. 6. literalmente. aba “Library”. 6. Instalação da versão com código fonte para Delphi e C++ Builder • • • Descompacte o arquivo EasyTEF. adicionar. © 2009 – EasyTEF Team – Todos os direitos reservados.. Escolha o arquivo “DEasyTEF. opção “Open”. opção “Install Packages”. campo “Library Path”. No Delphi. opção “Close All”).2. vá ao diretório onde o EasyTEF foi descompactado. . depois.zip no diretório and Meus Documentos\Borland • C:\Documents Settings\All Users\Documents\RAD Studio\5.. o diretório $(DELPHI)\Projects\Bpl no Labrary Path do Delphi (Menu “Tools”.zip no diretório and Meus Documentos\Borland • • • • C:\Documents Settings\All Users\Documents\RAD Studio\6. botão “Ok”. Menu “Component”.]). botão [.bpl” e pressione o botão “Abrir”.3. pressione o botão “Add”. Instalação da versão sem código fonte para Delphi e C++ Builder • Delphi 5.zip no diretório em que desejar.zip no diretório Meus Documentos\Borland Studio Projects\Bpl Delphi 2007 o Descompacte o arquivo Studio EasyTEF. 7. opção “Options”. opção “Library – Win32”. • Delphi 2006 o Descompacte • o arquivo EasyTEF. opção “Close All”).0\Bpl Delphi 2009 o Descompacte o arquivo Studio EasyTEF. • Para Delphi 2007 e 2009. feche todos os projetos (“Menu File”.

2007 e 2009). o início dos mesmos é minúsculo e cada palavra dentro do nome inteiro inicia com maiúscula. opção “Library – Win32”.1. opção “Environment Options”. opção “Options”. tab “Library” no Delphi 5.dpk. Na janela do package. para os clientes que utilizarem TEF discado. e menu “Tools”. A convenção de escrita de código que foi utilizada no nome dos métodos e propriedades é a mesma do Java.dpk. 7 e C++ Builder 6. © 2009 – EasyTEF Team – Todos os direitos reservados. 6. não serão feitas as verificações automáticas de transações pendentes e os métodos do componente não serão executados. mas nem todos utilizam TEF discado. mediante parametrização do sistema. Na janela do package.7 • • • • • • Va ao diretório EasyTEF\package e escolha o diretório cujo nome corresponde a versão de seu Delphi. campo “Library Path” para Delphi 2006. autoVerificarTEF Esta propriedade indica se o componente deve executar suas verificações automáticas e executar seus métodos. .4.4. Desta forma. 4. esta propriedade deve ser alterada para True em tempo de execução. depois o botão “Install”. Adicione o diretório common do EasyTEF no Library path do Delphi (menu “Tools”. pressione o botão “Compile”. Quando seu valor for False. Abra o arquivo DEasyTEF. pressione o botão “Compile”. Então. Propriedades Vejamos as propriedades visualizadas pelo Object Inspector e as propriedades public que podem ser utilizadas via código. o valor desta propriedade deve ser atribuída para False em tempo de design. Assim. para clientes que não usam TEF discado. mesmo quando invocados. 4. Esta propriedade foi desenvolvida para sistemas que são executados em vários clientes. Abra o arquivo REasyTEF.

Redecard e Visanet utilizam o Gerenciador Padrão. ele pode devolver uma resposta ao operador do sistema. © 2009 – EasyTEF Team – Todos os direitos reservados. formMsgOperador Os gerenciadores TEF retornam mensagens ao operador da AC. 4. Estas mensagens são mostradas em um form próprio do EasyTEF.3. Esta fonte é a fonte definida nesta propriedade. do form de mensagens ao operador. • fonte: Definir a fonte que irá formatar o texto do form de mensagens ao operador da AC. o componente irá exibir uma mensagem ao operador. seja de maneira automática. Caso o gerenciador fique inativo durante uma operação com cartão. em pixels. você poderá configurar esse formulário para personalizá-lo de acordo com a interface de sua AC. O valor padrão desta propriedade é True. botaoOK: Permite configurar altura e largura. Com esta propriedade. ou se o sistema não for vendido sem TEF discado. largura: Largura. o EasyTEF irá reativá-lo novamente para que a transação possa terminar com sucesso.4. Caso o valor desta propriedade seja False. seja de maneira manual através da ação do operador.8 Se todos os clientes utilizarem TEF discado. 4. ou seja. este deve ser ativado novamente. autoAtivarGerenciador O EasyTEF suporte várias redes de cartão e cada rede possui seu gerenciador.: Amex. Ex. pedindo para que ele ative o gerenciador manualmente. em pixels. caso o gerenciador fique inativo por qualquer razão. . do form de mensagens ao operador. em pixels.4. seu valor deve ser atribuído para True em tempo de design (que já é o default) e este valor nunca deve ser alterado. do botão OK. Esta mensagem deverá ser formatada com alguma fonte. • • • altura: Altura.2. Dependendo da operação requisitada ao gerenciador.

Esta propriedade existe para dar mais controle da impressão ao programador. multiplosCartoes Informa se a transação corrente está sendo feito com múltiplos cartões. imprimirComprovante Se True. tgBanrisul. © 2009 – EasyTEF Team – Todos os direitos reservados. imprime o comprovante automaticamente. REDECARD e VISANET.4. ao invés de linha discada. .P. logo após a execução de uma operação TEF que possua comprovante a ser impresso. de forma que sejam feitos alguns controles antes da impressão do cupom. tgGerenciadorPadrao.4.9 4.5.6. tgPayGo. No exemplo que acompanha o componente. para venda com cartão o mesmo valor está como False. gerenciador Definir qual o gerenciador que estará respondendo as requisições de TEF discado. tgHipercard. caso a operação tenha sido aprovada pela rede. numa operação administrativa. tgTecBan. o valor desta propriedade está como True. 4. mesmas redes do GP mas utiliza I. Pode ser o GP.4. esta property informa se a transação corrente está sendo feita com múltiplos cartões se o número de cartões utilizado na transação for maior que um. Valores: • • • • • 4.4. gerenciador para as redes AMEX. Após informar ao EasyTEF a quantidade de cartões que será utilizada. Pay&Go. pela property numeroDeCartoes. Entretanto. Hipercard e TecBan.

10 4. caso o EasyTEF mostre uma dizendo “Gerenciador Padrão não ativo e será ativado automaticamente. Hypertef. ver o método tratarPagamentoComCartao. ttCancelamento: Cancelamento de um pagamento via cartão. Dependendo do computador. Para maiores informações. principalmente com pagamentos com múltiplos cartões. da unit FrenteCaixaFrm. que é o tempo de resposta normal do Gerenciador. em segundos. O valor padrão desta propriedade é 7 segundos. Isto pode ser feito no momento de informar as formas de pagamento do cupom fiscal. © 2009 – EasyTEF Team – Todos os direitos reservados. Pay&Go.9. ttAdministrativa: Operação administrativa.4. numeroDeCartoes Serve para informar ao EasyTEF quantos serão os cartões utilizados na transação..pas. o Gerenciador pode demorar mais ou menos para responder uma requisição. ttNaoConfirmacao: Não confirmação a rede de cartão de que a Cupom TEF foi impresso com sucesso após a aprovação da transação. ttConfirmacao: Confirmação da rede de cartão de que o Cupom TEF foi impresso com sucesso após a aprovação da transação. timeOutGerenciador Esta propriedade serve para regular o tempo de espera.. ttGpAtivo: Verificação se o GP está ativo.4. ttCheque: Consulta de cheque. . 4. Para que todos os tratamentos relacionados a múltiplos cartões possam ser feitos automaticamente. o componente precisa saber antecipadamente a quantidade de cartões utilizada na transação.). ttCartao: Pagamento com cartão. Valores: • • • • • • • • ttNone: Nenhuma operação. 4.7. operacaoTEFAtual Identifica qual operação TEF está sendo executada no momento.4.8.” em meio de operações que não deveria. pela resposta do Gerenciador TEF (Gerenciador Padrão. O exemplo que acompanha o EasyTEF faz exatamente este tratamento.

Tratamentos para saber quais foram as transações aprovadas.4. transacaoNegada Informa se a transação atual foi negada. ou pode ser negada. devem ser feitos pela AC pois o valor total de cada forma de pagamento deve ser informado ao cupom fiscal. a AC deve oferecer ao usuário a opção de fechar o cupom com outra forma de pagamento ou cancelar a transação toda. caso a transação tenha sido aprovada. após o processamento da transação.10. após uma venda com cartão.12. pela rede. 4. Quando for feita uma transação com mais de um cartão. Retorno: True. se a transação foi aprovada. seriam colocados neste documento. Se não fossem tantos. caso a transação tenha sido negada 4.13. 4. © 2009 – EasyTEF Team – Todos os direitos reservados. pode ser que o GP esteja demorando um pouco mais que o padrão para responder. a transação pode ser aprovada pela rede de cartão. Durante o pagamento com cartão.4. porém. foi utilizado cartão de débito.4. . a partir da página 14. 4. Altere o valor desta propriedade para fazer o EasyTEF esperar um pouco mais pela resposta do Gerenciador.4. valorCampoXXX-XXX Estes campos são exatamente os mesmos citados no Guia Técnico Gerenciador Padrão. para o caso de fechamento do cupom com outras formas de pagamento. Retorno: True. se uma das transações for negada. pelo volume de campos.11. usouCartaoDebito Indica se. transacaoAprovada Indica.11 como a requisição de pagamento entre múltiplos cartões. ou não. sugerimos que seja lido o Guia Técnico GP.

REDECARD. Existem dois tipos de cancelamento: via este método ou via operação administrativa. 4. . numeroTransacaoNsu: Número da transação fornecido pela rede do cartão. usouCartaoCredito Indica se. VISANET). cancelarVenda Método que executa o cancelamento de uma venda com cartão. VISANET) é devolvido pelo GP no campo 010-000. O EasyTEFDiscado mapeia esses campos via property valorCampoXXX-XXX. REDECARD.12 Retorno: True caso o cartão utilizado tenha sido um cartão de débito. nomeRede: Nome da rede utilizada (AMEX.5. 4. 4. dataTransacao: Data em que ocorreu a transação. © 2009 – EasyTEF Team – Todos os direitos reservados. A implementação deste método não é obrigatória. Exemplo: O parâmetro nomeRede (AMEX.4. É importante ler o Guia Técnico Gerenciador Padrão. Retorno: True caso o cartão utilizado tenha sido um cartão de crédito. Parâmetros: • • • • • valorTotal: Valor total da venda feita com cartão.5. Métodos Vejamos os métodos disponibilizados pelo componente para realizar as transações via cartão ou consulta de cheque. mas o componente já está pronto caso deseje fazer o cancelamento personalizado. após uma venda com cartão.14. além de recursos adicionais. foi utilizado cartão de crédito. pois alguns parâmetros dos métodos são campos devolvidos pelo GP logo após uma operação TEF. que é mapeado no EasyTEFDiscado pela property valorCampo010_000. página 14 em diante.1. que é o mesmo campo indicado. horaTransacao: Hora em que ocorreu a transação.

este método foi implementado apenas pela rede REDECARD. então o operador da AC cancela o segundo pagamento com cartão. Basta chamar o método cancelarVenda. numeroTransacaoNsu: Número da transação fornecido pela rede do cartão. Este número é recebido após uma operação TEF. . Este método serve para fazer o cancelamento automático das últimas transações feitas com cartão na seguinte situação: Digamos que uma compra será paga com 2 cartões. a rede do mesmo precisa ser notificada de que o cupom fiscal foi impresso com sucesso. Depois de aprovada a transação via cartão.).. documentoFiscalVinculado: Número do cupom fiscal vinculado ao pagamento via cartão. porém.3. finalizacao: Dados recebidos pelo módulo TEF.5. a implementação deste método é obrigatório para a certificação. Por enquanto.2. confirmacaoVendaImpressaoCupom Confirmar à rede que o cupom fiscal foi impresso com sucesso. O primeiro cartão foi aprovado. REDECARD. consultarCheque Fazer uma consulta ou garantia de cheque via Serasa.4. 4.5. imediatamente o cupom fiscal é encerrado e o cupom TEF da consulta é impresso. A transação anterior foi aprovada e precisa ser cancelada. o cliente desiste da compra. sem parâmetros. VISANET. se a forma de pagamento for “Cheque”. 4. Inclusive. que não pede parâmetros. . Se a consulta for feita e o cheque foi aprovado. O exemplo implementa este método da seguinte maneira: Quando a venda é encerrada.. que o cancelamento da(s) transação(oes) anterior(es) será feito automaticamente. cancelarVenda Esta é uma versão sobrecarregada do método anterior. Parâmetros: • • • • nomeRede: Nome da rede utilizada (AMEX. © 2009 – EasyTEF Team – Todos os direitos reservados.13 4. Esta é a maneira que as certificadoras exigem que seja feito.5. é habilitado um botão para a consulta do cheque. mas na hora do passar o segundo cartão.

EasyTEF.Date.14 Parâmetros: • • • • • • • • • • • • • valorTotal: Valor do cheque.imprimirComprovante := False. ''). edtAgencia. documentoPessoa: No. do CNPJ para pessoa jurídica. EasyTEF.Text). da agência. 'F'. este método deve ser executado. ''. fazerRequisicaoAdministrativa Requisitar ao GP que seja feita uma operação administrativa junto aos módulos de cada rede. da agência. tipoPessoa: Tipo da pessoa do Cheque (F para física e J para jurídica). Exemplo: EasyTEF. edtContaCorrente. transmitir informações de lote. digitoControleContaCorrente: Dígito verificador do no. Para se configurar os módulos. edtBanco. caso exista. documentoFiscalVinculado: Valor do documento fiscal vinculado a venda. numeroCheque: Número do cheque. visualizar relatórios de venda e etc. digitoControleAgencia: Dígito verificador do no.Text.Text.consultarCheque(StrToFloat(edtValor. por exemplo.Text.Text. 4. ''. assim como para configurar PinPad. cmc7: Dados do cheque obtidos no mesmo formato de uma leitura cmc7. do CPF para pessoa física ou no.fazerRequisicaoAdministrativa. banco: Código do banco. dataCheque: Data do cheque. caso exista. dtpBomPara.Text. caso exista. ''.imprimirComprovante := True. da conta corrente. edtRegistro.5. agencia: Agência do banco.5. contaCorrente: No. . ''. edtCheque. digitoControleNumeroCheque: Digito verificador do cheque. © 2009 – EasyTEF Team – Todos os direitos reservados. Exemplo: EasyTEF.

6. 4. Parâmetros: imagemCupomTEF: TStrings. gerenciadorAtivo Verifica se o GP ou o Pay&Go.8.5. Pay&Go. penalidades legais podem ser aplicadas.15 4.9. Retorno: Um objeto do tipo TStrings contendo a imagem do cupom TEF. ser salvo em arquivo! Caso isso aconteça.5. Retorno: True.5. imprimirCuponsECF Imprimir os cupons fiscais de transações encerradas com múltiplos cartões. Tecban e Banrisul. imagemCupomTef Retorna a imagem do cupom TEF logo após uma operação TEF. 4. 4.10. Este método já cuida dessa regra automaticamente. imprimirCupomECF Imprimir a imagem do cupom TEF. de acordo com a propriedade gerenciador. Retorno: True. A impressão do cupom TEF deve ser feita em duas vias com intervalo de pelo menos 5 segundos entre a impressão de uma via e outra. . O cupom não pode. caso o gerenciador esteja instalado.7. em hipótese alguma. caso o valor da property imprimirComprovante seja False. executa este método. está ativo. © 2009 – EasyTEF Team – Todos os direitos reservados. caso o gerenciador esteja ativo. 4. entrar em contato com as certificadoras. gerenciadorInstalado Verifica se o GP. está instalado.5. caso tenha sido feito. Este método deve ser chamado após o pagamento com múltiplos cartões. O exemplo que acompanha o EasyTEF verifica se foi feito uma transação com múltplos cartões e.5. Hipercard. É este o cupom propriamente dito que é retornado pela rede e que deve ser impresso logo após a aprovação da venda pela rede. Para mais informações. de acordo com a propriedade gerenciador.

documentoFiscalVinculado: Número do cupom fiscal vinculado ao pagamento via cartão.12. Este número é recebido após uma operação TEF.). pois o componente ACBrECF levanta exceções quando o resultado da execução de um comando à ECF é anormal.11. REDECARD. finalizacao: Dados recebidos pelo módulo TEF. Então. 4.16 4. VISANET. naoConfirmacaoVendaImpressaoCupom Informar à rede que o cupom fiscal não foi impresso com sucesso. documentoFiscalVinculado: Número do cupom fiscal vinculado a compra. o que cancelará a transação. moeda: Moeda que será utilizada para a compra (0 para real e 1 para dólar). .. © 2009 – EasyTEF Team – Todos os direitos reservados.5.5. quando o valor desta propriedade estiver True. mostrarExcecoesECF (Delphi / C++ Builder) Esta propriedade foi desenvolvida para programadores que utilizam a biblioteca ACBr. as exceções do ACBr serão exibidas. numeroTransacaoNsu: Número da transação fornecido pela rede do cartão. Para o ambiente de produção.. Parâmetros: • • • valorTotal: Valor total da compra. recomendamos que esta propriedade seja False pois não interessa ao operador do sistema saber qual é o erro do ACBr. 4. o que recomendamos enquanto o sistema estiver no ambiente de desenvolvimento. pagarNoCartao Fazer o pagamento da compra via cartão de débito ou crédito. Depois de aprovada a transação via cartão. . a rede do mesmo precisa ser notificada de que o cupom fiscal foi impresso com sucesso.13.5. Parâmetros: • • • • nomeRede: Nome da rede utilizada (AMEX.

pas.14. EasyTEF. 0. da unit FrenteCaixaFrm.imprimirComprovante := False. solicitarPagamentoContas Este método serve para fazer pagamentos de contas via redes Tecban e Banrisul. © 2009 – EasyTEF Team – Todos os direitos reservados. A combinação dos parâmetros de múltiplos cartões obedece a seguinte tabela verdade: primeiroCartao ultimoCartao Informação passada ao EasyTEF False False True True False True False True Cartão(ões) intermediario(s) da transação Último cartão da transação Primeiro cartão da transação Pagamento com apenas um cartão O exemplo que acompanha o EasyTEF faz um tratamento de múltiplos cartões que informa corretamente o valor destes parâmetros durante o pagamento com múltiplos cartões no método tratarPagamentoComCartao. 4.17 • • primeiroCartao: Informa ao componente se o cartão corrente é o primeiro cartão de múltiplos cartões. Exemplo: EasyTEF. numeroCupom.pagarNoCartao(valorTotalCartao.numeroDeCartoes := 1. . podem ser feitos os tratamentos automáticos para impressão dos cupons TEF e tratamento de exceção durante a impressão dos mesmos durante o pagamento com múltiplos cartões. True.5. True). Informando estes parâmetros. EasyTEF. Parâmetros: • • • valorTotal: Valor do cheque. ultimoCartao: Informa ao componente se o cartão corrente é o último cartão de múltiplos cartões. tipoPessoa: Tipo da pessoa do Cheque (F para física e J para jurídica). cmc7: Dados do cheque obtidos no mesmo formato de uma leitura cmc7.

18 • • • • • • • • • • documentoPessoa: No. digitoControleNumeroCheque: Digito verificador do cheque. documentoFiscalVinculado: Número do cupom fiscal vinculado ao pagamento via cartão. caso exista. da agência. Durante a certificação. caso exista. numeroCheque: Número do cheque. nomeRede: Nome da rede utilizada para fazer a consulta.15. contaCorrente: No. Este número é recebido após uma operação TEF. codigoBarrasLinhaDigitaval: Valor do nº do código de barras da conta a ser paga. agencia: Agência do banco.5. O exemplo que acompanha o componente utiliza este método constantemente. tratarCupomFiscal Fazer o tratamento dos métodos relacionados ao cupom fiscal. da agência.16. caso exista. do CPF para pessoa física ou no. 4. digitoControleAgencia: Dígito verificador do no. dataCheque: Data do cheque. digitoControleContaCorrente: Dígito verificador do no. vários testes de desligamento da ECF serão realizados em momentos diferentes da impressão do cupom fiscal. do CNPJ para pessoa jurídica. tratarConsultaCheque Método que deve ser utilizado após uma consulta de cheque aprovada. Este método implementa o tratamento correto para esses momentos. 4. Parâmetros: • • • • • imagemCupomTEF: Imagem do cupom TEF da consulta aprovada. . da conta corrente.5. numeroTransacaoNsu: Número da transação fornecido pela rede do cartão. © 2009 – EasyTEF Team – Todos os direitos reservados. finalizacao: Dados recebidos pelo módulo TEF. banco: Código do banco.

Todos os valores possuem eventos associados que devem ser programados para a execução do método propriamente dito da ECF.19 Parâmetros: • método: Qual o método do cupom fiscal que deverá ser tratado. Caso este cupom tenha sido impresso com sucesso. o tmeTerminarFechamentoCupom: Indica que o método deve tratar o término do fechamento do cupom fiscal. será esse o valor de resultado. e o cupom não fiscal vinculado. Retorno: Se o método propriamente dito do cupom fiscal tiver algum retorno. Para tanto. o tmeIniciarFechamentoCupom: Indica que o método deve tratar o inicio do fechamento do cupom fiscal. o tmeEfetuarFormaPgtoDescForma: Indica que o método deve tratar a efetuação da(s) forma(s) de pagamento do cupom fiscal com descrição. Caso este cupom não seja © 2009 – EasyTEF Team – Todos os direitos reservados. o tmeEfetuarFormaPgto: Indica que o método deve tratar a efetuação da(s) forma(s) de pagamento do cupom fiscal. Valores: o tmeSubTotal: Indica que o método deve tratar a totalização do cupom fiscal. o EasyTEFDiscado faz justamente o tratamento de impressão do cupom fiscal e do cupom TEF devido a necessidade de confirmação das redes de que o cupom fiscal. Eventos Os eventos do componente são basicamente mapeamentos para funções específicas das impressoras fiscais. • params: Parâmetros que o método específico do cupom fiscal irá precisar. a rede de cartão receberá a confirmação definitiva da transação.6. tenham sido impressos com sucesso. 4. deve ser impresso o cupom TEF. que nas impressoras fiscais é impresso como cupom não fiscal vinculado. . Depois de uma transação ter sido aprovada pela rede de cartão.

4. valorCupom: Numa transação com múltiplos cartões. O componente fornece recursos para todos estes tratamentos e são implementados no exemplo que acompanha o EasyTEF.6.) a transação será cancelada.. params: Parâmetros que o método da ECF irá precisar (params[0].20 impresso por qualquer razão (falta de energia. © 2009 – EasyTEF Team – Todos os direitos reservados. retorno: Retorno que o método da ECF tiver.00. caso contrário. Parâmetros: • • • 4. retorno: Retorno que o método da ECF tiver.3.6. .. operacaoECFOk: Deve indicar se o comando foi executado com sucesso. params: Parâmetros que o método da ECF irá precisar (params[0]. . params[1]. .2.6. informa qual o valor do cupom TEF corrente. OnAbrirComprovanteNaoFiscalVinculado Evento que deve executar o comando de abertura do comprovante não fiscal vinculado da ECF. . OnEfetuarFormaPagamentoDescricaoForma Evento que deve executar o comando para efetuar a(s) forma(s) de pagamento do cupom fiscal com uma descrição.. params[1].. reiniciar o computador.. params[n]). OnEfetuarFormaPagamento Evento que deve executar o comando para efetuar a(s) forma(s) de pagamento do cupom fiscal. Parâmetros: • • • operacaoECFOk: Deve indicar se o comando foi executado com sucesso. Parâmetros: • • operacaoECFOk: Deve indicar se o comando foi executado com sucesso. 4.. informa 0.1... params[n]).

7.6. OnFecharComprovanteNaoFiscalVinculado Evento que deve executar o comando para fechar o comprovante não fiscal vinculado da ECF. Então. que pode ser um número seqüencial.5. OnGuilhotinar2aViaCupomTEF Algumas impressoras fiscais suportam corte automático de papel durante a impressão do comprovante não fiscal vinculado ao cupom fiscal.4. Bematech_FI_CancelaCupom. Este evento deve © 2009 – EasyTEF Team – Todos os direitos reservados.6. OnGerarIdentificacao Este evento é chamado para a geração da chave identificadora única.8. este evento é disparado. Caso ele escolha não.6. OnFecharRelatorioGerencial Evento que deve executar o comando fechar o relatório gerencial da ECF. o componente irá abrir um relatório gerencial na ECF.6. . Parâmetros: • 4. 4. identificacao: Deve ser atribuído um número inteiro a este parâmetro e este valor nunca deve ser repetido. OnEncerrarCupomFiscal Evento disparado quando o cupom fiscal precisa ser cancelado e fechado o comprovante não fiscal vinculado. Em operações administrativas ou por falta de energia na ECF. da operação TEF que será executada. 4. Quando o cupom TEF termina de ser impresso no relatório gerencial. este método é executado para fechar o mesmo. Exemplo: Bematech_FI_FechaComprovanteNaoFiscalVinculado. Quando ocorre algum problema na impressão do cupom.6.21 4. Os números gerados neste evento nunca devem se repetir. tanto o cupom não fiscal vinculado quanto o cupom fiscal devem ser fechados.6. 4. o componente pergunta ao operador se ele deseja tentar novamente a operação na ECF.

O método que imprime em bloco pode ser sobre escrito em componentes descendentes.6. um dos cartões pode ser negado pela rede de cartão por alguma razão. pois não é possível enviar todo o cupom TEF de uma só vez para a impressão. Parâmetros: • • imagemCupomTef: Blocos de três linhas da imagem do cupom TEF. ou seja. que tem manipulador de acesso protected: procedure imprimirEmBloco(imagemCupomTef: TStrings. 4.22 chamar o comando de corte do papel.6.6. 4. Via do Cupom TEF seja 4. var impressaoTEFOk: Boolean.11. Parâmetros: • operacaoECFOk: Deve indicar se a impressora TEM PAPEL. OnImprimirRelatorioGerencial Evento que deve executar o comando de impressão do relatório gerencial.10.9. para que a 2ª cortada automaticamente. OnTerminarCancelamentoMultiplosCartoes Durante uma transação com múltiplos cartões.6. . de três em três linhas. Eis o protótipo do método. o usuário deve ter a opção de terminar o fechamento do cupom com outra(s) forma(s) de pagamento ou © 2009 – EasyTEF Team – Todos os direitos reservados. virtual. impressaoOk: Deve indicar se o bloco foi impresso com sucesso. Neste momento. relatorioGerencial: Boolean = False). Parâmetros: • operacaoECFOk: Deve indicar se o comando foi executado com sucesso. 4. OnImpressoraTemPapel Evento que deve executar o tratamento de falta de papel na ECF. OnIniciarFechamentoCupomFiscal Evento que deve executar o comando de inicio de fechamento de cupom fiscal.12. Um detalhe importante sobre este evento é que ele é disparado para impressão do cupom TEF em bloco.

6. var impressaoTEFOk: Boolean. Parâmetros: operacaoECFOk: Deve indicar se o comando foi executado com sucesso. OnTerminarFechamentoCupom Evento que deve executar o comando de termino de fechamento do cupom fiscal. Eis o protótipo do método. 4. que tem manipulador de acesso protected: procedure imprimirEmBloco(imagemCupomTef: TStrings. Parâmetros: operacaoECFOk: Deve indicar se o comando foi executado com sucesso. virtual. Caso ele queira cancelar o cupom. O método que imprime em bloco pode ser sobre escrito em componentes descendentes.14. de três em três linhas. Um detalhe importante sobre este evento é que ele é disparado para impressão do cupom TEF em bloco. relatorioGerencial: Boolean = False). 4. © 2009 – EasyTEF Team – Todos os direitos reservados.6. O tratamento de limpeza da tela de frente de caixa da AC. OnUsarComprovanteNaoFiscalVinculado Método que deve executar o comando de uso do comprovante não fiscal vinculado da ECF. ou seja. deve ser feito neste evento. pois não é possível enviar todo o cupom TEF de uma só vez para a impressão. 4.23 cancelar o cupom. impressaoOk: Deve indicar se o bloco foi impresso com sucesso. . Parâmetros: • • imagemCupomTef: Blocos de três linhas da imagem do cupom TEF. OnSubTotalizarCupom Método que deve executar o comando de totalização do valor do cupom da ECF.6. após o cancelamento de uma transação feita com múltiplos cartões. a tela da AC deve ser limpa para uma nova transação.13.15.

Para mostrar que é a sua AC. OnValorPersonalizadoReq Durante o processo de certificação. será avaliado se sua AC utiliza alguma biblioteca externa para comunicação com o GP. que cria os arquivos de mensagens com o GP. mas que mostrará que apenas a sua AC faz a troca de mensagens com o GP sem intervenção de bibliotecas terceiras.6. valor: Valor do campo que será adicionado ao arquivo de mensagem. . que não será tratado pelo GP. Parâmetros: • • campo: Nome do campo que será adicionado ao arquivo de mensagem.16. © 2009 – EasyTEF Team – Todos os direitos reservados. o certificador irá solicitar que durante a certificação seja adicionado um novo campo com um novo valor no arquivo de mensagens.24 4. mesmo.

Cada cupom deve ser numerado com o número do teste equivalente a este cupom e todos devem ser enviados à certificadora de sua preferência para avaliar se sua AC pode passar pela certificação. Durante a certificação. Cada roteiro possui também um checklist que deve ser executado. O EasyTEFDiscado gera um backup com o mesmo nome do executável da AC. será agendada a certificação. além dos certificados de compatibilidade de cada rede devidamente preenchidos e com firma reconhecida em cartório. ÚLTIMOS PASSOS 5. além de Hipercard. informar a conta bancária para TEF e etc. Para certificar as redes AMEX.SP. A certificadora enviará por email endereços de hotéis próximos. Cada passo pode gerar ou não um cupom fiscal com um cupom não fiscal vinculado. Isso acarretará em deslocamento a São Paulo . © 2009 – EasyTEF Team – Todos os direitos reservados. . lanchonetes e mapas de como se guiar até lá. Será necessário levar uma gravadora de CD para gravar sua AC. que encontra-se no próprio roteiro de pré-homologação desta rede.1. na pasta onde está o executável. mas com extensão . REDECARD e AMEX com GP e Pay&Go redes e gerenciadores que o EasyTEFDiscado cobre. O processo de certificação Depois de implementado o EasyTEFDiscado em sua AC. de dois a quatro dias inteiros de testes. se todas estas redes forem certificadas. Tanto o checklist como o roteiro possuem passos numerados. 5. Lembrando que os cupons das redes Hipercard e TecBan devem ser enviados para Software Express e os cupons da rede Banrisul devem ser enviados para o endereço informado pelo Banrisul. Instalação em seu cliente Seu(s) cliente(s) deve(m) entrar em contato com cada rede de cartão para adquirir seu próprio número de terminal.2. pois a certificadora fica com uma cópia dela. o certificador fará um teste excluindo alguns arquivos do gerenciador e irá perguntar se a AC faz backup desses arquivos pra depois poder excluir este backup.ini. os roteiros de teste de cada rede devem ser executados. leva. Tecban e Banrisul.25 5. Quando eles aprovarem o roteiro de teste. saber dos valores cobrados.

Tecban e Banrisul.br). Outro detalhe importante é que a certificação de sua AC é valida por um ano.com. por parte das redes de cartão.bematech. ou se for descoberto algum bug. basta pagar apenas uma vez. e dos módulos de cada rede são os integradores. as possíveis atualizações não serão recebidas. Caso haja alterações depois do dia 23/09/2009 e a anuidade seguinte não for paga. porém. ou não. ou seja. uma vez que nosso software é habilitado pelas redes apenas para fazer os pagamentos via TEF discado. Obrigado. até 23/09/2009. Quem faz a instalação do GP. com baixo custo. Porém. A anuidade serve para o recebimento de atualizações e correções do componente durante um ano. Qualquer dúvida. Então.br) e Direção (http://www. Por esta mesma razão. nós. desenvolvedores. crítica ou sugestão.br.easytef. os integradores não fazem a instalação e configuração se sua AC não estiver certificada. não há problemas com a licença. Porém. entre em contato conosco pelo nosso site http://www. não há problema no uso do componente. havendo alterações na especificação TEF. esperamos que o EasyTEFDiscado tenha cumprido sua proposta de facilitar e agilizar. Exemplo: Adquirindo o componente dia 23/09/2008.com. a partir da data da compra. caso queira pagar apenas uma vez. ela não é obrigatória. Pay&GO. Por fim. uma vez por ano será necessário ir a São Paulo para re-certificar seu software. . o valor pago pelo EasyTEF pode ser anual. EasyTEF Team © 2009 – EasyTEF Team – Todos os direitos reservados.com. a atualização será recebida gratuitamente.direcao. possuíamos apenas cópias de desenvolvimento desses softwares. Os integradores de maior abrangência nacional são Bematech (http://www. Hipercard. a certificação de sua AC no processo de certificação TEF discado.26 Seu(s) cliente(s) deve(m) entrar em contato com um integrador TEF. Caso não deseje receber atualizações e correções.