Configuração de Impressora

As configurações de impressora são encontradas no POS em Configurações > Impressora. Cada dispositivo gerencia sua própria configuração de impressora — as impressoras são armazenadas localmente e não são sincronizadas entre dispositivos.

Impressoras Compatíveis por Plataforma

O formulário Adicionar Impressora se adapta ao aplicativo em uso — cada plataforma exibe apenas as conexões e opções que pode utilizar.

Plataforma	Impressoras Compatíveis	Conexões
Aplicativo web	Impressoras Epson e Star com servidor web integrado	Rede (HTTP)
Aplicativo desktop	Qualquer impressora de recibos em rede	Rede (TCP direto)
Aplicativo iOS	Epson e Star	Rede, Bluetooth
Aplicativo Android	Epson e Star	Rede, Bluetooth, USB

Por que apenas Epson e Star na web?

Navegadores web não conseguem abrir conexões TCP brutas. As impressoras de recibos Epson e Star incluem um servidor web integrado que aceita trabalhos de impressão via HTTP — esta é a única forma de enviar comandos ESC/POS a partir de um navegador. O aplicativo desktop não tem essa limitação porque pode se conectar diretamente via TCP.

Nos aplicativos móveis, a impressão por Bluetooth e USB utiliza os SDKs oficiais da Epson e da Star, portanto essas conexões também exigem uma impressora Epson ou Star. Impressoras genéricas funcionam apenas pela rede.

Adicionando uma Impressora

1

Abrir Configurações da Impressora

Acesse Configurações > Impressora no POS. Se nenhuma impressora estiver configurada ainda, será exibido um estado vazio com um botão Adicionar Impressora. Cada impressora recebe um Nome da Impressora — apenas um rótulo, preenchido automaticamente como "Impressora de Recibos" (depois "Impressora de Recibos 2", e assim por diante) — que pode ser alterado para qualquer nome que ajude a identificar suas impressoras.

2

Escolher Como a Impressora se Conecta

Esta é a etapa que muda conforme a plataforma:

• Aplicativo web — escolha o Fabricante: Epson ou Star. Esta é a primeira escolha na web, pois os navegadores só conseguem acessar os servidores web integrados dessas duas marcas.
• Aplicativo desktop — as impressoras se conectam pela rede; não há nada extra para selecionar aqui.
• Aplicativos móveis — selecione um Tipo de Conexão: Rede, Bluetooth ou USB (USB é apenas para Android). Os campos abaixo mudam de acordo com a sua escolha.

3

Identificar a Impressora

Impressoras de rede — insira o Endereço IP (por exemplo, 192.168.1.100). O WCPOS verifica o endereço para detectar se é um dispositivo Epson ou Star, e preenche automaticamente a porta, a linguagem de comando e o fabricante. Uma etiqueta "Detected: Epson" ou "Detected: Star" será exibida quando a detecção for concluída. No aplicativo web, também é exibida a URL exata do endpoint ao qual ele se conectará.

Impressoras Bluetooth ou USB (dispositivos móveis) — escolha sua impressora na lista de dispositivos encontrados. Ao selecionar um dispositivo, o nome e o fabricante são preenchidos automaticamente. Toque em Procurar impressoras (Bluetooth) ou Atualizar (USB) se sua impressora ainda não aparecer na lista.

Se a detecção automática não identificar tudo corretamente, é possível ajustar tudo em Configurações Avançadas.

4

Salvar e Testar

Clique em Salvar. O WCPOS envia uma impressão de teste primeiro e só salva a impressora se ela for bem-sucedida.

A impressão de teste é um diagnóstico rápido — uma régua de colunas numeradas, texto centralizado em tamanho normal e duplo, uma linha com alinhamento à esquerda/direita e um corte de papel. Ela foi projetada para que você possa confirmar que a largura do papel, o alinhamento, o dimensionamento e o corte estão configurados corretamente, e não apenas que a impressora está acessível.

Se o teste falhar, o erro será exibido junto com a opção Salvar sem testar para salvar o perfil mesmo assim.

Tipos de Conexão (Aplicativos Móveis)

Nos aplicativos iOS e Android, uma impressora pode se conectar de três formas. Escolha o Tipo de Conexão no topo do formulário Adicionar Impressora, e os campos de conexão serão atualizados de acordo.

Rede

A impressora está na mesma rede Wi-Fi que o seu dispositivo. Insira o endereço IP — consulte Encontrando o Endereço IP da Sua Impressora. Impressoras de rede podem ser Epson, Star ou Genérica.

Bluetooth

A impressora está pareada ao seu dispositivo via Bluetooth. Toque em Procurar impressoras e escolha a sua na lista — o nome e o fabricante serão preenchidos automaticamente. A impressão por Bluetooth utiliza os SDKs nativos da Epson e da Star, portanto a impressora deve ser um modelo Epson ou Star.

USB (somente Android)

A impressora é conectada por um cabo USB. Toque em Atualizar e selecione-a na lista de dispositivos conectados. Assim como o Bluetooth, a impressão via USB requer uma impressora Epson ou Star. O iOS não possui suporte geral a periféricos USB, portanto essa opção aparece apenas no Android.

nota

A configuração de Porta aplica-se apenas a impressoras de rede — ela fica oculta para conexões Bluetooth e USB.

Configurações Avançadas

Expanda Configurações Avançadas para ajustar a configuração da impressora. A maioria dessas opções é preenchida automaticamente quando o fabricante é identificado.

Configuração	Opções	Descrição
Fabricante	Epson, Star, Genérico	Fabricante da impressora. No aplicativo web, o Fabricante é a opção principal no topo do formulário (somente Epson ou Star), em vez de uma configuração avançada. Genérico está disponível para impressoras de rede nos aplicativos desktop e móvel, mas não para conexões Bluetooth ou USB.
Porta	Preenchida automaticamente	Porta de rede da impressora. Somente rede — oculta para Bluetooth e USB.
Linguagem	ESC/POS, StarPRNT, Star Line Mode	O protocolo de comandos que a impressora utiliza. Preenchida automaticamente a partir do fabricante detectado.
Largura de texto da impressora	58mm (32 caracteres), 80mm padrão (42 caracteres), 80mm largo (48 caracteres)	Quantos caracteres cabem em uma linha. Ajuste conforme o papel e a impressora — a maioria das impressoras de 80mm comporta 42 caracteres por linha, algumas comportam 48.
Recibo completo em raster	Desligado / Ligado	Imprime o recibo inteiro como imagem em vez de texto — veja Recibo completo em raster abaixo.

Opções da Impressora

Essas opções ficam na parte inferior do formulário Adicionar Impressora:

Opção	Descrição
Corte automático de papel	Corta o papel automaticamente após cada recibo
Abertura automática da gaveta de dinheiro	Envia um comando para abrir uma gaveta de dinheiro conectada após a impressão
Definir como padrão	Define esta como a impressora padrão — usada para qualquer recibo que não esteja direcionado a uma impressora específica

Procurando "impressão automática após finalização da venda"?

A impressão automática de um recibo ao concluir uma venda é uma configuração do carrinho, não uma configuração da impressora — ative Impressão automática de recibo nas configurações do carrinho do POS. Qual impressora será utilizada é determinado pela impressora padrão e por qualquer direcionamento de impressora por modelo.

Direcionamento de impressão

Se você utiliza mais de um modelo — por exemplo, um recibo térmico e uma fatura A4 — o direcionamento de impressão define para qual impressora cada modelo será impresso. O direcionamento possui três camadas, verificadas nesta ordem:

1. Substituição por trabalho. Na tela de recibo, um menu suspenso de impressora fica ao lado do seletor de modelo. Escolher uma impressora aqui substitui tudo para aquele trabalho de impressão específico. Trocar de modelo redefine de volta para Automático.
2. Substituição nas configurações. Acesse Configurações → Roteamento de Impressão para atribuir uma impressora específica a cada modelo. Por exemplo, direcione o recibo térmico para a impressora de rede Epson e a fatura HTML para a caixa de diálogo de impressão do sistema. Defina um modelo de volta para Automático para remover a substituição.
3. Correspondência automática. Quando nenhuma substituição está definida, o WCPOS faz a correspondência automaticamente:
   • Modelos térmicos são direcionados para impressoras térmicas cuja largura de caracteres seja compatível. Um modelo térmico de 58mm prefere impressoras de 32 colunas; um modelo de 80mm prefere impressoras de 42 ou 48 colunas.
   • Modelos HTML são direcionados para a caixa de diálogo de impressão do sistema.
   • Se várias impressoras forem compatíveis, a impressora padrão prevalece.

Se você enviar manualmente um modelo para uma impressora incompatível — por exemplo, um modelo térmico para a caixa de diálogo do sistema — um aviso de incompatibilidade em âmbar aparece na tela de recibo. A impressão prossegue, mas a saída pode não ser renderizada corretamente.

As substituições de roteamento são armazenadas por dispositivo. Cada iPad, celular ou computador gerencia seu próprio roteamento — não há sincronização no servidor.

nota

A página de configurações de Roteamento de Impressão só aparece depois que pelo menos uma impressora for adicionada. Sem impressoras configuradas, todos os modelos utilizam implicitamente a caixa de diálogo de impressão do sistema.

Rasterização completa do recibo

Por padrão, o WCPOS envia recibos para impressoras térmicas como texto — rápido, compacto e nítido, usando as fontes integradas da impressora. O problema: as fontes de impressoras térmicas cobrem apenas um conjunto limitado de caracteres. Scripts para os quais a impressora não possui fonte — muitos alfabetos não latinos, texto da direita para a esquerda, alguns símbolos — podem aparecer como quadrados em branco ou caracteres ilegíveis.

Rasterização completa do recibo resolve isso. Quando ativada, o WCPOS renderiza o recibo inteiro como uma imagem e envia essa imagem para a impressora, de modo que a impressão corresponde exatamente ao que aparece na tela — em qualquer idioma ou script.

Ative por impressora em Configurações Avançadas. Pontos importantes:

• É mais lento. Uma imagem é muito maior do que uma linha de texto, então o recibo demora mais para ser enviado e impresso.
• Use apenas quando necessário. Se os recibos são impressos corretamente como texto, deixe desativado.
• Aplica-se a impressoras térmicas em qualquer tipo de conexão (rede, Bluetooth, USB). Não se aplica à caixa de diálogo de impressão do sistema, que já imprime a partir de uma renderização de página inteira.

Descobrindo Impressoras

Nos aplicativos móveis, o formulário Adicionar Impressora lista impressoras próximas para conexões Bluetooth (iOS e Android) e USB (somente Android) — toque em Buscar impressoras ou Atualizar e escolha a sua na lista. O nome e o fabricante são preenchidos automaticamente.

Para impressoras de rede em qualquer plataforma, insira o endereço IP diretamente — consulte Encontrando o Endereço IP da Sua Impressora abaixo. O aplicativo web não possui descoberta de rede (navegadores não podem escanear redes), então sempre utiliza a inserção manual de IP.

Encontrando o Endereço IP da Sua Impressora

A maioria das impressoras de recibo pode imprimir uma página de autoteste que inclui o endereço IP:

• Epson: Mantenha o botão de avanço pressionado ao ligar a impressora
• Star: Mantenha o botão de avanço de papel pressionado por 5 segundos com a impressora ligada

Como alternativa, verifique a lista de dispositivos conectados do seu roteador ou o utilitário de configuração da sua impressora.

IP Estático Recomendado

Impressoras de recibo devem usar um endereço IP estático para evitar que o endereço mude quando a impressora for reiniciada. Configure isso de uma das seguintes formas:

• Na interface web integrada da impressora (geralmente acessível em http://<printer-ip>)
• Nas configurações de DHCP do seu roteador (atribua um IP reservado ao endereço MAC da impressora)

Impressoras Epson

Impressoras Epson com suporte a ePOS se comunicam via HTTP. O WCPOS envia requisições SOAP/XML para o servidor web integrado da impressora.

Detalhes da conexão:

• Porta 8008 (HTTP) ou 8043 (HTTPS)
• Endpoint: /cgi-bin/epos/service.cgi

Modelos confirmados como compatíveis:

• Epson TM-T70-i 2 (rede)
• Epson TM-m30iii (com middleware Printus)

dica

Certifique-se de que a impressora Epson esteja com o ePOS habilitado na configuração. Acesse a interface web da impressora em http://<printer-ip> para verificar e habilitar as configurações do ePOS.

Nos aplicativos móveis, as impressoras Epson também podem se conectar via Bluetooth ou USB por meio do SDK nativo da Epson — sem necessidade de endereço IP ou servidor web ePOS.

Impressoras Star

As impressoras Star com suporte a WebPRNT se comunicam via HTTP. O WCPOS envia comandos para o endpoint WebPRNT da Star.

Detalhes da conexão:

• HTTPS ou HTTP
• Endpoint: /StarWebPRNT/SendMessage

Nos aplicativos móveis, as impressoras Star também podem se conectar via Bluetooth ou USB por meio do SDK nativo da Star.

Impressoras Genéricas

O aplicativo desktop suporta qualquer impressora de recibos em rede via TCP bruto. Insira o endereço IP e a porta da impressora (geralmente 9100). Isso funciona com a maioria das impressoras térmicas independentemente do fabricante, desde que aceitem comandos ESC/POS.

Nos aplicativos móveis, as impressoras genéricas também são suportadas — mas apenas para conexões de rede, não via Bluetooth ou USB (esses requerem uma impressora Epson ou Star). O aplicativo web não suporta impressoras genéricas.

Gavetas de Dinheiro

As gavetas de dinheiro conectadas a uma impressora de recibos podem ser acionadas automaticamente após cada venda:

1. Ative Abrir gaveta de dinheiro automaticamente nas opções da impressora
2. O POS envia um comando ESC/POS de abertura após a impressão

nota

O controle da gaveta de dinheiro requer um perfil de impressora térmica — a caixa de diálogo de impressão do navegador não pode acionar gavetas de dinheiro.

Solução de problemas

Impressora não detectada durante a configuração

• Confirme se a impressora está ligada e conectada à mesma rede que o seu dispositivo
• Para impressoras de rede: verifique se o endereço IP está correto (imprima uma página de autoteste)
• Para o aplicativo web: confirme se a impressora é um modelo Epson ou Star com suporte a ePOS/WebPRNT
• Para o aplicativo desktop: tente a opção de fabricante Genérico com a porta 9100
• Para Bluetooth: emparelhe a impressora nas configurações de Bluetooth do seu dispositivo primeiro e, em seguida, toque em Buscar impressoras
• Para USB (Android): verifique o cabo e aprove a solicitação de permissão USB, caso ela apareça
• Verifique se nenhum firewall está bloqueando a conexão

Impressora detectada, mas nada é impresso

• Verifique o rolo de papel — ele pode estar vazio ou atolado
• Verifique se a configuração Largura do texto da impressora corresponde ao seu papel (58mm ou 80mm)
• Tente imprimir um autoteste diretamente pela impressora para confirmar que ela está funcionando
• Verifique se a linguagem de comando corresponde à sua impressora (ESC/POS para Epson, StarPRNT ou Star Line Mode para Star)

O recibo está ilegível ou com caracteres incorretos

• A configuração da linguagem de comando pode estar incorreta — tente alternar entre ESC/POS, StarPRNT e Star Line Mode
• Verifique se a configuração de Largura do texto da impressora está correta
• Se o recibo estiver em um script não latino ou em um idioma da direita para a esquerda, ative Recibo rasterizado completo nas Configurações Avançadas — isso imprime o recibo como uma imagem para que qualquer idioma seja renderizado corretamente

A gaveta de dinheiro não abre

• Confirme se Abertura automática da gaveta de dinheiro está ativada nas opções da impressora
• Verifique se a gaveta está conectada à porta DK da impressora (e não a uma fonte de alimentação separada)
• Nem todas as impressoras suportam o comando de abertura da gaveta — consulte a documentação da sua impressora

Não é possível conectar pelo aplicativo web

• O aplicativo web só pode se conectar a impressoras Epson e Star com servidores web integrados
• Impressoras genéricas e USB não são compatíveis com a versão web — use o aplicativo para desktop ou dispositivo móvel
• Se o seu site usa HTTPS, mas a impressora aceita apenas HTTP, o navegador pode bloquear a conexão como conteúdo misto

A impressora Bluetooth não conecta (dispositivo móvel)

• Emparelhe a impressora nas configurações de Bluetooth do sistema do seu dispositivo antes de adicioná-la no WCPOS
• A impressão Bluetooth é compatível apenas com impressoras Epson e Star — impressoras Bluetooth genéricas não são compatíveis
• Se a impressora não aparecer na lista, toque em Buscar impressoras novamente e verifique se ela está ligada e dentro do alcance