Roteiro de Instalação e Configuração Módulo GETNET LAC Conteúdo 1. INTRODUÇÃO... 2 2. DESCRIÇÃO DO NEGÓCIO... 2 3. PRÉ REQUISITOS... 3 4. COMPONENTES DO MÓDULO... 4 5. INSTALAÇÃO DO MÓDULO... 4 5.1 BACKUP...4 5.2 INSTALAÇÃO...4 5.3 ROLLBACK RETORNO DA VERSÃO QUANDO PROBLEMAS...5 6. CONFIGURAÇÃO DO MÓDULO GETNET LAC NO SITEF... 5 7. CONFIGURAÇÃO MULTIBANDEIRA... 10 8. CARGA DE TABELAS... 12 9. VISUALIZADOR DE TABELAS... 14 10. TRANSAÇÕES PERMITIDAS JUNTO A ADMINISTRADORA GETNET LAC... 15 11. CONFIGURAÇÃO DO PONTO DE VENDA (PDV)... 17 14.1 INTERFACE CLISITEF...17 14.2 INTERFACE CLIENT MODULAR...18 12. RELATÓRIOS... 19 13. TABELA DE ERROS... 19 Página 1 de 21 Versão 1.12 Data: 22/08/2013
1. Introdução Este documento destina-se ao usuário que pretende instalar e configurar o módulo GetNetLac no SiTef no qual tem como principal foco o roteamento MultiBandeira. 2. Descrição do Negócio A Getnet entrou no mercado como uma nova Adquirente autorizando multibandeiras. Este módulo foi desenvolvido para ser utilizado exclusivamente no mercado Latino Americano, por isso o nome GetNet LAC. Porém, a demanda do processo de multibandeira alterou o foco deste projeto e hoje, existe a necessidade do mesmo ser utilizado no mercado nacional. Para a correta utilização o cliente deverá instalar e configurar o processo de multibandeira. Somente neste ambiente e com a atualização da interface cliente (CliSiTef e/ou Cliente Modular) o módulo terá seu correto funcionamento. Este módulo, segundo informações da GetNet, iniciou com o processamento inicial dos cartões da bandeira Mastercard e posteriormente (já liberado) Visa. Isto significa que se um cliente já possui o módulo GetNet, o mesmo deve continuar ativo para o tratamento dos cartões já processados hoje pelo módulo GetNet. Lembre-se, GetNet e GetNet LAC são módulos diferentes, com processamento de cartões diferentes e que convivem em um mesmo Sitef. Sua finalidade GetNet Lac é ter uma única aplicação para capturar vendas Mastercard, Visa e com o crescimento outras bandeiras tais como Sodexho, com controle remoto de fácil configuração e alteração, adequando rapidamente cada meio de captura à regra de negócio proposto em contrato comercial. Destina-se a todos os clientes no qual comercialmente contratou com a GetNet a captura das bandeiras. Página 2 de 21 Versão 1.12 Data: 21/08/2013
3. Pré Requisitos 3.1 PinPad Versão 1.06 ou superior com a MasterKey da GetNet no slot 4 (caso não tenha solicitar a GetNet a atualização) Para uso do PRIVATE LABEL, é OBRIGATÓRIO o uso de PinPad com versão 1.07 (Ingênico) ou com versão 1.06 (Verifone ou Gertec). Caso esteja com a versão 1.05 do pinpad, será apresentada mensagem de AID INVÁLIDO por conta de versão (1.05 ou inferior). 3.2 Interface PDV (Client Modular ou CliSiTef) Interface PDV (Client Modular ou CliSiTef) com as versões mínimas: Client Sitef Modular versão igual ou superior a 4.0.2.15 CliSiTef versão igual ou superior a 4.0.104.11 SiTef versão igual ou superior a 3.0.19.5 3.3 Módulo da GetNet Lac Multibandeira-débito e crédito versão igual ou superior a 3.01E04 Private Label versão igual ou superior a 3.01E09 Pagamento de Carnê versão igual ou superior a 3.01E15 Voucher versão igual ou superior a 3.01E34 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 Página 3 de 21 Versão 1.12 Data: 21/08/2013
4. Componentes do Módulo APLICATIVO DESCRIÇÃO VERSÃO Carga_Tabelas.exe Carga de Tabelas 1.0.5.1 Cf_SiTef Configurador Geral do SiTef 1.0.5.5 SeGetnetLac.bpl Biblioteca de configuração 1.0.0.0 Drvcom.exe Driver de Comunicação 4.0.0.30 Gerpdv.exe Gerenciador de PDV 4.0.0.32 SiTefRel.exe Relatório do SiTef 0.0.11.39 sitgetnetlac.exe Módulo do SiTef 3.0.1.39 Sitef.exe Módulo do SiTef 3.0.19.12 VisualizadorTabelas.exe Visualizador de Tabelas 1.1.2.3 5. Instalação do Módulo 5.1 Backup a) Efetuar uma cópia de backup das pastas \SiTef\CONFIG e \SiTef\APLIC.WIN 5.2 Instalação a) Efetuar o download da versão GetNet Lac, conforme link abaixo: http://www.softwareexpress.com.br/arqcli/aplicativos/getnetlac.zip b) Descompactar o arquivo getnetlac.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 configuração conforme item Configuração do Módulo GetNet Lac e Configurador MultiBandeira. f) Em seguida ativar o serviço do SiTef - Solução Inteligente através dos serviços do Windows. Página 4 de 21 Versão 1.12 Data: 21/08/2013
5.3 RollBack Retorno da versão quando problemas ** Recomendado quando realizado atualização no mesmo dia ** Caso ocorram problemas em dias posteriores a 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_getnet Lac b) Renomear a pasta \\sitef\aplic.win para \aplic.win_getnet Lac c) Voltar as pastas backupeadas no item 8.1 Backup -> a) \SiTef\CONFIG e \SiTef\APLIC.WIN para o mesmo diretório \sitef\ 6. Configuração do Módulo GetNet Lac no SiTef Acessar Iniciar Programas O instalador valida a informação *Ultima versão* no regedit.exe (Editor de registro do Windows) Software Software Express Informática Ltda SiTef, qual a ultima versão instalada, onde: Se versão 3.0.x.x será instalado o arquivo \sitef\aplic.win\cfsitef.exe sem controle de acesso usuário Windows. Ex: Configurador Geral do SiTef sem controle de usuário do Windows: Usuário: Informar o código de acesso que deve ser o mesmo usado no acesso à máquina com permissão de administrador. Senha: Informar a senha do usuário com permissão de administrador. Página 5 de 21 Versão 1.12 Data: 21/08/2013
Se versão 4.0.x.x, será instalado o arquivo \sitef\aplic.win\cfsitef.exe com controle de acesso usuário do Windows, onde precisa dos usuário cadastrados no grupo SiTef-Adm e SiTef-Rel do Windows. Em seguida selecione a Guia GetNet Lac, serão apresentadas as opções abaixo: Na guia GetNet Lac Estabelecimento, configurar: Código do Estabelecimento: Informar o código de estabelecimento fornecido pela administradora GetNet Lac com tamanho de 15digitos (alinhado a esquerda). Terminal Lógico: Informar o código de terminal lógico fornecido pela administradora GetNet Lac. Página 6 de 21 Versão 1.12 Data: 21/08/2013
Na guia GetNet Lac Comunicação, configurar: Selecionar a Interface Host utilizada: 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 GetNet Lac no roteador Caso possua dois roteadores sendo um primário e o outro secundário efetuar a mesma configuração com os dados do roteador secundário. Após, selecionar o botão Salvar em seguida Retornar. Página 7 de 21 Versão 1.12 Data: 21/08/2013
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 GetNet Lac (fornecido pela administradora) User Data: Informar o User Data da GetNet Lac Obs: Se a linha da administradora for Renpac (Embratel) e a do estabelecimento for diferente, digitar o prefixo (0724) na frente do numero X25 da Administradora: 0724+X25 A configuração abaixo é somente para quem for utilizar a Placa Net Open: Envia Endereço Local: Não precisa selecionar Canal da Placa: Canal 0: Selecionar a opção Canal 0 se a placa estiver na COM1 Canal 1: Selecionar a opção Canal 1 se a placa estiver na COM2 Após, selecionar o botão Salvar em seguida Retornar. Página 8 de 21 Versão 1.12 Data: 21/08/2013
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 GetNet Lac, selecionar a opção Binário (High Low). 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 concessionarias homologadas. Caso possua 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. Gateway: Segue configuração necessária: PreAmbuloIf=0 PreAmbulo=26 CodigoTef=181 Após, selecionar o botão Salvar em seguida Retornar. Ao retornar para a tela do configurador, selecionar a opção Arquivo Sair. Página 9 de 21 Versão 1.12 Data: 21/08/2013
7. Configuração MultiBandeira Acessar o menu Iniciar Programas Selecionar a empresa para a qual deseja transacionar as bandeiras liberadas para o autorizador GetNet. Se a configuração for à mesma para todas as empresas, selecionar a opção TODAS. ATENÇÃO Até o momento as bandeiras: Visa Credito, Visa Electron, Maestro, Mastercard, Sodexho, PL Visa e PL Master são aceitas pela Getnet, somente elas devem ser configuradas para o autorizado GetNetLac conforme acordado com a adquirente Getnet. Os demais produtos disponibilizados não devem ser configurados para o Autorizador GetnetLac. Exemplo abaixo: Página 10 de 21 Versão 1.12 Data: 21/08/2013
: Página 11 de 21 Versão 1.12 Data: 21/08/2013
Após configuração, roteando as bandeiras para o autorizador Getnelac, pressione o botão Salvar Configuração, onde apresesentará a tela abaixo: Pressione a opção Sim para que a configuração seja salva. AVISO IMPORTANTE Sempre que uma configuração de multibandeira for alterada, será necessário o stop/start do Sitef. Recomendamos que preferencialmente, as alterações de roteamento sejam feitas em horários de pouco impacto no movimento, pois teremos carga de tabelas em todos os pinpads. Atualização de tabelas Configuração GetNet realizada com sucesso! 8. Carga de Tabelas Após realizar a configuração do SiTef, e reiniciar o serviço, é necessário efetuar uma carga de tabelas. ATENÇÃO: É proibido copiar os arquivos GetNet Lac.ini e tab_0181.emv nos diretórios. É necessário fazer a carga de tabelas, através do aplicativo abaixo. Acessar o menu Iniciar Programas Página 12 de 21 Versão 1.12 Data: 21/08/2013
Selecionar GetNetLac Carga, será exibida a tela abaixo: Selecionar a empresa desejada no combo Empresa, e em seguida clicar em. No campo Dados da Carga, deve exibir a mensagem Transacao OK. Clicar em, e em seguida Arquivo Sair. Página 13 de 21 Versão 1.12 Data: 21/08/2013
9. Visualizador de Tabelas Para visualizar os bins e configurações que desceram na carga de tabelas através da GetNetLac, acessar o menu Iniciar Programas Será exibida a tela abaixo: Dar um duplo click nas opções do GetNet Lac, e ao lado serão apresentadas as informações que desceram na tabela da GetNet. A Administradora (autorizador) GetNet Lac envia tabelas de ranges, emissores, AID, chaves publicas e transações habilitadas para cada cliente, configurada de acordo com o perfil de cada cliente, portanto caso deseja alterar alguma informação obtida na tabela, a mesma deverá ser solicitada junto ao autorizador GetNet Lac e efetuar uma nova carga de tabela. Página 14 de 21 Versão 1.12 Data: 21/08/2013
10. Transações Permitidas junto a Administradora GETNET LAC 10.1 Transações de Débito TRANSAÇÃO Débito a Vista Débito Pré-Datado Débito CDC Débito Parcelado sem Juros Débito a Vista com Cash Back Débito Voucher Consulta Parcelas Débito Consulta Saldo Débito Saque Débito a Vista Saque Débito Parcelado Cancelamento Débito Pagamento Carnê 10.2 Transações de Crédito TRANSAÇÃO Crédito a vista Crédito parcelado com juros Crédito parcelado sem juros Crédito a Vista com Cash Back Consulta Saldo Crédito Página 15 de 21 Versão 1.12 Data: 21/08/2013
Consulta Parcelas Crédito Saque Crédito a Vista Saque Crédito Parcelado Pré-autorização Captura pré-autorização a Vista Captura pré-autorização Parcelado sem Juros Captura pré-autorização Parcelado com Juros Cancelamento pré-autorização Cancelamento captura pré-autorização Cancelamento de credito magnético Cancelamento de credito digitado 10.3 Transações de Private Label TRANSAÇÃO Crédito Private Label a Vista Crédito Private Label Parcelado com Juros Crédito Private Label Parcelado sem Juros Cancelamento de Crédito Private Label Magnético Cancelamento de Crédito Private Label Digitado Página 16 de 21 Versão 1.12 Data: 21/08/2013
11. Configuração do Ponto de venda (PDV) 14.1 Interface Clisitef Débito e Crédito Não há configurações adicionais. Essa transação está disponível no menu de pagamentos (função 0). Depois de selecionado a opção desejada, seguir com o fluxo de venda. Transações Private Label Não há configurações adicionais. Essa transação está disponível no menu de pagamentos (função 0), através da opção Cartão Private Label Para que seja possível realizar a transação com cartão Private Label GetNet Lac é necessário que seja utilizado um pinpad com versão igual ou superior a 1.07 (Ingênico) ou 1.06 (Verifone ou Gertec). Transações Pagamento de Carnê Não há configurações adicionais. Essa transação está disponível no menu Débito para Pagamento de Carnê (função 16). Página 17 de 21 Versão 1.12 Data: 21/08/2013
Transações Voucher Não há configurações adicionais. Essa transação está disponível no menu de pagamentos (função 0 ), através da opção Cartão Débito. 14.2 Interface Client Modular Débito e Crédito Não há parâmetros adicionais para serem configurados. Essa transação está disponível no menu de Pagamentos (função CRT). Selecionar a opção seguindo o fluxo. ou Transações Private Label Incluir no arquivo \Client\ClienteTrn.ini os parâmetros abaixo: [BOTOES_HABILITADOS] btprivatelabel=1 Essa transação está disponível no menu de Pagamentos (função CRT). Selecionar a opção seguindo o fluxo. Para que seja possível realizar a transação com cartão private label GetNet é necessário que seja utilizado um pinpad com versão igual ou superior a 1.07 (Ingenico) ou 1.06 (Verifone ou Gertec). Página 18 de 21 Versão 1.12 Data: 21/08/2013
Transações Pagamento de Carnê Para realizar as transações de pagamento de carnê, é necessário que a aplicação inclua o campo 701-034 = 58 no arquivo Intpos.001 de requisição. (maiores informações estão no documento Especificacao do ClientSitef.pdf) Selecionar a opção seguindo o fluxo. Transações Voucher Não há parâmetros adicionais para serem configurados. Essa transação está disponível no menu de Pagamentos (função CRT). Selecionar a opção seguindo o fluxo. 12. Relatórios Para listar as transações utilizar o Relatório do SiTef, através do menu Iniciar Programas No campo Autorizador será apresentado o nome da rede pela qual a transação foi roteada. Tipo de Log: log_mmdd.dat e EXT_mmdd.181 Versão Mínima: 0.0.11.2 13. Tabela de Erros Código Resposta Descrição 00 Aprovada Aprovado ou Completado com Sucesso 01 Referida Referida para o emissor do cartão, pode retornar uma transação de venda solicitando algumas perguntas, como apenas uma mensagem a ser exibida no meio de captura Ligar para o Emissor do cartão 03 Declinada Estabelecimento Inválido 05 Declinada Do not honor 06 Declinada Erro no processamento 12 Declinada Transação Inválida 13 Declinada Valor inválido Requisições com valor zerado ou não atingiu um limite definido pelo emissor Página 19 de 21 Versão 1.12 Data: 21/08/2013
14 Declinada PAN Inválido 15 Declinada Emissor (Operadora) Inválido 30 Declinada Formato de mensagem com erro 31 Declinada Instituição não pertence à rede 38 Declinada Excedido número de tentativas do PIN 41 Declinada Cartão Perdido ou Extraviado 43 Declinada Cartão Roubado 51 Declinada Saldo Insulficiente 52 Declinada Erro nos dados da trilha do cartão 53 Declinada Este serviço não está autorizado 54 Declinada Cartão expirado 55 Declinada PIN Inválido ou Senha Incorreta 56 Declinada Refazer a transação pois os dados foram informados com erro 57 Declinada Transação não permitida para o Emissor ou portador do cartão Resposta do emissor para transações chip indicando um erro criptográfico do chip 58 Declinada Transação não permitida para o Adquirente ou Terminal 59 Declinada Autorização Inexistente 60 Declinada Entrar em contato com a Instituição Financeira 61 Declinada Excedeu o limite de retirada 62 Declinada Cartão Restrito ou Restringido 63 Declinada Erro na decriptação do PIN block 64 Declinada Documento já estornado, verifique 65 Declinada Excedeu o limite de retirada da conta 66 Declinada Valor informado acima do limite 67 Declinada Senha não cadastrada, Ligar para o Emissor (Operadora) 68 Declinada Senha errada, novo erro bloqueia. 69 Declinada Cartão não pertence a Rede 70 Declinada Transação inválida, contate o emissor do cartão 71 Declinada PIN não trocado 75 Declinada Excedeu o limite de entradas de PIN permitidas 76 Declinada Inválida para a conta especificada ou Cartão bloqueado 77 Declinada Inválida da conta especificada. Em caso de sonda aparece a mensagem pendente de confirmação quando a transação pendente não foi tratada manualmente no TEF 78 Declinada Conta especificada inválida. Página 20 de 21 Versão 1.12 Data: 21/08/2013
No caso da sonda, Indica Transação Cancelada quando o EC cancela a 83 Declinada Time-Out do Emissor 80 Declinada System not available. Ou Transação não Existe 84 Declinada Log-on não realizado (Terminal permanece fechado) 85 NA Not declined. Valido apenas para AVS ou requisição de certificado e-commerce 86 Declinada Transação desfeita. 87 Aprovada Valor para compra apenas, não esperado cash back 89 Declinada PIN não aceitável 91 Declinada Timeout Solicitação de Autorização enviada para o MIP mas o MIP não respondeu ou respondeu com atraso, pelos principais motivos: Processo do Emissor Inoperante O Issuer não tem um status para a conexão lógica com o MIP. Format Error O processo do Emissor retornou dados inválidos na mensagem de resposta da autorização 92 Declinada Transação não aprovada. 94 Declinada Transação duplicada detectada 96 Declinada Erro de Sistema 99 Declinada Autorização negada pelo SmartCard off-line, durante o First Generate AC. Deve popular a mensagem 0220 de advice de transação negada pelo chip. Página 21 de 21 Versão 1.12 Data: 21/08/2013