Atualização automática de PDVs via ERP – Distribuição de versão e regras por empresa

Resumo do que será ensinado

Este documento explica como configurar no ERP a distribuição automática de versões para PDVs, incluindo:

• definição de versão oficial por modelo de PDV;
• criação de versão específica por empresa (nova, beta ou retroativa);
• configuração de bloqueio de atualização para empresas;
• visão geral do gráfico de PDVs por versão e da lista de filiais por versão.

O objetivo é permitir que usuários iniciantes configurem, sozinhos, todas as regras de versão entre ERP e PDV.

Segue um Vídeo explicativo do processo

--> [Insira aqui o link do vídeo de atualização automática no ERP – parte 1 e parte 2]

Detalhamento do uso correto

Com este guia, você deve ser capaz de configurar a distribuição de versões entre ERP e PDV, definindo a versão oficial, versões específicas por empresa e empresas bloqueadas para atualização. Siga cada passo cuidadosamente e utilize as telas do ERP conforme descrito.

Segue o detalhamento de como utilizar a atualização automática de PDVs via ERP

1. Entendendo o conceito de distribuição de versão entre ERP e PDV.

   • O ERP possui um recurso para controlar qual versão do PDV cada empresa deve utilizar.
   • Antes, era possível apenas:
     
     • Informar uma versão por modelo de PDV.
     • Definir um link de download único para essa versão.
   • Com a evolução do recurso, agora é possível:
     
     • Manter uma versão oficial por modelo de PDV.
     • Definir versões específicas para empresas individuais.
     • Bloquear empresas para que não recebam novas versões.
   • Importante: toda a lógica de distribuição de versão é centralizada no ERP, e os PDVs consultam essa configuração quando pedem atualização.

2. Definindo a versão oficial por modelo de PDV.

   • A versão oficial é a versão padrão que será entregue a todos os PDVs de um determinado modelo, quando não existir regra específica por empresa nem bloqueio.
   • Passos para configurar a versão oficial:
   1. Acesse o módulo de configuração de distribuição de versão no ERP.
   2. Localize o campo onde se escolhe o modelo de PDV (no vídeo é citado como “flipper” – considere como o tipo/modelo de PDV).
   3. Selecione o modelo de PDV desejado.
   4. No campo de versão oficial, informe:
      
      • O número da versão (por exemplo, 13.1 ou 3.1, conforme o seu ambiente).
   5. No campo de URL de download, informe:
      
      • O link de download do instalador/atualizador referente a essa versão oficial.
   6. Salve as alterações.
   • Resultado esperado:
     
     • Todos os PDVs desse modelo, sem regra específica e sem bloqueio, ao consultar a versão no ERP, receberão:
     • A versão oficial configurada.
     • A URL de download associada a essa versão.
   • Ponto de atenção:
     
     • Mantenha a URL de download válida e acessível, pois é ela que será utilizada pelos PDVs para baixar o instalador.

3. Criando uma versão específica para uma empresa (nova, beta ou retroativa).

   • A versão específica por empresa permite que uma empresa em particular receba uma versão diferente da oficial, por exemplo:
     
     • Uma versão beta (para testes).
     • Uma versão mais nova ainda não liberada para todos.
     • Uma versão retroativa (anterior), caso seja necessário manter a empresa em um release mais antigo.
   • Passos para definir versão específica por empresa:
   1. Na tela de configuração de distribuição de versão, com o modelo de PDV já selecionado:
      
      • Localize a opção de “Versão específica por empresa” ou similar.
   2. Selecione a ação para adicionar uma nova regra específica.
   3. O sistema apresentará uma lista de empresas integradas ao ERP:
      
      • Você pode pesquisar uma empresa pelo nome ou identificador.
      • Caso a empresa não esteja integrada, você pode informar um documento avulso:
        
        • Digite o CPF ou CNPJ dessa empresa para criar a regra mesmo assim.
   4. Selecione a empresa desejada na lista ou confirme o documento informado.
   5. Informe a versão específica que essa empresa deverá receber, por exemplo:
      
      • 14.0 (versão mais nova).
      • Uma versão anterior, se o objetivo for manter a empresa em versão retroativa.
   6. Informe a URL de download correspondente a essa versão específica:
      
      • Deve ser o link do instalador da versão escolhida.
   7. Salve a configuração.
   • Comportamento após salvar:
     
     • Quando essa empresa consultar a versão disponível no ERP:
     • Não receberá mais a versão oficial (por exemplo, 3.1).
     • Passará a receber a versão específica configurada (por exemplo, 14.0) e seu respectivo link de download.
   • Pontos de atenção:
     
     • Você pode usar versões específicas para:
     • Pilotar uma nova versão com poucos clientes antes de liberar globalmente.
     • Corrigir problemas específicos em uma empresa com uma versão diferenciada.
     • Manter uma empresa em versão antiga por necessidade de integração.
     • Sempre confira se o link de download da versão específica está correto e acessível.

4. Mantendo uma empresa em versão retroativa (versão do passado).

   • Em alguns cenários, a empresa não pode atualizar para versões mais novas, seja por requisitos internos ou integrações externas.
   • Nesse caso, você pode usar a versão específica por empresa para fixar a empresa em uma versão anterior, mesmo que a versão oficial já seja mais recente.
   • Como proceder:
   1. Siga os mesmos passos do item anterior, escolhendo a empresa na lista ou informando o CPF/CNPJ.
   2. Em vez de informar uma versão mais nova, informe uma versão anterior (por exemplo, 12.x ou 13.0, conforme sua base).
   3. Cadastre a URL de download da versão retroativa.
   4. Salve a regra.
   • Resultado:
     
     • Enquanto essa regra estiver ativa, a empresa sempre receberá a versão retroativa configurada, mesmo que:
     • A versão oficial seja mais nova.
     • Outras empresas estejam atualizadas para versões superiores.

5. Configurando bloqueio de atualização para uma empresa.

   • O bloqueio de atualização serve para impedir que uma empresa receba qualquer mudança de versão, mantendo-a sempre na mesma versão que já está em uso.
   • Isso é útil quando:
     
     • A empresa está em ambiente crítico e não pode sofrer alterações.
     • Existe homologação em andamento e não se deseja atualizar durante o período.
   • Passos para bloquear uma empresa:
   1. Na tela de distribuição de versão, localize a seção de bloqueio de atualização ou lista de empresas bloqueadas.
   2. Adicione uma nova entrada de bloqueio.
   3. Informe a empresa que será bloqueada, podendo:
      
      • Selecionar na lista de empresas integradas.
      • Ou informar diretamente um CPF/CNPJ caso a empresa não conste na lista.
   4. Confirme a inclusão dessa empresa na lista de bloqueio.
   • Comportamento após o bloqueio:
     
     • Sempre que o ERP for consultado sobre qual é a versão atual para essa empresa:
     • Retornará a mesma versão que a empresa já utiliza atualmente (por exemplo, 13.1).
     • Essa versão é a que o próprio ERP mantém associada à empresa.
     • Mesmo que uma nova versão seja lançada (por exemplo, 13.2):
     • A empresa bloqueada continuará recebendo a versão 13.1.
     • As demais empresas, não bloqueadas, passarão a receber a nova versão global (13.2).
   • Pontos de atenção:
     
     • O bloqueio afeta somente as empresas listadas; não interfere nas demais.
     • Utilize o bloqueio com critério, documentando internamente por que a empresa está bloqueada e qual risco se pretende evitar.
     • Quando decidir liberar a empresa para atualização, remova-a da lista de bloqueio.

6. Relação entre versão oficial, versão específica e bloqueio.

   • O ERP segue uma hierarquia de decisão para definir qual versão será retornada a um PDV:
   1. Se a empresa estiver bloqueada:
      
      • O sistema mantém a empresa na versão atual informada ao ERP, independentemente de versões novas.
   2. Se existir versão específica por empresa (sem bloqueio):
      
      • A empresa recebe sempre a versão específica configurada, ignorando a versão oficial.
   3. Se não houver bloqueio nem versão específica:
      
      • A empresa recebe a versão oficial configurada para o modelo de PDV.
   • Importante:
     
     • Antes de alterar versões ou bloquear empresas, avalie o impacto nos PDVs e, se necessário, comunique os envolvidos.

7. Visão da distribuição de versões: gráfico e lista de filiais.

   • Na parte inferior da tela de distribuição de versão, o sistema apresenta:
     
     • Um gráfico de PDV por versão.
     • Uma lista de filiais com suas respectivas versões.
   • Gráfico de PDV por versão:
     
     • Mostra, de forma visual, quantos PDVs estão em cada versão.
     • Ajuda a entender a distribuição do parque de PDVs, por exemplo:
     • Quantos já atualizaram para a versão nova.
     • Quantos ainda estão em versões antigas.
   • Lista de filiais por versão:
     
     • Exibe cada filial/empresa e a versão do PDV em uso.
     • Permite identificar rapidamente:
     • Quais empresas ainda não foram atualizadas.
     • Quais estão usando versões específicas ou retroativas.
   • Ponto de atenção:
     
     • Em ambientes de teste, essa lista costuma ser reduzida, com poucos PDVs cadastrados.
     • Em produção, espera-se que o gráfico e a lista fiquem bem preenchidos, refletindo o parque real de PDVs.

8. Orientações práticas de uso no dia a dia.

   • Ao liberar uma nova versão geral:
     
     • Atualize a versão oficial e a URL de download no ERP.
     • Avalie se alguma empresa deve ficar:
     • Com versão específica (piloto ou retroativa).
     • Bloqueada temporariamente.
   • Ao testar versões beta:
     
     • Crie uma versão específica apenas para empresas piloto.
     • Não altere a versão oficial até concluir os testes.
   • Ao identificar problema em nova versão para um cliente:
     
     • Como medida emergencial, você pode:
     • Definir uma versão específica retroativa para essa empresa.
     • Ou colocá-la na lista de bloqueio, mantendo a versão estável atual.
   • Monitoramento contínuo:
     
     • Utilize o gráfico e a lista de filiais para acompanhar a adoção das versões.
     • Sempre que alterar regras ou bloquear empresas, monitore se os PDVs estão respondendo com as versões esperadas.

Informações Importantes

• Resumo das principais orientações.

  • Configure a versão oficial para cada modelo de PDV com sua respectiva URL de download.
  • Use versões específicas por empresa para liberar versões novas, beta ou retroativas apenas para clientes selecionados.
  • Utilize o bloqueio de atualização para manter empresas em uma versão fixa, mesmo com novas releases disponíveis.
  • Verifique o gráfico de PDV por versão e a lista de filiais para entender a distribuição e o impacto das mudanças.

• Dicas de uso.

  • Antes de grandes atualizações, planeje quais empresas:
  • Receberão a nova versão oficial imediatamente.
  • Permanecerão numa versão específica (beta ou retroativa).
  • Ficarão temporariamente bloqueadas.
  • Em cenários de teste, use versões específicas em poucas empresas para reduzir riscos.

• Recomendações gerais sobre o processo.

  • Documente internamente quais empresas possuem:
  • Versão específica configurada.
  • Bloqueio de atualização ativo.
  • Mantenha uma rotina de revisão das regras para evitar empresas esquecidas em versões antigas sem necessidade.
  • Caso surjam dúvidas sobre campos e telas, consulte também a documentação interna vinculada ao módulo de distribuição de versão no ERP.

• Benefícios de seguir corretamente o procedimento.

  • Maior controle e segurança sobre quais versões cada empresa utiliza.
  • Possibilidade de testar versões novas com grupos reduzidos antes da liberação geral.
  • Redução de incidentes causados por atualizações não planejadas.
  • Visão clara da distribuição de versões no parque de PDVs, facilitando suporte e planejamento de releases.