Skip to main content

Atualização do Novo Agente (versão 115199+) e ativação do Impressor

Por que atualizar

A partir da versão 10.000115199, o Novo Agente troca o modelo de comunicação com o Novo Avanço: sai o socket e entra o SSE (Server-Sent Events). A mudança dá mais estabilidade à conexão e reduz erros como cargas que não são baixadas e outras inconsistências na troca de dados com os PDVs e periféricos.

O que deixa de existir no Novo Agente: a impressão de etiquetas. Essa função passa a ser feita por outro software, o Impressor, que é instalado e configurado na etapa 2 deste documento.

A migração tem um pré-requisito e três etapas:

  1. Pré-requisito: Novo Agente na versão 10.000115199 ou superior;
  2. Etapa 1: ativar o parâmetro Exportação PDV/Periféricos V2;
  3. Etapa 2: instalar e configurar o Impressor e ativar o parâmetro Impressora V3;
  4. Etapa 3: validar a impressão de etiquetas, o envio de vendas e o download de cargas.

Pré-requisito: Novo Agente na versão 10.000115199 ou superior

Todos os agentes da empresa precisam estar na versão mais recente do beta, 10.000115199 ou superior. Há dois caminhos:

Opção 1: atualizar agora pelo beta
  1. Em Downloads -> Novo Agente, baixe a versão de QAS do sistema operacional da máquina e extraia na pasta do Novo Agente, como descrito em Como instalar e configurar Novo Agente.
  2. Na pasta do Novo Agente, abra o arquivo ambiente.cfg, troque o conteúdo pela palavra beta e salve.
  3. Reinicie o Novo Agente e confirme que a versão é 10.000115199 ou superior. A versão de cada agente aparece na coluna Versão da tela Frente de Loja -> Sincronização de Periféricos.
🟦 Windows C:\pdvw\NovoAvanco\ambiente.cfg
🐧 Linux /u/pdv/NovoAvanco/ambiente.cfg

Conteúdo do arquivo:

beta
Opção 2: aguardar a atualização automática

Até o final de novembro de 2026, a versão de produção passa a ser a versão mais recente, e todos os agentes são atualizados automaticamente para umaa versão acima115199 deou 10.000.superior. Nesse caso, não é preciso alterar nada no agente.

Só siga para a etapa 1 depois que todos os agentes da empresa estiverem atualizados.

1. Ativar a Exportação PDV/Periféricos V2

ADM Avanço -> Assinaturas -> Contas -> (editar a conta) -> aba Parâmetros -> seção PDV

Na conta da empresa, abra a aba Parâmetros, busque por "Periféricos V2", marque o parâmetro Exportação PDV/Periféricos V2 (nome antigo: Habilitar Exportação PDV/Periféricos V2) e clique em SALVAR.

Parâmetro Exportação PDV/Periféricos V2

Com o parâmetro ativo, a exportação do Novo Avanço deixa de ser uma exportação só de PDV e passa a ser uma exportação de periféricos: na tela Frente de Loja -> Sincronização de Periféricos é possível exportar para várias filiais e para todos os periféricos (PDVs, balanças, supervisores etc.) em uma única tela.

Tela Sincronização de Periféricos

2. Instalar e configurar o Impressor

Downloads -> Impressor

O Impressor (também chamado de Impressor Local ou Impressor Novo Avanço) substitui as funções de impressão de etiquetas que saíram do Novo Agente. Baixe a versão do sistema operacional (Windows ou Linux) na rotina de Downloads, instale no computador ligado à impressora de etiquetas e faça a configuração.

Downloads - Impressor

Ativar o parâmetro Impressora V3

ADM Avanço -> Assinaturas -> Contas -> (editar a conta) -> aba Parâmetros -> seção Etiquetas

Depois de configurar o Impressor, busque por "Impressora V3", marque o parâmetro Impressora V3 e clique em SALVAR.

Parâmetro Impressora V3

Com o parâmetro ativo, toda a impressão de etiquetas passa a ser feita pela comunicação entre o Novo Avanço e o Impressor. A comunicação agora é assíncrona: cada impressão gera um lote que fica gravado no banco de dados até ser consumido pelo Impressor. Assim, uma falha de rede não faz mais a solicitação de impressão se perder; o lote espera até o Impressor buscá-lo.

3. Validar a migração

Teste de etiqueta

Produtos -> Imprimir Etiquetas

Inclua um produto na lista, clique em Salvar Lote e confirme que a etiqueta saiu na impressora. Os lotes enviados podem ser consultados em Visualizar Lotes. Se aparecer o aviso "A impressão requer o Impressor instalado e configurado no computador", revise a etapa 2.

Tela Imprimir Etiquetas (Impressora V3)

Vendas e cargas

Frente de Loja -> Sincronização de Periféricos

  • Confirme que o Novo Avanço está recebendo as vendas enviadas pelos PDVs: a coluna Último envio de venda de cada agente deve estar atualizada.
  • Faça uma sincronização e confirme que os agentes baixaram a carga: a coluna Status da exportação deve mostrar Importada.
Back to top