> For the complete documentation index, see [llms.txt](https://help.vario-software.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe/modul-belegdruck/beleglayout-einrichten.md).

# Beleglayout einrichten: Logo, Briefpapier und Schrift

Richte Dein Beleglayout Schritt für Schritt mit eigenem Logo, digitalem Briefpapier und einer eigenen Schrift ein.

Mit dem mitgelieferten **Report-Designer** passt Du Deine Belege direkt in VARIO Cloud an. Diese Anleitung führt Dich vom Hochladen Deiner Dateien bis zur Belegvorschau.

Du benötigst Zugriff auf **Postbox**, **DMS** und **System → Ausgabe** sowie die Berechtigung, DMS-Dateien und Reporte zu bearbeiten. Halte Dein Logo oder Briefpapier als **Bilddatei**, z. B. PNG, und Deine eigene Schrift als **TTF- oder OTF-Datei** bereit.

## Was möchtest Du anpassen?

| Dein Ziel                                    | Wo stellst Du es ein?                                                                                                             |
| -------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Ein Logo oder einen Briefkopf einfügen       | **Report Parameter → Pfad zu einem Kopf-Bild**                                                                                    |
| Digitales Briefpapier hinter den Beleg legen | **Report Parameter → Pfad zu einem Hintergrund-Bild** und **Belegdruck → Allgemeine Report Parameter → Hintergrund-Bild drucken** |
| Eine eigene Schrift verwenden                | Datei im DMS als **Schriftart** einordnen, dann unter **Belegdruck → Schriftarten** auswählen                                     |

**Report Parameter** und **Belegdruck** sind zwei getrennte Bereiche auf der Detailseite desselben Reports: Im ersten hinterlegst Du die Bilddateien, im zweiten gestaltest Du das Layout.

## 1. Eigene Dateien hochladen

1. Öffne unter **CRM/DMS** die [**Postbox**](https://help.vario-software.de/vario-cloud-handbuch/crm-dms/postbox.md).
2. Ziehe die Datei in die Fläche **„Datei per Drag & Drop oder Klick hinzufügen.“** oder klicke darauf und wähle die Datei aus.
3. Es öffnet sich der Dialog **„DMS-Zusatzinformationen hinzufügen“**. Wähle für eine **TTF- oder OTF-Datei** den Dokumenttyp **Schriftart**. Bei Bildern kannst Du den vorbelegten Typ beibehalten.
4. Klicke auf **»Dateien hochladen«**.
5. Öffne anschließend unter **CRM/DMS → DMS** die hochgeladene Datei und klicke auf **»Bearbeiten«**.
6. Für ein **Bild** vergibst Du unter **Stammdaten → Alias** eine eindeutige Kennung, z. B. `firmenlogo` oder `briefpapier`. **Speichere** die Datei.

Ein Alias ist für die **Schriftauswahl** nicht erforderlich. Hast Du die Schrift zunächst mit einem anderen Dokumenttyp hochgeladen, wähle am DMS-Datensatz im Bereich **DMS-Typ** den Typ **Schriftart** und speichere.

Ein **Alias** ist der Name, über den Du ein Bild im Report wiederfindest. Aus dem Alias `firmenlogo` wird dort der Pfad `dms://firmenlogo`. Trage weder den Dateinamen auf Deinem Rechner noch den internen Speicherverweis ein.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FYRuw2sXsMsdqsCigMPVo%2Fimage.png?alt=media&amp;token=bbe599a2-d438-46e4-b0fa-6ed417f3d3c7" alt="Alias im DMS-Datensatz einer Bilddatei"><figcaption><p>Den Bildalias vergibst Du an der Datei im DMS.</p></figcaption></figure>

## 2. Den Report-Designer öffnen

Öffne **System → Ausgabe → Belegdruck**, wähle die mitgelieferte Reportgruppe **Beleg** und öffne die Systemvorgabe **Report-Designer**. Klicke auf **»Bearbeiten«**.

Für das erste Layout verwendest Du diesen vorhandenen Report. Du benötigst dafür kein neues Formular und keine JasperReports-Datei. Änderungen gelten für alle Belegausgaben, die diesen Report verwenden. Verwendest Du bereits mehrere Layouts, prüfe vorher, welcher Report zu Deinen Belegen gehört; mehr dazu unter [Auswahl des passenden Reports](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe.md#wie-vario-cloud-den-passenden-report-auswahlt).

Führe nun die passenden Schritte aus den folgenden drei Abschnitten aus.

## 3. Eigenes Logo einfügen

Klicke im geöffneten Report auf **»Bearbeiten«**, falls Du noch nicht im Bearbeitungsmodus bist.

1. Klappe **Report Parameter** auf.
2. Trage unter **„Pfad zu einem Kopf-Bild“** z. B. `dms://firmenlogo` ein. Der Teil nach `dms://` muss genau dem gespeicherten Alias Deiner Bilddatei entsprechen.
3. Öffne **Belegdruck → Allgemeine Report Parameter → Logo-Einstellungen**.
4. Wähle unter **„Skalierung“** die Option **Form beibehalten**, damit das Logo proportional eingepasst wird. Stelle die gewünschte horizontale und vertikale Ausrichtung ein.
5. **Speichere** den Report.

Das Logo wird in den vorgesehenen Bildrahmen im Belegkopf eingepasst. Wenn es kleiner erscheinen soll, kannst Du in der Bilddatei freie Fläche um das Logo anlegen. Weniger Pixel allein verkleinern die Darstellung nicht. Empfehlungen zu Größe und Auflösung findest Du unter [Firmenlogo für Belege vorbereiten](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe/modul-belegdruck.md#firmenlogo-fur-belege-vorbereiten).

## 4. Eigenes Briefpapier als Hintergrund verwenden

1. Lade Dein Briefpapier als **Bilddatei** hoch und vergib z. B. den Alias `briefpapier`, wie in Schritt 1 beschrieben. Eine PDF-Datei verwendest Du hier nicht als Bildpfad.
2. Öffne den Report und klicke auf **»Bearbeiten«**. Trage unter **Report Parameter → „Pfad zu einem Hintergrund-Bild“** den Wert `dms://briefpapier` ein.
3. Öffne **Belegdruck → Allgemeine Report Parameter** und schalte **»Hintergrund-Bild drucken«** ein.
4. **Speichere** den Report.

Das Bild liegt hinter dem Beleginhalt und wird auf das gesamte eingestellte Seitenformat skaliert, einschließlich der eingestellten Seitenränder. Bereite es deshalb im gleichen Seitenverhältnis wie Dein Beleg vor, z. B. im A4-Hochformat. Halte die Flächen für Adresse, Belegkopf, Positionen und Summen frei. Enthält das Briefpapier bereits Dein Logo, prüfe in der Vorschau, ob zusätzlich ein Kopf-Bild ausgegeben wird.

## 5. Eigene Schrift auswählen

1. Lade Deine **TTF- oder OTF-Datei** über die Postbox hoch und speichere sie im DMS mit dem **DMS-Typ Schriftart**, wie in Schritt 1 beschrieben. Eine nur auf Deinem Rechner installierte Schrift reicht nicht aus.
2. Öffne nach dem Hochladen den **Report-Designer**. War er bereits geöffnet, lade die Reportseite neu. Klicke auf **»Bearbeiten«**.
3. Klappe **Belegdruck → Schriftarten** auf.
4. Wähle die hochgeladene Schrift für die gewünschten Textbereiche aus, z. B. **Überschriften** und **Empfangsadresse**, und passe den Schriftgrad an. Die Schrift wird je Textbereich eingestellt.
5. **Speichere** den Report.

Hier wählst Du die Schrift aus der Liste. Ein `dms://`-Bildpfad gehört nicht in die Schriftauswahl.

<figure><img src="https://534317722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fa7nDlxyw1xkeHi7FnWgm%2Fuploads%2FnV9HZHj6m0OVXRqxyH2p%2Fimage.png?alt=media&amp;token=dd34b7a4-d443-4575-99f3-bdec85cf9ec5" alt="Schrifteinstellungen für die einzelnen Textbereiche im Report-Designer" width="563"><figcaption><p>Schriftart und Schriftgrad stellst Du für die jeweiligen Textbereiche ein.</p></figcaption></figure>

## 6. Ergebnis in der Belegvorschau kontrollieren

Öffne im Report den Bereich **Belegvorschau**. Wähle über die **Lupe** einen vorhandenen passenden Beleg und lade die Vorschau über den **Pfeil** neu. Die Vorschau verwendet immer den **gespeicherten** Stand.

Prüfe Logo, Schrift und Lesbarkeit sowie die Seitenumbrüche. Verwende auch einen mehrseitigen Beleg: Keine Angaben dürfen fehlen, abgeschnitten oder von Bildern überdeckt sein. Über **»Herunterladen«** kannst Du die Vorschau zusätzlich als PDF ansehen.

## Wenn etwas nicht erscheint

| Beobachtung                                               | Das prüfst Du                                                                                                                                                                                                                                                                                    |
| --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Das Bild fehlt                                            | Ist die DMS-Datei gespeichert und stimmt der Alias genau mit dem Teil nach `dms://` überein? Steht der Pfad im passenden Feld unter **Report Parameter**?                                                                                                                                        |
| Der Hintergrund fehlt                                     | Ist zusätzlich **»Hintergrund-Bild drucken«** unter **Belegdruck → Allgemeine Report Parameter** eingeschaltet?                                                                                                                                                                                  |
| Die eigene Schrift fehlt in der Liste                     | Ist es eine **TTF- oder OTF-Datei** mit DMS-Typ **Schriftart**? Speichere den DMS-Datensatz und lade die Reportseite neu.                                                                                                                                                                        |
| Die Schrift ändert sich nur an manchen Stellen            | Wähle die Schrift auch für die übrigen gewünschten Textbereiche unter **Schriftarten** aus.                                                                                                                                                                                                      |
| Die Vorschau zeigt den alten Stand                        | **Speichere** zuerst den Report und lade danach die **Belegvorschau** neu.                                                                                                                                                                                                                       |
| In der normalen Belegausgabe erscheint ein anderes Layout | Prüfe die verwendete **Reportgruppe** und die **Regeln** der Reporte. Die Vorschau im geöffneten Report ersetzt diese Auswahl nicht. Siehe [Auswahl des passenden Reports](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe.md#wie-vario-cloud-den-passenden-report-auswahlt). |

Weitere Einstellungen findest Du unter [Modul Belegdruck](https://help.vario-software.de/vario-cloud-handbuch/system/ausgabe/modul-belegdruck.md).


---

# 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://help.vario-software.de/vario-cloud-handbuch/system/ausgabe/modul-belegdruck/beleglayout-einrichten.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.
