AbasteceFacil

Instalação

Definições dos Parâmetros Gerais

Antes de realizar a instalação propriamente dita, precisamos configurar alguns parâmetros. Para isso, é necessário acessar o painel do AbasteceFacil, representado pelo ícone circulado na Imagem 1 se o mesmo nao estiver presente é necessário entrar em contato com a Merito. Dentro deste painel, encontraremos a opção "Parâmetros", onde os parâmetros para o funcionamento dos serviços devem ser configurados conforme representado na Imagem 2.

Imagem 1 - Exemplo de localização do ícone do painel de gerenciamento do AbasteceFacil

Imagem 2 - Exemplo do menu de parâmetros do AbasteceFacil

Instalação dos Serviços

Nota: O gerenciador de serviço padrão é o WinSW. Os arquivos .exe não serão enviados para evitar bloqueios durante a atualização. Eles devem ser baixados do WinSW

Serviço Gerenciador de Aplicativo

Para uma melhor experiência com o serviço, recomendamos que o mesmo seja executado no servidor da empresa e que a configuração de IP esteja fixa.

Para iniciar a instalação do aplicativo:

• Navegue até a pasta base do projeto.
• Acesse bin/abastecefacil/aplicativo.
• Copie o arquivo Modelo-AbasteceFacilGerenciadorAplicativo.xml para AbasteceFacilGerenciadorAplicativo.xml.
• Faça os seguintes ajustes dentro de AbasteceFacilGerenciadorAplicativo.xml:
  1. executable: Adicione o caminho do Java 11.
  2. arguments: Não é necessário alteração.
  3. ENV: Configure o IP do banco de dados, nome do banco, usuário e senha.
• Instalação específica para cada sistema:

• Windows

  • Faça o download do arquivo WinSW.
  • Renomeie o arquivo para AbasteceFacilGerenciadorAplicativo.exe.
  • Execute um prompt de comando como administrador.
  • Navegue até a pasta do arquivo.
  • Execute o comando: AbasteceFacilGerenciadorAplicativo install.

• Linux

  Após a configuração, execute o arquivo AbasteceFacilGerenciadorAplicativo. Se não tiver permissão, execute chmod +x AbasteceFacilGerenciadorAplicativo.

Serviço Emissor de Notas

Para uma melhor experiência com o serviço, recomendamos que o mesmo seja executado no servidor da empresa.

Para iniciar a instalação do aplicativo:

• Navegue até a pasta base do projeto.
• Acesse bin/abastecefacil/emissorNota.
• Copie o arquivo Modelo-AbasteceFacilEmissorNota.xml para AbasteceFacilEmissorNota.xml.

•  <service>
    <id>AbasteceFacilAplicativo</id>
    <name>AbasteceFacilAplicativo</name>
    <description></description>  
    <executable>"java"</executable>
    <arguments>-jar "%BASE%/AbasteceFacilGerenciadorAplicativo.jar"</arguments>
    <logmode>rotate</logmode>
    <logpath>%BASE%/logs</logpath>
  
  
    <env name="APP_PROFILE" value="prod" />
    <env name="IP" value="IPBD" />
    <env name="BD" value="NOMEBD" />
    <env name="usuario" value="USERBD" />
    <env name="senha" value="SENHABD" />
    <env name="ISBUFFON" value="CASO UTILIZE O SISTEMA INTEGRAPOSTO POR DEFAULT USAR TRUE" />
  
  </service>
  

• Faça os seguintes ajustes dentro de AbasteceFacilEmissorNota.xml:
  1. executable: Adicione o caminho do Java 8.
  2. arguments: O caminho do executável deve ser configurado com o caminho absoluto em caso de uma instalação Linux.
  3. Crie um arquivo abastecefacil.cfg dentro da pasta bin com as configurações de banco de dados e usuário para login no sistema. Exemplo abaixo
local.ip_bd =localhost
local.porta_bd =5432
local.nome_bd =jposto
local.usuario_bd =postgres
local.senha_bd =2c1062e1442p1072a141211451t1432507525142261241p067
empresa =1
unidade =1
usuario =1
senha =2q1062e1442p1072a141250751x142251451t055
• Instalação específica para cada sistema:

• Windows

  • Faça o download do arquivo WinSW.
  • Renomeie o arquivo para AbasteceFacilEmissorNota.exe.
  • Execute um prompt de comando como administrador.
  • Navegue até a pasta do arquivo.
  • Execute o comando: AbasteceFacilEmissorNota install.

• Linux

  Após a configuração, execute o arquivo AbasteceFacilEmissorNota. Se não tiver permissão, execute chmod +x AbasteceFacilEmissorNota.




Configuração de Dispositivo

Download do Aplicativo

Antes de iniciar, certifique-se de repassar os códigos correspondentes para a Mérito, dependendo da maquininha utilizada:

• Cielo: Cielo Code
• Stone: StoneCode e CNPJ da empresa
• Vero: Acesse o VeroStore e baixe o aplicativo JAbasteceFacil

Configuração Inicial

Para começar, conecte a maquininha a uma rede Wi-Fi que tenha acesso ao servidor e abra o aplicativo JAbasteceFacil:

• Insira o endereço IP do servidor e a porta 8080.
• Clique em "Conectar".
• Se tudo estiver correto, a maquininha mostrará um erro indicando que não está autorizada.

Autorizando Dispositivos

No painel do Abastece Fácil, acesse o menu "Dispositivos" para liberar a maquininha para uso do PDV móvel:

• Encontre o dispositivo desejado.
• Clique com o botão direito e selecione "Autorizar".
• Marque a opção "Autorizado".
• Se necessário, escolha o tipo de dispositivo na lista.
• Após isso, o dispositivo estará liberado para uso.

Utilização do Aplicativo

Após a configuração, a página inicial do aplicativo se torna a lista de abastecidas pendentes. As funcionalidades do aplicativo estão listadas abaixo:

1. Menu de Opções: Abre os menus para reimprimir um pedido e acessar as configurações.
2. Lista de Abastecidas: Mostra as abastecidas pendentes.
3. Modo Escuro / Claro: Altera entre os modos de exibição.
4. Aba das Abastecidas: Mostra a lista de abastecidas.
5. Aba dos Produtos: Mostra a lista de produtos.
6. Aba Clientes: Permite selecionar o cliente para o pedido.
7. Aba Checkout: Finaliza o pedido.
8. Reimpressão: Permite reimprimir notas.
9. Configurações: Abre as configurações do servidor.



Imagem 3 - Menu do aplicativo AbasteceFacil

Aba Abastecidas

Aqui estão listadas todas as abastecidas pendentes em ordem cronológica, com informações como nome do bico, código do bico, quantidade e valor total. Você pode adicionar abastecidas clicando no botão de adição (+) e remover clicando no botão de remoção (-).



Imagem 3 - Abastecidas

Aba Produtos

Nesta aba, você pode pesquisar produtos pelo nome, código ou código de barras. Após a pesquisa, os resultados serão exibidos com o nome do produto, quantidade em estoque e valor unitário. Você pode adicionar produtos ao pedido clicando no botão de adição (+) e remover clicando no botão de remoção (-).



Imagem 3 - Produtos

Aba Clientes

Permite a seleção do cliente para o pedido. Você pode pesquisar pelo nome, CPF, CNPJ ou placa. Após selecionar o cliente desejado, clique na seta para vinculá-lo ao pedido.



Imagem 3 - Clientes

Aba Checkout

Nesta tela, é exibido o resumo do pedido, incluindo as abastecidas e produtos selecionados. Aqui você pode remover ou alterar a quantidade dos itens. No final da tela, você pode limpar o pedido ou finalizá-lo.



Imagem 3 - Checkout

Resumo do Pedido

Nesta tela, o pedido é persistido no banco de dados e é feita a primeira interação com o serviço "Emissor de Nota", onde são validados os descontos do produto e cliente. Aqui você pode cancelar o pedido ou prosseguir para o pagamento (deve ser realizado em um POS real).



Imagem 3 - Resumo do pedido