# Dokumentenklassen

Konfigurations-Anleitungen im Kontext von Dokumentenklassen.

# Dokumentenklassen

#### Einführung

Dokumentenklassen beschreiben jeweils einen spezifischen Dokumententyp.

Innerhalb einer Dokumentenklasse können für den jeweiligen Dokumententyp, spezifische Konfigurationen angelegt werden:

**1. Felder und Tabellen**

- Lieferantennummer
- Lieferanten-Name
- Bestellnummer
- ID im ERP
- ...

**2. Feldgruppen (auf getrennten Reitern befindliche Felder)**

- Kopfdaten
- Metadaten
- ...

**3. Verlinkung zu Lokatoren (Wie werden Werte für ein Feld gefunden?)**

- reguläre Ausdrücke
- Datenbank-Link,
- Key-Value
- ...

**4. Export-Schnittstellen (Wie werden validierte Dokumente in das Folgesystem gebracht?)**

- Documents Soap
- XML-Datei
- Webservice
- ...

**5. Eigenschaften (allgemeine Konfigurationen für eine Dokumentenklasse)**

Alle möglichen Eigenschaften sind unter der Dokumentationseite der [Stapelklassen-Eigenschaften](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/stapelklassen-eigenschaften) aufgelistet.

<p class="callout info">Die Eigenschaften an einer Dokumentenklasse überschreiben die Eigenschaften an einer Stapelklasse.</p>

**6. Löschgründe**

Alle Löschgründe der Dokumentenklasse können über den Tab bearbeitet werden. Weitere Informationen können der Dokumentationsseite [Dokumentenklassen - Löschgründe](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/dokumentenklassen-loschgrunde) entnommen werden.

#### Dokumentenklasse anlegen

Dokumentenklassen können mit einem Klick auf den Reiter Dokumentenklassen konfiguriert werden

[![image-1648136421456.de - Outlook.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1648136421456-de-outlook.png)](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1648136421456-de-outlook.png)

Die Invoice Dokumentenklasse wird mit dem Invoice Template ausgeliefert.

[![image-1648136538260.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1648136538260.png)](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1648136538260.png)

Mit dem + Symbol können neuen Dokumentenklassen angelegt werden. Hier wird der technische Name und die Beschreibung der Dokumentenklasse gefüllt.

Mit einem Klick auf den Eintrag in der Liste öffnet sich der Konfigurationsdialog für die Dokumentenklasse.

[![Bildschirmfoto 2024-10-17 um 08.35.56.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/bildschirmfoto-2024-10-17-um-08-35-56.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/bildschirmfoto-2024-10-17-um-08-35-56.png)

# Dokumenten- und Tabellenfelder

## Dokumentenfelder

**Dokumentenfelder werden in Squeeze für unterschiedliche Funktionen benötigt:**

- Informationen aus der Extraktion aufnehmen
- Für die Dokumentensuche indiziert werden
- Informationen aus der Extraktion im Validierungsclient darstellen
- Validierte Extraktionsergebnisse in den Exportschnittstellen bereitstellen

**Felder und Tabellen sind als Teil einer Dokumentenklasse zu konfigurieren:**

[![image-1667925377844.png](https://docs.squeeze.one/uploads/images/gallery/2022-11/scaled-1680-/image-1667925377844.png)](https://docs.squeeze.one/uploads/images/gallery/2022-11/image-1667925377844.png)

### Validierungsspezifische Eigenschaften

Diese Einstellungen steuern, wie sich ein Feld in der Validierung verhält.

<table id="bkmrk-pflichtfeld-leere-fe" style="height: 179px;"><thead><tr style="height: 46px;"><td style="height: 46px; width: 118.483px;">Feld-Eigenschaft</td><td style="height: 46px; width: 690.75px;">Bedeutung</td></tr></thead><tbody><tr style="height: 46px;"><td style="height: 46px; width: 118.483px;">Pflichtfeld</td><td style="height: 46px; width: 690.75px;">leere Felder werden im Webclient rot dargestellt, die Validierung ist nicht möglich solange das Feld nicht gefüllt ist</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 118.483px;">Nur Lesen</td><td style="height: 29px; width: 690.75px;">Im Webclient kann das Feld nicht bearbeitet werden, Lokatoren können das Feld im Hintergrund füllen</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 118.483px;">Versteckt</td><td style="height: 29px; width: 690.75px;">das Feld wird im Webclient nicht dargestellt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 118.483px;">Bestätigen</td><td style="height: 29px; width: 690.75px;">das Feld wird im Webclient blau dargestellt und muss vor der Validierung mit Enter bestätigt werden</td></tr></tbody></table>

## Tabellenfelder

Für Tabellenfelder, in der UI nur als "Tabellen" bezeichnet, gelten die selben Kriterien, die auch für Dokumentenfelder gelten. Mit einer Ausnahme:

[![image-1654268333787.png](https://docs.squeeze.one/uploads/images/gallery/2022-06/scaled-1680-/image-1654268333787.png)](https://docs.squeeze.one/uploads/images/gallery/2022-06/image-1654268333787.png)

Für die Tabellenfelder ist es wichtig, dass sowohl ein Überschrift- als auch ein Wert-Lokator definiert werden. Mit Hilfe des Überschrift-Lokators wird die Spalte definiert in der per Wert-Lokator, wie im oberen Beispiel, der zu suchende Wert pro Zeile ausgelesen wird.

## Darstellung von Betragsfeldern

<p class="callout info">Der Reiter "Darstellung" wird nur angezeigt, wenn das Feature-Flag **configurableFieldAmountFormatting** für den Mandanten aktiviert ist (siehe [Features verwalten](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/features-verwalten), verfügbar ab Version 2.7.0). Ist das Flag deaktiviert, gilt für alle Betragsfelder das deutsche Standardformat.</p>

Für Felder und Tabellenspalten mit dem Datentyp **Betrag** lässt sich festlegen, wie Zahlenwerte im Validierungsclient dargestellt und beim Speichern normalisiert werden. Die Einstellungen liegen im Reiter "Darstellung" der Feld- bzw. Spaltenkonfiguration; bei allen anderen Datentypen ist der Reiter nicht auswählbar.

[![Bildschirmfoto 2026-11-09 um 10.50.48.png](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/bildschirmfoto-2026-11-09-um-10-50-48.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/bildschirmfoto-2026-11-09-um-10-50-48.png)

<table id="bkmrk-feld-eigenschaftbede"><thead><tr><td style="width: 20%;">Feld-Eigenschaft</td><td style="width: 80%;">Bedeutung</td></tr></thead><tbody><tr><td>Tausendertrennzeichen</td><td>Zeichen, das die Tausendergruppen trennt. Zur Auswahl stehen Leerzeichen, Punkt (.), Komma (,), Apostroph ('), Accent aigu (´) und Accent grave (`). Ohne Auswahl gilt der Punkt aus dem Standardformat.</td></tr><tr><td>Dezimaltrennzeichen</td><td>Zeichen, das die Nachkommastellen abtrennt. Zur Auswahl stehen Punkt (.) und Komma (,). Ohne Auswahl gilt das Komma aus dem Standardformat.</td></tr><tr><td>Dezimalstellen</td><td>Anzahl der Nachkommastellen, auf die der Wert formatiert wird (0 = keine Nachkommastellen). Ohne Angabe werden 2 Nachkommastellen verwendet.</td></tr></tbody></table>

### Verhalten der Zahlenformatierung

- **Standardformat:** Jede nicht gesetzte Einstellung fällt einzeln auf das deutsche Standardformat zurück – Tausendertrennzeichen ".", Dezimaltrennzeichen "," und 2 Nachkommastellen. Es ist also möglich, nur die Dezimalstellen abweichend zu konfigurieren und die Trennzeichen auf dem Standard zu belassen.
- **Trennzeichen dürfen nicht identisch sein:** Tausender- und Dezimaltrennzeichen müssen sich unterscheiden – auch nach dem Rückfall auf den Standard. Beispiel: Wird als Dezimaltrennzeichen der Punkt gewählt und das Tausendertrennzeichen leer gelassen, wird das Speichern abgelehnt, da der Standard dort ebenfalls den Punkt vorsieht. In diesem Fall muss zusätzlich ein abweichendes Tausendertrennzeichen gesetzt werden. Die Auswahllisten blenden das jeweils bereits gewählte Gegenstück aus.
- **Export:** Die konfigurierten Trennzeichen wirken auf Anzeige und Normalisierung in der Validierung. Beim Validieren und Exportieren eines Dokuments wird bewusst wieder das deutsche Standardformat verwendet, damit Exportschnittstellen ein einheitliches Zahlenformat erhalten. Die konfigurierten **Dezimalstellen bleiben dabei wirksam**.
- Die Einstellungen stehen für Dokumentenfelder und Tabellenspalten gleichermaßen zur Verfügung.

## Eingabehilfen

### Konfiguration der Eingabehilfe

Eingabehilfen auf Feldern oder Tabellenspalten untersützen Validierer beim Auswählen von vordefinierten Werten auf Basis von Stammdatentabellen.

[![image-1667925495049.png](https://docs.squeeze.one/uploads/images/gallery/2022-11/scaled-1680-/image-1667925495049.png)](https://docs.squeeze.one/uploads/images/gallery/2022-11/image-1667925495049.png)

<table id="bkmrk-feld-konfiguration-b" style="height: 329px;"><thead><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Feld-Konfiguration</td><td style="height: 29px; width: 479px;">Bedeutung</td></tr></thead><tbody><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Aktiv?</td><td style="height: 29px; width: 479px;">Hier kann ausgewählt werden, ob die Eingabehilfe aktiviert oder deaktiviert werden soll</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Freitext erlauben?</td><td style="height: 29px; width: 479px;">Wenn Freitext erlauben aktiviert ist, dann können auch Werte in dem Feld eingetragen werden, die nicht in der Datenbank stehen.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Suche ab Zeichen</td><td style="height: 46px; width: 479px;">Hier kann eingetragen werden, ab welcher Anzahl an Zeichen gesucht werden soll.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Tabelle</td><td style="height: 46px; width: 479px;">Hier kann ausgewählt werden, welche Stammdatentabelle als Grundlage für eine Suche dienen soll.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Ergebnisspalte</td><td style="height: 46px; width: 479px;">Hier kann angegeben werden, aus welcher Spalte der Stammdatentabelle das Ergebnis ausgegeben werden soll.</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Suche in Spalte(n)</td><td style="height: 29px; width: 479px;">Hier wird angegeben in welchen Datenbankspalten der eingegebene Wert gesucht werden soll.</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Informationsspalten</td><td style="height: 29px; width: 479px;">Sollten ein oder mehrere Treffer gefunden werden, wird hier angegeben welche Spalteninformationen zur Anzeige der Treffer verwendet werden sollen.</td></tr><tr><td style="width: 329px;">Eingabewert ignorieren</td><td style="width: 479px;">Falls aktiv, wird bei der Eingabehilfe der aktuelle Feldwert ignoriert. Das führt dazu, dass mehr Ergebnisse angezeigt werden.</td></tr><tr><td style="width: 329px;">Max. Anzahl Suchergebnisse</td><td style="width: 479px;">Steuert, wie viele Ergebnisse gesucht und angezeigt werden sollen.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Zusätzliche Filter, um die Ergebnisse der Eingabehilfe einzuschränken</td><td style="height: 46px; width: 479px;">s. unten</td></tr></tbody></table>

**Die Ergebnisse der Eingabehilfe können mit weiteren zur Verfügung stehenden Kopffeldern gefiltert werden. Filter anlegen.:**

<table id="bkmrk-tabellenspalte-hier-" style="border-collapse: collapse; width: 100%; height: 116px;"><tbody><tr style="height: 29px;"><td style="width: 17.1606%; height: 29px;">Tabellenspalte</td><td style="width: 82.8394%; height: 29px;">Hier wird die Tabellenspalte angegeben, mit der der Feldwert verglichen werden soll.</td></tr><tr style="height: 29px;"><td style="width: 17.1606%; height: 29px;">Operant</td><td style="width: 82.8394%; height: 29px;">Hier wird der Operator angegeben mit dessen Hilfe der Datenbankwert und Feldwert verglichen werden sollen.</td></tr><tr style="height: 29px;"><td style="width: 17.1606%; height: 29px;">Feld</td><td style="width: 82.8394%; height: 29px;">Hier wird das Fed ausgewählt in dem der Wert steht, der mit dem Datenbankwert verglichen werden soll.</td></tr></tbody></table>

### Verhalten der Eingabehilfe

<p class="callout info">Die Eingabehilfe wird beeinflusst durch den aktuellen Feldwerte. Auch die Extraktions-Alternativen werden bei der Eingabehilfe berücksichtigt.</p>

<p class="callout warning">Die Dokumentation der Eingabehilfe ist noch nicht vollständig, da ihre Funktion aktiv erweitert wird. Wir bitten diese Dokumentation zukünftig erneut aufzusuchen und um Feedback.</p>

1. Wenn das Feld ein **vor erkannten Wert** durch die Extraktion erhalten **(gilt auch für Alternativen)** hat und das Feld aber durch den Nutzer geleert wurde um eine listen artige Selektion der Stammdaten-Werte zu erzeugen 
    - dann wird die Eingabehilfe dennoch durch den **vor erkannten Wert gefiltert** (<span style="text-decoration: underline;">auch wenn das Feld geleert wurde)</span>, das bedeutet das man nie ein anderes Ergebnis erhält bis man den ersten Buchstaben in das Feld eintippt.

## Prompts für die LLM-Extraktion

<p class="callout info">Prompts wirken nur, wenn das Feature-Flag **llmExtraction** für den Mandanten aktiviert ist (siehe [Features verwalten](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/features-verwalten), verfügbar ab Version 2.34) *und* an der Dokumenten- bzw. Stapelklasse die Eigenschaft **LLMExtraction** gesetzt ist. Ist das Flag deaktiviert, findet keine LLM-gestützte Extraktion statt und hinterlegte Prompts bleiben wirkungslos.</p>

Bei aktiver LLM-gestützter Extraktion und aktivierter **`LLMEnableStandardPrompts`** Dokumentenklasseneigenschaft wird zu jedem Feld und jeder Tabellenspalte automatisch eine Extraktionsanweisung erzeugt. Ohne eigenen Prompt dient dabei die **Feldbeschreibung** als Anweisung, der Datentyp wird aus dem Squeeze-Feldtyp abgeleitet. Eine sorgfältig gepflegte Feldbeschreibung wirkt sich damit unmittelbar auf das Extraktionsergebnis aus.

Ist die Dokumentenklasseneigenschaft **`LLMEnableStandardPrompts`** nicht vorhanden oder auf "Nein" gesetzt, werden Felder ohne Prompts nicht für die LLM-Extraktion berücksichtigt.

Prompts lassen sich an zwei Stellen pflegen: direkt am Feld bzw. an der Tabellenspalte im Reiter **Prompts** der Feldkonfiguration, oder übergreifend in der Ansicht **Prompts** (linkes Menü unterhalb von *Lokatoren*), die alle Einträge getrennt nach Kopfdaten und Positionen auflistet. Aufbau eines Prompts, Geltungsbereich über Stapelklasse / Dokumentenklasse / Firma / Kreditor sowie das gezielte Abschalten einzelner Felder sind unter [Prompts &amp; Filtersystem](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/prompts-filtersystem) beschrieben.

# Dokumentenklassen-Eigenschaften

Mit Dokumentenklasseneigenschaften lassen sich allgemeine Konfigurationen pflegen, welche sich auf die Verarbeitung der Dokumente auswirken, die zu der jeweiligen Dokumentenklasseneigenschaft gehören.

## Eigenschaften

<p class="callout info">Siehe Auflistung der Eigenschaften unter [Stapelklassen-Eigenschaften](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/stapelklassen-eigenschaften)</p>

<p class="callout warning">Die Dokumentenklasseneigenschaften werden höher priorisiert als die Stapelklasseneigenschaften. Demnach überschreiben die Dokumentenklasseneigenschaften die Stapelklasseneigenschaften.</p>

# Dokumentenklassen - Löschgründe

### Einführung

Jede Dokumentenklasse hat seine eigenen Löschgründe, die beim Löschen eines Dokumentes zur Auswahl stehen.  
Diese können unter dem Reiter "Löschgründe" in der Dokumentenklasse angepasst werden:

[![Löschgründe UI](https://docs.squeeze.one/uploads/images/gallery/2026-05/scaled-1680-/bildschirmfoto-2026-05-05-um-11-36-29.png)](https://docs.squeeze.one/uploads/images/gallery/2026-05/bildschirmfoto-2026-05-05-um-11-36-29.png)

#### Eigenschaften

Diese Einstellungen steuern, wie sich ein Löschgrund für Nutzer verhält.

<table id="bkmrk-pflichtfeld-leere-fe" style="width: 100%; height: 152.781px;"><thead><tr style="height: 46.5938px;"><td style="width: 14.8288%; height: 46.5938px;">Feld-Eigenschaft</td><td style="width: 85.0521%; height: 46.5938px;">Bedeutung</td></tr></thead><tbody><tr><td style="width: 14.8288%;">Name</td><td style="width: 85.0521%;">Der interne Name des Feldes. Es sind nur alphanumerische Zeichen sowie der Unterstrich "\_" und das Minuszeichen "-" erlaubt. Umlaute und andere Sonderzeichen Zeichen sind nicht erlaubt.</td></tr><tr><td style="width: 14.8288%;">Beschreibung</td><td style="width: 85.0521%;">Dieser Text wird dem Nutzer im Dropdown angezeigt und wird automatisch aus dem Namen generiert, falls verfügbar wird eine Übersetzung aus der CSV extrahiert.</td></tr><tr style="height: 46.5938px;"><td style="width: 14.8288%; height: 46.5938px;">Textfeld</td><td style="width: 85.0521%; height: 46.5938px;">Bei einem Löschgrund mit aktivem Textfeld muss der Nutzer einen Kommentar eintragen, üblich für Löschgründe "Sonstiges"</td></tr><tr style="height: 29.7969px;"><td style="width: 14.8288%; height: 29.7969px;">Aktiv?</td><td style="width: 85.0521%; height: 29.7969px;">Ist der Löschgrund aktiv kann dieser von einem Nutzer in dieser Dokumentenklasse ausgewählt werden</td></tr></tbody></table>

#### Standard-Löschgründe

System Standard-Löschgründe sind fest im System hinterlegt und können nicht bearbeitet oder gelöscht werden. Das Textfeld kann aktiviert oder deaktiviert werden und der entsprechende Grund kann deaktiviert werden, damit ein Nutzer diese nicht angezeigt bekommt.

#### Sortierung

Die Löschgründe können über die erste Spalte per "Drag &amp; Drop" sortiert werden. Diese Sortierung wird in der Nutzeransicht übernommen.