> For the complete documentation index, see [llms.txt](https://helpcenter.etron.info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/etiketten-drucker.md).
# Etiketten Drucker
Etikettendrucker einrichten, Etikettendruck-Vorlagen, Etikettendruck Layout, Produktetiketten, Produktvarianten, Pfandetiketten,
> *Einstellungen -> Etiketten Drucker*
{% hint style="info" %}
*Beim Etikettendruck über den* [*ETRON Hardware Service*](/schnelles-wissen/drucker-and-hardware/etron-hardware-service-hws.md) *werden die in der* [*Systemanforderung*](/schnelles-wissen/drucker-and-hardware/anforderungen-hardware.md) *angeführten Etikettendrucker und A4 Drucker unterstützt.*
{% endhint %}
In ETRON onRetail sind bereits mehrere Etiketten-Druck-Layouts als Vorlage angelegt.
{% hint style="warning" %}
*Die bestehenden Vorlagen können nicht verändert, gelöscht oder zum Druckmenü hinzugefügt werden. Für die Nutzung und Anpassung ist eine Kopie zu erstellen.*
{% endhint %}
## Ablauf im Überblick
1. Eine passende [Vorlage](#vorlagentypen) auswählen und duplizieren.
2. Die Kopie in der [Formularansicht](#anpassen--formularansicht) anpassen.
3. Die Kopie über **Zum Druckmenü hinzufügen** aktivieren.
4. Etiketten im jeweiligen Modell drucken.
## Vorlagentypen
Die Listenansicht zeigt, um welches Etikett es sich handelt (**Name**), auf welches Datenmodell das Etikett zugreift (**Modell**) und ob es bereits im Druckmenü sichtbar ist (**Druckmenü ist Sichtbar**).
{% hint style="info" %}
*Das **Modell** legt fest, wo das Druckmenü später angezeigt wird.*
*Beispiel: Für den Etikettendruck einer Bestellung ist das Modell **Beschaffungsauftrag** auszuwählen.*
{% endhint %}
### Microsoft Print to PDF (A4 Etiketten)
*Druckformat: A4*
Diese Vorlage ermöglicht den Druck auf A4-Etiketten, wenn kein Etikettendrucker vorhanden ist.
Es wird eine A4-Seite erstellt und anschließend über den hinterlegten Drucker/**Microsoft Print to PDF** gedruckt. Die Anzahl der Etiketten pro A4-Seite wird im [Etiketten Drucker Code](#etiketten-drucker-code) festgelegt.
{% hint style="warning" %}
*In jeder Etikettenvorlage ist für den Etikettendruck das benötigte **Modell** auszuwählen.*
***Produktvorlage:** Modell "**Produkt**"*\
***Produktvarianten:** Modell "**Produktvariante**"*\
***Transfer** (Lagervorgang)**:** Modell "**Transfer**"*\
***Bestellung** (Einkauf): Modell "**Bestellung**"*\
***Verkauf:** Modell "**Verkaufsauftrag**"*
{% endhint %}
### HWS Produkt
*Druckformat: Etikett*
Diese Vorlage enthält ein Beispiel für den Etikettendruck von [Produkten (Produktvorlagen)](/verwaltungsoberflache/stammdaten/produkte.md).
### HWS Produkt Varianten
*Druckformat: Etikett*
Diese Vorlage enthält ein Beispiel für den Etikettendruck von [Produktvarianten](/verwaltungsoberflache/stammdaten/produkte/produkt-varianten.md).
### HWS Bestellung m. Varianten
*Druckformat: Etikett*
Diese Vorlage enthält ein Beispiel für den Etikettendruck bei Bestellungen. Grundlage sind Produktvarianten.
### HWS Anlieferung m. Varianten
*Druckformat: Etikett*
Diese Vorlage enthält ein Beispiel für den Etikettendruck bei Anlieferungen. Grundlage sind Produktvarianten.
### HWS Produkt und Produktvarianten mit Pfandtext (für Pfandartikel)
*Druckformat: Etikett*
Diese Vorlage steht für Produktvorlagen und Produktvarianten zur Verfügung.
Auf der Etikette wird der Text „zzgl. Pfand“ ausgegeben.
## Etikettenvorlagen erstellen, kopieren und anpassen
### Neu erstellen
Für ein neues Etikettendruck-Layout ist in der Übersicht der Button **Neu** auszuwählen. Die anpassbaren Felder werden unter [Anpassen / Formularansicht](#anpassen--formularansicht) beschrieben.
### Kopieren / Duplizieren von Etikettenvorlagen
Für ein Etikettendruck-Layout auf Grundlage einer Vorlage ist eine Etikettenvorlage zu öffnen.
Über **Aktion → Duplizieren** wird eine Kopie der Vorlage erstellt.
Die Kopie wird in der Vorlagenübersicht mit derselben Bezeichnung wie das Original angezeigt. \
Die Bezeichnung sollte umbenannt werden, damit die Kopie von der Vorlage zu unterscheiden ist.
Die Kopie kann anschließend angepasst und zum Druckmenü hinzugefügt werden.
### Anpassen / Formularansicht von Etikettenvorlagen
Beim Erstellen oder Öffnen einer Etikettenvorlage wird die Formularansicht angezeigt.
Die allgemeinen Felder haben folgende Bedeutung:
#### Name
Name des Etiketten-Layouts im System.
#### Modell
Auswahl der Datenquelle für die Inhalte des Etiketts. Relevante Datenquellen sind:
| Modell | Anzeige des Druckmenüs in … |
| ----------------------- | ----------------------------- |
| Produktvorlage | Produkte (Stammdaten) |
| Produkt | Produktvarianten (Stammdaten) |
| Bestellung | Bestellung (Einkauf) |
| Transfer (Lagervorgang) | Transfer (Lager) |
| Verkaufsauftrag | Verkauf (Auftragswesen) |
#### IP-Adresse
Adresse des ETRON Hardware Service. Standard:
#### Druckername
Name des Druckers in Microsoft Windows. Die Schreibweise muss exakt der Druckerbezeichnung entsprechen.
#### Etiketten Drucker Code
In diesem Feld wird JSON-Code nach dem Schema des ETRON Hardware Service hinterlegt. Beispiele befinden sich unter `C:\HWS\PROG\Doku\PrintLabel Doku.txt` (das Installationslaufwerk kann abweichen) sowie in den jeweiligen Vorlagen.
#### Zum Druckmenü hinzufügen
Über diesen Button wird das konfigurierte Etikett zur Druckauswahl beim gewählten [Modell](#modell) hinzugefügt (z.B. ein Etikett für "Produkt" unter [Stammdaten -> Produkte -> Produkte](/verwaltungsoberflache/stammdaten/produkte.md))
## Druckvorgang
Nach der Konfiguration von [Vorlagentyp](#vorlagentypen) und [Formularansicht](#anpassen--formularansicht) kann ein Testdruck durchgeführt werden.
{% hint style="danger" %}
*Vor dem Druckvorgang muss die Etikettenvorlage über **Zum Druckmenü hinzufügen** aktiviert werden. Andernfalls wird in der **Modell-Ansicht** die Vorlage nicht in der Druckauswahl angezeigt.*
{% endhint %}
Es ist die Ansicht zu öffnen, in der die Etiketten gedruckt werden sollen.
In diesem Beispiel werden Produkt-Etiketten für das Modell Produktvarianten gedruckt. Daher wird die Ansicht unter Stammdaten -> Produkte -> Produktvarianten geöffnet.
In der Listenansicht werden Produktvarianten ausgewählt, indem sie über die Checkbox markiert werden. Nach Auswählen des Buttons kann die Etikettenvorlage ausgewählt werden.
Produkt-Etiketten mit einer Etikettendruckvorlage drucken
Nachdem die zu druckende Etikettenvorlage ausgewählt wurde, erscheint die Druckansicht.
Für jede ausgewählte Produktvariante wird die Anzahl der zu druckenden Etiketten angegeben.
#### Leere Etiketten beim Etikettendruck berücksichtigen
Im Feld **Leere Etiketten** wird die Anzahl der beim Druck freizulassenden Etiketten eingetragen. Bei dem Wert `2` wird das erste Etikett an Position drei gedruckt.
Leere Etiketten beim Etikettendruck berücksichtigen
Dadurch kann ein bereits teilweise bedrucktes Etikettenblatt weiterverwendet werden.
Über den Button **Jetzt x Etiketten drucken!** wird der Druckvorgang gestartet.
{% file src="/files/8npNEv99hC9Lyvv3nn2K" %}
Der in der Vorlage hinterlegte Etikettendrucker erhält den Druckauftrag. Der Auftrag kann im Druckerspooler von Microsoft Windows geprüft werden.
{% hint style="info" %}
*Es ist darauf zu achten, dass* [*ETRON Hardware Service*](/schnelles-wissen/drucker-and-hardware/etron-hardware-service-hws.md) *installiert ist und läuft.*
{% endhint %}
## Etiketten Drucker Code
Der Etiketten Drucker Code legt das Layout und die Daten einer Etikette fest. Das folgende Beispiel stammt aus der Beispielausgabe.
{% hint style="warning" %}
*Die folgenden Codeblöcke enthalten Kommentare (`//`) zur Erklärung. Im Etiketten Drucker Code dürfen keine Kommentare enthalten sein.*
{% endhint %}
Dieser Teil des Codes beschreibt das Layout der Etikette:
```
{
"CmdVer": 1, // Version ist derzeit 1, bleibt unverändert
"Cmd": "PrintLabel", // Name des Befehls, muss PrintLabel lauten
"PrinterSettings": {
"PrinterName": "ZDesigner ZD420-300dpi ZPL"
// Name des Druckers in Microsoft Windows.
// Dieser Name muss exakt der Schreibweise
// in der Druckerauflistung entsprechen.
},
"Layout": {
"Style": 11,
"RowCount": 1,
"ColCount": 1,
"StartRow": 2,
"StartCol": 0
},
[...]
```
Dieser Teil des Codes beschreibt die gedruckten Daten. Das Beispiel bezieht sich auf das Modell **Produktvorlage**:
```
"PrintData": [{
"Ean": "model.barcodes", // EAN-Nummer
"Plu": "model.default_code", // Interne Artikelnummer
"Text": "model.name", // Artikeltext
"Text2": "model.description_sale", // Erweiterter Artikeltext
"Price": "model.list_price", // Verkaufspreis
"CrossedPrice": "model.regular_price", // Stattpreis
"ShowPrice": true, // Preisanzeige
"VatPrice": true, // Steueranzeige
"VatRate": "model.taxes_id", // Steuersatz
"GpiTmg": 200, // Standardwert
"GpiMeh": "ML", // Standardwert
"GpiBas": 1000 // Standardwert
}]
```
### Beispiel: Varianten-Etiketten
Für die Etikettenvorlagen wird die Template-Sprache [Jinja](https://jinja.palletsprojects.com/en/2.11.x/templates/) verwendet.
```
{
"CmdVer": 1,
"Cmd": "PrintLabel",
"PrinterSettings": {
"PrinterName": "ZDesigner ZD420-300dpi ZPL"
},
"Layout": {
"Style": 11,
"RowCount": 1,
"ColCount": 1,
"StartRow": 2,
"StartCol": 0
},
"PrintData": [
{
"Ean": "{{model.product_code}}",
"Plu": "{{model.id}}",
"Text": "{{model.name}}",
"Text2":"
{%- for attr in model.attribute_value_ids|sort(attribute="attribute_id.name",reverse=true) %}
{%- if loop.index > 1 %}, {% endif %}
{{-attr.attribute_id.name| truncate(200,end="")}}: {{attr.name}}
{%- endfor %}",
"Price": "{{model.list_price}}",
"CrossedPrice": "{{model.regular_price}}",
"ShowPrice": true,
"VatPrice": true,
"VatRate": "{{model.taxes_id.name|replace("Mehrwertsteuer ", "MwSt: ")}}",
"GpiTmg": 200,
"GpiMeh": "ML",
"GpiBas": 1000
}
]
}
```
### JSON-Format
Das Format der Etikette ist JSON. Im JSON-Format dürfen keine Kommentare enthalten sein. Andernfalls ist der Code ungültig.
Etiketten für Hauptprodukte werden auf das Modell `product.template` gelegt. Variantenetiketten werden auf das Modell `product.product` gelegt.
Nach dem Erstellen der Etikettendefinition ist **Zum Druckmenü hinzufügen** zu aktivieren. Dadurch wird die Etikettenvariante nach der Artikelauswahl im Dropdown **Drucken** angezeigt.
Die verwendeten Elemente haben folgende Bedeutung:
| Element | Bedeutung |
| ----------------------------------------------------- | ---------------------------------------------------------------------------- |
| `"Style": 11` | Verweist auf ein vordefiniertes Etikettenformat für die Artikelauszeichnung. |
| `for attr in model.attribute_value_ids` | Schleife über die Attributwerte der Variante. |
| `\|sort(attribute="attribute_id.name", reverse=true)` | Sortiert die Attribute nach Namen in umgekehrter Reihenfolge. |
| `{%- if loop.index > 1 %}, {% endif %}` | Fügt einen Beistrich nur vor Attribute ab der zweiten Position ein. |
| `\|truncate(200, end="")` | Kürzt Texte auf maximal 200 Zeichen. |
| `\|replace("Mehrwertsteuer ", "MwSt: ")` | Kürzt die Bezeichnung des Steuersatzes. |
Bei Jinja-Variablen und Codeblöcken können vorangestellte Leerzeichen entfernt werden. Dafür wird nach der öffnenden Klammer beziehungsweise dem ersten Prozentzeichen ein Minuszeichen gesetzt.
```
{{- variable }} anstatt {{variable}}
und
{%- etc... %} anstatt {% etc ... %}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/etiketten-drucker.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
