Upload
haquynh
View
248
Download
0
Embed Size (px)
Citation preview
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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 2 de 20 Versão 1.8 Data: 08/07/16
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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 3 de 20 Versão 1.8 Data: 08/07/16
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]
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 4 de 20 Versão 1.8 Data: 08/07/16
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\
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 5 de 20 Versão 1.8 Data: 08/07/16
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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 6 de 20 Versão 1.8 Data: 08/07/16
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 .
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 7 de 20 Versão 1.8 Data: 08/07/16
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.
Depois de configurado, pressione o botão , em seguida .
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 8 de 20 Versão 1.8 Data: 08/07/16
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).
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 9 de 20 Versão 1.8 Data: 08/07/16
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
Depois de configurado, pressione o botão , em seguida .
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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 10 de 20 Versão 1.8 Data: 08/07/16
Depois de configurado, pressione o botão , em seguida .
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’.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 11 de 20 Versão 1.8 Data: 08/07/16
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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 12 de 20 Versão 1.8 Data: 08/07/16
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.
Depois de configurado, pressione o botão , em seguida .
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 13 de 20 Versão 1.8 Data: 08/07/16
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.
Selecione o botão Incluir .
Depois de configurado, pressione o botão , em seguida .
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 14 de 20 Versão 1.8 Data: 08/07/16
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.
Selecione o botão Incluir .
Executar este procedimento para todos os Produtos.
Depois de configurado, pressione o botão , em seguida .
Configuração Combustível ValeCard realizada com sucesso!
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 15 de 20 Versão 1.8 Data: 08/07/16
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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 16 de 20 Versão 1.8 Data: 08/07/16
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
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 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
Essa transação está disponível no menu de pagamentos (função 0).
Selecionar a opção Cartão Combustível e seguir com o fluxo de venda.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 17 de 20 Versão 1.8 Data: 08/07/16
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
Não há configurações adicionais.
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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 18 de 20 Versão 1.8 Data: 08/07/16
12.2 Interface Client Modular
12.2.1 Compra Crédito
Não há configurações adicionais.
Essa transação está disponível no menu de Pagamentos (função CRT).
Selecionar a opção .
12.2.2 Compra Débito
Não há configurações adicionais.
Essa transação está disponível no menu de Pagamentos (função CRT).
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.
Essa transação está disponível no menu de Pagamentos (função CRT).
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.
Essa transação está disponível no menu de Pagamentos (função CRT).
Para maiores informações sobre essa transação, é necessária a leitura do documento;
”Especificacao do ClientSitef ValeCard.pdf”
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 19 de 20 Versão 1.8 Data: 08/07/16
12.2.5 Cancelamento
Não há configurações adicionais.
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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 20 de 20 Versão 1.8 Data: 08/07/16
3.0.2.9 Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de
combustível.
3.0.2.10 Melhorias no modulo
3.0.2.11 Permite mostrar o saldo quando selecionado Ticket Reduzido
3.0.2.12 Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de
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.