Shell Box (Pista)
- Leonardo Gama
- Dioni Rocha
O Shell Box é uma aplicação onde o cliente paga sem contato, participa automaticamente das promoções vigentes e tem benefícios.
Mais informações em:
https://www.shell.com.br/motoristas/promocoes-e-campanhas/app-shell-box.html
Este manual tem como objetivo mostrar as Configurações necessárias no webPosto e o funcionamento da Integração com o app Shell Box no webPostoPDV Pista.
Esta integração não necessita de liberação do Comercial ou Suporte da Quality.
Instalação do serviço (ShellBox Pista)
Faça o download do atualizador mais recente presente no FTP através do link a seguir:
http://arquivo.qualityautomacao.com.br/PDV/Versoes/webPostoPDV/
Marque apenas o serviço Serviço ShellBox e efetue a instalação.
Será criado um ícone de configuração na área de trabalho acesse-o para realizar a instalação e configuração do serviço.
Ao clicar pela primeira vez será necessário apontar o IP, Porta e Nome do Banco na Configuração do Banco de Dados.
Clique em Instalar Serviço e após em Iniciar Serviço.
Atenção!
O recebimento das informações está condicionado a liberação pelo próprio Shell Box, sendo necessário abrir um chamado na Shell: https://www.conexaoshell.com.br/login
Cadastro de Administradoras (ShellBox Pista)
Para que as informações do pagamento sejam identificadas e a integração ocorra em sua plenitude, é necessário que no cadastro das administradoras sejam inseridas as nomenclaturas para definir em qual será lançada os respectivos valores.
O campo a ser preenchido é “Administradora PDV Móvel”, disponibilizado ao habilitar a flag “Usa PDV Movel”.
E no campo “Tipo Administradora”, precisa estar selecionado como “Carteira Digital.
Nas versões do PDV 24.02 ou superiores, as administradoras que estiverem com a flag marcada de “Imprime Comprovante” será exibida a tela ao finalizar a venda se o usuário quer ou não imprimir o comprovante padrão do webPosto.
Localização: Retaguarda → Cadastros → Administradoras → Dados
Nomenclaturas das Administradoras para versão do serviço 24.04.5.3 ou anterior: (ShellBox Pista)
As nomenclaturas são: SHELLBOX DESCONTO, SHELLBOX CREDITO e SHELLBOX PIX.
Os valores do SHELLBOX DESCONTO é identificado no comprovante da Shell Box como “DESCONTO SHELL”.
Quanto ao valor do SHELLBOX MINHAS CAMPANHAS, o mesmo será apresentado com desconto diretamente no abastecimento. Este valor é apresentado no comprovante da Shell Box como “DESCONTO POSTO”.
Nomenclaturas das Administradoras para versão do serviço 24.09.5.1 ou superior: (ShellBox Pista)
Devido a alteração da rotina da integração, o cadastro da nomenclatura na administradora, no campo “Administradora PDV Móvel”, deverá ser de acordo com os métodos disponíveis no Shell Box.
Como a quantidade é expressiva, existe a opção de incluir na mesma administradora, separando as nomenclaturas por ponto e vírgula, diversos tipos, conforme exemplo:
SHELLBOX DESCONTO: SHELLBOX DESCONTO RAIZEN;SHELLBOX SHELL BOX CLUBE;SHELLBOX DINHEIRO
SHELLBOX CREDITO: SHELLBOX CARTAO DE CREDITO;SHELLBOX NUPAY CREDITO;SHELLBOX PARCEIRO DE ABASTECIMENTO;SHELLBOX EMPRESAS;SHELLBOX CARTEIRA DIGITAL;SHELLBOX CREDITO COMBUSTIVEL;SHELLBOX PAYPAL
SHELLBOX PIX: SHELLBOX PIX
SHELLBOX DEBITO: SHELLBOX DEBITO;SHELLBOX NUPAY DEBITO
Somente o desconto concedido pelo Shell Box que é necessário mapear na administradora.
O desconto configurado pelo posto no portal do Shell Box como por exemplo: SHELLBOX MINHAS CAMPANHAS, é aplicado diretamente como desconto no abastecimento.
Descrições definidas pelo Shell Box |
|---|
SHELLBOX CARTAO DE CREDITO |
SHELLBOX CARTEIRA DIGITAL |
SHELLBOX CREDITO COMBUSTIVEL |
SHELLBOX DEBITO |
SHELLBOX DESCONTO RAIZEN |
SHELLBOX DINHEIRO |
SHELLBOX EMPRESAS |
SHELLBOX NUPAY CREDITO |
SHELLBOX NUPAY DEBITO |
SHELLBOX PARCEIRO DE ABASTECIMENTO |
SHELLBOX PAYPAL |
SHELLBOX PIX |
SHELLBOX SHELL BOX CLUBE |
Para realizar a atualização do serviço é necessário:
Parar o serviço webPostoShellBoxIntegracao em execução e realizar uma cópia de backup do executável na própria pasta C:\Quality\Services\webPostoShellBoxIntegracao;
Ajustar o cadastro das administradoras, alterando as nomenclaturas já existentes dos itens 1 e 2, e cadastrando a nova “SHELLBOX DEBITO” do item 4 (É necessário realizar na versão do retaguarda 24.9 ou superior);
Aguardar a atualização na base local;
Atualizar utilizando o último arquivo do FTP e iniciar o serviço;
Acompanhar as novas transações para verificar se houve o cadastro incorreto das nomenclaturas.
Cadastro de PDV (ShellBox Pista)
Localização: Retaguarda → Cadastros → PDV → Cadastro → Configuração
Não é possível bloquear a forma de pagamento selecionada pelo cliente no app, no entanto, é possível bloquear o prazo, impedindo dar a baixa do abastecimento com a finalização da venda.
Necessita configurar a chave do PDV:
PDV-Tipo prazo abastecimento pré-pago permitido
Poderá utilizar no campo “Valor” os códigos, exemplo: “001” ou “011”.
Também poderá utilizar a nomenclatura, exemplo: “DINHEIRO” ou “CARTÃO.
Fluxo de Atendimento no webPostoPDV (ShellBox Pista)
Quando um abastecimento for pago utilizando o ShellBox, irão aparecer na coluna Pré Pago com as classificações SHELLBOX CREDITO e SHELLBOX DINHEIRO.
Ao Fechar a Venda, o abastecimento Pré Pago SHELBOX CREDITO será lançado automaticamente o pagamento no prazo CARTÃO conforme abaixo.
Ao Fechar a Venda, o abastecimento Pré Pago SHELBOX DINHEIRO será lançado automaticamente o pagamento no prazo DINHEIRO conforme abaixo.
Fluxo de Atendimento no webPostoPay (ShellBox Pista)
Versões necessárias para funcionamento:
Serviço do webPostoPay: 24.8.1 ou superior
App do webPostoPay: 24.8.1 ou superior
Quando um abastecimento for pago utilizando o ShellBox, irá surgir um ícone com a informação que já consta pago, precisando apenas selecionar para finalizar a venda.
