Cloud printen
Met cloud printen kan WCPOS bonnen versturen naar een printer die niet rechtstreeks is verbonden met het apparaat waarop de kassa draait. Stel het één keer in in WP Admin en je bestellingen worden afgedrukt op een keukenprinter, een kantoorprinter of een printer in een andere ruimte — zonder dat elk apparaat zelf de hardware hoeft te vinden en te koppelen.
Wat is cloud printen?
Bij lokaal printen communiceert het apparaat waarop de POS draait rechtstreeks met de printer via USB, Bluetooth of het lokale netwerk. Dat is de juiste keuze wanneer de printer naast de kassa staat — zie Printerinstelling voor het verbinden van USB-, Bluetooth- en netwerkprinters op hetzelfde apparaat.
Cloud printen is voor al het andere: een printer op een andere locatie, op een ander netwerk, of een printer die je door elk apparaat wilt laten delen zonder hem op ieder apparaat te configureren. Er zijn twee bezorgmodellen:
- Pollende printers. De printer neemt volgens een schema via internet contact op met WCPOS, vraagt "heb je iets voor mij?" en haalt eventuele wachtende taken op. WCPOS maakt nooit verbinding met de printer — de printer begint altijd het gesprek. Zo werken Star CloudPRNT en Epson Server Direct Print.
- Gehoste relay-providers. WCPOS dient de printtaak in bij een gehoste service, en die service levert hem af bij de printer. Zo werken Star Online en PrintNode. Star Online levert af bij Star CloudPRNT-printers die zijn geregistreerd in je stario.online-account; PrintNode levert via zijn desktopclient af bij vrijwel elke printer waarop die computer al kan printen.
Een pollende printer heeft geen open poort, geen statisch IP-adres en geen firewallwijzigingen nodig — hij doet alleen ooit uitgaande verzoeken. Dat maakt hem ideaal voor een printer op een externe locatie of achter een router die je niet beheert. De keerzijde is een korte vertraging: de printer print pas wanneer zijn volgende poll aan de beurt komt.
Een provider kiezen
Kies de provider die bij je hardware past.
Star CloudPRNT
Voor thermische Star-printers met de CloudPRNT-firmware. De printer pollt WCPOS en haalt taken op. Bonnen worden gerenderd naar de native commando's van de printer. Vereist een thermisch sjabloon.
Star Online
Voor Star-printers die zijn geregistreerd in een stario.online-account. WCPOS dient Star Document Markup in bij de gehoste service van Star, en de printer haalt het op bij Star Online. Vereist een thermisch sjabloon.
Epson Server Direct Print
Voor Epson ePOS-printers die Server Direct Print ondersteunen. De printer pollt WCPOS en haalt taken op als ePOS-Print XML. Vereist een thermisch sjabloon.
PrintNode
Werkt met vrijwel elke printer waarop je computer kan printen, op elk besturingssysteem, via de PrintNode-desktopclient. WCPOS dient een PDF in, dus je kunt elk sjabloon gebruiken — inclusief volledige HTML-facturen op paginaformaat.
| Provider | Hardware | Hoe taken verlopen | Sjablonen |
|---|---|---|---|
| Star CloudPRNT | Thermische Star-printer met CloudPRNT-firmware | Printer pollt WCPOS | Alleen thermisch |
| Star Online | Star-printer geregistreerd in stario.online | WCPOS dient Star Document Markup in bij Star Online | Alleen thermisch |
| Epson Server Direct Print | Epson ePOS-printer met Server Direct Print | Printer pollt WCPOS | Alleen thermisch |
| PrintNode | Elke via het besturingssysteem verbonden printer + PrintNode-client | WCPOS dient een PDF in bij PrintNode | Elk sjabloon |
WCPOS Cloud Print — de relay
Wanneer je een pollende printer instelt (Star CloudPRNT of Epson Server Direct Print), verwijst de poll-URL die WCPOS je geeft naar cloudprint.wcpos.com en niet naar je eigen site. Dat is WCPOS Cloud Print — een gratis relay van WCPOS die tussen je printer en je winkel staat.
Waarom die bestaat. Bonprinters draaien kleine, zelden bijgewerkte firmware. Veel printers kunnen geen beveiligde verbinding tot stand brengen met een winkel op moderne hosting: nieuwere TLS-versies, nieuwere certificaatautoriteiten of een CDN/firewall vóór de site (Cloudflare is een veelvoorkomende oorzaak) weigeren de printer — of worden door de printer geweigerd. Het symptoom is een printer die eeuwig op Waiting blijft staan hoewel elke instelling klopt. De relay biedt printers een verbinding die ook oudere firmware altijd tot stand kan brengen, en geeft hun verkeer door aan je winkel.
Hoe het werkt:
- Je site maakt automatisch verbinding met de relay zodra je de Cloud Print-instellingen voor het eerst opent — er valt niets in te schakelen of te configureren.
- De printer pollt
cloudprint.wcpos.com; de relay stuurt het verzoek door naar je winkel en geeft het antwoord van je winkel terug. Printtaken gaan door de relay heen — ze worden er nooit op opgeslagen. - De relay vangt het meeste inactieve pollen op, zodat een inactieve printer je site ongeveer één verzoek per minuut kost in plaats van één per paar seconden.
- Kan je site geen verbinding maken met de relay (bijvoorbeeld een lokale ontwikkelsite die de relay niet kan bereiken), dan valt WCPOS automatisch terug op URL's rechtstreeks naar de site.
Het instelscherm van elke printer heeft een Advanced-uitklapgedeelte met de URL rechtstreeks naar de site. Gebruik die als je weet dat je hosting printervriendelijk is, of als je taken liever niet via de relay laat lopen. Ontwikkelaars kunnen de relay sitebreed uitschakelen met één regel:
add_filter( 'woocommerce_pos_cloud_print_relay_enabled', '__return_false' );
Wat de relay kan zien. Door verbinding te maken deel je de URL van je site met wcpos.com, en printtaken — de inhoud van bonnen, inclusief bestelgegevens — passeren de relay op weg naar de printer. Er wordt niets bewaard. De volledige details staan in het privacybeleid.
Een cloudprinter instellen
Cloudprinters worden één keer ingesteld in WP Admin en gedeeld over elk apparaat — in tegenstelling tot lokale printers, die per apparaat worden opgeslagen.
Ga naar WP Admin > POS > Settings > Cloud Print en klik op Add printer. Geef hem een naam (bijvoorbeeld "Keuken" of "Kantoor"). WCPOS leidt automatisch een stabiel printer-ID af van de printer — dat verandert nooit, dus het is veilig om ernaar te verwijzen vanuit de firmwareconfiguratie van een printer.
Zodra de printer bestaat, configureer je de providerkant.
Star of Epson (pollende printers)
Voeg de printer toe in WCPOS
Voeg in WP Admin > POS > Settings > Cloud Print een printer toe en kies Star CloudPRNT of Epson Server Direct Print als provider. WCPOS genereert een poll-URL en een eenmalige token voor die printer.
Kopieer de poll-URL en token
Kopieer de gegenereerde poll-URL en token. De URL verwijst normaal gesproken naar cloudprint.wcpos.com — dat is de WCPOS Cloud Print-relay, en dat is ook de bedoeling; de URL rechtstreeks naar de site staat achter het Advanced-uitklapgedeelte. De token wordt slechts één keer getoond — als je hem kwijtraakt, genereer dan een nieuwe vanaf de printerkaart en werk de printer bij met de nieuwe waarde.
Voer ze in in de configuratie van de printer
Open de configuratiepagina van de printer — de CloudPRNT-instellingen voor Star of de Server Direct Print-instellingen voor Epson — en plak de poll-URL en token erin. Stel het pollinterval in als de printer daarom vraagt (een paar seconden is gebruikelijk). Sla op en herstart de printer indien nodig.
Binnen een pollcyclus meldt de printer zich aan en verandert zijn status in WCPOS van Waiting naar Connected.
PrintNode
Installeer de PrintNode-desktopclient
Installeer op een computer die al naar je doelprinter kan printen de PrintNode-client en log in. De client moet blijven draaien en online blijven om taken te kunnen printen.
Vraag een PrintNode API-sleutel aan
Maak in je PrintNode-account een API-sleutel aan. Dit is wat WCPOS toestaat om taken in te dienen bij je PrintNode-account.
Voer de API-sleutel in in WCPOS
Voeg een printer toe in WP Admin > POS > Settings > Cloud Print, kies PrintNode als provider en plak de API-sleutel erin. WCPOS gebruikt deze om de lijst op te halen van printers die bij je PrintNode-account zijn geregistreerd.
Selecteer de printer
Kies de doelprinter uit de lijst met printers die de PrintNode-client doorgeeft en sla op. WCPOS dient taken voor deze printer in bij PrintNode, en de client print ze.
Star Online
Gebruik Star Online wanneer je Star-printer al is geregistreerd bij een stario.online-account en je wilt dat de gehoste service van Star de bezorging afhandelt.
Verkrijg de CloudPRNT-URL
Open in stario.online Device Groups en kopieer de CloudPRNT URL van de groep. Die zou er moeten uitzien als https://device.stario.online/cloudprnt/... of https://eu-device.stario.online/cloudprnt/....
Maak een API-sleutel met rechten aan
Maak in stario.online een API-sleutel aan voor WCPOS. De sleutel moet toestemming hebben om apparaten op te sommen en ernaar te printen. Schakel minimaal het volgende in:
- EnumDevices — vereist wanneer WCPOS de apparatenlijst ophaalt
- ViewDevice — gebruikt voor apparaatstatuscontroles
- PrintToDevice — vereist om printtaken in te dienen
- ViewDeviceGroups — aanbevolen voor groepsopzoeking en diagnostiek
Een API-sleutel kan bestaan en toch falen als deze rechten niet zijn ingeschakeld.
Voer de URL en API-sleutel in in WCPOS
Voeg een printer toe in WP Admin > POS > Settings > Cloud Print, kies Star Online als provider en plak vervolgens de CloudPRNT-URL en API-sleutel. Klik op Fetch my devices.
Selecteer het Star-apparaat
Kies de printer uit de apparatenlijst en sla op. WCPOS slaat de API-sleutel aan de serverkant op en gebruikt de toegangsidentificatie van het geselecteerde apparaat bij het indienen van taken bij Star Online.
Regels voor automatisch printen
Regels voor automatisch printen bepalen automatisch wat waar wordt geprint — geschreven als gewone zinnen. Een regel is bereik × printer × sjabloon, bijvoorbeeld:
Print elke bestelling naar Keuken met Keukenticket.
Wanneer een overeenkomende bestelling wordt voltooid, rendert WCPOS het gekozen sjabloon aan de serverkant naar het formaat dat de printer nodig heeft en plaatst het in de wachtrij — de kassier hoeft niets te doen.
Star- en Epson-printers kunnen alleen thermische sjablonen gebruiken, omdat de taak gerenderd moet worden naar de native commandotaal van de printer (Star Document Markup of ESC/POS voor Star, ePOS-Print voor Epson). PrintNode kan elk sjabloon gebruiken — thermisch of volledige HTML op paginaformaat — omdat de taak gerenderd wordt naar een PDF. Als een sjabloon niet als optie verschijnt voor een printer, komt dat doordat de printer dat formaat niet kan renderen. Zie Thermische sjablonen voor het maken van thermische lay-outs.
Printers per winkel (Pro)
Printroutering per winkel vereist WCPOS Pro en een multi-store-configuratie.
Standaard zijn regels voor automatisch printen globaal — elke winkel deelt ze. Met Pro kun je een afzonderlijke winkel zijn eigen cloudprintregels geven, zodat zijn bestellingen worden afgedrukt op zijn eigen printers (een keukenticket op de ene locatie hoort niet op een andere te worden geprint).
Bewerk een winkel onder POS → Stores, open het gedeelte Cloud Printing en kies Add rule. Elke regel is:
- Printer ID — het stabiele ID van de cloudprinter waarnaar moet worden verstuurd
- Scope — POS orders only (standaard), Online orders only of Every order
- Format — StarPRNT (standaard), ESC/POS, Epson ePOS-Print of HTML
Wanneer een bestelling bij een winkel hoort die zijn eigen regels heeft, routeert WCPOS de bestelling naar de printers van die winkel. Als een winkel geen eigen regels heeft, valt deze terug op de globale regels voor automatisch printen — dus je hoeft alleen de winkels te configureren die afwijken.
Handmatig printen
Je hoeft niet te wachten op een regel voor automatisch printen. Vanaf het afreken-/bonscherm kan een kassier op verzoek een bon naar een cloudprinter sturen — handig voor herafdrukken of voor het routeren van een eenmalig ticket naar een specifieke printer.
Hoe de bon wordt geproduceerd, hangt af van de printer:
- Star CloudPRNT — de bon wordt op het apparaat gerenderd en via CloudPRNT aan de printer doorgegeven.
- Star Online, Epson en PrintNode — de bon wordt op de server gerenderd op basis van de geselecteerde bestelling en het sjabloon, en vervolgens afgeleverd bij de printer of gehoste relay.
De printwachtrij
Elke taak voor een cloudprinter blijft in een wachtrij op je site staan totdat de printer hem ophaalt (pollende printers) of de provider de aflevering bevestigt. WP Admin > POS > Settings > Cloud Print toont de wachtrij onder je printers:
- Filter op printer of op status — Waiting, Printing, Printed, Failed, Cancelled — met live aantallen.
- Elke rij toont hoe lang de bon al wacht en linkt naar de WooCommerce-bestelling die wordt geprint.
- Annuleer wachtende taken één voor één, in bulk of voor een hele printer tegelijk. Opnieuw proberen zet een mislukte taak terug in de wachtrij.
Als een printer wachtende taken heeft maar al meer dan een paar minuten niets heeft opgehaald, noemt een waarschuwingsbanner de printer, toont hoeveel bonnen er opstapelen en hoe lang al, en biedt Alles annuleren — een achterstand kan nooit stilzwijgend oplopen terwijl een printer losgekoppeld is.
Testprint & verbindingsstatus
Elke printerkaart heeft een knop Test print die een korte diagnose verstuurt, zodat je kunt bevestigen dat de printer bereikbaar is en het formaat klopt voordat je erop vertrouwt voor echte bestellingen.
De kaart toont ook een live status:
| Provider | Status | Betekenis |
|---|---|---|
| Star CloudPRNT / Epson | Waiting | De printer heeft zich nog niet aangemeld — WCPOS wacht op zijn eerste poll. |
| Star CloudPRNT / Epson | Connected | De printer heeft WCPOS recent gepollt en haalt taken op. |
| Star Online | Online | Star Online meldt dat het geselecteerde apparaat beschikbaar is. |
| Star Online | Offline | Star Online meldt dat het geselecteerde apparaat niet beschikbaar is. |
| Star Online | Unknown | WCPOS kon de apparaatstatus niet bevestigen via Star Online. |
| PrintNode | Online | De PrintNode-service meldt dat de client en printer beschikbaar zijn. |
| PrintNode | Offline | PrintNode meldt dat de client of printer niet beschikbaar is. |
Probleemoplossing
Printer blijft hangen op Waiting
Een pollende printer die nooit Waiting verlaat, heeft WCPOS nog nooit succesvol bereikt. Controleer:
- Of de poll-URL en token in de firmware van de printer exact overeenkomen met wat WCPOS heeft gegenereerd. Eén verkeerd teken betekent dat elke poll wordt afgewezen — genereer de token opnieuw in WCPOS en voer hem opnieuw in als je twijfelt.
- Of de printer je site daadwerkelijk via internet kan bereiken (juiste DNS, geen firewall die uitgaande HTTPS blokkeert, geldig SSL-certificaat op je winkel).
- Of polling is ingeschakeld in de CloudPRNT- / Server Direct Print-configuratie van de printer, met een redelijk interval. Herstart de printer nadat je de instellingen hebt gewijzigd.
- Als je de URL rechtstreeks naar de site hebt ingevoerd (uit het Advanced-uitklapgedeelte) en de printer nog steeds geen verbinding maakt, schakel dan over op de standaard-URL cloudprint.wcpos.com — veel printers kunnen geen beveiligde verbinding met moderne hosting tot stand brengen, en dat is precies wat de relay oplost.
Waarom verwijst mijn printer-URL naar cloudprint.wcpos.com?
Dat is WCPOS Cloud Print, de gratis relay die printers een verbinding geeft die hun firmware altijd tot stand kan brengen en die hun printtaken doorgeeft aan je winkel. Hij staat automatisch aan, taken worden er nooit op opgeslagen, en de URL rechtstreeks naar de site is altijd beschikbaar onder het Advanced-uitklapgedeelte van de printer als je dat liever hebt.
Ik heb mijn printer ingesteld voordat de relay bestond — moet ik iets wijzigen?
Nee — URL's die al in de configuratie van een printer zijn opgeslagen, blijven werken. Blijft die printer echter hangen op Waiting, dan is zijn firmware waarschijnlijk van een type dat niet rechtstreeks met je hosting kan verbinden: open Setup & token op de printerkaart, genereer de token opnieuw en voer de nieuwe cloudprint.wcpos.com-URL en token in de configuratie van de printer in.
Star Online zegt dat de API-sleutel niet geautoriseerd of verboden is
Star Online scheidt authenticatie van rechten:
- 401 / authenticatie mislukt betekent dat de API-sleutel zelf niet werd geaccepteerd. Controleer of de sleutel correct is gekopieerd, niet is ingetrokken en bij het verwachte Star Online-account/de verwachte regio hoort.
- 403 / verboden betekent dat de API-sleutel werd geaccepteerd, maar niet geautoriseerd is voor de gevraagde actie. Bewerk de sleutel in stario.online en schakel de vereiste rechten in, met name EnumDevices voor Fetch my devices en PrintToDevice voor printen.
Als Fetch my devices lukt maar er geen printers verschijnen, controleer dan de pagina Device Groups in stario.online. De groep moet ten minste één verbonden apparaat bevatten, en de CloudPRNT-URL in WCPOS moet naar diezelfde groep verwijzen.
PrintNode-taak wordt nooit afgedrukt
De taak heeft PrintNode bereikt maar kwam niet uit de printer. Controleer:
- Of de PrintNode-desktopclient draait en online is op de computer die met de printer is verbonden. Als de computer in slaapstand staat of de client gesloten is, wordt er niets geprint.
- Of je de juiste printer in WCPOS hebt geselecteerd — de naam moet overeenkomen met de printer die de client doorgeeft.
- Of de API-sleutel geldig is en niet is ingetrokken. Voer hem opnieuw in als PrintNode de printer als Offline toont.
Mijn sjabloon is niet selecteerbaar voor een Star- of Epson-printer
Alleen thermische sjablonen werken op Star- en Epson-cloudprinters, omdat de bon gerenderd moet worden naar ESC/POS- of ePOS-Print-commando's. HTML- en volledige paginasjablonen kunnen niet in die formaten worden uitgedrukt, dus ze zijn verborgen voor deze printers.
Kies ofwel een thermisch sjabloon, of gebruik een PrintNode-printer — PrintNode rendert naar PDF, dus die kan elk sjabloon printen.