Drukarki termiczne i etykiety transmisji

Skonfiguruj w 6 krokach

Zanim zaczniesz: wymaga to samodzielnej aplikacji Windows. Drukarka musi być widoczna jako zwykła drukarka Windows. Social Stream drukuje przez sterownik Windows, nie wysyła surowych poleceń ESC/POS, ZPL ani SDK producenta.

Podłącz drukarkę przez USB, włącz ją i zainstaluj sterownik Windows. Wydrukuj stronę testową Windows, aby sprawdzić działanie.
W Social Stream otwórz Ustawienia globalne i narzędzia → Mechanika – Połączenia i integracje → Sterowanie drukarką.
Kliknij Znajdź drukarki (Find printers). Wybierz drukarkę po nazwie widocznej w Windows.
Wpisz Szerokość papieru (mm). Zwykle jest to 58, 80 lub 62.
Pozostaw Stała długość etykiety (Fixed label length) na 0 dla papieru paragonowego. Dla etykiet wykrojonych wpisz długość w mm w kierunku podawania papieru.
Kliknij Drukuj test. Jeśli krawędź jest obcięta, zwiększ bezpieczny margines po tej stronie i przetestuj ponownie.

Domyślne bezpieczne marginesy 2 mm z lewej i prawej pasują do wielu tanich drukarek paragonowych 58 mm. Sterownik określa rzeczywisty obszar druku, więc pozostaw Użyj obszaru drukowania (Use printable area) włączone, chyba że przetestowano inne ustawienie.

Drukuj etykietę po darowiźnie

💰 Wpłata / napiwek (Donation / Tip)Minimalna kwota (Minimum Amount): 10

🖨️ Drukuj etykietę termiczną (Print Thermal Label)

{username}
{donation}

24 pt · pogrubienie · wyśrodkowanie

Otwórz Edytor Event Flow i utwórz nowy przepływ.
Dodaj Wpłata / napiwek (Donation / Tip) wyzwalacz. Ustaw Minimalna kwota (Minimum Amount) jeśli drukować mają się tylko większe darowizny.
Dodaj Drukuj etykietę termiczną (Print Thermal Label) (w Integracjach) i połącz z nim wyzwalacz.
Wpisz {username}, nowy wiersz, a następnie {donation}. Wybierz rozmiar czcionki, grubość, wyrównanie i liczbę kopii.
Pozostaw nadpisania drukarki i stałej długości akcji puste lub 0. Zostaną użyte ustawienia Printer Control.
Kliknij Testuj przepływ (Test Flow). Wpisz nazwę i włącz Kwota wsparcia (Has Donation), dodaj kwotę i uruchom. Wydrukuje to prawdziwą etykietę.

Inne przydatne symbole zastępcze: {message}, {source}, {donationAmount} i {counterValue}. Wartości utworzone przez wcześniejsze kroki przepływu też działają.

Drukuj sprzedaże, prezenty i numery zamówień

Chcę drukować…	Zrób to
Sprzedaż	Użyj Typ zdarzenia z `purchase`. Wpłata / napiwek (Donation / Tip) potrzebuje `hasDonation`, więc pomija większość sprzedaży.
Ukończone prezenty	Użyj `gift` lub `giftfunded`. W razie potrzeby filtruj według dostawcy.
Kolejny numer zamówienia	Dodaj Licznik (Counter) przed akcją drukowania.

Zobacz pola zdarzeń handlowych aby sprawdzić, co zawiera każda sprzedaż.

Pogrub kupującego, pozostaw zwykłą nazwę przedmiotu

Ustaw Grubość na Wybrany tekst.
Wpisz to jako tekst etykiety:

**{username}**
{subtitle}

Tylko tekst wewnątrz ** staje się pogrubiony. HTML ani JavaScript nie są potrzebne.
Używaj pojedynczych nawiasów klamrowych. Sprzedaże umieszczają nazwę produktu w {subtitle}. Ilość może znajdować się w {meta.commerce.quantity}.
Jeśli wcześniejszy krok tworzy buyer, użyj **{buyer}** zamiast tego.
Shopify i eBay nie wysyłają nazwy kupującego. Użyj dla nich licznika zamówień lub etykiety samego produktu.
Etykiety ustawione na Wszystko pogrubione lub Normalne zachowują wygląd.

Dla twórców przepływów: wyniki drukowania i numery kupujących

Akcja dodaje meta.thermalPrintResult.success, a przy błędzie także komunikat lub kod dla kolejnych kroków. Sukces oznacza wysłanie zadania do Windows, a nie wyjście papieru. Przed ponowieniem sprawdź kolejkę drukowania Windows, aby uniknąć podwójnych etykiet.

Licznik numeruje zakupy, a nie unikalnych kupujących. Ta sama liczba dla każdego zakupu jednej osoby wymaga osobnej listy kupujący–numer, resetowanej na początku transmisji. Pole powodu w User Memory to zwykły tekst, nie licznik numerów kupujących.

Etykiety przedmiotów Whatnot

Pobierz przykładowy przepływ Whatnot. Drukuje kupującego pogrubioną czcionką, nazwę przedmiotu i identyfikator zamówienia, jeśli jest dostępny. Gdy płatność się nie powiedzie, drukuje osobną PŁATNOŚĆ NIEUDANA etykietę z danymi zawartymi w komunikacie.

W aplikacji samodzielnej skonfiguruj Sterowanie drukarką (Printer Control) i uruchom wydruk testowy.
Otwórz Edytor Event Flow, kliknij Importuj (Import)i wybierz pobrany plik.
Wybierz Whatnot: etykiety przedmiotów i ostrzeżenia o płatnościach. Sprawdź obie akcje drukowania. Używają drukarki i długości etykiety z Printer Control.
Włącz przepływ i zapisz. Importuje się jako wyłączony.
Pozostaw źródło Whatnot otwarte z włączonym przechwytywaniem zdarzeń transmisji.

Etykieta sprzedaży nie oznacza opłacenia. Każdy komunikat jest drukowany po nadejściu. Przepływ nie czeka na płatność, nie poprawia poprzedniej etykiety ani nie nadaje numerów kupujących. Brakujące pola są puste. Komunikat błędu bez kupującego, przedmiotu lub danych zamówienia nie pozwala wskazać właściwej etykiety.

Jak działa przykładowy przepływ

Używa Event Type (Advanced) → Custom Event dla product_sold i payment_failed, z filtrem Whatnot. Oferty i komunikaty zakończenia aukcji nie są drukowane. Zobacz pola zdarzeń Whatnot.

Wybierz papier

Rolka paragonowa

Do potwierdzeń zakupu, numerków kolejki i paragonów dowolnej długości. Pozostaw stałą długość etykiety równą 0.

Ciągła rolka naklejek

Do samoprzylepnych pasków z nazwą o dowolnej długości. Działa jak papier paragonowy, ale drukarka lub sterownik muszą obsłużyć cięcie.

Etykiety wykrawane

Do identyfikatorów i etykiet produktów o jednakowym rozmiarze. Ustaw dokładną stałą długość i wybierz ten sam nośnik w preferencjach drukowania Windows.

Etykieta zakupu

KUPUJĄCY #12

Inky
Niebieski kubek Ninja

Papier paragonowy 58 mm. Długość rośnie wraz z tekstem.

Dziękujemy

INKY

$25.00 CAD

Etykieta wykrojona o stałym rozmiarze: nazwa i darowizna.

Odbiór

A-037

Bluza Ninja
Rozmiar L

Etykieta gadżetu lub odbioru z danymi zdarzenia i licznikiem.

Przykładowe drukarki

Drukarka	Dobre do	Uwagi
Ogólna „POS-58”	Tanie paragony 58 mm	Zwykle USB. Nazwy i sterowniki zależą od sprzedawcy. Social Stream testowano na podstawowym POS-58.
Epson TM-T20III	Solidniejsza drukarka paragonowa	USB. Papier 80 mm lub 58 mm z dołączonym adapterem.
Brother QL-800	Naklejki i etykiety z nazwami	USB. Do 62 mm, wykrojone lub ciągłe, z automatyczną obcinarką.
Brother QL-820NWB	Wspólne lub sieciowe stanowisko etykiet	USB, Ethernet, Wi-Fi i Bluetooth.
Zebra ZD220	Szersze etykiety produktów, wysyłkowe lub opaski	USB. Nośniki około 25–112 mm. Wersje termiczne i termotransferowe.

To przykłady, a nie lista przetestowanych urządzeń. Przed zakupem sprawdź, czy dokładny model ma aktualny sterownik Windows, obsługuje rozmiar etykiet i pojawia się jako zwykła drukarka Windows.

Poprawnie ustaw etykiety o stałym rozmiarze

Etykiety 3 × 1 cala (także Munbyn BT320): ustaw szerokość na 76.2 mm, a stałą długość na 25.4 mm, gdy bok 1 cala jest podawany pierwszy. Wybierz ten sam nośnik i kierunek w preferencjach drukowania Windows. Zacznij od czcionki 12–14 pkt.

Zasada	Dlaczego
Mierz w kierunku podawania	Etykieta 62 × 29 mm ma zwykle 62 mm szerokości i stałą długość 29 mm.
Dopasuj też Windows	W preferencjach drukowania sterownika ustaw ten sam nośnik, kierunek, wykrywanie przerwy/znacznika i obcinarkę.
Stały znaczy stały	Nie dodaje się dodatkowego wysuwu. Zbyt wysoki tekst może zostać obcięty lub przejść dalej, zależnie od sterownika.
Przetestuj najdłuższy tekst	Długie nazwy, opcje produktów i dodatkowe wiersze wymagają więcej miejsca lub mniejszej czcionki.
Bardzo krótkie etykiety mogą nie działać	Social Stream żąda co najmniej 20 mm. Sterownik nadal może ograniczać krótkie rozmiary stron.

Boczne linie wydruku testowego pokazują bezpieczną szerokość. Wysokość zależy od tekstu testowego. Nie obrysowują całej etykiety.

Pomysły na transmisję

Naklejki z nazwami wspierających na ścianę, rekwizyt, mapę lub tablicę postępu.
Etykiety gadżetów, zleceń, napojów lub odbioru przy nadejściu zamówień.
Losy. Przed drukowaniem dodaj limity częstotliwości i kontrolę uprawnień.
Identyfikatory VIP, wybory drużyn, żetony wyzwań lub etykiety kamieni milowych.
Krótka lista zadań dla producenta siedzącego obok.

Nie drukuj prywatnych danych. Pomijaj adresy, e-maile, dane płatności i prywatne wiadomości. Papier termiczny blaknie też pod wpływem ciepła, światła i czasu.

Rozwiązywanie problemów

Problem	Spróbuj tego
Nie widać drukarki	Sprawdź, czy Windows drukuje stronę testową. Uruchom ponownie Social Stream i kliknij ponownie Znajdź drukarki.
Komunikat sukcesu, ale nic się nie drukuje	Otwórz kolejkę drukarki w Windows. Sprawdź wstrzymanie, tryb offline oraz błędy papieru, sterownika lub portu.
Krawędź jest obcięta	Pozostaw włączone używanie obszaru drukowania. Zwiększ bezpieczny margines po tej stronie.
Za dużo pustego papieru	Dla paragonów użyj stałej długości 0. Zmniejsz dolny margines i dodatkowy wysuw. Dla etykiet ustaw dokładną długość.
Jedna etykieta drukuje się na dwóch	Tekst jest wyższy niż etykieta albo Windows ma zły rozmiar nośnika. Użyj mniej tekstu, mniejszej czcionki, ciaśniejszych odstępów lub mniejszych marginesów.
Test Flow używa niewłaściwej drukarki	Wybierz nadpisanie drukarki w kroku Drukuj etykietę termiczną. Jeśli jest puste, test w edytorze używa domyślnej drukarki Windows.