Instalação e Configuração sistema One com conexão com o PostgreSQL

Resumo do que será ensinado

Neste documento você aprenderá, passo a passo, como instalar e configurar o sistema Maqplan One utilizando o banco de dados PostgreSQL, desde a instalação do PostgreSQL até a configuração do arquivo de conexão e do primeiro acesso ao One com integração ao ERP.

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, você deve ser capaz de instalar o PostgreSQL, ajustar o arquivo de conexão do One para usar o banco PostgreSQL (removendo o banco embarcado em SQL), informar e‑mail e senha do ERP e configurar as principais opções do sistema (terminal, caixa, estoque, impressão, TEF, etc.).

Segue o detalhamento de como instalar e configurar o Maqplan One com PostgreSQL

1. Primeiro passo: Ajustar o arquivo de conexão do One para usar PostgreSQL.

   • Após instalar o sistema One, ele cria dois arquivos de configuração de banco na pasta de instalação.
   • Um destes arquivos representa o banco embarcado em SQL (não é o PostgreSQL).
   • A recomendação é não utilizar o banco embarcado, e sim o banco PostgreSQL que será instalado separadamente.
   • Localize os arquivos de configuração de banco do One:
     
     • Um arquivo com referência ao banco embarcado em SQL.
     • Outro arquivo referente ao banco PostgreSQL (DB).
   • Ação necessária:
     
     • Apague o arquivo do banco embarcado em SQL.
     • Deixe apenas o arquivo do banco PostgreSQL, com o nome contendo “db” (por exemplo, apenas o “db” certinho).
     • Em algumas versões, este arquivo pode ter uma extensão adicional no final (ex.: “.json” ou similar).
     • Nesse caso, mantenha a extensão, apenas garantindo que fique somente o arquivo DB.
   • Pontos de atenção.
     
     • Apagar o arquivo errado pode impedir a conexão; certifique‑se de remover apenas o que aponta para o banco embarcado em SQL.
     • Após manter apenas o arquivo DB, o sistema passará a trabalhar com o PostgreSQL instalado no computador.

2. Segundo passo: Abrir o sistema One pela primeira vez.

   • Com o arquivo de banco ajustado, abra o Maqplan One normalmente.
   • Na primeira execução, o sistema ainda não terá conexão estabelecida com a conta ERP do cliente.
   • O One exibirá uma tela solicitando e‑mail e senha do ERP.

3. Terceiro passo: Conectar o One à conta do ERP.

   • Na tela inicial do One, informe:
     
     • E‑mail do usuário cadastrado no ERP do cliente.
     • Senha correspondente a esse usuário ERP.
   • Após preencher, clique em Entrar / Conectar.
   • O sistema irá:
     
     • Validar as credenciais no ERP.
     • Conectar a conta do cliente.
     • Baixar as informações necessárias (dados da empresa, configurações iniciais, etc.).
   • Aguarde o processo de sincronização inicial até que o sistema conclua o carregamento dos dados.

4. Quarto passo: Conferir se os dados foram baixados corretamente.

   • Depois que o One concluir a sincronização, ele exibirá as informações básicas do cliente.
   • É recomendável conferir se:
     
     • Os dados da empresa (nome, CNPJ, etc.) estão corretos.
     • As configurações gerais do ERP foram reconhecidas.
   • Caso haja divergência, confirme no ERP se os dados estão atualizados e, se necessário, refaça o login no One.

5. Quinto passo: Configurar o tipo de terminal (ponto de venda / ADM / pré‑venda).

   • Ainda no processo de configuração do One, será exibida uma tela para definir o tipo de uso do terminal.
   • As principais opções são:
     
     • Terminal ponto de venda / realizar venda.
     • Usado em caixas que fazem vendas diretamente.
     • ADM.
     • Usado para cadastros, configurações administrativas e tarefas de gestão.
     • Terminal de cliente / pré‑venda.
     • Usado quando o terminal serve apenas para pré‑venda ou consulta, sem função de caixa principal.
   • Configuração padrão recomendada:
     
     • Marcar ponto de venda e ADM para a maioria dos terminais (permite vender e cadastrar).
     • Se o terminal for especificamente de pré‑venda, marque apenas a opção de pré‑venda, e o sistema automaticamente desmarca as duas de cima.
   • Após escolher as opções adequadas, clique em Avançar.

6. Sexto passo: Configurar opções de caixa (fechamento e fundo de caixa).

   • Na tela seguinte, o sistema exibirá várias opções relacionadas a caixa.
   • Entre as opções, encontram‑se:
     
     • Fechamento detalhado.
     • Fechamento diário.
     • Incluir fundo de caixa.
   • Configuração padrão recomendada para a maioria dos clientes:
     
     • Fechamento detalhado: para registrar de forma detalhada todas as movimentações.
     • Fechamento diário: para que o caixa seja fechado todos os dias.
     • Incluir fundo de caixa: quando o cliente utiliza valor inicial de caixa (troco).
   • Marque essas opções conforme o que for acordado com o cliente.
   • Existem outras opções adicionais que podem ser habilitadas conforme necessidade; porém, se não houver instrução específica, mantenha o padrão sugerido.

7. Sétimo passo: Configurar opções de estoque.

   • Na aba seguinte, as configurações serão relacionadas a estoque.
   • Algumas opções disponíveis:
     
     • Controle de estoque.
     • Controle de observação, complementos, etc.
   • Para uma configuração básica:
     
     • Ative pelo menos o “controle de estoque”, garantindo que o sistema gerencie entradas e saídas de produtos.
   • Outras opções, como observações e complementos, podem ser marcadas se o cliente desejar recursos extras de controle de produtos.

8. Oitavo passo: Configurar balança, etiquetas e entregas.

   • Na sequência, há abas específicas para:
     
     • Balança e etiqueta de balança.
     • Entregas.
   • Em balança:
     
     • Ative se o cliente trabalhar com produtos pesáveis, configurando o modelo de balança e etiqueta utilizada.
   • Em entregas:
     
     • Ative caso o cliente utilize delivery, podendo incluir integração com iFood e outras plataformas de entrega.
   • Essas opções ficam agrupadas nesta parte da configuração.

9. Nono passo: Configurar impressora.

   • Na aba de impressora, o One permite vincular a impressora que será usada para cupons, relatórios, etc.
   • Você pode escolher:
     
     • Impressora A4.
     • Impressora térmica.
   • O sistema exibirá uma lista de impressoras instaladas no Windows.
   • Selecione a impressora desejada para o terminal.
   • Há também a opção de perguntar se deseja imprimir toda vez que houver impressão, exibindo uma confirmação ao usuário.
     
     • Ative essa opção se o cliente preferir escolher caso a caso se imprime ou não.

10. Décimo passo: Configurar mesas (para restaurantes).

    • Na aba mesas, configure somente se o cliente trabalhar com controle de mesas, típico de restaurantes.
    • É possível:
      
      • Habilitar controle de mesa.
      • Definir a quantidade de mesas que serão exibidas.
    • Se o cliente não utiliza esse modelo, não habilite por enquanto.

11. Décimo primeiro passo: Configurar pedidos.

    • Na aba pedidos, é possível ajustar:
      
      • Modo de pedido.
      • Pedido confirmado (aquele que não emite nota fiscal, funcionando como uma pré‑ordem ou controle interno).
    • Habilite ou não essas opções conforme o processo do cliente.
    • O pedido confirmado é útil quando se deseja registrar pedidos sem emitir nota imediatamente.

12. Décimo segundo passo: Personalização visual.

    • Na aba de personalização, é possível:
      
      • Inserir a logo do cliente no sistema.
      • Configurar mensagens personalizadas.
      • Definir tela favorita, como tela de restaurante ou outra tela inicial específica.
    • Ajuste conforme o desejo do cliente para que o sistema fique personalizado com a identidade visual dele.

13. Décimo terceiro passo: Configurar TEF (se o cliente usar pagamento com cartão integrado).

    • Na aba de TEF, configure o módulo de TEF utilizado pelo cliente.
    • No vídeo, o exemplo utiliza um provedor específico (como GetCard), porém no One você:
      
      • Ativa o TEF.
      • Seleciona qual TEF será utilizado.
      • Ajusta o provedor conforme contratado pelo cliente.
    • Após selecionar o TEF, o sistema utilizará essas informações para integrar pagamentos com cartão às vendas.

14. Décimo quarto passo: Configurar parâmetros de vendas.

    • Na aba de vendas, existem várias opções relacionadas ao comportamento das telas de venda.
    • No exemplo do vídeo, as opções dessa aba foram desmarcadas, deixando apenas o que é necessário.
    • Você pode:
      
      • Habilitar controles específicos (se o cliente solicitar).
      • Desmarcar opções que não são necessárias para simplificar o uso.
    • Para uma configuração inicial, desmarque itens que não foram solicitados, evitando complexidade excessiva.

15. Décimo quinto passo: Definir modo fiscal (se emite nota ou não).

    • Numa etapa seguinte, o sistema perguntará sobre o modo fiscal.
    • No exemplo apresentado:
      
      • O cliente não emite nota pelo One, portanto o modo fiscal foi desabilitado.
    • Se o cliente não precisa emitir NF pelo One, desabilite o modo fiscal.
    • Caso contrário (cliente emitirá notas), essa configuração deve ser feita em outro momento, em uma aba específica de configurações fiscais.

16. Décimo sexto passo: Finalizar o assistente de configuração.

    • Depois de passar por todas as abas (caixa, estoque, balança, entregas, impressora, mesas, pedidos, personalização, TEF, vendas, modo fiscal):
      
      • Clique em Avançar.
      • Finalize o processo de configuração.
    • O sistema irá reiniciar automaticamente para aplicar todas as configurações realizadas.

17. Décimo sétimo passo: Verificar abertura do sistema e integrador.

    • Após o reinício, o Maqplan One será aberto novamente.
    • O integrador do sistema também será aberto, mostrando:
      
      • Opções como sincronizar tudo, sincronizar produtos, etc.
    • O integrador irá carregar todas as configurações e informações necessárias, mantendo o One sincronizado com o ERP e o banco PostgreSQL.
    • Verifique se o integrador está:
      
      • Recebendo e enviando dados corretamente.
      • Sem mensagens de erro.

18. Décimo oitavo passo: Confirmar operação do sistema em ambiente configurado.

    • Com a instalação do PostgreSQL, ajuste do arquivo DB, conexão ao ERP e configurações concluídas:
      
      • Faça um teste de uso básico, como abrir telas de venda, consultar produtos, etc.
    • Certifique‑se de que:
      
      • O sistema está rápido e estável.
      • Não há erros de conexão ao banco ou ao ERP.

Informações Importantes

• Resumo das principais orientações.

  • Apague o arquivo de banco embarcado em SQL e mantenha apenas o arquivo DB (PostgreSQL) com sua extensão correta.
  • Na primeira abertura, informe e‑mail e senha do ERP para conectar o One à conta do cliente.
  • Configure o terminal como ponto de venda e ADM (ou pré‑venda, quando for o caso).
  • Ajuste as abas de caixa, estoque, balança, entregas, impressora, mesas, pedidos, personalização, TEF e vendas conforme o padrão recomendado ou necessidade do cliente.
  • Desabilite o modo fiscal se o cliente não emitir nota pelo One; deixe para configurar em outro momento se necessário.

• Dicas de uso.

  • Sempre confira as configurações no ERP antes de sincronizar, garantindo que os dados do cliente estejam corretos.
  • Em terminais específicos (por exemplo, apenas pré‑venda), simplifique as configurações para evitar funções desnecessárias.
  • Ao configurar TEF, siga o padrão utilizado em outros sistemas da empresa para manter padronização de provedor e parâmetros.

• Recomendações gerais sobre o processo.

  • Se após apagar o arquivo de banco errado o sistema não conectar, revise:
  • Nome do arquivo DB.
  • Caminho do banco PostgreSQL.
  • Em qualquer erro de login ou sincronização, verifique se o e‑mail e senha ERP estão corretos e ativos.
  • Caso surjam mensagens de erro durante a configuração ou sincronização, registre o texto e encaminhe ao suporte técnico, informando que se trata de instalação/configuração do One com PostgreSQL.

• Benefícios de seguir corretamente o procedimento.

  • Garantir que o Maqplan One utilize corretamente o PostgreSQL como banco de dados, com conexão estável ao ERP.
  • Padronizar a configuração inicial, facilitando suporte e futuras manutenções.
  • Proporcionar ao cliente um ambiente organizado e funcional, com terminal configurado, integração ativa e recursos adequados às necessidades de operação.