Druck & Arbeitsplätze
Überblick
Vier Flächen, die zusammen den Etikettendruck tragen:
| Fläche | Was sie beantwortet |
|---|---|
| Arbeitsplätze | wo gedruckt und gewogen wird — und ob dort gerade ein Agent läuft |
| Drucker | welches Gerät an welchem Arbeitsplatz steckt und was es annimmt |
| Etiketten-Vorlagen | was auf Artikel-, Regal- und Chargen-Etiketten steht |
| Druckaufträge | was an den Geräten liegt — und was dort schiefging |
Der Satz, der die häufigste Störung erklärt, steht in der Anwendung selbst: Ohne angemeldeten Drucker gibt es keinen Direktdruck. Der Agent am Arbeitsplatz ist die Verbindung zwischen System und Gerät; läuft er nicht, entstehen Aufträge, die niemand ausdruckt.
Kernaufgaben
Arbeitsplätze einrichten. Je Ort, an dem gedruckt oder gewogen wird. Die Anzeige sagt, ob dort gerade ein Agent läuft.
Drucker anmelden. Gerät, Arbeitsplatz und die angenommenen Formate.
Etiketten-Vorlagen pflegen. Je Ding eine Vorlage — Artikel, Regal, Charge. Chargen-Etiketten greifen auf die Daten aus Chargen und Seriennummern zu.
Druckaufträge prüfen. Die Liste zeigt, was ansteht und was fehlschlug. Sie ist der erste Ort bei einer Störung — nicht der Drucker.
Belege ausgeben: die Ausgabewege
Angebot, Auftrag und Rechnung verlassen das Haus über einen Dialog, Beleg ausgeben. Unter Ausgabewege lassen sich die Wege kombinieren; jeder Weg hinterlässt am Beleg eine Spur (Kanal, Empfänger oder Ziel, Exemplare, Zeitpunkt, Ergebnis).
- Per E-Mail senden — an einen oder mehrere Empfänger, mit Betreff, Begleittext, weiteren
Anhängen aus der Dateiablage und auf Wunsch Kopie an mich; jeder Empfänger bekommt eine eigene Zustellung.
- Drucken — das Beleg-PDF geht in die Druck-Warteschlange eines Arbeitsplatzes, mit der Zahl der
Exemplare. Welcher Drucker es wird, entscheiden die Dokumenttypen am Drucker (siehe unten, etwa invoice für Rechnungen). Ohne eingerichteten Arbeitsplatz ist der Weg abgeschaltet und sagt warum: „Kein Druck-Arbeitsplatz eingerichtet."
- Mit der Ware versenden — es wird nichts gesendet: Der Beleg wird als Beilage für die
nächste Sendung des Auftrags vorgemerkt, sein PDF dabei eingefroren. Was in den Karton gehört, zeigt Versandzentrum → Sendungen → Beilagen. Belege ohne Warenbezug bieten den Weg nicht an.
Beilagen am Packtisch drucken. Damit vorgemerkte Beilagen beim Packen von selbst aus dem Drucker kommen, gibt es den mitgelieferten Ablauf Beilagen am Packtisch drucken: Beim Buchen einer Sendung druckt er alle Beilagen dieses Auftrags. Er ist ab Werk aus und wird unter Einstellungen → Versand in der Karte Versand-Abläufe eingeschaltet. Die Karte zeigt alle Abläufe, die auf das Buchen einer Sendung hören, mit Auslöser und Zustand; Neuer Ablauf und Im Automations-Editor öffnen führen in die Automationen — ein Versand-Ablauf ist eine normale Automation. Bedingungen wie Versanddienstleister, Empfängerland oder Gewicht ergänzen Sie dort, etwa „nur bei DHL nach Österreich".
Feste Beilagen. Dateien, die immer mitgehen sollen (AGB, Widerrufsbelehrung), hängen Sie einmal je Belegart und Marke unter Beleg-Beilagen an. Im Dialog stehen sie als immer dabei und lassen sich für diesen einen Versand herausnehmen.
Empfängerregeln je Kunde. Am Kunden im Reiter Kontakte legt der Abschnitt Empfängerregeln für Belege fest, wem ein Beleg dieses Kunden vorgeschlagen wird — je Belegart (Angebot, Auftrag, Rechnung) oder für Alle Belegarten. Der Empfänger wird entweder über eine Kontaktrolle bestimmt (die Buchhaltung bekommt die Rechnung; wechselt die Person, wechselt der Empfänger mit) oder über eine feste Adresse. Dazu kommen Kopie an-Adressen und Zusätzlich drucken — der Beleg geht dann per E-Mail und in den Druck, sofern es einen Druck-Arbeitsplatz gibt. Eine Regel für eine Belegart schlägt die für alle; je Belegart gibt es genau eine Regel. Die Regel ergänzt den Dialog: von Hand gewählte Adressen gehen vor, und ohne Regel schlägt der Versand den Hauptkontakt vor. Trägt beim Kunden niemand die gewählte Rolle, greift die Regel nicht — die Liste weist darauf hin.
Felder im Detail
Auflösung (dpi) an Drucker und Etiketten-Vorlage: 203 (Vorgabe) oder 300 dpi. Eine ZPL-Vorlage muss zur Auflösung des Druckers passen, sonst druckt sie verzerrt; bei PDF-Vorlagen bleibt das Feld leer.
Die Spalte Was es bewirkt beantwortet, was sich im System ändert — nicht, wie das Feld heißt. Der graue Name dahinter ist das Feld der API: unter ihm läuft dasselbe über Automation, Import und KI-Werkzeuge.
Arbeitsplatz
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Schlüssel workplaceKey | ja | Text, kleingeschrieben, etwa packtisch-1 | Womit sich der lokale Agent meldet — derselbe Schlüssel steht in seiner Konfiguration. Er ist die Kennung in Aufträgen und Auswertungen. |
Name name | ja | Text | Wie der Arbeitsplatz in der Liste heißt — meist der Ort, etwa „Packtisch 2". |
Aktiv active | nein | Ja/Nein | Ob der Arbeitsplatz Aufträge bekommt. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke der Arbeitsplatz arbeitet. Ein Marken-Wechsel entwertet das Agent-Token: der Arbeitsplatz bleibt stumm, bis ein neues ausgegeben ist. Die Antwort sagt es ausdrücklich. |
Das Geräte-Token ist bewusst kein Feld, sondern eine eigene Handlung: Jede Ausgabe entwertet die vorige, und der Klartext existiert genau einmal — in der Antwort der Ausgabe. Danach steht in der Liste nur noch ein Wiedererkennungs-Präfix. Ein Token sieht ausschließlich die Aufträge dieses Arbeitsplatzes.
Drucker
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Arbeitsplatz workplaceUlid | ja | bestehender Arbeitsplatz | Wo das Gerät steht. |
Geräte-Schlüssel printerKey | ja | Text, Warteschlangenname des Betriebssystems, etwa ZDesigner-GK420d | Unter welchem Namen der Agent das Gerät kennt. Stimmt er nicht, findet der Agent den Drucker nicht. |
Name name | ja | Text | Wie das Gerät in der Auswahl heißt. |
Format format | ja | zpl oder pdf | Was das Gerät annimmt. Etikettendrucker sprechen ZPL, Bürodrucker PDF. |
Dokumenttypen documentTypes | nein | Liste, etwa shipping_label, delivery_note; leer = alle | Die eigentliche Zuordnung: So geht das Versandetikett auf den Etikettendrucker und der Lieferschein auf den A4-Drucker, ohne dass jemand wählt. Leer heißt „nimmt alles" — der Ein-Drucker-Fall läuft ohne Einrichtung. |
Standard isDefault | nein | Ja/Nein | Welches Gerät genommen wird, wenn mehrere passen. |
Aktiv active | nein | Ja/Nein | Ob das Gerät Aufträge bekommt. |
Etiketten-Vorlage
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Ding subjectType | ja | product (Artikel), bin (Lagerplatz), batch (Charge) | Wofür die Vorlage gilt. Jedes Ding bringt seine eigenen Platzhalter mit; die Liste steht über der Tabelle. |
Schlüssel templateKey | ja | Text, etwa product-ean-50x30 | Die Kennung der Vorlage. Nach dem Anlegen unveränderlich — und der Hebel, um eine mitgelieferte Vorlage abzulösen: eine eigene mit demselben Schlüssel gewinnt. |
Name name | ja | Text | Wie die Vorlage in der Auswahl heißt. |
Inhalt body | ja | ZPL mit Platzhaltern der Form {{ variable }} | Was auf dem Etikett steht. Ein unbekannter Platzhalter wird beim Speichern im Klartext abgewiesen — nicht erst beim Druck. |
Breite widthMm | nein | Zahl in Millimetern | Die Etikettenbreite. |
Höhe heightMm | nein | Zahl in Millimetern | Die Etikettenhöhe. |
Standard isDefault | nein | Ja/Nein | Welche Vorlage für dieses Ding ohne weitere Wahl genommen wird. |
Aktiv active | nein | Ja/Nein | Ob die Vorlage angeboten wird. Über die Oberfläche entsteht sie aktiv; das Stilllegen ist ein Weg über Schnittstelle und Automation. |
Die Liste zeigt auch die mitgelieferten Vorlagen. Sie stehen im Programm und haben keine Datenbank-Zeile; sie zu verschweigen hieße, die Verwaltung meldet „keine Vorlagen", während das System druckt.
Druckauftrag
Ein Auftrag entsteht aus einer Handlung — Etikett drucken, Beleg ausgeben — und aus Automation und Schnittstelle. Auf dieser Seite wird er nicht angelegt, sondern beobachtet, abgebrochen und nachgedruckt.
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Arbeitsplatz workplaceKey | ja | Schlüssel eines Arbeitsplatzes | Wo gedruckt wird. |
Dokumenttyp documentType | ja | Text, etwa shipping_label | Was gedruckt wird. Danach sucht die Registry das passende Gerät. |
Format format | ja | zpl oder pdf | In welcher Sprache die Nutzlast vorliegt. |
Nutzlast payload | ja | ZPL-Text oder base64-kodiertes PDF | Der Druckinhalt. Er wird nie zurückgelesen — ein Etikett trägt Empfängeranschrift und Sendungsnummer, und die Warteschlange ist eine Betriebsansicht, kein Dokumentenarchiv. Wer das Etikett braucht, holt es am Beleg. |
Anzahl copies | nein | Zahl | Wie viele Exemplare. |
Gerät printerKey | nein | Schlüssel eines Druckers | Ein ausdrücklich verlangtes Gerät. Ohne Angabe entscheidet die Registry über Dokumenttyp und Format. |
| Angabe | Woher | Was sie bedeutet |
|---|---|---|
| Status | Rückmeldung des Agenten | Wartend, geholt, gedruckt, fehlgeschlagen oder abgebrochen. Ein fehlgeschlagener Auftrag bleibt stehen und wird nicht stillschweigend verworfen — sonst fehlte ein Etikett, ohne dass es jemandem auffällt. |
| Fehlergrund | Rückmeldung des Agenten | Warum es schiefging. Häufig ein Format, das der Drucker nicht annimmt. |
| Abbrechen | Handlung | Nur solange den Auftrag noch niemand geholt hat. |
| Erneut drucken | Handlung | Schickt denselben Auftrag noch einmal. Bei Belegen mit Nummer entsteht dabei keine neue Nummer. |
| Waage | Agent am Arbeitsplatz | Gewicht in Gramm und ob der Wert steht. Nur Anzeige — es gibt nichts einzutragen; ein veralteter Wert wird gar nicht erst gezeigt. |
Einstellungen & Rechte
- Modul
module.print. print.workplace.view/.managefür Arbeitsplätze und Drucker,print.job.view,
.create, .manage für Aufträge.
- Der Agent läuft am Arbeitsplatz, nicht im Browser. Er ist Voraussetzung für Direktdruck.
- Ausgabewege: den Weg Drucken bietet der Dialog an, sobald ein aktiver Arbeitsplatz besteht;
Empfängerregeln pflegt, wer den Kunden bearbeiten darf (Schnittstelle /api/v1/customers/{ulid}/document-dispatch-rules).
- Regal-Etiketten passen zu den Lagerplätzen aus dem Multilager.
FAQ & Fehlerbilder
Es wird nichts gedruckt. Prüfen Sie in dieser Reihenfolge: Läuft der Agent am Arbeitsplatz? Ist ein Drucker angemeldet? Nimmt er das Format an? Erst danach das Gerät selbst.
Ein Druckauftrag steht auf fehlgeschlagen. Die Liste nennt den Grund. Häufig ist es ein Format, das der Drucker nicht annimmt.
Das Etikett zeigt die falschen Angaben. Prüfen Sie die Vorlage — je Ding gibt es eine eigene.
Chargen-Etiketten sind leer. Dann ist der Artikel nicht nachweispflichtig gesetzt, siehe Chargen.