Impressora Térmica

Configure a impressão de comprovantes de venda em impressoras térmicas ESC/POS (80mm ou 58mm) através do agente local StoxisPrinter.

Como funciona

Como o Stoxis roda no navegador, ele não consegue acessar impressoras locais diretamente. Para isso, utilizamos um pequeno programa instalado no Windows chamado StoxisPrinter, que age como uma ponte entre o sistema e a impressora.

Stoxis (navegador)

gera comprovante

StoxisPrinter
localhost:3333

envia ao spooler

Impressora
USB / Rede

O StoxisPrinter atende apenas o próprio computador: ele precisa estar instalado e rodando em cada terminal que for imprimir, sempre no computador em que a impressora está conectada.

Requisitos

Sistema Operacional

Windows 10 64-bit ou superior
Windows 11 64-bit
macOS / Linux — não suportado

Impressora

Protocolo ESC/POS
Papel 80mm ou 58mm
Conexão USB
Instalada no spooler do Windows

Passo a passo: instalação

StoxisPrinter — Agente local para Windows

Baixe e instale no computador conectado à impressora.

Baixar StoxisPrinterSetup-v1.0.1.zip

Arquivo ZIP — extraia e execute o instalador StoxisPrinterSetup.exe dentro.

Baixe e instale o StoxisPrinter

Faça o download do arquivo ZIP acima no computador que tem a impressora conectada. Extraia o conteúdo e execute StoxisPrinterSetup.exe. Siga as etapas do instalador — ele criará um atalho no menu Iniciar e configurará o auto-start com o Windows.

Abra o StoxisPrinter

Após a instalação, o programa iniciará automaticamente. Um ícone aparecerá na bandeja do sistema (próximo ao relógio). Clique nele para abrir a janela de configuração.

Na janela do StoxisPrinter você verá:

Status do serviço — indica se o agente está rodando (porta 3333)
Impressora padrão — selecione a impressora térmica instalada
Largura do papel — escolha 80mm ou 58mm
Token de autenticação — código gerado automaticamente (copie este valor)

Copie o token de autenticação

Na janela do StoxisPrinter, localize o campo Token de autenticação e copie o valor exibido. Esse token é necessário para o Stoxis se comunicar com o agente com segurança.

Configure no Stoxis

No Stoxis, acesse Configurações → Impressora Térmica. Preencha os campos:

URL do agenteMantenha http://localhost:3333. Altere apenas a porta, e só se você tiver mudado a porta na janela do StoxisPrinter.

TokenCole o token copiado do StoxisPrinter no passo anterior.

Salve e teste

Clique em Salvar configurações. O sistema verificará a conexão automaticamente. Em seguida, clique em Testar impressão — a impressora deve imprimir um comprovante de teste. Se funcionar, a configuração está concluída!

Largura do papel: 80mm vs 58mm

O StoxisPrinter informa automaticamente ao Stoxis qual largura de papel está configurada. O comprovante é gerado com a quantidade certa de colunas para cada formato:

80mm— padrão

48 colunas de texto. Ideal para comprovantes com mais detalhes. É o formato mais comum em lojas.

58mm

32 colunas de texto. Comprovantes mais compactos. Comum em impressoras de menor porte.

Configure a largura corretamente no StoxisPrinter. Se o comprovante sair com texto quebrado ou mal alinhado, verifique se o valor está correspondendo ao papel carregado na impressora.

Problemas comuns

Agente não encontrado / não conecta

• Verifique se o StoxisPrinter está aberto (ícone na bandeja do sistema).

• Confirme a URL configurada no Stoxis (padrão: http://localhost:3333).

• Confirme que a porta na URL é a mesma exibida na janela do StoxisPrinter.

Erro 401 — Token inválido

• O token configurado no Stoxis não bate com o gerado pelo StoxisPrinter.

• Abra o StoxisPrinter, copie o token exibido e cole novamente em Configurações → Impressora Térmica.

Impressão não sai / impressora não responde

• Verifique se a impressora está ligada, com papel e sem erros (luz vermelha).

• Confirme que a impressora selecionada no StoxisPrinter é a correta (bata com o nome no Painel de Controle → Dispositivos e Impressoras).

• Tente imprimir um página de teste diretamente pelo Windows para validar que a impressora está funcionando.

Texto mal formatado ou quebrado no comprovante

• A largura do papel configurada no StoxisPrinter não corresponde ao papel físico. Ajuste para 80mm ou 58mm conforme o rolo instalado.

• Reinicie o StoxisPrinter após alterar a largura.

StoxisPrinter não inicia com o Windows

• O instalador configura o auto-start automaticamente. Se não estiver funcionando, abra o StoxisPrinter manualmente e habilite a opção "Iniciar com o Windows" dentro da tela de configurações do programa.

Após qualquer alteração nas configurações do StoxisPrinter (impressora padrão, largura, token), clique em Verificar conexão no Stoxis para confirmar que tudo está funcionando antes de atender clientes.

Planos FAQ