Configurando sua primeira impressora Bluetooth no EtiquetaChef

O EtiquetaChef imprime em impressoras térmicas Bluetooth com protocolo TSPL. Outros protocolos (CPCL, ESC/POS, ZPL) são atendidos sob solicitação — fale com o nosso comercial. Esse guia cobre o caminho mais comum — comprou uma impressora, quer imprimir a primeira etiqueta hoje.

Antes de comprar — o que verificar

Não é toda impressora térmica Bluetooth que serve. Confirme antes:

1. Bluetooth do jeito que o seu aparelho usa — no Android a conexão é Bluetooth Classic (SPP); no iPhone e no iPad é Bluetooth LE (GATT). Confirme na ficha técnica que o modelo tem o que o seu aparelho precisa — muitos modelos têm os dois.
2. Protocolo TSPL declarado no manual ou ficha técnica. Algumas marcas suportam mais de um — o que importa é o TSPL estar entre eles.
3. Largura da bobina — 40 mm ou 60 mm são as mais usadas. Defina antes de comprar etiquetas avulsas.
4. Resolução — 203 dpi (8 pontos/mm) é o padrão. 300 dpi melhora código de barras finos, mas é mais cara.

Modelos populares no mercado (Brasil/LATAM):

• Argox PT-280 (TSPL) — boa relação custo-benefício.
• TSC Alpha-30L (TSPL) — popular em food service.
• Genéricas chinesas com TSPL — funcionam, mas variam muito em qualidade. Confirme o TSPL antes.

Pareando com o celular

1. Ligue a impressora e mantenha pressionado o botão de pareamento (consulte o manual — geralmente é “PWR” + “FEED” simultâneo).
2. No Android, abra Configurações → Bluetooth.
3. Aparelho aparece como “PT-280-XX” (ou o nome do modelo). Toque para parear.
4. Confirme o código (geralmente 0000 ou 1234).
5. No iPhone e no iPad não é preciso parear nos Ajustes: pule os passos acima — o app encontra a impressora por Bluetooth LE na etapa seguinte.

Conectando no EtiquetaChef

1. Abra o app EtiquetaChef.
2. Vá em Configurações → Impressoras.
3. Toque em Adicionar impressora.
4. App lista os dispositivos Bluetooth pareados — escolha a sua.
5. Selecione o protocolo TSPL.
6. Defina largura (40 ou 60 mm) e resolução (203 dpi padrão).
7. Toque em Imprimir teste — se sair uma etiqueta com layout básico, está funcionando.

Problemas mais comuns

Etiqueta sai em branco

Cabeça térmica precisa do papel certo. Etiqueta normal de impressora laser não funciona. Use papel térmico para impressora térmica direta, conforme spec da impressora.

Etiqueta sai com texto cortado

Largura configurada não bate com a bobina física. Confira em Configurações → Impressoras o valor de “Width” e ajuste.

Não conecta após pareado

Algumas impressoras “esquecem” o pareamento se ficam desligadas muito tempo. Repita o passo 1 (modo de pareamento) e refaça.

Imprime caracteres estranhos em vez da etiqueta

A impressora provavelmente está em outro modo (ESC/POS, por exemplo). Se ela suporta mais de um protocolo, precisa estar configurada para TSPL no firmware (DIP switches físicos ou via software do fabricante). O EtiquetaChef envia os comandos em TSPL.

Próximos passos

Com a impressora funcionando, você está pronto para:

• Cadastrar produtos com regras de validade.
• Importar EAN via leitor de código de barras (câmera ou scanner Bluetooth dedicado).
• Imprimir em lote — selecione 10 produtos e mande pra fila.

Se travar em algum passo, manda um email pra nossa página de contato com a marca e modelo da impressora — a gente costuma já ter a configuração que funciona.