Configurando sua primeira impressora Bluetooth no EtiquetaChef

EtiquetaChef suporta três protocolos de impressão térmica via Bluetooth Classic (SPP): TSPL, CPCL e ESC/POS. 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. Conexão Bluetooth Classic (SPP) — não confundir com BLE (Low Energy). A maioria das impressoras profissionais usa Classic; etiquetas pequenas para uso pessoal podem usar BLE, que não funciona com EtiquetaChef.
2. Protocolo declarado no manual ou ficha técnica: TSPL, CPCL ou ESC/POS. Algumas marcas suportam mais de um.
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):

• Zebra ZQ320 (CPCL/ZPL) — robusta, bateria boa, mais cara.
• Argox PT-280 (TSPL) — boa relação custo-benefício.
• TSC Alpha-30L (TSPL) — popular em food service.
• Genéricas chinesas ESC/POS — funcionam, mas variam muito em qualidade. Confirme protocolo 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 “Zebra-XXXX” ou “PT-280-XX”. Toque para parear.
4. Confirme o código (geralmente 0000 ou 1234).

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, CPCL ou ESC/POS (segundo o manual).
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 ESC/POS quando deveria ser TSPL

Cada protocolo tem comandos diferentes. Se a impressora suporta dois protocolos, ela precisa estar configurada para o modo certo no firmware (DIP switches físicos ou via software do fabricante). EtiquetaChef apenas envia o que você selecionou no app.

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 help@etiquetachef.com com a marca e modelo da impressora — a gente costuma já ter a configuração que funciona.