Stampanti termiche ed etichette - Social Stream Ninja

Configura in 6 passaggi

Prima di iniziare: serve l'app autonoma per Windows. La stampante deve apparire come una normale stampante Windows. Social Stream stampa tramite il driver Windows. Non invia comandi ESC/POS o ZPL grezzi né comandi SDK del produttore.

Collega la stampante via USB, accendila e installa il driver Windows. Stampa una pagina di prova di Windows per verificarne il funzionamento.
In Social Stream, apri Impostazioni e strumenti globali → Meccanismi - Connessioni e integrazioni → Controllo stampante.
Fai clic su Trova stampanti (Find printers). Scegli la stampante con il nome mostrato da Windows.
Inserisci Larghezza carta (mm). Di solito è 58, 80, oppure 62.
Lascia Lunghezza fissa dell'etichetta a 0 per la carta per ricevute. Per le etichette pretagliate, inserisci la lunghezza in mm (nella direzione di avanzamento della carta).
Fai clic su Stampa di prova. Se un bordo viene tagliato, aumenta il margine di sicurezza di quel lato e riprova.

I margini di sicurezza predefiniti di 2 mm a sinistra e a destra sono adatti a molte stampanti economiche per ricevute da 58 mm. Il driver determina l'area stampabile effettiva, quindi mantieni Usa area stampabile (Use printable area) selezionato, a meno che tu abbia provato un'altra configurazione.

Stampa un'etichetta quando qualcuno dona

💰 Donazione / Mancia (Donation / Tip)Importo minimo (Minimum Amount): 10

🖨️ Stampa etichetta termica (Print Thermal Label)

{username}
{donation}

24 pt · grassetto · centrato

Apri Editor Event Flow e crea un nuovo flusso.
Aggiungi il trigger Donazione / Mancia (Donation / Tip) . Imposta Importo minimo (Minimum Amount) se devono essere stampate solo le donazioni più grandi.
Aggiungi Stampa etichetta termica (Print Thermal Label) (in Integrazioni) e collegaci il trigger.
Scrivi {username}, una nuova riga, poi {donation}. Scegli dimensione del carattere, spessore, allineamento e copie.
Lascia vuote le impostazioni specifiche di stampante e lunghezza fissa dell'azione, oppure a 0. Verranno usate le impostazioni di Controllo stampante.
Fai clic su Prova flusso (Test Flow). Inserisci un nome, attiva Contiene donazione (Has Donation), aggiungi un importo ed esegui. Verrà stampata un'etichetta reale.

Altri segnaposto utili: {message}, {source}, {donationAmount}, e {counterValue}. Funzionano anche i valori creati dai passaggi precedenti del flusso.

Stampa vendite, regali e numeri d'ordine

Voglio stampare…	Fai così
Vendite	Usa Tipo di evento con `purchase`. Donazione / Mancia (Donation / Tip) richiede `hasDonation`, quindi ignora la maggior parte delle vendite.
Regali completati	Usa `gift` oppure `giftfunded`. Filtra per fornitore se necessario.
Numero d'ordine progressivo	Aggiungi un Contatore prima dell'azione di stampa.

Consulta campi degli eventi commerciali per sapere cosa include ogni vendita.

Acquirente in grassetto, articolo in testo normale

Imposta Spessore a Testo selezionato.
Inserisci questo testo per l'etichetta:

**{username}**
{subtitle}

Solo il testo tra ** diventa grassetto. Non servono HTML o JavaScript.
Usa parentesi graffe singole. Le vendite inseriscono il nome del prodotto in {subtitle}. La quantità può essere in {meta.commerce.quantity}.
Se un passaggio precedente crea buyer, usa **{buyer}** in alternativa.
Shopify ed eBay non inviano il nome dell'acquirente. Usa un contatore di ordini o un'etichetta con il solo prodotto.
Le etichette già impostate su Tutto in grassetto o Normale mantengono il loro aspetto.

Per creare flussi: risultati di stampa e numeri acquirente

L'azione aggiunge meta.thermalPrintResult.success, più un errore o un codice in caso di problemi, per i passaggi successivi. Il successo indica che il lavoro è stato inviato a Windows, non che sia uscito il foglio. Controlla la coda di stampa di Windows prima di riprovare per evitare etichette duplicate.

Un contatore numera gli acquisti, non gli acquirenti unici. Per assegnare lo stesso numero a ogni acquisto di una persona serve un elenco separato che associ acquirente e numero, azzerato a inizio diretta. Il campo motivo di Memoria utente è testo semplice, non un contatore di acquirenti.

Etichette degli articoli Whatnot

Scarica il flusso di esempio Whatnot. Stampa l'acquirente in grassetto, il nome dell'articolo e un ID ordine se disponibile. Se un pagamento fallisce, stampa un'altra etichetta contrassegnata PAGAMENTO NON RIUSCITO con i dettagli inclusi in quell'avviso.

Nell'app autonoma, configura Controllo stampante (Printer Control) ed esegui la stampa di prova.
Apri Editor Event Flow, fai clic su Importa (Import), e scegli il file scaricato.
Seleziona Whatnot: etichette articoli + avvisi di pagamento. Controlla entrambe le azioni di stampa. Usano la stampante e la lunghezza etichetta di Controllo stampante.
Attiva il flusso e salva. Viene importato disattivato.
Mantieni aperta la sorgente Whatnot con la cattura degli eventi della diretta attiva.

Un'etichetta di vendita non significa che sia stata pagata. Ogni avviso viene stampato all'arrivo. Il flusso non attende il pagamento, non corregge etichette precedenti e non assegna numeri agli acquirenti. I campi mancanti restano vuoti. Un avviso di errore senza acquirente, articolo o dettagli dell'ordine non permette di identificare l'etichetta corrispondente.

Come funziona il flusso di esempio

Usa Tipo di evento (avanzato) → Evento personalizzato (Event Type (Advanced) → Custom Event) per product_sold e payment_failed, filtrati per Whatnot. Le offerte e gli avvisi di fine asta non vengono stampati. Consulta i campi degli eventi Whatnot.

Scegli la carta

Rotolo per ricevute

Per ricevute di acquisto, biglietti di coda e ricevute di qualsiasi lunghezza. Lascia la lunghezza fissa dell'etichetta a 0.

Rotolo adesivo continuo

Per strisce adesive con nomi di qualsiasi lunghezza. Funziona come la carta per ricevute, ma il taglio deve essere gestito dalla stampante o dal driver.

Etichette pretagliate

Per badge ed etichette prodotto delle stesse dimensioni. Imposta la lunghezza fissa esatta e scegli lo stesso supporto nelle Preferenze di stampa di Windows.

Etichetta di acquisto

ACQUIRENTE #12

Inky
Tazza Ninja blu

Carta per ricevute da 58 mm. La lunghezza aumenta con il testo.

Grazie

INKY

$25.00 CAD

Etichetta pretagliata di dimensione fissa: nome e donazione.

Ritiro

A-037

Felpa Ninja
Taglia L

Etichetta di prodotto o ritiro con dettagli dell'evento e un contatore.

Esempi di stampanti

Stampante	Adatto a	Note
Generica “POS-58”	Ricevute economiche da 58 mm	Di solito USB. Nomi e driver variano per venditore. Una POS-58 di base è stata usata per testare Social Stream.
Epson TM-T20III	Una stampante per ricevute più robusta	USB. Carta da 80 mm, oppure 58 mm con l'adattatore incluso.
Brother QL-800	Adesivi ed etichette con nomi	USB. Fino a 62 mm, pretagliato o continuo, con taglierina automatica.
Brother QL-820NWB	Una postazione di etichettatura condivisa o in rete	USB, Ethernet, Wi-Fi e Bluetooth.
Zebra ZD220	Etichette più larghe per prodotti, spedizioni o braccialetti	USB. Supporti da circa 25–112 mm. Versioni termica diretta e a trasferimento termico.

Sono esempi, non un elenco di modelli testati. Prima dell'acquisto, verifica che il modello esatto abbia un driver Windows aggiornato, supporti le tue etichette e appaia come una normale stampante Windows.

Configura correttamente le etichette di dimensione fissa

Etichette da 3 × 1 pollici (anche con Munbyn BT320): imposta la larghezza a 76.2 mm e la lunghezza fissa a 25.4 mm quando il lato da 1 pollice avanza per primo. Scegli lo stesso supporto e orientamento nelle Preferenze di stampa di Windows. Inizia con testo da 12–14 pt.

Regola	Perché
Misura nella direzione di avanzamento	Un'etichetta da 62 × 29 mm è solitamente larga 62 mm con lunghezza fissa di 29 mm.
Fai corrispondere anche Windows	Imposta lo stesso supporto, orientamento, rilevamento di spazi o segni e taglierina nelle Preferenze di stampa del driver.
Fisso significa fisso	Non viene aggiunto avanzamento extra. Il testo troppo alto può essere tagliato o finire sull'etichetta successiva, a seconda del driver.
Prova il testo più lungo	Nomi lunghi, opzioni di prodotto e righe aggiuntive richiedono più spazio o testo più piccolo.
Le etichette molto corte potrebbero non funzionare	Social Stream richiede almeno 20 mm. Il driver può comunque limitare le dimensioni delle pagine corte.

I bordi laterali della stampa di prova mostrano la larghezza sicura. L'altezza segue il testo di prova. Non delinea l'intera etichetta.

Idee per la diretta

Adesivi con i nomi dei sostenitori per una parete, un accessorio, una mappa o un tabellone di avanzamento.
Etichette di prodotti, commissioni, bevande o ritiro all'arrivo degli ordini.
Biglietti della lotteria. Aggiungi limiti di frequenza e controlli di idoneità prima del passaggio di stampa.
Badge VIP, scelte di squadra, gettoni sfida o etichette di traguardi.
Un breve elenco di attività per un produttore seduto accanto a te.

Non stampare informazioni private. Evita indirizzi, email, dati di pagamento e messaggi privati. La carta termica sbiadisce con calore, luce e tempo.

Risolvere i problemi

Problema	Prova così
Non appare nessuna stampante	Verifica che Windows possa stampare una pagina di prova. Riavvia Social Stream e fai di nuovo clic su Trova stampanti.
Indica successo, ma non stampa nulla	Apri la coda della stampante in Windows. Cerca pause, stato offline o errori di carta, driver o porta.
Un bordo viene tagliato	Mantieni attivo Usa area stampabile. Aumenta il margine di sicurezza di quel lato.
Troppa carta bianca	Usa lunghezza fissa 0 per le ricevute. Riduci il margine inferiore e l'avanzamento extra. Per le etichette, imposta la lunghezza esatta.
Un'etichetta viene stampata su due	Il testo è più alto dell'etichetta o Windows ha un formato di supporto errato. Usa meno testo, caratteri più piccoli, spaziatura più stretta o margini minori.
Prova flusso usa la stampante sbagliata	Scegli una stampante specifica nel passaggio Stampa etichetta termica. Se il campo è vuoto, i test nell'editor usano la stampante predefinita di Windows.

Stampanti termiche ed etichette per la diretta