Roteiro de Instalação e Configuração Módulo GETNET LAC

Roteiro de Instalação e Configuração

Módulo GETNET LAC

Conteúdo

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

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.

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

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.

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

[email protected] (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.

► 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).

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.

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

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.

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.

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.

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”.

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.

10. Transações Permitidas junto a Administradora GETNET LAC

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

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

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

14.1 Interface Clisitef

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.

► 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 ou

seguindo o fluxo.

► 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).

► 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

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

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.