Impressão na Nuvem
A impressão na nuvem permite que o WCPOS envie recibos para uma impressora que não está diretamente conectada ao dispositivo que executa o caixa. Configure uma vez no WP Admin e seus pedidos são impressos em uma impressora da cozinha, uma impressora do escritório ou uma impressora em outra sala — sem que cada dispositivo precise descobrir e parear com o hardware individualmente.
O que é impressão na nuvem?
Com a impressão local, o dispositivo que executa o POS se comunica diretamente com a impressora via USB, Bluetooth ou rede local. Essa é a escolha certa quando a impressora fica ao lado do caixa — consulte Configuração de Impressoras para conectar impressoras USB, Bluetooth e de rede no mesmo dispositivo.
A impressão na nuvem é para todo o resto: uma impressora em um local diferente, em uma rede diferente, ou uma que você queira que todos os dispositivos compartilhem sem configurá-la em cada um. Existem dois modelos de entrega:
- Impressoras por sondagem (polling). A impressora consulta o WCPOS pela internet em intervalos programados, pergunta "você tem algo para mim?" e baixa quaisquer trabalhos pendentes. O WCPOS nunca se conecta à impressora — a impressora sempre inicia a conversa. É assim que funcionam o Star CloudPRNT e o Epson Server Direct Print.
- Provedores de relé hospedado. O WCPOS envia o trabalho de impressão para um serviço hospedado, e esse serviço o entrega à impressora. É assim que funcionam o Star Online e o PrintNode. O Star Online entrega para impressoras Star CloudPRNT registradas na sua conta stario.online; o PrintNode entrega através do seu cliente de desktop para praticamente qualquer impressora na qual aquele computador já consiga imprimir.
Uma impressora por sondagem não precisa de uma porta aberta, um IP estático ou qualquer alteração de firewall — ela apenas faz solicitações de saída. Isso a torna ideal para uma impressora em um local remoto ou atrás de um roteador que você não controla. A contrapartida é um pequeno atraso: a impressora só imprime quando chega sua próxima sondagem.
Escolhendo um provedor
Escolha o provedor que corresponde ao seu hardware.
Star CloudPRNT
Para impressoras térmicas Star executando o firmware CloudPRNT. A impressora faz sondagem no WCPOS e baixa os trabalhos. Os recibos são renderizados nos comandos nativos da impressora. Requer um modelo térmico.
Star Online
Para impressoras Star registradas em uma conta stario.online. O WCPOS envia Star Document Markup para o serviço hospedado da Star, e a impressora o coleta do Star Online. Requer um modelo térmico.
Epson Server Direct Print
Para impressoras Epson ePOS que suportam Server Direct Print. A impressora faz sondagem no WCPOS e baixa os trabalhos como ePOS-Print XML. Requer um modelo térmico.
PrintNode
Funciona com praticamente qualquer impressora na qual seu computador consiga imprimir, em qualquer sistema operacional, através do cliente de desktop PrintNode. O WCPOS envia um PDF, então você pode usar qualquer modelo — incluindo faturas HTML de página inteira.
| Provedor | Hardware | Como os trabalhos fluem | Modelos |
|---|---|---|---|
| Star CloudPRNT | Impressora térmica Star com firmware CloudPRNT | A impressora faz sondagem no WCPOS | Apenas térmico |
| Star Online | Impressora Star registrada em stario.online | O WCPOS envia Star Document Markup ao Star Online | Apenas térmico |
| Epson Server Direct Print | Impressora Epson ePOS com Server Direct Print | A impressora faz sondagem no WCPOS | Apenas térmico |
| PrintNode | Qualquer impressora conectada ao SO + cliente PrintNode | O WCPOS envia um PDF ao PrintNode | Qualquer modelo |
Configurando uma impressora na nuvem
As impressoras na nuvem são configuradas uma vez no WP Admin e compartilhadas em todos os dispositivos — diferentemente das impressoras locais, que são armazenadas por dispositivo.
Acesse WP Admin > POS > Settings > Cloud Print e clique em Add printer. Dê a ela um nome (por exemplo, "Cozinha" ou "Escritório"). O WCPOS deriva automaticamente um ID de impressora estável a partir da impressora — ele nunca muda, então é seguro referenciá-lo a partir da configuração de firmware de uma impressora.
Depois que a impressora existir, configure o lado do provedor.
Star ou Epson (impressoras por sondagem)
Adicione a impressora no WCPOS
Em WP Admin > POS > Settings > Cloud Print, adicione uma impressora e escolha Star CloudPRNT ou Epson Server Direct Print como provedor. O WCPOS gera uma URL de sondagem e um token de uso único para aquela impressora.
Copie a URL de sondagem e o token
Copie a URL de sondagem e o token gerados. O token é exibido apenas uma vez — se você perdê-lo, gere um novo a partir do cartão da impressora e atualize a impressora com o novo valor.
Insira-os na configuração da impressora
Abra a página de configuração da impressora — as configurações CloudPRNT para a Star ou as configurações Server Direct Print para a Epson — e cole a URL de sondagem e o token. Defina o intervalo de sondagem se a impressora solicitar um (alguns segundos é o típico). Salve e reinicie a impressora, se necessário.
Dentro de um ciclo de sondagem, a impressora se registra e seu status no WCPOS muda de Waiting para Connected.
PrintNode
Instale o cliente de desktop PrintNode
Em um computador que já consiga imprimir na sua impressora de destino, instale o cliente PrintNode e faça login. O cliente deve permanecer em execução e online para que os trabalhos sejam impressos.
Obtenha uma chave de API do PrintNode
Na sua conta PrintNode, crie uma chave de API. É isso que permite ao WCPOS enviar trabalhos para sua conta PrintNode.
Insira a chave de API no WCPOS
Adicione uma impressora em WP Admin > POS > Settings > Cloud Print, escolha PrintNode como provedor e cole a chave de API. O WCPOS a utiliza para buscar a lista de impressoras registradas na sua conta PrintNode.
Selecione a impressora
Escolha a impressora de destino na lista de impressoras informadas pelo cliente PrintNode e salve. O WCPOS enviará trabalhos para esta impressora ao PrintNode, e o cliente os imprimirá.
Star Online
Use o Star Online quando sua impressora Star já estiver registrada em uma conta stario.online e você quiser que o serviço hospedado da Star cuide da entrega.
Obtenha a URL do CloudPRNT
No stario.online, abra Device Groups e copie a CloudPRNT URL do grupo. Ela deve ter a aparência de https://device.stario.online/cloudprnt/... ou https://eu-device.stario.online/cloudprnt/....
Crie uma chave de API com permissões
No stario.online, crie uma chave de API para o WCPOS. A chave deve ter permissão para listar dispositivos e imprimir neles. No mínimo, habilite:
- EnumDevices — necessário quando o WCPOS busca a lista de dispositivos
- ViewDevice — usado para verificações de status do dispositivo
- PrintToDevice — necessário para enviar trabalhos de impressão
- ViewDeviceGroups — recomendado para pesquisa de grupos e diagnóstico
Uma chave de API pode existir e ainda assim falhar se essas permissões não estiverem habilitadas.
Insira a URL e a chave de API no WCPOS
Adicione uma impressora em WP Admin > POS > Settings > Cloud Print, escolha Star Online como provedor e cole a CloudPRNT URL e a chave de API. Clique em Fetch my devices.
Selecione o dispositivo Star
Escolha a impressora na lista de dispositivos e salve. O WCPOS armazena a chave de API no servidor e usa o identificador de acesso do dispositivo selecionado ao enviar trabalhos ao Star Online.
Regras de impressão automática
As regras de impressão automática decidem o que imprime onde, automaticamente — escritas como frases simples. Uma regra é escopo × impressora × modelo, por exemplo:
Imprimir todos os pedidos na Cozinha usando o Ticket de Cozinha.
Quando um pedido correspondente é concluído, o WCPOS renderiza o modelo escolhido no servidor no formato de que a impressora precisa e o coloca na fila — não há nada para o operador de caixa fazer.
As impressoras Star e Epson só podem usar modelos térmicos, porque o trabalho precisa ser renderizado na linguagem de comando nativa da impressora (Star Document Markup ou ESC/POS para a Star, ePOS-Print para a Epson). O PrintNode pode usar qualquer modelo — térmico ou HTML de página inteira — porque o trabalho é renderizado em um PDF. Se um modelo não aparece como opção para uma impressora, é porque a impressora não consegue renderizar aquele formato. Consulte Modelos Térmicos para criar layouts térmicos.
Impressoras por loja (Pro)
O roteamento de impressão por loja requer o WCPOS Pro e uma configuração de múltiplas lojas.
Por padrão, as regras de impressão automática são globais — todas as lojas as compartilham. Com o Pro, você pode dar a uma loja individual suas próprias regras de impressão na nuvem, para que seus pedidos sejam impressos em suas próprias impressoras (um ticket de cozinha em um local não deve ser impresso em outro).
Edite uma loja em POS → Stores, abra sua seção Cloud Printing e clique em Add rule. Cada regra é:
- Printer ID — o ID estável da impressora na nuvem para a qual enviar
- Scope — POS orders only (padrão), Online orders only ou Every order
- Format — StarPRNT (padrão), ESC/POS, Epson ePOS-Print ou HTML
Quando um pedido pertence a uma loja que tem suas próprias regras, o WCPOS o roteia para as impressoras daquela loja. Se uma loja não tem regras próprias, ela recorre às regras globais de impressão automática — então você só precisa configurar as lojas que diferem.
Impressão manual
Você não precisa esperar por uma regra de impressão automática. Na tela de checkout / recibo, um operador de caixa pode enviar um recibo para uma impressora na nuvem sob demanda — útil para reimpressões ou para rotear um ticket avulso para uma impressora específica.
Como o recibo é produzido depende da impressora:
- Star CloudPRNT — o recibo é renderizado no dispositivo e entregue à impressora através do CloudPRNT.
- Star Online, Epson e PrintNode — o recibo é renderizado no servidor a partir do pedido e do modelo selecionados, e então entregue à impressora ou ao relé hospedado.
Impressão de teste e status da conexão
Cada cartão de impressora tem um botão Test print que envia um diagnóstico curto para que você possa confirmar que a impressora está acessível e que o formato está correto antes de confiar nela para pedidos reais.
O cartão também mostra um status ao vivo:
| Provedor | Status | Significado |
|---|---|---|
| Star CloudPRNT / Epson | Waiting | A impressora ainda não se registrou — o WCPOS está aguardando sua primeira sondagem. |
| Star CloudPRNT / Epson | Connected | A impressora fez sondagem no WCPOS recentemente e está coletando trabalhos. |
| Star Online | Online | O Star Online informa que o dispositivo selecionado está disponível. |
| Star Online | Offline | O Star Online informa que o dispositivo selecionado não está disponível. |
| Star Online | Unknown | O WCPOS não conseguiu confirmar o status do dispositivo no Star Online. |
| PrintNode | Online | O serviço PrintNode informa que o cliente e a impressora estão disponíveis. |
| PrintNode | Offline | O PrintNode informa que o cliente ou a impressora estão indisponíveis. |
Solução de problemas
Impressora travada em Waiting
Uma impressora por sondagem que nunca sai de Waiting nunca chegou ao WCPOS com sucesso. Verifique:
- A URL de sondagem e o token no firmware da impressora correspondem exatamente ao que o WCPOS gerou. Um único caractere errado faz com que todas as sondagens sejam rejeitadas — gere novamente o token no WCPOS e insira-o novamente se estiver em dúvida.
- A impressora realmente consegue alcançar seu site pela internet (DNS correto, sem firewall bloqueando o HTTPS de saída, certificado SSL válido na sua loja).
- A sondagem está habilitada na configuração CloudPRNT / Server Direct Print da impressora, com um intervalo razoável. Reinicie a impressora após alterar suas configurações.
O Star Online diz que a chave de API não está autorizada ou é proibida
O Star Online separa autenticação de permissões:
- 401 / falha de autenticação significa que a própria chave de API não foi aceita. Verifique se a chave foi copiada corretamente, não foi revogada e pertence à conta/região esperada do Star Online.
- 403 / proibido significa que a chave de API foi aceita, mas não está autorizada para a ação solicitada. Edite a chave no stario.online e habilite as permissões necessárias, especialmente EnumDevices para Fetch my devices e PrintToDevice para impressão.
Se Fetch my devices for bem-sucedido, mas nenhuma impressora aparecer, verifique a página Device Groups do stario.online. O grupo deve conter pelo menos um dispositivo conectado, e a CloudPRNT URL no WCPOS deve apontar para esse mesmo grupo.
O trabalho do PrintNode nunca é impresso
O trabalho chegou ao PrintNode, mas não saiu da impressora. Verifique:
- O cliente de desktop PrintNode está em execução e online no computador conectado à impressora. Se o computador estiver em suspensão ou o cliente estiver fechado, nada será impresso.
- Você selecionou a impressora correta no WCPOS — o nome deve corresponder à impressora que o cliente informa.
- A chave de API é válida e não foi revogada. Insira-a novamente se o PrintNode mostrar a impressora como Offline.
Meu modelo não é selecionável para uma impressora Star ou Epson
Apenas modelos térmicos funcionam em impressoras na nuvem Star e Epson, porque o recibo precisa ser renderizado em comandos ESC/POS ou ePOS-Print. Modelos HTML e de página inteira não podem ser expressos nesses formatos, então ficam ocultos para essas impressoras.
Escolha um modelo térmico ou use uma impressora PrintNode — o PrintNode renderiza em PDF, então pode imprimir qualquer modelo.