Recursos e Funcionalidades do Integrador do Maqplan One

Resumo do que será ensinado

Neste documento você entenderá como utilizar o Integrador do Maqplan One, incluindo:

• Onde localizar e abrir o Integrador.
• Como acompanhar o que está sendo sincronizado.
• Como usar as opções Sincronizar tudo, Produtos, Clientes, Operadores de caixa, Vendas, Pré-requisitos fiscais e Caixas.
• Como configurar o comportamento do Integrador (tempo de sincronização, itens pendentes, múltiplos servidores, notificações e minimização).

Segue um Vídeo explicativo do processo

Detalhamento do uso correto

Com este guia, você deve ser capaz de operar o Integrador do One no dia a dia, entendendo o que cada menu faz e como utilizar as configurações para manter o PDV sempre sincronizado com o ERP.

Segue o detalhamento de como utilizar o Integrador do Maqplan One

1. Primeiro passo: Localizar e abrir o Integrador do One.

   • Após a instalação do Maqplan One, o Integrador é instalado junto com o sistema.
   • Ele aparece como um ícone específico:
     
     • Na área de trabalho (desktop).
     • E/ou dentro da pasta de instalação do sistema One.
   • Para abrir:
     
     • Dê duplo clique no ícone do Integrador.
   • Ao abrir, será exibida uma tela principal mostrando:
     
     • Um log (histórico) de tudo que está sendo feito (sincronizações, horários, operações).
   • Pontos de atenção.
     
     • Se a tela estiver cheia de registros, você pode limpar clicando em “Limpar” para zerar a visualização (isso não apaga dados, apenas limpa a tela de log).

2. Segundo passo: Entender as funções principais do Integrador (menu superior).

   • Na tela do Integrador, há botões/menus com diversas funções.
   • A função principal é manter o One sincronizado com o ERP, recebendo e enviando dados.
   • Entre as opções, destacam-se:
     
     • Sincronizar tudo.
     • Produtos (pendentes e todos).
     • Clientes (pendentes e todos).
     • Operador de caixa.
     • Sincronizar vendas.
     • Pré-requisitos fiscais (perfil tributário, certificados, CSC etc.).
     • Caixas.
     • Conectar (usuário e senha).
     • Configurações (tempo, itens pendentes, comportamento do sincronizador).

3. Terceiro passo: Utilizar a opção “Sincronizar tudo”.

   • Clique na opção “Sincronizar tudo”.
   • O Integrador exibirá uma mensagem de confirmação, avisando que esta operação pode demorar bastante tempo, principalmente se o cliente tiver muitos dados.
   • Ao confirmar:
     
     • Serão sincronizados todos os dados principais do ERP para o One, como:
     • Produtos.
     • Clientes.
     • Fornecedores.
     • Outras entidades relacionadas.
     • Importante:
     • Vendas não são recebidas do ERP para o One por esta função (o Integrador não desce vendas do ERP; ele apenas sobe as vendas do PDV para o ERP).
   • Quando usar “Sincronizar tudo”.
     
     • Em instalações novas (banco em branco) para carregar toda a base.
     • Após formatações ou reinstalações em que é necessário reconstruir o conteúdo do PDV.

4. Quarto passo: Trabalhar com o menu de Produtos.

   • Acesse a aba/menu Produtos no Integrador.
   • Nela, existem duas funções principais:
   1. Receber produtos pendentes.
      
      • Essa função busca apenas os produtos que foram editados ou criados recentemente no ERP desde a última sincronização.
      • Útil quando:
        
        • Você fez pequenas alterações no ERP (ex.: preço de alguns itens, cadastro de poucos produtos) e quer apenas essas mudanças no PDV.
      • Após receber, o Integrador informa ao ERP que aqueles itens foram sincronizados; se você tentar receber pendentes novamente sem novas mudanças, ele indicará que não há mais nada pendente.
   2. Sincronizar todos os produtos.
      
      • Esta opção busca todos os produtos do ERP para o One.
      • Se houver 10.000 ou 20.000 produtos, ele irá recebê-los todos, exibindo no log algo como:
        
        • Lista 1 de 50, lista 2 de 50, e assim por diante.
      • A cada lista, ele baixa entre 300 e 500 produtos (números informados no vídeo) até completar toda a base.
   • Pontos de atenção.
     
     • Use “produtos pendentes” para atualizações rápidas.
     • Use “sincronizar todos” em casos de instalação nova, reconfiguração geral ou quando houver suspeita de muitos itens desatualizados.

5. Quinto passo: Trabalhar com o menu de Clientes.

   • No menu Clientes, existem opções semelhantes:
     
     • Sincronizar todos os clientes.
     • Sincronizar apenas clientes pendentes.
   • Funcionam de forma similar aos produtos:
     
     • Pendentes: apenas novos clientes ou clientes alterados recentemente no ERP.
     • Todos: traz toda a base de clientes para o One.
   • Utilização prática.
     
     • Pendentes: quando foram cadastrados poucos clientes novos no ERP.
     • Todos: em banco novo ou após grandes ajustes na base de clientes.

6. Sexto passo: Sincronizar operadores de caixa (usuários do PDV).

   • O Integrador possui um menu para Operadores de caixa.
   • Nessa opção, você sincroniza os usuários que irão operar o PDV, ou seja:
     
     • Quem vai abrir o sistema.
     • Quem vai operar o caixa.
   • Os operadores geralmente são cadastrados no ERP ou em módulo central, e depois enviados ao One pelo Integrador.
   • Ponto de atenção.
     
     • Se um operador não aparece no PDV, verifique se foi feito o envio dos operadores de caixa pelo Integrador.

7. Sétimo passo: Enviar vendas do One para o ERP.

   • Há uma função de sincronizar vendas, que serve para subir as vendas do PDV para o ERP.
   • Observações importantes:
     
     • O Integrador não traz vendas do ERP para o One.
     • Ele é utilizado para enviar (subir) vendas registradas no PDV para o ERP, garantindo:
     • Controle de faturamento centralizado.
     • Atualização de estoque e financeiro no ERP.
   • Sempre que houver muitas vendas registradas, certifique‑se de que a sincronização de vendas está ocorrendo regularmente.

8. Oitavo passo: Sincronizar pré-requisitos fiscais e caixas.

   • No Integrador, existe uma opção chamada Pré-requisitos (ou similar), que inclui:
     
     • Perfil tributário (regras fiscais).
     • Certificado digital.
     • CSC (código de segurança do contribuinte).
     • Outros itens fiscais necessários para emissão de documentos fiscais.
   • Também há a opção Caixas, usada para enviar as configurações de caixas do ERP para o One.
   • Quando usar.
     
     • Ao configurar o ambiente fiscal (NFC-e, SAT, etc.).
     • Quando houver mudança de certificado, CSC ou perfil tributário.
     • Ao criar ou alterar caixas no ERP que devem ser replicados para o PDV.

9. Nono passo: Conectar o Integrador ao ERP (usuário e senha).

   • Para que o Integrador funcione, é necessário que ele esteja conectado ao ERP.
   • Existe um menu/opção Conectar.
   • Ao clicar, será solicitado:
     
     • Usuário (e-mail ou login cadastrado no ERP).
     • Senha correspondente.
   • Após informar e confirmar, o Integrador passa a:
     
     • Utilizar essas credenciais para acessar o ERP.
     • Realizar as sincronizações (enviar e receber dados).
   • Pontos de atenção.
     
     • Use sempre usuário e senha válidos, com permissão para integração.
     • Se houver erro de login, revise as credenciais no ERP.

10. Décimo passo: Configurar o comportamento do Integrador (menu Configurações).

    • No menu Configurações, você encontra parâmetros importantes para o funcionamento automático do Integrador:

    10.1 Tempo de sincronização automática.

    • Há um campo de tempo em que o Integrador irá executar sincronizações automáticas.
    • Por padrão, este tempo vem configurado em 30 minutos.
    • Significa que a cada 30 minutos o Integrador:
      
      • Verifica se há dados pendentes.
      • Realiza sincronizações de acordo com as configurações.
    • Você pode ajustar esse tempo conforme necessidade do cliente (mais curto ou mais longo).

    10.2 Sincronizar itens pendentes (marcado x desmarcado).

    • Existe a opção “Sincronizar itens pendentes”.
    • Quando está marcada:
      
      • O Integrador trabalha apenas com itens pendentes (produtos/entidades que tiveram edição recente).
      • Ideal para clientes com um único banco de dados/servidor.
    • Quando está desmarcada:
      
      • O Integrador entende que existem dois ou mais bancos/servidores e precisa garantir que todos os produtos sejam recebidos.
      • Ele passa a considerar a necessidade de recebimento total em determinados cenários, garantindo que nenhum servidor fique sem os produtos necessários.
    • O vídeo explica que:
      
      • Mesmo desmarcando, ele não fica recebendo todos os produtos o tempo todo.
      • Ele verifica se todos os produtos já foram recebidos por aquele servidor; se já estiver tudo recebido, ele não baixa novamente.
    • Resumo:
      
      • Marcado: foco em pendentes (um servidor).
      • Desmarcado: contexto com vários servidores, garantindo que ninguém fique sem dados essenciais.

    10.3 Comportamento de notificação e inicialização minimizada.

    • Existem duas opções adicionais:

      1. Não exibir o valor de notificação.
      • Quando desativado, o Integrador não mostra algumas notificações visualmente (ex.: mensagens flutuantes de sincronização), deixando o uso mais “silencioso”.
      1. Iniciar sincronizador minimizado.
      • Quando ativado, mesmo que o usuário “feche” a janela:
        
        • O Integrador não é encerrado.
        • Ele continua rodando minimizado, geralmente na bandeja do sistema (próximo ao relógio).
      • Isso é importante porque:
        
        • Garante que o Integrador permaneça ativo o dia inteiro, recebendo atualizações do ERP sem depender do usuário deixar a janela aberta.

    • Ponto de atenção.

      • Recomenda‑se deixar a opção de iniciar minimizado ativada, para que o Integrador sempre rode em segundo plano, garantindo a atualização contínua.

11. Décimo primeiro passo: Salvar configurações e manter o Integrador rodando.

    • Após ajustar as configurações:
      
      • Clique em Salvar / Gravar.
      • Não é necessário reiniciar o Integrador; ele passará a executar com as novas configurações.
    • Deixe o Integrador rodando em background (principalmente com a opção de iniciar minimizado), garantindo que:
      
      • Dados de produtos, clientes, operadores, pré-requisitos e vendas sejam sincronizados regularmente.

Informações Importantes

• Resumo das principais orientações.

  • O Integrador é responsável por sincronizar o Maqplan One com o ERP.
  • Sincronizar tudo traz/mantém todos os dados (menos vendas) do ERP no One.
  • Os menus de Produtos e Clientes permitem sincronizar pendentes (alterações recentes) ou todos.
  • Operadores de caixa e Caixas precisam ser enviados para que o PDV funcione com os usuários corretos.
  • Vendas são apenas enviadas do One para o ERP (não são recebidas).
  • O menu Configurações define tempo de sincronização, uso de itens pendentes e comportamento de notificações/minimização.

• Dicas de uso.

  • Para clientes com grande volume de dados, evite usar Sincronizar tudo com frequência; prefira pendentes.
  • Sempre que houver alteração importante no ERP (produtos, clientes, perfis fiscais), planeje uma sincronização adequada pelo Integrador.
  • Em ambientes com mais de um servidor, ajuste corretamente a opção Sincronizar itens pendentes (desmarcando quando necessário).
  • Verifique regularmente o log do Integrador para identificar erros de comunicação ou itens que não sincronizaram.

• Recomendações gerais sobre o processo.

  • Em caso de erro (mensagem no log, falha de conexão):
  • Anote a mensagem exibida.
  • Verifique usuário/senha, conexão com a internet e acesso ao ERP.
  • Encaminhe as informações ao suporte técnico, informando que o problema está no Integrador do One.
  • Não feche o Integrador completamente durante o expediente; mantenha‑o minimizado para garantir sincronização constante.

• Benefícios de seguir corretamente o procedimento.

  • Manter o Maqplan One sempre atualizado com as informações do ERP.
  • Garantir que produtos, clientes, operadores e parâmetros fiscais estejam alinhados entre os sistemas.
  • Reduzir falhas operacionais por falta de dados ou desatualização, proporcionando uma operação de PDV mais estável e confiável.