Roteiro de Instalação e...

Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br

Página 1 de 20 Versão 1.8 Data: 08/07/2016

Roteiro de Instalação e Configuração

Módulo ValeCard

mailto:[email protected]



Conteúdo

1. INTRODUÇÃO ........................................................................................................................................... 3

2. DESCRIÇÃO DO NEGÓCIO ..................................................................................................................... 3

3. PRÉ-REQUISITOS .................................................................................................................................... 3

IMPORTANTE: .......................................................................................................................................... 3

4. INSTALAÇÃO DO MÓDULO VALECARD ................................................................................................ 4

4.1 BACKUP ................................................................................................................................................... 4 4.2 INSTALAÇÃO ............................................................................................................................................. 4 4.3 ROLLBACK ............................................................................................................................................... 4

5. COMPONENTES DO MÓDULO ............................................................................................................... 5

6. CONFIGURAÇÃO DO MÓDULO VALECARD NO SITEF ........................................................................ 6

7. CARGA DE TABELAS ............................................................................................................................. 10

8. VISUALIZANDO TABELAS ..................................................................................................................... 11

9. CONFIGURAÇÃO DO CONFIGURADOR COMBUSTÍVEL ................................................................... 12

10. RELATÓRIOS .......................................................................................................................................... 15

11. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA VALECARD .......................................... 15

12. CONFIGURAÇÃO DO PONTO DE VENDA (PDV) ................................................................................. 16

12.1 INTERFACE CLISITEF .............................................................................................................................. 16 12.1.1 Compra Crédito ............................................................................................................................. 16 12.1.2 Compra Débito .............................................................................................................................. 16 12.1.3 Compra Combustível .................................................................................................................... 16 12.1.4 Consulta de Saldo Combustível ................................................................................................... 17 12.1.5 Cancelamento ............................................................................................................................... 17

12.2 INTERFACE CLIENT MODULAR ................................................................................................................. 18 12.2.1 Compra Crédito ............................................................................................................................. 18 12.2.2 Compra Débito .............................................................................................................................. 18 12.2.3 Compra Combustível .................................................................................................................... 18 12.2.4 Consulta de Saldo Combustível ................................................................................................... 18 12.2.5 Cancelamento ............................................................................................................................... 19

13. TABELA DE CÓDIGOS DE RETORNO DA ADMINISTRADORA. ......................................................... 19

14. HISTÓRICO DE VERSÕES .................................................................................................................... 19




1. Introdução

Este documento destina-se ao usuário que pretende instalar e configurar o módulo ValeCard no SiTef.

2. Descrição do Negócio

O autorizador ValeCard processa cartões da própria bandeira ValeCard, disponibilizando as transações de

Débito a vista, Débito parcelado, Crédito a vista, parcelado com juros e parcelado sem juros, Combustível e

Consulta Saldo Combustível (débito e crédito).

3. Pré-Requisitos

Nome Descrição Versão Mínima

Client Modular Interface PDV 5.0.2.8

CliSiTef Interface PDV cc94

IMPORTANTE: Para utilizar o Pinpad Ingênico é recomendada a versão do firmware 4.21.

Link para download das versões atualizadas:

CliSiTef - Win 32 bits

https://www.softwareexpress.com.br/distri/aplicativos/clisitefwin32.zip

CliSiTef – Linux

https://www.softwareexpress.com.br/distri/aplicativos/linuxclisitef.zip

Client Modular

https://www.softwareexpress.com.br/distri/aplicativos/clientsitef.zip

SiTef Produção

https://www.softwareexpress.com.br/distri/aplicativos/sitef.zip

Gateway, solicitar versão com [email protected]

SiTefWeb e Exportadores, solicitar versões com [email protected]


https://www.softwareexpress.com.br/distri/aplicativos/clisitefwin32.zip

https://www.softwareexpress.com.br/distri/aplicativos/linuxclisitef.zip

https://www.softwareexpress.com.br/distri/aplicativos/clientsitef.zip

https://www.softwareexpress.com.br/distri/aplicativos/sitef.zip





4. Instalação do Módulo ValeCard

4.1 Backup

a) Efetuar uma cópia de backup das pastas \SiTef\CONFIG e \SiTef\APLIC.WIN

4.2 Instalação

a) Efetuar o download do modulo ValeCard no link

https://www.softwareexpress.com.br/distri/aplicativos/valecard.zip

b) Descompactar o arquivo ValeCard.zip em uma pasta temporária, por exemplo C:\Instalacao\

c) Finalizar o serviço do SiTef - Solução Inteligente através dos serviços do Windows

d) Acessar o diretório temporário criado (C:\Instalacao), executar o programa Instala.exe e seguir os

passos Next ► Finish

e) Efetuar a configuração conforme item 6 abaixo:

f) Em seguida ativar o serviço do SiTef - Solução Inteligente através dos serviços do Windows.

4.3 RollBack

**Recomendado quando realizado atualização no mesmo dia**

Caso ocorram problemas em dias posteriores à atualização, contate nosso suporte

[email protected] (11) 3170-5353, para ser orientado com as instruções corretas.

a) Renomear a pasta \SiTef\Config\ para \Config_Erro_ValeCard

b) Renomear a pasta \SiTef\Aplic.win para \Aplic.win_ Erro_ValeCard

c) Voltar as pastas que foram feitas backup no item 4.3 Backup ► \SiTef\CONFIG e

\SiTef\APLIC.WIN para o mesmo diretório \SiTef\


https://www.softwareexpress.com.br/distri/aplicativos/valecard.zip




5. Componentes do Módulo

Nome Descrição Versão Mínima

CfSiTef.exe Configurador do SiTef 2.0.0.9

DrvCom.exe Driver de Comunicação 5.0.1.10

Gerpdv.exe Gerenciador de PDV’s 5.0.0.16

sitValeCard.exe Módulo ValeCard 5.0.0.5

SiTefRel.exe Relatório do SiTef 2.0.13.25

SiTefService.exe Aplicativo do SiTef 5.0.1.57

Carga_Tabelas.exe Aplicativo Carga de Tabelas 2.0.0.6

VisualizadorTabelas.exe Visualizador de Carga de Tabelas 1.1.2.6




6. Configuração do Módulo ValeCard no SiTef

Acessar o menu Iniciar ► Programas ► ►

Em seguida selecione a guia ValeCard, serão apresentadas as opções abaixo:

Na guia Estabelecimento, configurar:

Empresa: Selecione a empresa desejada no qual deseja configurar.

Caso SiTef esteja configurado como monoempresa a empresa utilizada é a 00000000, não permitindo

selecionar outra empresa.

Código de Estabelecimento: Informar o código de estabelecimento fornecido pela administradora

ValeCard, tamanho de 15 dígitos.

Depois de configurado, pressione o botão , em seguida .




Na guia Comunicação, configurar:

Selecionar a Interface Host utilizada:

Observação: A configuração de comunicação é padrão do Sitef. O sistema foi homologado utilizando X25.

Para a utilização em produção de outro protocolo, será necessário validar a comunicação.

Todos os testes foram executados via conexão X25 dedicada.

Se Interface Host – Roteador Cyclades ou Aligera ou Cisco RBP

Endereço IP Primário: Informar o endereço IP do roteador

Porta TCP: Informar a porta “socket” onde foi configurado o X25 da ValeCard no roteador.

Caso tenha dois roteadores sendo um primário e o outro secundário efetuar a mesma configuração com os

dados do roteador secundário.





Se Interface Host – Eicon ou NetOpen

Endereço Local: Informar o número da sua X25

Endereço Remoto: Informar o número da X25 da ValeCard (fornecido pela administradora)

User Data: Informar o User Data da ValeCard (fornecido pela administradora)

Obs: Se o lojista possui um link X.25 de uma determinada operadora de telefonia que não seja a mesma

operadora na qual deseja se conectar, deve-se observar o prefixo da operadora da “nuvem destino”.

Exemplos:

Um lojista possui um link Telemar (OI) e as redes adquirentes lhe passaram um endereço RenPac

(Embratel), logo a “nuvem destino” será Embratel e, portanto, o prefixo a ser inserido antes do número

X.25 (DTE Address) será “0724” (0724+<DTE Address>).

Um lojista possui um link RenPac (Embratel) e as redes adquirentes lhe passaram um endereço

SPPac (Telefônica), logo a “nuvem destino” será a da Telefônica e, portanto, o prefixo a ser inserido

antes do número X.25 (DTE Address) será “0725” (0725+<DTE Address>).

Já para “nuvem destino” Telemar (OI) o prefixo a ser inserido antes do numero X.25 será “07243”

(07243+<DTE Address>).

Envia Endereço Local: Não precisa selecionar (à menos que este parâmetro não seja de envio default

pela Operadora do Link X25).




Canal da Placa: (PLACA MODEM)

Canal 0: Selecionar a opção Canal 0 se a placa estiver no PORT0

Canal 1: Selecionar a opção Canal 1 se a placa estiver no PORT1


Se Interface Host – TCPIP/Direto

Endereço IP Primário: Informar o endereço IP de destino

Porta TCP: Informar a porta TCP de destino

Formato do Tamanho:

► Se a comunicação for através do Gateway, selecionar a opção Binário (Low High).

► Se a comunicação for direta com a ValeCard, verificar com o autorizador ValeCard o formato do

tamanho da mensagem.

Configuração Geral- Habilita Sitef-Gw: Selecionar esta opção se o seu ambiente utiliza o Gateway de

comunicação SiTef-GW utilizando VPN com as provedoras homologadas.

Caso tenha duas conexões IP, sendo uma primária e a outra secundária, efetuar a mesma configuração

com os dados da conexão secundária.





Ao retornar para a tela do configurador, selecionar a opção Arquivo – Sair.

Configuração ValeCard realizada com sucesso!

7. Carga de Tabelas

Na primeira inicialização que o SiTef faz com a ValeCard enviará uma solicitação de carga.

Se houver necessidade de realizar uma nova carga de tabelas forçada, utilize o aplicativo Carga de

Tabelas conforme abaixo:

Acesse o menu, Iniciar ► Programas ► ►

selecionando a loja/estabelecimento cadastrado no Sitef, observe:

Selecionar a opção ValeCard► Carga, clicar na empresa SiTef que deseja efetuar a carga de tabelas e

clicar no Botão ‘Enviar’.




8. Visualizando Tabelas

Acesse o menu Iniciar ► Programas ► ►

Este aplicativo permite apenas visualizar os dados que desceram na tabela da ValeCard. Qualquer

alteração deve ser solicitada para a ValeCard, e após realizar uma carga de tabelas.




9. Configuração do Configurador Combustível

Acessar o menu Iniciar ► Programas ► ►

Em seguida selecione a guia Combustível, serão apresentadas as opções abaixo:

Na guia Cadastro de Produto, configurar:

Código do Produto: Informe o código do produto

Descrição: Informe a descrição do produto.

Empresa: Selecione qual empresa deseja configurar.

Se a configuração for igual para todas, seleciona no campo empresa = Todas. Caso contrário à

configuração deverá ser feita por empresa.

Selecione o botão Incluir .

Executar este procedimento para todos os Produtos.



Suporte

Realce

Suporte

Nota

A configuração que o Suporte Adaptive realizará para a Administradora ValeCard refere-se somente ao item 9 (páginas de 12 a 14).



Na guia ID da Rede, configurar:

No processo de instalação do modulo ValeCard, os códigos de produtos e serviços já são inseridos no

configurador, onde ao acessar o configurador combustível, é possível visualizar o código e a descrição do

produto ou serviço.

Se necessário inserir um novo código disponibilizado pelo autorizador ValeCard, basta seguir os passos

abaixo:

Código do Produto ValeCard: Informar o código de um novo produto ou serviço da ValeCard.

Descrição do produto ValeCard: Informe a descrição do produto.

Rede: Selecione a administradora de cartão ValeCard.






Na guia Combustível, configurar:

Rede: Selecione a rede ValeCard

Produtos Cadastrados: Selecione os produtos que foram cadastrados na guia Cadastro de Produtos

Produtos ValeCard: Relacione o produto cadastrado com o produto da ValeCard.

Empresa: Selecione qual empresa deseja configurar.


Executar este procedimento para todos os Produtos.


Configuração Combustível ValeCard realizada com sucesso!




10. Relatórios

Para listar as transações utilizar o Relatório SiTef, através do menu Iniciar ► Programas ►

►

Tipo de Log: log_mmdd.dat

Versão Mínima: 1.0.11.49

11. Transações Permitidas junto a Administradora ValeCard

Transações

Compra crédito a vista magnética e digitada

Compra crédito parcelada sem/com juros magnética e digitada

Cancelamento da compra crédito magnética e digitada

Compra débito a vista e parcelado

Cancelamento débito

Compra combustível magnética e digitada

Cancelamento da compra combustível magnética e digitada

Consulta de Saldo Combustível Débito e Crédito




12. Configuração do Ponto de venda (PDV)

12.1 Interface CliSiTef

12.1.1 Compra Crédito

Não há configurações adicionais.

Essa transação está disponível no menu de pagamentos (função 0).

Selecionar a opção Cartão de Crédito e seguir com o fluxo de venda.

12.1.2 Compra Débito



Selecionar a opção Cartão de Débito e seguir com o fluxo de venda.

12.1.3 Compra Combustível

Incluir no arquivo Clisitef.ini os parâmetros abaixo:

[Geral]

TransacoesAdicionaisHabilitadas=3020

[CartaoCombustivel]

ColetaDadosProdutoSeparadamente=1


Selecionar a opção Cartão Combustível e seguir com o fluxo de venda.




Para maiores informações sobre essa transação, é necessária a leitura do documento;

”Cartao Combustivel - Clisitef 1.5.doc”

12.1.4 Consulta de Saldo Combustível


Essa transação está disponível no menu de funções administrativas (função 110).

Selecionar a opção Consulta Saldo Combustível e seguir com o fluxo da consulta.

12.1.5 Cancelamento

Incluir no arquivo Clisitef.ini os parâmetros abaixo:

[Geral]

TransacoesAdicionaisHabilitadas=3289

Para cancelamento de transação de combustível, utilizar o tipo de cancelamento Cartão de

Cartão Combustível.

Essa transação está disponível no menu de transações administrativas (função 110).

Selecionar a opção Cancelamento de Transação

Em seguida selecionar o tipo de cancelamento desejado.




12.2 Interface Client Modular

12.2.1 Compra Crédito


Essa transação está disponível no menu de Pagamentos (função CRT).

Selecionar a opção .

12.2.2 Compra Débito



Selecionar a opção .

12.2.3 Compra Combustível

Incluir no arquivo ClienteTrn.ini os parâmetros abaixo:

[BOTOES_HABILITADOS]

btCombustivel=1

Além desse parâmetro, é necessário que a aplicação envie no arquivo Intpos.001 o campo

507-001=1.


12.2.4 Consulta de Saldo Combustível

Incluir no arquivo ClienteTrn.ini os parâmetros abaixo:

[BOTOES_HABILITADOS]

btCombustivel=1

Além desse parâmetro, é necessário que a aplicação envie no arquivo Intpos.001 o campo

507-001=1.


Para maiores informações sobre essa transação, é necessária a leitura do documento;

”Especificacao do ClientSitef ValeCard.pdf”




12.2.5 Cancelamento


Para cancelamento de transação de combustível, utilizar o tipo de cancelamento Cartão de

Crédito.

Essa transação está disponível no menu de transações administrativas (função ADM).

Clicar no botão

Selecionar a opção ou

13. Tabela de códigos de retorno da Administradora.

Tabela não disponível. Favor entrar em contato com a Administradora.

14. Histórico de Versões

Versão Alteração

3.00E04 Inclusão da transação de carga de tabelas

3.01E09 Implementação de ticket reduzido, cartão combustível crédito/débito

3.01E09e Melhorias na transação de carga de tabelas

3.02E04 Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de

carga de tabelas.

3.02E05 Ajuste na troca de mensagem entre o PDV e SiTef, para melhor desempenho das

transações.

3.0.2.6 Melhorias nas transações de Combustível

3.0.2.7 Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de

carga de tabelas.

3.0.2.8 Ajuste na troca de mensagem entre o PDV e SiTef, para melhor desempenho das

transações.





combustível.

3.0.2.10 Melhorias no modulo

3.0.2.11 Permite mostrar o saldo quando selecionado Ticket Reduzido


desfazimento.

3.0.3.0 Ajuste na troca de mensagem entre o PDV e SiTef, para melhor desempenho das

transações.

3.0.3.1 Ajuste na troca de mensagem com o Autorizador ValeCard para melhor desempenho nas

transações.

5.0.0.2 Inclusão das transações EMV

5.0.0.3 Atualizações para gerar a versão simulada

5.0.0.4 Melhoria no tratamento de ranges para permitir um mesmo bin pertencer a ranges de

produtos diferentes.

5.0.0.5 Melhorias no envio de bins quando não há configuração multibandeira.


Roteiro de Instalação e...

Documents

Transcript of Roteiro de Instalação e...