Roteiro de Instalação e Configuração Módulo ValeCard Página 1 de 20 Versão 1.8 Data: 08/07/2016
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 Página 2 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 suporte@softwareexpress.com.br SiTefWeb e Exportadores, solicitar versões com suporte.sitefweb@softwareexpress.com.br Página 3 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 suporte@softwareexpress.com.br (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\ Página 4 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 Página 5 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. Página 6 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. Página 7 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). Página 8 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. Página 9 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. Página 10 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. Página 11 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. Página 12 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. Página 13 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! Página 14 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 Página 15 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. Página 16 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. Página 17 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 Página 18 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 3.02E04 3.02E05 Melhorias na transação de carga de tabelas Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de carga de tabelas. 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 3.0.2.8 Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de carga de tabelas. Ajuste na troca de mensagem entre o PDV e SiTef, para melhor desempenho das transações. Página 19 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 3.0.3.0 3.0.3.1 Melhorias na troca de mensagem com o Autorizador ValeCard, referente a transação de desfazimento. Ajuste na troca de mensagem entre o PDV e SiTef, para melhor desempenho das transações. 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. Página 20 de 20 Versão 1.8 Data: 08/07/16