Instalar o agente de impressão e a impressora

O Separa Aí roda na internet e não enxerga a impressora ligada no computador da loja. O agente de impressão é um programa pequeno que fica nesse computador e manda as etiquetas para a impressora térmica, sem passar pela janela de impressão do navegador. Aqui você instala o agente, escolhe o modelo da impressora e imprime o teste.

Antes de começarCopiar link da seção

Disponível em todos os planos (Essentials, Advanced e Pro Max).

• Só o administrador abre Configurações › Impressora. Para os outros usuários, a tela diz Só o administrador mexe na impressora.
• Você precisa de um computador com Windows ligado à impressora térmica, com a impressora já instalada no Windows (ela aparece em Impressoras e scanners). O agente não existe para Mac.
• Faça tudo nesse computador, no Chrome ou no Edge. Safari e Firefox não conseguem falar com o agente.
• A impressora precisa entender uma destas duas linguagens: PPLA (o padrão da Argox) ou ZPL (Zebra, Elgin ou Argox no modo PPLZ).
• A instalação pede permissão de administrador do Windows e leva uns dois minutos.

Passo a passoCopiar link da seção

Acertar a calibraçãoCopiar link da seção

A etiqueta de teste sai com "Etiqueta de teste", o preço R$ 99,90 e o código TESTE01, no tamanho e no formato da etiqueta salva em Configurações › Etiqueta. Compare com uma etiqueta do rolo e ajuste em Calibração:

• Intensidade: quanto a impressão escurece, de mais claro a mais escuro. Vai até 20 na Argox e até 30 na ZPL.
• Para a direita e Para baixo: empurram a impressão em milímetros, de meio em meio. Número negativo puxa para a esquerda ou para cima.
• Barra fina: a espessura das barras do código, de 1 a 4. Com 1, o código fica mais compacto.

O Imprimir teste usa a calibração que está na tela, mesmo antes de salvar. Quando ficar bom, toque em Salvar impressora.

Escolher outra impressoraCopiar link da seção

O agente usa a impressora padrão do Windows. Se o computador tem mais de uma impressora e a de etiquetas não é a padrão, você pode fixar a de etiquetas no agente:

1. No menu Iniciar, digite PowerShell, clique com o botão direito em Windows PowerShell e escolha Executar como administrador.

2. Entre na pasta onde está o consig-print-agent.exe e liste as impressoras instaladas. Se você extraiu em C:\ConsigAgente, os comandos são:

   Copiar texto

   cd C:\ConsigAgente\consig-print-agent
   .\consig-print-agent.exe -list

3. Copie o nome exato da impressora de etiquetas e rode o instalador com ele, entre aspas (troque o nome do exemplo):

   Copiar texto

   powershell -ExecutionPolicy Bypass -File .\instalar-agente.ps1 -Impressora "Argox OS-214 plus"

O agente reinicia já com a impressora escolhida, e ela continua fixada nas próximas atualizações feitas na mesma pasta.

O que acontece depoisCopiar link da seção

• O agente liga sozinho junto com o Windows e fica rodando em segundo plano. Não precisa abrir nada antes de imprimir.
• A tela Etiquetas passa a mostrar o botão Imprimir nesse computador. Veja Imprimir etiquetas.
• Aberto em outro computador ou no celular, o Separa Aí avisa em Configurações que o agente de impressão não respondeu. É esperado: ali as etiquetas saem em PDF.

Perguntas comunsCopiar link da seção

A impressora não imprime. O que confiro?Copiar link da seção

Na tela Impressora, no computador ligado à impressora, a coluna Neste computador mostra o que falta: o agente encontrado, o navegador (Chrome ou Edge), o Windows e a escolha salva. Com tudo certo, confira se a impressora está ligada, com papel, e se é a impressora padrão do Windows (ou fixe a certa, como em "Escolher outra impressora").

Instalei, mas o agente continua "não encontrado"Copiar link da seção

Espere uns segundos e toque em Procurar agora. Se o Chrome ou o Edge perguntar se o Separa Aí pode acessar dispositivos da rede local, permita: é assim que a página fala com o agente. Se não resolver, abra o Agendador de Tarefas do Windows e veja se a tarefa ConsigPrintAgent está em execução. Se não estiver, clique nela com o botão direito e escolha Executar. Reiniciar o computador também resolve, porque o agente liga junto com o Windows.

O antivírus bloqueou ou apagou o agenteCopiar link da seção

Restaure o arquivo consig-print-agent.exe pela quarentena do antivírus, coloque a pasta do agente nas exceções dele e abra o instalar.cmd de novo.

A etiqueta de teste saiu em branco ou com caracteres estranhosCopiar link da seção

A linguagem está trocada. Em Modelo da impressora, troque entre Argox e Zebra, Elgin ou Argox em PPLZ e imprima o teste de novo. Na dúvida, comece pela Argox.

A etiqueta sai fora do lugar, clara ou com o código de barras grande demaisCopiar link da seção

Ajuste em Calibração: Para a direita e Para baixo mudam a posição, Intensidade escurece e Barra fina em 1 deixa o código mais compacto. Se o problema é o tamanho da etiqueta ou o que sai nela, o ajuste fica em Modelo da etiqueta.

Funciona no Mac?Copiar link da seção

O agente só existe para Windows. No Mac, no celular ou no tablet, use Gerar PDF na tela Etiquetas e imprima pela janela de impressão.

Qual impressora de etiquetas comprar?Copiar link da seção

Uma térmica de etiquetas que fale PPLA ou ZPL: a tela traz as opções Argox, Zebra e Elgin. Antes de comprar, confira com o vendedor se ela imprime em PPLA ou ZPL e se tem driver para Windows. Para joias e bijuterias, use o rolo de rabo de rato.

Em outro computador ou no celular não imprime diretoCopiar link da seção

É esperado. O agente atende só o computador onde foi instalado. Nos outros, a tela Etiquetas oferece o PDF. Para imprimir direto em mais de um computador, instale o agente em cada um que tiver uma térmica ligada.

Como atualizar o agente?Copiar link da seção

O agente fica rodando, e o Windows não deixa trocar um programa em uso. Por isso, pare o agente antes:

1. Baixe o arquivo de novo em Configurações › Impressora.

2. Abra o PowerShell como administrador (como em "Escolher outra impressora") e rode:

   Copiar texto

   Disable-ScheduledTask ConsigPrintAgent
   Stop-ScheduledTask ConsigPrintAgent

3. Extraia o arquivo novo para a mesma pasta em que você extraiu da primeira vez (C:\ConsigAgente, se seguiu o passo a passo; não a consig-print-agent de dentro dela) e, quando o Windows perguntar, escolha substituir os arquivos.

4. Abra o instalar.cmd da pasta consig-print-agent. Ele registra e liga o agente de novo, já na versão nova.

Extraindo na mesma pasta, a impressora escolhida continua a mesma. Numa pasta nova, o agente volta para a impressora padrão do Windows.

Como removo o agente?Copiar link da seção

Abra o PowerShell como administrador e rode, trocando a pasta se você extraiu em outro lugar:

cd C:\ConsigAgente\consig-print-agent
powershell -ExecutionPolicy Bypass -File .\desinstalar-agente.ps1
cd \

Depois feche o PowerShell e apague a pasta C:\ConsigAgente.

RelacionadosCopiar link da seção

• Imprimir etiquetas: montar o lote e imprimir.
• Modelo da etiqueta: o formato, as medidas e o que sai impresso.