AbasteceFacil

De Merito Wiki
Revisão de 14h43min de 6 de março de 2024 por imported>Wilian
Ir para: navegação, pesquisa

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

    aaaa a a a

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

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

    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.

    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.

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