Como instalar e configurar o Impressor

O que é o Impressor

O Impressor é o aplicativo de impressão de etiquetas de gôndola e de produto do Novo Avanço, instalado no computador ligado à impressora térmica (Windows ou Linux).

Ele substitui a impressão de etiquetas que era feita pelo Novo Agente. A partir da versão 115199, o Novo Agente deixa de imprimir etiquetas (veja Atualização do Novo Agente (versão 115199+) e ativação do Impressor).

O Impressor também resolve os problemas de instabilidade de rede que faziam a impressão não acontecer. As etiquetas enviadas pelo Novo Avanço viram lotes gravados no banco de dados e ficam lá até o Impressor buscá-los. Se a rede cair no meio do caminho, a solicitação não se perde: o lote continua disponível para ser impresso.

O Impressor envia a etiqueta direto para a impressora, sem precisar de driver do fabricante. Basta a impressora estar instalada no sistema operacional: no Windows como uma impressora comum (qualquer driver, inclusive "Generic / Text Only"), e no Linux como uma fila no CUPS.

1. Baixar e instalar

Downloads -> Impressor

No Novo Avanço, abra a rotina Downloads & Extensões e, no card Impressor, clique na versão do sistema operacional do computador:

🟦 Windows	Execute o instalador baixado (Impressor-production.exe) e siga as telas até o fim.
🐧 Linux	O arquivo baixado é um AppImage (Impressor-production.AppImage). Dê permissão de execução e abra o arquivo.

chmod +x Impressor-production.AppImage
./Impressor-production.AppImage

Ao abrir, o Impressor mostra a tela principal, ainda sem impressora nem acesso configurados:

2. Configurar

Impressor -> Configurações -> aba API / Impressão

Impressora

Escolha como o computador fala com a impressora:

• USB: a impressora está ligada neste computador. Selecione-a no campo Impressora.
• Rede (compartilhada): a impressora está ligada em outro computador da loja, que a compartilhou na rede. Informe o Computador ou IP desse computador (nunca localhost ou 127.0.0.1) e o nome do Compartilhamento, depois clique em Testar conexão. O compartilhamento precisa permitir acesso sem senha.

Acesso ao Novo Avanço

1. Em Acesso à API, clique em Configurar Acesso.
2. Informe o e-mail e a senha do usuário do cliente no Novo Avanço e clique em Autenticar.
3. Em Selecione a filial, clique na empresa/filial que vai imprimir as etiquetas. A lista mostra o número e o nome da loja, a razão social e o CNPJ.
4. Clique em Salvar configurações.

Com tudo certo, a seção mostra Autenticado com o e-mail usado, e os campos Ambiente API e Filial selecionada ficam preenchidos. O nome da filial também aparece no topo da tela principal.

Na aba Layouts ficam os modelos de etiqueta cadastrados no Novo Avanço. Confira se o layout certo está definido como ativo antes de imprimir.

3. Imprimir etiquetas

Há duas formas de imprimir.

Opção 1: direto pelo Impressor

1. Bipe o código de barras ou digite o EAN / código interno no campo Código EAN / Interno e tecle Enter. O produto entra na lista.
2. Ou digite parte da descrição e clique em Pesquisar. Nos resultados, clique no + do produto desejado ou em Adicionar todos.
3. Ajuste a Quantidade de etiquetas de cada produto, se precisar.
4. Clique em Imprimir.

Com o botão Autoimpressão ligado, o Impressor imprime a etiqueta assim que o produto é encontrado. É útil para bipar e imprimir na hora.

Opção 2: por lotes criados no Novo Avanço

Novo Avanço -> Produtos -> Imprimir Etiquetas

Esta forma usa a tela de Impressora V3 do Novo Avanço (parâmetro Impressora V3 ativo na conta).

1. No Novo Avanço, escolha o tipo de etiqueta (Gôndola ou Produto), adicione os produtos e clique em Incluir na lista.
2. Se quiser, preencha a Descrição do lote para achá-lo com facilidade no Impressor.
3. Clique em Salvar Lote. O sistema confirma com a mensagem "Lote N criado com sucesso".

Depois, no Impressor:

1. Clique em Buscar Lote.
2. Clique no lote desejado. Os produtos dele entram na lista.
3. Clique em Imprimir.

Adicional: configurações avançadas

Impressor -> Configurações -> aba Avançado

Calibração e gap entre etiquetas

Com Aplicar calibração de tamanho na impressão ligado, o Impressor informa à impressora o tamanho da etiqueta antes de cada impressão:

• Largura (mm) e Altura (mm): tamanho da etiqueta;
• Gap (mm): espaço entre uma etiqueta e outra no rolo.

Ajuste esses valores quando a impressora pular etiquetas, imprimir fora de posição ou ficar puxando papel sem parar. Desligue a opção se preferir usar a calibração que já está salva na memória da impressora. Clique em Salvar configurações ao terminar.

Diagnóstico

O botão Diagnóstico gera um relatório com o sistema operacional, a versão do Impressor, a configuração atual (ambiente, usuário, filial, impressora, calibração e layout ativo) e as impressoras detectadas. O relatório não inclui o token de acesso.

• Testar impressão: envia uma etiqueta de teste com a configuração atual;
• Copiar: copia o relatório completo.

Ao abrir um card de suporte sobre impressão, clique em Copiar e cole o relatório no card. Ele traz os detalhes que o time precisa para analisar o problema.