TEF Dedicado IP

Neste artigo, veremos uma nova forma de utilizar TEF Dedicado, mais segura, mais
barata e, conseqüentemente, mais acessível ao desenvolvedor e seus clientes, além da
integração desta ferramenta com seu sistema.

No Brasil, no mundo da automação comercial (AC), temos que enfrentar algumas

batalhas conhecidas, se quisermos que nossas ACs sejam vitoriosas no mercado. Uma delas é
a certificação TEF (Transferência Eletrônica de Fundos), imposta pelo governo federal, para
que nossos sistemas possam fazer pagamentos com cartão de crédito e débito, onde
precisamos tomar algumas decisões para arquitetarmos nossa estratégia de Guerra:

• Integrar nossa AC com qual software TEF?

o SiTef?
o D-TEF?
o V&Spague?
o ...?
• Qual tipo de TEF?
o Discado?
o Dedicado?
o IP?

Por uma questão de custos (as vezes não analisados), escolhemos o TEF Discado porque
os gastos do TEF Dedicado são muito elevados, tanto para nós como para nossos clientes,
além de não levarmos em conta valores relacionados a deslocamento à homologadora,
alimentação e hospedagem (esses últimos também presentes na homologação TEF Discado).

Outros fatores que elevam em muito o custo de programação para TEF Dedicado são o
valor da licença de desenvolvimento do software TEF, que normalmente se paga para a dona
do sistema de TEF, e o aluguel do link X25, por parte de nossos clientes. O X25 possui um
custo mensal alto, inviabilizando o uso de TEF dedicado para pequenos e médios clientes, que
são a maioria dos usuários de programas de computador no Brasil.

Desta forma, as vantagens do TEF Dedicado, principalmente o aumento de velocidade no

atendimento, não estão acessíveis aos pequenos e médios estabelecimentos em nosso país. A
pergunta mais natural, neste cenário, seria: É possível entrarmos na batalha do TEF dedicado
e vencê-la? Hoje, a resposta é sim!

Um novo método para uso de TEF dedicado, mais racional e otimizado, está no mercado
para resolver os três maiores problemas de custo deste tipo de TEF:

• Licença de desenvolvimento do software TEF para os programadores;

• Custo do link X25 para o cliente final;
• Gastos com a homologação.

O nome desta nova arma é SimaTEF, da Sotech Soluções Tecnológicas. Esta solução
utiliza o software V&Spague, da empresa VBI, e o chamado Getway TEF, que é um
concentrador de requisições TEF, onde fica o link X25. No Datacenter da Sotech, há um
conjunto de servidores, com distribuição de carga de trabalho, que recebem as requisições
TEF. A requisição é roteada para um servidor, conectado ao link X25, dedicado, que é
repassada para a rede de cartão selecionada.

A conexão entre o V&Spague, instalado e configurado no estabelecimento comercial, e o

Getway TEF da Sotech é criptografada por meio de criptografia de chaves públicas e privadas.
Esta solução é certificada PCI-DSS (Payment Card Industry Data Security Standard), que é a
uma certificação feita pelo grupo formado pelas principais redes de cartão: Visa, Mastercard e
Amex.

© 2010 – EasyTEF Team – Todos os direitos reservados

 Isso significa que o estabelecimento comercial, nossos clientes, podem fazer requisições
TEF pela internet, bastando ter um link banda larga de qualquer tipo. O programador não
precisa adquirir licenças de desenvolvimento para o V&Spague, não arcando com qualquer
custo de licenciamento deste software, além de ter a opção de fazer a homologação de
maneira remota ( para maiores informações sobre homologação remota, favor entrar em
contato com Moises, pelo email cemay.informatica@gmail.com )

A Sotech entrou em contato conosco para desenvolver um middleware nos moldes do já

conhecido EasyTEFDedicado, porém, funcionando com o V&Spague. Desta forma,
estabelecemos parceria, unindo forças para ter a solução mais completa, com o melhor preço e
de rápida integração com sua AC. Assim, foram criadas a EasyTEFVesLib.dll (Windows) e
libeasytefveslib.so (Linux), que aceleram e facilitam TODO o desenvolvimento de software para
a solução SimaTEF.

As bibliotecas EasyTEF são gratuitas ao desenvolvedor e estão disponíveis para download

no link abaixo, possuindo código fonte exemplo de frente de caixa, que faz pagamentos com
cartão e tratamentos relacionados a um PDV simples, além de documentação:

http://www.easytef.com.br/downloads/EasyTEFVesLib.zip

A título de exemplo, abaixo, está uma lista dos passos necessários para qualquer rotina
de fechamento de cupom fiscal com TEF:

1 - subtotalizar cupom fiscal

2 - tratar pagamento com cartão
3 - iniciar fechamento cupom fiscal
4 - efetuar formas de pagamento (dinheiro, cartao, cheque)
5 - terminar fechamento cupom
6 - imprimir cupom(s) tef

Vejamos como implementar uma compra paga com múltiplos cartões, com a biblioteca
EasyTEF, em uma linguagem genérica:

/* GLOBAL */
Variavel valoresCartao As Variant
/* A função abaixo deve ser usada para o fechamento do cupom fiscal */

procedimento encerrarVenda - Sem Parametros - Sem Retorno

Variavel valorTotal As Double
Variavel valorDinheiro As Double
Variavel valorCheque As Double
Variavel valorCartao As Double
Variavel params As Variant
Variavel valor As String
Variavel i As Integer
Variavel retorno As String
Variavel operacaoECFOK As Boolean
Variavel resultado As Boolean
CursorDoMouse = CursorDeEspera
SuaECF_FechaPortaSerial
params = Vetor("0")
tratarCupomFiscal(tmeSubTotal, params, retorno)
valorTotal = retorno
If valorTotal = 0 Then
Mensagem "Cupom fiscal sem valor, operação cancelada."
Sair do procedimento encerrarVenda
Else
/* aqui podem ser colocadas as formas de pagamento do seu sistema */
valorDinheiro = valorDinheiroDaTela
valorCheque = edtValorChequeDaTela
valorCartao = edtValorCartaoDaTela
If Not (valorTotal = (valorDinheiro + valorCheque + valorCartao)) Then
Mensagem "Total das formas de pagamento diferente do total do cupom"
Sair do procedimento encerrarVenda
End If
End If

© 2010 – EasyTEF Team – Todos os direitos reservados

 If UsuarioSelecionouTEF Then
/* A função tratarPagamentoComCartao está mais abaixo */
resultado = tratarPagamentoComCartao(valorTotal)
If resultado = False Then
voltarCursorDoMouseAoNormal
Sair do procedimento encerrarVenda
End If
End If
/*
Desconto no cupom fiscal deve ser passado como o valor em R$, mas negativo.
Ex.: R$ 10,00 de desconto deve ser -10,00.
Acréscimo no cupom fiscal deve ser passado como o valor em R$.
Ex.: R$ 10,00 de acréscimo deve ser 10,00
Neste PseudoCodigo não estamos dando desconto (0,00)
*/
valor = "0,00"
params = Vetor(valor)
If tratarCupomFiscal(tmeIniciarFechamentoCupom, params, retorno) Then
If UsuarioSelecionouDinheiro Then
params = Vetor(FORMA_PGTO_DINHEIRO,
Formatar(valorDinheiro, "###.00"))
operacaoECFOK = tratarCupomFiscal(tmeEfetuarFormaPgto,
params, retorno)
End If
If UsuarioSelecionouCheque Then
params = Vetor(FORMA_PGTO_CHEQUE,
Formatar(valorCheque, "###.00"))
operacaoECFOK = tratarCupomFiscal(tmeEfetuarFormaPgto,
params, retorno)
End If
If UsuarioSelecionouCheque Then
operacaoECFOK = True
For i = LimiteInferiorVetor(valoresCartao) Até
LimiteSuperiorVetor(valoresCartao)

params = Vetor(FORMA_PGTO_CARTAO, Format(valoresCartao(i),

"###.00"))
operacaoECFOK = operacaoECFOK And tratarCupomFiscal(
tmeEfetuarFormaPgto, params, retorno)
Next i
End If
If operacaoECFOK Then
params = Vetor("Mensagem desejada de fechamento do cupom...")
If tratarCupomFiscal(tmeTerminarFechamentoCupom,
params, retorno) Then
If imprimirCuponsTEF Then
limparTela
End If

End If
End If
End If
CursorDoMouse = CursorNormal
Fim procedimento
funcao tratarPagamentoComCartao
(PorReferencia valorTotalCartao As Double) - Retorna Boolean
Variavel i As Integer
/* Atribuição da "GLOBAL" */
valorTotalCartao = 0
valoresCartao = VetorDinamico(QuantidadeTotalDeCartoesTEF)
/* Aqui, todos os pagamentos com cartão terão o mesmo valor */
For i = 0 To QuantidadeTotalDeCartoesTEF - 1
valoresCartao(i) = valorCartaoTela / QuantidadeTotalDeCartoesTEF
valorTotalCartao = valorTotalCartao + valoresCartao(i)
Next i
retornoDaFuncao = pagarNoCartao(valoresCartao)
Fim funcao

© 2010 – EasyTEF Team – Todos os direitos reservados

 Na história, há várias batalhas famosas: A Batalha de Waterloo, onde Napoleão
Bonaparte foi derrotado; A Batalha de Termópilas, inspiração para o filme “300 de Esparta” e
diversas outras. Nessas batalhas, sempre houve algum fator decisivo que influenciou seu
término e a vitória de um dos lados, seja apenas por estratégia, seja por um exército massivo.
Para que seu aplicativo tenha um diferencial competitivo, com relação a TEF, a biblioteca
EasyTEF é a mais nova arma para enfrentar a batalha do TEF dedicado e ajudá-lo a vencer!

Tanto a EasyTEFVesLib.dll como a libeasytefveslib.so são as bibliotecas recomendadas

pela Sotech Soluções Tecnológicas.

© 2010 – EasyTEF Team – Todos os direitos reservados