# 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?[​](#what-is-cloud-printing "Link direto para 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](/pt-BR/hardware/printers.md) 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.

Por que uma impressora que faz sondagem?

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[​](#providers "Link direto para 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[​](#setup "Link direto para 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)[​](#setup-polling "Link direto para Star ou Epson (impressoras por sondagem)")

1

#### 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.

2

#### 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.

3

#### 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[​](#setup-printnode "Link direto para PrintNode")

1

#### 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.

2

#### 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.

3

#### 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.

4

#### 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[​](#setup-star-online "Link direto para 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.

1

#### 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/...`.

2

#### 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.

3

#### 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**.

4

#### 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[​](#auto-print "Link direto para 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.

A compatibilidade de modelos importa

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](/pt-BR/receipts/thermal-templates.md) para criar layouts térmicos.

## Impressoras por loja (Pro)[​](#per-store-printers "Link direto para Impressoras por loja (Pro)")

Recurso Pro

O roteamento de impressão por loja requer o [WCPOS Pro](/pt-BR/getting-started/pro-license.md) e uma configuração de [múltiplas lojas](/pt-BR/stores/.md).

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[​](#manual "Link direto para 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[​](#status "Link direto para 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[​](#troubleshooting "Link direto para 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](/pt-BR/receipts/thermal-templates.md) ou use uma impressora **PrintNode** — o PrintNode renderiza em PDF, então pode imprimir qualquer modelo.

## Documentação Relacionada[​](#related-documentation "Link direto para Documentação Relacionada")

[Configuração de ImpressorasConecte uma impressora no mesmo dispositivo ou rede](/pt-BR/hardware/printers.md)

[ModelosO sistema de modelos de recibo](/pt-BR/receipts/.md)

[Modelos TérmicosCrie layouts ESC/POS para impressoras Star e Epson](/pt-BR/receipts/thermal-templates.md)