Termoimpresoras y etiquetas - Social Stream Ninja

Configúralo en 6 pasos

Antes de empezar: se necesita la aplicación independiente de Windows. La impresora debe aparecer como una impresora normal de Windows. Social Stream imprime mediante el controlador de Windows. No envía comandos ESC/POS ni ZPL sin procesar, ni comandos del SDK del fabricante.

Conecta la impresora por USB, enciéndela e instala su controlador de Windows. Imprime una página de prueba de Windows para comprobar que funciona.
En Social Stream, abre Ajustes y herramientas globales → Mecánica - Conexiones e integraciones → Control de impresora.
Haz clic en Buscar impresoras (Find printers). Elige tu impresora por el nombre que muestra Windows.
Introduce Ancho del papel (mm). Normalmente es 58, 80, o 62.
Deja Longitud fija de etiqueta en 0 para papel de recibos. Para etiquetas troqueladas, introduce la longitud de la etiqueta en mm (en la dirección de avance del papel).
Haz clic en Imprimir prueba. Si se corta un borde, aumenta el margen de seguridad de ese lado y vuelve a probar.

Los márgenes de seguridad predeterminados de 2 mm a izquierda y derecha sirven para muchas impresoras económicas de recibos de 58 mm. El controlador determina el área imprimible real, así que mantén Usar área imprimible (Use printable area) activado salvo que hayas probado otra configuración.

Imprime una etiqueta cuando alguien done

💰 Donación / PropinaImporte mínimo: 10

🖨️ Imprimir etiqueta térmica

{username}
{donation}

24 pt · negrita · centrado

Abre: Editor de Event Flow y crea un flujo nuevo.
Añade el Donación / Propina (Donation / Tip) como disparador. Establece Importe mínimo (Minimum Amount) si solo deben imprimirse las donaciones más grandes.
Añade Imprimir etiqueta térmica (Print Thermal Label) (en Integraciones) y conecta el disparador.
Escribe {username}, una nueva línea y luego {donation}. Elige el tamaño de letra, el grosor, la alineación y el número de copias.
Deja vacíos los ajustes de impresora y longitud fija de la acción, o con valor 0. Se usarán los ajustes de Control de impresora.
Haz clic en Probar flujo (Test Flow). Introduce un nombre, activa Tiene donación (Has Donation), añade un importe y ejecútalo. Se imprimirá una etiqueta real.

Otros marcadores útiles: {message}, {source}, {donationAmount}, y {counterValue}. También funcionan los valores creados en pasos anteriores del flujo.

Imprime ventas, regalos y números de pedido

Quiero imprimir…	Haz esto
Ventas	Usa Tipo de evento con `purchase`. Donación / Propina (Donation / Tip) necesita `hasDonation`, por lo que omite la mayoría de las ventas.
Regalos completados	Usa `gift` o `giftfunded`. Filtra por proveedor si es necesario.
Número de pedido consecutivo	Añade un Contador (Counter) antes de la acción de impresión.

Consulta: campos de eventos de comercio para ver qué incluye cada venta.

Comprador en negrita y artículo en texto normal

Configura Grosor a Texto seleccionado.
Introduce este texto para la etiqueta:

**{username}**
{subtitle}

Solo el texto entre ** se pone en negrita. No hace falta HTML ni JavaScript.
Usa llaves simples. Las ventas incluyen el nombre del producto en {subtitle}. La cantidad puede estar en {meta.commerce.quantity}.
Si un paso anterior crea buyer, usa **{buyer}** en su lugar.
Shopify y eBay no envían el nombre del comprador. Usa un contador de pedidos o una etiqueta que solo muestre el producto.
Las etiquetas configuradas como Todo en negrita o Normal conservan su aspecto.

Para crear flujos: resultados de impresión y números de comprador

La acción añade meta.thermalPrintResult.success, además de un error o código si algo falla, para los pasos posteriores. El éxito significa que el trabajo se envió a Windows, no que salió papel. Comprueba la cola de impresión de Windows antes de reintentar para evitar etiquetas duplicadas.

Un contador numera compras, no compradores únicos. Para dar el mismo número a cada compra de una persona, necesitas una lista independiente de comprador a número, reiniciada al comienzo de cada transmisión. El campo de motivo de Memoria de usuario es texto simple, no un contador de compradores.

Etiquetas de artículos de Whatnot

Descargar el flujo de ejemplo de Whatnot. Imprime el comprador en negrita, el nombre del artículo y un identificador de pedido si existe. Si falla un pago, imprime otra etiqueta marcada PAGO FALLIDO con los datos que incluya ese aviso.

En la aplicación independiente, configura Control de impresora (Printer Control) y ejecuta su prueba de impresión.
Abre: Editor de Event Flow, haz clic en Importar (Import), y elige el archivo descargado.
Selecciona Whatnot: etiquetas de artículos + avisos de pago. Comprueba ambas acciones de impresión. Usan la impresora y la longitud de etiqueta de Control de impresora.
Activa el flujo y guarda. Se importa desactivado.
Mantén abierta tu fuente de Whatnot con la captura de eventos de transmisión activada.

Una etiqueta de venta no significa que esté pagada. Cada aviso se imprime al llegar. El flujo no espera al pago, no corrige etiquetas anteriores ni asigna números de comprador. Los campos ausentes se imprimen vacíos. Un aviso de error sin comprador, artículo ni datos de pedido no permite identificar a qué etiqueta corresponde.

Cómo funciona el flujo de ejemplo

Usa Tipo de evento (avanzado) → Evento personalizado para product_sold y payment_failed, filtrados para Whatnot. Las pujas y los avisos de fin de subasta no se imprimen. Consulta los campos de eventos de Whatnot.

Elige el papel

Rollo de recibos

Para comprobantes de compra, turnos y recibos de cualquier longitud. Deja la longitud fija de etiqueta en 0.

Rollo adhesivo continuo

Para tiras adhesivas con nombres de cualquier longitud. Funciona como papel de recibos, pero la impresora o el controlador deben cortarlo.

Etiquetas troqueladas

Para credenciales y etiquetas de producto del mismo tamaño. Configura la longitud fija exacta y elige el mismo papel en Preferencias de impresión de Windows.

Etiqueta de compra

COMPRADOR N.º 12

Inky
Taza Ninja azul

Papel de recibos de 58 mm. La longitud crece con el texto.

Gracias

INKY

25,00 $ CAD

Etiqueta troquelada de tamaño fijo: nombre y donación.

Recogida

A-037

Sudadera Ninja
Talla L

Etiqueta de mercancía o recogida con datos del evento y un contador.

Ejemplos de impresoras

Impresora	Adecuado para	Notas
«POS-58» genérica	Recibos económicos de 58 mm	Normalmente USB. Los nombres y controladores varían según el vendedor. Se usó una POS-58 básica para probar Social Stream.
Epson TM-T20III	Una impresora de recibos más robusta	USB. Papel de 80 mm, o de 58 mm con el adaptador incluido.
Brother QL-800	Pegatinas y etiquetas con nombres	USB. Hasta 62 mm, troquelado o continuo, con cortador automático.
Brother QL-820NWB	Una estación de etiquetas compartida o en red	USB, Ethernet, Wi-Fi y Bluetooth.
Zebra ZD220	Etiquetas más anchas para productos, envíos o pulseras	USB. Soportes de unos 25–112 mm. Versiones térmica directa y de transferencia térmica.

Son ejemplos, no una lista de modelos probados. Antes de comprar, comprueba que el modelo exacto tenga un controlador actual de Windows, admita el tamaño de tus etiquetas y aparezca como una impresora normal de Windows.

Configura correctamente las etiquetas de tamaño fijo

Etiquetas de 3 × 1 pulgadas (también con Munbyn BT320): configura el ancho en 76.2 mm y la longitud fija en 25.4 mm cuando el lado de 1 pulgada avance primero. Elige el mismo papel y orientación en Preferencias de impresión de Windows. Empieza con texto de 12–14 pt.

Regla	Por qué
Mide en la dirección de avance	Una etiqueta de 62 × 29 mm suele tener 62 mm de ancho y una longitud fija de 29 mm.
Haz coincidir también Windows	Configura el mismo papel, orientación, detección de huecos/marcas y cortador en las Preferencias de impresión del controlador.
Fijo significa fijo	No se añade avance adicional. El texto demasiado alto puede cortarse o pasar a otra etiqueta, según el controlador.
Prueba el texto más largo	Los nombres largos, las opciones de producto y las líneas adicionales necesitan más espacio o texto más pequeño.
Las etiquetas muy cortas pueden no funcionar	Social Stream solicita al menos 20 mm. El controlador puede limitar de todos modos los tamaños de página cortos.

Los bordes laterales de la prueba de impresión muestran el ancho seguro. Su altura sigue el texto de prueba. No dibuja el contorno de toda la etiqueta.

Ideas para la transmisión

Pegatinas con nombres de seguidores para una pared, accesorio, mapa o tablero de progreso.
Etiquetas de mercancía, encargos, bebidas o recogida a medida que llegan pedidos.
Boletos de sorteo. Añade límites de frecuencia y comprobaciones de participación antes del paso de impresión.
Credenciales VIP, selecciones de equipo, fichas de retos o etiquetas de hitos.
Una lista breve de tareas para un productor sentado a tu lado.

No imprimas información privada. Omite direcciones, correos, datos de pago y mensajes privados. El papel térmico también se desvanece con el calor, la luz y el tiempo.

Solucionar problemas

Problema	Prueba esto
No aparece ninguna impresora	Comprueba que Windows pueda imprimir una página de prueba. Reinicia Social Stream y vuelve a hacer clic en Buscar impresoras.
Indica éxito, pero no imprime nada	Abre la cola de la impresora en Windows. Busca errores de pausa, desconexión, papel, controlador o puerto.
Se corta un borde	Mantén activada Usar área imprimible. Aumenta el margen de seguridad de ese lado.
Demasiado papel en blanco	Usa longitud fija 0 para recibos. Reduce el margen inferior y el avance adicional. Para etiquetas, configura la longitud exacta.
Una etiqueta se imprime en dos	El texto es más alto que la etiqueta o Windows tiene configurado un tamaño de papel incorrecto. Usa menos texto, una fuente más pequeña, menos espaciado o márgenes menores.
Probar flujo usa la impresora incorrecta	Elige una impresora específica en el paso Imprimir etiqueta térmica. Si está vacío, las pruebas en el editor usan la impresora predeterminada de Windows.

Impresoras térmicas y etiquetas para transmisiones