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 |
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 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.
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.
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.