Hilfe-Center

PrintAgent sendet Ihre Etiketten direkt an den Etikettendrucker. Nachfolgend lesen Sie, wie die Kommunikation funktioniert und worauf Sie bei der Einrichtung Ihres Druckers achten sollten.

Kommunikation über ZPL

PrintAgent kommuniziert mit Zebra-kompatiblen Etikettendruckern über ZPL (Zebra Programming Language). Ihr Entwurf wird in der Cloud in ZPL-Befehle umgewandelt und über den PrintAgent Node oder Agent an den Drucker in Ihrem Netzwerk gesendet. Ein Druckertreiber ist nicht erforderlich, und Ihre Etiketten sehen an jedem Standort gleich aus.

Verschiedene Druckertypen einrichten

Geben Sie Ihrem Drucker eine feste IP-Adresse und stellen Sie sicher, dass Port 9100 erreichbar ist. Fügen Sie den Drucker anschließend unter Drucker hinzu und wählen Sie das richtige Modell und die Auflösung (dpi). Verwenden Sie 'Netzwerk scannen', um Drucker in Ihrem Netzwerk automatisch zu finden. Weicht die dpi von Ihrem Entwurf ab, erhalten Sie beim Drucken eine Warnung.

Unterstützte Drucker

PrintAgent arbeitet mit Etikettendruckern, die ZPL oder ZPL II unterstützen. Beispiele: Zebra (ZD-, ZT-, GK- und GX-Serie), TSC (TE-, DA- und BX-Serie), Godex, Argox, CAB, SATO und Toshiba. Auch Drucker von Honeywell und Citizen funktionieren, sofern sie sich im ZPL-Modus befinden. Ist Ihr Modell nicht dabei? Probieren Sie es einfach aus: Wenn der Drucker ZPL unterstützt, funktioniert er mit PrintAgent.

Drucker in den ZPL-Modus versetzen

Stellen Sie die Befehlssprache Ihres Druckers auf ZPL oder ZPL II. Dies geschieht in der Regel über das Druckermenü (Einstellungen → Befehlssprache oder Printer Language), über den Windows-Druckertreiber (Einstellungen → Erweitert → Befehlssprache) oder mit dem Konfigurationstool des Herstellers. Drucken Sie anschließend ein Testetikett über PrintAgent: Kommt das Etikett korrekt heraus, ist der Drucker richtig eingerichtet. Sorgen Sie außerdem für eine feste IP-Adresse und einen erreichbaren Port 9100.

Aktionen und HTTP-Trigger

Mit Aktionen lassen Sie externe Systeme einen Druckauftrag auf Ihrem PrintAgent Node starten. Jede Aktion mit einem HTTP-Trigger hat ihre eigene Adresse: POST http://<node>:7158/actions/<slug>, wobei sich die Slug aus dem Aktionsnamen ergibt. Authentifiziert wird mit dem Token der Aktion (Header X-PrintAgent-Token oder ?token= in der URL). Der JSON-Body darf beliebige Felder enthalten: Sie werden als Platzhalter auf dem Etikett verwendet. Pro Aufruf können Sie das Template (Name oder Id), den Drucker und die Anzahl der Exemplare überschreiben und optional eine Produktnummer nachschlagen: senden Sie ein productcode-Feld mit, wählen Sie das Matchfeld (number, ean13 oder qrcode) und verknüpfen Sie Produktfelder mit Platzhaltern. Ohne Zuordnung stehen alle Produktfelder als {{product.feld}} zur Verfügung. Die Firewall-Regel für Port 7158 wird automatisch mit PrintAgent Node installiert.

Konkrete Beispiele

Dateiablage — ein Etikett pro Zeile

Erstelle eine Aktion mit Trigger Dateiablage und wähle den Ordner, z. B. C:\ERP\drop (Muster *.csv). PrintAgent druckt ein Etikett pro Zeile und verschiebt die Datei anschließend, damit nichts doppelt gedruckt wird. Jede Spalte wird ein Platzhalter im Etikett.

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

Scan — Barcode direkt zum Etikett

Verbinde einen Barcode-Scanner mit dem Computer, auf dem PrintAgent Node läuft (z. B. COM5, 9600 Baud), und wähle den Trigger Scanner. Jeder Scan steht im Etikett als {{barcode}} zur Verfügung. Aktiviere Produkt-Lookup, um den Code mit deiner Produktliste abzugleichen und Felder wie {{product.name}} und {{product.salesprice}} hinzuzufügen.

HTTP-Request — Drucken aus jedem System

Erstelle eine Aktion mit Trigger HTTP-Request und kopiere das Token. Dein ERP, Shop oder Skript startet den Druck dann mit einem einfachen POST — jedes Feld im Body wird ein Platzhalter.

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

Optionale Parameter

Der JSON-Body kann die Einstellungen der Aktion pro Aufruf überschreiben:

• template — Etikett-Vorlage nach Name oder ID
• printer — Drucker nach Name (wie in der Druckerliste)
• copies — Anzahl der Kopien (positive Ganzzahl)
• productcode — Produktcode für den Produkt-Lookup (wenn aktiviert)

Platzhalter in der Etikett-Vorlage

Verwende die Feldnamen in doppelten geschweiften Klammern in deinem Etikett-Design. Leere oder unbekannte Platzhalter werden einfach weggelassen.

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

info@tegrasystems.nl