Configuração da impressora
As configurações da impressora ficam 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.
Esta página aborda impressoras conectadas ao caixa por USB, Bluetooth ou pela rede local. Para uma impressora em outro ambiente ou local — ou uma que você queira compartilhar com todos os dispositivos — consulte Impressão em nuvem.
Impressoras compatíveis por plataforma
O formulário Adicionar impressora se adapta ao aplicativo em uso — cada plataforma mostra apenas as conexões e opções que ela realmente pode usar.
| Plataforma | Impressoras compatíveis | Conexões |
|---|---|---|
| Aplicativo web | Impressoras Epson e Star com servidor web integrado | Rede (HTTP) |
| Aplicativo desktop | Qualquer impressora de recibos de rede | Rede (TCP bruto) |
| Aplicativo iOS | Epson e Star | Rede, Bluetooth |
| Aplicativo Android | Epson e Star | Rede, Bluetooth, USB |
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 por HTTP — essa é a única forma de enviar comandos ESC/POS a partir de um navegador. O aplicativo para desktop não tem essa limitação porque pode se conectar diretamente por TCP.
Nos aplicativos móveis, a impressão por Bluetooth e USB passa pelos 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.
Adicionar uma impressora
Abrir configurações da impressora
Acesse Configurações > Impressora no POS. Se ainda não houver impressoras configuradas, você verá um estado vazio com o 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 diferenciar suas impressoras.
Escolher como a impressora se conecta
Esta é a etapa que muda de acordo com a plataforma:
- Aplicativo web — selecione o Fabricante: Epson ou Star. Esta é a primeira escolha na web, porque os navegadores só conseguem acessar os servidores web integrados dessas duas marcas.
- Aplicativo para desktop — as impressoras se conectam pela rede; não há mais nada para selecionar aqui.
- Aplicativos móveis — selecione um Tipo de conexão: Rede, Bluetooth, ou USB (USB é apenas para Android). Os campos abaixo mudam para corresponder à sua escolha.
Identificar a impressora
Impressoras de rede — informe 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 comandos e o fornecedor. Você verá um rótulo "Detectado: Epson" ou "Detectado: Star" quando a detecção for concluída. No aplicativo web, ele também mostra a URL exata do endpoint ao qual se conectará.
Impressoras Bluetooth ou USB (móvel) — escolha sua impressora na lista de dispositivos encontrados. Selecionar um dispositivo preenche automaticamente o nome e o fornecedor. Toque em Procurar impressoras (Bluetooth) ou Atualizar (USB) se sua impressora ainda não estiver listada.
Se a detecção automática não configurar tudo corretamente, é possível ajustar tudo em Configurações avançadas.
Salvar e testar
Clique em Salvar. O WCPOS envia primeiro uma impressão de teste e só salva a impressora se ela for bem-sucedida.
A impressão de teste é um diagnóstico curto — uma régua de coluna numerada, texto normal e em tamanho duplo centralizado, uma linha de alinhamento à esquerda/direita e um corte de papel. Ela foi projetada para que seja possível confirmar que a largura do papel, o alinhamento, o dimensionamento e o corte estão todos configurados corretamente, não apenas que a impressora está acessível.
Se o teste falhar, você verá o erro 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 na parte superior do formulário Adicionar impressora, e os campos de conexão serão atualizados para corresponder.
Rede
A impressora está na mesma rede Wi-Fi que o seu dispositivo. Insira o endereço IP dela — consulte Como encontrar o endereço IP da sua impressora. Impressoras de rede podem ser Epson, Star ou Genéricas.
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 são preenchidos automaticamente. A impressão por Bluetooth usa os SDKs nativos da Epson e da Star, portanto a impressora deve ser um modelo Epson ou Star.
USB (somente Android)
A impressora está conectada por um cabo USB. Toque em Atualizar e selecione-a na lista de dispositivos conectados. Assim como no Bluetooth, a impressão por USB requer uma impressora Epson ou Star. O iOS não tem suporte geral a periféricos USB, portanto esta opção aparece apenas no Android.
A configuração Porta se aplica 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 desses campos é preenchida automaticamente assim que o fabricante é identificado.
| Configuração | Opções | Descrição |
|---|---|---|
| Fabricante | Epson, Star, Genérica | Fabricante da impressora. No app web, Fabricante é a opção principal no topo do formulário (somente Epson ou Star), em vez de uma configuração avançada. Genérica está disponível para impressoras de rede nos apps para desktop e dispositivos móveis, mas não para conexões Bluetooth ou USB. |
| Porta | Preenchida automaticamente | Porta de rede da impressora. Apenas rede — oculta para Bluetooth e USB. |
| Idioma | ESC/POS, StarPRNT, Star Line Mode | O protocolo de comandos usado pela impressora. Preenchido automaticamente a partir do fornecedor detectado. |
| Largura do texto da impressora | 58mm (32 caracteres), 80mm padrão (42 caracteres), 80mm largo (48 caracteres) | Quantos caracteres cabem em uma linha. Ajuste isso ao papel e à impressora — a maioria das impressoras de 80mm usa 42 caracteres por linha, algumas usam 48. |
| Rasterização completa do recibo | Desativado / Ativado | Imprime o recibo inteiro como imagem em vez de texto — veja Rasterização completa do recibo abaixo. |
Opções da impressora
Esses seletores ficam na parte inferior do formulário Adicionar impressora:
| Opção | Descrição |
|---|---|
| Corte automático do papel | Corta o papel automaticamente após cada recibo |
| Abertura automática da gaveta de dinheiro | Envia um comando de acionamento para abrir uma gaveta de dinheiro conectada após a impressão |
| Definir como padrão | Torna esta a impressora padrão — usada para qualquer recibo que não seja direcionado a uma impressora específica |
Imprimir automaticamente um recibo quando uma venda é concluída é uma configuração do carrinho, não uma configuração da impressora — ative Imprimir recibo automaticamente nas configurações do carrinho do POS. A impressora usada é determinada pela impressora padrão e por qualquer roteamento de impressora por modelo.
Roteamento de impressão
Se você usa mais de um modelo — por exemplo, um recibo térmico e uma fatura A4 — o roteamento de impressão decide em qual impressora cada modelo será impresso. O roteamento tem três camadas, verificadas nesta ordem:
- Substituição por trabalho. Na tela de recibo, há uma lista suspensa de impressoras ao lado do alternador de modelos. Escolher uma impressora aqui substitui todas as outras configurações apenas para esse trabalho de impressão. Trocar de modelo redefine a opção para Automático.
- 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 novamente como Automático para remover a substituição.
- Correspondência automática. Quando nenhuma substituição está definida, o WCPOS faz a correspondência automaticamente:
- Modelos térmicos são roteados para impressoras térmicas cuja largura de caracteres corresponde ao modelo. 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 roteados para a caixa de diálogo de impressão do sistema.
- Se várias impressoras corresponderem, a impressora padrão será usada.
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 aparecerá na tela de recibo. A impressão ainda prosseguirá, mas a saída pode não ser renderizada corretamente.
As substituições de roteamento são armazenadas por dispositivo. Cada iPad, telefone ou computador gerencia seu próprio roteamento — não há sincronização no lado do servidor.
A página de configurações de roteamento de impressão só aparece depois que você adiciona pelo menos uma impressora. Sem impressoras configuradas, todos os modelos usam 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 detalhe é que as fontes de impressoras térmicas cobrem apenas um conjunto limitado de caracteres. Escritas para as quais a impressora não tem fonte, como muitos alfabetos não latinos, texto da direita para a esquerda e alguns símbolos, podem sair como caixas em branco ou caracteres ilegíveis.
A rasterização completa do recibo corrige isso. Quando ativada, o WCPOS renderiza o recibo inteiro como uma imagem e envia essa imagem para a impressora, para que a impressão corresponda exatamente ao que aparece na tela, em qualquer idioma ou sistema de escrita.
Ative por impressora em Configurações avançadas. O que saber:
- É mais lento. Uma imagem é muito maior do que uma linha de texto, então o recibo demora mais para ser enviado e impresso.
- Use somente quando necessário. Se seus recibos forem impressos corretamente como texto, deixe desativado.
- Aplica-se a impressoras térmicas em qualquer 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.
Descoberta de 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 Procurar impressoras ou Atualizar e escolha a sua na lista. O nome e o fornecedor são preenchidos automaticamente.
Para impressoras de rede em qualquer plataforma, informe o endereço IP diretamente; consulte Como encontrar o endereço IP da sua impressora abaixo. O aplicativo web não tem descoberta de rede (navegadores não conseguem escanear redes), por isso sempre usa a inserção manual do IP.
Como encontrar o endereço IP da impressora
A maioria das impressoras de recibos pode imprimir uma página de autoteste que inclui o endereço IP:
- Epson: Mantenha o botão de avanço pressionado ao ligar
- Star: Mantenha o botão de avanço pressionado por 5 segundos enquanto estiver ligada
Como alternativa, verifique a lista de dispositivos conectados do roteador ou o utilitário de configuração da impressora.
IP estático recomendado
As impressoras de recibos devem usar um endereço IP estático para evitar que o endereço mude quando a impressora for reiniciada. Configure isso de uma destas formas:
- Na interface web integrada da impressora (geralmente acessível em
http://<printer-ip>) - Nas configurações de DHCP do roteador (atribua um IP reservado ao endereço MAC da impressora)
Impressoras Epson
Impressoras Epson com suporte a ePOS se comunicam por HTTP. O WCPOS envia solicitações SOAP/XML para o servidor web integrado da impressora.
Detalhes da conexão:
- Porta
8008(HTTP) ou8043(HTTPS) - Endpoint:
/cgi-bin/epos/service.cgi
Modelos com funcionamento confirmado:
- Epson TM-T70-i 2 (rede)
- Epson TM-m30iii (com middleware Printus)
Verifique se a impressora Epson está com ePOS ativado na configuração. Acesse a interface web da impressora em http://<printer-ip> para verificar e ativar as configurações de ePOS.
Nos aplicativos móveis, as impressoras Epson também podem se conectar por Bluetooth ou USB usando o SDK nativo da Epson — sem necessidade de endereço IP ou servidor web ePOS.
Impressoras Star
Impressoras Star com suporte a WebPRNT se comunicam por HTTP. O WCPOS envia comandos para o endpoint Star WebPRNT.
Detalhes da conexão:
- HTTPS ou HTTP
- Endpoint:
/StarWebPRNT/SendMessage
Nos aplicativos móveis, as impressoras Star também podem se conectar por Bluetooth ou USB por meio do SDK nativo da Star.
Impressoras genéricas
O aplicativo desktop oferece suporte a 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, impressoras genéricas também são compatíveis, mas apenas para conexões de rede, não por Bluetooth ou USB (essas exigem uma impressora Epson ou Star). O aplicativo web não oferece suporte a impressoras genéricas.
Gavetas de dinheiro
Gavetas de dinheiro conectadas a uma impressora de recibos podem ser acionadas automaticamente após cada venda:
- Ative Abrir gaveta de dinheiro automaticamente nas opções da impressora
- O POS envia um comando de acionamento ESC/POS após a impressão
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 do 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 fornecedor Genérico com a porta 9100
- Para Bluetooth: primeiro emparelhe a impressora nas configurações de Bluetooth do dispositivo e depois toque em Procurar impressoras
- Para USB (Android): verifique o cabo e aprove a solicitação de permissão USB, se ela aparecer
- 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 funciona
- Verifique se a linguagem de comandos 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 comandos pode estar incorreta — tente alternar entre ESC/POS, StarPRNT e Star Line Mode
- Verifique se a configuração Largura do texto da impressora está correta
- Se o recibo estiver em uma escrita não latina ou em um idioma da direita para a esquerda, ative Rasterização completa do recibo 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 Abrir gaveta de dinheiro automaticamente está ativado nas opções da impressora
- Verifique se a gaveta está conectada à porta DK da impressora (não a uma fonte de alimentação separada)
- Nem todas as impressoras são compatíveis com 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 na web — use o aplicativo desktop ou móvel em vez disso
- Se o seu site usa HTTPS, mas a impressora só se comunica por HTTP, o navegador pode bloquear a conexão como conteúdo misto
A impressora Bluetooth não conecta (móvel)
- Pareie a impressora nas configurações Bluetooth do sistema do seu dispositivo antes de adicioná-la no WCPOS
- A impressão por 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 Procurar impressoras novamente e verifique se ela está ligada e dentro do alcance