Roteiro de Instalação e Configuração Módulo GETNET LAC · Para a correta utilização o...
Transcript of 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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 2 de 21 Versão 1.12 Data: 21/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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 3 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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 4 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 5 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
[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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 6 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 7 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 8 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 9 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 10 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:
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 11 de 21 Versão 1.12 Data: 21/08/2013
:
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 12 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 ► ►
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 13 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 14 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 15 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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 16 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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 17 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).
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 18 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 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).
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 19 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
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 20 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.
Email: [email protected] Tel: (11) 3170-5353 Site: www.softwareexpress.com.br
Página 21 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.