TransactionCentre
Client
Manual de Instalao
Client Connection
Esta documentao, softwares e materiais disponibilizados so protegidos por
propriedade intelectual e no podem ser copiados, reproduzidos ou cedidos sob
qualquer forma ou pretexto sem prvia e formal autorizao da SevenPDV.
Out/2010
Confidencial
1. Introduo
2. Instalao Client Connection
3. Apoio Soluo de Erros
4. Venda Teste Realizao
1. Introduo *****
A finalidade deste documento apresentar os seguintes processos:
- Instalao do aplicativo Client Connection;
- Realizao do teste de ativao (venda teste);
Este manual fornece orientao sobre a instalao do aplicativo Client Connection,
responsvel pela comunicao entre o estabelecimento e os Autorizadores. No caso de dvidas ou
sugestes relativas a estas ferramentas, entre em contato com o departamento de Suporte da
SevenPDV, o qual est capacitado a lhe fornecer as informaes e apoio necessrios.
No caso de dvidas ou sugestes relacionadas utilizao de seu Sistema de Automao,
entre em contato com sua SoftwareHouse, que poder lhe orientar devidamente.
Este material, os programas e mdulos que o acompanham somente podero ser utilizados
para acesso ao sistema, divulgao e treinamento relativos soluo TransactionCentre (de
propriedade da SevenPDV), sendo vetada qualquer outra utilizao sem a prvia e formal
autorizao de sua proprietria.
O TransactionCentre uma plataforma de processamento de transaes eletrnicas para
Programas de Fidelidade em mltiplas Centrais de Autorizao e foi desenhada para atender
multiplicidade de modelos de funcionamento e tecnologias adotadas nos Sistemas de
Automao, propiciando um modelo de reposio integrada com diversos Distribuidores.
Confidencial
2. Instalao Client Connection
O aplicativo Client Connection responsvel pela comunicao entre o Sistema de
Automao Comercial de seu estabelecimento e o Sistema Autorizador de cada Administradora
(que armazena as informaes dos portadores de cartes e lhes concede os devidos benefcios /
descontos). Antes de realizar a instalao da Client Connection, observe os requisitos bsicos para
o processo:
- O estabelecimento deve possuir Internet Banda Larga.
- O cadastro do estabelecimento no Portal da Drogaria ([Link]) deve
estar completo. Caso no esteja, selecione a aba Cadastro e clique na opo
Manuteno de filiais para verificar se o campo Prximos passos, j solicita que sejam
feitas a instalao e a venda teste.
- Aps completar o cadastro do estabelecimento, aguarde 24 horas para realizar a instalao
da Client Connection.
- A instalao deve ser efetuada no computador ligado impressora fiscal para que as
vendas sejam realizadas com sucesso.
Para realizar a instalao da Client Connection, siga os passos apresentados a seguir:
- acesse [Link]/material/install
- clique no arquivo INSTALL_TRNCCLIENT_KY9.zip e salve o mesmo em uma pasta de fcil
acesso, como por exemplo, sua rea de Trabalho
- realize a descompactao do arquivo, extraindo-o para a rea de Trabalho. Ser criada
automaticamente uma pasta de nome INSTALL_TRNCCLIENT_KY9.
- entre na pasta INSTALL_TRNCCLIENT_KY9 e, dentro desta, entre na pasta DISK1
- clique duas vezes no arquivo [Link] e em seguida, ser apresentada a janela abaixo:
fig. 1
Confidencial
- no combo Tipo de Instalao, selecione Servidor/Estao
- no combo Modo de Acesso, selecione Dedicado TCP/IP
- no campo Endereo do Servidor, digite: localhost
- no combo Unidade de disco Instalado, selecione C:
- selecione (habilite) a opo Ftp Passive Mode
- os demais campos no devem ser preenchidos
- clique no boto Salvar, a seguinte janela ser apresentada:
fig. 2
- no campo CNPJ, digite o CNPJ de seu estabelecimento, sem pontuao, barras, hfens ou
espaos. Observe que este CNPJ dever estar cadastrado no Portal da Drogaria;
- no campo Nome Fantasia, digite o nome fantasia de seu estabelecimento (no h distino
entre letras maisculas e minsculas);
- no campo Logradouro (Rua, Av, Praa, etc), digite o endereo de seu estabelecimento
precedido do tipo de logradouro, sem numerao (exemplo: Av Paulista);
- no campo Nmero, digite o nmero do endereo de seu estabelecimento;
- no campo Complemento, digite os dados complementares do endereo, caso necessrio;
- no campo CEP, digite o CEP de seu estabelecimento, sem hfens ou espaos;
- no campo Nome do Instalador, informe o nome do responsvel pela instalao;
- no campo N do Documento, informe o nmero do documento (RG ou CPF) do instalador;
- clique no boto Salvar, a seguinte janela ser apresentada:
Confidencial
fig. 3
- no combo Tipo de Leitor, selecione a forma utilizada para a captura do nmero do carto do
portador, conforme segue:
o Se a captura do nmero do carto do portador for feita atravs de digitao,
selecione a opo Nenhum e clique no boto Salvar;
o Se a captura do nmero do carto do portador for feita atravs de um leitor de trilha
magntica, selecione a opo Leitor de Trilha e clique no boto Salvar;
o Se a captura do nmero do carto do portador for feita atravs de um PinPad
seguro, selecione a opo PinPad. No combo Modelo, selecione o modelo do
PinPad utilizado, no combo Porta Serial, selecione a porta serial utilizada pelo
PinPad e clique no boto Salvar.
- Se desejar ou caso no saiba a forma de captura utilizada, voc poder alterar o Tipo de
Leitor a qualquer momento aps a instalao. Assim, selecione a opo Nenhum e clique
no boto Salvar.
- A seguinte janela ser apresentada:
Confidencial
fig. 4
- as informaes de CNPJ e Nome Fantasia sero apresentadas;
- no campo Seleciona Tipo Estabelecimento, a opo Estabelecimento dever estar
selecionada. Caso no esteja, selecione-a;
- no combo Operadora, selecione INSTALL;
- no campo Administradora, digite: TRNCENTR caso esta informao no seja apresentada
automaticamente aps a seleo da Operadora;
- nas opes de leitura, selecione Digitao e aperte a tecla ENTER. Observe que esta
instruo vlida mesmo para aqueles que anteriormente selecionaram o Tipo de Leitor
PinPad;
- aps apertar ENTER, o campo Nmero do Carto ser apresentado. Digite o nmero
999111999222999 e aperte a tecla ENTER;
- aps apertar ENTER, os campos CEP e Nmero do Estabelecimento sero apresentados.
Digite o CEP e nmero do endereo de seu estabelecimento informados anteriormente e
aperte a tecla ENTER ou clique no boto F2 Pr Autorizao;
- a seguinte janela ser apresentada:
fig. 5
Confidencial
- anote o Cdigo de Ativao apresentado e clique no boto OK
Observao: Os passos acima, referentes obteno do cdigo de ativao atravs
da operadora INSTALL, podero ser repetidos quantas vezes forem necessrias. O
Cdigo de ativao ser sempre o mesmo para um determinado CNPJ.
- aps realizados estes passos, clique no menu Iniciar > Programas > Transaction Centre >
Configurador, conforme a figura abaixo:
fig. 6
- ao clicar em Configurador, a seguinte janela ser apresentada:
fig. 7
- no campo apresentado, digite o Cdigo de Ativao fornecido anteriormente e clique no
boto Salvar;
Confidencial
- a seguinte janela dever ser apresentada:
fig. 8
- clique no boto OK para confirmar. Sua instalao j est completa neste ponto
- a seguinte janela dever ser apresentada:
fig. 9
- Atravs do Configurador do TransactionCentreClient voc poder:
o Acessar as Configuraes Locais (abre a janela apresentada na figura 3), onde voc
poder selecionar / alterar o Tipo de Leitor utilizado;
o Acessar as Configuraes Server (abre a janela apresentada na figura 1), onde
voc poder selecionar / alterar algumas das configuraes do servidor.
- para sair do Configurador, clique no boto Cancelar;
- voc poder acessar o Configurador a qualquer momento seguindo os passos descritos na
figura 6 (menu Iniciar > Programas > Transaction Centre > Configurador)
Confidencial
Ateno: Antes de alterar qualquer parmetro do Configurador, o aplicativo
TransactionCentreClient deve estar fechado. aconselhvel fechar tambm a Client Connection
caso as alteraes sejam referentes ao modo de acesso, nome da conexo, etc. Para fechar a
Client Connection, basta clicar duas vezes sobre o cone localizado na rea de Notificao, prximo
ao relgio (ver figura abaixo). Uma janela ser aberta com as opes Ocultar e Fechar. Para
encerrar a Client Connection, clique no boto Fechar. Para cancelar, clique no boto Ocultar.
fig. 10
Ateno: Aps realizar a instalao, recomendvel fechar o aplicativo TransactionCentreClient
e aguardar alguns segundos antes de reinici-lo.
Ateno: Aps realizada a instalao, necessrio executar o teste de ativao para que seja
obtido o nmero de protocolo a ser utilizado no Termo de Adeso (junto s Administradoras). Alm
disso, este teste garante que sua instalao foi realizada com sucesso. Siga os passos descritos a
seguir para saber como efetuar seu teste de ativao.
3. Operao Teste de Ativao
A realizao do teste de ativao tem por finalidade:
- ativar o estabelecimento (Obrigatrio), gerando o nmero de protocolo que dever ser
utilizado no Termo de Adeso junto (s) Administradora(s);
- permitir a realizao de testes sem afetar as reposies do estabelecimento (uma venda
teste no gera reposio automtica);
- testar o funcionamento do ambiente e treinar os colaboradores do estabelecimento.
Confidencial
Os dados utilizados para a realizao do teste de ativao so:
- operadora: LogixPharma (LGX)
- n do carto: 63957300000000013
- opes de medicamentos (utilizar pelo menos um deles): 7896261005860,
7896094201187, 7891268106596
O teste de ativao deve ser realizado seguindo o procedimento normal utilizado para venda
pelo estabelecimento, de acordo com seu modelo operacional.
Ateno: O teste dever ser realizado at sua finalizao, ou seja, a venda deve ser simulada, com
um dos produtos informados acima, tal qual ocorreria em condies normais, sendo obrigatria a
impresso do comprovante de benefcio (cupom vinculado/relatrio gerencial).
Observaes importantes sobre o teste de ativao:
- No deixe de fazer seu teste de ativao. Somente aps a realizao do teste o nmero de
protocolo de seu estabelecimento ser gerado. Este nmero requerido no Termo de Adeso a ser
firmado junto aos Laboratrios com os quais o estabelecimento tenha interesse em trabalhar. O
nmero de protocolo gerado 48 horas aps a realizao do teste de ativao e disponibilizado
ao estabelecimento atravs do Portal da Drogaria ([Link]).
- Sem a realizao da venda teste, o estabelecimento no poder se Credenciar a nenhuma
Administradora e, consequentemente, no poder participar de seus Programas de Benefcio.
- No deixe de fazer o teste de ativao aps a instalao. Ele ir garantir que os procedimentos
foram realizados com sucesso e servir como um treinamento para a realizao de vendas.
No caso de dvidas ou sugestes relacionadas utilizao de seu Sistema de Automao,
entre em contato com sua SoftwareHouse (Empresa Desenvolvedora do sistema) , que poder lhe
orientar devidamente.
4. Apoio Soluo de Erros
Seguindo as instrues acima, dificilmente haver algum impedimento para a realizao da
venda teste e obteno do nmero de protocolo.
Entretanto, devido a particularidades de cada computador, como verso do Windows ou utilizao
de Firewall, possvel que seu estabelecimento se depare com alguma das mensagens que
mostraremos a seguir, porm se necessrio, solicite o acompanhamento de um tcnico:
4.1 Configurao do parmetro Port2Listen no arquivo [Link] est errada.
Confidencial
fig. 11
Essa mensagem exibida quando o Sistema Operacional Windows Vista ou Seven. Para
Solucionar este problema, siga os passos abaixo:
- Clicar em OK e em seguida ir no diretrio de instalao do Transaction Centre (Meu
Computador > Disco Local C: > TRNCENTR), localizar o executvel [Link], clicar
com o boto direito em cima do executvel e selecionar a opo Propriedades em seguida na aba
Compatibilidade. Marcar no Box a opo Executar este programa em modo de compatibilidade e
abaixo selecionar a opo Windows XP (Service Pack 2), em seguida clicar em Aplicar e OK,
conforme imagem abaixo:
fig. 12
Confidencial
4 - Executar a Client Connection que dever carregar normalmente.
5 - Abrir o Prompt de Comando (Menu Iniciar > Todos os Programas > Acessrios > Prompt de
Comando) e acessar o diretrio onde foi instalado o Transaction Centre (C:\TRNCENTR). No
diretrio de instalao digitar o seguinte:
regsvr32 [Link] e em seguida executar (pressione o boto Enter).
Aparecer um BOX dizendo se o processo foi realizado com sucesso, conforme figura abaixo:
fig. 13
Caso no ocorra a mensagem acima verificar se o procedimento foi corretamente executado.
OBS: Este processo serve para registrar a DLL no sistema, para que assim qualquer usurio possa
utilizar a [Link] sem necessitar se logar como Administrador.
6 Aps o processo fazer uma transao teste afim de verificar se todo processo foi realizado
corretamente.
4.2 163 Falha na Conexo com a Internet.
Essa mensagem exibida quando, por algum bloqueio do computador, o ClientConnection no
consegue estabelecer conexo com a Internet.
Confidencial
fig. 14
Caso essa mensagem seja exibida, verifique os seguintes itens:
1 O Client Connection (figura 10), deve estar ativo, prximo ao relgio. Se no estiver, ele poder
ser aberto de duas Formas:
1- Abra o Menu Iniciar > Todos os Programas > Inicializar > TransactionCentre
ClientConnection
fig.15
2 - Clique no cone Meu Computador, abra o Disco Local (C:), em seguida a pasta
TRNCENTR e abra com duplo clique em ClientConnection (ou [Link]).
2 O endereo do Servidor deve ser localhost para o tipo de instalao Servidor ou
Servidor/Estao. Para conferir a informao registrada, abra o Configurador (figura 6) e, na tela
exibida ser possvel conferir a informao neste campo e alter-la atravs do boto
Configuraes Server, conforme as imagens abaixo.
Confidencial
fig. 16
Este Campo tambm poder ser corrigido da seguinte forma:
1- Acesse a Pasta C:\ TRNCENTR (Meu Computador > Disco Local C: > TRNCENTR)
2- Abra o arquivo Core (ou [Link])
3- Altere o contedo das linhas IPServer e Adress para localhost
4- Salve a Alterao atravs do menu Arquivo, Opo Salvar e feche o arquivo.
3 Algumas portas e/ou IPs devem estar liberados em sua mquina. So Eles:
Relao de IP's habilitados PROXY
Endereo IP
[Link] [Link]
[Link] [Link]
[Link] [Link]
Relao de Portas habilitadas FIREWALL
Endereo IP PORTAS
IP: [Link] 5002 at 5006
IP: [Link] 5002 at 5006
IP: [Link] 5002 at 5006
IP: [Link] 5002 at 5006
IP: [Link] 6002 at 6006
possvel saber quais foram bloqueados atravs do aplicativo StatusCon, presente na pasta
C:\TRNCENTR. Apenas abra-o e pressione o boto OK e ele testar a conexo e mostrar se as
portas esto liberadas ou no, conforme a imagem abaixo:
Confidencial
fig. 17
Caso aparea ERRO em alguma linha, significa que a porta (ou o ClientConnection) est
bloqueado. Neste caso, solicite a liberao ao tcnico responsvel pela manuteno dos
Computadores do estabelecimento. importante lembrar que alguns Antivrus tambm bloqueiam
o ClientConnection, se este for o seu caso, tambm ser necessrio configur-lo para que permita
o funcionamento do aplicativo.
Confidencial