roteiro de instalação e configuração módulo getnet lac · para a correta utilização o...

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

Página 1 de 21 Versão 1.12 Data: 22/08/2013

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



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.



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

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

http://www.softwareexpress.com.br/ArqCli/aplicativos/getnetlac.zip



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.

Senha: Informar a senha do usuário com permissão de administrador.

mailto:[email protected]



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



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.



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


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



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:



:



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



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.



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

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



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

► 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


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ê


Essa transação está disponível no menu Débito para Pagamento de Carnê (função 16).



► Transações Voucher


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


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)


► Transações Voucher

Não há parâmetros adicionais para serem configurados.



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

78 Declinada Conta especificada inválida.



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.

roteiro de instalação e configuração módulo getnet lac · para a correta utilização o...

Documents