Der Auftrag geht an ein Gerät, nicht an eine Adresse
Ein Druckauftrag geht an einen Geräteeintrag: die
device_id, die Sie beim Registrieren des Druckers erhalten
(POST /v1/devices; GET /v1/devices listet sie). Die
Netzwerkadresse steht nicht in Ihrer Integration, sondern in der Zuordnung des
Agents auf dem Rechner neben dem Drucker — einen Drucker umzuziehen heißt, eine
Zuordnung zu ändern, nicht Ihren ERP-Code.
Die Identität des Druckers festlegen
Wenn Sie einen ZPL-Netzwerkdrucker zuordnen, legen Sie seine Identität im
selben Schritt fest:
Der Agent fragt den Drucker, wer er ist (ZPL ~HI), speichert
einen Hash der Antwort und meldet Identity pinned. Danach stellt
er dieselbe Frage vor jedem Auftrag — nicht einmalig bei der
Einrichtung, denn eine DHCP-Lease wandert nicht bei der Einrichtung.
Bei Abweichung wird nichts gedruckt
Antwortet unter der zugeordneten Adresse ein Gerät mit einer anderen
Antwort, sendet der Agent das Etikett nicht. Sein Protokoll sagt es in einer
Zeile:
identity mismatch: the device at 192.168.1.50:9100 is NOT the device pinned for "DEVICE_ID". Nothing was printed.
gefolgt vom Befehl zum erneuten Festlegen, falls der Drucker wirklich
getauscht wurde. Der Auftrag gilt mit dem Fehlertyp
KimlikUyusmazligi als fehlgeschlagen und wird nicht
automatisch wiederholt. Das ist wichtig: Wartete der Auftrag in der
Warteschlange, würde das Korrigieren der Festlegung das alte Etikett auf dem
Gerät drucken, das die Adresse gerade hält — ihn erneut zu senden ist Ihre
Entscheidung.
Was wir gemessen haben
Am 2. November 2026 haben wir das an einem Zebra GK420d im Netzwerk mit
Agent 0.6.1 und dem Produktivdienst durchgespielt:
das Festlegen meldete Identity pinned, und ein Testetikett
wurde gedruckt;
dann haben wir den gespeicherten Hash so geändert, dass die Antwort des
Druckers nicht mehr passte — dieselbe Lage, wie wenn ein anderes Gerät
antwortet — und zwei Aufträge gesendet: kein Papier kam
heraus, das Protokoll zeigte die Zeile oben, und beide Aufträge
galten mit KimlikUyusmazligi als fehlgeschlagen;
wir haben den ursprünglichen Hash wiederhergestellt und 60 Sekunden
beobachtet: Die fehlgeschlagenen Aufträge wurden nicht von
selbst gedruckt; ein neues Testetikett druckte normal.
Die Abweichung haben wir an einem Drucker durch Ändern der Festlegung
erzeugt; zwei physische Drucker unter derselben Adresse haben wir nicht
getauscht.
Wo der Schutz endet
Nur ZPL-Netzwerkdrucker. Die Frage ist
~HI, die einzige Identitätsabfrage, die wir geprüft haben. Für
EPL, TSPL und CPCL gibt es keine geprüfte Abfrage; Festlegen ist dort nicht
möglich, und der Agent sagt das. Ein USB-Drucker wird über die
Druckwarteschlange des Betriebssystems erreicht, die Daten nur in eine
Richtung trägt — der Agent kann ihn nichts fragen.
Es ist optional. Ein Gerät ohne Festlegung wird nicht
geprüft.
Baugleiche Zwillinge sehen gleich aus. Festgelegt wird
die eigene Antwort des Druckers auf ~HI: Modell,
Firmware-Version, Auflösung und Speicher. Unser GK420d antwortet
GK420d-200dpi,V61.17.17Z,8,2104KB — eine Seriennummer steht
nicht darin. Zwei Drucker desselben Modells mit gleicher Firmware und gleichem
Speicher antworten gleich, die Prüfung kann sie nicht unterscheiden. Sie
stoppt ein anderes Modell oder eine andere Konfiguration unter der Adresse;
bei baugleichen Druckern bleiben reservierte Adressen Ihr Schutz.
Ein Firmware-Update kann die Antwort ändern. Dann
stoppt der Auftrag, und die Meldung bittet Sie, neu festzulegen. Eine
stehende Linie ist besser als ein Etikett im falschen Karton.
Geprüft heißt nicht gedruckt. Eine bestandene Prüfung
bedeutet, dass das richtige Gerät die Bytes erhalten hat. Papierende,
offener Druckkopf oder Stau passieren danach, und Rohdruck meldet sie
nicht.
Wenn Sie eine Abweichung sehen
Finden Sie heraus, welches Gerät die Adresse jetzt hält: Konfigurationsetikett
drucken oder die DHCP-Lease-Tabelle prüfen — wie im
Diagnose-Ratgeber.
Richten Sie die Zuordnung wieder auf den richtigen Drucker, am besten auf
eine reservierte Adresse.
Legen Sie nur neu fest, wenn der Drucker selbst getauscht oder seine
Firmware aktualisiert wurde.
Senden Sie dann das fehlgeschlagene Etikett erneut — bewusst.
Was passiert, wenn unter der Adresse ein anderer Drucker antwortet?
Wurde der Drucker festgelegt und weicht die Antwort auf die Identitätsabfrage von der festgelegten ab, sendet der Agent nichts. Sein Protokoll meldet, dass das Gerät nicht das festgelegte ist und nichts gedruckt wurde; der Auftrag gilt mit KimlikUyusmazligi als fehlgeschlagen und wird nicht automatisch wiederholt.
Funktioniert die Prüfung bei jedem Drucker?
Nein. Sie funktioniert bei ZPL-Druckern im Netzwerk, die der Agent mit ~HI fragen kann. EPL, TSPL und CPCL haben keine geprüfte Identitätsabfrage, eine USB-Druckwarteschlange trägt Daten nur in eine Richtung, und ein nicht festgelegtes Gerät wird nicht geprüft.
Kann sie zwei baugleiche Drucker unterscheiden?
Nein. Festgelegt wird die Antwort des Druckers auf ~HI — Modell, Firmware, Auflösung und Speicher, keine Seriennummer. Zwei Drucker desselben Modells mit gleicher Firmware und gleichem Speicher antworten gleich; zwischen ihnen schützen reservierte Adressen.
