# 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](/pt-BR/receipts/cloud-printing.md). 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[​](#supported-printers-by-platform "Link direto para 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[​](#adding-a-printer "Link direto para 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[​](#connection-types-mobile-apps "Link direto para 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[​](#network "Link direto para 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](#finding-your-printers-ip-address). 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[​](#bluetooth "Link direto para 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[​](#usb-android-only "Link direto para 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[​](#advanced-settings "Link direto para 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](#full-receipt-raster) 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[​](#printer-options "Link direto para 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[​](#print-routing "Link direto para 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[​](#full-receipt-raster "Link direto para 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[​](#discovering-printers "Link direto para 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](#finding-your-printers-ip-address) 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[​](#finding-your-printers-ip-address "Link direto para 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[​](#static-ip-recommended "Link direto para 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://`) * Nas configurações de DHCP do seu roteador (atribua um IP reservado ao endereço MAC da impressora) ## Impressoras Epson[​](#epson-printers "Link direto para 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://` 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[​](#star-printers "Link direto para 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[​](#generic-printers "Link direto para 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[​](#cash-drawers "Link direto para 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[​](#troubleshooting "Link direto para 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](/pt-BR/receipts/cloud-printing.md) * 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