Impressoras térmicas e etiquetas

Configure em 6 etapas

Antes de começar: é necessário o aplicativo independente para Windows. A impressora precisa aparecer como uma impressora normal do Windows. O Social Stream imprime pelo driver do Windows. Não envia comandos ESC/POS ou ZPL brutos nem comandos de SDK do fabricante.

Conecte a impressora por USB, ligue e instale o driver do Windows. Imprima uma página de teste do Windows para confirmar que funciona.
No Social Stream, abra Configurações e ferramentas globais → Mecânica - Conexões e integrações → Controle da impressora.
Clique em Encontrar impressoras. Escolha sua impressora pelo nome que o Windows mostra.
Informe Largura do papel (mm). Geralmente é 58, 80, ou 62.
Deixe Comprimento fixo da etiqueta em 0 para papel de recibo. Para etiquetas pré-cortadas, informe o comprimento da etiqueta em mm (na direção de alimentação do papel).
Clique em Imprimir teste. Se uma borda for cortada, aumente a margem de segurança desse lado e teste novamente.

As margens de segurança padrão de 2 mm à esquerda e à direita servem para muitas impressoras baratas de recibos de 58 mm. O driver define a área imprimível real, então mantenha Usar área imprimível selecionado, a menos que tenha testado outra configuração.

Imprima uma etiqueta quando alguém doar

💰 Doação / GorjetaValor mínimo: 10

🖨️ Imprimir etiqueta térmica

{username}
{donation}

24 pt · negrito · centralizado

Abra: Editor do Event Flow e crie um novo fluxo.
Adicione o Doação / Gorjeta gatilho. Defina Valor mínimo se apenas doações maiores devem imprimir.
Adicione Imprimir etiqueta térmica (em Integrações) e conecte o gatilho a ela.
Digite {username}, uma nova linha e depois {donation}. Escolha o tamanho da fonte, o peso, o alinhamento e as cópias.
Deixe vazias as substituições de impressora e comprimento fixo da ação, ou com valor 0. As configurações do Controle da impressora serão usadas.
Clique em Testar fluxo. Digite um nome, ative Tem doação (Has Donation), adicione um valor e execute. Isso imprime uma etiqueta real.

Outros marcadores úteis: {message}, {source}, {donationAmount}, e {counterValue}. Valores criados em etapas anteriores do fluxo também funcionam.

Imprima vendas, presentes e números de pedido

Quero imprimir…	Faça isto
Vendas	Use Tipo de evento com `purchase`. Doação / Gorjeta precisa de `hasDonation`, por isso não captura a maioria das vendas.
Presentes concluídos	Use `gift` ou `giftfunded`. Filtre por provedor se necessário.
Número sequencial de pedido	Adicione uma ação Contador antes da ação de impressão.

Veja: campos de eventos de comércio para ver o que cada venda inclui.

Comprador em negrito, item normal

Defina Peso como Texto selecionado.
Digite isto como texto da etiqueta:

**{username}**
{subtitle}

Só o texto entre ** fica em negrito. Não é necessário HTML nem JavaScript.
Use chaves simples. As vendas colocam o nome do produto em {subtitle}. A quantidade pode estar em {meta.commerce.quantity}.
Se uma etapa anterior criar buyer, use **{buyer}** em vez disso.
Shopify e eBay não enviam o nome do comprador. Use um contador de pedidos ou uma etiqueta só com o produto.
Etiquetas já configuradas como Tudo em negrito ou Normal mantêm sua aparência.

Para criar fluxos: resultados de impressão e números de comprador

A ação adiciona meta.thermalPrintResult.success, além de um erro ou código quando algo falha, para as próximas etapas. Sucesso significa que o trabalho foi enviado ao Windows, não que saiu papel. Confira a fila de impressão do Windows antes de tentar novamente para evitar etiquetas duplicadas.

Um contador numera compras, não compradores únicos. Para dar o mesmo número a cada compra de uma pessoa, é preciso uma lista separada que relacione comprador e número, reiniciada no começo de cada transmissão. O campo de motivo da Memória do usuário é texto simples, não um contador de compradores.

Etiquetas de itens do Whatnot

Baixar o fluxo de exemplo do Whatnot. Imprime o comprador em negrito, o nome do item e um ID de pedido quando houver. Se um pagamento falhar, imprime outra etiqueta marcada FALHA NO PAGAMENTO com os detalhes incluídos nesse aviso.

No aplicativo independente, configure Controle da impressora e execute sua impressão de teste.
Abra: Editor do Event Flow, clique em Importar, e escolha o arquivo baixado.
Selecione Whatnot: etiquetas de itens + avisos de pagamento. Confira as duas ações de impressão. Elas usam a impressora e o comprimento de etiqueta do Controle da impressora.
Ative o fluxo e salve. Ele é importado desativado.
Mantenha sua fonte Whatnot aberta com a captura de eventos da transmissão ativada.

Uma etiqueta de venda não significa que ela foi paga. Cada aviso é impresso quando chega. O fluxo não espera o pagamento, não corrige etiquetas anteriores nem atribui números de comprador. Campos ausentes ficam em branco. Um aviso de falha sem comprador, item ou detalhes do pedido não informa a qual etiqueta pertence.

Como funciona o fluxo de exemplo

Usa Event Type (Advanced) → Custom Event para product_sold e payment_failed, filtrados para Whatnot. Lances e avisos de fim de leilão não são impressos. Veja os campos de eventos do Whatnot.

Escolha o papel

Rolo de recibo

Para comprovantes de compra, senhas e recibos de qualquer comprimento. Deixe o comprimento fixo da etiqueta em 0.

Rolo contínuo de adesivos

Para tiras adesivas com nomes de qualquer comprimento. Funciona como papel de recibo, mas a impressora ou o driver precisa cortar.

Etiquetas pré-cortadas

Para crachás e etiquetas de produto do mesmo tamanho. Defina o comprimento fixo exato e escolha o mesmo papel nas Preferências de impressão do Windows.

Etiqueta de compra

COMPRADOR #12

Inky
Caneca Ninja azul

Papel de recibo de 58 mm. O comprimento aumenta com o texto.

Obrigado

INKY

$25.00 CAD

Etiqueta pré-cortada de tamanho fixo: nome e doação.

Retirada

A-037

Moletom Ninja
Tamanho G

Etiqueta de produto ou retirada usando detalhes do evento e um contador.

Exemplos de impressoras

Impressora	Bom para	Notas
“POS-58” genérica	Recibos baratos de 58 mm	Geralmente USB. Nomes e drivers variam por vendedor. Uma POS-58 básica foi usada para testar o Social Stream.
Epson TM-T20III	Uma impressora de recibos mais robusta	USB. Papel de 80 mm, ou 58 mm com o adaptador incluído.
Brother QL-800	Adesivos e etiquetas de nome	USB. Até 62 mm, pré-cortado ou contínuo, com cortador automático.
Brother QL-820NWB	Uma estação de etiquetas compartilhada ou em rede	USB, Ethernet, Wi-Fi e Bluetooth.
Zebra ZD220	Etiquetas mais largas para produtos, envios ou pulseiras	USB. Mídias de cerca de 25–112 mm. Versões térmica direta e de transferência térmica.

São exemplos, não uma lista de modelos testados. Antes de comprar, confira se o modelo exato tem um driver atual do Windows, aceita seu tamanho de etiqueta e aparece como uma impressora normal do Windows.

Configure corretamente etiquetas de tamanho fixo

Etiquetas de 3 × 1 polegadas (incluindo Munbyn BT320): defina a largura como 76.2 mm e o comprimento fixo como 25.4 mm quando o lado de 1 polegada entrar primeiro. Escolha o mesmo papel e direção nas Preferências de impressão do Windows. Comece com texto de 12–14 pt.

Regra	Por quê
Meça na direção de alimentação	Uma etiqueta de 62 × 29 mm costuma ter 62 mm de largura e comprimento fixo de 29 mm.
Ajuste também no Windows	Defina o mesmo papel, direção, detecção de espaços/marcas e cortador nas Preferências de impressão do driver.
Fixo significa fixo	Não há avanço extra. Texto alto demais pode ser cortado ou passar para outra etiqueta, dependendo do driver.
Teste seu texto mais longo	Nomes longos, opções de produto e linhas extras precisam de mais espaço ou texto menor.
Etiquetas muito curtas podem não funcionar	O Social Stream solicita pelo menos 20 mm. O driver ainda pode limitar tamanhos de página curtos.

As bordas laterais da impressão de teste mostram a largura segura. A altura acompanha o texto do teste. Ela não contorna a etiqueta inteira.

Ideias para a transmissão

Adesivos com nomes de apoiadores para uma parede, objeto de cena, mapa ou quadro de progresso.
Etiquetas de produtos, encomendas, bebidas ou retirada conforme os pedidos chegam.
Bilhetes de sorteio. Adicione limites de frequência e verificações de elegibilidade antes da etapa de impressão.
Crachás VIP, escolhas de time, fichas de desafio ou etiquetas de marcos.
Uma pequena lista de tarefas para um produtor ao seu lado.

Não imprima informações privadas. Evite endereços, e-mails, dados de pagamento e mensagens privadas. Papel térmico também desbota com calor, luz e tempo.

Resolver problemas

Problema	Tente isto
Nenhuma impressora aparece	Confira se o Windows consegue imprimir uma página de teste. Reinicie o Social Stream e clique em Encontrar impressoras novamente.
Diz sucesso, mas nada é impresso	Abra a fila da impressora no Windows. Procure erros de pausa, offline, papel, driver ou porta.
Uma borda é cortada	Mantenha Usar área imprimível ativado. Aumente a margem de segurança desse lado.
Papel em branco demais	Use comprimento fixo 0 para recibos. Reduza a margem inferior e o avanço extra. Para etiquetas, defina o comprimento exato.
Uma etiqueta é impressa em duas	O texto é mais alto que a etiqueta ou o Windows está com o tamanho de papel errado. Use menos texto, fonte menor, espaçamento mais apertado ou margens menores.
Testar fluxo usa a impressora errada	Escolha uma impressora específica na etapa Imprimir etiqueta térmica. Quando vazio, os testes no editor usam a impressora padrão do Windows.

Impressoras térmicas e etiquetas de transmissão