A app de impressão (SUNMI, USB, Android)

A zrsPOS Print é uma pequena app Android que transforma o próprio tablet no servidor de impressão. Corre em segundo plano, pergunta ao zrsPOS de poucos em poucos segundos se há talões e imprime-os na impressora que o tablet tiver. Nada fica exposto à internet e não é preciso mexer no router da loja.

Use-a quando a impressora está integrada no tablet, ligada a ele por USB, emparelhada com ele por Bluetooth, ou acessível na rede local a partir dele.

Em que impressoras imprime

• A impressora integrada de um POS Android SUNMI. A app fala com o serviço de impressão da própria SUNMI, por isso lê a largura real do papel no tablet e nunca adivinha.
• Uma impressora USB que siga a classe «impressora» do USB (interface 0x07) — a maioria das térmicas de 58 mm e 80 mm. Ligada ao tablet ou a uma pequena caixa Android.
• Uma impressora que carrega o tablet — uma impressora de talões com porta USB para tablets (por exemplo uma Epson TM-m30II-SL num suporte de tablet), em que a impressora alimenta o tablet pelo mesmo cabo. Precisa da zrsPOS Print 1.0.8 ou superior.
• Uma impressora Bluetooth emparelhada com o tablet nas definições do Android. Precisa da zrsPOS Print 1.0.9 ou superior.
• Uma impressora de rede na mesma rede local que aceite ESC/POS em bruto na porta 9100.

Tablets SUNMI

Qualquer tablet ou terminal Android SUNMI com impressora integrada funciona, porque a deteção passa pelo serviço de impressão da SUNMI e não por uma lista de modelos. Os mais comuns:

Não tem de dizer ao zrsPOS qual tem. Ao emparelhar, a app pergunta ao tablet o modelo e a largura do papel e envia os dois; o talão é formatado para essa largura.

Requisitos: Android 7.0 ou superior e acesso à internet no tablet.

Instalar a app

A app não está no Google Play. Descarregue-a em zrspos.com/downloads.

1. No tablet abra um navegador e vá a zrspos.com/downloads.
2. Carregue em Descarregar APK. O ficheiro é descarregado.
3. Abra o ficheiro descarregado. O Android pergunta se permite instalar apps desta origem — permita e carregue em Instalar. Nos tablets SUNMI esta permissão já costuma estar dada.
4. Abra a zrsPOS Print na lista de aplicações. Aparece o ecrã de emparelhamento.

A página de descargas serve sempre a versão mais recente e mostra o número da versão.

Atualizar a app

A app atualiza-se a partir do seu próprio ecrã; não precisa de descarregar nada outra vez.

1. Abra a zrsPOS Print e carregue em Procurar atualizações. Quando há uma versão nova, a app diz-o (e mostra também uma notificação).
2. Carregue em Atualizar para … (o botão indica a versão nova). A app descarrega-a e verifica-a.
3. Da primeira vez, o Android pede para permitir que esta app instale as suas atualizações: permita no ecrã que se abre, volte à app e carregue outra vez em Atualizar para …. O Android só pergunta uma vez.
4. Confirme Instalar no ecrã do Android. A impressão retoma sozinha depois, e o emparelhamento mantém-se.

Se a atualização falhar, a app diz porquê; tente outra vez, ou descarregue a versão mais recente em zrspos.com/downloads e instale por cima. O emparelhamento mantém-se em qualquer dos casos.

Emparelhar a app com a sua loja

Na administração Shopify:

1. Abra zrsPOS → Definições › Impressão e entrega › Impressoras e carregue em Adicionar impressora.
2. Em Como recebe os talões escolha App de impressão ou zrsPOS PrintBox e carregue em Seguinte.
3. Escolha a loja e um nome e carregue em Seguinte: código de emparelhamento. Aparece um QR, o nome da loja e um código de 6 dígitos. O código é válido 10 minutos e serve uma vez; a página conta os minutos e oferece um código novo quando acaba.

No tablet, na app zrsPOS Print:

1. Carregue em Ler o QR e aponte a câmara ao código no ecrã. A loja e o código preenchem-se sozinhos e o emparelhamento começa. Ou escreva-os à mão: Loja (asualoja.myshopify.com) e o código de 6 dígitos.
2. Nome deste dispositivo — opcional, por exemplo «Balcão 1». É o que vai ver na lista de impressoras.
3. Carregue em Emparelhar.

A app responde Emparelhado ✓ — n impressora(s) registada(s). Na administração Shopify o assistente mostra as impressoras encontradas em poucos segundos; termine o assistente e carregue em Imprimir um teste em … na página da impressora.

Se a app disser que o código é inválido ou expirou, gere um novo no assistente. Cada código serve uma vez.

Depois de emparelhar

O único ecrã da app mostra:

• o estado — «A imprimir para n impressora(s) — ligado ao zrsPOS» quando está tudo bem, ou a razão por que não consegue ligar-se;
• as impressoras que comanda, cada uma com o seu estado: pronta, sem papel, tampa aberta, inacessível, erro. O mesmo estado aparece na página da impressora no zrsPOS;
• Imprimir teste local — imprime uma amostra diretamente pelo controlador, sem passar pelo servidor. Serve para provar a impressora em si;
• Permitir funcionar em segundo plano (bateria) — aparece quando a otimização de bateria do Android mataria a app. Carregue e permita. Faça-o, ou a impressão pára com o ecrã apagado;
• Desemparelhar este dispositivo.

A app arranca sozinha quando o tablet (ou a caixa) liga e corre como serviço em primeiro plano, por isso há uma notificação permanente a dizer que está ligada. É essa notificação que impede o Android de a parar; não a desative.

De quanto em quanto tempo pergunta se há talões

Por predefinição a app pergunta ao zrsPOS se há trabalho a cada 2 segundos. Pode mudar isso na página da impressora no zrsPOS, em Pedir trabalho › Com que frequência (de cada segundo a cada 30 segundos). Aplica-se no contacto seguinte da app; não é preciso reinstalar nada. Mais curto faz os talões sair mais depressa; mais longo poupa a bateria e os dados numa loja com pouco movimento.

Impressoras USB

Uma Epson TM-m30, TM-T20 ou TM-T88, ou qualquer impressora de 58/80 mm da classe USB de impressoras, ligada a um tablet Android ou a um SUNMI. A impressora tem de ter alimentação própria (corrente); o tablet só transporta os dados.

1. O cabo. A impressora tem uma tomada USB-B. Num tablet com USB-C use um cabo USB-C para USB-B, ou um adaptador OTG USB-C mais um cabo A-para-B normal de impressora. Num SUNMI com USB-A, um cabo A-para-B simples.
2. Carregar o tablet. Com um cabo de impressora normal é o tablet que alimenta a porta USB, por isso, enquanto a impressora ocupa a única porta USB-C do tablet, o tablet não carrega. Para um balcão o dia inteiro use um hub USB-C com passagem de energia (os tablets Samsung aceitam um hub PD), um tablet com base de carregamento, ou uma impressora que carrega o tablet (secção seguinte).
3. Ligue o cabo, ligue a impressora. O Android pergunta Abrir a zrsPOS Print quando este dispositivo USB for ligado? — marque Utilizar por predefinição e permita. É toda a permissão necessária: fica memorizada para reinícios e para quando voltar a ligar o cabo. (Se a impressora já estava ligada quando instalou a app, abra a app uma vez; faz a mesma pergunta.)
4. A impressora aparece na lista da app em segundos; o agente regista-a sozinho no zrsPOS. Carregue em Imprimir teste local para confirmar e depois em Imprimir um teste em … na página da impressora na administração para confirmar o circuito completo.

A largura do papel de uma impressora USB não pode ser lida da impressora; as impressoras USB novas ficam registadas como 80 mm. Para uma de 58 mm, defina-a na página da impressora no zrsPOS, em Largura do papel.

Só Epson: se a impressora não for encontrada com o cabo e a corrente em ordem, o modo USB da impressora pode estar em vendor class da Epson em vez de printer class. A zrsPOS Print aceita os dois, mas firmware muito antigo não expõe nenhum — a app TM Utility da Epson mostra e altera a definição.

Impressoras que carregam o tablet

Algumas impressoras de talões têm uma porta USB para tablets e alimentam o tablet por ela — por exemplo uma Epson TM-m30II-SL num suporte de tablet. Aqui é a impressora que comanda o cabo, e o Android vê-a como um acessório USB e não como uma impressora USB. A zrsPOS Print 1.0.8 ou superior imprime nela.

1. Ligue o tablet à porta de tablet da impressora e ligue a impressora. O tablet começa a carregar.
2. O Android pergunta se quer abrir a zrsPOS Print para este acessório USB. Permita e marque Sempre (ou Utilizar por predefinição), se aparecer. Se o Android propuser outra app (o TM Assistant da Epson, por exemplo), limpe as predefinições dessa app nas definições do Android, desligue e volte a ligar o cabo, e escolha a zrsPOS Print.
3. A impressora aparece na lista da app. Carregue em Imprimir teste local e depois em Imprimir um teste em … na página da impressora na administração.

Só uma app pode usar a impressora por este cabo. Se o Shopify POS também tiver de imprimir na mesma impressora, dê-lhe a ligação de rede da impressora.

Impressoras Bluetooth

A zrsPOS Print 1.0.9 ou superior imprime numa impressora de talões emparelhada com o tablet por Bluetooth.

1. Emparelhe primeiro a impressora, em Definições do Android → Bluetooth, como qualquer acessório Bluetooth. A app não procura impressoras; usa as que já estão emparelhadas.
2. Abra a zrsPOS Print. Se aparecer Permitir Bluetooth (dispositivos próximos), carregue e permita. (Se o Android já não perguntar, a app explica: em Permissões, abra «Dispositivos próximos» e escolha Permitir.)
3. A impressora emparelhada aparece na lista da app e fica registada sozinha no zrsPOS. Carregue em Imprimir teste local e depois em Imprimir um teste em … na página da impressora na administração.

A app mantém a ligação Bluetooth à impressora aberta entre talões e fecha-a ao fim de 5 minutos sem imprimir. A maioria das impressoras de talões só aceita uma ligação Bluetooth de cada vez, por isso não partilhe essa impressora com outro tablet, nem com a impressão Bluetooth do próprio Shopify POS. Se o Shopify POS também precisar da impressora, ligue-a ao Shopify por rede ou USB.

Por baixo da lista de impressoras a app diz o que vê por Bluetooth: as impressoras emparelhadas, «não autorizado», «desligado» (ligue o Bluetooth nas definições rápidas) ou «nenhuma impressora emparelhada».

Resolver problemas

Remover um tablet ou uma caixa

Na página da impressora no zrsPOS (Definições › Impressão e entrega › Impressoras › a impressora), carregue em Desemparelhar a app de impressão. A app termina a sessão de vez: di-lo no contacto seguinte e nunca volta sozinha. As suas impressoras ficam guardadas, sem uso. Para voltar a imprimir com ela, emparelhe-a de novo com um código novo em Adicionar impressora.

No próprio tablet ou PrintBox, Desemparelhar este dispositivo na app termina a sessão desse lado; desemparelhe-a também no zrsPOS, para a administração deixar de contar com ela.

Apagar uma impressora também não a traz de volta: a app não a volta a adicionar. Apagar a última impressora em uso da app também termina a sessão da app.