# Atualização do Novo Agente e ativação do Impressor ### Por que atualizar A partir da versão **115199**, 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**](https://novoqas.avancoinfo.com.br/novoPortal/downloads?app=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 115199 ou superior; 2. **Etapa 1:** ativar o parâmetro *Exportação PDV/Periféricos V2*; 3. **Etapa 2:** instalar e configurar o [Impressor](https://novoqas.avancoinfo.com.br/novoPortal/downloads?app=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 115199 ou superior Todos os agentes da empresa precisam estar na versão mais recente do **beta**, 115199 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](https://bc.avancoinfo.com.br/books/novo-agente/page/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 é 115199 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 a versão 115199 ou 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](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/scaled-1680-/01-exportacao-pdv-v2.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/01-exportacao-pdv-v2.png) 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](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/scaled-1680-/04-sincronizacao-perifericos.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/04-sincronizacao-perifericos.png) ### 2. Instalar e configurar o Impressor *[Downloads -> Impressor](https://novoqas.avancoinfo.com.br/novoPortal/downloads?app=impressor)* O [**Impressor**](https://novoqas.avancoinfo.com.br/novoPortal/downloads?app=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](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/scaled-1680-/02-downloads.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/02-downloads.png) ##### **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](https://novoqas.avancoinfo.com.br/novoPortal/downloads?app=impressor), busque por **"Impressora V3"**, marque o parâmetro **Impressora V3** e clique em **SALVAR**. [![Parâmetro Impressora V3](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/scaled-1680-/03-impressora-v3.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/03-impressora-v3.png) 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**. [![Tela Imprimir Etiquetas (Impressora V3)](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/scaled-1680-/05-impressora-v3-tela.png)](https://bc.avancoinfo.com.br/uploads/images/gallery/2026-10/05-impressora-v3-tela.png) ##### **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*.