instalando configurando ambiente dtef off-line

7/24/2019 Instalando Configurando Ambiente DTEF Off-line

1/22

Pag. 1 - 22

Suporte ao Desenvolvedor:0800 770 332 0www.desenvolvedoresdaruma.com.br

Manual para ins talao e con figurao do

ambien te OFF-L INE de Tes tes de homologaodo

TEF Dedicado Daruma IP

Apl icat ivo DTEF(OFF-LINE)

Verso 1.0 .0.6Data: 24/05/2011


2/22

Pag. 2 - 22


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/Ambiente_de_Instalacao_off-line_Completo.zip

Para Download do Gerenciador padro, clique no link abaixo:www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenciador_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.
http://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Ambiente_de_Instalacao_Completo.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Ambiente_de_Instalacao_Completo.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Ambiente_de_Instalacao_Completo.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenciador_Padrao.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenciador_Padrao.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenciador_Padrao.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenciador_Padrao.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Gerenciador_Padrao.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Ambiente_de_Instalacao_Completo.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Utilitarios/Ambiente_de_Instalacao_Completo.zip


3/22

Pag. 3 - 22


Introduo

Resumo do TEF IP Daruma:

A DIREO e a DARUMA firmaram uma parceria para comercializao da soluoTEF IP Daruma. Dentro desta parceria, a DARUMA est habilitada a realizar as atividadesde consultoria para integrao das aplicaes com o D-TEF e acompanhamento dascertificaes, desta forma, gostaramos que a Certified acatasse as solicitaes deagendamento de certificaes com o D-TEF pela DARUMA, em nome da Direo.

A Direo disponibiliza o programa GP (gerenciador padro) e o ambiente de simulaocompleto que converte todo o modulo de TEF Discado que j est funcionando, para TEFDedicado onde usando o GP (Gerenciador Padro) que realiza a troca de arquivos como noTEF Discado, porm, para o TEF Dedicado, evitando assim um novo desenvolvimento dozero para o TEF Dedicado usando uma DLL ou Driver similar. A troca de arquivos passarfazer as transaes do TEF Dedicado apenas instalando o ambiente de teste para o TEFDedicado, ficando assim transparente para seu aplicativo se discado ou dedicado acomunicao.

Obs:a estrutur a do TEF discado diferente do TEF Dedicado , no entantotero qu e ser real izadas algumas mu danas no sistem a sim c onfo rme descr i tono f inal deste documento.

Quais as vantagens deste TEF da Daruma?

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

Precisa de poucas alteraes no sistema pra homologar, (vide as alteraesnecessrias no final deste documento) o TEF Dedicado, ou seja, noprecisa desenvolverum novo modu lo do s is tema, pra isso basta usar oque voc j tem do discado, que, o GP da Direo vai efetuar a troca dearquivos, convertendo para o TEF Dedicado, dentro das regras do TEFDedicado, tanto um nico Carto quanto para Mltiplos Cartes.

O cliente final paga por transao, ou seja, pacote de transao (somente oque 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 3Gde internet que jtem funcionando na loja.

Homologa todas as bandeiras em uma nica homologao, lembrando que aDireo, ou seja, o DTEF j contempla todas as redes autorizadas domercado (vide o manual Redes Autorizadas no linkwww.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.zip

Pode usar o mesmo sistema fazendo poucos ajustes para certificar o Tefdiscado caso precisar posteriormente.
http://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais/Redes_Autorizadoras_D-TEF8.zip


4/22

Pag. 4 - 22


Instalando o ambiente completo

Este mdulo destinasse a instalao do ambiente de teste para o aplicativo TEFDedicado, que incluir o instalador off-line e o Gerenciador padro, no qual sernecessrio para se ter o ambiente completo e funcional para testes dehomologao.

A primeira instalao ser do ambiente completo.

OBS: os programas deste STK foram instalados e testados nos seguintes sistemasoperacionais em 32 bitscom 100% de funcionamento:

Windows XP

Windows VistaWindows 7Windows Server 2003 e Windows Server 2008> exige obrigatoriamente o arquivo

pg_senha.ini necessrio apenas para estas verses de Windows 2008 e 2003Server, o arquivo que est junto a este documento para download, e neste STKteremos a abordagem dos tpico necessrios para instalar, configurar e testar oambiente TEF completo para estas 2 verses do Windows, que tem particularidadesde segurana que impedem que seja instalado o banco de dados Postgre, queexige criao de usurio Postgre que guarda os dados das transaes e uma senhaque no pode ser fraca. Neste caso faa a configurao do pg_senha.ini ANTESde iniciar a instalao do ambiente.

Para ambiente 64 bitsno funciona! incompatvel!


5/22

Pag. 5 - 22


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 ouno, porm, voc deve ter um programa leitor qualquer de PDFOBRIGATORIAMENTE em seu PC para conseguir consultar as transaes de TEFrealizadas.


6/22

Pag. 6 - 22


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

Instale o GP que baixamos no inicio do STK, este programa tambm no temparticularidades, 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 oApache, 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 comboto direito do mouse em HTTP, opo novo e clique em Valor DWORD (32 Bits)

de-lhe o nome de NoRun mude seu valor para1.


7/22

Pag. 7 - 22


Na chave Start do diretrio HTTP, mude seu valor para 0.Reinicie o sistemaoperacional.

Obs: caso tenha o IIS ins talado, aps a ins talao do Ap ache pode travar ouaps e/ou no fu ncionar, isso ocorre d evido ambos os p rogramas ocu parem apo rta 80 por default, assim c om o MSN ou Skyp e tambm p odem. Para resolverisso mu de a por ta do apache d e 80 para 8081.

Para alterar a porta do Apache siga os passos abaixo:

muito simples. Basta acessar o arquivo httpd.conf, que fica localizado emC:\DIRECAO\HTTP\ApacheGroup\Apache2\conf\httpd.conf, dentro do arquivoencontre as seguintes linhas:

#Listen 12.34.56.78:80Listen 80

Veja que a linha que contm o # apenas comentrio, a linha Listen 80 a quedeve ser alterada (eu coloquei 8080 porque geralmente a mais usada mais vocpode escolher qualquer porta).

#Listen 12.34.56.78:8080Listen 8080

Lembre-se agora quando voc for acessar internamente coloque no lugar desimplesmente:

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 conflitotambm na instalao do Apache), iniciando automaticamente junto comWindows.

O Servidor IIS7 est funcionando normalmente em http://localhost O Servidor Apache tambm est funcionando normalmente em

http://localhost:8080
http://localhost:8080/http://localhost:8080/http://localhost:8080/


8/22

Pag. 8 - 22


Configurando o Pin-Pad

Ao tentar fazer a primeira transao voc perceber que o Gerenciador Padro vaidar erro de Pin-Pad, para resolver isso voc deve ter o Pin-Pad conectadocorretamente 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 umasenha que dpos (tudo minsculo) ou DPOS (tudo maisculo), acessa a guia Pin-Pad e desmarque a opo Pin-Pad Ativo e pronto, se tiver Pin-Pad basta configurara porta com que ele est lembrando de marcar a opo Pin-Pad ativo e pronto jpode testar com o Carto fisicamente.


9/22

Pag. 9 - 22


Configurando o arquivo pg_senha.ini para Windows

2003/2008Antes de iniciar a instalao no Windows Server 2003/2008 deve-se seguir aorientao abaixo.

No caso do Windows Server 2003/2008 tem uma segurana maior, devido a issoele no deixa ser instalado o Postgre dando a seguinte mensagem de erro:

A senha padro do Postgre pg3655, como o Windows Server 2008 por seguranano aceita senhas fracas, ento a soluo alterar para uma senha complexa,exemplo 1234.c@nguini, ou seja, com numero, letras e ao menos 2 caracteressendo um especial.

Para isso voc necessita alterar a senha dentro de um arquivo chamadopg_senha.ini (este arquivo est anexo junto a este documento) e coloc-lo junto (namesma pasta) do instalador Instala D-TEF 8 - v8.1.10.0.exe.
mailto:1234.c@nguinimailto:1234.c@nguinimailto:1234.c@nguini


10/22


11/22

Pag. 11 - 22


Testando o ambiente instalado

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

Nesta tela noprecisa alterar, configurar ou acessar nenhuma opo, e ento parainiciar 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 digiteum dos nmeros de exemplo abaixo:


12/22

Pag. 12 - 22


45518200000094784551820000009486

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 qualquernumero com 4 dgitos ou mais e de ENTER. Se ficar sem pode optar por ilegvel econtinuar, pronto a transao foi realizada.

Obs: caso der alguma mensagem de erro no GP voc pode efetuar o seguinteprocedimento:

Iniciar, executar e digite, services.msc que vai acessar os servios do Windows eento procure o D-TEF 8 e reinicie. Se mesmo assim der erro feche o simurede e aDireo 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 barrade relgio.

Para consultar se a transao est ok, pendente ou cancelada, devemos acessarum atalho que foi criado na Desktop que Monitorao e configurao D-TEF(queest com cone do Internet Explore), aps abrir ele vai mostrar a seguinte telaabaixo:


13/22

Pag. 13 - 22


Para acessa-lo muito simples, digite o usurio integradore a senha 1ou dir3655eser pedido para trocar a senha, coloca a senha de sua preferncia e ANOTEpara

no perder.Ao digitar o usurio e senha do DTEF-WEB voc vai acessar, procure a opoRelatrios e depois Analticos:


14/22

Pag. 14 - 22


Ao clicar em analtico teremos a empresa, loja, as redes e as transaes, na duvidamarque 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 ontempoderemos selecionar varias opes para chegar onde precisamos que so astransaes realizadas e seus status.

Veja que temos um boto Gerar na parte inferior direita, ao clicar no Gerar ele vaicriar um relatrio em PDF (pra isso voc deve ter um leitor de PDF j instalado emseu PC)e l vai mostrar hora da transao, a data, NSU (numero da transao) eo status dela se esto pendentes, canceladas, ok (j confirmadas) ou desfeitas.

Abaixo uma imagem de um relatrio gerado constando algumas transaesefetuadas e seus respectivos status:


15/22

Pag. 15 - 22


Obs: observe que temos do lado direito do relatrio uma serie de informaes comoOK que significa que a transao foi realizada ok e foi confirmado tambm semproblemas e temos tambm o status Desfeita que significa que tivemos algumproblema na transao e foi desfeita.


16/22

Pag. 16 - 22


Dicas e informaes para migrar/desenvolver o TEF IP

O TEF IP Daruma usa o Gerenciador padro da Direo, no qual ser possvel atroca de arquivos assim como no discado, portanto, as rotinas do GP Direo para oTEF Dedicado para avaliao, incluindo os mltiplos cartes, tabela das siglas queso encontradas no decorrer das explicaes de como fazer a transao de acordocom o TEF Dedicado.

ATV= Verifica se o Gerenciador Padro est ativoADM = Permite o acionamento da Soluo TEF Discado para execuo das funesadministrativasCHQ= Pedido de autorizao para transao por meio de chequeCRT = Pedido de autorizao para transao por meio de carto

CNC = Cancelamento de venda efetuada por qualquer meio de pagamentoCNF= Confirmao da venda e impresso de cupomNCN= No confirmao da venda e/ou da impresso.

No TEF dedicado para TEF Discado existem sim diferenas no momento daTransao, onde, devem ser realizados alguns ajustes no aplicativo, para issomontamos aqui uma seqncia lgica de como estruturar a impresso do TEF bemcomo tratamento de erros para aplicar no TEF Dedicado usando o GP.

Exemplos lgicos do Gerenciador Padro da Direo

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

1Venda de 1 carto.

- ATV- CRT

- ATV-CNF

- ATV-NCN

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


17/22

Pag. 17 - 22


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

Venda 1 carto desligamento.- ATV- CRT(Queda da impressora)

- ATV- NCN

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

Venda de mltiplos cartes

1 Carto

- ATV- CRTCampo 001-000 = 999xxxxxxx)

2 Carto

- ATV- CRTCampo 001-000 = 999xxxxxx)

3 Carto


AC imprime todos comprovantes retidos depois manda 3 CNF, uma para cadatransao aprovada.

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

- ATV


18/22

Pag. 18 - 22


- 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- CRTCampo 001-000 = 999xxxxxxx)

2 Carto

- ATV- CRTQueda da impressora durante a impresso do comprovante.

- ATV- NCNcampo 001-000 = 999xxxxxxx(com NSU da 1 da primeira transao)

- ATV

- NCNcampo 001-000 = XXXxxxxxxx(com NSU da 2 da primeira transao)

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

3 Cartes e fechando em dinheiro.

1 Carto

- ATV

- CRTCampo 001-000 = 999xxxxxxx)

2 Carto


3 Carto


19/22

Pag. 19 - 22


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

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

- ATV- CNFcampo 001-000 = 999xxxxxxx(com NSU da 1 da primeira transao)

- ATV- CNFcampo 001-000 = 002xxxxxxx(com NSU da 2 da primeira transao)

Obs: No exemplo a segunda transao passa a ser considerada a ltima, comisso a identificao da transao deve ser alterado os 3 dgitos iniciais de=999xxxxxx para = 002xxxxxx e caso essa regra no for aplicada issoimplicar em desfazimento das transaes anteriores e/ou posteriores queesto pendentes ao confirmar uma transao em MLTIPLOSCARTES.

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


20/22

Pag. 20 - 22


Dicas para alterar o TEF Discado para TEF Dedicado c/nico Carto

Mensagem de desfazimento e demais mensagens: est mensagem noTEF Discado vem quando fazemos o cancelamento e ento o sistema deautomao mostra est mensagem, no TEF Dedicado o GP da Direo quemostra essa mensagem, isso conceito de TEF Dedicado e no tem comomudar. Neste ponto necessrio fazer ajustes no FOCO da tela dedesfazimento caso a mensagem perca o foco, nas demais mensagenstambm exibido pelo GPDireo sendo assim voc deve remover asmensagens que seu sistema apresenta e deixar que o GP Direo as mostrepara assim no ter problema de foco de tela. O mtodo da DLL para ajudarnesta tarefa eTEF_SetarFoco_ECF_Daruma.

2 vias do documento vinculado: o TEF Discado voc recebi apenas 1 viado documento vinculado, onde impresso e para ter-se a 2 via basta repetiro comando e pronto temos as 2 vias de documento vinculado, no TEFDedicado o arquivo j traz as 2 vias, sendo assim voc dever mandar umnico vinculado que vai conter as 2 vias em um nico documento vinculado.Idem para o Cancelamento, porm suas vias sero impressas em um nicorelatrio gerencial.

Formas de pagamento: no TEF Discado voc deve mandar o dinheiro antese as demais formas depois, o TEF Dedicado voc deve passar todos osvinculados primeiros e por ultimo o dinheiro, por qu? Por que caso hajatroco, o troco vai ser em cima do dinheiro.

Cancelamento de Cupom fiscal: no TEF Discado voc deve fechar odocumento vinculado ou relatrio gerencial j aberto, no TEF Dedicado vocdeve cancelar o cupom fiscal, fechar o vinculado e ou fechar o Relatriogerencial para contemplar os testes, neste caso voc usa o comandorRetornaInformacao_ECF_Daruma retorna que retorna a informaoconforme o documento que est aberto na ECF, podemos ai usar o retorno56:

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
http://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais_e_STK/DarumaFrameWork_Help_CHM.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais_e_STK/DarumaFrameWork_Help_CHM.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais_e_STK/DarumaFrameWork_Help_CHM.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais_e_STK/DarumaFrameWork_Help_CHM.ziphttp://www.desenvolvedoresdaruma.com.br/home/downloads/Site_2011/Manuais_e_STK/DarumaFrameWork_Help_CHM.zip


21/22

Pag. 21 - 22


Alteraes a serem feitas para portar o TEF Dedicadopara Mltiplos Cartes

Confirmao: Em mltiplos cartes NECESSRIO alterar o sistema,pois o TEF Dedicado tem a estrutura diferente do TEF Discado, o TEFDiscado funciona da seguinte forma, passa o carto e confirma uma a umaas transaes, exemplo de 3 cartes, imprimi 1 via e confirma, imrpimi a 2 econfirma e imprimi a 3 via e confirma, conforme vai passando os cartes, jno TEF Dedicado no, passa o carto e no confirmar, ou seja, ele mantm aconfirmao pendente, e somente so confirmados os cartes TODOS deuma 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 paramltiplos cartes.

Obs: os testes onde esto presentes o focu de tela e/ou desligamento deECF/PC so os mais crticos na homologao, portanto os revise bem emvarias situaes conforme esto os roteiros.


22/22


Fazendo a desinstalao do ambiente completo

Abaixo umas dicas para caso voc for reinstalar o ambiente ou mesmo antes deinstalar caso tenha alguma verso antiga.

OBS: para desinstalar deve ser desinstalar pelo Remover Programas doWindows por algum motivo, voc necessita limpar/excluir os seguintes arquivose 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 ousurio do postgre.

Excluir a pasta TEFdial, Direcao, GPdirecao e as Dpos que estivem na raizem 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:[email protected];[email protected];[email protected]

Skypes:desenvolvedores_tef, claudenir_andrade; daruma_suporte_alexandre

Telefone:11-3146-4975
mailto:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]:[email protected]

instalando configurando ambiente dtef off-line

Documents