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

A zrsPOS Print é uma pequena app Android que transforma o próprio dispositivo POS 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 dispositivo tiver. Nada fica exposto à internet e não é preciso mexer no router da loja.

Use-a quando a impressora está integrada no dispositivo POS, ligada a ele por USB, 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 dispositivo 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 dispositivo POS ou a uma pequena caixa Android.
• Uma impressora de rede na mesma rede local que aceite ESC/POS em bruto na porta 9100.

Dispositivos SUNMI

Qualquer dispositivo 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 dispositivo 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 dispositivo.

Instalar a app

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

1. No dispositivo POS 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 dispositivos 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. Para atualizar, descarregue outra vez e instale por cima; o emparelhamento mantém-se.

Emparelhar a app com a sua loja

Na administração Shopify:

1. Abra zrsPOS → Guia de configuração → 7. Impressoras.
2. Carregue em Adicionar impressora.
3. Em Ligação escolha App de impressão — no dispositivo POS ou na caixa zrsPOS.
4. Carregue em Gerar o 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.

No dispositivo POS, 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 teste 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 dispositivo 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.

Impressoras USB

1. Ligue a impressora ao dispositivo POS (uma porta USB-A, ou um adaptador OTG num tablet) e ligue-a à corrente.
2. Abra a zrsPOS Print. O Android pergunta Permitir que a zrsPOS Print aceda ao dispositivo USB? — marque «sempre» e permita. Nada é detetado enquanto não o fizer.
3. A impressora aparece na lista da app. Se já estiver emparelhado, carregue em Imprimir teste local para confirmar e emparelhe outra vez (ou use Adicionar impressora no assistente) para a nova impressora ficar registada no zrsPOS.

A largura do papel de uma impressora USB não pode ser lida do dispositivo. Defina-a na página da impressora no zrsPOS, em Largura do papel.

Resolver problemas

Remover um dispositivo

Carregue em Desemparelhar este dispositivo na app e apague a impressora em Guia de configuração → 7. Impressoras. Apagar a impressora na administração também revoga a app: ela indica-o no contacto seguinte.