Helpcentrum

PrintAgent stuurt je etiketten rechtstreeks naar de labelprinter. Hieronder lees je hoe de communicatie werkt en waar je op moet letten bij het instellen van je printer.

Communicatie via ZPL

PrintAgent communiceert met Zebra-compatibele labelprinters via ZPL (Zebra Programming Language). Je ontwerp wordt in de cloud omgezet naar ZPL-opdrachten en via de PrintAgent Node of agent naar de printer op je netwerk gestuurd. Je hebt dus geen printerdriver nodig en je labels zien er op elke locatie hetzelfde uit.

Verschillende printertypes instellen

Geef je printer een vast IP-adres en zorg dat poort 9100 bereikbaar is. Voeg de printer daarna toe onder Printers en kies het juiste model en de resolutie (dpi). Gebruik 'Netwerk scannen' om printers in je netwerk automatisch te vinden. Wijkt de dpi af van je ontwerp, dan krijg je bij het afdrukken een waarschuwing.

Ondersteunde printers

PrintAgent werkt met labelprinters die ZPL of ZPL II ondersteunen. Voorbeelden: Zebra (ZD-, ZT-, GK- en GX-serie), TSC (TE-, DA- en BX-serie), Godex, Argox, CAB, SATO en Toshiba. Ook printers van Honeywell en Citizen werken, mits ze in de ZPL-modus staan. Staat jouw model er niet bij? Probeer het gewoon: als de printer ZPL ondersteunt, werkt hij met PrintAgent.

Printer in ZPL-modus zetten

Zet de opdrachttaal van je printer op ZPL of ZPL II. Dit kan meestal via het printermenu (Instellingen → Opdrachttaal of Printer Language), via de Windows-printerdriver (Voorkeuren → Geavanceerd → Opdrachttaal) of met de configuratie-utility van de fabrikant. Print daarna een testetiket via PrintAgent: komt het label er correct uit, dan staat de printer goed. Zorg ook voor een vast IP-adres en een bereikbare poort 9100.

Acties en HTTP-triggers

Met Acties laat je externe systemen een printopdracht starten op je PrintAgent Node. Elke actie met een HTTP-trigger heeft een eigen adres: POST http://<node>:7158/actions/<slug>, waarbij de slug uit de actienaam volgt. Je authenticeert met de token van de actie (header X-PrintAgent-Token, of ?token= in de URL). De JSON-body mag willekeurige velden bevatten: die worden als placeholders op het label gebruikt. Per aanroep kun je het template (naam of id), de printer en het aantal exemplaren overschrijven en optioneel een productcode opzoeken: stuur een productcode-veld mee, kies het matchveld (number, ean13 of qrcode) en koppel productvelden aan placeholders. Zonder koppeling zijn alle productvelden beschikbaar als {{product.veld}}. De firewall-regel voor poort 7158 wordt automatisch met PrintAgent Node geïnstalleerd.

Concrete voorbeelden

Filedrop — een label per regel

Maak een actie met trigger Filedrop en wijs de map aan, bijvoorbeeld C:\ERP\drop (patroon *.csv). PrintAgent print één label per regel en verplaatst het bestand daarna, zodat niets dubbel print. Elke kolom wordt een placeholder in het sjabloon.

order;ean;qty
A-1024;8712345678901;2
A-1025;8710987654321;1

Scan — barcode direct naar een label

Sluit een barcodescanner aan op de computer met PrintAgent Node (bijvoorbeeld COM5, 9600 baud) en kies de trigger Scanner. Elke scan komt in het sjabloon beschikbaar als {{barcode}}. Zet product lookup aan om de code te matchen met je productenlijst en velden zoals {{product.name}} en {{product.salesprice}} toe te voegen.

HTTP-request — printen vanuit elk systeem

Maak een actie met trigger HTTP-request en kopieer het token. Je ERP, webshop of script start de print dan met een simpele POST — elk veld in de body wordt een placeholder.

curl -X POST "http://NODE-IP:7158/actions/shipping-labels" \
  -H "X-PrintAgent-Token: TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "template": "Shipping label", "printer": "Zebra-1", "copies": 2, "productcode": "8712345678901", "order": "A-1024" }'

→ 202 Accepted

Optionele parameters

De JSON-body kan de instellingen van de actie per aanroep overschrijven:

template — labelsjabloon op naam of id
printer — printer op naam (zoals in de printerlijst)
copies — aantal exemplaren (positief geheel getal)
productcode — productcode voor het opzoeken van productgegevens (indien ingeschakeld)

Placeholders in je sjabloon

Gebruik de veldnamen tussen dubbele accolades in je labelontwerp. Lege of onbekende placeholders worden simpelweg weggelaten.

Order {{order}} ({{qty}}x)
{{product.name}}
EAN {{product.ean13}} · € {{product.salesprice}}

info@tegrasystems.nl