> 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/system/gutscheinvorlage.md).

# Gutscheinvorlage

> *Einstellungen -> System -> Gutscheinvorlage*

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F2WCpRr83PPi6AoW6wc6V%2Fimage.png?alt=media&amp;token=7cf2273d-604a-4461-bb32-9c070bea0ee5" alt="Einstellungen -> System -> Gutscheinvorlage"><figcaption><p><em>Einstellungen -> System -> Gutscheinvorlage</em></p></figcaption></figure></div>

{% hint style="info" %}
*Für die Anzeige dieses Menüpunkts muss die Einstellung **Bearbeitung des Vorlagencodes** unter* [*Einstellungen -> Allgemeine Einstellungen -> Berechtigungen*](/verwaltungsoberflache/einstellungen/allgemeine-einstellungen/allgemeine-einstellungen/berechtigungen.md#bearbeitung-des-vorlagencodes) *aktiviert werden.*

*Nach Aktivieren der Einstellung ist es nötig, die Seite zu aktualisieren (Tastatur: F5)*
{% endhint %}

{% hint style="warning" %}
*Das Anpassen des Gutscheindokuments erfordert Kenntnisse in QWEB (XML) und sollte nur von fachkundigen Personen vorgenommen werden.*

*Unsachgemäß vorgenommene Änderungen können dazu führen, dass keine Gutscheine mehr gedruckt werden können!*
{% endhint %}

In dem Menüpunkt sind die Ansichten des Gutscheindokuments hinterlegt. Ansichten können an dieser Stelle weder neu angelegt noch gelöscht werden.

<table><thead><tr><th width="243.8887939453125">Ansicht</th><th>Inhalt</th></tr></thead><tbody><tr><td><strong>gift_card_report</strong></td><td>Inhalt des Gutscheins: Kopfzeile, Logo, Betrag, Gutschein-Code mit QR-Code, Gültigkeitsangaben und Fußbereich</td></tr><tr><td><strong>external_layout_voucher</strong></td><td>Seitenrahmen: Seitengröße, Ränder und Hintergrundbild aus dem Dokumentenlayout des Unternehmens</td></tr></tbody></table>

Um das Gutscheindokument anzupassen, wird die Gutscheinansicht "gift\_card\_report" geöffnet.

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2FGWMHO2U4DhtJyCiqhoGV%2Fimage.png?alt=media&amp;token=f776b535-bcfa-4526-b75e-1746bbd976e7" alt="Geöffnete Ansicht gift_card_report"><figcaption><p>Geöffnete Ansicht gift_card_report</p></figcaption></figure></div>

## Anpassung über eine vererbte Ansicht

Im Reiter "Vererbte Ansichten" wird über "Zeile hinzufügen" ein PopUp geöffnet, über das eine neue Ansicht erstellt wird. Für die Ansicht wird eine Ansichtsbezeichnung eingegeben. Im Reiter "Architektur" werden die Anpassungen an das Gutscheindokument mit QWEB (XML) vorgenommen.

{% hint style="info" %}
*Die vererbte Ansicht erscheint nicht in der Liste unter* *Gutscheinvorlage* *– diese zeigt dauerhaft nur die beiden Originalansichten. Erreichbar ist die eigene Anpassung über den Reiter "Vererbte Ansichten" der Ansicht "gift\_card\_report".*
{% endhint %}

### Beispiel: Persönlicher Text auf dem Gutschein

Ziel: Zwischen dem Gutschein-Code und dem Fußbereich erscheint auf jedem gedruckten Gutschein ein zusätzlicher Text.

{% stepper %}
{% step %}

#### Gutscheinvorlagen-Ansicht öffnen

Unter *Einstellungen -> System -> Gutscheinvorlage* wird die Ansicht **gift\_card\_report** geöffnet.
{% endstep %}

{% step %}

#### Vererbte Ansicht anlegen

Im Reiter "Vererbte Ansichten" wird über "Zeile hinzufügen" eine neue Ansicht erstellt, z. B. mit der Bezeichnung *Gutschein - Persönlicher Text*.
{% endstep %}

{% step %}

#### Gutscheinvorlagen-Anpassung eintragen

Im Reiter "Architektur" der neuen Ansicht wird die Anpassung hinterlegt:

```xml
<xpath expr="//t[@t-call='onr_loyalty.external_layout_voucher']" position="inside">
    <div style="position: absolute; top: 230mm; left: 12.7mm; right: 12.7mm;
                text-align: center; font-size: 9pt; color: #464646;">
        Vielen Dank für den Einkauf. Wir freuen uns auf Ihren nächsten Besuch.
    </div>
</xpath>
```

{% endstep %}

{% step %}

#### Ansicht speichern

Die Ansicht wird gespeichert. Erst danach steht der neue Text für die Übersetzung zur Verfügung.
{% endstep %}

{% step %}

#### Übersetzung hinterlegen

Am rechten Rand des Feldes **Architektur** zeigt ein Sprachkürzel (z. B. *EN*) an, in welcher Sprache der Inhalt gerade bearbeitet wird. Über dieses Kürzel wird der Dialog **Übersetzen** geöffnet.

Der Dialog listet alle übersetzbaren Begriffe der Ansicht – je aktivierter Sprache einmal. Links steht der ursprüngliche Begriff, rechts wird die Übersetzung eingetragen. Der eigene Text erscheint dort als zusätzlicher Begriff. Mit **Speichern** werden alle Sprachfassungen gemeinsam übernommen.

<div data-with-frame="true"><figure><img src="https://2281246901-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlM26Mg6nljOOOe95HyIq%2Fuploads%2F1QD1UvWMMMkeIERORERb%2Fimage.png?alt=media&amp;token=3a21ce23-6d22-4ba9-ae30-f7effb911704" alt=""><figcaption><p>Gutscheinvorlaegn-Anpassung in eine andere Sprache übersetzen</p></figcaption></figure></div>

{% hint style="warning" %}
*Der Gutschein wird in der Sprache des hinterlegten Kontakts gedruckt. Bleibt eine Sprachfassung leer, erscheint auf dem Gutschein der ursprünglich eingetragene Text.*
{% endhint %}
{% endstep %}

{% step %}

#### Ergebnis prüfen

Zur Kontrolle wird ein bestehender Gutschein über *Drucken -> Gutschein* ausgegeben – für die Prüfung der Übersetzung ein Gutschein eines Kontakts mit der jeweiligen Sprache. Die Gutscheine sind unter [*Konfiguration -> Stammdaten Produkte -> Gutscheine und eWallets*](/verwaltungsoberflache/konfiguration/stammdaten-produkte/preise-and-guthaben/gutscheine-and-ewallet.md) über das jeweilige Gutscheinprogramm aufrufbar.
{% endstep %}
{% endstepper %}

### Aufbau des Gutscheindokuments

Das Gutscheindokument arbeitet mit festen Positionen in Millimetern, damit die Inhalte zur hinterlegten Hintergrundgrafik passen. Eine Angabe zur Position ist daher bei jeder Ergänzung erforderlich.

| Bereich            | Position ab oberem Seitenrand | Inhalt                                                                 |
| ------------------ | ----------------------------- | ---------------------------------------------------------------------- |
| Kopfbereich        | 12,7 mm                       | Kopfzeile des Unternehmens, Logo                                       |
| Mittelteil         | 50 mm                         | Betrag und Art des Gutscheins auf der Schleifengrafik                  |
| Codebereich        | 177 mm                        | QR-Code, Gutschein-Code, Erstell- und Gültigkeitsdatum, Einlösehinweis |
| **frei verfügbar** | **224,5 – 238 mm**            | **–**                                                                  |
| Fußbereich         | 238 mm                        | Name, Anschrift, Land, Telefon, E-Mail, Website                        |

{% hint style="info" %}
*Kopfzeile, Logo und die Angaben im Fußbereich stammen aus den Unternehmensdaten und dem Dokumentenlayout. Für eine Änderung dieser Angaben ist keine Anpassung der Vorlage nötig – sie werden unter* *Einstellungen -> Allgemeine Einstellungen -> Dokumentenlayout* *bzw. beim Unternehmen gepflegt.*
{% endhint %}

Angaben aus dem Gutschein werden über Platzhalter eingebunden, z. B. `<span t-field="o.code"/>` für den Gutschein-Code oder `<span t-field="o.expiration_date"/>` für das Ablaufdatum.

### Hinweise Gutscheinvorlage

* Eine Anpassung gilt für **alle** Gutscheine. Ein nur für einzelne Gutscheine abweichender Text ist über die Vorlage nicht abbildbar.
* Ergänzter Text wird nicht automatisch übersetzt. Für mehrsprachige Ausgaben ist die Übersetzung je Sprache über das Sprachkürzel zu hinterlegen.


---

# 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/system/gutscheinvorlage.md?ask=<question>&goal=<user_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.