Configuração de Impressora

As configurações de impressora estão 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.

Imprimindo em uma impressora que não está neste dispositivo?

Esta página cobre impressoras conectadas ao caixa por USB, Bluetooth ou rede local. Para uma impressora em outra sala ou local — ou uma que você deseja compartilhar com todos os dispositivos — consulte Impressão em Nuvem. As impressoras em nuvem configuradas para sua loja aparecem automaticamente na lista de impressoras de cada dispositivo — não é necessário adicioná-las aqui.

Impressoras Compatíveis por Plataforma

O formulário Adicionar Impressora se adapta ao aplicativo que você está usando — cada plataforma exibe apenas as conexões e opções que pode realmente utilizar.

Plataforma	Impressoras Compatíveis	Conexões
Aplicativo web	Impressoras Epson e Star com servidor web integrado (rede); impressoras Epson e Star via WebUSB/Web Bluetooth (USB/Bluetooth, apenas Chrome/Edge)	Rede (HTTP), USB, Bluetooth
Aplicativo desktop	Qualquer impressora de recibos em rede	Rede (TCP direto), USB, Bluetooth
Aplicativo iOS	Epson e Star	Rede, Bluetooth
Aplicativo Android	Epson e Star	Rede, Bluetooth, USB

Por que apenas Epson e Star pela rede na web?

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

A impressão via USB e Bluetooth no navegador também funciona, mas apenas no Chrome ou Microsoft Edge (eles usam as APIs WebUSB e Web Bluetooth) — Safari e Firefox não oferecem suporte.

Nos aplicativos móveis, a impressão via Bluetooth e USB utiliza os SDKs oficiais da Epson e da Star, portanto essas conexões 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, uma tela vazia será exibida 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

Escolha Como a Impressora se Conecta

Todas as plataformas começam com a mesma pergunta — Tipo de Conexão — e exibem apenas as opções compatíveis com aquela plataforma. Os campos abaixo são atualizados de acordo com a sua escolha.

• Aplicativo web — Rede, USB ou Bluetooth (USB e Bluetooth exigem Chrome ou Edge). Para uma impressora de Rede, é necessário escolher o Fabricante — Epson ou Star — porque o navegador se comunica com a impressora de rede por meio do servidor web integrado da marca.
• Aplicativo desktop — Rede, USB ou Bluetooth.
• Aplicativos móveis — Rede ou Bluetooth, além de USB no Android (o aplicativo iOS não possui suporte a USB).

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 comandos e o fabricante. Uma etiqueta "Detectado: Epson" ou "Detectado: Star" será exibida após a conclusão da detecção. No aplicativo web, também é exibida a URL exata do endpoint ao qual será feita a conexão.

Impressoras Bluetooth ou USB (mobile) — selecione a impressora na lista de dispositivos descobertos. Ao selecionar um dispositivo, o nome e o fabricante são preenchidos automaticamente. Toque em Buscar impressoras (Bluetooth) ou Atualizar (USB) se a impressora ainda não estiver listada.

Se a detecção automática não identificar tudo corretamente, é possível ajustar nas 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 breve — uma régua de colunas numeradas, texto centralizado em tamanho normal e duplo, uma linha de alinhamento esquerda/direita e um corte de papel. Foi projetada para 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.

O teste falhou? Ainda é possível salvar

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

Comece selecionando o Tipo de Conexão no topo do formulário Adicionar Impressora, e os campos de conexão serão atualizados de acordo. Os tipos disponíveis dependem da plataforma (consulte a tabela acima).

Rede

A impressora está na mesma rede Wi-Fi que o seu dispositivo. Nos aplicativos desktop e móvel, toque em Escanear Rede para descobrir impressoras automaticamente, ou insira o endereço IP manualmente — consulte Encontrando o Endereço IP da Sua Impressora. O aplicativo web utiliza apenas a entrada manual de IP. Nos aplicativos desktop e móvel, uma impressora de rede pode ser Epson, Star ou Genérica; na web, deve ser Epson ou Star, e a escolha é feita na conexão de Rede.

Bluetooth

A impressora está pareada com o seu dispositivo via Bluetooth. Escolha a sua na lista — o nome e o fabricante são preenchidos automaticamente. No móvel, a impressão Bluetooth utiliza os SDKs nativos da Epson e da Star, portanto a impressora deve ser um modelo Epson ou Star; na web, o Bluetooth funciona no Chrome ou Edge por meio da API Web Bluetooth.

USB

A impressora está conectada por um cabo USB. Selecione-a na lista de dispositivos conectados. O USB está disponível na web (Chrome ou Edge, via WebUSB), no aplicativo desktop e no Android — mas não no iOS, que não possui suporte geral a periféricos USB. No móvel, a impressão USB requer uma impressora Epson ou Star.

nota

A configuração de 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 dessas opções é preenchida automaticamente assim que o fabricante é identificado.

Estas configurações se aplicam em todas as plataformas:

Configuração	Opções	Descrição
Linguagem	ESC/POS, StarPRNT, Star Line Mode	O protocolo de comando que a impressora utiliza. Preenchido automaticamente a partir do fabricante 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 de acordo com o papel e a impressora — a maioria das impressoras de 80mm comporta 42 caracteres por linha, algumas comportam 48.
Recibo completo em imagem	Desativado / Ativado	Imprime o recibo inteiro como imagem em vez de texto — veja Recibo completo em imagem abaixo.

Estas duas configurações se comportam de maneira diferente dependendo da plataforma e do tipo de conexão:

Configuração	Opções	Onde se aplica
Fabricante	Epson, Star, Genérico	Fabricante da impressora. No aplicativo web, o fabricante é selecionado diretamente na conexão de Rede (apenas Epson ou Star), não como uma configuração avançada. Genérico está disponível para impressoras de rede nos aplicativos para desktop e dispositivos móveis, mas não para conexões Bluetooth ou USB.
Porta	Preenchida automaticamente	Porta de rede da impressora, exibida ao lado do endereço IP. Apenas rede — oculta para Bluetooth e USB. É preenchida automaticamente com base no fabricante (e, no aplicativo web, se o POS é servido via HTTP ou HTTPS); altere apenas se a sua rede redirecionar a porta.

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 a 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 esteja direcionado a uma impressora específica

Procurando "impressão automática após o checkout"?

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

Roteamento de impressão

Se você utiliza mais de um modelo — por exemplo, um recibo térmico e uma fatura A4 — o roteamento de impressão determina para qual impressora cada modelo será enviado. O roteamento 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 todas as outras configurações para aquele trabalho de impressão específico. Ao trocar de modelo, a seleção 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 Epson de rede e a fatura HTML para a caixa de diálogo de impressão do sistema. Defina um modelo como Automático para remover a substituição.
3. Correspondência automática. Quando nenhuma substituição é definida, o WCPOS faz a correspondência automaticamente:
   • Modelos térmicos são direcionados para impressoras térmicas cuja largura de caracteres corresponda. 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 corresponderem, a impressora padrão é utilizada.

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 lado do servidor.

nota

A página de configurações de Roteamento de Impressão só aparece depois que pelo menos uma impressora é adicionada. Sem impressoras configuradas, todos os modelos utilizam a caixa de diálogo de impressão do sistema implicitamente. Impressoras na nuvem configuradas para sua loja também contam aqui — elas aparecem como destinos de roteamento automaticamente, sem precisar ser adicionadas no dispositivo.

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 porém: as fontes de impressoras térmicas cobrem apenas um conjunto limitado de caracteres. Escritas para as quais a impressora não possui fonte — muitos alfabetos não latinos, texto da direita para a esquerda, alguns símbolos — podem aparecer como caixas em branco ou caracteres ilegíveis.

A 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 corresponda exatamente ao que aparece na tela — em qualquer idioma ou escrita.

Ative por impressora em Configurações Avançadas. O que você precisa 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 apenas quando necessário. Se seus recibos imprimem bem como texto, deixe desativado.
• Isso se aplica 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.

Descobrindo Impressoras

A forma de encontrar uma impressora depende do tipo de conexão:

• Bluetooth e USB — nos aplicativos móveis, toque em Buscar impressoras (Bluetooth) ou Atualizar (USB) e escolha a sua na lista; o nome e o fabricante são preenchidos automaticamente. Na web (Chrome ou Edge), clique em Conectar e escolha a impressora no seletor de dispositivos do navegador.
• Rede — nos aplicativos desktop e móveis, toque em Buscar na Rede para encontrar impressoras na sua rede local automaticamente (o desktop as descobre via mDNS/Bonjour; o móvel usa os SDKs da Epson e Star), e então escolha a sua na lista. Você também pode inserir o endereço IP diretamente — consulte Encontrando o Endereço IP da Sua Impressora abaixo. Navegadores não conseguem fazer varredura de rede, então o aplicativo web sempre usa a entrada manual de IP.

Encontrando o Endereço IP da Sua 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 a impressora
• Star: Mantenha o botão de avanço 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 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 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 ao servidor web integrado da impressora.

Detalhes da conexão:

• Porta 8008 (HTTP) ou 8043 (HTTPS) — preenchida automaticamente conforme o POS esteja sendo servido via HTTP ou 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 para dispositivos 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:

• Porta 80 (HTTP) ou 443 (HTTPS) — preenchida automaticamente conforme o POS esteja servido via HTTP ou HTTPS
• 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, 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

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 consegue acionar gavetas de dinheiro.

Solução de Problemas

Impressora não detectada durante a configuração

• Confirme que a impressora está ligada e conectada à mesma rede que o seu dispositivo
• Para impressoras de rede: no aplicativo desktop ou móvel, tente Escanear Rede para encontrá-la automaticamente; caso contrário, verifique se o endereço IP está correto (imprima uma página de autoteste)
• Para o aplicativo web: confirme que 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 depois toque em Escanear impressoras
• Para USB (Android): verifique o cabo e aprove a solicitação de permissão USB, caso apareça
• Verifique se nenhum firewall está bloqueando a conexão

Impressora detectada, mas nada é impresso

• Verifique o rolo de papel — 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 na impressora para confirmar que ela funciona
• 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
• Certifique-se de que a configuração 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 completo em raster 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 que 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 suportam o comando de abertura de gaveta — consulte a documentação da sua impressora

Não é possível conectar pelo aplicativo web

• Pela rede, o aplicativo web alcança apenas impressoras Epson e Star (através de seus servidores web integrados) — impressoras genéricas de rede raw não são suportadas no navegador; use o aplicativo para desktop ou dispositivos móveis, ou uma impressora em nuvem
• Impressoras USB e Bluetooth funcionam na web, mas apenas no Chrome ou Microsoft Edge (Safari e Firefox não suportam as APIs WebUSB / Web Bluetooth)
• Se o seu site usa HTTPS mas a impressora só aceita HTTP, o navegador pode bloquear a conexão como conteúdo misto — a impressora deve usar o mesmo HTTP/HTTPS do seu POS

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 ao alcance