# ⚙️ Etiketten Drucker

> *Einstellungen -> Etiketten Drucker*

{% hint style="info" %}
*Beim ETRON onRetail Etikettendruck über den* [*ETRON Hardware Service*](https://helpcenter.etron.info/schnelles-wissen/drucker-and-hardware/etron-hardware-service-hws) *werden die in der* [*Systemanforderung*](https://helpcenter.etron.info/schnelles-wissen/drucker-and-hardware/anforderungen-hardware) *angeführten Etikettendrucker und A4 Drucker unterstützt.*
{% endhint %}

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FviteTfim8tVVfF5zt3Dy%2Fimage.png?alt=media&#x26;token=54378f6f-66e6-4e96-a34c-2394fbd58967" alt=""><figcaption></figcaption></figure>

In ETRON onRetail sind bereits mehrere Etiketten-Druck-Layouts als Vorlage angelegt.

{% hint style="warning" %}
*Die Vorlagen selbst können nicht verändert, gelöscht oder zum Druckmenü hinzugefügt werden. Für die Nutzung und Anpassung müssen diese* [*kopiert/dupliziert* ](#etikettendruck-erstellen-kopieren-und-anpassen)*werden.*
{% endhint %}

## 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** sagt auch aus, wo das Druckmenü später erscheint.*&#x20;

*Beispiel: Bei einer Bestellung soll ein Etikett gedruckt werden. Hierfür ist das Modell **Beschaffungsauftrag** auszuwählen.*
{% endhint %}

### Microsoft Print to PDF (A4 Etiketten)

*Druckformat: A4*

Diese Vorlage zeigt die Möglichkeit zum Druck auf A4 Etiketten, wenn kein echter Etikettendrucker vorhanden ist.&#x20;

Es wird eine A4 Seite erstellt und anschließend auf den Microsoft Print to PDF Drucker (Standard PDF Drucker von Microsoft Windows) gedruckt. Wie viele Etiketten auf das A4 Papier gedruckt werden, wird im [Label Print Code](https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/broken-reference) definiert. &#x20;

{% hint style="info" %}
*Es ist auf das gewünschte **Modell** für den A4 Druck zu achten. Standardmäßig ist das Modell **Produktvorlage** ausgewählt.*&#x20;

*<mark style="color:red;">**Ebenso ist auf die Modellbezeichnung zu achten:**</mark>*

*Das Modell **Produktvorlage** wird für das "Produkt", bzw. "Hauptprodukt" **(***[***Stammdaten > Produkte > Produkte***](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte)***)** verwendet.*

*Das Modell **Produkt** wird für die **Produktvarianten (***[***Stammdaten > Produkte > Produkt Varianten***](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkt-varianten)***)** verwendet. Werden Produktvarianten verwendet, so ist immer "**Produkt**" zu verwenden.*
{% endhint %}

### HWS Produkt

*Druckformat: Etikett*

Diese Vorlage zeigt ein Beispiel für den Etikettendruck der Produktvorlage/Hauptprodukt *(*[*Stammdaten > Produkte > Produkte*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte)*)*&#x20;

### HWS Produkt Varianten

*Druckformat: Etikett*

Diese Vorlage zeigt ein Beispiel für den Etikettendruck von Produktvarianten

&#x20;*(*[*Stammdaten > Produkte > Produkt Varianten*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkt-varianten)*)*&#x20;

### HWS Bestellung m. Varianten

*Druckformat: Etikett*

Diese Vorlage zeigt ein Beispiel für den Etikettendruck bei Bestellungen im Einkaufswesen, basierend auf Produktvarianten *(*[*Stammdaten > Produkte > Produkt Varianten*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkt-varianten)*)*&#x20;

### HWS Anlieferung m. Varianten

*Druckformat: Etikett*

Diese Vorlage zeigt ein Beispiel für den Etikettendruck bei Anlieferungen im Lagerwesen, basierend auf Produktvarianten  *(*[*Stammdaten > Produkte > Produkt Varianten*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkt-varianten)*)*&#x20;

### HWS Produkt und Produktvarianten mit Pfandtext (für Pfandartikel)

*Druckformat: Etikett*

Diese Vorlage gibt es für den Etikettendruck für die Produktvorlage  ([*Stammdaten > Produkte > Produkte*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte)*)* und für die Produktvariante *(*[*Stammdaten > Produkte > Produkt Varianten*](https://helpcenter.etron.info/verwaltungsoberflache/stammdaten/produkte/produkt-varianten)*)*&#x20;

Auf der Etikette befindet sich der Text "zzgl. Pfand"

<div align="left"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F4mfG52pxZKPv82gLT4Sa%2Fimage.png?alt=media&#x26;token=7ee7b50c-c1f6-4593-a521-d26286ad87d0" alt=""><figcaption></figcaption></figure></div>

## Etikettendruck erstellen, kopieren und anpassen

### Neu erstellen

![](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fz0oJje8pndIR9ggEilI0%2Fimage.png?alt=media\&token=7185a554-1635-46f9-9d95-c152ba513d9d)

Um ein Etikettendrucklayout neu zu erstellen in der Übersicht auf den Button "Neu" klicken. Die Schritte zur Anpassung sowie die Erklärung der Felder sind unter [Anpassen/Formularansicht](#anpassen-formularansicht) beschrieben.

### Kopieren

Um ein Etikettendrucklayout auf Grundlage einer Vorlage zu erstellen, öffnet man eine der Etikettenvorlagen durch Anklicken.

In der Etikettenvorlage klickt man oben auf **Aktion > Duplizieren** um eine Kopie der Vorlage zu erstellen.

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fkr763TFgkqmMIGAyg9HD%2Fimage.png?alt=media&#x26;token=897d3c78-dd71-45ad-b467-b33165487bee" alt=""><figcaption></figcaption></figure>

In der Vorlagen-Übersicht befindet sich nun die Kopie der Vorlage (diese hat die gleiche Bezeichnung wie das Original).

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FGA5wGrmkBoktBUKhEOMl%2Fimage.png?alt=media&#x26;token=c391e761-f49c-461e-aaae-f43fe48bedbb" alt=""><figcaption></figcaption></figure>

Diese Vorlage kann nun angepasst sowie zum Druckmenü hinzugefügt werden.

### Anpassen / Formularansicht

Wird eine neue Etikettenvorlage erstellt oder eine bestehende geöffnet, öffnet sich die Formularansicht, in der diese angepasst werden kann.

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F2n17eZLn8xT2I1LNiXtF%2Fimage.png?alt=media&#x26;token=73e3fa9b-e7fd-44b5-86c9-83625d3cb17b" alt=""><figcaption></figcaption></figure>

Die allgemeinen Felder haben folgende Bedeutung:

#### Name

Name des Labels im System

#### **Modell**

Auswahl der Datenquelle für das Befüllen des Labels mit Inhalten\
Die relevantesten Datenquellen sind:

| Modell         | Anzeige des Druck Menüs in..  |
| -------------- | ----------------------------- |
| Produktvorlage | Produkte (Stammdaten)         |
| Produkt        | Produktvarianten (Stammdaten) |
| Bestellung     | Bestellung (Einkauf)          |
| Transfer       | Anlieferung (Lager)           |

#### **IP-Adresse**

Adresse des ETRON Hardware Service. Standardmäßig immer: <http://localhost:7786/EtrHws/run>

#### **Druckername**

Name des Druckers in Windows. Dieser Name muss 1:1 die selbe Schreibweise aufweisen, wie der Drucker unter Microsoft Windows in der Druckauflistung benannt wird.&#x20;

**Etiketten Drucker Code**

Hier wird JSON Code nach der Vorlage des ETRON Hardware Service eingetragen. Beispiele finden sich in Ihrem ETRON Hardware Service Ordner unter C:\HWS\PROG\Doku\PrintLabel Doku.txt (Laufwerk C: kann ggfs. abweichen, je nachdem welches Laufwerk bei der Installation gewählt wurde), sowie hier im Artikel unter [Etiketten Drucker Code](#etiketten-drucker-code).

#### **Zum Drückmenü hinzufügen**

![](https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2Fpylb4HJvxgwCJsA3wPMt%2Fimage.png?alt=media\&token=257c79d8-fd6f-4c2e-8016-642b3bfd59e0)

Dieser Button (rechts oben) fügt das konfigurierte Etikett anschließend in die Etikettendruck-Auswahl anschließend zur Ansicht des ausgewählten [**Modell** ](#modell)hinzu.&#x20;

## Druckvorgang

Wenn alles mittels [Vorlagen-Typen](#vorlagentypen) und [Anpassung in der Formular-Ansicht](#anpassen-formularansicht) konfiguriert ist, kann der erste Testdruck erfolgen.

{% hint style="danger" %}
*Vor dem Druckvorgang ist sicher zu stellen, dass die Etikettenvorlage auch durch Klick auf den Button "Zum Druckmenü hinzufügen" aktiviert wurde. Ohne diese Aktion erscheint im gewünschten* [***Modell***](#modell) *nicht die Auswahl zum Drucken der Etiketten.*
{% endhint %}

In die Ansicht gehen, in der die Etiketten gedruckt werden sollen. In unserem Beispiel sind es die normalen Produktetiketten über die Artikel-Stammdaten Ansicht.

In der Listenansicht über die Checkbox jene Produkte markieren, für die Etiketten gedruckt werden sollen. Anschließend auf den Button "Drucken" klicken und die gewünschte Etiketten-Vorlage auswählen:

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FDhlNtCQliUP3UGMEtwOA%2Fimage.png?alt=media&#x26;token=f9b57e99-e150-4027-8dda-a01265e46bc1" alt=""><figcaption></figcaption></figure>

Nach Auswahl der zu druckenden Etiketten-Vorlage erscheint eine neue Ansicht.

Pro Produkt kann die Anzahl an Etiketten eingegeben werden, die gedruckt werden soll.

#### Leere Etiketten drucken/berücksichtigen

In das Feld "leere Etiketten" kann die Anzahl an Etiketten eingegeben werden, die beim Druck leer gelassen werden soll. z.B. 2. Somit würde das 1. Etikett an Stelle 3 gedruckt werden.&#x20;

Diese Einstellung ist nützlich, wenn auf dem Etikettenpapier bereits Etiketten gedruckt wurden und das restliche Blatt weiterbenutzt werden soll.

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FAtBthh0njP9JtOmVfsMo%2Fimage.png?alt=media&#x26;token=a6be1174-8a36-478e-89e3-6234ca9c874a" alt=""><figcaption></figcaption></figure>

Über den Button  **Jetzt x Etiketten drucken!** wird der Druckvorgang gestartet.

{% file src="<https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FtmaHYKjBSrTDtDLke2wh%2FEtikettendruck%20mit%20Leeretiketten.pdf?alt=media&token=96ce5dd9-1b8f-46cb-8ba3-416076d90f4e>" %}

Der hinterlegte Etikettendrucker sollte nun den Druckauftrag erhalten. Das kann auch über den Druckerspooler in Microsoft Windows überprüft werden.&#x20;

{% hint style="info" %}
*Es ist darauf zu achten, dass* [*ETRON Hardware Service*](https://helpcenter.etron.info/schnelles-wissen/drucker-and-hardware/etron-hardware-service-hws) *installiert ist und läuft.*
{% endhint %}

## Etiketten Drucker Code

Der Etiketten Drucker Code legt fest, wie die gedruckte Etikette aussehen soll und welche Daten darauf beschrieben sein sollen. Hier ist ein Beispiel aus der "Beispielausgabe":

<figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FUHqwyb2OYqepp7Zz8sA6%2Fimage.png?alt=media&#x26;token=bf95e4b9-a302-4cc0-8fdd-c965920fe7ce" alt=""><figcaption></figcaption></figure>

*Dieser Teil des Codes beschreibt, wie die Etikette auszusehen hat:*

```
{
    „CmdVer“: 1,             // Version ist derzeit 1, bleibt unverändert
    „Cmd“: „PrintLabel“,     // Name des Befehls, muss PrintLabel heißen
    „PrinterSettings“: {
        „PrinterName“: „ZDesigner ZD420-300dpi ZPL“ 
        
        // Name des Druckernamens in Windows, 
        // dieser Name muss exakt der selbe 
        // wie in den Windows Druckereinstellungen sein.
    },
    „Layout“: {
        „Style“:11,
        „RowCount“:1,
        „ColCount“:1,
        „StartRow“:2,
        „StartCol“:0
    },
    
    [...]
```

*Dieser Teil des Codes beschreibt, welche Daten auf dem Etikett gedruckt werden: (dieses 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, ist der Stattpreis 0 wird kein Wert auf das Etikett gedruckt.
    „ShowPrice“: true,                       // Gibt an, ob der Preis angezeigt werden soll
    „VatPrice“: true,                        // Gibt an, ob die Steuer angezeigt werden soll
    „VatRate“: “model.taxes_id“,             // Steuersatz
    „GpiTmg“: 200,                           // Standardwert, bitte belassen
    „GpiMeh“: „ML“,                          // Standardwert, bitte belassen
    „GpiBas“: 1000                           // Standardwert, bitte belassen.
}]
```

### Beispiel: Varianten-Etiketten

Die Template Sprache Jinja wird hier verwendet.

[Jinja Templating](https://jinja.palletsprojects.com/en/2.11.x/templates/)

```
{
  "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 eingefügt sein, ansonsten ist es ungültig.

Etiketten für Hauptprodukte werden in der Etikettendefinition auf das Modell „product.template“ gelegt, die für Variantenprodukte auf das Modell „product.product“.

Nach Erstellen der Etikettendefinition muss der Aktionsbutton „Zum Druckmenü hinzufügen“ aktiviert werden, damit die Etikettenvariante nach Auswahl von Artikeln in der Listenansicht im Drucken Dropdown sichtbar wird.

`„Style“: 11,` bezieht sich auf ein vordefiniertes Etikettenformat für die Artikelauszeichnung.

`for attr in model.attribute_value_ids` ist die Schleife über die Attributwerte der Variante.

`|sort(attribute=„attribute_id.name“,reverse=true)` Die Pipe „|“ ermöglicht es Datenfelder mit verschiedenen von Jinja definierten Helfer Funktionen weiter zu bearbeiten. Hier wird die Liste der Attribute nach ihren Namen in umgekehrter Reihenfolge sortiert.

`,` Ein Beistrich soll vor das Attribut nur gesetzt werden, wenn es nicht das erste ist.

`| truncate(200,end=„“)` Mit dem Helfer „truncate“ können zu lange Texte abgeschnitten werden. Hier ist die maximale Länge 200 Zeichen.

`|replace(„Mehrwertsteuer “, „MwSt: “)` Der „replace“ Helfer wird hier verwendet, um das ausgegebene Wort „Mehrwertsteuer “ auf dem Etikett abzukürzen.

Bei den Jinja Variablen und Codeblöcken kann man die Leerzeichen davor aufsaugen indem man ein Minus nach den öffnenden Klammern/dem ersten Prozentzeichen anhängt.

```
{{- variable }} anstatt {{variable}}
und
{%- etc... %} anstatt {% etc ... %}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpcenter.etron.info/verwaltungsoberflache/einstellungen/etiketten-drucker.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.