Imprimantes thermiques et étiquettes

Configurer en 6 étapes

Avant de commencer : l'application Windows autonome est nécessaire. Votre imprimante doit apparaître comme une imprimante Windows classique. Social Stream imprime via le pilote Windows. Il n'envoie pas de commandes ESC/POS ou ZPL brutes, ni de commandes du SDK du fabricant.

Branchez l'imprimante en USB, allumez-la et installez son pilote Windows. Imprimez une page de test Windows pour vérifier son fonctionnement.
Dans Social Stream, ouvrez Réglages et outils globaux → Mécanismes - Connexions et intégrations → Contrôle de l'imprimante.
Cliquez sur Rechercher les imprimantes (Find printers). Choisissez votre imprimante d'après le nom affiché dans Windows.
Saisissez Largeur du papier (mm). C'est généralement 58, 80, ou 62.
Laissez Longueur fixe de l’étiquette (Fixed label length) à 0 pour le papier de reçu. Pour les étiquettes prédécoupées, saisissez la longueur en mm (dans le sens d'avance du papier).
Cliquez sur Imprimer un test. Si un bord est coupé, augmentez la marge de sécurité de ce côté et réessayez.

Les marges de sécurité par défaut de 2 mm à gauche et à droite conviennent à de nombreuses imprimantes de reçus économiques de 58 mm. Le pilote détermine la zone imprimable réelle ; gardez donc Utiliser la zone imprimable (Use printable area) sélectionné, sauf si vous avez testé une autre configuration.

Imprimer une étiquette lors d'un don

💰 Don / Pourboire (Donation / Tip)Montant minimum (Minimum Amount) : 10

🖨️ Imprimer une étiquette thermique (Print Thermal Label)

{username}
{donation}

24 pt · gras · centré

Ouvrez : Éditeur Event Flow et créez un nouveau flux.
Ajoutez le déclencheur Don / Pourboire (Donation / Tip) . Réglez Montant minimum (Minimum Amount) si seuls les dons plus importants doivent être imprimés.
Ajouter Imprimer une étiquette thermique (Print Thermal Label) (dans Intégrations) et connectez-y le déclencheur.
Tapez {username}, une nouvelle ligne, puis {donation}. Choisissez la taille de police, la graisse, l'alignement et le nombre de copies.
Laissez les réglages spécifiques d'imprimante et de longueur fixe de l'action vides ou à 0. Les réglages du Contrôle de l'imprimante seront utilisés.
Cliquez sur Tester le flux (Test Flow). Saisissez un nom, activez Montant du don (Has Donation), ajoutez un montant et lancez le test. Une vraie étiquette sera imprimée.

Autres variables utiles : {message}, {source}, {donationAmount}, et {counterValue}. Les valeurs créées par les étapes précédentes du flux fonctionnent aussi.

Imprimer ventes, cadeaux et numéros de commande

Je veux imprimer…	Procédez ainsi
Ventes	Utilisez Type d'événement (Event Type) avec `purchase`. Don / Pourboire (Donation / Tip) nécessite `hasDonation`, ce qui exclut la plupart des ventes.
Cadeaux finalisés	Utilisez `gift` ou `giftfunded`. Filtrez par fournisseur si nécessaire.
Numéro de commande séquentiel	Ajoutez un Compteur (Counter) avant l'action d'impression.

Consultez : champs des événements commerciaux pour savoir ce que contient chaque vente.

Acheteur en gras, article en texte normal

Définissez Graisse à Texte sélectionné.
Saisissez ce texte pour l'étiquette :

**{username}**
{subtitle}

Seul le texte entre ** passe en gras. Aucun HTML ni JavaScript n'est nécessaire.
Utilisez des accolades simples. Les ventes placent le nom du produit dans {subtitle}. La quantité peut se trouver dans {meta.commerce.quantity}.
Si une étape précédente crée buyer, utilisez **{buyer}** à la place.
Shopify et eBay n'envoient pas le nom de l'acheteur. Utilisez un compteur de commandes ou une étiquette avec le produit uniquement.
Les étiquettes réglées sur Tout en gras ou Normal conservent leur apparence.

Pour créer des flux : résultats d'impression et numéros d'acheteur

L'action ajoute meta.thermalPrintResult.success, ainsi qu'une erreur ou un code en cas d'échec, pour les étapes suivantes. Un succès signifie que la tâche a été envoyée à Windows, pas que du papier est sorti. Vérifiez la file d'impression Windows avant de réessayer pour éviter les doublons.

Un compteur numérote les achats, pas les acheteurs uniques. Donner le même numéro à chaque achat d'une personne nécessite une liste distincte associant acheteur et numéro, réinitialisée au début de chaque diffusion. Le champ de motif de la Mémoire utilisateur est du texte simple, pas un compteur d'acheteurs.

Étiquettes d'articles Whatnot

Télécharger le flux d’exemple Whatnot. Il imprime l'acheteur en gras, le nom de l'article et un identifiant de commande s'il existe. En cas d'échec de paiement, il imprime une autre étiquette marquée ÉCHEC DU PAIEMENT avec les détails fournis dans cet avis.

Dans l'application autonome, configurez Contrôle de l’imprimante (Printer Control) et lancez son test d'impression.
Ouvrez : Éditeur Event Flow, cliquez sur Importer (Import), puis choisissez le fichier téléchargé.
Sélectionnez Whatnot : étiquettes d’articles et avertissements de paiement. Vérifiez les deux actions d'impression. Elles utilisent l'imprimante et la longueur d'étiquette du Contrôle de l'imprimante.
Activez le flux et enregistrez. Il est désactivé à l'importation.
Gardez votre source Whatnot ouverte avec la capture des événements de diffusion activée.

Une étiquette de vente ne signifie pas qu'elle est payée. Chaque avis est imprimé à son arrivée. Le flux n'attend pas le paiement, ne corrige pas une étiquette précédente et n'attribue pas de numéros d'acheteur. Les champs manquants restent vides. Un avis d'échec sans acheteur, article ou détails de commande ne permet pas d'identifier l'étiquette concernée.

Fonctionnement du flux d'exemple

Il utilise Type d’événement avancé → Événement personnalisé (Event Type (Advanced) → Custom Event) pour product_sold et payment_failed, filtrés sur Whatnot. Les enchères et les avis de fin d'enchère ne sont pas imprimés. Consultez les champs d’événements Whatnot.

Choisir le papier

Rouleau à reçus

Pour les bons d'achat, tickets de file d'attente et reçus de toute longueur. Laissez la longueur fixe d'étiquette à 0.

Rouleau d’étiquettes continu

Pour des bandes adhésives avec noms de toute longueur. Fonctionne comme le papier de reçu, mais l'imprimante ou le pilote doit assurer la découpe.

Étiquettes prédécoupées

Pour des badges et étiquettes produit de même taille. Définissez la longueur fixe exacte et choisissez le même support dans les préférences d'impression Windows.

Étiquette d’achat

ACHETEUR #12

Inky
Mug Ninja bleu

Papier de reçu de 58 mm. La longueur augmente avec le texte.

Merci

INKY

$25.00 CAD

Étiquette prédécoupée de taille fixe : nom et don.

Retrait

A-037

Sweat à capuche Ninja
Taille L

Étiquette de produit ou de retrait utilisant les détails de l'événement et un compteur.

Exemples d'imprimantes

Imprimante	Adapté à	Remarques
« POS-58 » générique	Reçus économiques de 58 mm	Généralement USB. Les noms et pilotes varient selon le vendeur. Une POS-58 basique a servi à tester Social Stream.
Epson TM-T20III	Une imprimante de reçus plus robuste	USB. Papier de 80 mm, ou de 58 mm avec l'adaptateur fourni.
Brother QL-800	Autocollants et étiquettes de nom	USB. Jusqu'à 62 mm, prédécoupé ou continu, avec massicot automatique.
Brother QL-820NWB	Un poste d’étiquetage partagé ou en réseau	USB, Ethernet, Wi-Fi et Bluetooth.
Zebra ZD220	Étiquettes plus larges pour produits, expéditions ou bracelets	USB. Supports d'environ 25–112 mm. Versions thermique directe et transfert thermique.

Ce sont des exemples, pas une liste de modèles testés. Avant l'achat, vérifiez que le modèle exact dispose d'un pilote Windows actuel, accepte votre taille d'étiquette et apparaît comme une imprimante Windows classique.

Bien régler les étiquettes de taille fixe

Étiquettes de 3 × 1 pouces (y compris Munbyn BT320) : réglez la largeur sur 76.2 mm et la longueur fixe à 25.4 mm lorsque le côté de 1 pouce avance en premier. Choisissez le même support et le même sens dans les préférences d'impression Windows. Commencez avec du texte de 12–14 pt.

Règle	Pourquoi
Mesurer dans le sens d'avance	Une étiquette de 62 × 29 mm mesure généralement 62 mm de large et 29 mm de longueur fixe.
Faire correspondre Windows aussi	Réglez le même support, sens, détection d'espacement ou de repère et massicot dans les préférences d'impression du pilote.
Fixe signifie fixe	Aucune avance supplémentaire n'est ajoutée. Un texte trop haut peut être coupé ou déborder, selon le pilote.
Tester le texte le plus long	Les noms longs, options de produit et lignes supplémentaires nécessitent plus d'espace ou un texte plus petit.
Les étiquettes très courtes peuvent ne pas fonctionner	Social Stream demande au moins 20 mm. Le pilote peut toutefois limiter les formats de page courts.

Les bordures latérales du test d'impression montrent la largeur sûre. Sa hauteur suit le texte de test. Il ne trace pas le contour de toute l'étiquette.

Idées pour le direct

Autocollants au nom des soutiens pour un mur, un accessoire, une carte ou un tableau de progression.
Étiquettes de produits, commandes, boissons ou retrait à l'arrivée des commandes.
Tickets de tombola. Ajoutez des limites de fréquence et des contrôles d'admissibilité avant l'étape d'impression.
Badges VIP, choix d'équipe, jetons de défi ou étiquettes de paliers.
Une courte liste de tâches pour un réalisateur assis à côté de vous.

N'imprimez pas d'informations privées. Évitez les adresses, e-mails, informations de paiement et messages privés. Le papier thermique s'efface aussi avec la chaleur, la lumière et le temps.

Résoudre les problèmes

Problème	À essayer
Aucune imprimante n'apparaît	Vérifiez que Windows peut imprimer une page de test. Redémarrez Social Stream et cliquez à nouveau sur Rechercher des imprimantes.
Un succès est indiqué, mais rien ne s'imprime	Ouvrez la file d'impression Windows. Recherchez une pause, un état hors ligne ou des erreurs de papier, pilote ou port.
Un bord est coupé	Gardez Utiliser la zone imprimable activé. Augmentez la marge de sécurité de ce côté.
Trop de papier blanc	Utilisez une longueur fixe de 0 pour les reçus. Réduisez la marge inférieure et l'avance supplémentaire. Pour les étiquettes, définissez la longueur exacte.
Une étiquette s'imprime sur deux	Le texte dépasse la hauteur de l'étiquette ou le format du support dans Windows est incorrect. Réduisez le texte, la police, l'espacement ou les marges.
Tester le flux utilise la mauvaise imprimante	Choisissez une imprimante spécifique dans l'étape Imprimer une étiquette thermique. Si le champ est vide, les tests de l'éditeur utilisent l'imprimante par défaut de Windows.

Imprimantes thermiques et étiquettes de diffusion