Você está na página 1de 22

Suporte ao Desenvolvedor: 0800 770 332 0

www.desenvolvedoresdaruma.com.br

Manual para instalao e configurao do


ambiente OFF-LINE de Testes de homologao
do
TEF Dedicado Daruma IP
Aplicativo DTEF
(OFF-LINE)

Verso 1.0.0.6
Data: 24/05/2011

Pag. 1 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Premissas:
1. Possuir um dos Sistemas Operacionais a seguir: Windows XP,
Vista, Windows 7, 2000 Server, 2003 Server e 2008 Server.
2. Fazer download dos aplicativos necessrios que so:

Instalador do ambiente completo;


GP.

3. Possuir um leitor de documentos PDF instalado.


Para Download do ambiente completo, clique no link abaixo:
www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Ambien
te_de_Instalacao_off-line_Completo.zip
Para Download do Gerenciador padro, clique no link abaixo:
www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenc
iador_Padrao.zip

O processo ser dividido em 7 etapas:

Introduo;
Instalando o ambiente completo;
Configurao de PinPad;
Configurando o pg_senha.ini para Windows 2003/2008 Server
Testando o ambiente;
Dicas e informaes para o TEF IP;
Desinstalao do ambiente.

Pag. 2 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Introduo

Resumo do TEF IP Daruma:

A DIREO e a DARUMA firmaram uma parceria para comercializao da soluo


TEF IP Daruma. Dentro desta parceria, a DARUMA est habilitada a realizar as atividades
de consultoria para integrao das aplicaes com o D-TEF e acompanhamento das
certificaes, desta forma, gostaramos que a Certified acatasse as solicitaes de
agendamento de certificaes com o D-TEF pela DARUMA, em nome da Direo.
A Direo disponibiliza o programa GP (gerenciador padro) e o ambiente de simulao
completo que converte todo o modulo de TEF Discado que j est funcionando, para TEF
Dedicado onde usando o GP (Gerenciador Padro) que realiza a troca de arquivos como no
TEF Discado, porm, para o TEF Dedicado, evitando assim um novo desenvolvimento do
zero para o TEF Dedicado usando uma DLL ou Driver similar. A troca de arquivos passar
fazer as transaes do TEF Dedicado apenas instalando o ambiente de teste para o TEF
Dedicado, ficando assim transparente para seu aplicativo se discado ou dedicado a
comunicao.

Obs: a estrutura do TEF discado diferente do TEF Dedicado, no entanto


tero que ser realizadas algumas mudanas no sistema sim conforme descrito
no final deste documento.
Quais as vantagens deste TEF da Daruma?

A homologao remota, no precisa ter que se deslocar pra So Paulo pra


homologar.
Precisa de poucas alteraes no sistema pra homologar, (vide as alteraes
necessrias no final deste documento) o TEF Dedicado, ou seja, no
precisa desenvolver um novo modulo do sistema, pra isso basta usar o
que voc j tem do discado, que, o GP da Direo vai efetuar a troca de
arquivos, convertendo para o TEF Dedicado, dentro das regras do TEF
Dedicado, tanto um nico Carto quanto para Mltiplos Cartes.
O cliente final paga por transao, ou seja, pacote de transao (somente o
que usar) e no precisa de servidor ou mesmo uma X25 na loja.
O cliente no precisa pagar uma banda larga parte para usar o TEF
Dedicado, ele pode usar o prprio link banda larga ou 3G de internet que j
tem funcionando na loja.
Homologa todas as bandeiras em uma nica homologao, lembrando que a
Direo, ou seja, o DTEF j contempla todas as redes autorizadas do
mercado (vide o manual Redes Autorizadas no link
www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/R
edes_Autorizadoras_D-TEF8.zip
Pode usar o mesmo sistema fazendo poucos ajustes para certificar o Tef
discado caso precisar posteriormente.
Pag. 3 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Instalando o ambiente completo


Este mdulo destinasse a instalao do ambiente de teste para o aplicativo TEF
Dedicado, que incluir o instalador off-line e o Gerenciador padro, no qual ser
necessrio para se ter o ambiente completo e funcional para testes de
homologao.
A primeira instalao ser do ambiente completo.
OBS: os programas deste STK foram instalados e testados nos seguintes sistemas
operacionais em 32 bits com 100% de funcionamento:
Windows XP
Windows Vista
Windows 7
Windows Server 2003 e Windows Server 2008 > exige obrigatoriamente o arquivo
pg_senha.ini necessrio apenas para estas verses de Windows 2008 e 2003
Server, o arquivo que est junto a este documento para download, e neste STK
teremos a abordagem dos tpico necessrios para instalar, configurar e testar o
ambiente TEF completo para estas 2 verses do Windows, que tem particularidades
de segurana que impedem que seja instalado o banco de dados Postgre, que
exige criao de usurio Postgre que guarda os dados das transaes e uma senha
que no pode ser fraca. Neste caso faa a configurao do pg_senha.ini ANTES
de iniciar a instalao do ambiente.
Para ambiente 64 bits no funciona! incompatvel!

Pag. 4 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Abaixo a tela do programa sendo executado, a partir deste momento ele vai
comear a instalar os componentes do ambiente de testes (no inclui o GP):

Por fim, ele vai pedir pra instalar o Adobe Reader, neste caso tanto faz instalar ou
no, porm, voc deve ter um programa leitor qualquer de PDF
OBRIGATORIAMENTE em seu PC para conseguir consultar as transaes de TEF
realizadas.

Pag. 5 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

E no final da instalao pedir pra reiniciar. Clique em NO.

Instale o GP que baixamos no inicio do STK, este programa tambm no tem


particularidades, basta rodar o .exe e ir avanando at concluir a instalao (netx,
next, next e finish). simples e rpido! E agora reinicie o sistema operacional.
Ao retomar voc pode usar o ambiente de testes que vai carregar com o Windows o
Apache, o Simurede e o GP, sendo assim, o ambiente foi instalado com sucesso.

Obs: aps o apache estar instalado, mas no rodar, siga os passos abaixo:
Acesse o registry do Windows e entre em:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP, clique com
boto direito do mouse em HTTP, opo novo e clique em Valor DWORD (32 Bits)
de-lhe o nome de NoRun mude seu valor para 1.
Pag. 6 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Na chave Start do diretrio HTTP, mude seu valor para 0.Reinicie o sistema
operacional.
Obs: caso tenha o IIS instalado, aps a instalao do Apache pode travar ou
aps e/ou no funcionar, isso ocorre devido ambos os programas ocuparem a
porta 80 por default, assim como MSN ou Skype tambm podem. Para resolver
isso mude a porta do apache de 80 para 8081.
Para alterar a porta do Apache siga os passos abaixo:
muito simples. Basta acessar o arquivo httpd.conf, que fica localizado em
C:\DIRECAO\HTTP\ApacheGroup\Apache2\conf\httpd.conf, dentro do arquivo
encontre as seguintes linhas:
#Listen 12.34.56.78:80
Listen 80
Veja que a linha que contm o # apenas comentrio, a linha Listen 80 a que
deve ser alterada (eu coloquei 8080 porque geralmente a mais usada mais voc
pode escolher qualquer porta).
#Listen 12.34.56.78:8080
Listen 8080
Lembre-se agora quando voc for acessar internamente coloque no lugar de
simplesmente:
http://localhost/
voc dever colocar sempre:
http://localhost:8080
Sendo assim teremos o seguinte resultado:

O servio de spooler de impresso voltou ao normal (que pode dar conflito


tambm na instalao do Apache), iniciando automaticamente junto com
Windows.
O Servidor IIS7 est funcionando normalmente em http://localhost
O Servidor Apache tambm est funcionando normalmente em
http://localhost:8080

Pag. 7 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Configurando o Pin-Pad
Ao tentar fazer a primeira transao voc perceber que o Gerenciador Padro vai
dar erro de Pin-Pad, para resolver isso voc deve ter o Pin-Pad conectado
corretamente ou ento desabilitar o uso do Pin-Pad da seguinte forma:
Entrar no menu do Windows Iniciar Direo - D-POS 8 GP e abrir o Dpos App,
neste menu acesse a opo Administrao Configurao DPOS vai pedir uma
senha que dpos (tudo minsculo) ou DPOS (tudo maisculo), acessa a guia PinPad e desmarque a opo Pin-Pad Ativo e pronto, se tiver Pin-Pad basta configurar
a porta com que ele est lembrando de marcar a opo Pin-Pad ativo e pronto j
pode testar com o Carto fisicamente.

Pag. 8 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Configurando o arquivo pg_senha.ini para Windows


2003/2008
Antes de iniciar a instalao no Windows Server 2003/2008 deve-se seguir a
orientao abaixo.
No caso do Windows Server 2003/2008 tem uma segurana maior, devido a isso
ele no deixa ser instalado o Postgre dando a seguinte mensagem de erro:

A senha padro do Postgre pg3655, como o Windows Server 2008 por segurana
no aceita senhas fracas, ento a soluo alterar para uma senha complexa,
exemplo 1234.c@nguini, ou seja, com numero, letras e ao menos 2 caracteres
sendo um especial.
Para isso voc necessita alterar a senha dentro de um arquivo chamado
pg_senha.ini (este arquivo est anexo junto a este documento) e coloc-lo junto (na
mesma pasta) do instalador Instala D-TEF 8 - v8.1.10.0.exe.

Pag. 9 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

O instalador ir utilizar a senha contida no arquivo, ou seja, voc poder definir a


senha que quiser realizando a alterao abaixo neste arquivo:
[POSTGRES]
SENHA=novasenhaparaopostgres (alterar para a senha que desejar)
Exemplo:
[POSTGRES]
SENHA=1234.c@nguini
Salve o arquivo e inicie a instalao!
Durante a instalao do D-TEF, ir ocorrer um erro indicando que no foi possvel
realizar a criao da base de dados, e a tela do print em anexo ser exibida:

Clique habilitar digitao do usurio master.


No campo senha master, digite a senha escolhida (mesma que foi digitada no
arquivo pg_senha.ini).

Pag. 10 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Testando o ambiente instalado


Para validar o ambiente instalado e ver se est tudo ok, devemos clicar no Iniciar do
Windows, programas, Direo, D-POS 8 GP e rodar o D-POS App que vai abrir a
seguinte tela:

Nesta tela no precisa alterar, configurar ou acessar nenhuma opo, e ento para
iniciar o teste tecle F5 e ele abrir o GP na sua tela, pedindo o valor da transao,
coloque um valor qualquer e de ENTER, quando ele pedir o numero de carto digite
um dos nmeros de exemplo abaixo:
Pag. 11 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

4551820000009478
4551820000009486
Na prxima opo digite a seguinte data de validade:
11/11 ou 12/12
Na opo seguinte ele vai pedir o cdigo de segurana que pode ser qualquer
numero com 4 dgitos ou mais e de ENTER. Se ficar sem pode optar por ilegvel e
continuar, pronto a transao foi realizada.
Obs: caso der alguma mensagem de erro no GP voc pode efetuar o seguinte
procedimento:
Iniciar, executar e digite, services.msc que vai acessar os servios do Windows e
ento procure o D-TEF 8 e reinicie. Se mesmo assim der erro feche o simurede e a
Direo Client D-TEF que esto j situados na barra do relgio e reinicie o PC.
Garanta sempre que o Direo Client D-TEF e o simurede esto rodando na barra
de relgio.
Para consultar se a transao est ok, pendente ou cancelada, devemos acessar
um atalho que foi criado na Desktop que Monitorao e configurao D-TEF (que
est com cone do Internet Explore), aps abrir ele vai mostrar a seguinte tela
abaixo:

Pag. 12 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Para acessa-lo muito simples, digite o usurio integrador e a senha 1 ou dir3655 e


ser pedido para trocar a senha, coloca a senha de sua preferncia e ANOTE para
no perder.
Ao digitar o usurio e senha do DTEF-WEB voc vai acessar, procure a opo
Relatrios e depois Analticos:

Pag. 13 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Ao clicar em analtico teremos a empresa, loja, as redes e as transaes, na duvida


marque todas as opes para se obter o histrico de todos os cartes e locais de
rede que passou o carto, conforme segue a tela abaixo, estamos no menu ontem
poderemos selecionar varias opes para chegar onde precisamos que so as
transaes realizadas e seus status.

Veja que temos um boto Gerar na parte inferior direita, ao clicar no Gerar ele vai
criar um relatrio em PDF (pra isso voc deve ter um leitor de PDF j instalado em
seu PC) e l vai mostrar hora da transao, a data, NSU (numero da transao) e
o status dela se esto pendentes, canceladas, ok (j confirmadas) ou desfeitas.
Abaixo uma imagem de um relatrio gerado constando algumas transaes
efetuadas e seus respectivos status:

Pag. 14 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Obs: observe que temos do lado direito do relatrio uma serie de informaes como
OK que significa que a transao foi realizada ok e foi confirmado tambm sem
problemas e temos tambm o status Desfeita que significa que tivemos algum
problema na transao e foi desfeita.

Pag. 15 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Dicas e informaes para migrar/desenvolver o TEF IP


O TEF IP Daruma usa o Gerenciador padro da Direo, no qual ser possvel a
troca de arquivos assim como no discado, portanto, as rotinas do GP Direo para o
TEF Dedicado para avaliao, incluindo os mltiplos cartes, tabela das siglas que
so encontradas no decorrer das explicaes de como fazer a transao de acordo
com o TEF Dedicado.
ATV = Verifica se o Gerenciador Padro est ativo
ADM = Permite o acionamento da Soluo TEF Discado para execuo das funes
administrativas
CHQ = Pedido de autorizao para transao por meio de cheque
CRT = Pedido de autorizao para transao por meio de carto
CNC = Cancelamento de venda efetuada por qualquer meio de pagamento
CNF = Confirmao da venda e impresso de cupom

NCN = No confirmao da venda e/ou da impresso.


No TEF dedicado para TEF Discado existem sim diferenas no momento da
Transao, onde, devem ser realizados alguns ajustes no aplicativo, para isso
montamos aqui uma seqncia lgica de como estruturar a impresso do TEF bem
como tratamento de erros para aplicar no TEF Dedicado usando o GP.
Exemplos lgicos do Gerenciador Padro da Direo
##############################################################
1 Venda de 1 carto.
- ATV
- CRT
<1=se transao aprovada, imprimir comprovante>
<2=se impressao realizada com sucesso, confirma>
- ATV
-CNF
<senao, desfaz>
- ATV
-NCN
<fim2>
<fim1>

##############################################################

Pag. 16 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

##############################################################
Venda 1 carto desligamento.
- ATV
- CRT (Queda da impressora)
<1=no caso de desligamento da impressora, o AC deve aprensentar mensagem de
falha de comunicao e perguntar ao operador se deseja tentar novamente>
<2=se sim, tentar imprimir novamente>
<seno>
- ATV
- NCN
<fim2>
<fim1>

##############################################################
Venda de mltiplos cartes
1 Carto
- ATV
- CRT Campo 001-000 = 999xxxxxxx)
<AC "segura"o comprovante e seu respectivo NSU>
2 Carto
- ATV
- CRT Campo 001-000 = 999xxxxxx)
<AC "segura"o comprovante e seu respectivo NSU>
3 Carto
- ATV
- CRT Campo 001-000 = 002xxxxxx)
<AC "segura"o comprovante e seu respectivo NSU>
AC imprime todos comprovantes retidos depois manda 3 CNF, uma para cada
transao aprovada.
- ATV
- CNF campo 001-000 = 999xxxxxxx (com NSU da 1 da primeira transao)
- ATV
Pag. 17 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

- CNF campo 001-000 = 999xxxxxxx (com NSU da 2 da primeira transao)


- ATV
- CNF campo 001-000 = 002xxxxxxx (com NSU da 3 da primeira transao)
################################################################
Desligamento mltiplos.

- 1 Carto
- ATV
- CRT Campo 001-000 = 999xxxxxxx)
<AC "segura"o comprovante e seu respectivo NSU>
2 Carto
- ATV
- CRT Queda da impressora durante a impresso do comprovante.
- ATV
- NCN campo 001-000 = 999xxxxxxx (com NSU da 1 da primeira transao)
- ATV
- NCN campo 001-000 = XXXxxxxxxx (com NSU da 2 da primeira transao)
###################################################################
#

3 Cartes e fechando em dinheiro.


1 Carto
- ATV
- CRT Campo 001-000 = 999xxxxxxx)
<AC "segura"o comprovante e seu respectivo NSU>
2 Carto
- ATV
- CRT Campo 001-000 = 999xxxxxx)
<AC "segura"o comprovante e seu respectivo NSU>
3 Carto
Pag. 18 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

- ATV
- CRT Campo 001-000 = 002xxxxxx) Carto no aprovado fechar em dinheiro

AC imprime todos comprovantes retidos depois manda as CNF, uma para cada
transao aprovada.

- ATV
- CNF campo 001-000 = 999xxxxxxx (com NSU da 1 da primeira transao)
- ATV
- CNF campo 001-000 = 002xxxxxxx (com NSU da 2 da primeira transao)

Obs: No exemplo a segunda transao passa a ser considerada a ltima, com


isso a identificao da transao deve ser alterado os 3 dgitos iniciais de
=999xxxxxx para = 002xxxxxx e caso essa regra no for aplicada isso
implicar em desfazimento das transaes anteriores e/ou posteriores que
esto pendentes ao confirmar uma transao em MLTIPLOSCARTES.
###################################################################
####

Pag. 19 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Dicas para alterar o TEF Discado para TEF Dedicado c/


nico Carto

Mensagem de desfazimento e demais mensagens: est mensagem no


TEF Discado vem quando fazemos o cancelamento e ento o sistema de
automao mostra est mensagem, no TEF Dedicado o GP da Direo que
mostra essa mensagem, isso conceito de TEF Dedicado e no tem como
mudar. Neste ponto necessrio fazer ajustes no FOCO da tela de
desfazimento caso a mensagem perca o foco, nas demais mensagens
tambm exibido pelo GPDireo sendo assim voc deve remover as
mensagens que seu sistema apresenta e deixar que o GP Direo as mostre
para assim no ter problema de foco de tela. O mtodo da DLL para ajudar
nesta tarefa eTEF_SetarFoco_ECF_Daruma.

2 vias do documento vinculado: o TEF Discado voc recebi apenas 1 via


do documento vinculado, onde impresso e para ter-se a 2 via basta repetir
o comando e pronto temos as 2 vias de documento vinculado, no TEF
Dedicado o arquivo j traz as 2 vias, sendo assim voc dever mandar um
nico vinculado que vai conter as 2 vias em um nico documento vinculado.
Idem para o Cancelamento, porm suas vias sero impressas em um nico
relatrio gerencial.

Formas de pagamento: no TEF Discado voc deve mandar o dinheiro antes


e as demais formas depois, o TEF Dedicado voc deve passar todos os
vinculados primeiros e por ultimo o dinheiro, por qu? Por que caso haja
troco, o troco vai ser em cima do dinheiro.

Cancelamento de Cupom fiscal: no TEF Discado voc deve fechar o


documento vinculado ou relatrio gerencial j aberto, no TEF Dedicado voc
deve cancelar o cupom fiscal, fechar o vinculado e ou fechar o Relatrio
gerencial para contemplar os testes, neste caso voc usa o comando
rRetornaInformacao_ECF_Daruma retorna que retorna a informao
conforme o documento que est aberto na ECF, podemos ai usar o retorno
56:
0 = nenhum documento 1= CF 2= CNF 3= CCD 4= RG

Download do Help DLL Framework:


http://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Man
uais_e_STK/DarumaFrameWork_Help_CHM.zip

Pag. 20 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Alteraes a serem feitas para portar o TEF Dedicado


para Mltiplos Cartes

Confirmao: Em mltiplos cartes NECESSRIO alterar o sistema,


pois o TEF Dedicado tem a estrutura diferente do TEF Discado, o TEF
Discado funciona da seguinte forma, passa o carto e confirma uma a uma
as transaes, exemplo de 3 cartes, imprimi 1 via e confirma, imrpimi a 2 e
confirma e imprimi a 3 via e confirma, conforme vai passando os cartes, j
no TEF Dedicado no, passa o carto e no confirmar, ou seja, ele mantm a
confirmao pendente, e somente so confirmados os cartes TODOS de
uma nica vez quando o ultimo vinculado termina de ser impresso OK).
Vide estrutura lgica no final deste documento para Mltiplos Cartes.

Alm desta alterao, deve considerar TODAS acima descritas para


mltiplos cartes.

Obs: os testes onde esto presentes o focu de tela e/ou desligamento de


ECF/PC so os mais crticos na homologao, portanto os revise bem em
varias situaes conforme esto os roteiros.

Pag. 21 - 22

Suporte ao Desenvolvedor: 0800 770 332 0


www.desenvolvedoresdaruma.com.br

Fazendo a desinstalao do ambiente completo


Abaixo umas dicas para caso voc for reinstalar o ambiente ou mesmo antes de
instalar caso tenha alguma verso antiga.
OBS: para desinstalar deve ser desinstalar pelo Remover Programas do
Windows por algum motivo, voc necessita limpar/excluir os seguintes arquivos
e tambm:

Apagar o Apache.ini que est na pasta C:\Windows.


Tirar a DPOSDRV.DLL que est na pasta C:\Windows ou C:\Windows
\System32.
Apagar os arquivos dtef, dpos, GPDirecao, clientdtef5, tef.ini e ppvisa que
ficam situados em C:\Windows.
Excluir o usurio do Postgre, para isso clique com o boto direito do mouse
em meu computador, gerenciar, usurios e grupos locais, usurios e exclua o
usurio do postgre.
Excluir a pasta TEFdial, Direcao, GPdirecao e as Dpos que estivem na raiz
em C:\
Excluir os atalhos criados na Desktop e no menu de programas do Windows.
Excluir a pasta do usurio postgre que fica em usurios ou user em C:\
Excluir as pastas em C:\ Direcao, dpos8, suporte d-tef e tef_dial.

Contatos:
E-mails:
Desenvolvedores.tef@daruma.com.br; claudenir@daruma.com.br;
suporte.alexandre@daruma.com.br
Skypes:
desenvolvedores_tef, claudenir_andrade; daruma_suporte_alexandre
Telefone:
11-3146-4975

Pag. 22 - 22