Configurar a impressora da pizzaria: cupom, cozinha, etiqueta, USB e IP com o Aliv Agent
Do Aliv Agent até o cupom saindo sozinho: cadastrar impressoras de cupom e etiqueta, definir o que cada uma imprime por tipo e origem do pedido e acompanhar os PCs e as falhas.
A guia Impressoras liga o sistema às impressoras térmicas da pizzaria: o cupom do caixa, a comanda da cozinha e as etiquetas. Ela fica em Configurações › Lojas › Ajustes da loja › Impressoras. Quem imprime de verdade é o Aliv Agent, um programa que fica aberto no computador da loja e recebe os pedidos do sistema.
Impressão é o assunto que mais gera chamado, quase sempre por um detalhe de configuração. Este guia cobre a tela inteira, do vídeo de primeira configuração até as impressões que falharam.
Por que a impressão bem configurada importa
Na hora do pico, um cupom que não sai é um pedido que a cozinha não viu. Uma comanda com o cupom inteiro na impressora errada é papel jogado fora e confusão na bancada. Definindo certinho qual impressora é o caixa, qual é a cozinha e o que cada tipo de pedido imprime, o pedido sai no lugar certo sem ninguém precisar reimprimir à mão.
Passo a passo: instalar o Aliv Agent e cadastrar a impressora
- Vídeo de primeira configuração. O primeiro quadro da guia é um vídeo curto com o passo a passo: baixar o agente, achar o nome ou o IP da impressora, cadastrar e ligar a impressão automática. O botão Assistir abre o vídeo sem sair da tela, e o botão Como configurar abre o mesmo vídeo.
- Baixar ALIV Agent. A janela mostra seis passos: extrair a pasta do arquivo zip num lugar seguro (evite a pasta Downloads, que costuma ser limpa), dar dois cliques em INSTALAR.bat para o agente abrir junto com o Windows, abrir o ALIV Agent, colar o código da loja que aparece na janela, copiar no agente o nome exato da impressora e cadastrar em Nova Impressora. O botão Baixar ZIP baixa o programa.
- Achar o nome ou o IP. Impressora ligada por USB usa o nome que aparece no Windows, exatamente igual; copie e cole em vez de digitar. Impressora de rede usa o IP dela.
- Nova Impressora. Dê um apelido (Caixa, Cozinha, Bar), escolha a conexão Windows ou IP (Rede), preencha o nome no Windows ou o IP e clique em Adicionar. A impressora aparece na lista, já salva.
A regra que mais gera dúvida: impressoras por IP na rede são atendidas por um agente só, em qualquer computador da mesma rede. Impressora USB precisa de um agente aberto no computador onde ela está ligada.
O cartão de cada impressora
- Apelido, Conexão e Nome no Windows ou IP: os dados do cadastro, que podem ser corrigidos ali mesmo. As mudanças salvam sozinhas.
- Ativa: liga e desliga a impressora sem apagar o cadastro.
- Cupom Principal (Caixa): recebe o pedido completo. Sem nenhuma marcada, o sistema usa a primeira impressora ativa da lista como caixa e mostra um aviso.
- Expedição (KDS): recebe os pedidos finalizados no KDS.
- Nº de Vias: quantas cópias saem.
- Fundo preto no destaque: bebida e observação saem com fundo preto e letra branca. Se a impressora imprimir letras estranhas, desmarque e o destaque vira só negrito.
- Largura: 48 colunas para bobina de 80mm (padrão), 42 colunas para 80mm com letra maior e 32 colunas para 58mm. Se as linhas tracejadas quebram ou o total sai em duas linhas, escolha uma largura menor.
- Acentuação: PC850 (padrão) ou PC1252 (Windows). Troque quando ç, ã e é saem errados.
- Vinculada ao PC: prende a impressora a um computador com o agente. Em Automático, o sistema acha o computador pelo nome ou pelo IP da impressora.
- O que imprimir por tipo de pedido: para Delivery, Balcão, Mesa e Comanda, escolha Cupom Completo, Só Cozinha, Cupom + Cozinha ou Não Imprimir. Sem escolha vale o padrão: a principal imprime o cupom completo e as outras só os itens das categorias que mandam para elas. Escolher cupom completo numa impressora que não é a principal mostra um aviso, porque o cupom inteiro não sai nela. Em Cupom + Cozinha, a impressora que tem categoria apontando para ela só imprime a via da cozinha quando o pedido tem item dessas categorias; sem nenhuma categoria apontando, a via sai com o pedido inteiro.
- Lixeira: exclui a impressora, com autorização e senha de um responsável.
Etiquetas, origem do pedido e segurança
- Impressoras de Etiqueta: cada uma tem apelido, nome no Windows e IP opcional. Os botões de setor ligam os setores do KDS que imprimem nela, a opção Padrão vale quando não há vínculo, e Vincular a ESTE PC faz este computador imprimir nela (desvincular desfaz). Na hora de imprimir, o KDS ainda deixa trocar a impressora.
- Comprovante do totem: um atalho lembra que a impressora do totem é escolhida no controle do totem.
- Roteamento por Origem do Pedido: para iFood, Anota AI, Aiqfome, 99Food, DeliveryLab, Wabiz, Cardápio Web, app próprio e PDV (balcão, mesa e comanda). Origem Ativa imprime só nas impressoras definidas ali, ignorando a categoria; cada destino tem impressora e modo (cupom inteiro, só itens de cozinha ou não imprime). Desativada, segue o roteamento normal, por categoria.
- Código de pareamento do Aliv Agent: os cupons levam telefone e endereço do cliente. Desligado, qualquer computador que saiba o código da loja conecta. Ligado com Gerar código, só o Aliv Agent 2.1.5 ou mais novo com o código digitado conecta. O código aparece escondido, com botão para mostrar e Copiar; Trocar código desconecta quem tem o antigo e Desligar pareamento volta ao comportamento anterior.
- PCs de Impressão (Agents): cada computador com o agente aparece ao vivo, online ou offline, com a versão, a última comunicação, as impressoras que ele enxerga e a fila (na fila e imprimindo). O botão Atualizar recarrega, e a lista também se atualiza sozinha.
- Impressões que Falharam: cupons que não saíram depois de várias tentativas, com o número do pedido, a impressora e as tentativas. Reimprimir devolve para a fila e a lixeira descarta.
O agente precisa ficar aberto. Pode minimizar, mas se fechar o programa, o cupom para de sair. Se a impressão parou, confira primeiro se o agente está online em PCs de Impressão.
Como atualizar o Aliv Agent para a versão nova
A versão aparece no topo da janela do agente e em PCs de Impressão, nesta guia. Atualize em cada computador que tem o agente. A impressão para por cerca de um minuto, então evite o meio do movimento. Nenhuma configuração da loja é apagada.
Jeito 1: pelo botão do agente (versão 2.0.7 ou mais nova).
- Perto do relógio do Windows, abra a setinha, clique com o botão direito no ícone do Aliv Agent e escolha Abrir Painel.
- No aviso amarelo Atualização disponível, clique em Atualizar agora. Se o aviso não aparecer, clique em Verificar atualização.
- Confirme em OK e não feche a janela. O agente fecha e abre sozinho.
- Abra o painel de novo: o topo mostra a versão nova e o status CONECTADO. Depois use Solução de problemas e Imprimir teste aqui na guia.
Jeito 2: pelo corretor (versão mais antiga que a 2.0.7, ou agente que fechou e não voltou).
- No computador da impressora, abra app.alivhub.com.br/agente/corrigir no navegador. Se ele avisar sobre o arquivo, escolha Manter.
- Dê dois cliques no arquivo CORRIGIR_AGENTE.bat. Se aparecer "O Windows protegeu o computador", clique em Mais informações e Executar assim mesmo. Na tela preta, aperte uma tecla para começar.
- Ele acha a pasta do agente, limpa a atualização que ficou pela metade e abre o programa. Espere aparecer PRONTO.
- Espere cerca de dois minutos: nas versões antigas o agente baixa a nova, fecha e abre sozinho. Confira a versão no painel e use Imprimir teste.
Jeito 3: instalando o ZIP por cima (quando os outros não resolvem).
- No computador da impressora, baixe o ZIP em Baixar ALIV Agent › Baixar ZIP, nesta guia, ou em app.alivhub.com.br/agente/baixar.
- Aperte Ctrl + Shift + Esc, clique com o botão direito em AlivPrintAgent e escolha Abrir local do arquivo. Deixe essa pasta aberta: é nela que o agente está instalado.
- Clique com o botão direito no ícone do agente perto do relógio e escolha Sair Totalmente. Se houver uma janela preta ALIV PRINT AGENT na barra de tarefas, feche também.
- Clique com o botão direito no ZIP, escolha Extrair tudo, clique em Procurar e aponte para a pasta do passo 2. Se o Windows perguntar, escolha Substituir os arquivos no destino. Usar a mesma pasta mantém o código da loja e a identificação do computador.
- Nessa pasta, dê dois cliques em INSTALAR.bat e espere aparecer PRONTO. Se o Windows reclamar, clique em Mais informações e Executar assim mesmo.
- Abra o painel do agente, confira a versão e o status CONECTADO e use Imprimir teste.
Solução de problemas: quando a impressora não imprime
No topo da lista de impressoras fica o botão Solução de problemas. Clique nele quando um cupom não sair. O sistema verifica na hora os computadores da loja, as impressoras cadastradas e as últimas tentativas de impressão, e mostra cada problema com o motivo e o que fazer.
- Computador aberto que não recebe os cupons: o Aliv Agent perdeu a identificação depois de uma queda de conexão. Clique em Sair no programa e abra de novo.
- Impressora que não existe em nenhum computador: o nome no campo Nome no Windows ou IP não bate com o Windows. Quando o nome é quase igual, o botão Usar o nome certo corrige. O apelido pode ser qualquer um.
- Impressora em computador fechado: ligue esse computador e abra o Aliv Agent. Se ele não abrir ou não conectar, abra app.alivhub.com.br/agente/corrigir nesse computador e dê dois cliques no arquivo baixado: ele acha o programa e abre de novo.
- Impressora de rede sem responder: confira se está ligada, o cabo de rede e se o IP mudou.
- Cupom recebido que não imprime: o problema está no Windows ou na impressora. Veja a fila de impressão, se ela não está pausada ou offline, o papel e o cabo.
- Impressora cadastrada duas vezes: cada cupom pode sair em dobro. O botão Excluir tira o cadastro repetido.
Depois, use Imprimir teste na linha da impressora para mandar um cupom curto. O sistema mostra se ela aceitou o teste e pergunta se o papel saiu, porque ele não enxerga o papel nem o cabo. Se não saiu, a tela mostra o que conferir no computador. Com o problema resolvido, clique em Verificar de novo.
Ligação com outras partes do sistema
A impressão automática é ligada na guia Operacional, em Auto-Print da Via do CAIXA, Auto-Print da Via da COZINHA e Auto-Print KDS (Expedição). A impressora de cozinha de cada categoria é escolhida no cadastro de categorias do Cardápio. Os pedidos do iFood e das outras integrações seguem o Roteamento por Origem quando ele está ativo, e o KDS usa as impressoras de etiqueta ligadas aos seus setores.
Perguntas frequentes
O sistema voltou, mas a impressora não imprime. Como faz a impressora voltar?
Depois de uma queda do sistema, o Aliv Agent reconecta e as comandas que ficaram paradas saem sozinhas. Se nada sair, feche e abra o Aliv Agent no computador da impressão e desligue a impressora por 10 segundos. Não precisa reinstalar o programa nem trocar a impressora: a falha foi do sistema, não do seu computador.
Preciso de um Aliv Agent em cada computador?
Depende da impressora. Impressoras de rede, cadastradas por IP, são atendidas por um agente só, em qualquer computador da mesma rede. Impressora USB precisa de um agente aberto no computador onde ela está ligada fisicamente.
Uma pizza do pedido não saiu na via da cozinha junto com as outras. Por quê?
Ela foi para a outra impressora. Cada item segue a impressora da categoria dele, e pizza montada pela IA pode vir pela categoria de sabores. Se essa categoria está sem impressora, o item vai para outra cozinha. No Cardápio, edite as categorias de sabores e, em Impressora, escolha a mesma das pizzas. Faça o mesmo nas categorias de promoção e de bebidas, porque categoria sem impressora muda de destino conforme o resto do pedido.
A via da cozinha saiu com itens que não são daquela impressora. O que faço?
Veja o modo Cupom + Cozinha e as categorias. Se nenhuma categoria aponta para essa impressora, a via sai com o pedido inteiro. Se alguma aponta, a via só sai com itens dessas categorias. Para separar, edite cada categoria no Cardápio e escolha a Impressora certa. Como uma categoria aponta para uma impressora só, promoção de pizza e promoção de lanche ficam em categorias separadas.
A nota fiscal está imprimindo só na cozinha. Como mudo?
A nota fiscal sai na impressora marcada como Cupom Principal (Caixa). Em Configurações, Lojas, Ajustes da loja, Impressoras, desmarque essa opção na impressora da cozinha e marque na impressora onde a nota deve sair. O cupom completo acompanha essa marcação: confira em O que imprimir por tipo de pedido se a cozinha continua recebendo a comanda dela.
Por que o cupom completo não sai na impressora da cozinha?
Porque o cupom completo sai na impressora marcada como Cupom Principal (Caixa). Nas outras, o padrão é imprimir só os itens das categorias que mandam para elas. Para uma impressora imprimir o pedido inteiro, marque Cupom Principal no cartão dela.
No sistema saiu 1 borda e na comanda saíram 2. Qual está certo?
O que vale é o pedido na tela do sistema: ali está o que o cliente escolheu e pagou. Na comanda de combo, a borda ou outro item podia sair uma segunda vez no fim do item, colado no último sabor, sem o cliente ter pedido a mais. Isso foi corrigido. Se ainda aparecer repetido, confira o pedido na tela antes de montar e mande a foto da comanda para o suporte.
A acentuação sai trocada no cupom. O que faço?
No cartão da impressora, troque a Acentuação entre PC850 e PC1252. Se aparecerem letras estranhas no destaque de bebidas e observações, desmarque Fundo preto no destaque. E se as linhas quebram, escolha uma Largura menor.
Como atualizar o Aliv Agent para a versão nova?
No computador da impressora: 1) Perto do relógio do Windows, clique com o botão direito no ícone do Aliv Agent e escolha Abrir Painel. 2) No aviso amarelo, clique em Atualizar agora; se ele não aparecer, clique em Verificar atualização. 3) Confirme em OK e não feche a janela: o agente fecha e abre sozinho. 4) Abra o painel, confira a versão nova no topo e o status CONECTADO. 5) No sistema, em Impressoras, use Solução de problemas e Imprimir teste. Em versão mais antiga que a 2.0.7 esse botão não existe: use o corretor em app.alivhub.com.br/agente/corrigir.
O Aliv Agent fechou sozinho depois de atualizar e parou de imprimir. O que faço?
No computador da impressora: 1) Abra app.alivhub.com.br/agente/corrigir no navegador; se ele avisar sobre o arquivo, escolha Manter. 2) Dê dois cliques em CORRIGIR_AGENTE.bat; se aparecer que o Windows protegeu o computador, clique em Mais informações e Executar assim mesmo. 3) Aperte uma tecla na tela preta e espere aparecer PRONTO: ele acha a pasta, limpa a atualização pela metade e abre o agente. 4) Espere cerca de dois minutos, porque nas versões antigas ele ainda baixa a nova, fecha e abre sozinho. 5) No sistema, em Impressoras, use Solução de problemas e Imprimir teste.
Como baixar e instalar o Aliv Agent num computador novo?
No computador da impressora: 1) Baixe o ZIP em Impressoras › Baixar ALIV Agent › Baixar ZIP, ou em app.alivhub.com.br/agente/baixar. 2) Clique com o botão direito no ZIP, escolha Extrair tudo e use uma pasta fixa, como C:\AlivAgent, nunca Downloads. 3) Na pasta, dê dois cliques em INSTALAR.bat; se o Windows reclamar, clique em Mais informações e Executar assim mesmo. Espere aparecer PRONTO. 4) Perto do relógio, clique com o botão direito no ícone do agente e escolha Abrir Painel. 5) Em Slug da Loja, cole o código da loja que aparece na janela Baixar ALIV Agent e clique em Salvar Configuração. Se a loja ligou o código de pareamento, digite ele também. 6) Copie no agente o nome exato da impressora. 7) No sistema, clique em Nova Impressora, cole o nome e adicione. 8) Use Imprimir teste.
Como instalar a versão nova do Aliv Agent por cima da antiga, pelo ZIP?
Use quando o botão e o corretor não resolverem. 1) Baixe o ZIP em Impressoras › Baixar ALIV Agent › Baixar ZIP, ou em app.alivhub.com.br/agente/baixar. 2) Aperte Ctrl + Shift + Esc, clique com o botão direito em AlivPrintAgent e escolha Abrir local do arquivo; deixe essa pasta aberta. 3) Clique com o botão direito no ícone do agente perto do relógio e escolha Sair Totalmente. Se houver uma janela preta ALIV PRINT AGENT, feche também. 4) Clique com o botão direito no ZIP, escolha Extrair tudo, clique em Procurar e aponte para a pasta do passo 2; se o Windows perguntar, escolha Substituir os arquivos no destino. 5) Nessa pasta, dê dois cliques em INSTALAR.bat e espere aparecer PRONTO. 6) Abra o painel do agente, confira a versão e o status CONECTADO e use Imprimir teste. A mesma pasta mantém o código da loja e a identificação do computador.
Como sei qual versão do Aliv Agent está no meu computador?
A versão aparece no topo da janela do agente: clique com o botão direito no ícone perto do relógio e escolha Abrir Painel. No sistema, ela aparece em Impressoras › PCs de Impressão, para cada computador.
O Aliv Agent está fechado e não consigo imprimir. Como abro de novo?
No computador da impressora: 1) Perto do relógio do Windows, abra a setinha e procure o ícone do Aliv Agent. Se ele estiver lá, clique com o botão direito, escolha Abrir Painel e confira o status CONECTADO. 2) Se o ícone não estiver lá, ou o programa não conectar, abra app.alivhub.com.br/agente/corrigir no navegador; se ele avisar sobre o arquivo, escolha Manter. 3) Dê dois cliques em CORRIGIR_AGENTE.bat; se aparecer que o Windows protegeu o computador, clique em Mais informações e Executar assim mesmo. Aperte uma tecla na tela preta e espere aparecer PRONTO: ele acha o programa e abre de novo. 4) Se ele disser que não encontrou o programa, faça isso no computador certo, normalmente o do caixa, ou instale o Aliv Agent. 5) No sistema, em Impressoras, use Solução de problemas e Imprimir teste.
O que é o código de pareamento do Aliv Agent?
É uma proteção dos cupons, que levam telefone e endereço do cliente. Com o código ligado, só conecta como impressora o Aliv Agent 2.1.5 ou mais novo que tiver o código digitado. Sem ele, qualquer computador que saiba o código da loja conecta.
Minha impressora não está imprimindo. Como descubro o motivo?
Na guia Impressoras, clique em Solução de problemas. O sistema verifica os computadores, as impressoras cadastradas e as últimas tentativas, e mostra o motivo e como resolver. Depois, use Imprimir teste na impressora para confirmar.
O Aliv Agent está aberto, conectado, e o cupom nem chega nele. O que fazer?
Clique em Solução de problemas na guia Impressoras. Se aparecer que o computador está aberto, mas não está recebendo os cupons, clique em Sair no Aliv Agent e abra de novo. Só fechar a janela ou salvar a configuração não resolve.
O cupom está saindo em dobro. Por quê?
O mais comum é a mesma impressora estar cadastrada duas vezes como Cupom Principal, às vezes com o nome escrito de outro jeito. A Solução de problemas aponta o cadastro repetido e oferece o botão para excluir.
Um pedido não imprimiu. Como reimprimo?
Os cupons que falharam depois de várias tentativas aparecem em Impressões que Falharam, no fim da guia, com o número do pedido e a impressora. O botão Reimprimir manda de novo para a fila do agente.