Guia de instalação
POSLBC
Apresentação
Desde sua criação, em 1994, a LBC está alinhada com as tendências do mercado e comprometida com a satisfação de seus clientes. É por isso que hoje ocupamos lugar de destaque no mercado de software para Automação de Postos de Combustíveis e Lojas de Conveniência desenvolveu soluções inteligentes para atender plenamente todas as necessidades específicas do segmento.
O mercado está cada vez mais competitivo, os consumidores ficam mais exigentes, as empresas aprimoram serviços e produtos, a concorrência cresce
rapidamente. Para acompanhar esta evolução, você precisa de uma gestão realmente eficaz, que garanta integração, segurança e agilidade em todos os processos
administrativos.
Pensando nisso, foi criado o POSLBC, queagiliza o pagamento e aumenta a segurança. Com ele são evitadas fraudes durante o processo de pagamento. Assim, tudo fica mais seguro, simples e organizado.
Este Guia Prático tem como objetivo auxiliar a implantação e configuração para o correto funcionamento do POSLBC.
Importante
Antes que uma equipe se dirija ao posto para implantar o POSLBC, faz-se necessário verificar se o ambiente de TI atende aos pré-requisitos estabelecidos.
Padrões
É necessário usar Wi-Fi;
SSID será POSLBC_000X, onde os quatro últimos dígitos são o número da empresa;
Senha de 8 a 12 caracteres; Criptografia Wi-fi WPA2 PSK AES;
Portas 3050(Firebird), 4096(Sitef), 7077(SqlServer) e 8088(Xampp) deverão estar liberadas;
Caminho do servidor do Xampp deverá ser C:\XAMPP\;
Topologia
A topologia para o funcionamento da solução POSLBC é apresentada na Figura 1, na qual são apresentados todos os dispositivos utilizados.
Para que este conjunto funcione como desejado faz-se necessário configurar os diversos recursos envolvidos, são eles:
* Conforme as condições do ambiente de TI do posto a máquina utilizada poderá ser a mesma para todos os servidores.
Instalação
Para implantação da topologia e utilização do POSLBC serão necessários que alguns softwares estejam instalados, são eles:
Firebird 2.5
Após instalar o Firebird 2.5 validar se está ativo o Interbase no php da máquina. Ir ao endereço localhost:8088 entrará no site
http://localhost:8088/dashboard/
Clicar no menu PHPinfo e localizar pelo nome interbase que deverá estar conforme a imagem abaixo, caso não esteja, reinstale o firebird 2.5 excluindo todas as pastas existentes.
SiTef Local; AGT; XAMPP; VPN – Gsurf.
SITEF
Esta etapa é fundamental que já tenha em mãos os números lógicos de cada administradora para fazer a configuração de comunicação.
Para prosseguir faça o download do aplicativo no link abaixo.
SITEF - https://www.softwareexpress.com.br/distri/aplicativos/sitef.zip
Ao termino do download do modulo SITEF, localize o arquivo baixado e extraia seuconteúdo dentro de uma pasta temporária. Será criada uma pasta com o nome da versão que foi baixada e dentro dela estarão os arquivos necessários para a instalação.
Será solicitado que você selecione o driver onde pretende instalar o SITEF.
Na primeira tela do assistente de instalação pressione Next. O assistente irá iniciar a instalação logo em seguida, quando finalizada clique no botãoFinish.
Após o término da instalação irá surgir a tela de “Instalação da chave de licenciamento do Sitef V. x.xx”. Forneça as informações conforme solicitado na sequência.
Uma licença temporária de 14 dias será criada, com a qual será permitido fazer toda aconfiguração do SITEF e os devidos testes antes de substituir pela licença
permanente, pois após sua instalação a Software Express já iniciará a cobrança de manutenção para o cliente.
Digite então o CNPJ do cliente e clique no botão Encerra, surgira na tela uma mensagem informando que a licença temporária foi criada, clique em Encerra novamente, depois dê OK na mensagem.
Instalando o AGT
Execute o instalador do modulo AGT (Instala.exe), aparecerá a tela abaixo, selecione o SiTef do cliente que deve estar em uma versão 5.0.12 ou superior e clica em OK.
Configurando o SITEF
Nesta parte faremos a configuração da comunicação do SITEF com a VPN da GSurf, cadastrar os números lógicos, realizar as cargas de tabela para obter as informações dousuário junto as redes de cartões e ao final configurar os terminais (POS-WiFi).
Execute o Configurador GeralSiTef e façaos passo a seguir:
Clique emSitef>Interface SiTef/Host, escolha a opção TCP Direto, marque
Clique em Dados Operacionais, no campo empresa selecione a opção NOVA no campo nova empresa, colocar o número da EMP com (8 digitos) Sempre o número da EMP completando com zero a esquerda. Clique em Salvar.
Clique na aba Captura Parâmetros e informe os dados do Estabelecimento, marque as opções:Captura número de parcelas para compra com Cartão de
Crédito e Captura taxa de Serviço. Clique em Salvar.
OBS:NÃO é necessário preencher os dados do Estabelecimento, esse campo
Clique na administradora de cartão que deseja configurar, em seguida em
Estabelecimento, então escolha a empresa que você cadastrou anteriormente,
informe em terminal lógico o número lógico fornecido pela administradora.
OBS: Não é necessário preencher o campo terminal Lógico, esse campo será
preenchidoautomaticamente após a ativação da chave AGT. Caso for preencher o campo tenha muita atenção.
Clique na opção Comunicação, ainda dentro da administradora escolhida, digite o IP ea porta fornecida pela LBC em Endereço IP primário
(172.30.96.231) e Porta TCP, Marque a opçãoBinário (Low High). Repita
Clique em AGT>Estabelecimento, escolha a Empresa.
Escolha a Rede, digite o Endereço IP e a Porta TCP. Clique em Confirmare Salvar.
Segue lista com Endereço de Portas e IPComunicação SiTef->AGT IP :172.27.220.139 cielo - 8702 getnet - 8802 rede - 8825 elavon - 8827 bin - 8828 global - 8829 stone - 8830 vero – 8831
Configurar identificação das transações de Débito no TEF
Clique sobre o diretório: “C:\SiTef\CONFIG”
Clique sobre o Arquivo: “sitefcfg.ini” e descreva no arquivo as informações exatamente como destacado na imagem abaixo:
Instalação VPN – Gsurf-Net
Baixe o Link para baixar a conexão do Suporte Gsurf na máquina do cliente.
www.ajudar.info
Baixa na área de trabalho.
A instalação Gsurf será realizada pelos Analistas de Suporte da Gsurf,
Solicite ao atendente que seja feita a instalação da VPN para comunicação entre o Software Express e Modulo AGT.
Ligar para Gsurf: (0800) 644-4833.
Execute oSitef – Controle Geral e verifique se está ativada o módulo AGT e a administradora que o Cliente trabalha.
Execute Carga de Tabela.
Clique emAGT> clique em carga> selecione a Administradora,
automaticamente a opção Ativação será marcada > Insira os Dados da Chave (fornecida na planilha Chave de Ativação AGT) > Clique em Ativar.
Clique na Administradora cadastrada > clique em carga> selecione a Empresa> Clique em Enviar.
Server XAMPP
Para realizar a tarefa de disponibilizar os dados do cupom de venda, é utilizado um servidor WEB (XAMPP) o qual fornece os dados solicitados pelo POS.
Para Instalá-lo siga os seguintes passos:
Execute o instalador como administrador (Clicar com o botão direito e escolher
Na tela seguinte deixe marcado apenas os componentes Apaches, o PHP e
phpMyAdmin> Clique em Next.
Desmarque a caixa “Learn more aboutBitnami for XAMPP”> Clique no botão
Next> Next na próxima imagem novamente.
Configurando o XAMPP
Clique no botão Config.
Na tela que aparecerá clique nos seguintes itens para configuração:
*Apache (httpd.conf)
No clique em Apache (httpd.conf) será exibido o conteúdo do arquivo httpd.conf,
busque e altere nele as seguintes linhas:
Busque por “Listen 80” e substitua por “Listen 8088”.
Busque por “ServerName localhost:80” e substitua por “ServerName
localhost:8088”.
No clique em PHP (php.ini) será exibido o conteúdo do arquivo php.ini, faça as seguintes alterações nele:
Busque por “;extension=php_interbase.dll” e retire o “;”. Busque por “;extension=php_sockets.dll” e retire “;”;
Busque por “;date.timezone”, retire o ‘;’ e acrescente após o sinal de igual a palavra“Sao_Paulo” exatamente como solicitado.
Após a configuração > Clique em STARTe aguarde a tela ficar da seguinte forma:
Instalando a aplicação WEB
Para instalar a aplicação Web do POS, descompactem a pasta htdocs
(C:\xampp\htdocs), o pacote (.irar) nomeado (PHPs XAMPP - HTDOCS -
v100.rar), que será disponibilizada também com o Pacote de instalação do modulo POSLBC.
Altere o arquivo config.ini conforme demonstrado a seguir.
Caso o IP do Servidor XAMPP não seja 192.168.1.120, deve ser alterado o IP dentro dos seguintes arquivos que também estarão no diretório
(C:\xampp\htdocs),
A instalação do Sistema tem que estar nomeada a pasta do Sistema como (LBCPDV).
Copie o arquivo (AcessoDadosCartao_DLBC_Sistemas.cha) disponível na pasta instalação SITEF > Coloque na pasta CNFIG do Sitef (C:\SiTef\CONFIG).
Configuração no LBCGAS
Além da instalação e configuração de todos os softwares acima, ainda é necessário realizar algumas configurações no LBCGAS.Para realizar a configuração realize os passos a seguir:
Clique em Utilitários > Configurações > MóduloPDV >POS LBC – Geral.
Definições Gerais
“Endereço IP do servidor APACHE onde a aplicação POSLBC.PHP está instalada”
(Deve ser informado o IP da máquina onde está instalada o APACHE exemplo: 192.168.x.xx:8088)
“Quantidade de abastecimentos que devem ser exibidos no POS para seleção do vendedor:”
(Deve ser inserido de acordo com a solicitação do Cliente)
“Permitir que pagamento em DÉBITO, CRÉDITO e de CORRENTISTAS seja realizado apenas para abastecimentos finalizados há no máximo:”
(Se o abastecimento estiver sido finalizado após o período informado na máquina de cartão não serão apresentas as opções de pagamento acima)
“Informe a forma de pagamento, para cartões de débito, que deverá ser registrada quando nenhuma outra forma compatível com a transação realizada não for encontrada:”
“Informe a forma de pagamento, para cartões de crédito, que deverá ser registrada quando nenhuma outra forma compatível com a transação realizada não for encontrada:”
(Essas formas de pagamento devem estar cadastradas no sistema e com o seu devido Tipo informadas, a mesma também não poderá ter as informações de LBC POS – identificação da forma de pagamento)
“Não permitir que, formas de pagamento exportadas para o PDV com definições de REDE AUTORIZADA e BANDEIRA para POS LBC, sejam utilizadas para lançamento manuais de venda”
(Deve ser inserido de acordo com a solicitação do Cliente)
“Desabilitar a funcionalidade de o recebimento em DINHEIRO no POS” “Desabilitar a funcionalidade de recebimento AVULSO no POS”
(Deve ser inserido de acordo com a solicitação do Cliente, caso o cliente não queira essa funcionalidade na máquina de cartão)
POS LBC – Função PGTO CUPOM FISCAL
“Essa funcionalidade permite que cupons fiscais de PRODUTOS e COMBUSTÍVEIS sejam recebidos no POS. Para isso, o documento deve ter uma das formas de pagamento abaixo relacionadas em seu recebimento.”
IMPORTANTE: Somente será permitido utilizar o POS LBC para transações de CRÉDITO ou
DÉBITO se uma das formas abaixo tiver sido utilizada. Para pagamento com Cartão de débito:
Para pagamento com Cartão de Crédito:
(Essas formas de pagamento devem estar cadastradas no sistema e com o seu devido Tipo informadas, a mesma também não poderá ter as informações de LBC POS – identificação da forma de pagamento)
POS LBC – Preços especiais
Para o recebimento de CRÉDITO e DÉBITO no POS LBC, é possível vincular uma tabela de preços especiais para o combustível selecionado abaixo a tabela de preço especial que deve ser aplicada em cada modalidade de pagamento.
(Essa funcionalidade foi criada para aqueles clientes que desejam realizar a venda de combustível com preço diferenciado para Crédito e Débito. Deve ser configurada de acordo com as necessidades do cliente).
POS LBC – Definição de acesso
Nesse campo devem ser realizadas as configurações de perfil de acesso para manuseio da máquina de cartão POS LBC.
Realize a conferência e cadastro das formas de
pagamento
No cadastro da forma de pagamento preencha os campos destacados na imagem de acordo com a Rede autorizada e Bandeira, que a empresa trabalha.
OBS: Fiquem atentos a Operação cadastrada na forma de Pagamento e se a mesma está sendo Exportada para o PDV.
Após a configuração e alteração do cadastro, exportar os dados para o PDV.
Feche o LBCPDVSERVER e execute novamente, para receber a atualização das configurações.
Atualizar dados da Máquina POSLBC
Para configuração das maquinas POS é importante lembrar que deve estar em execução:
LBCPDVSERVER XAMPP
Modulo SITEF
Ligue a máquina POS e siga as instruções abaixo:
IMPORTANTE: Para que funcione normalmente é preciso que a máquina esteja atualizada para no mínimo B03.03.06r000.
Caso a máquina não esteja atualizada, realize o processo seguindo o passo a passo abaixo:
Na tela inicial de GERENCIADOR DE APPS, selecione a opção (03 TELECARGA)
Digite o IP do TERMINAL (POS) Digite a máscara da REDE do cliente. Digite o GATEWAY da REDE do cliente.
Nesta tela devem ser inseridas as informações para se alcançar o servidor da Software Express.
IP: 187.103.184.75 Porta 7000 ID
ID da TELECARGA: 3622
OBS: deve ser marcar a opção de carga total.
Após a execução desse processo a máquina será reiniciada, ao iniciar vai baixar alguns registros e atualizar a versão.
ENCERRAR O BROWSER para voltar ao MENU GERENCIADOR DE APP
Caso seja feito a instalação primeiro que a atualização da versão, será necessário encerrar o browser para voltar ao menu de GERENCIADOR DE APP:
REALIZE O SEGUINTE PROCESSO:
Configuração da Máquina POSLBC
Clique na opção 04 Configuração; Clique na opção 02 Config. Instalação;
Digite o IP de instalação:(187.103.184.75) Digite a PORTA de instalação;
OBS: A porta deve ser informada conforme a Administradora do Cliente.
Segue uma lista com algumas portas de Comunicação POS->AGT Público: IP 187.103.184.75 tex - 7000 AGT - Cielo - 8502 AGT - GetNet - 8503 AGT - Rede - 8504 AGT - Elavon - 8505 AGT - Bin - 8510
AGT - Global Payment - 8511 AGT - Stone - 8512
AGT - Vero - 8513
Clique novamente na opção 4configuração. Clique na opção 1 comunicação.
Clique em ENTER na primeira tela apresentada. Digite o SSID (Nome da REDE WIFI)
Digite a senha do wifi do Cliente. Marque a opção NÃO no DHCP
Digite o IP do TERMINAL (POS) Digite a máscara da REDE do cliente. Digite o GATEWAY da REDE do cliente.
Clique na opção 2 Instalação> Digite a chave de ativação do POS.
OBS: Quando for CIELO é uma chave para cada POS Quando for REDE é apenas uma chave para todos os POS
Clique novamente na opção 4configuração. Selecione a opção (lista de Endereços) >Enter
Clique em Enter;
Digite a senha do supervisor (1);
Digite o endereço conforme a imagem lembrando que o IP será o da máquina onde este instalado o XAMPP.