Skip to main content

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

Downloads - Impressor

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

Tela principal do Impressor

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
      Em construção.Acesso à API, clique em Configurar Acesso. Informe o e-mail e a senha do usuário do cliente no Novo Avanço e clique em Autenticar. 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. Clique em Salvar configurações.

      Configurar acesso com e-mail e senha

      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.

      Impressor configurado e autenticado

      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
        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. Ou digite parte da descrição e clique em Pesquisar. Nos resultados, clique no + do produto desejado ou em Adicionar todos. Ajuste a Quantidade de etiquetas de cada produto, se precisar. Clique em Imprimir.

        Busca por descrição

        Produtos na lista para impressão

        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).

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

          Criação de lote no Novo Avanço

          Depois, no Impressor:

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

            Selecionar lote no Impressor

            Lote carregado no Impressor

            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.

              Aba Avançado com calibração e gap

              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.

                Relatório de diagnóstico