# Squeeze for Dynamics 365 BC - de-DE

Handbuch zur Administration und Nutzung von SQUEEZE for Microsoft Dynamics 365 Business Central.  
  
SQUEEZE ist eine Mandanten-fähige Software-Lösung für Dokumenten-Klassifikation und Inhaltsextraktion.   
Es ist ein vollständig webbasiertes System zur Verarbeitung von elektronischen Dokumenten, mit wesentlichem Fokus auf die Erkennung und Auslesung von Eingangsdokumenten im B2B Sektor.

# Systemvoraussetzungen

Systemvoraussetzungen zur Nutzung von SQUEEZE for Dynamics 365 BC

# Unterstützte Microsoft Dynamics 365 Business Central Versionen

Die Microsoft Dynamics 365 Business Central Integration ist auf Grund von technischen Mindestvoraussetzungen ab folgender Version möglich:

[Unterstützte Microsoft Dynamics 365 Business Central Versionen](https://docs.squeeze.one/books/dexpro-business-central-apps/page/unterstutzte-microsoft-dynamics-365-business-central-versionen "Unterstützte Microsoft Dynamics 365 Business Central Versionen")

<p class="callout info">Voraussetzung zum Betrieb ist, dass die jeweilige Microsoft Dynamics 365 Business Central Version sich noch im regulären Support befindet. Der erweiterte Support (extended Support) wird ausgeschlossen.</p>

# Unterstützte SQUEEZE Versionen

Die Integration von SQUEEZE in Microsoft Dynamics 365 Business Central benötigt für den Betrieb ein lizensiertes SQUEEZE System ab der Version 2.20.0.

Bei der Kombination aus einem Cloud BC und einem OnPrem Squeeze, muss beachtet werden, dass BC die Belege aus dem PULL Export von Squeeze abholt. Somit muss das Squeeze System aus der BC Cloud Umgebung erreichbar sein.

Microsoft hat hierzu diesen Artikel erfasst: [https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/security/security-service-tags#destination-service-supports-network-access-rules-with-ip-ranges](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/security/security-service-tags#destination-service-supports-network-access-rules-with-ip-ranges)

# Installation

# Lizenzen

### Microsoft

Informationen zu den [Microsoft Business Central Lizenzen](https://docs.squeeze.one/books/dexpro-business-central-apps/page/bc-lizenzen).

### SQUEEZE

Das DEXPRO SQUEEZE System welches an Business Central angeschlossen werden soll benötigt eine gültige Kunden-Lizenz.

# Bezug der DEXPRO Module

Detailliertere Informationen finden Sie [hier](https://docs.squeeze.one/books/dexpro-business-central-apps/page/bezug-der-dexpro-module).

### OnPrem

Für OnPrem Installationen wird auf Anfrage eines registrierten Resellers / Partners ein Runtime Package mit den benötigten Apps zur Verfügung gestellt. Diese werden durch den Partner der Kundenlizenz hinzugefügt und im Anschluss in das Microsoft Dynamics Business Central eingespielt.

### Cloud

Für Cloud Installationen benötigt man lediglich Zugriff auf den Microsoft [AppSource](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.69470%7CPAPPID.368db399-65f5-4250-9afd-b2a67a49e809?tab=Overview). Hier werden die benötigten DEXPRO Apps heruntergeladen.

[![Squeeze_icon_appsource.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/squeeze-icon-appsource.png)](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.69470%7CPAPPID.368db399-65f5-4250-9afd-b2a67a49e809?tab=Overview)

# Einrichtungsassistent

Wenn die SQUEEZE Einrichtung das erste mal geöffnet wird, wird man von dem SQUEEZE Einrichtungsassistenten begrüßt.

Dieser führt den Anwender Schritt für Schritt durch die grundlegenden Einstellungen des Moduls. Nach Abschluss des Assistenten ist eine Verbindung zwischen Microsoft Dynamics 365 Business Central und Ihrem SQUEEZE Mandanten hergestellt.

#### Willkommen

In diesem Schritt begrüßt Sie der Assistent und erklärt den Ablauf. Halten Sie die URL zu Ihrem SQUEEZE Mandanten (z. B. https://ihrmandantenname.squeeze.one) bereit.

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

#### Mandanten-URL eingeben

In diesem Schritt hinterlegen Sie die URL zu Ihrem SQUEEZE Mandanten. Über die Schaltfläche "Weiter" wird anschließend die Verbindung zum SQUEEZE Mandanten getestet.

Beispiel: https://demo.msbc.squeeze.one

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

#### Verbindung testen und Dokumentenklassen konfigurieren

Nach erfolgreichem Verbindungstest wird in diesem Schritt die Einrichtung der Dokumentenklassen direkt eingebettet. Wählen Sie eine Dokumentenklasse aus, öffnen Sie über die Dokumentenklassen-ID die Auswahl und ordnen Sie die korrekte SQUEEZE Dokumentenklassen-ID zu, die angebunden werden soll.

[![image-1760436263416.png](https://docs.squeeze.one/uploads/images/gallery/2025-10/scaled-1680-/image-1760436263416.png)](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1760436263416.png)

#### Core- und SQUEEZE-Nummernserie

In diesem Schritt wählen Sie eine Nummernserie für die Core Belege und eine für die SQUEEZE Belege aus. Sollte noch keine existieren, so wird automatisch eine Standard-Nummernserie für Sie angelegt, die Sie übernehmen oder über die Nummernserienauswahl ändern können.

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

#### Abschluss

Durch den Klick auf "Fertigstellen" beenden Sie den Einrichtungsassistenten. Im Anschluss werden Sie gefragt, ob Sie die Einrichtung der Dokumentenklassen jetzt öffnen möchten. Weitere Konfigurationsmöglichkeiten werden [hier](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/squeeze-einrichtung) beschrieben.

[![image-1760438852555.png](https://docs.squeeze.one/uploads/images/gallery/2025-10/scaled-1680-/image-1760438852555.png)](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1760438852555.png)

# Konfiguration & Administration

# Berechtigungssätze

Um die Module nutzen zu können, muss den jeweiligen Anwendern der passende Berechtigungssatz zugewiesen werden.

Folgende werden mit ausgeliefert:

- DXP Core Admin - <span class="stringcontrol-read value thm-cont-u1-font-size-2--medflat thm-cont-u1-font-stack-2--medflat thm-cont-u1-color-2--medflat thm-cont-u1-color-2--medtint--grid-row-selected thm-cont-u1-color-2--mintint--grid-row-nosel-hovered thm-cont-g2-bgcolor-2 thm-cont-s1-bdrcolor--focus thm-cont-s1-outlinecolor--focus" id="bkmrk-dexpro-core-administ" tabindex="0" title="DEXPRO Core Administrator">DEXPRO Core Administrator</span>
- DXP Core User - <span class="stringcontrol-read value thm-cont-u1-font-size-2--medflat thm-cont-u1-font-stack-2--medflat thm-cont-u1-color-2--medflat thm-cont-u1-color-2--medtint--grid-row-selected thm-cont-u1-color-2--mintint--grid-row-nosel-hovered thm-cont-g2-bgcolor-2 thm-cont-s1-bdrcolor--focus thm-cont-s1-outlinecolor--focus" id="bkmrk-dexpro-core-benutzer" tabindex="0" title="DEXPRO Core Benutzer">DEXPRO Core Benutzer</span>
- DXP SQUEEZE Admin - <span class="stringcontrol-read value thm-cont-u1-font-size-2--medflat thm-cont-u1-font-stack-2--medflat thm-cont-u1-color-2--medflat thm-cont-u1-color-2--medtint--grid-row-selected thm-cont-u1-color-2--mintint--grid-row-nosel-hovered thm-cont-g2-bgcolor-2 thm-cont-s1-bdrcolor--focus thm-cont-s1-outlinecolor--focus" id="bkmrk-dexpro-squeeze-admin" tabindex="0" title="DEXPRO SQUEEZE Administrator">DEXPRO SQUEEZE Administrator</span>
- DXP SQUEEZE User - <span class="stringcontrol-read value thm-cont-u1-font-size-2--medflat thm-cont-u1-font-stack-2--medflat thm-cont-u1-color-2--medflat thm-cont-u1-color-2--medtint--grid-row-selected thm-cont-u1-color-2--mintint--grid-row-nosel-hovered thm-cont-g2-bgcolor-2 thm-cont-s1-bdrcolor--focus thm-cont-s1-outlinecolor--focus" id="bkmrk-dexpro-squeeze-benut" tabindex="0" title="DEXPRO SQUEEZE Benutzer">DEXPRO SQUEEZE Benutzer</span>
- DXP SQUEEZE Objects - Exec - <span class="stringcontrol-read value thm-cont-u1-font-size-2--medflat thm-cont-u1-font-stack-2--medflat thm-cont-u1-color-2--medflat thm-cont-u1-color-2--medtint--grid-row-selected thm-cont-u1-color-2--mintint--grid-row-nosel-hovered thm-cont-g2-bgcolor-2 thm-cont-s1-bdrcolor--focus thm-cont-s1-outlinecolor--focus" id="bkmrk-dexpro-squeeze-objec" tabindex="0" title="DEXPRO SQUEEZE Objekte - Ausführen">DEXPRO SQUEEZE Objekte - Ausführen</span> (interner Baustein, nicht direkt zuweisbar; enthält die Ausführungsberechtigungen auf die SQUEEZE-Objekte und wird von den übrigen Berechtigungssätzen sowie den Lizenz-Entitlements referenziert)

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

# DEXPRO Core

Der DEXPRO Core verwaltet die einzelnen DEXPRO Apps und deren Dokumente pro Mandant.

Es werden alle Belege, welche über die unterschiedlichen DEXPRO Module in Microsoft Dynamics 365 Business Central eingelaufen und verarbeitet worden sind, angezeigt. Zur Nachvervolgung von einzelnen Belegen wird auf eine globale Nummernserie, welche über alle DEXPRO Apps genutzt wird, gesetzt. Dies bietet den Vorteil, dass die Anwender mit nur einer Nummernserie pro Beleg arbeiten.

Weitere Informationen finden sie [hier](https://docs.squeeze.one/books/dexpro-microsoft-dynamics-365-business-central-apps/chapter/dexpro-core).

# SQUEEZE Einrichtung

In der SQUEEZE Einrichtung wird sowohl die Anbindung an das SQUEEZE System, als auch die Verarbeitung innerhalb der App eingerichtet.

## Menü

### Start

[![image-1760438915204.png](https://docs.squeeze.one/uploads/images/gallery/2025-10/scaled-1680-/image-1760438915204.png)](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1760438915204.png)

#### Einrichtungsassistent

Hier rüber wird der [Einrichtungsassistenz](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-admin-handbuch/page/einrichtungsassistent) gestartet. Dieser führt den Anwender Schritt für Schritt durch alle Menüpunkte.

#### Einrichtung kopieren

Hiermit wird die Einrichtung in andere Mandanten kopiert.

#### API-Schlüssel holen

Über diese Funktion wird mithilfe von Benutzername und Passwort der erste API-Schlüssel des angeschlossenen SQUEEZE System geholt und im isolierten Speicher abgelegt.

#### Hintergrundjobs anlegen

Die automatisierte Abholung und Verarbeitung von Dokumenten aus SQUEEZE erfordert die Einrichtung eines [Hintergrundjobs](https://docs.squeeze.one/link/303#bkmrk-hintergrundjob). Dies kann in über diese Funktion durchgeführt werden.

### Stammdaten

[![image-1765442320505.png](https://docs.squeeze.one/uploads/images/gallery/2025-12/scaled-1680-/image-1765442320505.png)](https://docs.squeeze.one/uploads/images/gallery/2025-12/image-1765442320505.png)

#### Squeeze Stammdatentabellen

Öffnet eine Übersicht über die [Stammdatentabellen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-stammdatentabellen "Squeeze Stammdatentabellen"), die bei einer Synchronisierung mit Squeeze berücksichtigt werden.

### Navigation

[![image-1765442346395.png](https://docs.squeeze.one/uploads/images/gallery/2025-12/scaled-1680-/image-1765442346395.png)](https://docs.squeeze.one/uploads/images/gallery/2025-12/image-1765442346395.png)

#### SQUEEZE-Verknüpfungen (obsolet)

Über den Menüpunkt SQUEEZE-Verknüpfungen kann man einsehen welcher Kreditor bzw. welches Kreditorenbankkonto welche ID auf der Squeeze Seite hat.

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

#### Benutzerspezifische Einrichtung

Über diesen Menüpunkt erreichen Sie die [benutzerspezifische Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerspezifische-einrichtung). In dieser können abweichende Regeln je Anwender hinterlegt werden.

#### Importwarteschlangen-Einrichtung

In diesem [Menü](https://docs.squeeze.one/link/524#bkmrk-importwarteschlangen "Importwarteschlange") wird eine Liste von SQUEEZE Belegen angezeigt, die bereit für den Import in die SQUEEZE for BC App sind. Durch das Ändern des Systemfilters ist es ebenfalls möglich, bereits importierte Belege einzusehen.

#### Kreditorenbezogene Einrichtung

Über diesen Menüpunkt erreichen Sie die [kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-admin-handbuch/page/kreditorenbezogene-einrichtung). In dieser können abweichende Regeln pro Kreditor hinterlegt werden.

#### Dokumentenklassen Einrichtung

Über diesen Menüpunkt erreichen Sie die Einrichtung für die SQUEEZE [Dokumentenklassen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/dokumentenklassen-einrichtung).

## FastTabs

### Allgemein

In diesem FastTab kann man die Nutzung dieser App aktivieren/Deaktivieren. Zusätzlich sieht man die Version des angeschlossenem SQUEEZE-Systems.

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

### API

In diesem Fasttab wird die URL des SQUEEZE Systems angegeben. Des Weiteren wird über den **API-Schlüsselname** der Name des Zugriffsschlüssels gesetzt und der dazugehörige API-Schlüssel über die Funktion "API-Schlüssel holen" eingetragen. Bei jedem Öffnen der SQUEEZE Einrichtung wird zudem die Verbindung zum verbundenen SQUEEZE Mandanten überprüft.

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

### Nummernserie

Hier wird die Nummernserie für die SQUEEZE Belege angegeben.

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

### Hintergrundjobs

Für die automatisierte Abholung von Belegen aus SQUEEZE sowie deren Verarbeitung und Bereinigung ist die Einrichtung von Hintergrundjobs notwendig. Sobald die Aktion "Hintergrundjobs anlegen" in der SQUEEZE Einrichtung ausgeführt wird, werden folgende Aufgabenwarteschlangenposten automatisch angelegt:

- **Belegdownload-Job**: Führt die Codeunit "DXP SQUEEZE Download Tasks" aus. Dieser Job lädt neue Belege aus SQUEEZE herunter und legt sie in der App an. Er wird standardmäßig alle 2 Minuten ausgeführt und zunächst mit dem Status "Zurückgestellt" (On Hold) angelegt, damit er kontrolliert aktiviert werden kann.
- **Bereinigungs-Job**: Führt die Codeunit "DXP SQUEEZE Cleanup Tasks" aus. Dieser Job bereinigt bereits validierte bzw. zur Löschung markierte Belege. Er berücksichtigt dabei das in den Job-Einstellungen hinterlegte Bereinigungsintervall als Datumsformel (z. B. -1M).
- **Stammdatensynchronisierung**: Führt die Codeunit "DXP SQZ Synch. Master Data" aus und überträgt freigegebene und fakturierte Einkaufsbestellungen an SQUEEZE (siehe [Squeeze Stammdatentabellen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-stammdatentabellen)). Er wird alle 5 Minuten ausgeführt, nur angelegt, wenn Bestellungen synchronisiert werden, und erscheint in den Aufgabenwarteschlangenposten als „DEXPRO Squeeze - Stammdatensynchronisierung“. Dieser Posten wird nicht in der SQUEEZE Einrichtung verknüpft.

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

In der SQUEEZE Einrichtung sind die Aufgabewarteschlangenposten anschließend verknüpft.

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

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

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

#### Sicherheit

In diesem FastTab befinden sich sicherheitsrelevante Einstellungen:

- **Dokument-Token verwenden**: Wenn aktiviert, wird anstelle des API-Schlüssels ein dokumentspezifisches Zugriffstoken für Viewer-URLs verwendet. Das Token ist 30 Minuten gültig und wird automatisch erneuert. Dies erhöht die Sicherheit, da der API-Schlüssel nicht in Browser-URLs übertragen wird.

#### Viewer

In diesem FastTab befinden sich Einstellungen zum SQUEEZE Viewer:

- **Viewer im Ziel-Beleg**: Wenn aktiviert, wird der SQUEEZE Viewer als Infobox (FactBox) auch in den resultierenden Zielbelegen angezeigt, z. B. in Einkaufsrechnungen und Einkaufsbestellungen. So können Anwender den ursprünglich gescannten Beleg auch nach der Validierung jederzeit einsehen, ohne zum SQUEEZE-Beleg zurückkehren zu müssen.
- **Neuen Viewer verwenden**: Wenn aktiviert, wird der neue SQUEEZE Viewer (Vorschauversion) genutzt.

#### Job-Einstellungen

Zusätzlich zu den Hintergrundjobs selbst kann in den Job-Einstellungen der folgende Wert konfiguriert werden:

- **Bereinigungsintervall (Datumsformel)**: Definiert, wie alt die zur Löschung markierten Belege sein müssen, bevor sie bereinigt werden. Beispiel: `-1M` bedeutet, dass Belege mindestens einen Monat alt sein müssen.

# Dokumentenklassen Einrichtung

In der SQUEEZE Dokumentenklassen Einrichtung wird die Zuordnung zwischen der jeweiligen Dokumentenklasse und Ihrer Exportschnittstelle vorgenommen. Des Weitern wird hier die Feldzuordnung jeder Dokumentenklasse heruntergeladen und so ein Set an Standard Feldern und deren Verwendung in Microsoft Dynamics 365 Business Central hergestellt.

Die [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/dexpro-business-central-apps/page/dokumentenklassen-einrichtung) ist App übergreifend und wird über den DEXPRO Core verwaltet.

### Start

[![image-1761290057881.png](https://docs.squeeze.one/uploads/images/gallery/2025-10/scaled-1680-/image-1761290057881.png)](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761290057881.png)

#### Feldzuordnung herunterladen

Hiermit wird die Feldstruktur der SQUEEZE Dokumentenklasse heruntergeladen. Diese werden für die [Metadaten-Zuordnung](#bkmrk-kreditorenbezogene-e) benötigt.

### Navigation

[![image-1761290085366.png](https://docs.squeeze.one/uploads/images/gallery/2025-10/scaled-1680-/image-1761290085366.png)](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761290085366.png)

#### Feldzuordnung

Über diesen Menüpunkt erreichen Sie die [Feldzuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-admin-handbuch/page/metadaten-zuordnung). In dieser wird definiert welche Felder aus dem Squeeze-Endpunkt an die definierten Felder in Microsoft Dynamics 365 Business Central übertragen werden. Die Standardfeldzuordnung ist nicht editierbar. Abweichende Zuordnungen können über die [Benutzerdefinierte Feldzuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerdefinierte-feldzuordnung "Benutzerdefinierte Feldzuordnung") realisiert werden.

#### Kreditorenbezogene Einrichtung

Über diesen Menüpunkt erreichen Sie die [kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung). In dieser können Sie je Kreditor abweichende Einstellungen zu den Standardeinrichtungen der Dokumentenklasse vornehmen.

### Liste

#### Dokumentenklassen

In dieser Übersicht werden alle eingerichteten Dokumentenklassen aufgelistet.

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

### Karte

#### Dokumentenklasse

Hier wird jede Dokumentenklasse individuell eingerichtet.

### Allgemein

[![image-1677144005353.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677144005353.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677144005353.png)

In diesem FastTab wird der Name der Dokumentenklasse, der nächste Prozessschritt, sowie die automatische Anreicherung der Positionen eingerichtet.

### Squeeze

[![image-1761290180014.png](https://docs.squeeze.one/uploads/images/gallery/2025-10/scaled-1680-/image-1761290180014.png)](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761290180014.png)

##### Standardbuchungsdatum

Analog zum BC Standard haben Sie die Möglichkeit, ein Buchungsdatum als Standard zu definieren, sofern anderweitig noch keins eingetragen wurde (z.B. durch die [Benutzerdefinierte Feldzuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerdefinierte-feldzuordnung "Benutzerdefinierte Feldzuordnung")). Sie können zwischen dem Arbeitsdatum, der Standard BC Einrichtung "Kreditoren &amp; Einkauf Einr." und dem heutigen Datum wählen.

[![image-1707118510125.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1707118510125.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1707118510125.png)

##### Autovervollständigen:

Das System kann sich pro Kreditor merken, wie Sie die Positionen eines Belegs kontiert haben (Art, Nr., Mengeneinheit, Beschreibung und Dimensionen), und dieselben Positionen auf den nächsten Belegen wieder ausfüllen. Hierfür gibt es drei Optionen, die gewählt werden können.

1. **Niemals:** Die Funktion ist ausgeschaltet. Die Aktion „Autovervollständigen" wird auf der Validierungsseite ausgeblendet und beim Import wird nichts ausgefüllt.
2. **Manuell:** Die Positionen werden beim Validieren gemerkt. Angewendet werden sie nur, wenn Sie auf der Validierungsseite die Aktion „Autovervollständigen" ausführen. [![image-1683626664167.png](https://docs.squeeze.one/uploads/images/gallery/2023-05/scaled-1680-/image-1683626664167.png)](https://docs.squeeze.one/uploads/images/gallery/2023-05/image-1683626664167.png)
3. **Automatisch:** Die Positionen werden beim Validieren gemerkt und beim Import von Belegen ohne Bestellnr. automatisch angewendet. Die Aktion „Autovervollständigen" steht zusätzlich zur Verfügung.

<p class="callout info">Für einzelne Kreditoren können Sie in der [Kreditorenbezogenen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung) abweichen. Voraussetzungen, Funktionsweise und Beispiele finden Sie unter [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen).</p>

##### Automatische Validierung:

Aktivieren Sie diese Option, damit Squeeze for BC eingehende Belege automatisch validiert. Bitte beachten Sie, dass diese Funktion nur im Falle vollkommen plausibler Daten funktioniert.

##### Validierungsdialog deaktivieren:

Nach dem Abschluss der Validierung fragt Squeeze for BC: **Validierung erfolgreich. Möchten Sie den Beleg jetzt öffnen?** Aktivieren Sie diesen Schalter, wenn diese Frage bei Belegen dieser Dokumentenklasse nicht gestellt werden soll. Die Einstellung ist die Voreinstellung für alle Benutzer. Hat ein Benutzer eine [Benutzerspezifische Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerspezifische-einrichtung), gilt für ihn stattdessen deren Einstellung **Validierungsdialog deaktivieren**.

<p class="callout info">In einer neu angelegten benutzerspezifischen Einrichtung ist **Validierungsdialog deaktivieren** bereits aktiviert. Benutzer mit einer benutzerspezifischen Einrichtung sehen die Frage daher nur, wenn sie den Schalter dort deaktivieren.</p>

##### Anhänge herunterladen:

Aktivieren Sie diesen Schalter, um beim Erstellen eines neuen Belegs automatisch SQUEEZE Anhänge herunterzuladen.

##### Anhänge in den Zielbereich transferieren:

Hierrüber richten Sie ein, ob die SQUEEZE Anhänge in den Zielbeleg transferiert werden sollen.

##### Kontierungscode:

Gibt die [Kontierungseinrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungseinrichtungen) an, die bei der Durchführung der Kontierung im Validierungsprozess verwendet werden soll.

#### API Einstellungen

An dieser Stelle wird die der Dokumentenklasse entsprechende ID des verbundenen Squeeze Mandanten hinterlegt sowie die ID der Pull-Export-Schnittstelle, als auch die korrekte Line Table ID. Die Standardwerte stimmen nicht zwangsläufig mit der Einrichtung im Squeeze Mandanten überein und sollten gegengeprüft werden.

#### Bestellabgleich

Der [Bestellabgleich](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/bestell-wareneingangsabgleich) dient zur automatisierten Überprüfung der ausgelesenen Positionen mit denen der noch offenen Bestellungen in Microsoft Dynamics 365 Business Central. In diesem FastTab werden die zulässigen Betrags- &amp; Mengentoleranzen für den Abgleich eingerichtet. Zusätzlich kann festgelegt werden, ob der Abgleich gegen Bestellungen oder Lieferungen statt finden soll. Wenn "Daten ersetzen" aktiv ist, ersetzen Einzelpreis und Zeilenbetrag der Bestellzeile die der Position (bei einer Lieferung zusätzlich Einzelpreis und Produktbuchungsgruppen der Lieferzeile); sonst wird der Einzelpreis nur übernommen, wenn er 0 ist. Beschreibung, Menge und Rabatt % übernehmen Rechnungen und Gutschriften immer aus der Bestellzeile.

#### Plausibilitätsprüfung

An dieser Stelle können Sie einzelne Plausibilitätsprüfungen deaktivieren.

#### Bestellnummer im Kopf anzeigen

Über den Schalter **Bestellnummer im Kopf anzeigen** kann eingestellt werden, ob die erkannte Bestellnummer im Kopfbereich des SQUEEZE-Belegs als Feld dargestellt werden soll.

#### Dokumententeilung deaktivieren

Über den Schalter **Dokumententeilung deaktivieren** kann die Funktion "Dokument aufteilen" für diese Dokumentenklasse deaktiviert werden. Wenn aktiviert, steht die Belegtrennung in der Validierungsseite nicht zur Verfügung.

#### Bestellungszuweisung zulassen

Über den Schalter **Bestellungszuweisung zulassen** kann festgelegt werden, ob SQUEEZE-Positionen manuell Bestellzeilen zugewiesen werden dürfen.

#### Gesperrten Lieferanten (Zahlung) ignorieren

Über den Schalter **Gesperrten Lieferanten (Zahlung) ignorieren** kann eingestellt werden, ob Kreditoren mit dem Gesperrtstatus "Zahlung" bei der Plausibilitätsprüfung nicht als fehlerhaft markiert werden sollen.

#### Regeln

An dieser Stelle können Sie anhand der [Rules Engine](https://docs.squeeze.one/books/dexpro-microsoft-dynamics-365-business-central-apps/page/regel-engine-rules-engine) regelbasierte Einrichtungen vornehmen. Die Rules Engine ermöglicht es, anhand von Bedingungen automatisiert Entscheidungen zu treffen:

- **Nächster Prozessschritt**: Definiert die Regelgruppe, die den nächsten Prozessschritt bestimmt. So kann z. B. festgelegt werden, dass Belege bestimmter Kreditoren oder ab einem bestimmten Betrag in eine individuelle Verarbeitung geleitet werden.
- **Kontierungscode**: Definiert die Regelgruppe, die den zu verwendenden Kontierungscode bestimmt. Hier ein [Beispiel](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen).
- **Zeilenkontierung**: Definiert die Regelgruppe, die den einzelnen Belegzeilen ein Konto und Dimensionen zuweist. Mehr dazu unter [Kontierungen anhand von Bedingungen auswählen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen).
- **Plausibilitätsregelgruppe**: Definiert die Regelgruppe, deren Regeln Einträge der Plausibilitätsprüfung erzeugen. Jede aktive Regel, deren Bedingungen zutreffen, fügt einen Eintrag mit einer automatisch erzeugten Meldung hinzu.

# Kreditorenbezogene Einrichtung

In dieser Einrichtung werden pro SQUEEZE Dokumentenklasse kreditorenspezifische Einstellungen vorgenommen. Dies wird für Kreditoren getan, welche vom eingestellten Mandanten-Standard abweichen.

Neben der Autovervollständigung von Positionen können hier auch abweichende Betrags- und Mengentoleranzen eingerichtet werden.

### Liste

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

### Karte

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

##### Autovervollständigen:

Das System kann sich pro Kreditor merken, wie Sie die Positionen eines Belegs kontiert haben (Art, Nr., Mengeneinheit, Beschreibung und Dimensionen), und dieselben Positionen auf den nächsten Belegen wieder ausfüllen. Hierfür gibt es drei Optionen, die gewählt werden können.

1. **Niemals:** Die Funktion ist für diesen Kreditor ausgeschaltet. Die Aktion „Autovervollständigen" wird auf der Validierungsseite ausgeblendet und beim Import wird nichts ausgefüllt.
2. **Manuell:** Die Positionen werden beim Validieren gemerkt. Angewendet werden sie nur, wenn Sie auf der Validierungsseite die Aktion „Autovervollständigen" ausführen. [![image-1683626664167.png](https://docs.squeeze.one/uploads/images/gallery/2023-05/scaled-1680-/image-1683626664167.png)](https://docs.squeeze.one/uploads/images/gallery/2023-05/image-1683626664167.png)
3. **Automatisch:** Die Positionen werden beim Validieren gemerkt und beim Import von Belegen ohne Bestellnr. automatisch angewendet, auch wenn die Dokumentenklasse auf „Manuell" steht.

<p class="callout info">Gibt es für einen Kreditor eine Kreditorenbezogene Einrichtung, gilt ihre Option statt der der Dokumentenklasse – in beide Richtungen. Eine neue Kreditorenbezogene Einrichtung übernimmt zunächst die Option der Dokumentenklasse. Voraussetzungen, Funktionsweise und Beispiele finden Sie unter [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen).</p>

Die gelernten Einträge eines Kreditors öffnen Sie in der Liste mit der Aktion **Autovervollständigen-Einträge**.

##### Automatische Validierung:

Aktivieren Sie diese Option, damit Squeeze for BC eingehende Belege automatisch validiert. Bitte beachten Sie, dass diese Funktion nur im Falle vollkommen plausibler Daten funktioniert.

##### Kontierungscode:

Gibt die [Kontierungseinrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungseinrichtungen) an, die bei der Durchführung der Kontierung im Validierungsprozess verwendet werden soll.

#### Bestellabgleich

Der [Bestellabgleich](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/bestell-wareneingangsabgleich) dient zur automatisierten Überprüfung der ausgelesenen Positionen mit denen der noch offenen Bestellungen in Microsoft Dynamics 365 Business Central. In diesem FastTab werden die zulässigen Betrags- &amp; Mengentoleranzen für den Abgleich eingerichtet. Zusätzlich kann festgelegt werden, ob der Abgleich gegen Bestellungen oder Lieferungen statt finden soll. Wenn "Daten ersetzen" aktiv ist, ersetzen Einzelpreis und Zeilenbetrag der Bestellzeile die der Position (bei einer Lieferung zusätzlich Einzelpreis und Produktbuchungsgruppen der Lieferzeile); sonst wird der Einzelpreis nur übernommen, wenn er 0 ist. Beschreibung, Menge und Rabatt % übernehmen Rechnungen und Gutschriften immer aus der Bestellzeile.

# Kontierungseinrichtungen

Hier finden Sie die Kontierungseinrichtungen. Wenn Sie Standardkontierungen für bestimmte MwSt. Sätze haben, so können Sie die hier hinterlegen.

Eine Kontierungseinrichtung legt fest, wie ein Beleg ohne Bestellbezug kontiert wird: Für jeden MwSt.-Satz im Belegkopf, zu dem die Kontierungseinrichtung eine Zeile hat, fügt SQUEEZE eine Belegzeile mit dem hinterlegten Konto und dem Nettobetrag dieses MwSt.-Satzes ein – oder, über einen Standardeinkaufscode, mehrere Zeilen, auf die der Nettobetrag verteilt wird. Das lohnt sich bei Rechnungen, deren einzelne Positionen Sie für die Buchung nicht brauchen, etwa für Energie, Reinigung, Wartung oder Bürobedarf.

Jede Kontierungseinrichtung hat einen Code, den **Kontierungscode**. Angewendet wird sie automatisch beim Import des Belegs oder von Hand mit der Aktion **Kontierungscode anwenden** in den Zeilen des Belegs.

[![image-1729088531464.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729088531464.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729088531464.png)

## Voraussetzungen

- **Kontierungscode mit Zeilen:** In der Liste **Squeeze Kontierungseinrichtungen** gibt es einen Code mit mindestens einer Kontierungseinrichtungszeile.
- **Passender MwSt.-Satz:** Der **MwSt.-Satz** einer Kontierungseinrichtungszeile stimmt genau mit einem Steuersatz im Belegkopf überein (**Steuersatz**, **Steuersatz 2** oder **Steuersatz 3**), und der zugehörige Nettobetrag (**Nettobetrag**, **Nettobetrag 2** oder **Nettobetrag 3**) ist nicht 0.
- **Buchbare Konten:** Ein Sachkonto ist ein nicht gesperrtes Buchungskonto, das Direktbuchungen zulässt; ein Artikel ist nicht gesperrt. Für die MwSt.-Geschäftsbuchungsgruppe des Belegs und die MwSt.-Produktbuchungsgruppe der Zeile ist die MwSt.-Buchungsmatrix eingerichtet.
- **Für die Kontierung beim Import:** Der Beleg gehört zur Dokumentenklasse **Rechnung / Gutschrift** und hat keinen Bestellbezug, der Kontierungscode ist in der Dokumentenklassen Einrichtung, in der Kreditorenbezogenen Einrichtung oder über eine Regel zugeordnet, und an ihm ist **Automatisch anwenden** aktiviert. Für die Aktion **Kontierungscode anwenden** genügt es, den Code in der Auswahlliste zu wählen.
- **Berechtigungen:** Mit dem Berechtigungssatz **DEXPRO SQUEEZE User** können Benutzer Kontierungseinrichtungen lesen und damit auf Belege anwenden. Kontierungscodes anlegen und ändern können Benutzer mit **DEXPRO SQUEEZE Admin**. Siehe [Berechtigungssätze](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/berechtigungssatze).

## Einrichtung

1. Öffnen Sie über die Suche die Liste **Squeeze Kontierungseinrichtungen** und legen Sie einen **Code** mit einer **Beschreibung** an, z. B. BUERO.
2. Öffnen Sie mit der Aktion **Kontierungseinrichtungszeilen** die Zeilen des Codes und legen Sie für jeden MwSt.-Satz, den Sie kontieren möchten, eine Zeile an. Den **MwSt.-Satz** tragen Sie auf der Karte **Squeeze Kontierungseinrichtungszeile** ein; je Code und MwSt.-Satz gibt es genau eine Zeile. Die Felder der Zeile sind unten unter „Kontierungseinrichtung“ beschrieben.
3. Ordnen Sie den Code zu: im FastTab **Squeeze** der [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) im Feld **Kontierungscode**, in der [Kreditorenbezogenen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung) eines Kreditors im Feld **Kontierungscode** oder über eine Regel (siehe [Kontierungen anhand von Bedingungen auswählen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen)).
4. Legen Sie fest, ob der Code beim Import automatisch angewendet wird (**Automatisch anwenden**, **Squeeze Zeilen überschreiben**, siehe unten).

Die Felder der Liste **Squeeze Kontierungseinrichtungen**:

- **Code** und **Beschreibung** — der Kontierungscode und wofür er gedacht ist.
- **Kreditorennr.** — optional. Ist sie gefüllt, erscheint der Code in der Auswahlliste der Aktion **Kontierungscode anwenden** nur bei Belegen dieses Kreditors. Auf Codes, die über die Dokumentenklasse, die Kreditorenbezogene Einrichtung oder eine Regel zugeordnet sind, wirkt sich das Feld nicht aus.
- **Automatisch anwenden** und **Squeeze Zeilen überschreiben** — steuern die Kontierung beim Import, siehe unten.

### Zuordnung und automatische Anwendung

Sobald eine Kontierungseinrichtung mit Einrichtungszeilen angelegt und in einer [Dokumentenklassen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) oder einer [kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung) hinterlegt wurde, wird diese automatisch heran gezogen.

Beim Importieren eines Beleges von Squeeze werden die erkannten MwSt. Sätze gegen die Einrichtungszeilen der hinterlegten Kontierungseinrichtung geprüft. Wenn passende Einträge gefunden werden, wird hierzu geprüft, ob Zeilen mit den hinterlegten Kontierungen angelegt werden dürfen. Im Standard Fall wird dies nur durchgeführt, wenn Squeeze <span style="text-decoration:underline;">keine</span> Positionen liefert.

Zusätzlich kann eingerichtet werden, ob eine Kontierungseinrichtung automatisch für die Validierung angewendet werden soll.

<p class="callout info">Dies sollte in der [Dokumentenklasseneinrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) nicht als Standard gesetzt sein, da dies dann für alle Kreditoren und Belege gelten würde. Diese Option ergibt für einzelne Kreditoren mehr Sinn ([Kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung)).</p>

Für die automatische Anwendung kann man zusätzlich aktivieren, dass alle Squeeze-Zeilen eines Dokuments mit den konfigurierten Kontierungseinrichtungszeilen überschrieben werden. ("Squeeze Zeilen überschreiben" anhaken)

<table id="bkmrk-automatisch-anwenden"><thead><tr><th>Automatisch anwenden</th><th>Squeeze Zeilen überschreiben</th><th>SQUEEZE liefert keine Zeilen</th><th>SQUEEZE liefert Zeilen</th></tr></thead><tbody><tr><td>aus</td><td>–</td><td>keine Kontierung</td><td>keine Kontierung</td></tr><tr><td>an</td><td>aus</td><td>Zeilen aus der Kontierungseinrichtung werden eingefügt</td><td>keine Kontierung, die Zeilen von SQUEEZE bleiben</td></tr><tr><td>an</td><td>an</td><td>Zeilen aus der Kontierungseinrichtung werden eingefügt</td><td>alle Zeilen werden gelöscht, dann werden die Zeilen aus der Kontierungseinrichtung eingefügt</td></tr></tbody></table>

<p class="callout warning">Ohne **Automatisch anwenden** legt der Import keine Zeilen an – auch nicht bei Belegen, für die SQUEEZE keine Zeilen geliefert hat. Der Schalter wirkt unabhängig davon, ob in der Dokumentenklassen Einrichtung **Automatische Validierung** aktiviert ist. Belege mit Bestellbezug werden beim Import nie kontiert. Auf die Aktion **Kontierungscode anwenden** haben beide Schalter keinen Einfluss.</p>

#### Kontierungseinrichtung

Zu jedem Kontierungscode werden die Einrichtungszeilen separat verwaltet.

[![image-1729088721850.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729088721850.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729088721850.png)

Hier werden die einzelnen MwSt. Sätze, zu denen Standardkontierungen gesetzt werden sollen, angelegt.

Pro MwSt. Satz setzt man im Anschluss die Kontierungsart.

##### Kontierungsart "Ein Konto"

[![image-1729088814439.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729088814439.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729088814439.png)

Die Auswahl der Kontoart entspricht dem BC Standard:

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

Die Beschreibung kann nach Auswahl der Nummer beliebig angepasst werden.

Als **Art** stehen Sachkonto, Artikel, Anlage und Zu-/Abschlag (Artikel) zur Auswahl. Mit der **Nr.** wird die **Beschreibung** des Kontos eingetragen; **Produktbuchungsgruppe** und **MwSt. Produktbuchungsgruppe** werden vom Konto übernommen, solange sie leer sind. Alle drei Felder können Sie ändern. Wechseln Sie später nur die Nr., bleiben bereits gefüllte Buchungsgruppen stehen – prüfen Sie sie dann. Beim Einfügen der Belegzeile haben die Buchungsgruppen der Kontierungseinrichtungszeile Vorrang vor denen des Kontos. Die Dimensionen der Zeile legen Sie im Bereich **Dimensionen** oder mit der Aktion **Dimensionen** fest.

<p class="callout info">Den MwSt.-Prozentsatz der eingefügten Zeile ermittelt Business Central aus der MwSt.-Geschäftsbuchungsgruppe des Belegs und der MwSt. Produktbuchungsgruppe der Zeile – nicht aus dem Feld **MwSt.-Satz**. Dieses Feld dient nur dazu, den passenden Steuersatz im Belegkopf zu finden. Wählen Sie für die Zeile mit 7 % also ein Konto oder eine MwSt. Produktbuchungsgruppe mit 7 %.</p>

##### Kontierungsart "Standardeinkaufscode"

[![image-1729088762427.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729088762427.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729088762427.png)

Hier kann ein Standardeinkaufscode aus den wiederkehrenden Einkaufszeilen ausgewählt werden.

[![image-1729088952793.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729088952793.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729088952793.png)

Für jede Zeile des Standardeinkaufscodes legt SQUEEZE eine Belegzeile an – mit Art, Nr., Beschreibung, Menge, Mengeneinheit und Dimensionen dieser Zeile. Die Buchungsgruppen kommen vom jeweiligen Konto. Wie der Nettobetrag des MwSt.-Satzes auf die Zeilen verteilt wird, legt die **Verteilungsart** fest:

<table id="bkmrk-verteilungsartmenge-"><thead><tr><th>Verteilungsart</th><th>Menge der Zeile</th><th>Betrag der Zeile</th></tr></thead><tbody><tr><td>**Gleichmäßig**</td><td>1</td><td>Nettobetrag geteilt durch die Anzahl der Zeilen</td></tr><tr><td>**Proportional nach Menge**</td><td>Menge aus dem Standardeinkaufscode</td><td>Anteil der Zeile an der Gesamtmenge mal Nettobetrag; der EK-Preis ist dieser Betrag geteilt durch die Menge</td></tr><tr><td>**Fixen Betrag verwenden**</td><td>Menge aus dem Standardeinkaufscode</td><td>**Betrag ohne MwSt.** der Zeile im Standardeinkaufscode – unabhängig vom Nettobetrag des Belegs</td></tr></tbody></table>

Eine Menge 0 im Standardeinkaufscode zählt als 1. Rundungsdifferenzen bei **Gleichmäßig** und **Proportional nach Menge** landen in der letzten Zeile. Textzeilen ohne Art werden mit übernommen, erhalten aber keinen Betrag. Einen **Betrag ohne MwSt.** lässt Business Central im Standardeinkaufscode nur bei Sachkonten und Zu-/Abschlägen (Artikel) zu; alle anderen Zeilen erhalten bei **Fixen Betrag verwenden** den Betrag 0.

## So funktioniert es

### Welcher Kontierungscode gilt?

Für einen Beleg gilt immer genau ein Kontierungscode. SQUEEZE ermittelt ihn in dieser Reihenfolge:

1. **Regel:** Ist in der Dokumentenklassen Einrichtung im Abschnitt **Regeln** im Feld **Kontierungscode** eine Regelgruppe hinterlegt und trifft eine ihrer Regeln auf den Beleg zu, gilt der Kontierungscode dieser Regel. Eine zutreffende Regel ohne Kontierungscode wird übergangen.
2. **Kreditorenbezogene Einrichtung:** Sonst gilt der **Kontierungscode** aus der Kreditorenbezogenen Einrichtung des Kreditors für diese Dokumentenklasse, sofern er gefüllt ist.
3. **Dokumentenklassen Einrichtung:** Sonst gilt der **Kontierungscode** im FastTab **Squeeze** der Dokumentenklassen Einrichtung.

<p class="callout info">Eine neue Kreditorenbezogene Einrichtung übernimmt beim Anlegen den Kontierungscode der Dokumentenklasse. Ändern Sie danach den Code der Dokumentenklasse, bleibt der Code beim Kreditor unverändert. Leeren Sie das Feld beim Kreditor, gilt wieder der Code der Dokumentenklasse – ein leeres Feld nimmt den Kreditor also nicht von der Kontierung aus. Dafür hinterlegen Sie beim Kreditor einen eigenen Kontierungscode mit Zeilen, bei dem **Automatisch anwenden** ausgeschaltet ist.</p>

### Beim Import

Wenn SQUEEZE eine Rechnung oder Gutschrift importiert, wird der Kontierungscode nur angewendet, wenn alle diese Bedingungen erfüllt sind:

1. **Kein Bestellbezug:** SQUEEZE hat im Beleg keine Bestellnummer erkannt – weder im Kopf noch als Alternative zur Bestellnr. noch in einer Zeile. Andernfalls ist im Belegkopf **Bestellnummer gefunden** gesetzt, und der Beleg wird nicht kontiert. Das gilt auch, wenn der automatische Bestellabgleich ausgeschaltet ist oder es die Bestellnummer in Business Central gar nicht gibt.
2. **Ein Kontierungscode gilt** (siehe oben), und an ihm ist **Automatisch anwenden** aktiviert.
3. **Keine Zeilen von SQUEEZE** – oder am Kontierungscode ist **Squeeze Zeilen überschreiben** aktiviert. Dann werden zuerst alle Zeilen des Belegs gelöscht – aber nur, wenn die Kontierungseinrichtung für mindestens einen Steuersatz des Belegs eine Zeile einfügt. Passt keiner, bleiben die ausgelesenen Zeilen unverändert.

Anschließend wird für jede Kontierungseinrichtungszeile, deren **MwSt.-Satz** einem Steuersatz im Kopf entspricht, der zugehörige Nettobetrag kontiert. Ist dieser Nettobetrag 0, entsteht für den MwSt.-Satz keine Zeile. Rückfragen gibt es beim Import nicht.

### Aktion „Kontierungscode anwenden“

Auf der Seite [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung) wählen Sie in den Zeilen **Funktionen** → **Kontierungscode anwenden**. Die Aktion wirkt unabhängig von **Automatisch anwenden** und **Squeeze Zeilen überschreiben** und auch bei Belegen mit Bestellbezug. Sie verwendet die Steuersätze und Nettobeträge, die gerade im Belegkopf stehen – korrigieren Sie diese also vorher.

[![Zeilen des Squeeze Belegs, Menü Funktionen mit Kontierungscode anwenden](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/squeeze-document-line-functions.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/squeeze-document-line-functions.png)

1. Liefert eine Regel oder die Kreditorenbezogene Einrichtung einen Kontierungscode, verwendet die Aktion ihn ohne Rückfrage. Sonst öffnet sich die Liste **Squeeze Kontierungseinrichtungen** mit allen Codes ohne **Kreditorennr.** und den Codes für den Kreditor des Belegs; der Code aus der Dokumentenklassen Einrichtung ist vorausgewählt. Schließen Sie die Liste ohne Auswahl, bricht die Aktion mit **Kein Kontierungs-Setup ausgewählt.** ab.
2. Hat der Code keine Kontierungseinrichtungszeilen, bricht die Aktion mit **Keine Squeeze Kontierungseinrichtung gefunden.** ab.
3. Hat der Beleg einen Bestellbezug, fragt das System: **Wir haben mindestens eine Bestellnummer in Ihrem Beleg entdeckt - Diese Funktion löscht alle bestehenden Positionen und fügt neue Positionen basierend auf den Steuersätzen und Nettobeträgen des Belegkopfes ein. Möchten Sie fortfahren?** Mit **Nein** bricht die Aktion ab, ohne etwas zu ändern.
4. Hat der Beleg Zeilen, fragt das System: **Dadurch werden alle vorhandenen Positionen gelöscht und neue Positionen auf der Grundlage der Steuersätze und Nettobeträge des Belegkopfes eingefügt. Möchten Sie fortfahren?** Mit **Ja** werden alle Zeilen gelöscht – auch Zeilen, die einer Bestellung oder einem Wareneingang zugeordnet sind. Mit **Nein** bricht die Aktion ab, ohne etwas zu ändern.
5. Danach fügt die Aktion die Zeilen aus der Kontierungseinrichtung ein.

Regeln zur Zeilenkontierung laufen nach der Aktion nicht von selbst. Wenn Sie welche eingerichtet haben, wählen Sie anschließend **Funktionen** → **Kontierungsregeln anwenden**.

### Welche Zeilen entstehen

- **Kontierungsart „Ein Konto“:** eine Zeile mit **Art**, **Nr.** und **Beschreibung** der Kontierungseinrichtungszeile, **Menge** 1 und dem Nettobetrag des MwSt.-Satzes als **EK-Preis**. Die Zeile erhält genau die Dimensionen der Kontierungseinrichtungszeile; Vorgabedimensionen des Kontos kommen nicht hinzu. Hat die Kontierungseinrichtungszeile keine Dimensionen, hat zunächst auch die Belegzeile keine.
- **Kontierungsart „Standardeinkaufscode“:** eine Zeile je Zeile des Standardeinkaufscodes, verteilt nach der **Verteilungsart** (siehe oben).

Die neuen Zeilen werden hinter vorhandenen Zeilen angefügt, in aufsteigender Reihenfolge der MwSt.-Sätze.

Steht [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen) auf **Automatisch** und hat der Beleg keine **Bestellnr.**, läuft es direkt nach dem Einfügen – beim Import ebenso wie bei der Aktion. Hat Autovervollständigen für den Kreditor und das Konto eine Beschreibung oder Dimensionen gelernt, ersetzen diese die Werte aus der Kontierungseinrichtung; ein Eintrag ohne Beschreibung oder ohne Dimensionen lässt die Werte aus der Kontierungseinrichtung stehen.

### Reihenfolge beim Import

1. Kopf und Zeilen werden aus SQUEEZE angelegt.
2. Autovervollständigen (nur bei Option **Automatisch** und ohne Bestellnr.)
3. Bestellnummern werden gesucht, gegebenenfalls wird **Bestellnummer gefunden** gesetzt; automatischer Bestellabgleich, falls eingerichtet
4. Kontierung über die Kontierungseinrichtung (nur ohne Bestellbezug), anschließend Autovervollständigen
5. Regeln zur Zeilenkontierung – eine zutreffende Regel überschreibt auch das Konto einer Zeile aus der Kontierungseinrichtung
6. Automatische Validierung, falls aktiviert

## Beispiele

### Beispiel 1: Rechnung mit 19 % und 7 %

Ein Bürobedarfshändler (Kreditor 44000) liefert Büromaterial und Fachbücher. Seine Rechnungen haben keine Bestellnummer, die einzelnen Positionen brauchen Sie nicht. In der Kreditorenbezogenen Einrichtung des Kreditors ist der Kontierungscode BUERO hinterlegt; an ihm ist **Automatisch anwenden** aktiviert. BUERO hat zwei Kontierungseinrichtungszeilen:

<table id="bkmrk-mwst.-satzkontierung"><thead><tr><th>MwSt.-Satz</th><th>Kontierungsart</th><th>Art</th><th>Nr.</th><th>Beschreibung</th><th>MwSt. Produktbuchungsgruppe</th></tr></thead><tbody><tr><td>7</td><td>Ein Konto</td><td>Sachkonto</td><td>6820</td><td>Zeitschriften, Bücher</td><td>Gruppe für 7 %</td></tr><tr><td>19</td><td>Ein Konto</td><td>Sachkonto</td><td>6815</td><td>Bürobedarf</td><td>Gruppe für 19 %</td></tr></tbody></table>

SQUEEZE liest aus einer Rechnung im Kopf **Steuersatz** 19 mit **Nettobetrag** 250,00 und **Steuersatz 2** 7 mit **Nettobetrag 2** 80,00, aber keine Zeilen. Beim Import entstehen zwei Zeilen:

<table id="bkmrk-artnr.beschreibungme"><thead><tr><th>Art</th><th>Nr.</th><th>Beschreibung</th><th>Menge</th><th>EK-Preis</th><th>MwSt. %</th></tr></thead><tbody><tr><td>Sachkonto</td><td>6820</td><td>Zeitschriften, Bücher</td><td>1</td><td>80,00</td><td>7</td></tr><tr><td>Sachkonto</td><td>6815</td><td>Bürobedarf</td><td>1</td><td>250,00</td><td>19</td></tr></tbody></table>

Zusammen ergeben sie die 330,00 netto des Belegkopfs. Enthält die nächste Rechnung nur Büromaterial zu 19 %, entsteht nur die Zeile mit 6815. Hätte SQUEEZE Zeilen geliefert, bliebe der Beleg unverändert – es sei denn, an BUERO ist zusätzlich **Squeeze Zeilen überschreiben** aktiviert.

### Beispiel 2: Reinigungskosten auf drei Kostenstellen verteilen

Eine Reinigungsfirma berechnet jeden Monat die Reinigung des ganzen Gebäudes mit 19 % MwSt. Die Kosten sollen auf drei Kostenstellen verteilt werden. Dazu gibt es in Business Central den Standardeinkaufscode REINIGUNG mit drei Zeilen, alle auf Sachkonto 6330 (Reinigung):

<table id="bkmrk-zeilekostenstellemen"><thead><tr><th>Zeile</th><th>Kostenstelle</th><th>Menge</th><th>Betrag ohne MwSt.</th></tr></thead><tbody><tr><td>1</td><td>VERWALTUNG</td><td>2</td><td>250,00</td></tr><tr><td>2</td><td>PRODUKTION</td><td>5</td><td>450,00</td></tr><tr><td>3</td><td>VERTRIEB</td><td>3</td><td>300,00</td></tr></tbody></table>

Der Kontierungscode REINIGUNG hat eine Kontierungseinrichtungszeile mit **MwSt.-Satz** 19, **Kontierungsart** Standardeinkaufscode und **Standardeinkaufscode** REINIGUNG. Bei einer Rechnung über 1.000,00 netto entstehen je nach **Verteilungsart** diese Zeilen (Menge × EK-Preis = Zeilenbetrag):

<table id="bkmrk-kostenstellegleichm%C3%A4"><thead><tr><th>Kostenstelle</th><th>Gleichmäßig</th><th>Proportional nach Menge</th><th>Fixen Betrag verwenden</th></tr></thead><tbody><tr><td>VERWALTUNG</td><td>1 × 333,33 = 333,33</td><td>2 × 100,00 = 200,00</td><td>2 × 125,00 = 250,00</td></tr><tr><td>PRODUKTION</td><td>1 × 333,33 = 333,33</td><td>5 × 100,00 = 500,00</td><td>5 × 90,00 = 450,00</td></tr><tr><td>VERTRIEB</td><td>1 × 333,34 = 333,34</td><td>3 × 100,00 = 300,00</td><td>3 × 100,00 = 300,00</td></tr><tr><td>**Summe**</td><td>1.000,00</td><td>1.000,00</td><td>1.000,00</td></tr></tbody></table>

Steigt der Rechnungsbetrag auf 1.100,00, verteilen **Gleichmäßig** (366,67 / 366,67 / 366,66) und **Proportional nach Menge** (220,00 / 550,00 / 330,00) den neuen Betrag. **Fixen Betrag verwenden** setzt weiterhin 250,00 / 450,00 / 300,00 – die Differenz von 100,00 gleichen Sie von Hand aus.

<p class="callout warning">Alle drei Zeilen haben dasselbe Sachkonto. Autovervollständigen erkennt Zeilen aus der Kontierungseinrichtung nur an Art und Nr. Hat es für diesen Kreditor einen Eintrag mit Dimensionen für Sachkonto 6330 gelernt und steht es auf **Automatisch**, erhalten alle drei Zeilen dieselben Dimensionen. Stellen Sie Autovervollständigen in der Kreditorenbezogenen Einrichtung dieses Kreditors deshalb auf **Manuell** oder **Niemals**, oder löschen Sie den Eintrag.</p>

### Beispiel 3: Ein Code für einen einzelnen Kreditor, Belege mit Bestellnummer

In der Dokumentenklassen Einrichtung ist der Kontierungscode ALLGEMEIN hinterlegt, ohne **Automatisch anwenden**. Für einen Energieversorger (Kreditor 70000) gibt es eine Kreditorenbezogene Einrichtung mit dem Kontierungscode ENERGIE: **Kreditorennr.** 70000, **Automatisch anwenden** an, eine Zeile für 19 % mit Sachkonto 6325 (Gas, Strom, Wasser) und der Kostenstelle VERWALTUNG.

- **Monatsrechnung des Energieversorgers ohne Bestellnummer:** Beim Import entsteht eine Zeile auf 6325 mit dem Nettobetrag und der Kostenstelle VERWALTUNG.
- **Rechnung des Energieversorgers, auf der SQUEEZE eine Bestellnummer erkannt hat:** Im Kopf ist **Bestellnummer gefunden** gesetzt, beim Import wird nicht kontiert. Wählen Sie **Kontierungscode anwenden**, verwendet die Aktion ENERGIE ohne Auswahlliste – nach der Rückfrage wegen der Bestellnummer.
- **Rechnung eines anderen Kreditors ohne Kreditorenbezogene Einrichtung:** Es gilt ALLGEMEIN; weil dort **Automatisch anwenden** aus ist, wird beim Import nicht kontiert. Die Aktion öffnet die Auswahlliste mit ALLGEMEIN vorausgewählt. ENERGIE erscheint darin nicht, weil an ihm die Kreditorennr. 70000 eingetragen ist.

## Einschränkungen

- Kontiert wird nur nach den drei Steuersätzen im Belegkopf, und der MwSt.-Satz muss genau übereinstimmen. Steht derselbe Steuersatz zweimal im Kopf, wird nur der erste Nettobetrag kontiert.
- Gibt es für einen Steuersatz des Belegs keine Kontierungseinrichtungszeile, fehlt dessen Nettobetrag in den Zeilen. Ist der Zeilenbetragsvergleich nicht deaktiviert, meldet die [Plausibilitätsprüfung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/plausibilitatsprufungen) die Differenz zwischen Kopf- und Zeilenbeträgen.
- **Fixen Betrag verwenden** übernimmt die Beträge aus dem Standardeinkaufscode, auch wenn die Rechnung über einen anderen Betrag lautet. Der Nettobetrag des MwSt.-Satzes muss trotzdem ungleich 0 sein, sonst entsteht keine Zeile.
- Die Dimensionen einer Zeile kommen ausschließlich aus der Kontierungseinrichtungszeile bzw. der Zeile des Standardeinkaufscodes – und gegebenenfalls aus Autovervollständigen. Vorgabedimensionen des Kontos werden nicht ergänzt.
- Anders als Autovervollständigen und Regeln zur Zeilenkontierung prüft die Kontierungseinrichtung das Konto beim Einfügen: Ein gesperrtes Sachkonto, ein Sachkonto ohne Direktbuchung oder ein gesperrter Artikel führt zu einer Fehlermeldung – beim Import ebenso wie bei der Aktion.
- Beim Import wird nur in der Dokumentenklasse **Rechnung / Gutschrift** und nur ohne Bestellbezug kontiert.
- Für einen Beleg gilt genau ein Kontierungscode; mehrere Codes lassen sich nicht kombinieren.

## Fehlerbehebung

#### Beim Import werden keine Zeilen angelegt

1. Ist im Belegkopf **Bestellnummer gefunden** gesetzt? Dann wird beim Import nicht kontiert. Ein Drilldown auf das Feld zeigt, welche Bestellnummern erkannt wurden. Wenden Sie den Code mit der Aktion **Kontierungscode anwenden** an.
2. Gehört der Beleg zur Dokumentenklasse **Rechnung / Gutschrift**?
3. Welcher Kontierungscode gilt? Prüfen Sie Regeln, Kreditorenbezogene Einrichtung und Dokumentenklassen Einrichtung in dieser Reihenfolge. Eine Kreditorenbezogene Einrichtung hat beim Anlegen den Code der Dokumentenklasse übernommen.
4. Ist an diesem Code **Automatisch anwenden** aktiviert?
5. Hat SQUEEZE Zeilen geliefert? Ohne **Squeeze Zeilen überschreiben** bleibt der Beleg dann unverändert – mit dem Schalter ebenfalls, wenn kein Steuersatz des Belegs zur Kontierungseinrichtung passt.
6. Stimmt der **MwSt.-Satz** einer Kontierungseinrichtungszeile genau mit **Steuersatz**, **Steuersatz 2** oder **Steuersatz 3** überein, und ist der zugehörige Nettobetrag ungleich 0?

#### Meldung „Keine Squeeze Kontierungseinrichtung gefunden.“

Der Kontierungscode hat keine Kontierungseinrichtungszeilen. Kommt der Code aus einer Regel oder aus der Kreditorenbezogenen Einrichtung, verwendet die Aktion ihn ohne Auswahlliste – legen Sie für diesen Code Zeilen an oder hinterlegen Sie dort einen anderen Code.

#### Meldung „Kein Kontierungs-Setup ausgewählt.“

Sie haben die Auswahlliste geschlossen, ohne einen Code zu wählen. Am Beleg wurde nichts geändert.

#### Meldung „No DXP SQZ Document Lines found.“

Diese Meldung erscheint auf Englisch. Sie kann bei der Kontierungsart Standardeinkaufscode mit der Verteilungsart **Gleichmäßig** oder **Proportional nach Menge** auftreten, wenn der Standardeinkaufscode keine Zeile mit Art und Nr. enthält. Ergänzen Sie den Standardeinkaufscode.

#### Die Zeile hat den falschen MwSt.-Prozentsatz

Der MwSt.-Prozentsatz kommt aus der MwSt. Produktbuchungsgruppe der Zeile. Tragen Sie in der Kontierungseinrichtungszeile die passende **MwSt. Produktbuchungsgruppe** ein, oder wählen Sie ein Konto, dessen Gruppe zum MwSt.-Satz passt.

#### Fehlermeldung zur Nr. oder zum Konto

Bei der Kontierungsart **Ein Konto** ist keine **Nr.** eingetragen, oder das Konto ist inzwischen gesperrt bzw. lässt keine Direktbuchung zu. Korrigieren Sie die Kontierungseinrichtungszeile.

#### Die Zeilen ergeben nicht den Nettobetrag des Belegs

Für einen Steuersatz fehlt eine Kontierungseinrichtungszeile, derselbe Steuersatz steht zweimal im Kopf, oder die Verteilungsart ist **Fixen Betrag verwenden**.

#### Dimensionen fehlen oder weichen ab

Die Zeile erhält nur die Dimensionen der Kontierungseinrichtungszeile – tragen Sie dort alle benötigten Dimensionen ein. Ein gelernter Eintrag von Autovervollständigen oder eine Regel zur Zeilenkontierung kann sie danach ändern.

## Verwandte Themen

- [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung)
- [Kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung)
- [Kontierungen anhand von Bedingungen auswählen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen)
- [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen)
- [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung)
- [Bestell- &amp; Wareneingangsabgleich](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/bestell-wareneingangsabgleich)
- [Plausibilitätsprüfungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/plausibilitatsprufungen)

# Feldzuordnung

In der Feldzuordnung wird das Standard-Mapping jeder Dokumentenklasse heruntergeladen. Diese feste Zuordnung gewährleistet einen reibungslosen Zuordnungsprozess von der Extraktion der Daten in Squeeze bis zur Erstellung eines Einkaufsbelegs.

[![image-1707117274147.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1707117274147.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1707117274147.png)

### Zuweisung von Metadaten

Werden in Squeeze Felder hinzugefügt, haben Sie an dieser Stelle die Möglichkeit, die enthaltenen Informationen direkt an definierte Felder des Einkaufsbelegs zu übertragen. Dieses Informationen sind in der Validierung nicht editierbar, sondern werden quasi "durchgeschleift".

[![image-1707117318752.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1707117318752.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1707117318752.png)

nach Zuweisung:

[![image-1707117563823.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1707117563823.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1707117563823.png)

# Benutzerdefinierte Feldzuordnung

Möglicherweise möchten Sie in Ihrem Prozess immer gewisse Informationen abweichend von der Standard-Feldzuordnung in gewisse Felder schreiben. In dem folgenden Beispiel wird das durch Squeeze erkannte Leistungsdatum immer in das Feld "Buchungsdatum" geschrieben - zusätzlich zum Standardverhalten. Das Leistungsdatum bleibt also trotzdem gefüllt.

**In der Dokumentenklassen-Einrichtung die Feldzuordnung öffnen:**

[![image-1707117914293.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1707117914293.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1707117914293.png)

**Anschließend öffnen Sie die "Benutzerdefinierte Feldzuordnung":**

[![image-1707117989936.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1707117989936.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1707117989936.png)

**Nehmen Sie dann die gewünschte Zuordnung vor:**

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

1. Auswahl des Squeeze-Feldes
2. Auswahl des Validierungs-Feldes zu dem das Squeeze-Feld gemappt wird.
3. Auswahl eines Zielfeldes im BC Standard EK-Beleg

In dieser Einrichtung kann man neue Squeeze Felder auf Validierungsfelder mappen (1+2). Alternativ kann man auch neue Validierungsfelder nur an den Workflow übergeben und das Zielfeld im EK-Beleg mit angeben (2+3). Zudem ist natürlich auch eine Kombination möglich, dass alle drei Optionen genutzt werden. Also eine Übertragung eines Feldes von der Beleglesung zur Validierung, über den Workflow hin zum Einkaufsbeleg.

Auf der [Breeze Seite](https://docs.squeeze.one/link/482#bkmrk-benutzerdefinierte-f) können diese Werte verarbeitet und auch zurück an BC übergeben werden.

# Benutzerspezifische Einrichtung

In dieser Einrichtung werden benutzerspezifische Einstellungen vorgenommen. So haben Anwender die Möglichkeit, die App individuell auf ihre Arbeitsweise und Peripheriegeräte einzustellen.

Die Übersicht zeigt alle Benutzer und ihre jeweiligen Einstellungen. Beim Öffnen wird automatisch der aktuelle Benutzer angezeigt.

#### Viewer

- **Nur externen Viewer verwenden**: Wenn aktiviert, wird der Viewer ausschließlich extern (abgedockt) dargestellt. Dies ist insbesondere beim Arbeiten mit zwei Monitoren empfehlenswert. Der abgedockte Viewer aktualisiert sich bei einem Belegwechsel automatisch.
- **Viewer Auflösung**: Ermöglicht die Anpassung der Viewer-Auflösung. Die Optionen **Hoch** und **Niedrig** stehen zur Verfügung.

#### Validierung

- **Zurück zur Liste nach Validierung**: Wenn aktiviert, wird nach dem Abschluss der Validierung automatisch zur Belegübersicht zurück navigiert. Dies beschleunigt die Bearbeitung bei der sequenziellen Validierung mehrerer Belege.
- **Validierungsdialog deaktivieren**: Wenn aktiviert, wird der Bestätigungsdialog nach dem Abschluss der Validierung unterdrückt. Die Einstellung gilt für den Benutzer anstelle der gleichnamigen Einstellung der [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung). Für Benutzer ohne benutzerspezifische Einrichtung gilt die Einstellung der Dokumentenklasse. In einer neu angelegten Einrichtung ist der Schalter aktiviert.

# Squeeze Stammdatentabellen

### Standardtabellen

Diese Stammdaten werden automatisch, sofern nicht deaktiviert, mit dem Squeeze Mandanten synchronisiert. Es ist nach wie vor notwendig, die Stammdaten initial hochzuladen.

Bei Kreditoren, Kreditorenbankkonten und dem Mandanten werden im Hintergrund die Events für OnInsert, OnModify und OnDelete überwacht und Änderungen adhoc gen Squeeze synchronisiert. Hierfür ist kein separater Job notwendig.

#### Bestellungen

Bestellungen werden über einen Hintergrundjob an Squeeze übertragen:

- Das Freigeben einer Einkaufsbestellung und das Buchen einer Rechnung direkt aus der Bestellung stellen die Änderung nur in eine Warteschlange ein. Die Freigabe bzw. Buchung wartet nicht auf Squeeze.
- Der wiederkehrende Aufgabenwarteschlangenposten **DEXPRO Squeeze - Stammdatensynchronisierung** überträgt die Warteschlange alle 5 Minuten: freigegebene Bestellungen mit ihren noch nicht vollständig fakturierten Zeilen. Nach einer Rechnungsbuchung werden die vollständig fakturierten Zeilen einer weiterhin offenen Bestellung aus Squeeze entfernt.
- Wareneingänge ohne Rechnung lösen keine Übertragung aus – auch nicht, wenn ein Wareneingang palettenweise in vielen einzelnen Buchungen gebucht wird.
- Kann ein Eintrag nicht übertragen werden, z. B. weil Squeeze nicht erreichbar ist, wird er beim nächsten Lauf erneut versucht. Die übrigen Einträge werden trotzdem übertragen.

Der Aufgabenwarteschlangenposten wird automatisch angelegt, sobald Bestellungen synchronisiert werden: beim erstmaligen Hochladen der Stammdaten, über die Aktion „Hintergrundjobs anlegen“ in der [SQUEEZE Einrichtung](https://docs.squeeze.one/link/303#bkmrk-hintergrundjob) und wenn für die Stammdatentabelle der Bestellungen „Nicht synchronisieren“ wieder deaktiviert wird. Bei einem Update der App wird er angelegt, wenn Bestellungen bereits synchronisiert werden.

<p class="callout info">Frühere Versionen legten bei jeder Buchung einer Bestellung einen eigenen, einmaligen Aufgabenwarteschlangenposten an. Bei schnell aufeinanderfolgenden Buchungen – z. B. einem Wareneingang je Palette – konnte die Buchung dadurch mit der Meldung abbrechen, dass der Aufgabenwarteschlangenposten nicht vorhanden ist. Solche einmaligen Posten werden beim Anlegen des wiederkehrenden Postens entfernt.</p>

Das Feld "Verwendet externe Id" wird ab der Squeeze Version 2.13 unterstützt und bietet die Verwaltung der Squeeze Stammdaten aus einer Drittsoftware. In diesem Fall BC.

[![image-1765442638008.png](https://docs.squeeze.one/uploads/images/gallery/2025-12/scaled-1680-/image-1765442638008.png)](https://docs.squeeze.one/uploads/images/gallery/2025-12/image-1765442638008.png)

#### Stammdaten initial hochladen

Über die Funktion "Stammdaten erstmalig hochladen" werden alle Kreditoren und Kreditorenbankkonten, sowie der aktuelle Mandant und die relevanten Bestelldaten erstmalig an SQUEEZE übertragen.

### Generische Stammdatentabellen

Um weitere Stammdaten gen Squeeze zu übertragen, welche nicht mit den Standard Stammdatentabellen überein stimmen, pflegt man diese in der generischen Stammdaten Tabellen Einrichtung.

[![image-1737715560079.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737715560079.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737715560079.png)

##### Anlage der zu übertragenden Tabelle

Im Feld "BC Tabellennr." wird die zu übertragende Tabelle eingetragen oder über den Drilldown ausgewählt. Im Feld "Squeeze Tabellenname" kann dann die Bezeichnung angepasst werden. Im Feld "Synchronisierung aktiviert" wird festgelegt, ob diese Tabelle derzeit synchronisiert werden soll oder nicht.

##### Auswahl der zu übertragenden Felder

Über den Menüpunkt "Feldauswahl" erreichen Sie die Einrichtung.

[![image-1737715953591.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737715953591.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737715953591.png)

Hier werden die Felder ausgewählt, welche synchronisiert werden sollen.

[![image-1737716013473.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737716013473.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737716013473.png)

##### Erstellung der Squeeze Stammdatentabelle aus BC heraus

Nachdem eine BC Tabelle eingetragen und deren Felder für die Synchronisierung ausgewählt worden sind, kann nun eine neue Squeeze Tabelle aus BC heraus angelegt werden. Hierfür steht die Schaltfläche "Squeeze-Tabelle erstellen" zur Verfügung.

[![image-1737716163786.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737716163786.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737716163786.png)

Nach der Erstellung wird in der Übersicht das Feld "Squeeze Tabellen-Id" gesetzt.

Auf der Squeeze Seite steht nun die neue Tabelle zur Verfügung.

[![image-1737716310362.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737716310362.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737716310362.png)

Die ausgewählten Felder sind hier nun als Spalten automatisiert angelegt worden.

[![image-1737716340239.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737716340239.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737716340239.png)

##### Synchronisation der Daten

Nach der Erstellung der Squeeze Tabelle wird der User gefragt, ob eine Synchronisierungsaufgabe erstellt werden soll.

[![image-1737716200501.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737716200501.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737716200501.png)

Ist diese aktiv, so werden die Stammdaten automatisiert im eingerichteten Rhythmus übertragen. Alternativ können die Stammdaten auch manuell über die Schaltfläche "Jetzt synchronisieren" einmalig übertragen werden.

##### Löschen der Stammdatentabelle

Beim Löschen eines Listeneintrags wird gefragt, ob auch die Squeeze Stammdatentabelle mit gelöscht werden soll.

[![image-1737716546550.png](https://docs.squeeze.one/uploads/images/gallery/2025-01/scaled-1680-/image-1737716546550.png)](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737716546550.png)

Sollte dies bestätigt werden, so wird die aus BC erstellte Squeeze-Tabelle unwiederbringlich entfernt.

#### Filterregeln

Über den Menüpunkt **Filterregeln verwalten** können Sie Filter definieren, die festlegen, welche Datensätze der BC-Tabelle an SQUEEZE synchronisiert werden sollen. So können Sie z. B. nur Datensätze eines bestimmten Typs oder mit einem bestimmten Status übertragen.

#### Spalten aktualisieren

Wenn sich die Feldauswahl einer generischen Stammdatentabelle geändert hat, können über die Aktion **Spalten aktualisieren** die Spalten in der SQUEEZE-Tabelle aktualisiert werden, ohne die gesamte Tabelle neu erstellen zu müssen.

#### Synchronisierungsstatus

Für jede generische Stammdatentabelle werden der Zeitpunkt der letzten Synchronisierung (**Zuletzt synchronisiert**) und ein eventueller Fehlertext (**Letzter Synchronisierungsfehler**) angezeigt. Dies erleichtert die Fehlerdiagnose bei Synchronisierungsproblemen.

#### Hinweis zu "Verwendet externe Id"

Das Feld **Verwendet externe Id** wird ab SQUEEZE Version 2.13 unterstützt. Wenn aktiviert, werden die Stammdaten in SQUEEZE über eine externe ID (aus Business Central) verwaltet. Dies ermöglicht eine bidirektionale Referenzierung und verhindert die doppelte Anlage von Stammdaten.

# SQUEEZE

#### Grundsätzliche Einrichtung

Die SQUEEZE Seite muss ebenfalls für das Abholen der Dokumente aus Microsoft Dynamics Business Central vorbereitet werden.

Jede Dokumentenklasse welche von Microsoft Dynamics Business Central abgeholt werden soll, benötigt eine eigene Exportschnittstelle vom Typ "Pull". Zudem muss in Microsoft Dynamics Business Central in der Einrichtung für die SQUEEZE [Dokumentenklassen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/dokumentenklassen-einrichtung) die Dokumentenklassen ID, die Export Schnittstellen ID und die Stammdatentabellen ID hinterlegt werden.

Sofern nicht die neuste SQUEEZE for BC Version benutzt wird, müssen noch die folgenden Stapelklasseneigenschafen in dem SQUEEZE Mandanten gesetzt werden:  
  
[![MicrosoftTeams-image.png](https://docs.squeeze.one/uploads/images/gallery/2023-08/scaled-1680-/microsoftteams-image.png)](https://docs.squeeze.one/uploads/images/gallery/2023-08/microsoftteams-image.png)

#### System Reset

Wird ein Squeeze System zurückgesetzt (z.B. im Rahmen von Tests), müssen folgende Schritte in Business Central berücksichtigt werden:

##### Importwarteschlange

Die Tabelle muss geleert werden. Dabei ist zu beachten, dass alle Filter entfernt werden, die in der Page gesetzt sind.

# Rollencenter-Aktivitäten

SQUEEZE for BC erweitert das Rollencenter des Einkäufers um mehrere Aktivitätenkacheln, die einen Überblick über den aktuellen Bearbeitungsstatus der SQUEEZE-Belege geben.

#### SQUEEZE Aktivitäten

Diese Kacheln zeigen die Anzahl der SQUEEZE-Belege an, die eine Bearbeitung erfordern (offene Belege, heute erstellte Belege, etc.).

#### Zurückgestellte Belege

Diese Kacheln zeigen die Anzahl der zurückgestellten Belege, aufgeschlüsselt nach Zurückstellungsgrund:

- **Gesamt zurückgestellte Belege**: Die Gesamtanzahl aller zurückgestellten Belege.
- **Kreditor existiert nicht**: Belege, bei denen der Kreditor nicht im System gefunden wurde.
- **Klärungsbedarf bzgl. der Leistung**: Belege, bei denen Leistungsdetails geklärt werden müssen.
- **Warten auf Wareneingang**: Belege, die auf den Wareneingang warten.

Jede Kachel ist per Drilldown mit der gefilterten Squeeze Belegübersicht verknüpft.

#### Bestellabgleich-Aktivitäten

Diese Kacheln zeigen die Anzahl der Belege mit Abweichungen aus dem Bestellabgleich:

- **Abweichungen insgesamt**: Die Gesamtanzahl aller Belege mit identifizierten Abweichungen.
- **Mengenabweichung**: Belege mit Mengenunterschieden.
- **Preisabweichung**: Belege mit Preisunterschieden.
- **Wareneingangsdatum-Abweichung**: Belege mit abweichendem Wareneingangsdatum.
- **Rabattabweichung**: Belege mit Rabattunterschieden.

#### Navigation

Im Rollencenter stehen unter der Gruppe **Squeeze** zwei Navigationspunkte zur Verfügung:

- **Aktueller Mandant**: Öffnet die SQUEEZE Belegübersicht des aktuellen Mandanten.
- **Mandantenübergreifend**: Öffnet die mandantenübergreifende Belegansicht.

Über den **Einrichtungsbereich** des Rollencenters kann die SQUEEZE Einrichtung direkt aufgerufen werden.

# Validierung

Sichtkontrolle der ausgelesenen Dokumente

# SQUEEZE Beleg Übersicht

In der Belegübersicht werden alle Belege aufgelistet welche durch SQUEEZE ausgelesen worden sind.

[![image-1729089189050.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729089189050.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729089189050.png)

Durch einen Doppelklick mit der Maus oder über Bearbeiten/Ansicht wird ein einzelner Beleg in der Validierungsansicht geöffnet.

### Start

[![image-1729089227302.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729089227302.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729089227302.png)

##### Belege jetzt herunterladen

Über diese Funktion wird die Belegabholung von SQUEEZE manuell ausgeführt. Wahlweise wird das über den entsprechenden Hintergrundjob gesteuert und durchgeführt.

##### Belege hochladen

Mit dieser Funktion können Sie Belege direkt über BC an ihr Squeeze System senden.

### Navigation

[![image-1729089253473.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/image-1729089253473.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/image-1729089253473.png)

##### Importwarteschlange

In diesem [Menü](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/importwarteschlange "Importwarteschlange") wird eine Liste von SQUEEZE Belegen angezeigt, die bereit für den Import in die SQUEEZE for BC App sind. Durch das Ändern des Systemfilters ist es ebenfalls möglich, bereits importierte Belege einzusehen.

##### Mandanten-Belegübersicht

Öffnet eine [mandantenübergreifende Ansicht](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/mandantenubergreifende-belegansicht) aller Squeeze Belege.

##### Warteschlange

Öffnet eine Übersicht, die Ihnen Informationen zu den Belegen in der SQUEEZE Warteschlange des verbundenen Mandanten liefert.

# Mandantenübergreifende Belegansicht

Die mandantenübergreifende Belegansicht bietet eine Gesamtübersicht aller SQUEEZE-Belege über sämtliche Business Central Mandanten hinweg, in denen SQUEEZE aktiviert ist.

#### Übersicht

Die Ansicht stellt für jeden Mandanten folgende Kennzahlen dar:

- **Mandant**: Der Name des jeweiligen Business Central Mandanten.
- **Offene Belege**: Die Anzahl der offenen SQUEEZE-Belege.
- **Individuelle Verarbeitung**: Die Anzahl der Belege im Status "Individuelle Verarbeitung".
- **Überfällige Belege**: Die Anzahl der überfälligen Belege.
- **Dubletten**: Die Anzahl der als Dublette markierten Belege.
- **Abgelehnte Belege**: Die Anzahl der abgelehnten Belege.
- **Heute erstellte Belege**: Die Anzahl der heute erstellten Belege.
- **Meine offenen Belege**: Die Anzahl der dem aktuellen Benutzer zugewiesenen Belege.

Zusätzlich werden die Ergebnisse des Bestellabgleichs mandantenübergreifend zusammengefasst:

- **Abweichungen insgesamt**: Gesamtanzahl der Belege mit Bestellabgleich-Abweichungen.
- **Preisabweichung / Mengenabweichung / Wareneingangsdatum-Abweichung / Rabattabweichung**: Aufschlüsselung nach Abweichungstyp.

#### Navigation

Jede Kennzahl ist als Drilldown ausgeführt: Durch einen Klick auf einen Wert wird die entsprechend gefilterte Belegübersicht des jeweiligen Mandanten in einem neuen Tab geöffnet.

#### Aktualisierung

Die Daten werden asynchron im Hintergrund geladen und aktualisieren sich automatisch alle 60 Sekunden. Über die Aktion **Daten aktualisieren** kann eine manuelle Aktualisierung ausgelöst werden.

Die mandantenübergreifende Belegansicht ist aus der Belegübersicht über die Aktion **Mandanten-Belegübersicht** oder über das Rollencenter (Squeeze &gt; Mandantenübergreifend) erreichbar.

# Importwarteschlange

Die Importwarteschlage ist eine Mittelschicht, die SQUEEZE Belege in die entsprechenden **Zielmandaten** importiert - der Zielmandant muss mit dem aktuellen BC Mandanten (wichtig: Der **Name (Primärschlüssel)** ist ausschlaggebend, <span style="text-decoration:underline;">nicht</span> der Anzeigename) in dem die Belege heruntergeladen werden, übereinstimmen. Wurde kein Zielmandant erkannt, werden die Belege für die Validierung in dem eingerichteten [**Fallback Mandanten**](#bkmrk-importwarteschlangen) erstellt.

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

### Navigation

##### Importwarteschlangen-Einrichtung

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

**Fallback Mandant**

Gibt den Wert des Fallback Mandanten an. In diesen Mandanten werden Belege importiert, die in der Importwarteschlange einen leeren Zielmandanten aufweisen.

**Zeitspanne für Warnung (Stunden)**

Gibt die Zeitspanne an, nach der eine Warnung angezeigt werden soll, wenn es unverarbeitete Einträge gibt.

### Start

##### Unverarbeitete Datensätze verarbeiten

<div id="bkmrk-erzeugt-squeeze-bele"><div>Erzeugt SQUEEZE-Belege aus nicht verarbeiteten Einträgen in dem aktiven Mandanten. Dies geschieht normalerweise, wenn der erkannte Mandant mit keinem Mandanten in der Datenbank übereinstimmt.</div></div>#### Importpuffer

Über die Aktion **Importpuffer** kann eine Seite geöffnet werden, in der SQUEEZE Beleg-IDs manuell eingetragen werden können. Dies ist nützlich, wenn ein einzelner Beleg gezielt aus SQUEEZE heruntergeladen werden soll, z. B. wenn ein Beleg nicht automatisch abgeholt wurde.

#### Systemfilter

Standardmäßig werden in der Importwarteschlange nur unverarbeitete Einträge des aktuellen Mandanten angezeigt. Über den Systemfilter können auch bereits verarbeitete Einträge sowie Einträge anderer Mandanten eingesehen werden.

Die Spalte **Zielmandant** wird rot hervorgehoben, wenn der Zielmandant vom aktuellen Mandanten abweicht. Dies weist darauf hin, dass der Beleg für einen anderen Mandanten bestimmt ist.

# SQUEEZE Belegvalidierung

Die Belegvalidierung ist der Hauptarbeitsbereich der Anwendung. Hier werden die ausgelesenen Belege vom Anwender überprüft, fehlende Informationen ergänzt und bestätigt.

## Menü

### Start

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

#### Feldtraining öffnen

Öffnet das lieferantenspezifische [Feldtraining](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/lieferantenspezifisches-training).

#### Positionstraining öffnen

Öffnet das lieferantenspezifische [Positionstraining](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/lieferantenspezifisches-training).

#### Beleg neu erstellen

Sendet den Beleg erneut in den Extraktionsschritt des verbundenen SQUEEZE Mandanten. Dort wird das Ausleseergebnis anhand der aktuellen Stammdaten und Trainings neu bewertet und im Anschluss erneut zur Abholung bereit gestellt.

#### Dokument aufteilen

Ruft die die [Belegtrennung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/dokument-aufteilen) auf. Diese wird verwendet, falls ein Lieferant mehrere Rechnungen in einer PDF gesandt hat.

#### Autovervollständigen

Füllt die Positionen mit den Werten aus, die sich das System bei früheren Validierungen dieses Kreditors gemerkt hat: Art, Nr., Mengeneinheit, Beschreibung und Dimensionen. Die Aktion ist sichtbar, wenn die Autovervollständigen-Option in der [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung "Dokumentenklassen Einrichtung") bzw. der [Kreditorenbezogenen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung) nicht auf „Niemals" steht. Sie überschreibt die wiedererkannten Positionen – führen Sie sie deshalb vor Ihren eigenen Korrekturen aus. Mehr dazu unter [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen).

#### Bestellabgleich

Öffnet den [Bestellabgleich](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/bestell-wareneingangsabgleich).

#### Validieren

Schließt den Validierungsprozess des Belegs ab.

#### Doublettenprüfung

Wenn ein neuer Beleg (z.B. eine Eingangsrechnung) ins System importiert wird, prüft SQUEEZE automatisch, ob dieses Dokument **bereits vorhanden** ist. Ziel ist es, eine doppelte Erfassung zu verhindern.

**Voraussetzungen**

Bevor die eigentliche Prüfung startet, müssen zwei Bedingungen erfüllt sein:

1. Das Dokument muss einen gültigen **Einkaufsbelegart** haben (z.B. Rechnung, Gutschrift)
2. Der **Kreditor (Lieferant)** muss bekannt sein — ohne Lieferantennummer ist keine Prüfung möglich

Außerdem findet die gesamte Prüfung nur statt, wenn eine **Belegnr.** (z.B. die Rechnungsnummer des Lieferanten) vorhanden ist. Ohne diese Referenz kann kein Abgleich erfolgen.

**Prüfschritte (in dieser Reihenfolge)**

Die Prüfung vergleicht immer die Kombination aus **drei Feldern**:

- **Einkaufsbelegart** (z.B. Rechnung)
- **Belegnr** (z.B. die externe Rechnungsnummer des Lieferanten)
- **Kreditorennummer** (welcher Lieferant)

Mit dieser Kombination wird in vier Bereichen nacheinander gesucht:

1. **Bereits gebuchte Belege** — Gibt es schon einen gebuchten Posten mit derselben Rechnungsnummer von diesem Lieferanten?
2. **Andere importierte SQUEEZE-Belege**— Wurde dieselbe Rechnung bereits als anderes Dokument importiert und wartet noch auf Verarbeitung?
3. **Offene Einkaufsbelege** — Existiert bereits ein offener (noch nicht gebuchter) Einkaufsbeleg in Business Central mit denselben Daten?
4. **Corebelege** — Ist das Dokument bereits im übergeordneten DXP-System vorhanden (z.B. Breeze Interface)?

**Was passiert bei einem Treffer?**

Sobald in einem der vier Schritte ein bestehendes Dokument gefunden wird, gilt das neue Dokument als **Duplikat**. Die Prüfung stoppt sofort, und das Dokument wird entsprechend markiert. Die weiteren Schritte werden dann nicht mehr durchlaufen.

#### Beleg ablehnen

Diese Aktion erlaubt es Ihnen, einen Beleg abzulehnen. Dieser wird dann, wahlweise mit einem zusätzlichen Kommentar, in einem speziellen Status "Abgelehnt" abgespeichert - nicht jedoch gelöscht.

[![image-1677579185888.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677579185888.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677579185888.png)

Im Anschluss kann noch eine e-Mail an den Lieferanten gesandt werden.

[![image-1677579219509.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677579219509.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677579219509.png)

Hierfür ist ein Standardkonto in der Einrichtung "E-Mail-Konten" anzulegen und als Standard im "E-Mail-Szenario Einrichtung" zu setzen.

Ist dies eingerichtet, wird das BC E-Mail Modul geöffnet. Hier wird der Bemerkungstext der Ablehnung, die Rechnungsnummer, sowie der Absender/Bearbeiter der Validierung vorausgefüllt.

[![image-1677579479375.png](https://docs.squeeze.one/uploads/images/gallery/2023-02/scaled-1680-/image-1677579479375.png)](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677579479375.png)

### Navigation

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

#### Dimensionen

Hier rüber erreichen Sie das Dimensionsmenü um Dimensionen für den Belegkopf zu hinterlegen.

### Viewer

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

#### Externen Viewer öffnen

Hier rüber wird der [Viewer](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/externer-viewer) abgedockt. Dies ermöglicht das Arbeiten auf zwei Monitoren.

### Aktionen

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

#### Dokument verschieben

Hier rüber wird ein Beleg in einen anderen Mandanten verschoben.

#### Anhänge herunterladen

Hier rüber laden Sie die Anhänge des Belegs herunter. Sobald das Herunterladen abgeschlossen wurde, werden diese in der Infobox [Anhänge](https://docs.squeeze.one/link/311#bkmrk-anh%C3%A4nge) angezeigt. Sie haben die Möglichkeit, das Herunterladen der Anhänge automatisch durchführen zu lassen - diese Einstellung nehmen Sie bitte in der [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung "Dokumentenklassen Einrichtung") vor.

## Fasttabs

### Beleg

In diesem Bereich werden die Belegkopf-Informationen sowie der SQUEEZE Viewer angezeigt.

[![image-1688734648314.png](https://docs.squeeze.one/uploads/images/gallery/2023-07/scaled-1680-/image-1688734648314.png)](https://docs.squeeze.one/uploads/images/gallery/2023-07/image-1688734648314.png)

#### Kopffelder

Diese Felder werden mit den Ergebnissen aus der Beleglesung vorbelegt. Der Anweder prüft diese und korrigiert, bzw. reichert sie mit weiteren Daten an und vervollständigt so das Leseergebnis. Über die drei Punkte wird die Fundstelle des jeweiligen Leseergebnisses im Viewer hervorgehoben.

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

#### Zuständigkeitseinheit und MwSt.-Geschäftsbuchungsgruppe

Bei Rechnungen und Gutschriften zeigt der Bereich **Einkauf von Kreditor** zusätzlich die Felder **Zuständigkeitseinheitencode** und **MwSt.-Geschäftsbuchungsgruppe**. Sie werden nicht aus dem Beleg gelesen, sondern legen fest, mit welchen Werten der Einkaufsbeleg in Business Central angelegt wird.

- **Zuständigkeitseinheitencode** — wird beim Import und bei einem Wechsel des Kreditors vorbelegt: mit der Zuständigkeitseinheit, auf die Ihre Benutzereinrichtung (oder die Firmendaten) den Einkauf beschränkt, sonst mit der des Kreditors – genau wie bei einem von Hand angelegten Einkaufsbeleg.
- **MwSt.-Geschäftsbuchungsgruppe** — wird mit der Gruppe des Kreditors vorbelegt, und die Zeilen übernehmen sie. Ändern Sie die Gruppe, etwa für eine Lieferung aus dem Ausland, wird sie an alle Zeilen weitergegeben, die keiner Bestell- oder Lieferzeile zugeordnet sind; die MwSt. dieser Zeilen wird neu berechnet. Zeilen aus einer Bestellung oder Lieferung behalten die Gruppe der Bestell- bzw. Lieferzeile.

Ein Wechsel des Kreditors setzt beide Felder auf die Vorgaben des neuen Kreditors zurück.

<p class="callout info">Bei Auftragsbestätigungen werden die beiden Felder nicht angezeigt: Die bestehende Bestellung behält ihre Zuständigkeitseinheit und MwSt.-Geschäftsbuchungsgruppe.</p>

[![Squeeze Beleg mit Belegkopf und Viewer](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/squeeze-document.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/squeeze-document.png)

#### Viewer

Auf der rechten Seite wird der SQUEEZE Viewer angezeigt. Hierbei handelt es sich nicht um ein PDF, sondern um eine eingebundene Webkomponente, welche hier aus der Validierung ferngesteuert wird. Sie dient zur bildlichen Darstellung des Belegs und zum hervorheben von Fundstellen gelesener Werte. Weiterhin wird hier auch das lieferantenspezifische [Feldtraining](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/lieferantenspezifisches-training) durchgeführt.

[![image-1688734733840.png](https://docs.squeeze.one/uploads/images/gallery/2023-07/scaled-1680-/image-1688734733840.png)](https://docs.squeeze.one/uploads/images/gallery/2023-07/image-1688734733840.png)

### Zeilen

In diesem Bereich werden die ausgelesenen Positionen angezeigt. Der Anweder prüft diese und korrigiert, bzw. reichert sie mit weiteren Daten an und vervollständigt so das Leseergebnis.

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

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

Sollte das Leseergebnis bei Rechnungen mit Bestellbezug nicht ausreichen, so können die [Bestell-/Wareneingangszeilen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-handbuch/page/bestell-wareneingangszeilen-importieren) direkt importiert werden.

Bei Rechnungen ohne Bestellbezug können Positionen aus den MwSt. Raten und Kopfbeträgen generiert werden. Eine Zeile pro MwSt. Rate. Hierfür wird die [Kontierungseinrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungseinrichtungen) aus der [Dokumentenklasse](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) heran gezogen.

### Dimensionen

Hier werden die Shortcut Dimensionen 1 &amp; 2 des Belegs angezeigt.

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

### SQUEEZE Details

Hier werden SQUEEZE spezifische Beleginformationen angezeigt.

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

## Infoboxen

Die jeweiligen Infoboxen werden nur situationsbedingt angezeigt.

### Plausibilitätseinträge

Hier werden alle zu klärende Themen für eine erfolgreiche Validierung aufgelistet.

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

### Metadatenboxen

Die [Metadatenzuordnung](https://docs.squeeze.one/link/304#bkmrk-zuweisung-von-metada) wird nur angezeigt, wenn vom Standard abweichende zusätzliche Felder von SQUEEZE übertragen worden sind.

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

#### Metadatenzuordnung Kopffelder

Hier werden zusätzliche Felder aus SQUEEZE aufgelistet, welche nicht zu der Standardzuordnung der Kopffelder gehören.

#### Metadatenzuordnung Positionsfelder

Hier werden zusätzliche Felder aus SQUEEZE aufgelistet, welche nicht zu der Standardzuordnung der Positionen gehören.

### Bestellabgleichsboxen

Die Bestellabgleichsboxen werden nur angezeigt, wenn eine oder mehrere Bestellnummern auf dem Beleg erkannt worden sind.

#### Bestellabgleich-Info (Preise)

Hier wird für die ausgewählte Zeile der Preisvergleich angezeigt. Verglichen werden die Ergebnisse von SQUEEZE, der Lieferung, der Bestellung und der aktuellen Zeile.

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

#### Bestellabgleich-Info (Mengen)

Hier wird für die ausgewählte Zeile der Mengenvergleich angezeigt. Verglichen werden die Ergebnisse von SQUEEZE, der Lieferung, der Bestellung und der aktuellen Zeile.

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

### Anhänge

Diese Infobox wird nur angezeigt, wenn die Anhänge zuvor heruntergeladen worden sind (das kann auf Wunsch auch automatisch nach der Belegerstellung passiert - siehe [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung "Dokumentenklassen Einrichtung"). Über die drei Punkte lassen sich die Anhänge wieder entfernen.

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

#### Beleg zurückstellen / Zurückstellung entfernen

Über die Aktion **Beleg zurückstellen** kann ein Beleg temporär zurückgestellt werden. In dem sich öffnenden Dialog muss ein Grund ausgewählt werden:

- **Kreditor existiert nicht**: Der Kreditor wurde im System nicht gefunden.
- **Klärungsbedarf bzgl. der Leistung**: Die Liefer- oder Leistungsdetails müssen geklärt werden.
- **Warten auf Wareneingang**: Der Wareneingang steht noch aus.

Zusätzlich kann eine freie Notiz hinterlegt werden. Zurückgestellte Belege können nicht validiert werden, bis die Zurückstellung über **Zurückstellung entfernen** aufgehoben wird.

Zurückgestellte Belege werden im Rollencenter in eigenen Aktivitätenkacheln nach Grund aufgeschlüsselt dargestellt.

#### Ablehnung zurücknehmen

Wurde ein Beleg bereits abgelehnt, kann die Ablehnung über die Aktion **Ablehnung zurücknehmen** wieder aufgehoben werden. Der Beleg kehrt dann in den vorherigen Status zurück.

#### Beleg verschieben

Über die Aktion **Beleg verschieben** (im Menü unter Aktionen) kann ein Beleg in einen anderen Mandanten verschoben werden. Der Beleg wird im aktuellen Mandanten gelöscht und im Zielmandanten neu erstellt.

#### Kreditor erstellen/finden

Über die Aktion **Kreditor erstellen/finden** kann anhand der erkannten Textfelder (Name, Adresse, USt-ID etc.) ein passender Kreditor im System gesucht oder ein neuer Kreditor angelegt werden.

#### Fehlendes Bankkonto erstellen

Über die Aktion **Fehlendes Bankkonto erstellen** kann ein Kreditorbankkonto aus der erkannten IBAN angelegt werden, sofern die IBAN auf dem Beleg erkannt wurde, jedoch kein passendes Bankkonto beim Kreditor hinterlegt ist.

#### Kontierungscode anwenden

Über die Aktion **Kontierungscode anwenden** in den Zeilen können alle Positionen gelöscht und anhand einer konfigurierten steuerlichen Kontierungseinrichtung automatisch neue Zeilen generiert werden. Diese Funktion steht über die Kontierungseinrichtungen zur Verfügung.

#### Viewer-Modi

Der SQUEEZE Viewer in der Belegvalidierung unterstützt drei Darstellungsmodi:

- **Belegübersicht**: Zeigt den gesamten Beleg im Viewer an.
- **Positionsfokus**: Fokussiert den Viewer auf den Positionsbereich des Belegs.
- **Abgedockt**: Öffnet den Viewer in einem separaten Browserfenster (siehe auch "Externer Viewer").

#### Feldalternativen

Wenn SQUEEZE bei der Beleglesung mehrere mögliche Werte für ein Feld erkennt (z. B. mehrere mögliche Kreditorennummern), werden diese als Feldalternativen bereitgestellt. Die Feldalternativen können über die Infobox eingesehen werden. Der Anwender kann so den passenden Wert auswählen.

# Lieferantenspezifisches Training

Das Training stellt eine wesentliche Optimierungs-Komponente der Verarbeitung dar.  
Sofern Daten nicht eindeutig durch das System erkannt werden, können lieferanten-spezifische Trainings angewendet werden, welche den Automatisierungsgrad bei der Erfassung der Rechnungen erhöhen.

Wenn der Trainingsmodus gestartet wird, können alle relevanten Felder für ein Training ausgewählt werden.  
Es können beliebig viele Trainings pro Lieferant und pro Rechnungsfeld angelegt werden.

Externe Rechnungsnummern lassen sich in der Regel nicht inhaltlich im System prüfen, da keine Daten zur Überprüfung bestehen. Dieses Feld ist z.B. ideal für Trainings.

In Business Central starten Sie das Training auf der Seite [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung) mit den Aktionen **Feldtraining öffnen** und **Positionstraining öffnen**. Trainiert wird im SQUEEZE Viewer auf der rechten Seite, gespeichert wird das Training in SQUEEZE – Business Central selbst speichert keine Trainings und übergibt nur, für welchen Kreditor Sie trainieren. Um die Wirkung gleich am aktuellen Beleg zu sehen, lassen Sie ihn anschließend mit **Ergebnis neu erstellen** neu auslesen.

## Feldtraining oder Positionstraining?

<table id="bkmrk-feldtrainingposition"><thead><tr><th></th><th>Feldtraining</th><th>Positionstraining</th></tr></thead><tbody><tr><td>**Aktion**</td><td>**Feldtraining öffnen**</td><td>**Positionstraining öffnen**</td></tr><tr><td>**Wofür**</td><td>Kopffelder – Werte, die einmal je Beleg vorkommen</td><td>Positionen – die Spalten der Positionstabelle</td></tr><tr><td>**Typische Felder**</td><td>Belegnr. (die Rechnungsnummer des Lieferanten), Belegdatum, Leistungsdatum, Bestellnr., Nettobetrag, Gesamtbetrag, IBAN, USt-ID</td><td>die Werte in den SQZ-Spalten der Zeilen, z. B. SQZ Art.-Nr., SQZ Beschreibung, SQZ Menge, SQZ Einzelpreis</td></tr><tr><td>**Im Viewer**</td><td>Anker und Wert markieren – siehe [Kopffeld Training](https://docs.squeeze.one/link/312#bkmrk-kopffeld-training)</td><td>eine Region über die ganze Spalte markieren – siehe [Positionsfeld Training](https://docs.squeeze.one/link/312#bkmrk-positionsfeld-traini)</td></tr></tbody></table>

Ob ein Kopffeld an der falschen Stelle gelesen wurde, sehen Sie am schnellsten über die drei Punkte (…) neben dem Feld: Der Viewer hebt die Stelle hervor, an der SQUEEZE den Wert gefunden hat. Bei Positionen vergleichen Sie die SQZ-Spalten der Zeilen mit dem Beleg im Viewer; **SQZ Beschreibung** und **SQZ Mengeneinheit** sind standardmäßig ausgeblendet, Sie blenden sie über **Personalisieren** ein. Welches SQUEEZE-Feld in welchem Feld des Squeeze Belegs landet, legt die [Feldzuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/feldzuordnung) fest.

<p class="callout info">Ein Training verbessert, was SQUEEZE vom Beleg liest. Ist der gelesene Wert richtig, setzt Business Central aber das falsche Konto, den falschen Artikel oder die falschen Dimensionen, hilft ein Training nicht. Dafür gibt es [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen), die [Kontierungseinrichtungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungseinrichtungen) und die [Regeln zur Zeilenkontierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen).</p>

## Voraussetzungen

- **Verbindung zu SQUEEZE:** In der [SQUEEZE Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-einrichtung) ist **Aktiviert** gesetzt und das Feld **Version (Squeeze Mandant)** gefüllt. Fehlt eines davon, sind die Aktionen ausgegraut.
- **PDF-Beleg:** Die Aktionen sind nur bei Belegen aktiv, die als PDF vorliegen. Bei anderen Dateiarten sind sie ausgegraut.
- **Richtiger Kreditor:** Im Feld **Eink. von Kred.-Nr.** steht der Kreditor, für den Sie trainieren wollen. Beim Öffnen des Trainings übergibt Business Central diese Nummer an den Viewer – es ist dieselbe Nummer, unter der Business Central den Kreditor als Stammdaten an SQUEEZE überträgt. Business Central prüft dabei nicht, ob das Feld gefüllt ist. Tragen Sie den Kreditor deshalb vor dem Öffnen ein bzw. korrigieren Sie ihn.
- **Viewer-Modus Belegübersicht oder Abgedockt:** Im Modus **Belegübersicht** öffnet sich das Training im Viewer, der in die Seite eingebettet ist, im Modus **Abgedockt** im externen Viewer – dieser muss dafür geöffnet sein. Im Viewer-Modus **Positionsfokus** sind die Aktionen ausgeblendet.
- **Berechtigungen:** Die Berechtigungssätze **DEXPRO SQUEEZE User** und **DEXPRO SQUEEZE Admin** enthalten die Seite mit den Trainingsaktionen (siehe [Berechtigungssätze](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/berechtigungssatze)). Eine eigene Berechtigung nur für das Training gibt es in Business Central nicht. Den Viewer lädt Business Central mit dem API-Schlüssel aus der SQUEEZE Einrichtung – oder mit einem belegbezogenen Token, wenn dort **Dokument-Token verwenden** eingeschaltet ist.

## Training starten und durchführen

1. Öffnen Sie den Beleg aus der Liste **Squeeze Belege** (siehe [SQUEEZE Beleg Übersicht](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-beleg-ubersicht)). Er öffnet sich auf der Seite **Squeeze Beleg**.
2. Prüfen Sie den Kreditor im Feld **Eink. von Kred.-Nr.** und korrigieren Sie ihn bei Bedarf.
3. Steht der **Viewer-Modus** nicht auf **Belegübersicht**, stellen Sie ihn um.
4. Wählen Sie in der Aktionsleiste unter **Vorgang** die Aktion **Feldtraining öffnen** (Kopffelder) oder **Positionstraining öffnen** (Positionen). Die Aktion heißt danach **Feldtraining schließen** bzw. **Positionstraining schließen**. Solange eines der beiden Trainings geöffnet ist, ist die Aktion für das andere ausgegraut.
5. Trainieren Sie im Viewer, wie unten unter [Kopffeld Training](https://docs.squeeze.one/link/312#bkmrk-kopffeld-training) bzw. [Positionsfeld Training](https://docs.squeeze.one/link/312#bkmrk-positionsfeld-traini) beschrieben.
6. Schließen Sie das Training mit **Feldtraining schließen** bzw. **Positionstraining schließen**. Blättern Sie zum nächsten oder vorherigen Beleg, schließt Business Central ein geöffnetes Training automatisch.
7. Entscheiden Sie, ob Sie den aktuellen Beleg von Hand korrigieren oder mit **Ergebnis neu erstellen** neu auslesen lassen – siehe **Training auf den aktuellen Beleg anwenden** unten.

[![Squeeze Beleg mit den Aktionen Feldtraining öffnen und Positionstraining öffnen](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/v5Bsqueeze-document.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/v5Bsqueeze-document.png)

Das Trainingsfenster wird innerhalb des Viewers am unteren Bildrand eingeblendet.

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

### Kopffeld Training

#### Trainieren eines Feldes

Nachdem die Trainingsfunktion gestartet wurde, ist das zu trainierende Feld auszuwählen.

[![image-1646210908178.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1646210908178.png)](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646210908178.png)  
Nachdem das entsprechende Feld ausgewählt wurde, ist der Anker zu definieren.  
Mit Anker ist in diesem Fall der Bezugsbegriff gemeint. In diesem Falle der auf der jeweiligen Rechnung angebrachte Begriff für die externe Belegnummer. Der Ankerbegriff ist mit der rechten Maustaste auf dem Dokument im Viewer zu markieren und wird dann gelb hinterlegt.

Anschließend ist das Feld „Wert“ im Aktionsbereich anzuklicken und dann der Wert, der gesucht werden soll. Dieser ist ebenfalls mit der rechten Maustaste zu markieren. Ist der gesuchte Wert kein zusammenhängender Wert, kann auch mit der rechten Maustaste ein beliebig großer Bereich markiert werden, um alle gewünschten Informationen auszulesen. Ist die Information angegeben, kann das Training über „Trainieren“ gespeichert werden.

Das System erzeugt einen „regulären Ausdruck“ – dieser kann von geschultem Fachpersonal oder IT-lern jederzeit noch optimiert werden. Z.B. können Leerzeichen ignoriert werden, da diese selten auch im ERP System / in der Buchung mit angegeben werden.

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

#### Testen und Prüfen der vorhandenen Trainings

Mit „Testen“ wird eine Übersicht aller bisherigen Kopffeld-Trainings angezeigt. Die Ergebnisse werden direkt mit ausgegeben. Durch einen Doppelklick auf einen Eintrag wird der Anker und der Wert in dem Viewer hervorgehoben.  
[![image-1646211311830.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1646211311830.png)](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646211311830.png)

#### Entfernen eines Trainings

Um ein Training wieder zu entfernen wird die [Übersicht](https://docs.squeeze.one/link/312#bkmrk-testen-und-pr%C3%BCfen-de) der vorhandenen Trainings geöffnet und der zu entfernende Eintrag markiert. Mit der Entfernen-Taste "Entf" wird der Eintrag gelöscht.

### Positionsfeld Training

#### Trainieren einer Spalte

Nachdem die Trainingsfunktion gestartet wurde, ist das zu trainierende Feld und die dazugehörige Spalte auszuwählen.

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

Nachdem dies ausgewählt wurde, ist die Region zu definieren.

Diese ist so zu wählen, dass Sie möglichst die gesamte Spalte eines Feldes abdeckt. Die Region ist mit der rechten Maustaste auf dem Dokument im Viewer zu markieren und wird dann gelb hinterlegt. Hierbei ist zu beachten, dass sich keine Regionen mit bereits [trainierten Regionen](https://docs.squeeze.one/link/312#bkmrk-testen-und-pr%C3%BCfen-de-0) überschneiden sollten.

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

Sind die Information angegeben, kann das Training über „Trainieren“ gespeichert werden.

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

#### Testen und Prüfen der vorhandenen Trainings

Mit „Testen“ wird eine Übersicht aller bisherigen Positionsfeld-Trainings angezeigt. Durch einen Doppelklick auf einen Eintrag wird der jeweils trainierte Bereich angezeigt.

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

#### Entfernen eines Trainings

Um ein Training wieder zu entfernen wird die [Übersicht](https://docs.squeeze.one/link/312#bkmrk-testen-und-pr%C3%BCfen-de-0) der vorhandenen Trainings geöffnet und der zu entfernende Eintrag markiert. Mit der Entfernen-Taste "Entf" wird der Eintrag gelöscht.

## Training auf den aktuellen Beleg anwenden

Ein Training ändert den Beleg, an dem Sie trainiert haben, nicht von selbst: Kopffelder und Zeilen in Business Central bleiben so, wie sie importiert wurden. Sie haben zwei Möglichkeiten:

- **Von Hand korrigieren** und wie gewohnt validieren. Das Training wirkt dann ab dem nächsten Beleg dieses Kreditors.
- **Ergebnis neu erstellen:** SQUEEZE liest den Beleg mit dem neuen Training noch einmal aus. So sehen Sie am selben Beleg, ob das Training greift.

### Ergebnis neu erstellen

1. Wählen Sie **Ergebnis neu erstellen** und bestätigen Sie die Frage *Möchten Sie das Ergebnis neu erstellen lassen?*
2. Business Central schickt den Beleg zurück in den Extraktionsschritt von SQUEEZE. In Business Central erhält der Beleg den Status **Gelöscht**; die Seite schließt sich und öffnet sich – falls vorhanden – mit den übrigen importierten Belegen neu.
3. Sobald SQUEEZE den Beleg fertig verarbeitet hat, holt Business Central das neue Ergebnis beim nächsten Herunterladen der Belege ab: automatisch über die Aufgabenwarteschlange (siehe [SQUEEZE Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-einrichtung)) oder sofort mit **Belege jetzt herunterladen** in der Liste **Squeeze Belege**. Bis dahin steht der Beleg in der Liste **Core Belege** im Status **Neu erstellen**.
4. Es entsteht ein **neuer** Squeeze Beleg mit einer neuen Nummer. Er wird wie ein neu importierter Beleg derselben Dokumentenklasse verarbeitet – z. B. mit Bestellabgleich, Autovervollständigen und Regeln zur Zeilenkontierung. Ist die automatische Validierung aktiviert, wird der Beleg validiert, sofern er alle Plausibilitätsprüfungen besteht.

<p class="callout warning">Korrekturen, die Sie auf dem bisherigen Beleg gemacht haben, werden nicht übernommen – der neue Beleg enthält nur das neue Ausleseergebnis. Wählen Sie **Ergebnis neu erstellen** deshalb direkt nach dem Training, bevor Sie den Beleg weiter bearbeiten.</p>

Bei Belegen im Status **Gelöscht** oder **Abgelehnt** ist die Aktion ausgegraut.

## Wirkung auf künftige Belege

Ein Training gilt für den Kreditor, für den Sie es geöffnet haben, und wird in SQUEEZE beim Auslesen der folgenden Belege dieses Kreditors angewendet. In Business Central ist dafür nichts weiter einzurichten. Welche Trainings es gibt, prüfen und entfernen Sie im Viewer (siehe [Testen und Prüfen der vorhandenen Trainings](https://docs.squeeze.one/link/312#bkmrk-testen-und-pr%C3%BCfen-de)) – Business Central zeigt keine Trainings an.

<p class="callout info">Nutzen Sie für den Kreditor [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen), beachten Sie: Autovervollständigen erkennt eine Position an den Werten **SQZ Art.-Nr.**, **SQZ Mengeneinheit**, **SQZ Beschreibung** und **SQZ Einzelpreis**. Liest SQUEEZE nach einem Positionstraining in diesen Spalten andere Werte als bisher, passen die gemerkten Einträge nicht mehr. Kontieren Sie die betroffenen Positionen einmal von Hand und validieren Sie den Beleg – danach merkt sich Autovervollständigen die Positionen mit den neuen Werten.</p>

## Beispiele

### Beispiel 1: Rechnungsnummer wird an der falschen Stelle gelesen

Ein Lieferant (Kreditor 20000) druckt im Rechnungskopf „Kunden-Nr. 10442“ und darunter „Rechnungs-Nr. RE-24-0815“. SQUEEZE liest 10442 als Rechnungsnummer, im Feld **Belegnr.** steht also 10442. Weil die Kundennummer auf jeder Rechnung dieses Lieferanten gleich ist, bekäme jede weitere Rechnung dieselbe Belegnr. – und die [Doublettenprüfung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung#bkmrk-doublettenpr%C3%BCfung), die Belegnr. und Kreditor vergleicht, würde sie als Duplikat erkennen.

1. Klicken Sie auf die drei Punkte neben **Belegnr.** – der Viewer hebt 10442 neben „Kunden-Nr.“ hervor.
2. Prüfen Sie, dass im Feld **Eink. von Kred.-Nr.** 20000 steht, und wählen Sie **Feldtraining öffnen**.
3. Wählen Sie im Trainingsfenster das Feld für die Rechnungsnummer. Markieren Sie mit der rechten Maustaste den Anker „Rechnungs-Nr.“, klicken Sie auf „Wert“, markieren Sie „RE-24-0815“ und speichern Sie mit „Trainieren“.
4. Kontrollieren Sie mit „Testen“, ob das Training RE-24-0815 liefert, und schließen Sie es mit **Feldtraining schließen**.
5. Wählen Sie **Ergebnis neu erstellen**. Nach dem nächsten Herunterladen steht auf dem neuen Beleg im Feld **Belegnr.** RE-24-0815 – ebenso auf den folgenden Rechnungen von Kreditor 20000.

### Beispiel 2: Artikelnummern der Positionen fehlen

Auf den Rechnungen eines Großhändlers (Kreditor 30000) steht die Artikelnummer in einer eigenen Spalte „Art.-Nr.“ links neben der Bezeichnung. In den Zeilen der Seite Squeeze Beleg bleibt **SQZ Art.-Nr.** trotzdem leer.

1. Wählen Sie **Positionstraining öffnen**.
2. Wählen Sie das Feld für die Artikelnummer und die zugehörige Spalte. Markieren Sie mit der rechten Maustaste eine Region über die ganze Spalte „Art.-Nr.“ – ohne Überschneidung mit bereits trainierten Regionen – und speichern Sie mit „Trainieren“.
3. Schließen Sie das Training mit **Positionstraining schließen** und wählen Sie **Ergebnis neu erstellen**.
4. Auf dem neuen Beleg ist **SQZ Art.-Nr.** in den Zeilen gefüllt. Haben Sie für diesen Kreditor bisher Autovervollständigen genutzt, kontieren Sie die Positionen einmal von Hand und validieren Sie: Die bisherigen Einträge wurden mit leerer Artikelnummer gemerkt und passen nicht mehr.

## Einschränkungen

- Das Training starten Sie nur auf der Seite **Squeeze Beleg**. Im [Viewer im Ziel-Beleg](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/viewer-im-ziel-beleg) gibt es keine Trainingsaktionen.
- Training ist nur bei PDF-Belegen möglich.
- Im Viewer-Modus **Positionsfokus** sind die Aktionen ausgeblendet. [Auftragsbestätigungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/auftragsbestatigungen) öffnen in der Regel in diesem Modus – stellen Sie den Viewer-Modus zum Trainieren auf **Belegübersicht**.
- Feld- und Positionstraining lassen sich nicht gleichzeitig öffnen.
- Ein Training gilt nur für den Kreditor, für den es angelegt wurde.
- Auf den aktuellen Beleg wirkt ein Training nur über **Ergebnis neu erstellen** – und dabei gehen Ihre Korrekturen auf diesem Beleg verloren.
- Business Central zeigt keine Trainings an; Prüfen und Entfernen geht nur im Viewer.

## Fehlerbehebung

#### Die Aktionen „Feldtraining öffnen“ und „Positionstraining öffnen“ fehlen

Der Viewer-Modus steht auf **Positionsfokus**. Stellen Sie ihn auf **Belegübersicht**.

#### Die Aktionen sind ausgegraut

1. Ist das jeweils andere Training noch geöffnet? Schließen Sie es zuerst.
2. Liegt der Beleg als PDF vor? Bei anderen Dateiarten ist kein Training möglich.
3. Steht die Verbindung zu SQUEEZE? In der SQUEEZE Einrichtung müssen **Aktiviert** gesetzt und **Version (Squeeze Mandant)** gefüllt sein.

#### Im Viewer erscheint kein Trainingsfenster

Prüfen Sie den Viewer-Modus. Im Modus **Abgedockt** erscheint das Trainingsfenster im externen Viewer – öffnen Sie ihn, falls er geschlossen ist, und wählen Sie die Aktion dann erneut. Im Modus **Positionsfokus** sind die Trainingsaktionen ausgeblendet; stellen Sie den Viewer-Modus auf **Belegübersicht**.

Ist in der [Benutzerspezifischen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerspezifische-einrichtung) **Nur externen Viewer verwenden** gesetzt, öffnet die Seite den Viewer abgedockt. Das Training öffnet sich dann im externen Viewer.

#### „Ergebnis neu erstellen“ ist ausgegraut

Der Beleg hat den Status **Gelöscht** oder **Abgelehnt**, oder die Verbindung zu SQUEEZE fehlt (siehe oben).

#### Nach „Ergebnis neu erstellen“ kommt der Beleg nicht zurück

1. Werden Belege heruntergeladen? Wählen Sie in der Liste **Squeeze Belege** die Aktion **Belege jetzt herunterladen** oder prüfen Sie den Aufgabenwarteschlangenposten.
2. Hat SQUEEZE den Beleg fertig verarbeitet? Business Central übernimmt das neue Ergebnis erst, wenn der Beleg in SQUEEZE den Schritt Export, Backup oder Delete erreicht hat. Bis dahin bleibt er in der Liste **Core Belege** im Status **Neu erstellen**. Siehe auch [Belege werden nicht aus Squeeze abgeholt und verbleiben dort im Export Schritt](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/belege-werden-nicht-aus-squeeze-abgeholt-und-verbleiben-dort-im-export-schritt).

#### Meldung „Der Beleg … konnte nicht von SQUEEZE abgerufen werden …“

SQUEEZE kennt den Beleg nicht mehr oder ist nicht erreichbar, deshalb kann **Ergebnis neu erstellen** ihn nicht erneut auslesen lassen. Am Beleg wurde nichts geändert. Prüfen Sie die Verbindung in der SQUEEZE Einrichtung und ob der Beleg in SQUEEZE noch vorhanden ist; sonst bearbeiten Sie den Beleg von Hand.

#### Der neue Beleg enthält immer noch den falschen Wert

1. Wurde das Training mit „Trainieren“ gespeichert? Prüfen Sie es im Viewer mit „Testen“.
2. Stand beim Öffnen des Trainings der richtige Kreditor in **Eink. von Kred.-Nr.**? Business Central übergibt die Nummer, die beim Öffnen eingetragen ist. Haben Sie den Kreditor erst danach geändert, schließen Sie das Training und öffnen Sie es neu.
3. Wurde auf dem neuen Beleg derselbe Kreditor erkannt? Ein Training gilt nur für den Kreditor, für den es angelegt wurde.
4. Bei Positionstraining: Überschneidet sich die Region mit einer bereits trainierten Region?

## Verwandte Themen

- [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung)
- [Externer Viewer](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/externer-viewer)
- [Benutzerspezifische Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerspezifische-einrichtung)
- [SQUEEZE Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-einrichtung)
- [Feldzuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/feldzuordnung)
- [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen)
- [Auftragsbestätigungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/auftragsbestatigungen)

# Dokument Aufteilen

Die Trennfunktion ist hauptsächlich für E-Mail-Rechnungen gedacht. Wenn Lieferanten sich nicht an die Vorgabe der E-Mail-Rechnungs-Zustellung halten (pro PDF Datei eine Rechnung). Es ist aber auch möglich die Seiten eines PDF neu zu sortieren.

Sie starten die Aufteilung auf der Seite [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung) mit der Aktion **Dokument aufteilen**. Aus den Seiten, die Sie im Aufteilungsdialog zusammenstellen, erzeugt SQUEEZE neue Belege, die Business Central wie jeden anderen Beleg abholt. Sobald jede Seite des Originals einem neuen Beleg zugeordnet ist, erhält das Original den Status **Gelöscht**.

## Voraussetzungen

- **Aufteilung erlaubt:** In der [Dokumentenklassen-Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) ist im FastTab **Squeeze** der Schalter **Dokumententeilung deaktivieren** für die Dokumentenklasse des Belegs ausgeschaltet. Das ist die Vorgabe. Eine abweichende Einstellung je Kreditor gibt es nicht.
- **PDF-Beleg:** Der Beleg liegt als PDF vor. Bei Belegen in einem anderen Dateiformat ist die Aktion ausgegraut.
- **Beleg offen:** Der Beleg hat weder den Status **Abgelehnt** noch **Gelöscht**. Zurückgestellte Belege können Sie aufteilen.
- **SQUEEZE verbunden:** In der [Squeeze Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-einrichtung) ist **Aktiviert** eingeschaltet und die Verbindung zu Ihrem SQUEEZE-Mandanten hergestellt – das Feld **Version (Squeeze Mandant)** ist gefüllt. Der Aufteilungsdialog ist eine Seite Ihres SQUEEZE-Systems; Business Central öffnet sie mit derselben Verbindung wie den Viewer.
- **Berechtigungen:** Die Berechtigungssätze **DEXPRO SQUEEZE Benutzer** (DXP SQUEEZE User) und **DEXPRO SQUEEZE Administrator** (DXP SQUEEZE Admin) enthalten alles, was zum Aufteilen nötig ist. Siehe [Berechtigungssätze](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/berechtigungssatze).

## Aufteilung starten

1. Öffnen Sie in der Liste **Squeeze Belege** den Beleg, der mehrere Rechnungen enthält. Tragen Sie noch nichts ein – Eingaben am Original werden nicht auf die neuen Belege übertragen (siehe unten).
2. Wählen Sie auf der Validierungsseite die Aktion **Dokument aufteilen**.
3. Das Fenster **Squeeze Viewer** öffnet sich mit dem Aufteilungsdialog von SQUEEZE. Ab jetzt gilt die Aufteilung als begonnen.

[![Squeeze Beleg mit der Aktion Dokument aufteilen](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/Oiisqueeze-document.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/Oiisqueeze-document.png)

## Im Aufteilungsdialog

In dem neuen Fenster wird ein Dialog gestartet, um die Belege voneinander zu trennen und so aus einem Beleg mehrere zu machen.

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

Auf der linken Seite werden alle Seiten des original PDFs aufgelistet. In der Mitte ist der Bereich für die Neuerstellung und Rechts sieht man die aktuell ausgewählte Seite.

Um einen Beleg aufzuteilen werden die zu einer Rechnung dazugehörigen Seiten einzeln entweder per Maus mit Drag&amp;Drop oder per Pfeil-Taste der Tastatur in den mittleren Bereich übertragen. Dort kann man auch die Reihenfolge der Seiten korrigieren.

Ist das Rechnungsdokument korrekt separiert, kann die Erzeugung eines neuen Einzelbelegs mit „Dokument erzeugen“ gestartet werden. Der neue Beleg wird direkt von SQUEEZE ausgelesen, verarbeitet und sobald er bereit steht auch in der Übersichtsliste bereitgestellt. Dieser Vorgang wird solange wiederholt bis der original Beleg komplett aufgeteilt worden ist.

## Aufteilung abschließen

Haben Sie alle Belege erzeugt, schließen Sie das Fenster. Business Central fragt dann bei SQUEEZE ab, welche Seiten des Originals bereits einem neuen Beleg zugeordnet sind, und reagiert so:

<table id="bkmrk-stand-der-aufteilung"><thead><tr><th>Stand der Aufteilung</th><th>Was passiert</th></tr></thead><tbody><tr><td>Keine Seite zugeordnet</td><td>Die Aufteilung wird verworfen. Der Beleg bleibt, wie er ist, und lässt sich normal bearbeiten und validieren; die Aktion **Dokument aufteilen** steht wieder zur Verfügung.</td></tr><tr><td>Ein Teil der Seiten zugeordnet</td><td>Die Aufteilung bleibt offen. Die Validierungsseite wird neu geöffnet, die Meldung *Der Beleg ist noch nicht komplett aufgeteilt, bitte teilen Sie diesen komplett auf.* erscheint, und das Fenster **Squeeze Viewer** öffnet sich erneut.</td></tr><tr><td>Alle Seiten zugeordnet</td><td>Das Original erhält den Status **Gelöscht**. Die Validierungsseite wird geschlossen und – falls noch Belege im Status **Importiert** vorhanden sind – mit dem nächsten Beleg wieder geöffnet.</td></tr></tbody></table>

Solange die Aufteilung offen ist, zeigt die Validierungsseite statt **Dokument aufteilen** die Aktion **Dokumentenaufteilung abschließen**. Sie öffnet das Fenster **Squeeze Viewer** erneut; beim Schließen prüft Business Central wieder wie oben beschrieben.

Öffnen Sie einen Beleg, dessen Aufteilung noch offen ist, erscheint ebenfalls die Meldung *Der Beleg ist noch nicht komplett aufgeteilt, bitte teilen Sie diesen komplett auf.*, und das Fenster öffnet sich von selbst. Das gilt, wenn der Viewer in die Seite eingebettet ist (**Viewer-Modus** **Belegübersicht** oder **Positionsfokus**). Im Viewer-Modus **Abgedockt** setzen Sie die Aufteilung mit **Dokumentenaufteilung abschließen** fort.

<p class="callout warning">Ein Beleg mit offener Aufteilung kann nicht validiert werden. In der Infobox **Plausibilitätseinträge** steht *Der Beleg ist nicht vollständig aufgeteilt. Bitte schließen Sie die Dokumentenaufteilung ab.*, und **Validieren** bricht mit der Meldung *Der Beleg ist nicht gültig - bitte prüfen Sie die Plausibilitätseinträge in der Factbox rechts, lösen Sie die Probleme und versuchen Sie es erneut.* ab.</p>

## Was mit dem Original passiert

- **Status Gelöscht:** Sobald alle Seiten zugeordnet sind, erhält das Original den Status **Gelöscht**. Im Feld **Bemerkung** steht dann zum Beispiel *Gelöscht von Benutzer MMUSTER - Grund: Dokumentenaufteilung abgeschlossen*.
- **Nicht mehr in der Liste:** Die Liste **Squeeze Belege** blendet gelöschte Belege standardmäßig aus. Sie finden das Original in der Ansicht **Gelöscht**, die auch die Spalte **Bemerkung** zeigt.
- **Nur noch lesbar:** Die Felder des Originals sind gesperrt, die meisten Aktionen ausgegraut. Ist der Viewer eingebettet, erscheint beim Öffnen die Meldung *Der Beleg ist komplett aufgeteilt und wird gelöscht.*
- **Endgültig entfernt:** Die automatische Bereinigung (Hintergrundjob der Squeeze Einrichtung) löscht Belege im Status **Gelöscht** endgültig, sobald ihr Importdatum so weit zurückliegt, wie das **Bereinigungsintervall (Datumsformel)** in der Squeeze Einrichtung vorgibt – in der Vorgabe **-1M**, also einen Monat. Maßgeblich ist der Tag des Imports, nicht der Tag der Aufteilung.
- **Eingaben gehen nicht über:** Was Sie am Original eingetragen oder korrigiert haben – etwa Kreditor, Buchungsdatum, Zeilen oder Dimensionen –, wird nicht auf die neuen Belege übertragen.

<p class="callout info">Teilen Sie einen Beleg deshalb auf, bevor Sie ihn bearbeiten.</p>

## Die neuen Belege

- SQUEEZE liest jeden neuen Beleg selbst aus. Business Central holt ihn mit der nächsten Belegabholung ab – über den Hintergrundjob oder sofort mit der Aktion **Belege jetzt herunterladen** in der Liste **Squeeze Belege**.
- Jeder neue Beleg erscheint in der Liste **Squeeze Belege** im Status **Importiert** mit seinem eigenen Leseergebnis. Er durchläuft dieselbe Verarbeitung wie jeder andere neu abgeholte Beleg – einschließlich der automatischen Validierung, falls sie eingeschaltet ist.
- Ob SQUEEZE einen neuen Beleg noch verarbeitet, sehen Sie über die Aktion **Warteschlange** in der Liste **Squeeze Belege** (siehe [SQUEEZE Warteschlange](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-warteschlange)).

## Beispiele

### Beispiel 1: Drei Rechnungen in einer PDF

Ein Lieferant schickt eine PDF mit fünf Seiten, in der drei Rechnungen stecken:

<table id="bkmrk-seiteninhalt-1%E2%80%932rech"><thead><tr><th>Seiten</th><th>Inhalt</th></tr></thead><tbody><tr><td>1–2</td><td>Rechnung RE-1001</td></tr><tr><td>3</td><td>Rechnung RE-1002</td></tr><tr><td>4–5</td><td>Rechnung RE-1003</td></tr></tbody></table>

1. Sie öffnen den Beleg und wählen **Dokument aufteilen**, bevor Sie etwas eintragen.
2. Im Fenster **Squeeze Viewer** übertragen Sie die Seiten 1 und 2 in den mittleren Bereich und starten „Dokument erzeugen“.
3. Dasselbe wiederholen Sie mit Seite 3 und danach mit den Seiten 4 und 5.
4. Sie schließen das Fenster. Alle fünf Seiten sind zugeordnet: Das Original erhält den Status **Gelöscht** und verschwindet aus der Liste.
5. Nach der nächsten Belegabholung stehen drei neue Belege in der Liste **Squeeze Belege** – einer je Rechnung. Sie bearbeiten und validieren sie wie gewohnt.

### Beispiel 2: Aufteilung unterbrochen

Wie in Beispiel 1, aber Sie schließen das Fenster schon nach RE-1001 und RE-1002. Die Seiten 4 und 5 sind noch keinem Beleg zugeordnet. Deshalb erscheint *Der Beleg ist noch nicht komplett aufgeteilt, bitte teilen Sie diesen komplett auf.*, und das Fenster öffnet sich wieder. Sie erzeugen RE-1003 und schließen das Fenster – jetzt ist die Aufteilung abgeschlossen.

### Beispiel 3: Seiten neu sortieren

Eine dreiseitige Rechnung wurde mit der letzten Seite zuerst eingescannt. Sie übertragen alle drei Seiten in der richtigen Reihenfolge in den mittleren Bereich und erzeugen einen einzigen neuen Beleg. Weil damit alle Seiten zugeordnet sind, erhält das Original den Status **Gelöscht**, und Sie arbeiten mit dem neuen Beleg weiter.

### Beispiel 4: Versehentlich gestartet

Sie haben **Dokument aufteilen** gewählt, obwohl der Beleg nur eine Rechnung enthält. Schließen Sie das Fenster, ohne einen Beleg zu erzeugen: Es ist keine Seite zugeordnet, der Beleg bleibt unverändert und lässt sich normal validieren. Zeigt die Validierungsseite danach trotzdem **Dokumentenaufteilung abschließen**, wählen Sie die Aktion und schließen Sie das Fenster noch einmal.

## Einschränkungen

- Aufgeteilt wird nach ganzen Seiten. Stehen zwei Rechnungen auf derselben Seite, lassen sie sich nicht trennen.
- Die Aufteilung ist erst abgeschlossen, wenn jede Seite des Originals einem neuen Beleg zugeordnet ist. Beiblätter wie AGB oder ein Anschreiben ordnen Sie deshalb einer der Rechnungen zu.
- Ein Beleg wird ganz oder gar nicht aufgeteilt: Solange die Aufteilung offen ist, lässt sich das Original nicht validieren.
- Eingaben am Original werden nicht auf die neuen Belege übertragen.
- Nur Belege im PDF-Format lassen sich aufteilen.
- Abschalten lässt sich die Aufteilung nur je Dokumentenklasse, nicht je Kreditor.

## Fehlerbehebung

#### Die Aktion „Dokument aufteilen“ ist ausgegraut

1. Ist in der Dokumentenklassen-Einrichtung für diese Dokumentenklasse **Dokumententeilung deaktivieren** eingeschaltet?
2. Liegt der Beleg in einem anderen Format als PDF vor?
3. Hat der Beleg den Status **Abgelehnt** oder **Gelöscht**? Eine Ablehnung nehmen Sie mit **Ablehnung zurücknehmen** zurück.
4. Ist in der Squeeze Einrichtung **Aktiviert** eingeschaltet und **Version (Squeeze Mandant)** gefüllt? Fehlt die Verbindung, sind auch die übrigen SQUEEZE-Aktionen ausgegraut.

#### Statt „Dokument aufteilen“ wird „Dokumentenaufteilung abschließen“ angezeigt

Für diesen Beleg wurde eine Aufteilung begonnen und nicht abgeschlossen. Wählen Sie **Dokumentenaufteilung abschließen**, ordnen Sie die restlichen Seiten zu und schließen Sie das Fenster. Haben Sie noch keinen neuen Beleg erzeugt, schließen Sie das Fenster einfach wieder – dann wird die Aufteilung verworfen.

#### „Validieren“ meldet „Der Beleg ist nicht gültig …“

Steht in den Plausibilitätseinträgen *Der Beleg ist nicht vollständig aufgeteilt. Bitte schließen Sie die Dokumentenaufteilung ab.*, ist die Aufteilung noch offen. Gehen Sie vor wie im vorigen Punkt.

#### Beim Öffnen erscheint „Der Beleg ist noch nicht komplett aufgeteilt, …“ und der Squeeze Viewer öffnet sich

Einige Seiten des Originals sind noch keinem neuen Beleg zugeordnet. Ordnen Sie sie zu und schließen Sie das Fenster. Solange Seiten übrig sind, öffnet sich das Fenster nach dem Schließen erneut.

#### Beim Öffnen erscheint „Der Beleg ist komplett aufgeteilt und wird gelöscht.“

Sie haben das Original einer abgeschlossenen Aufteilung geöffnet, zum Beispiel aus der Ansicht **Gelöscht**. Hier ist nichts mehr zu tun; arbeiten Sie mit den neuen Belegen.

#### Die neuen Belege erscheinen nicht

1. Wählen Sie in der Liste **Squeeze Belege** die Aktion **Belege jetzt herunterladen**.
2. Prüfen Sie über die Aktion **Warteschlange**, ob SQUEEZE die neuen Belege noch verarbeitet.

#### Das Original ist aus der Liste verschwunden

Nach einer abgeschlossenen Aufteilung hat das Original den Status **Gelöscht**. Wechseln Sie in der Liste **Squeeze Belege** zur Ansicht **Gelöscht**; die Spalte **Bemerkung** zeigt, wer den Beleg aufgeteilt hat.

## Verwandte Themen

- [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung)
- [SQUEEZE Beleg Übersicht](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-beleg-ubersicht)
- [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung)
- [SQUEEZE Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-einrichtung)
- [SQUEEZE Warteschlange](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-warteschlange)
- [Plausibilitätsprüfungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/plausibilitatsprufungen)
- [Externer Viewer](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/externer-viewer)

# Bestell- & Wareneingangsabgleich

Der Bestell- &amp; Wareneingangsabgleich prüft die ausgelesenen Belegpositionen und vergleicht diese mit allen Bestell- &amp; Wareneingangszeilen anhand der ausgelesenen Bestellnummern des Belegs.

Der Bestellabgleich lässt sich auf der Seite SQUEEZE Belegvalidierung über die Aktion **Bestellabgleich** jederzeit öffnen, außer bei gelöschten oder abgelehnten Belegen. Abgeglichen wird gegen die Bestellnummer, die SQUEEZE vom Beleg ausgelesen hat oder die im Kopffeld **Bestellnr.** eingetragen ist. Hat der Beleg keine Bestellnummer, bleibt die Liste leer, bis Sie oben im Feld **Bestellnr.** eine Bestellung auswählen.

Dieser Vergleich wird nach der Abholung des Belegs aus SQUEEZE automatisch durchgeführt. Der Anwender hat die Möglichkeit diesen Vergleich auch manuell durchzuführen oder zu korrigieren.

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

## Voraussetzungen

- **Dokumentenklasse:** Gegen Bestellungen und Lieferungen abgeglichen werden Belege der Dokumentenklasse **Rechnung / Gutschrift**. Belege der Dokumentenklasse **Auftragsbestätigung** werden nur gegen Bestellungen abgeglichen (siehe [Auftragsbestätigungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/auftragsbestatigungen)).
- **Kreditor:** Der Beleg hat einen Kreditor, und es ist derselbe wie der **Eink. von Kred.-Nr.** der Bestellung. Bestellungen und Lieferungen anderer Kreditoren zeigt der Bestellabgleich nicht an.
- **Bestellnummer:** Für den automatischen Abgleich beim Import muss SQUEEZE mindestens eine Bestellnummer erkannt haben – im Belegkopf, als weitere Bestellnummer oder in einer Position (**SQZ Bestellnr.**). Ob das der Fall ist, zeigt im Belegkopf das Feld **Bestellnummer gefunden**. Im Bestellabgleich selbst können Sie jede Bestellung des Kreditors auswählen.
- **Offene Zeilen:** Die Bestellung hat Zeilen, die noch nicht vollständig berechnet sind. Für den Abgleich gegen Lieferungen muss zur Bestellung eine gebuchte Einkaufslieferung mit **Lief. nicht fakt. Menge** vorhanden sein.
- **Einrichtung:** **Automatischer Bestellabgleich** ist gefüllt (siehe *Einrichtung*). Für Zuweisungen an Bestellzeilen muss außerdem **Bestellungszuweisung zulassen** eingeschaltet sein.
- **Abweichende Mengeneinheiten:** Damit z. B. 24 STK einer Bestellzeile über 1 PALETTE zugeordnet werden, müssen beide Einheiten beim Artikel unter **Maßeinheiten Artikel** mit ihrer **Menge pro Einheit** eingerichtet sein.
- **Berechtigungen:** Die Berechtigungssätze **DEXPRO SQUEEZE User** und **DEXPRO SQUEEZE Admin** enthalten den Bestellabgleich (siehe [Berechtigungssätze](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/berechtigungssatze)). Bestellungen und gebuchte Einkaufslieferungen liest der Bestellabgleich mit den Rechten des Benutzers; er braucht dafür in Business Central Leserechte auf Einkaufsbestellungen und gebuchte Einkaufslieferungen.

## Einrichtung

Die Einstellungen stehen im FastTab **Bestellabgleich** der [Dokumentenklassen-Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) (Standard für alle Kreditoren) und der [Kreditorenbezogenen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung) (Abweichung für einzelne Kreditoren). Gibt es für den Kreditor eine Kreditorenbezogene Einrichtung, gelten für den Bestellabgleich deren Werte; nur **Bestellungszuweisung zulassen** kommt immer aus der Dokumentenklassen-Einrichtung. Eine neue Kreditorenbezogene Einrichtung übernimmt beim Anlegen die Werte der Dokumentenklasse.

[![Dokumentenklassen-Einrichtung, FastTab Squeeze mit dem Bereich Bestellabgleich](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/egVdoc-class-setup-squeeze.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/egVdoc-class-setup-squeeze.png)

<table id="bkmrk-feldwirkung-automati"><thead><tr><th>Feld</th><th>Wirkung</th></tr></thead><tbody><tr><td>**Automatischer Bestellabgleich**</td><td>Wogegen beim Import automatisch abgeglichen wird: **Lieferung** (Zeilen gebuchter Einkaufslieferungen) oder **Bestellung** (Bestellzeilen). Leer = kein automatischer Abgleich. Vorgabe: **Lieferung** bei Rechnung / Gutschrift, **Bestellung** bei Auftragsbestätigung.</td></tr><tr><td>**Betragstoleranz %**, **Max. Betragstoleranz**</td><td>Zulässige Abweichung des Zeilenbetrags in Prozent bzw. als Betrag (siehe *Toleranzen*).</td></tr><tr><td>**Betragstoleranz ignorieren**</td><td>Der Betrag wird bei der abschließenden Prüfung nicht geprüft.</td></tr><tr><td>**Mengentoleranz %**, **Max. Mengentoleranz**</td><td>Zulässige Abweichung der Menge in Prozent bzw. absolut.</td></tr><tr><td>**Mengentoleranz ignorieren**</td><td>Die Menge wird bei der abschließenden Prüfung nicht geprüft (zur Suche siehe den Hinweis unter *Toleranzen*).</td></tr><tr><td>**Beschreibung Ähnlichkeit %**</td><td>Mindestähnlichkeit der Beschreibungen für Suchschritt 4. Leer bzw. 0 bedeutet 70 %. Das Feld ist ausgeblendet; Sie blenden es über **Personalisieren** ein.</td></tr><tr><td>**Daten ersetzen**</td><td>Nur bei Rechnung / Gutschrift: Beim Anwenden wird der EK-Preis der Belegzeile durch den der Bestellzeile ersetzt – bei Zuweisung zu einer Lieferzeile durch den der Lieferzeile. Ist der Schalter aus, bleibt der EK-Preis aus SQUEEZE stehen, außer er ist 0. Beschreibung, Menge und Rabatt % werden unabhängig davon übernommen (siehe *4. Anwenden*). Vorgabe: eingeschaltet.</td></tr><tr><td>**Bestellungszuweisung zulassen**</td><td>Nur in der Dokumentenklassen-Einrichtung, angezeigt bei Rechnung / Gutschrift: erlaubt Zuweisungen an Bestellzeilen. Vorgabe: ausgeschaltet bei Rechnung / Gutschrift, eingeschaltet bei Auftragsbestätigung.</td></tr><tr><td>**Toleranz Wareneingangsdatum**, **Sendungslaufzeit**</td><td>Nur bei Auftragsbestätigungen (Sendungslaufzeit nur in der Kreditorenbezogenen Einrichtung), siehe [Auftragsbestätigungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/auftragsbestatigungen).</td></tr></tbody></table>

<p class="callout info">**Automatischer Bestellabgleich** lässt sich in der Dokumentenklassen-Einrichtung nur auf **Bestellung** stellen, wenn **Bestellungszuweisung zulassen** eingeschaltet ist. In der Kreditorenbezogenen Einrichtung wird das nicht geprüft – stellen Sie dort **Bestellung** nur ein, wenn die Dokumentenklasse Bestellungszuweisungen zulässt.</p>

## Menü

### Zuweisen

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

Zugewiesene Zeilen werden durch einen grünen Haken dargestellt [![image-1646147695338.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1646147695338.png).](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646147695338.png)

#### Zuweisen

Hiermit wird die ausgewählte Bestell-/Lieferzeile der ausgewählten SQUEEZE Belegzeile zugewiesen.

Beim manuellen Zuweisen werden keine Toleranzen geprüft. Hat die Belegzeile schon eine Zuweisung, wird sie ersetzt. Bestellzeilen (Belegart **Bestellung**) lassen sich nur zuweisen, wenn in der Dokumentenklassen-Einrichtung **Bestellungszuweisung zulassen** eingeschaltet ist.

#### Automatisch zuweisen

Hiermit wird allen SQUEEZE Belegzeilen die passende Bestell-/Lieferzeile zugewiesen. Hierfür muss im oberen Bereich die Bestellung/Lieferung selbst ausgewählt werden.

Sie können im oberen Bereich auch mehrere Bestellungen/Lieferungen oder einzelne Zeilen markieren; bei einer Bestellung/Lieferung werden alle ihre Zeilen verarbeitet. Gesucht wird nur unter Belegzeilen ohne Zuweisung, nach denselben Regeln wie beim Import (siehe „So funktioniert der automatische Abgleich“). Berücksichtigt wird nur die Bestellung, die oben im Feld **Bestellnr.** steht. Die gefundenen Zuweisungen werden noch nicht angewendet – dafür gibt es die Aktionen unter **Anwenden**.

### Zuweisung entfernen

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

Nicht zugewiesene Zeilen werden durch ein rotes Ausrufezeichen dargestellt [![image-1646147781116.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1646147781116.png)](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646147781116.png).

#### Ausgewählte Zuweisung entfernen

Hiermit wird die Zuweisung der ausgewählten Zeile entfernt.

#### Alle Zuweisungen entfernen

Hiermit werden alle Zuweisungen entfernt.

<p class="callout warning">Das Entfernen einer Zuweisung macht ein bereits erfolgtes Anwenden nicht rückgängig: Art, Nr., Menge, Beschreibung und die übrigen übernommenen Werte bleiben in der Belegzeile stehen.</p>

### Anwenden

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

#### Ausgewählte Zeile anwenden

Hiermit wird die Zuweisung der ausgewählten Zeile angewendet. Die Belegzeile übernimmt dabei die Daten der zugewiesenen Bestell-/Lieferzeile, vorhandene Werte werden überschrieben – welche, steht unten im Abschnitt „4. Anwenden“. Diese Änderung wird hierdurch auch umgehend an die Validierungszeile übertragen.

#### Zugewiesene Zeilen anwenden

Hiermit wird die Zuweisung aller zugewiesenen Zeilen angewendet. Die Belegzeilen übernehmen dabei die Daten der zugewiesenen Bestell-/Lieferzeilen, vorhandene Werte werden überschrieben. Diese Änderungen werden hierdurch auch umgehend an die Validierungszeilen übertragen.

<p class="callout warning">**Zugewiesene Zeilen anwenden** wendet alle Zuweisungen des Belegs erneut an – auch solche, die schon angewendet wurden. Korrekturen, die Sie danach an diesen Belegzeilen gemacht haben (z. B. an der Menge), werden dabei überschrieben.</p>

## Bereiche

### Bestellnummer

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

Hier wird die derzeit zu vergleichende Bestellnummer angezeigt. Sollten mehrere Bestellnummern ausgelesen worden sein, so kann über die drei Punkte die entsprechende Liste geöffnet werden.

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

Vorbelegt ist die Bestellnummer aus dem Belegkopf; steht dort keine, die erste weitere Bestellnummer, die SQUEEZE ausgelesen hat. Die Liste hinter den drei Punkten enthält die Bestellnummer aus dem Belegkopf, alle weiteren ausgelesenen Bestellnummern, die Bestellnummern aus den Positionen (**SQZ Bestellnr.**) und alle freigegebenen Bestellungen des Kreditors; zu jeder Nummer steht, woher sie stammt.

Gehört die Nummer nicht zu einer Bestellung des Kreditors auf dem Beleg, erscheint daneben in Rot z. B. **Bestellnr. 106099 passt nicht zum Eink. von Kred.-Nr. 20000.** Die Liste darunter bleibt dann leer.

### Bestell- &amp; Lieferungen

In diesem Bereich werden die Bestellung und ihre noch nicht vollständig berechneten Zeilen aufgelistet, bei Rechnungen und Gutschriften außerdem die dazugehörigen Lieferungen mit ihren noch nicht berechneten Zeilen.

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

Nicht angezeigt werden Zeilen ohne Art (z. B. Textzeilen), vollständig berechnete Bestellzeilen und Lieferzeilen ohne offene Menge. Die Spalte **Menge** zeigt die offene Menge: bei Bestellzeilen die noch nicht berechnete Menge (Menge minus **Bereits berech. Menge**), bei Lieferzeilen die **Lief. nicht fakt. Menge**, bei Auftragsbestätigungen die **Restbestellungsmenge**. **Menge (Basis)** zeigt dieselbe Menge in der Basiseinheit. Die Spalte **Zugewiesen** zeigt, ob eine Belegzeile dieses Belegs der Zeile zugewiesen ist.

### SQUEEZE Belegzeilen

In diesem Bereich werden alle ausgelesenen Positionen des SQUEEZE Belegs aufgelistet.

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

Die Spalte **Zugewiesen** zeigt, ob die Belegzeile eine Zuweisung hat; die Spalten **Zugewiesene Belegart**, **Zugewiesene Belegnr.**, **Zugewiesene Belegzeilennr.**, **Zugewiesene Menge**, **Zugewiesener Einzelpreis**, **Zugewiesener Zeilenbetrag** und **Zugewiesener Zeilenrabatt %** zeigen, wem sie zugewiesen ist.

## So funktioniert der automatische Abgleich

Der automatische Abgleich läuft beim Import eines Belegs, wenn **Automatischer Bestellabgleich** gefüllt ist, und jedes Mal, wenn Sie im Bestellabgleich **Automatisch zuweisen** wählen. Das System geht die offenen Bestell- bzw. Lieferzeilen der Reihe nach durch und sucht zu jeder eine passende Belegzeile.

### 1. Bestell- und Lieferzeilen ermitteln

- Beim Import wird jede Bestellnummer des Belegs berücksichtigt: die aus dem Belegkopf, die weiteren von SQUEEZE ausgelesenen und die aus den Positionen (**SQZ Bestellnr.**). **Automatisch zuweisen** berücksichtigt nur die Bestellung im Feld **Bestellnr.** des Bestellabgleichs.
- Beim Import werden nur Zeilen der eingestellten Art verwendet: Lieferzeilen bei **Lieferung**, Bestellzeilen bei **Bestellung**. **Automatisch zuweisen** verwendet die Zeilen, die Sie markiert haben.
- Verglichen wird mit der offenen Menge: bei einer Bestellzeile mit der noch nicht berechneten Menge, bei einer Lieferzeile mit der **Lief. nicht fakt. Menge**. Der Betrag der Bestell- bzw. Lieferzeile wird auf diese Menge umgerechnet.

### 2. Passende Belegzeile suchen

In Frage kommen Belegzeilen, die noch keine Zuweisung haben und deren **SQZ Bestellnr.** leer ist oder zur Bestellung passt. Für jede Bestell- bzw. Lieferzeile versucht das System nacheinander:

1. **Art und Nr.:** gleiche **Art**, die **Nr.** ist gleich der Nr. oder der **Artikelreferenz-Nr.** der Bestellzeile, und die **Menge** liegt in der Mengentoleranz.
2. **Gleiche Beschreibung:** Die **SQZ Beschreibung** ist gleich der Beschreibung der Bestell-/Lieferzeile; Groß- und Kleinschreibung spielen keine Rolle.
3. **Enthaltene Beschreibung:** Die **SQZ Beschreibung** enthält die Beschreibung der Bestell-/Lieferzeile.
4. **Erkannte Werte:** **SQZ Menge** und **SQZ Einzelpreis** liegen in der Mengen- bzw. Betragstoleranz, und die **SQZ Beschreibung** ist der Beschreibung der Bestell-/Lieferzeile mindestens so ähnlich wie in **Beschreibung Ähnlichkeit %** angegeben (Standard 70 %). Die Ähnlichkeit ergibt sich aus der Zahl der Zeichen, die man ändern müsste, im Verhältnis zur Länge der längeren Beschreibung.

Kommen mehrere Belegzeilen in Frage, wird die oberste genommen. Hat die Belegzeile eine andere Mengeneinheit als die Bestell-/Lieferzeile, vergleicht das System in den Schritten 1 und 4 zuerst über die Basiseinheit und erst danach die Werte, wie sie dastehen (siehe Beispiel 3).

### 3. Abschließende Prüfung

Hat ein Schritt eine Belegzeile gefunden, prüft das System

- den **Zeilenbetrag** der Belegzeile gegen den Betrag der Bestell-/Lieferzeile für die offene Menge (Betragstoleranz) und
- die **Menge** der Belegzeile gegen die offene Menge (Mengentoleranz, auch über die Basiseinheit).

Nur wenn beides passt, wird die Belegzeile zugewiesen. Besteht die gefundene Belegzeile die Prüfung nicht, bleibt die Bestell-/Lieferzeile ohne Zuweisung – die folgenden Suchschritte werden für sie nicht mehr versucht.

### Toleranzen

Für die abschließende Prüfung gilt, für Betrag und Menge gleichermaßen:

<table id="bkmrk-%25-wertmax.-werterlau"><thead><tr><th>%-Wert</th><th>Max.-Wert</th><th>Erlaubte Abweichung</th></tr></thead><tbody><tr><td>0</td><td>0</td><td>keine – die Werte müssen genau übereinstimmen</td></tr><tr><td>größer 0</td><td>0</td><td>höchstens der Prozentsatz, bezogen auf den Wert der Belegzeile</td></tr><tr><td>0</td><td>größer 0</td><td>höchstens der Max.-Wert</td></tr><tr><td>größer 0</td><td>größer 0</td><td>beide Grenzen müssen eingehalten sein</td></tr></tbody></table>

Mit **Betragstoleranz ignorieren** bzw. **Mengentoleranz ignorieren** entfällt die jeweilige Prüfung.

<p class="callout warning">Bei der Suche – Menge in den Schritten 1 und 4, Einzelpreis in Schritt 4 – lässt das System eine Abweichung nur zu, wenn %-Wert und Max.-Wert beide größer als 0 sind; es gilt dann die engere der beiden Grenzen. Ist einer der beiden Werte 0 oder **Mengentoleranz ignorieren** eingeschaltet, muss die Menge dort genau übereinstimmen. Wenn Sie Abweichungen zulassen wollen, tragen Sie deshalb immer beide Werte ein. Für den Einzelpreis in Schritt 4 wird die **Max. Betragstoleranz** durch die Menge geteilt; mit **Betragstoleranz ignorieren** wird der Einzelpreis dort nicht verglichen, die Belegzeile braucht dann aber einen **SQZ Einzelpreis** größer als 0.</p>

### 4. Anwenden

Beim Import werden die gefundenen Zuweisungen sofort angewendet. **Zuweisen** und **Automatisch zuweisen** weisen nur zu; angewendet wird mit **Ausgewählte Zeile anwenden** oder **Zugewiesene Zeilen anwenden**.

Beim Anwenden übernimmt eine Belegzeile der Dokumentenklasse Rechnung / Gutschrift aus der zugewiesenen Zeile:

- **Art**, **Nr.**, **Artikelreferenz-Nr.**, **Mengeneinheit**, Buchungsgruppen, Dimensionen, Lagerort, Lagerplatz, Abgrenzungscode und Projektangaben der Bestellzeile – bei einer Lieferzeile die Dimensionen der Lieferzeile,
- die **Beschreibung** der Bestellzeile,
- als **Menge** die offene Menge der zugewiesenen Zeile: bei einer Bestellzeile die noch nicht berechnete Menge, bei einer Lieferzeile die gelieferte, noch nicht berechnete Menge,
- den **Rabatt %** der Bestellzeile,
- den **EK-Preis** nur mit **Daten ersetzen** (siehe *Einrichtung*).

Der **Zeilenbetrag** wird danach aus Menge, EK-Preis und Rabatt neu berechnet. Hat die Belegzeile eine andere Mengeneinheit als die zugewiesene Zeile, wird sie vorher in deren Einheit umgerechnet: 24 STK zu 10,00 werden 1 PALETTE zu 240,00. Die Spalte **Artikelabgleichsmethode** der Positionen zeigt anschließend z. B. *Abgeglichen durch Bestellungsabgleich (Einkaufslieferzeile: Belegnr. 107001, Zeilennr. 10000).* Die Spalte ist standardmäßig ausgeblendet; Sie blenden sie über **Personalisieren** ein.

Beim Erstellen der Einkaufsrechnung werden Belegzeilen, die einer Lieferzeile zugewiesen sind, aus dieser Lieferzeile erzeugt – wie mit **Wareneingangszeilen abrufen** – und erhalten anschließend Menge, EK-Preis, Rabatt % und Buchungsgruppen aus der Validierung.

### Besonderheiten bei Auftragsbestätigungen

- Abgeglichen wird nur gegen Bestellzeilen; verglichen wird mit der **Restbestellungsmenge**. Bestellzeilen ohne Restbestellungsmenge werden nicht angezeigt.
- Zuerst werden Bestellzeilen zugewiesen, die noch kein **Zugesagtes Wareneingangsdatum** haben, danach die übrigen.
- In den Schritten 2 und 3 muss zusätzlich die Menge in der Mengentoleranz liegen.
- Beim Anwenden bleiben die bestätigte Menge, der bestätigte EK-Preis und die Beschreibung erhalten (bei abweichender Mengeneinheit umgerechnet); übernommen werden u. a. Art, Nr., Mengeneinheit, Buchungsgruppen und Dimensionen.

Mehr dazu unter [Auftragsbestätigungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/auftragsbestatigungen).

### Abweichungen nach der Zuweisung

Zu jeder zugewiesenen Position zeigt die Seite [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung) die Infoboxen **Bestellabgleich-Info (Menge)**, **Bestellabgleich-Info (Preis)** und **Bestellabgleich-Info (Rabatt)**, bei Auftragsbestätigungen zusätzlich **Bestellabgleich-Info (Datum)**. Abweichungen werden dort rot dargestellt:

- **Preis:** EK-Preis gegen den zugewiesenen Einzelpreis, mit der Betragstoleranz; die Max. Betragstoleranz wird dafür durch die Menge geteilt.
- **Menge:** Menge gegen die zugewiesene Menge, mit der Mengentoleranz.
- **Rabatt:** Rabatt % gegen den zugewiesenen Zeilenrabatt % – ohne Toleranz.

Ist die Position einer Lieferzeile zugewiesen, vergleicht das System zusätzlich mit der Bestellzeile; ist sie einer Bestellzeile zugewiesen und gibt es dazu schon eine Lieferung, zusätzlich mit der Lieferzeile. Belege mit Abweichungen zählen die Kacheln der Bestellabgleich-Aktivitäten im Rollencenter (siehe [Rollencenter-Aktivitäten](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/rollencenter-aktivitaten)).

## Beispiele

Die Beispiele gehen von der Dokumentenklasse **Rechnung / Gutschrift** mit den Vorgabewerten aus: **Automatischer Bestellabgleich** = **Lieferung**, **Daten ersetzen** eingeschaltet, **Bestellungszuweisung zulassen** ausgeschaltet, alle Toleranzen 0.

### Beispiel 1: Rechnung über eine Teillieferung

Einkaufsbestellung 106001 für Kreditor 20000 hat eine Zeile: Artikel 1000 „Bürostuhl Comfort“, Menge 10, EK-Preis 120,00. Gebucht ist die Lieferung 107001 über 6 Stück. Die Rechnung nennt die Bestellnummer 106001 und eine Position über 6 Stück zu 120,00. SQUEEZE hat den Artikel 1000 erkannt; die ausgelesene Beschreibung lautet „Buerostuhl Comfort schwarz“.

1. Beim Import ermittelt das System die Lieferzeile 107001 / 10000 mit der offenen Menge 6.
2. Schritt 1 findet die Position: Art **Artikel**, Nr. 1000, Menge 6.
3. Die abschließende Prüfung ergibt keine Abweichung: Zeilenbetrag 720,00 = 6 × 120,00, Menge 6 = 6.
4. Die Position wird zugewiesen und angewendet. Ihre Beschreibung lautet danach „Bürostuhl Comfort“, die Artikelabgleichsmethode *Abgeglichen durch Bestellungsabgleich (Einkaufslieferzeile: Belegnr. 107001, Zeilennr. 10000).*
5. Beim Erstellen der Einkaufsrechnung entsteht die Rechnungszeile aus der Lieferzeile 107001 / 10000.

Stünde **Automatischer Bestellabgleich** auf **Bestellung**, würde mit der Bestellzeile und ihrer noch nicht berechneten Menge 10 verglichen. Ohne Mengentoleranz würde die Position über 6 Stück dann nicht zugewiesen.

### Beispiel 2: Preisabweichung und Betragstoleranz

Wie Beispiel 1, aber mit **Betragstoleranz %** = 1 und **Max. Betragstoleranz** = 5. Beide Grenzen müssen eingehalten sein:

<table id="bkmrk-ek-preis-auf-der-rec"><thead><tr><th>EK-Preis auf der Rechnung</th><th>Zeilenbetrag</th><th>Abweichung zu 720,00</th><th>Ergebnis</th></tr></thead><tbody><tr><td>120,50</td><td>723,00</td><td>3,00 (0,41 %)</td><td>zugewiesen</td></tr><tr><td>121,00</td><td>726,00</td><td>6,00 (0,83 %)</td><td>nicht zugewiesen – mehr als 5,00, obwohl unter 1 %</td></tr></tbody></table>

Im ersten Fall steht nach dem Anwenden der EK-Preis der Lieferzeile in der Position (120,00, Zeilenbetrag 720,00), weil **Daten ersetzen** eingeschaltet ist; ist der Schalter aus, bleibt 120,50 stehen. Im zweiten Fall bleibt die Position ohne Zuweisung. Sie können sie im Bestellabgleich mit **Zuweisen** von Hand zuweisen – dabei werden keine Toleranzen geprüft.

### Beispiel 3: Andere Mengeneinheit

Artikel 70000 „Sechskantschrauben M8 verzinkt“ hat die Basiseinheit STK, die Einheit PAKET mit **Menge pro Einheit** 2 und die Einheit PALETTE mit **Menge pro Einheit** 24. Bestellt und geliefert wurde 1 PALETTE zu 240,00. Der Lieferant berechnet 24 STK zu 10,00.

1. Schritt 1 rechnet über die Basiseinheit um: 1 PALETTE = 24 STK – die Menge passt.
2. Abschließende Prüfung: Zeilenbetrag 240,00 = 240,00; Menge 24 STK = 1 PALETTE.
3. Beim Anwenden wird die Position in die Einheit der Lieferzeile umgerechnet: 1 PALETTE zu 240,00, Zeilenbetrag weiterhin 240,00.

Weil die Umrechnung zuerst geprüft wird, geht eine Bestellzeile über 1 PALETTE an eine Rechnungsposition über 1 PALETTE und nicht an eine Position über 1 PAKET desselben Artikels, obwohl beide die Menge 1 haben.

### Beispiel 4: Position ohne erkannten Artikel

Wie Beispiel 3, aber SQUEEZE hat in der Position keinen Artikel erkannt. Ausgelesen wurden **SQZ Beschreibung** „Sechskantschrauben M8 verz.“, **SQZ Menge** 24 und **SQZ Einzelpreis** 10,00.

1. Schritt 1 findet nichts, weil die Position keinen Artikel hat. Die Schritte 2 und 3 finden nichts, weil die Beschreibung der Lieferzeile „Sechskantschrauben M8 verzinkt“ weder gleich ist noch in der SQZ Beschreibung enthalten ist.
2. Schritt 4: SQZ Menge 24 entspricht 1 PALETTE, SQZ Einzelpreis 10,00 entspricht 240,00 je PALETTE, und die Beschreibungen sind sich zu rund 87 % ähnlich (4 geänderte Zeichen bei 30 Zeichen) – mehr als die geforderten 70 %.
3. Prüfung und Anwenden wie in Beispiel 3. Die Position erhält dabei Art **Artikel** und Nr. 70000.

## Einschränkungen

- Der automatische Abgleich beim Import läuft je Beleg nur einmal. Wird eine Lieferung erst später gebucht oder eine Bestellnummer nachgetragen, öffnen Sie den Bestellabgleich, wählen **Automatisch zuweisen** und danach **Zugewiesene Zeilen anwenden**.
- Beim Import wird nur gegen eine Art abgeglichen: Lieferzeilen oder Bestellzeilen.
- Lieferungen werden nur bei Rechnungen und Gutschriften angezeigt.
- Positionen, deren **SQZ Bestellnr.** auf eine andere Bestellung verweist, werden dieser Bestellung nicht automatisch zugewiesen.
- Die Schritte 2 und 3 vergleichen nur die Beschreibung. Besteht die zuerst gefundene Belegzeile die abschließende Prüfung nicht, sucht das System für diese Bestell-/Lieferzeile keine andere Belegzeile mehr.
- Beim manuellen Zuweisen werden weder Toleranzen noch offene Mengen geprüft.
- Das System verhindert nicht, dass eine Bestell- oder Lieferzeile mehreren Belegzeilen zugewiesen wird – etwa von Hand oder wenn Sie **Automatisch zuweisen** erneut ausführen. Beim Erstellen der Einkaufsrechnung entsteht je Lieferzeile aber nur eine Rechnungszeile. Prüfen Sie die Spalte **Zugewiesen** deshalb vor dem Validieren.
- Das Entfernen einer Zuweisung macht das Anwenden nicht rückgängig.
- Beim Anwenden ersetzt eine Rechnungsposition Menge, Beschreibung und Rabatt % durch die Werte der zugewiesenen Zeile. Berechnet der Lieferant nur einen Teil einer Liefer- oder Bestellzeile, korrigieren Sie die Menge nach dem Anwenden.

## Fehlerbehebung

#### Beim Import wurde keine Position zugewiesen

1. Ist **Automatischer Bestellabgleich** gefüllt – in der Kreditorenbezogenen Einrichtung, wenn es für den Kreditor eine gibt, sonst in der Dokumentenklassen-Einrichtung?
2. Hat SQUEEZE eine Bestellnummer erkannt (Feld **Bestellnummer gefunden**)? Wenn nicht, wählen Sie die Bestellung im Bestellabgleich aus und nutzen **Automatisch zuweisen**.
3. Gehört die Bestellung zum Kreditor des Belegs? Sonst zeigt der Bestellabgleich eine rote Meldung neben der Bestellnr.
4. Gibt es offene Zeilen der eingestellten Art? Bei **Lieferung** muss die Lieferung gebucht und noch nicht berechnet sein. Wurde sie erst nach dem Import gebucht, führen Sie **Automatisch zuweisen** von Hand aus.
5. Liegen Menge und Zeilenbetrag in den Toleranzen? Mit den Vorgabewerten 0 müssen sie genau übereinstimmen. Ist nur einer der beiden Toleranzwerte gefüllt, findet die Suche nach Art und Nr. nur genau gleiche Mengen (siehe *Toleranzen*).
6. Verweist die **SQZ Bestellnr.** der Position auf eine andere Bestellung?

#### Fehlermeldung zu „Bestellungszuweisung zulassen“ beim Zuweisen

Sie haben eine Bestellzeile zugewiesen oder **Automatisch zuweisen** auf einer Bestellung ausgeführt, aber in der Dokumentenklassen-Einrichtung ist **Bestellungszuweisung zulassen** ausgeschaltet – bei Rechnung / Gutschrift die Vorgabe. Markieren Sie stattdessen die Lieferung bzw. ihre Zeilen, oder schalten Sie **Bestellungszuweisung zulassen** ein. Beachten Sie, dass beim Öffnen des Bestellabgleichs die erste Zeile markiert ist – und das ist die Bestellung.

#### Die Plausibilitätsprüfung meldet „Zugewiesene Belegart darf nicht Bestellung sein.“

Eine Position ist einer Bestellzeile zugewiesen, obwohl **Bestellungszuweisung zulassen** ausgeschaltet ist. Entfernen Sie die Zuweisung und weisen Sie die Position der passenden Lieferzeile zu, oder schalten Sie **Bestellungszuweisung zulassen** ein.

#### Neben der Bestellnummer steht „Bestellnr. … passt nicht zum Eink. von Kred.-Nr. …“

Unter dieser Nummer gibt es keine Bestellung des Kreditors, der auf dem Beleg steht. Prüfen Sie den Kreditor im Belegkopf und wählen Sie die Bestellnummer über die drei Punkte aus.

#### Nach dem Anwenden hat die Position eine andere Menge oder Beschreibung

Das ist das Ergebnis des Anwendens (siehe *4. Anwenden*). Korrigieren Sie die Werte danach von Hand und führen Sie **Zugewiesene Zeilen anwenden** anschließend nicht erneut aus – sonst werden Ihre Korrekturen wieder überschrieben.

#### „Bestellungszuweisung zulassen“ lässt sich nicht ausschalten

Es erscheint **Automatischer Bestellabgleich darf nicht Bestellung sein. Bitte ändern Sie den Wert Automatischer Bestellabgleich.** Stellen Sie zuerst **Automatischer Bestellabgleich** auf **Lieferung** oder leer.

## Verwandte Themen

- [Bestell-/ Wareneingangszeilen manuell importieren](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/bestell-wareneingangszeilen-manuell-importieren)
- [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung)
- [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung)
- [Kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung)
- [Auftragsbestätigungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/auftragsbestatigungen)
- [Rollencenter-Aktivitäten](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/rollencenter-aktivitaten)
- [Autovervollständigen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/autovervollstandigen)
- [Implementierung eines benutzerdefinierten, automatischen Bestellabgleichs](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/implementierung-eines-benutzerdefinierten-automatischen-bestellabgleichs) (für Entwickler)

# Bestell-/ Wareneingangszeilen manuell importieren

Holen der Positionen aus Bestellung / Wareneingang

## Menü

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

#### Hinzufügen zur Importvorschau

Hiermit werden alle ausgewählten Zeilen in die Importvorschau übernommen.

Ausgewählte Zeilen werden durch einen grünen Haken dargestellt [![image-1646147695338.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1646147695338.png).](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646147695338.png)

#### Ausgewählte Vorschauzeile löschen

Hiermit werden alle ausgewählten Zeilen aus der Importvorschau entfernt.

#### Importvorschau übernehmen

Hiermit werden alle Zeilen aus der Importvorschau in den zu validierenden Beleg übernommen. Sie haben die Wahl ob diese Zeilen die SQUEEZE Positionen ersetzen oder hinten angehängt werden sollen.

## Bereiche

### Bestellnummer

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

Hier wird die ausgelesene Bestellnummer angezeigt. Sollten mehrere Bestellnummern ausgelesen worden sein, so kann über die drei Punkte die entsprechende Liste geöffnet werden.

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

### Bestell- &amp; Lieferungen

in diesem Bereich werden die Bestellung und alle Ihre Zeilen, sowie alle dazugehörigen Lieferungen und deren Zeilen aufgelistet.

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

### Importvorschau

In diesem Bereich werden alle ausgewählten Positionen aufgelistet.

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

# Externer Viewer

Um das Arbeiten mit dem Viewer zu vereinfachen, kann der eingebettete Viewer abgedockt und so auf einem zweiten Bildschirm genutzt werden.

Sämtliche Viewer Funktionen, wie z.B. das Highlighting der Kopf- und Positionsdaten, sowie die Trainingsfunktionen des Viewers werden weiterhin unterstützt.

Damit der abgedockte Viewer auch bei einem Belegwechsel aktiv bleibt und sich selbstständig aktualisiert, muss in der [benutzerspezifischen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/benutzerspezifische-einrichtung) das Feld "Nur externen Viewer verwenden" gesetzt werden.

[![image-1688735018861.png](https://docs.squeeze.one/uploads/images/gallery/2023-07/scaled-1680-/image-1688735018861.png)](https://docs.squeeze.one/uploads/images/gallery/2023-07/image-1688735018861.png)

# Belege hochladen

SQUEEZE for BC bietet die Möglichkeit, Belege direkt aus Business Central an das verbundene SQUEEZE-System zu senden.

#### Belege hochladen über die Belegübersicht

In der SQUEEZE Belegübersicht steht die Aktion **Belege hochladen** zur Verfügung. Beim Aufruf wird die zu verwendende Dokumentenklasse abgefragt. Anschließend öffnet sich die Upload-Seite.

#### Squeeze Dateiupload

Auf der Upload-Seite können Dateien per **Drag &amp; Drop** in den Ablagebereich gezogen werden. Es können mehrere Dateien gleichzeitig abgelegt werden.

Über die Aktion **Dateien hochladen** werden alle abgelegten Dateien an den SQUEEZE Mandanten übertragen. Nach dem erfolgreichen Upload wird jede Datei mit einem Häkchen markiert.

Beim Schließen der Seite wird geprüft, ob alle abgelegten Dateien hochgeladen wurden. Sollte mindestens eine Datei nicht hochgeladen worden sein, erscheint eine entsprechende Warnung.

# SQUEEZE Warteschlange

Die SQUEEZE Warteschlange bietet eine Echtzeitübersicht über den Verarbeitungsstatus aller Belege in der SQUEEZE-Pipeline des verbundenen Mandanten.

#### Übersicht

Die Warteschlange zeigt für jeden Verarbeitungsschritt die Anzahl der darin befindlichen Belege an:

- **Fehler**: Belege, bei denen ein Fehler aufgetreten ist (rot hervorgehoben). Über den Drilldown wird die SQUEEZE Web-Oberfläche geöffnet.
- **Neue Dokumente**: Belege, die sich im initialen Verarbeitungsschritt befinden.
- **Bildaufbereitung**: Belege, die aktuell bildtechnisch aufbereitet werden.
- **Barcode Extraktion**: Belege, bei denen Barcodes ausgelesen werden.
- **Texterkennung (OCR)**: Belege, bei denen die Texterkennung durchgeführt wird.
- **Klassifizierung**: Belege, die einer Dokumentenklasse zugeordnet werden.
- **Extraktion**: Belege, bei denen die Datenextraktion (Beleglesung) durchgeführt wird.
- **Export**: Belege, die bereit zur Abholung durch Business Central sind.
- **Verarbeitet**: Bereits verarbeitete Belege.

Nicht-leere Schritte werden fett dargestellt. Die Ansicht aktualisiert sich automatisch alle 5 Sekunden.

#### Aktionen

- **Belege jetzt herunterladen**: Löst eine manuelle Abholung von Belegen aus SQUEEZE aus.
- **Beleg hochladen**: Ermöglicht das Hochladen eines Belegs an das SQUEEZE-System.

Die Warteschlange ist aus der SQUEEZE Belegübersicht über die Aktion **Warteschlange** erreichbar.

# Viewer im Ziel-Beleg

Ab der neuesten Version kann der SQUEEZE Viewer auch in den resultierenden Zielbelegen (Einkaufsrechnungen und Einkaufsbestellungen) angezeigt werden. Dadurch können Anwender den ursprünglich gescannten Beleg jederzeit einsehen, ohne zum SQUEEZE-Beleg zurückkehren zu müssen.

#### Aktivierung

Die Funktion wird in der **SQUEEZE Einrichtung** im FastTab **Viewer** über den Schalter **Viewer im Ziel-Beleg** aktiviert.

#### Funktionsweise

Wenn die Funktion aktiviert ist, erscheint der SQUEEZE Viewer als Infobox (FactBox) auf den folgenden Seiten:

- **Einkaufsrechnung**: Der Viewer zeigt den ursprünglich gescannten Beleg an, aus dem die Rechnung erstellt wurde.
- **Einkaufsbestellung**: Bei Auftragsbestätigungen zeigt der Viewer den zugehörigen gescannten Beleg an.

Der Viewer unterstützt dabei alle gewohnten Funktionen, wie z. B. das Hervorheben von Fundstellen. Auch der abgedockte Modus wird unterstützt.

#### Hinweis

Die Verknüpfung zwischen Zielbeleg und SQUEEZE-Beleg wird automatisch über den DEXPRO Core hergestellt. Der Viewer wird nur angezeigt, wenn für den jeweiligen Einkaufsbeleg ein zugehöriger SQUEEZE-Beleg existiert.

# Plausibilitätsprüfungen

Die Plausibilitätsprüfung ist ein zentraler Bestandteil der Belegvalidierung. Sie stellt sicher, dass alle relevanten Daten plausibel und vollständig sind, bevor ein Beleg weiterverarbeitet wird. Die Ergebnisse werden in der Infobox **Plausibilitätseinträge** angezeigt.

#### Kopffeld-Prüfungen

- **Kreditor existiert / nicht gesperrt**: Der angegebene Kreditor muss im System vorhanden sein und darf nicht gesperrt sein (optional: Gesperrtstatus "Zahlung" kann über "Gesperrten Lieferanten (Zahlung) ignorieren" in der Dokumentenklassen Einrichtung übersprungen werden).
- **Pflichtfelder**: Belegdatum, Buchungsdatum, Belegnummer und Belegart müssen ausgefüllt sein.
- **Buchungsdatum**: Das Buchungsdatum muss in einem zulässigen Buchungszeitraum liegen (kann über "Buchungsdatum nicht prüfen" deaktiviert werden).
- **IBAN-Prüfung**: Wenn eine IBAN erkannt wurde, wird geprüft, ob beim Kreditor ein passendes Bankkonto hinterlegt ist (kann über "IBAN nicht prüfen" deaktiviert werden).
- **USt-ID-Prüfung**: Wenn eine USt-ID erkannt wurde, wird geprüft, ob diese mit der hinterlegten USt-ID des Kreditors übereinstimmt (kann über "USt-ID nicht prüfen" deaktiviert werden).
- **Doublettenprüfung**: Es wird geprüft, ob bereits ein Beleg mit derselben Belegnummer und demselben Kreditor existiert.
- **Währungscode**: Der angegebene Währungscode muss im System vorhanden sein.
- **Zahlungsbedingungscode**: Ein angegebener Zahlungsbedingungscode muss im System vorhanden sein.
- **Zuständigkeitseinheitencode** (Rechnungen und Gutschriften): Die Zuständigkeitseinheit muss im System vorhanden sein, und Ihr Benutzer muss sie für Einkaufsbelege verwenden dürfen. Beschränkt die Benutzereinrichtung (oder die Firmendaten) Ihren Benutzer auf eine andere Zuständigkeitseinheit, erscheint z. B. **Zuständigkeitseinheit BERLIN ist nicht zulässig. Ihr Benutzer ist so eingerichtet, dass er Einkäufe nur für Zuständigkeitseinheit MUENCHEN verarbeiten kann.**
- **MwSt.-Geschäftsbuchungsgruppe** (Rechnungen und Gutschriften): Die MwSt.-Geschäftsbuchungsgruppe im Belegkopf muss im System vorhanden sein.
- **Bestellnummer**: Wenn eine Bestellnummer angegeben ist, muss die zugehörige Bestellung im System existieren.

#### Betragsüberprüfungen

- **Kopfbetragsprüfung**: Es wird geprüft, ob die Netto-, Steuer- und Gesamtbeträge rechnerisch korrekt sind (kann über "Kopfbetragsprüfung deaktivieren" abgeschaltet werden).
- **Zeilenbetragsvergleich**: Die Summe der Zeilenbeträge wird mit den Kopfbeträgen verglichen (kann über "Zeilenbetragsvergleich deaktivieren" abgeschaltet werden).
- **Kopfsteuerprüfung**: Es wird geprüft, ob der Steuerbetrag zum Nettobetrag und Steuersatz passt (kann über "Kopfsteuerprüfung deaktivieren" abgeschaltet werden).

#### Zeilenprüfungen

- **Buchungsgruppen**: Für jede Zeile wird geprüft, ob die erforderlichen MwSt.-Buchungsgruppen und allgemeinen Buchungsgruppen existieren.
- **Artikel**: Wenn ein Artikel zugewiesen ist, muss dieser im System vorhanden sein.
- **Mengeneinheit**: Die angegebene Mengeneinheit muss für den zugewiesenen Artikel gültig sein.
- **Lagerort**: Wenn ein Lagerort angegeben ist, muss dieser existieren (kann über "Lagerortprüfung deaktivieren" abgeschaltet werden).
- **Dimensionen**: Die Dimensionswerte in Kopf und Zeilen werden auf Gültigkeit geprüft.
- **Projektdaten**: Wenn Projektdaten (Projektnr., Projektaufgabennr.) zugewiesen sind, wird deren Existenz und Gültigkeit geprüft.

#### Konfiguration

Die einzelnen Plausibilitätsprüfungen können in der **Dokumentenklassen Einrichtung** unter dem Abschnitt **Plausibilitätsprüfung** individuell deaktiviert werden. Dies ermöglicht es, die Validierung an die jeweiligen Geschäftsprozesse anzupassen.

# Auftragsbestätigungen

Neben Einkaufsrechnungen und Gutschriften unterstützt SQUEEZE for BC auch die Verarbeitung von **Auftragsbestätigungen**. Diese Dokumentenklasse ermöglicht es, eingehende Auftragsbestätigungen von Lieferanten automatisiert zu erfassen und mit bestehenden Einkaufsbestellungen abzugleichen.

#### Verarbeitung

Auftragsbestätigungen durchlaufen denselben Verarbeitungsprozess wie Rechnungen (SQUEEZE-Extraktion, Import, Validierung). Die folgenden Besonderheiten gelten:

- **Pflicht-Bestellzuweisung**: Im Gegensatz zu Rechnungen muss bei Auftragsbestätigungen mindestens eine Zeile einer Bestellzeile zugewiesen sein, bevor die Validierung abgeschlossen werden kann.
- **Zugesagtes Wareneingangsdatum**: Das vom Lieferanten bestätigte Lieferdatum wird auf Zeilenebene erfasst und als "Zugesagtes Wareneingangsdatum" übernommen.
- **Kein Wareneingangs-Abgleich**: Auftragsbestätigungen können nur gegen Bestellungen abgeglichen werden, nicht gegen Wareneigänge (Lieferungen).

#### Bestellabgleich bei Auftragsbestätigungen

Der Bestellabgleich bei Auftragsbestätigungen prüft zusätzlich folgende Bedingungen:

- Das zugesagte Wareneingangsdatum darf nicht leer sein.
- Die bestätigte Menge und der bestätigte Einzelpreis dürfen nicht Null sein.
- Abweichungen zwischen bestätigten und bestellten Werten (Menge, Preis, Rabatt, Lieferdatum) werden in den Bestellabgleich-Infoboxen hervorgehoben.

#### Toleranzen

Im Gegensatz zu Rechnungen steht bei Auftragsbestätigungen zusätzlich die **Toleranz Wareneingangsdatum** in der Dokumentenklassen- und der kreditorenbezogenen Einrichtung zur Verfügung. Diese definiert als Datumsformel, wie weit das bestätigte Lieferdatum vom erwarteten abweichen darf (z. B. `2D` für zwei Tage).

#### Einrichtung

Um Auftragsbestätigungen zu verarbeiten, muss eine eigene Dokumentenklasse vom Typ **Auftragsbestätigung** in SQUEEZE und in der Dokumentenklassen Einrichtung in Business Central eingerichtet werden.

# Autovervollständigen

Autovervollständigen merkt sich, wie Sie die Positionen eines Kreditors kontiert haben, und füllt dieselben Positionen auf den nächsten Belegen dieses Kreditors selbst aus: Art, Nr., Mengeneinheit, Beschreibung und Dimensionen. Das spart vor allem bei wiederkehrenden Rechnungen ohne Bestellbezug Arbeit – etwa Miete, Wartungsverträge, Energie oder Büromaterial.

Die Funktion lernt ausschließlich aus Ihren eigenen Validierungen. Es gibt keine vorab gepflegten Regeln: Eine Position wird erst dann automatisch ausgefüllt, wenn Sie sie für diesen Kreditor schon einmal korrigiert und den Beleg validiert haben.

## Voraussetzungen

- **Option eingeschaltet:** In der [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) steht im FastTab **Squeeze** das Feld **Autovervollständigen-Option** auf **Manuell** oder **Automatisch**. Gibt es für den Kreditor eine [Kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung), gilt deren Wert (siehe unten).
- **Kreditor bekannt:** Der Beleg hat eine **Kreditorennr.** Alles, was Autovervollständigen sich merkt, gilt je Kreditor. Ohne Kreditor wird nichts gemerkt und nichts ausgefüllt.
- **Mindestens eine Validierung:** Ein früherer Beleg desselben Kreditors in derselben Dokumentenklasse wurde validiert, nachdem die Position darauf korrigiert wurde. Beim allerersten Beleg eines Kreditors gibt es noch nichts zum Ausfüllen.
- **Für das automatische Ausfüllen beim Import:** Der Beleg hat keine **Bestellnr.** Belege mit Bestellnummer werden über den [Bestellabgleich](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/bestell-wareneingangsabgleich) verarbeitet; die Aktion **Autovervollständigen** können Sie dort trotzdem von Hand ausführen.
- **Berechtigungen:** Die Berechtigungssätze **DEXPRO SQUEEZE Benutzer** und **DEXPRO SQUEEZE Administrator** enthalten alles, was für Autovervollständigen und die Liste der Einträge nötig ist. Siehe [Berechtigungssätze](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/berechtigungssatze).

## Einrichtung

### Autovervollständigen-Option

Das Feld gibt es in der Dokumentenklassen Einrichtung (Standard für alle Kreditoren) und in der Kreditorenbezogenen Einrichtung (Abweichung für einzelne Kreditoren).

<table id="bkmrk-optionaktion-%E2%80%9Eautove"><thead><tr><th>Option</th><th>Aktion „Autovervollständigen"</th><th>Beim Import ausfüllen</th><th>Beim Validieren merken</th></tr></thead><tbody><tr><td>**Niemals**</td><td>ausgeblendet</td><td>nein</td><td>nein</td></tr><tr><td>**Manuell**</td><td>sichtbar</td><td>nein</td><td>ja</td></tr><tr><td>**Automatisch**</td><td>sichtbar</td><td>ja</td><td>ja</td></tr></tbody></table>

**Manuell** eignet sich zum Einstieg: Das System lernt bereits mit, aber Sie entscheiden je Beleg, ob Sie die gemerkten Werte übernehmen. Wenn die Vorschläge zuverlässig passen, stellen Sie auf **Automatisch** um.

[![Dokumentenklassen-Einrichtung, FastTab Squeeze mit Autovervollständigen-Option](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/doc-class-setup-squeeze.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/doc-class-setup-squeeze.png)

### Dokumentenklasse oder Kreditor – was gilt?

Gibt es für den Kreditor eine Kreditorenbezogene Einrichtung, gilt deren Autovervollständigen-Option – für die Aktion, das Ausfüllen beim Import und das Merken beim Validieren. Sonst gilt die Option der Dokumentenklassen Einrichtung.

So können Sie die Funktion für einzelne Kreditoren in beide Richtungen abweichend einstellen: Steht die Dokumentenklasse auf **Manuell**, stellen Sie z. B. den Kreditor mit den monatlichen Mietrechnungen auf **Automatisch**; steht sie auf **Automatisch**, nehmen Sie einen Kreditor mit stark wechselnden Positionen mit **Manuell** oder **Niemals** heraus.

Legen Sie eine neue Kreditorenbezogene Einrichtung an, übernimmt sie die Autovervollständigen-Option der Dokumentenklasse. Ändern Sie danach die Dokumentenklasse, bleibt der Wert beim Kreditor unverändert.

## So funktioniert es

### 1. Merken beim Validieren

Wenn Sie einen Beleg mit **Validieren** abschließen (oder die automatische Validierung ihn abschließt), legt das System für jede Position einen Autovervollständigen-Eintrag an oder aktualisiert ihn, wenn

- die Position eine **Nr.** hat (Artikel, Sachkonto, Ressource usw.) und
- die Position nach dem Import noch geändert wurde – in der Praxis also Ihre Korrekturen.

Gemerkt werden **Art**, **Nr.**, **Mengeneinheit**, **Beschreibung** und die **Dimensionen** der Position – je Dokumentenklasse und Kreditor. Gibt es für dieselbe Position schon einen Eintrag, wird er mit Ihrer letzten Korrektur überschrieben. Mengen und Preise werden nicht gemerkt.

### 2. Wiedererkennen einer Position

Woran eine Position wiedererkannt wird, hängt davon ab, woher sie stammt:

- **Vom Beleg ausgelesene Positionen:** an der Kombination der Werte, die SQUEEZE ausgelesen hat – **SQZ Art.-Nr.**, **SQZ Mengeneinheit**, **SQZ Beschreibung** und **SQZ Einzelpreis**. Alle vier müssen genau übereinstimmen; Groß- und Kleinschreibung spielt keine Rolle.
- **Positionen aus der [Kontierungseinrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungseinrichtungen):** an Art und Nr. des Kontos, das die Kontierungseinrichtung einsetzt. Für diese Positionen merkt sich das System je Kreditor und Konto die **Beschreibung** und die **Dimensionen**. Das Konto selbst bleibt das der Kontierungseinrichtung – ein anderes Konto hinterlegen Sie in der Kontierungseinrichtung des Kreditors oder über eine [Regel zur Zeilenkontierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen).

<p class="callout info">Weil der Einzelpreis Teil der Wiedererkennung ist, gilt eine Position nach einer Preisänderung als neu. Sie korrigieren sie dann einmal von Hand; nach der Validierung wird auch der neue Preis wiedererkannt.</p>

### 3. Ausfüllen

Bei jeder wiedererkannten Position setzt das System **Art** und **Nr.** – mit allem, was Business Central daraus ableitet, z. B. Buchungsgruppen und Vorgabedimensionen – sowie die **Mengeneinheit**. **Beschreibung** und **Dimensionen** werden nur übernommen, wenn der Eintrag welche enthält; ein Eintrag ohne Beschreibung oder ohne Dimensionen lässt die vorhandenen Werte stehen. Menge und Preise bleiben unverändert.

- **Automatisch:** beim Import des Belegs, noch vor dem Bestellabgleich und der Kontierung. Positionen, die anschließend die Kontierungseinrichtung anlegt, werden direkt danach ebenfalls ausgefüllt.
- **Manuell:** über die Aktion **Autovervollständigen** auf der Seite [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung). Die Aktion bearbeitet alle Positionen des Belegs.

<p class="callout warning">Die Aktion **Autovervollständigen** überschreibt bei jeder wiedererkannten Position Art, Nr. und Mengeneinheit sowie – falls gemerkt – Beschreibung und Dimensionen, auch wenn Sie die Position vorher schon von Hand geändert haben. Führen Sie die Aktion deshalb vor Ihren eigenen Korrekturen aus.</p>

Welche Positionen ausgefüllt wurden, zeigt die Spalte **Artikelabgleichsmethode** der Positionen: *Abgeglichen durch Autovervollständigen Eintrag (vorherige manuelle Zuordnung für diesen Kreditoren).* Die Spalte ist standardmäßig ausgeblendet; Sie blenden sie über **Personalisieren** ein.

### Reihenfolge beim Import

1. Autovervollständigen (nur bei Option **Automatisch** und ohne Bestellnr.)
2. Automatischer Bestellabgleich
3. Kontierung über die Kontierungseinrichtung (nur ohne Bestellbezug), anschließend Autovervollständigen der neuen Positionen
4. Regeln zur Zeilenkontierung
5. Automatische Validierung, falls aktiviert

Regeln zur Zeilenkontierung laufen nach dem Autovervollständigen. Trifft eine Regel auf eine Position zu, gilt das Konto der Regel.

## Beispiele

### Beispiel 1: Wiederkehrende Position ohne Artikelstamm

Ein Bürobedarfslieferant (Kreditor 44000) schickt jeden Monat eine Rechnung mit der Position:

<table id="bkmrk-sqz-art.-nr.sqz-besc"><thead><tr><th>SQZ Art.-Nr.</th><th>SQZ Beschreibung</th><th>SQZ Mengeneinheit</th><th>SQZ Einzelpreis</th></tr></thead><tbody><tr><td>TON-505</td><td>Toner schwarz 05A</td><td>STK</td><td>89,90</td></tr></tbody></table>

1. **Januar:** Die Position kommt ohne Nr. an. Sie setzen Art **Sachkonto**, Nr. **6815** (Bürobedarf), die Beschreibung „Toner Drucker Empfang" und die Kostenstelle **VERWALTUNG**. Dann validieren Sie den Beleg – das System merkt sich die Position für Kreditor 44000.
2. **Februar:** Dieselbe Position kommt wieder. Bei Option **Automatisch** ist sie beim Öffnen des Belegs bereits mit Sachkonto 6815, der Beschreibung und der Kostenstelle ausgefüllt; bei **Manuell** klicken Sie auf **Autovervollständigen**.
3. **Juni:** Der Lieferant erhöht den Preis auf 92,50. Die Position wird nicht wiedererkannt und kommt leer an. Sie kontieren sie einmal neu und validieren – ab Juli wird auch der neue Preis wiedererkannt.

### Beispiel 2: Dimensionen auf einer Position aus der Kontierungseinrichtung

Für einen Energieversorger ist eine Kontierungseinrichtung hinterlegt, die je MwSt.-Satz eine Position mit Sachkonto **6325** und der Beschreibung „Energiekosten" anlegt.

1. Auf der ersten Rechnung ändern Sie die Beschreibung in „Strom Halle 2", setzen die Kostenstelle **PRODUKTION** und validieren.
2. Auf jeder weiteren Rechnung dieses Kreditors legt die Kontierungseinrichtung wieder eine Position mit Sachkonto 6325 an, und Autovervollständigen ergänzt „Strom Halle 2" und die Kostenstelle PRODUKTION.

## Autovervollständigen-Einträge

Die Liste **Autovervollständigen-Einträge** zeigt, was das System gelernt hat. Sie öffnen sie über die Suche oder aus der Liste **Squeeze Kreditorenbezogene Einrichtung** mit der Aktion **Autovervollständigen-Einträge** – dann ist die Liste bereits auf den markierten Kreditor und seine Dokumentenklasse gefiltert.

[![Liste Autovervollständigen-Einträge](https://docs.squeeze.one/uploads/images/gallery/2026-11/scaled-1680-/autocomplete-entries.png)](https://docs.squeeze.one/uploads/images/gallery/2026-11/autocomplete-entries.png)

- **Dokumentenklasse** und **Kreditorennr.** — für welche Belege der Eintrag gilt.
- **Art**, **Nr.**, **Beschreibung**, **Mengeneinheit** — die Werte, mit denen die Position ausgefüllt wird.
- **Dimensionssatz-ID** und **Shortcutdimensionscode 1–8** — die Dimensionen. Über die Dimensionssatz-ID öffnen Sie die Dimensionen und können sie ändern.

Welche ausgelesene Position zu einem Eintrag gehört, wird intern als Prüfwert gespeichert und in der Liste nicht angezeigt. Erkennen Sie einen Eintrag deshalb an Kreditor, Nr. und Beschreibung. Neue Einträge entstehen nur durch Validieren; von Hand angelegte Einträge werden nie wiedererkannt.

Sie können Einträge ändern, z. B. ein anderes Sachkonto oder eine andere Kostenstelle eintragen, oder einen falschen Eintrag löschen.

## Einschränkungen

- Wiedererkannt wird nur eine genau gleiche Position: Ändert sich Artikelnummer, Schreibweise der Beschreibung, Mengeneinheit oder Einzelpreis auf dem Beleg, gilt sie als neu.
- Einträge gelten nur für den Kreditor und die Dokumentenklasse, für die sie gelernt wurden.
- Beim Import wird nur bei Belegen ohne Bestellnr. automatisch ausgefüllt.
- Beim Ausfüllen wird nicht geprüft, ob der gemerkte Artikel oder das gemerkte Konto inzwischen gesperrt ist. Sperren oder löschen Sie einen Artikel oder ein Konto, löschen Sie auch die Einträge, die darauf verweisen.

## Fehlerbehebung

#### Die Aktion „Autovervollständigen" fehlt

Für den Kreditor steht die Option in der Kreditorenbezogenen Einrichtung auf **Niemals** – oder es gibt keine und die Dokumentenklasse steht auf **Niemals**.

#### Beim Import wird nichts ausgefüllt

1. Gibt es eine Kreditorenbezogene Einrichtung für den Kreditor? Dann muss dort **Automatisch** stehen – die Dokumentenklasse spielt dann keine Rolle.
2. Gibt es keine, muss die Dokumentenklasse auf **Automatisch** stehen. **Manuell** füllt beim Import nie aus.
3. Hat der Beleg eine **Bestellnr.**? Dann wird beim Import nicht ausgefüllt; führen Sie die Aktion von Hand aus.
4. Gibt es einen Eintrag? Öffnen Sie die Autovervollständigen-Einträge, gefiltert auf den Kreditor.
5. Ist die Position wirklich gleich? Vergleichen Sie SQZ Art.-Nr., SQZ Beschreibung, SQZ Mengeneinheit und SQZ Einzelpreis mit dem Beleg, aus dem gelernt wurde – meist hat sich der Preis geändert.
6. Greift eine Regel zur Zeilenkontierung? Sie läuft danach und setzt ihr eigenes Konto.

#### Ein falscher Wert wird immer wieder eingesetzt

Korrigieren Sie die Position auf dem nächsten Beleg und validieren Sie ihn – der Eintrag wird mit Ihrer Korrektur überschrieben. Alternativ ändern oder löschen Sie den Eintrag in den Autovervollständigen-Einträgen.

## Verwandte Themen

- [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung)
- [Kreditorenbezogene Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung)
- [Kontierungseinrichtungen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungseinrichtungen)
- [Kontierungen anhand von Bedingungen auswählen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kontierungen-anhand-von-bedingungen-auswahlen)
- [SQUEEZE Belegvalidierung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-belegvalidierung)

# Extension Entwicklung

In diesem Kapitel werden wichtige Integration Events und Beispiele aufgeführt, die bei der Entwicklung einer Extension für SQUEEZE for BC helfen.  
  
Wichtig:  
Anpassungen dürfen nur durch entsprechend geschulte Berater/Entwickler durchgeführt werden. Diese befinden sich außerdem immer außerhalb des Standard-Supports.

# Squeeze-Ursprungsanhang anpassen

## Übersicht

Das `OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment` Integration Event ermöglicht es Drittanbieter-Entwicklern, Dokumentenanhang-Datensätze anzupassen, bevor sie während des SQUEEZE-Anhang-Verarbeitungsworkflows modifiziert werden. Ein Ursprungsanhang ist der relevante Anhang, der zur Erstellung eines Belegs führt (z.B. die Rechnung des Lieferanten).

## Event-Deklaration

```PASCAL
[IntegrationEvent(false, false)]
local procedure OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment(var DocumentAttachment: Record "DXP Document Attachment")
begin
end;
```

## Event-Parameter

<div id="bkmrk-"><div><div><div><svg class="transition-all opacity-100 scale-100" fill="currentColor" height="14" viewbox="0 0 256 256" width="14" xmlns="http://www.w3.org/2000/svg"></svg></div></div></div></div><table class="bg-bg-100 min-w-full border-separate border-spacing-0 text-sm leading-[1.88888] whitespace-normal" id="bkmrk-parameter-typ-beschr" style="width: 815px;"><thead class="border-b-border-100/50 border-b-[0.5px] text-left"><tr class="[tbody>&]:odd:bg-bg-500/10"><th class="text-text-000 [&:not(:first-child)]:-x-[hsla(var(--border-100) / 0.5)] font-400 px-2 [&:not(:first-child)]:border-l-[0.5px]" style="width: 158px;">Parameter</th><th class="text-text-000 [&:not(:first-child)]:-x-[hsla(var(--border-100) / 0.5)] font-400 px-2 [&:not(:first-child)]:border-l-[0.5px]" style="width: 289px;">Typ</th><th class="text-text-000 [&:not(:first-child)]:-x-[hsla(var(--border-100) / 0.5)] font-400 px-2 [&:not(:first-child)]:border-l-[0.5px]" style="width: 368px;">Beschreibung</th></tr></thead><tbody><tr class="[tbody>&]:odd:bg-bg-500/10"><td class="border-t-border-100/50 [&:not(:first-child)]:-x-[hsla(var(--border-100) / 0.5)] border-t-[0.5px] px-2 [&:not(:first-child)]:border-l-[0.5px]" style="width: 158px;">DocumentAttachment</td><td class="border-t-border-100/50 [&:not(:first-child)]:-x-[hsla(var(--border-100) / 0.5)] border-t-[0.5px] px-2 [&:not(:first-child)]:border-l-[0.5px]" style="width: 289px;">`Record "DXP Document Attachment"` (var)</td><td class="border-t-border-100/50 [&:not(:first-child)]:-x-[hsla(var(--border-100) / 0.5)] border-t-[0.5px] px-2 [&:not(:first-child)]:border-l-[0.5px]" style="width: 368px;">Der Dokumentenanhang-Datensatz, der modifiziert werden soll. Als Referenz übergeben, wodurch Änderungen möglich sind.</td></tr></tbody></table>

## Wann wird dieses Event ausgelöst?

Dieses Event wird während der `SaveAttachments`-Prozedur ausgelöst, wenn:

- Ein Anhang von SQUEEZE verarbeitet wird
- Der Anhang als Ursprungsdatei identifiziert wird (`IsOriginFile = true`)
- Das System den Ursprungsdateinamen und das `DXP Is Origin File` Flag gesetzt hat
- Kurz vor dem`DocumentAttachment.Modify(true)`-Aufruf

## Anwendungsfälle

Dieses Integration Event ist nützlich für:

- **Benutzerdefiniertes Füllen von Feldern**: Setzen zusätzlicher benutzerdefinierter Felder im Dokumentenanhang
- **Dateinamen-Transformation**: Anwenden benutzerdefinierter Namenskonventionen oder Formatierung
- **Metadaten-Erweiterung**: Hinzufügen benutzerdefinierter Metadaten oder Tags zu Anhängen
- **Validierungslogik**: Implementierung benutzerdefinierter Validierung vor dem Speichern des Datensatzes
- **Integrationsanforderungen**: Vorbereitung von Daten für externe Systemintegrationen

## Implementierungsbeispiel

### Dateinamen vor Modifikation ändern

```PASCAL
[EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment', '', false, false)]
local procedure OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment(var DocumentAttachment: Record "DXP Document Attachment")
var
    CoreDocument: Record "DXP Document";
    SQZDocumentHeader: Record "DXP SQZ Document Header";
    Vendor: Record Vendor;
    NewFileName: Text[250];
    VendorPrefix: Text[50];
begin
    // Get the core document using the document attachment's Document No.
    if not CoreDocument.Get(DocumentAttachment."Document No.") then
        exit;

    // Check if the core document has a linked SQUEEZE document
    if IsNullGuid(CoreDocument."Linked-to Record Id") then
        exit;

    // Get the SQZ Document Header using the SystemId from Linked-to Record Id
    if not GetSQZDocumentHeaderFromRecordId(CoreDocument."Linked-to Record Id", SQZDocumentHeader) then
        exit;

    // Check if Buy-from Vendor No. is populated
    if SQZDocumentHeader."Buy-from Vendor No." = '' then
        exit;

    // Get the vendor record
    if not Vendor.Get(SQZDocumentHeader."Buy-from Vendor No.") then
        exit;

    // Create vendor prefix from Search Name (fallback to Name if Search Name is empty)
    if Vendor."Search Name" <> '' then
        VendorPrefix := Vendor."Search Name"
    else
        VendorPrefix := Vendor.Name;

    // Clean the vendor prefix (remove invalid filename characters and limit length)
    VendorPrefix := CleanFilenameText(VendorPrefix, 30);

    // Check if vendor prefix already exists in filename to avoid duplicates
    if DocumentAttachment."File Name".StartsWith(VendorPrefix + '_') then
        exit;

    // Create new filename with vendor prefix
    NewFileName := VendorPrefix + '_' + DocumentAttachment."File Name";

    // Update the attachment filename
    DocumentAttachment."File Name" := NewFileName;
end;

local procedure GetSQZDocumentHeaderFromRecordId(LinkedRecordId: Guid; var SQZDocumentHeader: Record "DXP SQZ Document Header"): Boolean
var
    RecRef: RecordRef;
    SystemIdFieldRef: FieldRef;
begin
    // Method 1: Try to get the record directly if LinkedRecordId is actually a SystemId
    if SQZDocumentHeader.GetBySystemId(LinkedRecordId) then
        exit(true);

    // Method 2: If that fails, we need to find the record another way
    // This assumes the Linked-to Record Id might be stored differently
    SQZDocumentHeader.Reset();
    SQZDocumentHeader.SetRange(SystemId, LinkedRecordId);
    exit(SQZDocumentHeader.FindFirst());
end;

local procedure CleanFilenameText(InputText: Text; MaxLength: Integer): Text
var
    CleanText: Text;
begin
    // Remove invalid filename characters
    CleanText := DelChr(InputText, '=', '<>|"/\:*?');
    
    // Replace spaces with underscores for better filename compatibility
    CleanText := CleanText.Replace(' ', '_');
    
    // Limit length
    CleanText := CopyStr(CleanText, 1, MaxLength);
    
    exit(CleanText);
end;
```

## Wichtige Überlegungen

### Datenintegrität

- Der `DocumentAttachment`-Datensatz wird als Referenz übergeben, daher werden alle Änderungen gespeichert
- Berücksichtigen Sie Feldlängenbegrenzungen beim Ändern von Textfeldern

### Performance

- Halten Sie die Verarbeitung schlank, da dieses Event für jeden Ursprungsdatei-Anhang aufgerufen wird
- Erwägen Sie das Zwischenspeichern häufig verwendeter Daten

### Fehlerbehandlung

- Implementieren Sie ordnungsgemäße Fehlerbehandlung, um zu verhindern, dass der Anhang-Speichervorgang fehlschlägt
- Verwenden Sie try-Funktionen für riskante Operationen

## Verwandte Events

- `OnAfterSaveAttachment`: Wird ausgelöst, nachdem jeder Anhang vollständig gespeichert wurde.
- Erwägen Sie die Verwendung dieses alternativen Events, wenn Sie Aktionen nach dem Speichern des Datensatzes durchführen müssen.

## Fehlerbehebung

Wenn Ihr Event Subscriber nicht ausgelöst wird:

- Testen Sie speziell mit Ursprungsdateien (Nicht-Ursprungsdateien lösen dieses Event nicht aus)

# Abweichende Verwendung der SQUEEZE Anhänge

Im Folgenden wird kurz erläutert, wie die durch SQUEEZE for BC heruntergeladenen Anhänge für ein Szenario verwendet werden können, das von der vorgesehenen Verwendung abweicht.

Nach der Erstellung des Einkaufsbeleges aus dem validierten SQUEEZE Beleg haben Sie die Möglichkeit, die Anhänge abzugreifen (sofern diese im Vorfeld heruntergeladen wurden).

```C#
    // Set IsHandled to true and implement your code
    // Do not forget to deactivate "Transfer attachments to target document" in the Document Class Setup
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Mgt.", 'OnBeforeTransferCoreAttachmentsToStandardDocument', '', false, false)]
    local procedure DXPDocMgtOnBeforeTransferCoreAttachmentsToStandardDocument(Document: Record "DXP Document"; var IsHandled: Boolean)
    begin
    	IsHandled := true;
        HandleCoreAttachmentsAccordingToYourNeeds(Document, IsHandled);
    end;

    procedure HandleCoreAttachmentsAccordingToYourNeeds(Document: Record "DXP Document"; var IsHandled: Boolean)
    var
        CoreAttachments: Record "DXP Document Attachment";
        InStr: InStream;
    begin
        CoreAttachments.SetRange("Document No.", Document."No.");
        CoreAttachments.IsEmpty() then
       		exit;
        CoreAttachments.FindSet();
        repeat
            CoreAttachments.Calcfields(Attachment);
            CoreAttachments.Attachment.CreateInStream(InStr);
            // Here you can handle the file stream according to your needs
         	[...]
        until CoreAttachments.Next() = 0;
    end;
```

# Anpassung der Dateinamen von Anhängen nach der Validierung

## <a id="bkmrk-"></a>Überblick

Diese Anleitung zeigt, wie Entwickler die Dateinamen von Anhängen in DEXPRO SQUEEZE anpassen können. Das Event `OnBeforeAddLineToDocumentJObj` wird **nach der Plausibilitätsprüfung** ausgeführt, sodass alle Belegdaten vollständig validiert und verfügbar sind.

## <a id="bkmrk--0"></a>Verfügbares Event

### <a id="bkmrk--1"></a>OnBeforeAddLineToDocumentJObj

**Für Rechnungen/Gutschriften:** `Codeunit 70954657 "DXP SQZ P. Inv/Crdt Memo Impl."`  
**Für Bestellbestätigungen:** `Codeunit 70954658 "DXP SQZ P. Order Conf. Impl."`

**Wann aufgerufen:** Nach Header-Verarbeitung, vor Zeilen-Verarbeitung, **nach Plausibilitätsprüfung**

## <a id="bkmrk--3"></a>Implementierungsbeispiele

### <a id="bkmrk--4"></a>Beispiel 1: Einfacher Kreditorenprefix für Rechnungen/Gutschriften

```PASCAL
codeunit 50100 "Custom Invoice Filename"
{
        [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnBeforeAddLineToDocumentJObj', '', false, false)]
    local procedure OnBeforeAddLineToDocumentJObjInvoice(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")
    begin
        CustomizeAttachmentFilenames(DocHeader);
    end;

    local procedure CustomizeAttachmentFilenames(DocHeader: Record "DXP SQZ Document Header")
    var
        DocumentAttachment: Record "DXP Document Attachment";
        VendorPrefix: Text;
        NewFileName: Text[1024];
    begin
        // Beenden, wenn keine Kreditorinformationen vorhanden
        if DocHeader."Buy-from Vendor No." = '' then
            exit;

        // Kreditorenprefix erstellen
        VendorPrefix := DocHeader."Buy-from Vendor No." + '_';

        // Alle Anhänge für dieses Dokument bearbeiten
        DocumentAttachment.Reset();
        DocumentAttachment.SetRange("Document No.", DocHeader."Core Document No.");

        if DocumentAttachment.FindSet(true) then
            repeat
                // Überspringen, wenn Prefix bereits vorhanden
                if not DocumentAttachment."File Name".Contains(VendorPrefix) then begin
                    // Neuen Dateinamen mit Prefix erstellen
                    NewFileName := VendorPrefix + DocumentAttachment."File Name";

                    // Aktualisieren
                    DocumentAttachment."File Name" := CopyStr(NewFileName, 1, MaxStrLen(DocumentAttachment."File Name"));
                    DocumentAttachment.Modify(true);
                end;
            until DocumentAttachment.Next() = 0;
    end;
}


```

### <a id="bkmrk--5"></a>Beispiel 2: Bestellbestätigungen - Kreditorenprefix

```PASCAL
codeunit 50101 "Custom Order Conf Filename"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Order Conf. Impl.", 'OnBeforeAddLineToDocumentJObj', '', false, false)]
    local procedure OnBeforeAddLineToDocumentJObjOrderConf(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")
    begin
        CustomizeAttachmentFilenames(DocHeader);
    end;

    local procedure CustomizeAttachmentFilenames(DocHeader: Record "DXP SQZ Document Header")
    var
        DocumentAttachment: Record "DXP Document Attachment";
        VendorPrefix: Text;
        NewFileName: Text[1024];
    begin
        // Beenden, wenn keine Kreditorinformationen vorhanden
        if DocHeader."Buy-from Vendor No." = '' then
            exit;

        // Kreditorenprefix erstellen
        VendorPrefix := DocHeader."Buy-from Vendor No." + '_';

        // Alle Anhänge für dieses Dokument bearbeiten
        DocumentAttachment.Reset();
        DocumentAttachment.SetRange("Document No.", DocHeader."Core Document No.");

        if DocumentAttachment.FindSet(true) then
            repeat
                // Überspringen, wenn Prefix bereits vorhanden
                if not DocumentAttachment."File Name".Contains(VendorPrefix) then begin
                    // Neuen Dateinamen mit Prefix erstellen
                    NewFileName := VendorPrefix + DocumentAttachment."File Name";

                    // Aktualisieren
                    DocumentAttachment."File Name" := CopyStr(NewFileName, 1, MaxStrLen(DocumentAttachment."File Name"));
                    DocumentAttachment.Modify(true);
                end;
            until DocumentAttachment.Next() = 0;
    end;
}


```

### <a id="bkmrk--6"></a>Beispiel 3: Beide Dokumenttypen - Verschiedene Prefixe für Quelldateien

```PASCAL
codeunit 50102 "Advanced Filename Handling"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnBeforeAddLineToDocumentJObj', '', false, false)]
    local procedure OnBeforeAddLineToDocumentJObjInvoice(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")
    begin
        CustomizeFilenamesWithSourceHandling(DocHeader);
    end;

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Order Conf. Impl.", 'OnBeforeAddLineToDocumentJObj', '', false, false)]
    local procedure OnBeforeAddLineToDocumentJObjOrderConf(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")
    begin
        CustomizeFilenamesWithSourceHandling(DocHeader);
    end;

    local procedure CustomizeAttachmentFilenames(DocHeader: Record "DXP SQZ Document Header")
    var
        DocumentAttachment: Record "DXP Document Attachment";
        VendorPrefix: Text;
        NewFileName: Text[1024];
    begin
        // Beenden, wenn keine Kreditorinformationen vorhanden
        if DocHeader."Buy-from Vendor No." = '' then
            exit;

        // Kreditorenprefix erstellen
        VendorPrefix := DocHeader."Buy-from Vendor No." + '_';

        // Alle Anhänge für dieses Dokument bearbeiten
        DocumentAttachment.Reset();
        DocumentAttachment.SetRange("Document No.", DocHeader."Core Document No.");

        if DocumentAttachment.FindSet(true) then
            repeat
                // Überspringen, wenn Prefix bereits vorhanden
                if not DocumentAttachment."File Name".Contains(VendorPrefix) then begin
                    // Neuen Dateinamen mit Prefix erstellen
                    NewFileName := VendorPrefix + DocumentAttachment."File Name";

                    // Aktualisieren
                    DocumentAttachment."File Name" := CopyStr(NewFileName, 1, MaxStrLen(DocumentAttachment."File Name"));
                    DocumentAttachment.Modify(true);
                end;
            until DocumentAttachment.Next() = 0;
    end;
}


```

## <a id="bkmrk--7"></a>Praktische Hinweise

### <a id="bkmrk--8"></a>Verfügbare Daten zur Event-Zeit:

- `DocHeader."Buy-from Vendor No."` - Kreditorennummer (validiert)
- `DocHeader."Document Date"` - Belegdatum
- `DocHeader."Document Reference"` - Belegnummer
- `DocHeader."Core Document No."` - Verknüpfung zu Anhängen
- Alle anderen Belegfelder sind verfügbar

### <a id="bkmrk--9"></a>Beispielresultate:

- **Original**: `"Rechnung_2024_001.pdf"`
- **Mit Kreditorenprefix**: `"VEND001_Rechnung_2024_001.pdf"`
- **Quelldatei**: `"ORIGINAL_VEND001_Rechnung_2024_001.pdf"`

### <a id="bkmrk--10"></a>Best Practices:

- **Duplikatprüfung**: Immer prüfen, ob Prefix bereits vorhanden
- **Längenvalidierung**: Neue Dateinamen dürfen max. 1024 Zeichen haben

# Hinzufügen eines Feldes in der Validierung (ab Version 2.10)

Im Folgenden wird anhand einer Beispielextension dargestellt, wie man als Entwickler Felder in der Validierung hinzufügen kann (hier: Dokumentenklasse Rechnung/Gutschrift).

#### Optionale Integration Events inkl. beispielhafter Prozeduren:

<div id="bkmrk-"></div>```Powershell
codeunit 50100 EventSubs
{
    //
    // [If you want to perform plausibility checks on the newly added header field, this is the place]
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnAfterDoHeaderPlausibilityChecks', '', false, false)]
    local procedure SQZPInvCrdtMemoImplOnBeforeDoHeaderPlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
    begin
        CheckCustomer(PlausibilityCheck, DocHeader."Customer No.");
    end;

    // 
    // [If you want to perform plausibility checks on the newly added line field, this is the place]
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnAfterDoLinePlausibilityChecks', '', false, false)]
    local procedure SQZPInvCrdtMemoImplOnAfterDoLinePlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; DocLine: Record "DXP SQZ Document Line"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
    begin
        CheckCustomer(PlausibilityCheck, DocLine."Customer No.");
    end;

    [TryFunction]
    local procedure CustomerExists(CustomerNo: Code[20])
    var
        Customer: Record Customer;
    begin
        Customer.Get(CustomerNo);
    end;

    local procedure CheckCustomer(var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt."; CustomerNo: Code[20]): Boolean
    begin
        if CustomerNo = '' then
            exit(false);

        if not CustomerExists(CustomerNo) then begin
            PlausibilityCheck.AddPlausibilityCheckEntry(GetLastErrorText(), Page::"Customer List");
            exit(false);
        end;

        exit(true);
    end;
}
```

#### Table Extensions:

##### SQUEEZE 4 BC

```Python
tableextension 50100 "SQZ Doc. Header Ext." extends "DXP SQZ Document Header"
{
    fields
    {
        field(50100; "Customer No."; Code[20])
        {
            TableRelation = Customer;
            ValidateTableRelation = false;
            Caption = 'Customer No.';
        }
    }
}
```

```Python
tableextension 50101 "SQZ Doc. Line Ext." extends "DXP SQZ Document Line"
{
    fields
    {
        field(50100; "Customer No."; Code[20])
        {
            TableRelation = Customer;
            ValidateTableRelation = false;
            Caption = 'Customer No.';
        }
    }
}
```

##### Zielbeleg (hier: Einkaufsbeleg)

```Python
tableextension 50102 "Purchase Header Ext." extends "Purchase Header"
{
    fields
    {
        field(50100; "DXP Customer No."; Code[20])
        {
            DataClassification = CustomerContent;
            TableRelation = Customer;
            Caption = 'DEXPRO Customer No.';
        }
    }
}
```

#### Page Extensions:

##### SQUEEZE 4 BC

```Python
pageextension 50100 "SQZ Document Ext." extends "DXP SQZ Document v2"
{
    layout
    {
        addafter(BuyFromVendorInternal)
        {
            field("Customer No. Internal"; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
              	//The following code is optional. It is used to highlight a recognized value in the Squeeze Viewer
                trigger OnAssistEdit()
                begin
                    MarkField(Rec.FieldNo("Customer No."), Rec."Customer No.", Rec);
                end;

                trigger OnValidate()
                begin
                    CheckPlausibility();
                end;
            }
        }
        addafter(BuyFromVendorExternal)
        {
            field("Customer No."; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
                //The following code is optional. It is used to highlight a recognized value in the Squeeze Viewer
                trigger OnAssistEdit()
                var
                    ApiMgt: Codeunit "DXP SQZ API Mgt.";
                    ViewerResident: Codeunit "DXP SQUEEZE Viewer Resident";
                begin
                    MarkField(Rec.FieldNo("Customer No."), Rec."Customer No.", Rec);
                end;

                trigger OnValidate()
                begin
                    CheckPlausibility();
                end;
            }
        }
    }

    local procedure MarkField(AppFldNo: Integer; FieldVal: Variant; DocHeader: Record "DXP SQZ Document Header")
    var
        ApiMgt: Codeunit "DXP SQZ API Mgt.";
        ViewerResident: Codeunit "DXP SQUEEZE Viewer Resident";
    begin
        ViewerResident := GetViewerResident();
        ApiMgt.MarkField(AppFldNo, FieldVal, ViewerResident, DocHeader);
    end;
}

```

```Python
pageextension 50101 "SQZ Document Sf. Ext." extends "DXP SQZ Document Subform"
{
    layout
    {
        addafter("No.")
        {
            field("Customer No."; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
            }
        }
    }
}

```

##### Zielbeleg (hier: Einkaufsbeleg)

```Python
pageextension 50102 "Purchase Invoice Ext." extends "Purchase Invoice"
{
    layout
    {
        addafter("Buy-from Vendor No.")
        {
            field("DXP Customer No."; Rec."DXP Customer No.")
            {
                ToolTip = 'Specifies the value of the DEXPRO Customer No. field.';
                ApplicationArea = all;
            }
        }
    }
}

```

```Python
pageextension 50103 "Purchase Inv. Sf Ext." extends "Purch. Invoice Subform"
{
    layout
    {
        addafter("No.")
        {
            field("DXP Customer No."; Rec."DXP Customer No.")
            {
                ToolTip = 'Specifies the value of the DEXPRO Customer No. field.';
                ApplicationArea = all;
            }
        }
    }
}

```

# Implementierung eines benutzerdefinierten, automatischen Bestellabgleichs

## Einführung

Der automatische Bestellabgleich ist ein wichtiger Bestandteil der Dokumentenverarbeitung in Squeeze for Business Central. Im Standard vergleicht das System eingehende Belege mit vorhandenen Bestellungen und Wareneingängen. Diese Dokumentation zeigt Ihnen, wie Sie diesen Abgleichsprozess um Ihre eigenen Belegarten erweitern können.

Die Standardimplementierung verwendet einen dreistufigen Prozess:

1. Sammeln relevanter Belegnummern basierend auf Geschäftsregeln
2. Für jede gefundene Belegnummer wird ein detaillierter Abgleich durchgeführt
3. Im Anschluss werden die von Squeeze ausgelesenen Positionen um die gefundenen Daten angereichert

Diesen bewährten Ansatz werden wir in der folgenden, beispielhaften Implementierung beibehalten.

## Integrationspunkt

Der zentrale Integrationspunkt ist das `OnBeforePerformAutomaticOrdermatch`-Event in Codeunit 70954632 "DXP SQZ Document Mgt.". Dieses Event wird nach der Erstellung von Kopf- und Positionsdaten aufgerufen.

```PASCAL
[IntegrationEvent(false, false)]
local procedure OnBeforePerformAutomaticOrdermatch(
    DocHeader: Record "DXP SQZ Document Header"; 
    var OrderNoList: List of [Code[20]]; 
    var IsHandled: Boolean)

```

### Parameter

- `DocHeader`: Der Dokumentenkopf mit den zu vergleichenden Daten
- `OrderNoList`: Eine Liste von Belegnummern für den Abgleich
- `IsHandled`: Steuert, ob die Standardverarbeitung übersprungen werden soll

## Implementierungsbeispiel

## Technische Umsetzung

### 1. Erweiterung des Dokumententyp-Enums

Zunächst erweitern wir die möglichen Dokumententypen um unseren eigenen Typ:

```PASCAL
enumextension 50100 "Custom Order Match Doc. Type" extends "DXP Order Match Document Type"
{
    value(50000; "Custom")
    {
        Caption = 'Custom Document';
    }
}
```

### 2. Implementierung der Abgleichslogik

Der zentrale Punkt unserer Implementierung ist eine Codeunit, die den Abgleichsprozess steuert. Integrationspunkt ist :

```PASCAL
//codeunit 50100 "Custom Document Matching"
//{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforePerformAutomaticOrdermatch', '', false, false)]
    local procedure OnBeforePerformAutomaticOrdermatch(
        DocHeader: Record "DXP SQZ Document Header";
        var OrderNoList: List of [Code[20]];
        var IsHandled: Boolean)
    var
        CustomSourceDoc: Record "Custom Source Document";
        CustomDocNo: Code[20];
    begin
        // Take control of the matching process and prevent standard processing
        IsHandled := true;
        
        // Find potential matching documents
        CustomSourceDoc.SetRange("Vendor No.", DocHeader."Buy-from Vendor No.");
        // Add your specific document status or type filters
        CustomSourceDoc.SetRange("Document Type", CustomSourceDoc."Document Type"::Order);
        CustomSourceDoc.SetRange(Status, CustomSourceDoc.Status::Released);
        
        // Add matching document numbers to the list
        if CustomSourceDoc.FindSet() then
            repeat
            	CustomDocNo := CustomSourceDoc."No.";
                if IsDocumentEligibleForMatching(CustomSourceDoc, DocHeader) then
                	if not OrderNoList.Contains(CustomDocNo) then
                    	OrderNoList.Add(CustomDocNo);
            until CustomSourceDoc.Next() = 0;

        // Process all collected documents
        ProcessMatchingDocuments(DocHeader, OrderNoList);
    end;

    local procedure IsDocumentEligibleForMatching(
        CustomSourceDoc: Record "Custom Source Document";
        DocHeader: Record "DXP SQZ Document Header"): Boolean
    begin
        // Implement business rules for document selection
        // For example:
        if CustomSourceDoc."Document Date" > DocHeader."Document Date" then
            exit(false);

        if CustomSourceDoc."Currency Code" <> DocHeader."Currency Code" then
            exit(false);

        // Check for open lines that can be matched
        if not HasOpenLinesToMatch(CustomSourceDoc) then
            exit(false);

        exit(true);
    end;

    local procedure HasOpenLinesToMatch(CustomSourceDoc: Record "Custom Source Document"): Boolean
    var
        CustomSourceLine: Record "Custom Source Line";
    begin
        CustomSourceLine.SetRange("Document No.", CustomSourceDoc."No.");
        CustomSourceLine.SetFilter("Outstanding Quantity", '>0');
        exit(not CustomSourceLine.IsEmpty());
    end;
//}
```

### 3. Verarbeitung der gefundenen Belege

Nach dem Sammeln der relevanten Belegnummern erfolgt der eigentliche Abgleich:

```PASCAL
local procedure ProcessMatchingDocuments(
    DocHeader: Record "DXP SQZ Document Header";
    OrderNoList: List of [Code[20]])
var
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary;
    OrderNo: Code[20];
begin
    foreach OrderNo in OrderNoList do begin
        // Get matching entries for current document
        GetMatchEntries(OrderNo, TempMatchEntry, DocHeader);
        
        if not TempMatchEntry.IsEmpty() then
            // Try to find and assign matching lines
            TryMatchDocumentLines(TempMatchEntry, DocHeader);
    end;
end;

local procedure GetMatchEntries(
    DocumentNo: Code[20];
    var TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary;
    DocHeader: Record "DXP SQZ Document Header")
var
    CustomSourceLine: Record "Custom Source Line";
begin
    TempMatchEntry.Reset();
    TempMatchEntry.DeleteAll();

    // Get lines from custom document
    CustomSourceLine.SetRange("Document No.", DocumentNo);
    
    if CustomSourceLine.FindSet() then
        repeat
            // Create match entry for each relevant line
            CreateMatchEntry(CustomSourceLine, TempMatchEntry);
        until CustomSourceLine.Next() = 0;
end;

local procedure CreateMatchEntry(
    CustomSourceLine: Record "Custom Source Line";
    var TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary)
begin
    TempMatchEntry.Init();
    TempMatchEntry."Document Type" := "DXP Order Match Document Type"::Custom;
    TempMatchEntry."Document No." := CustomSourceLine."Document No.";
    TempMatchEntry."Document Line No." := CustomSourceLine."Line No.";
    TempMatchEntry."No." := CustomSourceLine."Item No.";
    TempMatchEntry.Quantity := CustomSourceLine.Quantity;
    TempMatchEntry."Direct Unit Cost" := CustomSourceLine."Unit Price";
    TempMatchEntry."Line Amount" := CustomSourceLine.Amount;
    TempMatchEntry.Insert();
end;

```

## Die Matching-Logik im Detail

Der eigentliche Abgleich der Belegzeilen erfolgt nach definierten Geschäftsregeln:

```PASCAL
local procedure TryMatchDocumentLines(
    var TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary;
    DocHeader: Record "DXP SQZ Document Header")
var
    DocLine: Record "DXP SQZ Document Line";
    MatchSetup: Record "Custom Match Setup";
    HasCustomSetup: Boolean;
begin
    // Get configuration
    MatchSetup.Get();
    
    // Process each potential match entry
    if TempMatchEntry.FindSet() then
        repeat
            DocLine.Reset();
            DocLine.SetRange("Document No.", DocHeader."No.");
            DocLine.SetRange("Buy-from Vendor No.", TempMatchEntry."Buy-from Vendor No.");
            DocLine.SetFilter("Allocated Document Line No.", '%1', 0); // Only unallocated lines
            
            // Try matching strategies in order of precision
            if TryExactMatch(DocLine, TempMatchEntry) then
                CheckTolerancesAndAllocate(TempMatchEntry, DocLine, MatchSetup)
            else
                if TryItemReferenceMatch(DocLine, TempMatchEntry) then
                    CheckTolerancesAndAllocate(TempMatchEntry, DocLine, MatchSetup)
                else
                    if TryDescriptionMatch(DocLine, TempMatchEntry) then
                        CheckTolerancesAndAllocate(TempMatchEntry, DocLine, MatchSetup)
                    else
                        if TryBasicValuesMatch(DocLine, TempMatchEntry) then
                            CheckTolerancesAndAllocate(TempMatchEntry, DocLine, MatchSetup);
        until TempMatchEntry.Next() = 0;
end;

local procedure TryExactMatch(
    var DocLine: Record "DXP SQZ Document Line";
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary): Boolean
begin
    DocLine.SetRange(Type, TempMatchEntry.Type);
    DocLine.SetFilter("No.", '%1|%2', TempMatchEntry."No.", TempMatchEntry."Item Reference No.");
    DocLine.SetRange("SQZ Quantity", TempMatchEntry.Quantity);
    
    exit(not DocLine.IsEmpty());
end;

local procedure TryItemReferenceMatch(
    var DocLine: Record "DXP SQZ Document Line";
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary): Boolean
begin
    DocLine.SetRange(Type);  // Clear previous filters
    DocLine.SetRange("Item Reference No.", TempMatchEntry."Item Reference No.");
    
    exit(not DocLine.IsEmpty());
end;

local procedure TryDescriptionMatch(
    var DocLine: Record "DXP SQZ Document Line";
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary): Boolean
begin
    DocLine.SetRange("Item Reference No."); // Clear previous filter
    DocLine.SetFilter("SQZ Description", '@*' + TempMatchEntry.Description + '*');
    
    exit(not DocLine.IsEmpty());
end;

local procedure TryBasicValuesMatch(
    var DocLine: Record "DXP SQZ Document Line";
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary): Boolean
begin
    DocLine.SetRange("SQZ Description");  // Clear previous filter
    DocLine.SetRange("SQZ Quantity", TempMatchEntry.Quantity);
    DocLine.SetRange("SQZ Unit Price", TempMatchEntry."Direct Unit Cost");
    
    exit(not DocLine.IsEmpty());
end;

local procedure CheckTolerancesAndAllocate(
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary;
    var DocLine: Record "DXP SQZ Document Line";
    MatchSetup: Record "Custom Match Setup")
begin
    DocLine.FindFirst();  // We know there is at least one line
    
    if IsMatchWithinTolerances(DocLine, TempMatchEntry, MatchSetup) then
        AssignMatchData(DocLine, TempMatchEntry);
end;

local procedure IsMatchWithinTolerances(
    DocLine: Record "DXP SQZ Document Line";
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary;
    MatchSetup: Record "Custom Match Setup"): Boolean
var
    QtyTolerance: Decimal;
    AmountTolerance: Decimal;
begin
    QtyTolerance := MatchSetup."Quantity Tolerance";
    AmountTolerance := MatchSetup."Amount Tolerance";
    
    if Abs(DocLine."SQZ Quantity" - TempMatchEntry.Quantity) > QtyTolerance then
        exit(false);
        
    if Abs(DocLine."SQZ Unit Price" - TempMatchEntry."Direct Unit Cost") > AmountTolerance then
        exit(false);
        
    exit(true);
end;

local procedure AssignMatchData(
    var DocLine: Record "DXP SQZ Document Line";
    TempMatchEntry: Record "DXP SQZ Order Match Entry" temporary)
begin
    // Assign the matched data to the document line
    DocLine.Validate("Allocated Document Type", "DXP Order Match Document Type"::Custom);
    DocLine.Validate("Allocated Document No.", TempMatchEntry."Document No.");
    DocLine.Validate("Allocated Document Line No.", TempMatchEntry."Document Line No.");
    DocLine.Validate("Allocated Quantity", TempMatchEntry.Quantity);
    DocLine.Validate("Allocated Unit Price", TempMatchEntry."Direct Unit Cost");
    DocLine.Validate("Allocated Line Amount", TempMatchEntry."Line Amount");
    DocLine.Validate("Allocated Line Discount %", TempMatchEntry."Line Discount %");
    DocLine.Modify(true);
end;

```

Bei Fragen zur Implementierung stehen wir Ihnen gerne zur Verfügung.

# Implementierung einer neuen, generischen Dokumentenklasse

## SQUEEZE → Core → Ihre Verarbeitung

Dieser Leitfaden ist bewusst fokussiert und pipeline‑orientiert: Er zeigt, wie Belegdaten aus **SQUEEZE** heruntergeladen, in Warteschlangen verarbeitet und in **DEXPRO Core** persistiert werden – und an welcher Stelle sich eine Drittanbieter‑Extension einklinkt.

Begriff: In diesem Leitfaden meint „SQUEEZE‑App“ die Business‑Central‑Erweiterung, die mit der SQUEEZE API verbunden ist und den Import nach DEXPRO Core steuert.

Annahmen:

- Drittanbieter‑Entwickler arbeiten typischerweise mit **veröffentlichten Symbolen**, nicht mit dem gesamten Quellcode.
- Die SQUEEZE‑App übernimmt **Herunterladen + Importwarteschlange + Erstellung des Core‑Belegs sowie die rudimentäre Erstellung des SQUEEZE‑Belegs unter Berücksichtigung der Feldzuordnung**, sobald die Einrichtung abgeschlossen ist.
- Ihre Extension übernimmt die Fachlogik, nachdem das Core‑Dokument existiert: Quell‑Datensätze erstellen bzw. erweitern, validieren, „Processed JSON“ erzeugen und optional ein eigenes Zielobjekt oder einen eigenen Beleg erstellen.

---

## 1) Der Ende‑zu‑Ende‑Ablauf SQUEEZE → Core

Sobald Dokumentklasse und Einrichtung konfiguriert sind, läuft die Importpipeline der SQUEEZE‑App typischerweise so ab:

1. **`DXP Document Class` erweitern** und Ihre Implementierung binden: `DXP ISource Document`.
2. **Dokumentenklassen‑Einrichtung** für diese Klasse konfigurieren. 
    - Beim Validieren von `DXP SQZ Document Class ID` holt die SQUEEZE‑App automatisch die benötigten Einrichtungswerte aus SQUEEZE (z. B. `DXP SQZ Export Interface ID` und `DXP SQZ Line Table ID`) und füllt sie.
3. Der Job der SQUEEZE‑App ruft `DXP SQZ API Mgt.DownloadDocumentData()` auf. Auch via "Belege herunterladen" aufrufbar 
    - Dabei werden neue Einträge in `DXP SQZ Import Queue` angelegt (Dokument‑ID + Zielmandant).
4. Die SQUEEZE‑App ruft `DXP SQZ Import Queue Mgt.TransferImportQueueEntries()` auf. 
    - Dabei wird die Orchestrierungs‑Codeunit `DXP Sqz Create Document` für die Einträge in der Importwarteschlange ausgeführt.
5. `DXP SQZ API Mgt.CreateCoreAndSQUEEZEDocument(DocClass, DocumentId)` lädt das vollständige JSON. 
    - Es wird `DXP Document Mgt.AddDocument(DocClass, DocumentId, RawJson, …)` aufgerufen.
    - Ergebnis: Ein `DXP Document`‑Datensatz existiert. Status = `Imported`, `JSON Raw` ist gefüllt.
6. Die SQUEEZE‑App ruft Ihre Implementierung `ISourceDocument.CreateSource(Document)` auf. 
    - Ab hier beginnt Ihre Implementierung.

Nach Schritt 6 haben Sie:

- Ein Core‑Container‑Dokument (`DXP Document`).
- Ein SQUEEZE‑Dokument auf Seite der SQUEEZE‑App.
- Ihre Source‑Datensätze sollten existieren, sobald `CreateSource` erfolgreich abgeschlossen ist.

---

## 2) Was Sie implementieren (Interfaces)

### Quell‑Vertrag, also Squeeze Seite: `DXP ISource Document`

Das implementieren Sie, um:

- Ihre editierbaren Source‑Datensätze aus `DXP Document.JSON Raw` zu erstellen
- Source‑Datensätze zu validieren
- „Processed JSON“ zu erzeugen und an Core‑Processing zu übergeben

### Ziel‑Vertrag, also Zielbeleg: `DXP IDocument Processing`

Das implementieren Sie, wenn Core aus dem „Processed JSON“ **einen eigenen Ziel‑Datensatz** (Ihre eigene Tabelle / Ihr eigenes Dokument) erstellen/aktualisieren soll.

---

## 3) Schritt 1 — Dokumentklasse definieren und Quell‑Implementierung zuweisen

Erstellen Sie eine Enum‑Extension und binden Sie Ihre Source‑Implementierung:

```al
enumextension 50100 "MY Document Class Ext." extends "DXP Document Class"
{
    value(50100; "MY Generic Document")
    {
        Caption = 'My Generic Document';
        Implementation = "DXP ISource Document" = "MY Source Document Impl.";
    }
}

```

---

## 4) Schritt 2 — Dokumentenklassen‑Einrichtung konfigurieren (damit die Importwarteschlange gefüllt wird)

Konfigurieren Sie in der **Dokumentenklassen‑Einrichtung** für Ihre neue Dokumentklasse die SQUEEZE‑spezifischen Felder.

Wichtig:

- Das Validieren von `DXP SQZ Document Class ID` triggert das automatische Laden der erforderlichen Konfiguration aus SQUEEZE (z. B. `DXP SQZ Export Interface ID` und `DXP SQZ Line Table ID`).
- Falls der Abruf fehlschlägt, werden diese API‑abgeleiteten Felder wieder geleert.

Ergebnis: Die SQUEEZE‑App kann `DownloadDocumentData()` ausführen und Einträge in `DXP SQZ Import Queue` für Ihre Klasse anlegen.

---

## 5) Schritt 3 — Feldzuordnung sicherstellen (heruntergeladene Zuordnung + Ihre Standardwerte)

Die SQUEEZE‑App kann den Feldkatalog des angeschlossenen Squeeze Mandanten herunterladen und in Core‑Mapping‑Tabellen persistieren (pro Dokumentklasse).

Ihre Rolle als Dokumentklassen‑Implementierer:

- Standard‑Feldzuordnung „Squeeze Field Name → AL Field No.“ via `InitFieldMapping(...)` bereitstellen.
- Alternativ Felder über die Zuordnungs‑Pages mappen (Benutzerdefinierte Feldzuordnung).

### 5.1 `InitFieldMapping` implementieren (eigenständiges Beispiel)

```al
codeunit 50101 "MY Source Document Impl." implements "DXP ISource Document"
{
    procedure InitFieldMapping(var HeaderMapping: Dictionary of [Text, Integer]; var LineMapping: Dictionary of [Text, Integer])
    var
        Header: Record "DXP SQZ Document Header";
        Line: Record "DXP SQZ Document Line";
    begin
        Clear(HeaderMapping);
        Clear(LineMapping);

        // Header fields
        HeaderMapping.Add('vendorNo', Header.FieldNo("Buy-from Vendor No."));
        HeaderMapping.Add('documentDate', Header.FieldNo("Document Date"));
        HeaderMapping.Add('postingDate', Header.FieldNo("Posting Date"));
        HeaderMapping.Add('reference', Header.FieldNo("Document Reference"));

        // Line fields
        LineMapping.Add('description', Line.FieldNo(Description));
        LineMapping.Add('quantity', Line.FieldNo(Quantity));
        LineMapping.Add('unitPrice', Line.FieldNo("Direct Unit Cost"));
    end;

    // other interface methods omitted here...
}

```

### 5.2 Validierungs‑Schalter beim Zuweisen von Feldern: App‑Feld validieren

Wenn die SQUEEZE‑App oder Ihre Quell‑Erstelllogik JSON‑Werte in „App-/Quellfelder“ schreibt, können Sie steuern, ob der **OnValidate‑Trigger** ausgeführt wird.

In `DXP Custom Field Mapping`:

- `Validate App Field` = App‑Feld während des Assignments validieren.
- `Validate` (Ziel) = Validierung beim Transfer in das Ziel‑Feld ausführen.

Nutzen Sie das z. B. wenn Erweiterungsfelder Business‑Logik in `OnValidate` haben oder wenn Sie bewusst trigger‑frei (performanter) zuweisen wollen.

---

## 6) Schritt 4 — Source‑Datensätze in `CreateSource` erstellen

`CreateSource(Document)` wird von der SQUEEZE‑App unmittelbar nach `DXP Document Mgt.AddDocument(...)` aufgerufen, sobald der Core‑Container‑Datensatz existiert.

Minimale Verantwortlichkeiten:

1. `DXP Document.JSON Raw` lesen.
2. SQUEEZE‑Source‑Header/Lines erstellen (`DXP SQZ Document Header` / `DXP SQZ Document Line`).
3. Core‑Dokument mit dem SQUEEZE‑Source‑Header via `UpdateDocumentAfterTransfer` verknüpfen.

Optional (empfohlen, wenn Sie Gleichwertigkeit der Funktionen zu den Standard‑SQUEEZE‑Dokumentklassen möchten): 4) Anhänge herunterladen, wenn `DXP Download Attachments` aktiv ist. 5) Automatische Validierung ausführen, wenn für das Dokument aktiviert.

### 6.1 Beispiel: SQUEEZE‑Header + Lines mit den generischen Helpern erstellen

Was die Helper machen (damit Sie es nicht doppelt implementieren):

- `SqzDocumentMgt.CreateSQUEEZEDocHeader(Document, DocHeader, RawJson)`
    
    
    - Erstellt genau einen Datensatz in `DXP SQZ Document Header` für das Core‑Dokument (`DXP Document`).
    - Setzt Identifikationsfelder wie `Core Document No.` und die SQUEEZE‑`API Document ID`.
    - Weist Header‑Felder aus JSON anhand der konfigurierten Zuordnungen zu: 
        - `DXP Field Mapping` (Feldzuordnung)
        - `DXP Custom Field Mapping` (Benutzerdefinierte Feldzuordnung)
    - Respektiert `DXP Custom Field Mapping.Validate App Field` und entscheidet damit, ob beim Zuweisen der **OnValidate‑Trigger** ausgeführt wird.
    - Führt das Integration‑Event `OnBeforeModifySQUEEZEDocumentHeader(...)` als Extension‑Hook aus.
    - Für die eingebauten Standard‑SQUEEZE‑Klassen wird zusätzlich Standard‑Post‑Processing ausgeführt (z. B. alternative IBAN/USt‑ID‑Ermittlung, Lieferantenaktualisierung, Standard‑Buchungsdatum, Duplikatsprüfung).
- `SqzDocumentMgt.CreateSQUEEZEDocLine(DocHeader, RawJson)`
    
    
    - Erstellt die `DXP SQZ Document Line`‑Datensätze basierend auf den JSON‑Rows.
    - Weist Line‑Felder nach dem gleichen Mapping‑Prinzip zu (Standard + Custom; optional mit Validierungstriggern).
    - Befüllt `Core Document No.` auf den Lines.
    - Für Standard‑SQUEEZE‑Klassen wird zusätzlich Standard‑Line‑Post‑Processing angewendet (z. B. Übertragung erkannter Werte).
    - Persistiert line‑bezogene Hilfsdaten (z. B. Koordinaten/Metadaten, die UI und Matching‑Logik nutzen).

```al
procedure CreateSource(Document: Record "DXP Document"): Boolean
var
    DocClassSetup: Record "DXP Document Class Setup";
    AutoValidationMgt: Codeunit "DXP Automatic Validation Mgt.";
    JsonHelper: Codeunit "DXP Json Helper";
    DocMgt: Codeunit "DXP Document Mgt.";
    SqzDocumentMgt: Codeunit "DXP SQZ Document Mgt.";
    SqzApiMgt: Codeunit "DXP SQZ API Mgt.";
    RawJson: JsonObject;
    DocHeader: Record "DXP SQZ Document Header";
    AutomaticValidation: Boolean;
begin
    if (not Document."JSON Raw".HasValue()) or (Document.Status <> Document.Status::Imported) then
        exit(false);

    // 1) Unverarbeitetes JSON lesen
    RawJson := JsonHelper.JObjectFromBlob(Document.RecordId(), Document.FieldNo("JSON Raw"));

    // 2) SQUEEZE‑Source‑Dokument mit den generischen Hilfsfunktionen erstellen
    //    (Feldzuordnung + optionales Validierungs‑Trigger‑Verhalten wird im Helper behandelt)
    SqzDocumentMgt.CreateSQUEEZEDocHeader(Document, DocHeader, RawJson);
    SqzDocumentMgt.CreateSQUEEZEDocLine(DocHeader, RawJson);

    // 3) Core → SQUEEZE‑Source‑Header verknüpfen
    DocMgt.UpdateDocumentAfterTransfer(Document."No.", Document.Status::Transferred, DocHeader."API Document ID", DocHeader.RecordId());

    // 4) Optional: Anhänge herunterladen und speichern
    //    (gesteuert über die Dokumentenklassen‑Einrichtung)
    if DocClassSetup.Get(DocHeader."Document Class") then
        if DocClassSetup."DXP Download Attachments" then
            SqzApiMgt.DownloadAndSaveAttachments(DocHeader);

    // 5) Optional: Automatische Validierung
    //    Wenn aktiviert, führt die Validierung die Plausibilitätsprüfungen aus und erstellt das „Processed JSON“.
    AutomaticValidation := AutoValidationMgt.AutomaticValidationActivated(DocHeader."No.");
    if AutomaticValidation then
        SqzDocumentMgt.ValidateSQUEEZEDocument(DocHeader, AutomaticValidation);

    exit(true);
end;

```

---

## 7) Schritt 5 — Validierung + Übergabe „Processed JSON“

### 7.1 Validierung: `IsSourceDataPlausible`

Nutzen Sie das Core‑Plausibility‑Framework, damit Fehler konsistent angezeigt werden:

```al
procedure IsSourceDataPlausible(Source: Variant; var TempPlausibilityCheckEntry: Record "DXP Plausibility Check Entry" temporary): Boolean
var
    PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.";
    Header: Record "DXP SQZ Document Header";
begin
    if not Source.IsRecord then
        exit(false);

    Header := Source;
    TempPlausibilityCheckEntry.DeleteAll();

    PlausibilityCheck.FieldIsEmpty(Header, Header.FieldNo("Buy-from Vendor No."), 0, false, false);
    PlausibilityCheck.CheckPostingDate(Header."Posting Date", Header.FieldNo("Posting Date"));
    PlausibilityCheck.GetPlausibilityCheckEntries(TempPlausibilityCheckEntry);

    exit(TempPlausibilityCheckEntry.IsEmpty());
end;

```

### 7.2 „Processed JSON“ bauen und an Core übergeben: `CreateProcessedJsonFromSource`

„Processed JSON“ wird von Core in `DXP Document.JSON Processed` gespeichert und an Ihre Zielverarbeitung übergeben.

```al
procedure CreateProcessedJsonFromSource(Source: Variant)
var
    CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
    DocMgt: Codeunit "DXP Document Mgt.";
    JsonHelper: Codeunit "DXP Json Helper";
    DocTransferMgt: Codeunit "DXP Document Transfer Mgt.";
    Header: Record "DXP SQZ Document Header";
    Line: Record "DXP SQZ Document Line";
    HeaderJObj: JsonObject;
    LinesJArr: JsonArray;
    LineJObj: JsonObject;
begin
    Header := Source;

    HeaderJObj.Add(CoreTokenMgt.GetVendorNoTok(), Header."Buy-from Vendor No.");
    HeaderJObj.Add(CoreTokenMgt.GetDocDateTok(), Header."Document Date");
    HeaderJObj.Add(CoreTokenMgt.GetDocReferenceTok(), Header."Document Reference");

    // Benutzerdefinierte Felder (Erweiterungsfelder) aus den Source‑Tabellen hinzufügen
    HeaderJObj.Add(CoreTokenMgt.GetCustomFieldsTok(), JsonHelper.Rec2JsonFieldArray(Header, true, true, Header."Document Class", Enum::"DXP Field Type"::Header));

    Line.SetRange("Document No.", Header."No.");
    if Line.FindSet() then
        repeat
            Clear(LineJObj);
            LineJObj.Add(CoreTokenMgt.GetDescriptionTok(), Line.Description);
            LineJObj.Add(CoreTokenMgt.GetQtyTok(), Line.Quantity);
            LineJObj.Add(CoreTokenMgt.GetCustomFieldsTok(), JsonHelper.Rec2JsonFieldArray(Line, true, true, Header."Document Class", Enum::"DXP Field Type"::Line));
            LinesJArr.Add(LineJObj);
        until Line.Next() = 0;

    DocTransferMgt.AddDocLinesToHeaderJson(HeaderJObj, LinesJArr);

    // An Core‑Zielverarbeitung übergeben
    DocMgt.UpdateDocument(
        Header."Core Document No.",
        Enum::"DXP Document Status"::Transferred,
        Enum::"DXP Target Document Process"::"MY Create Custom Document",
        Enum::"DXP Next process step"::"Standard document",
        HeaderJObj);
end;

```

---

## 8) Schritt 6 — Eigenes Ziel‑Dokument erstellen

Wenn Core Ihren eigenen Ziel‑Datensatz erstellen soll, erweitern Sie `DXP Target Document Process` und implementieren Sie `DXP IDocument Processing`:

```al
enumextension 50102 "MY Target Doc Process Ext." extends "DXP Target Document Process"
{
    value(50102; "MY Create Custom Document")
    {
        Caption = 'Create My Custom Document';
        Implementation = "DXP IDocument Processing" = "MY Custom Doc Creation";
    }
}

codeunit 50103 "MY Custom Doc Creation" implements "DXP IDocument Processing"
{
    procedure ProcessStandardDocument(JObject: JsonObject): RecordId
    var
        CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
        DocTransferMgt: Codeunit "DXP Document Transfer Mgt.";
        JsonHelper: Codeunit "DXP Json Helper";
        MyDoc: Record "MY Custom Document";
        TargetVariant: Variant;
    begin
        MyDoc.Init();
        MyDoc.Validate("Vendor No.", JsonHelper.ValAsTxt(JObject, CoreTokenMgt.GetVendorNoTok(), false));
        MyDoc.Validate("Document Date", JsonHelper.ValAsDate(JObject, CoreTokenMgt.GetDocDateTok(), false));
        MyDoc.Insert(true);

        // Überträgt Metadaten sowie benutzerdefinierte/zusätzliche Felder anhand der Core‑Zuordnungen in den Ziel‑Datensatz.
        TargetVariant := MyDoc;
        DocTransferMgt.ProcessAdditionalInformation(JObject, TargetVariant);
        MyDoc := TargetVariant;

        exit(MyDoc.RecordId());
    end;
}

```

Hinweis: Die Übertragung von Metadaten sowie benutzerdefinierten/zusätzlichen Feldern ist im obigen Beispiel bereits enthalten und basiert auf den Core‑Zuordnungstabellen.

---

## 9) Fehlerbehebung (schnelle Prüfungen)

- Keine Einträge in `DXP SQZ Import Queue` → Dokumentenklassen‑Einrichtung für SQUEEZE ist unvollständig.
- Core‑`DXP Document` existiert, aber kein Source‑Datensatz → Ihr `CreateSource(Document)` ist fehlgeschlagen oder gibt `false` zurück.
- Source existiert, aber Ziel wird nicht erstellt → `CreateProcessedJsonFromSource` wird nicht aufgerufen oder `DXP Target Document Process` ist nicht konfiguriert.
- Falsches Trigger‑Verhalten beim Zuweisen → `DXP Custom Field Mapping.Validate App Field` und `Validate` prüfen. 
    - `Validate` steuert, ob die Validierung des Ziel‑Feldes (OnValidate) ausgeführt wird.

---

## 10) Was Core automatisch macht

Wenn Sie `DXP Document Mgt.UpdateDocument(...)` aufrufen:

- Core speichert das „Processed JSON“ in `DXP Document`.`JSON Processed`.
- Core setzt `DXP Document`.`Status` auf den übergebenen Status.
- Core verknüpft/aktualisiert `DXP Document`.`Linked-to Record Id` mit dem Datensatz, den Ihre `DXP IDocument Processing`‑Implementierung zurückgibt.
- Core überträgt Core‑Attachments auf den zurückgegebenen Datensatz (und hängt typischerweise das „Processed JSON“ als `.json`‑Attachment an).

# Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)

## Inhaltsverzeichnis

1. [Überblick](#%C3%BCberblick)
2. [Verstehen des Dokumentenablaufs](#bkmrk-verstehen-des-dokume)
3. [JSON-Datenstruktur](#bkmrk-json-datenstruktur)
4. [Schnellstart: Einfache benutzerdefinierte Verarbeitung](#bkmrk-schnellstart%3A-einfac)

---

## Überblick

Dieses Handbuch erklärt, wie Sie benutzerdefinierte Business Central-Dokumente aus JSON-Daten erstellen, die von DEXPRO Core bereitgestellt werden. Das System empfängt Dokumente mit dem Status **"Custom Processing"** (Individuelle Verarbeitung), die Drittanbieter-Entwickler in jeden BC-Dokumententyp umwandeln können (Bestellungen, Verkaufsaufträge, Fibu-Buchblätter, Serviceaufträge usw.).

### Was Sie lernen werden

- Wie Sie Dokumente abfangen, die für die individuelle Verarbeitung markiert sind
- Die JSON-Struktur mit Dokumentenkopf, Zeilen, Metadaten und benutzerdefinierten Feldern
- Wie Sie Ihr benutzerdefiniertes Dokument erstellen

---

## Verstehen des Dokumentenablaufs

### Kernworkflow

```
┌─────────────────────────────────────────────────────────────────┐
│ 1. Dokumentenimport                                             │
│    JSON-Rohdaten → DXP Document (Status: Imported)              │
└────────────────────────┬────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. Erstellung des Quelldokuments                                │
│    ISourceDocument.CreateSource() → Ihre Quelltabellen          │
│    (z.B. SQZ Document Header/Lines)  │
└────────────────────────┬────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. Validierung & Plausibilitätsprüfungen                        │
│    ISourceDocument.IsSourceDataPlausible()                      │
│    → Validiert Datenqualität, prüft auf Fehler                  │
└────────────────────────┬────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│ 4. Verarbeitetes JSON erstellen                                 │
│    ISourceDocument.CreateProcessedJsonFromSource()              │
│    → Erstellt JSON-Struktur für Zieldokument                    │
└────────────────────────┬────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│ 5. Core-Dokument mit "Custom Processing" Status aktualisieren   │
│    UpdateDocument() → Setzt Status auf "Custom Processing"      │
│    → Speichert JSON Processed in DXP Document                   │
└────────────────────────┬────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│ 6. Ihre benutzerdefinierte Verarbeitung (HIER SETZEN SIE AN!)   │
│    Ereignisse abonnieren oder Interface implementieren          │
│    → JSON Processed aus DXP Document lesen                      │
│    → Ihr BC-Zieldokument erstellen                              │
└────────────────────────┬────────────────────────────────────────┘
                         │
                         ▼
┌─────────────────────────────────────────────────────────────────┐
│ 7. Finale Statusaktualisierung                                  │
│    Dokumentstatus → Transferred oder Finished                   │
│    Linked-to Record Id → Ihr erstelltes BC-Dokument             │
└─────────────────────────────────────────────────────────────────┘

```

### Wichtige Statuswerte

<table id="bkmrk-status-beschreibung-"><thead><tr><th>Status</th><th>Beschreibung</th></tr></thead><tbody><tr><td>**Imported**</td><td>JSON-Rohdaten empfangen, noch nicht verarbeitet</td></tr><tr><td>**Transferred**</td><td>Quelldokument erstellt, bereit zur Verarbeitung</td></tr><tr><td>**Custom Processing**</td><td>**Ihr Zielstatus** - Dokument bereit für benutzerdefinierte Verarbeitung</td></tr><tr><td>**Closed**</td><td>Zieldokument erfolgreich verbucht oder ggfs. bezahlt</td></tr><tr><td>**Deleted**</td><td>Verarbeitung abgebrochen, Dokument gelöscht</td></tr></tbody></table>

---

## JSON-Datenstruktur

### Überblick

Das `"JSON Processed"` Blob in der `DXP Document`-Tabelle enthält ein strukturiertes JSON-Objekt mit allen Informationen, die zum Erstellen Ihres Zieldokuments benötigt werden.

### JSON-Struktur (Auszug)

```lang-json
{
  // ═══════════════════════════════════════════════════════════
  // KOPFBEREICH - Dokumentenebene Informationen
  // ═══════════════════════════════════════════════════════════

  "Type": "Invoice",                    // Dokumenttyp: Invoice, Credit Memo, Order, usw.
  "VendorNo": "VENDOR001",              // Kreditoren-/Kundennummer
  "DocumentDate": "2025-10-15",         // Belegdatum
  "PostingDate": "2025-10-16",          // Buchungsdatum
  "DocumentReference": "INV-2025-001",  // Externe Belegnummer
  "OrderNo": "PO-12345",                // Referenz zur Bestellung (falls vorhanden)
  "PostingDescription": "Invoice Q4",   // Buchungsbeschreibung
  "NetAmount": 1000.00,                 // Nettobetrag (ohne MwSt.)
  "TotalAmount": 1190.00,               // Bruttobetrag (inkl. MwSt.)
  "TaxAmount": 190.00,                  // Gesamter Steuerbetrag
  "Currency": "EUR",                    // Währungscode
  "ResponsibilityCenter": "BERLIN",     // Zuständigkeitseinheit (leer: Vorgabe aus Benutzereinrichtung / Kreditor)
  "VATBusPostingGroup": "EU",           // MwSt.-Geschäftsbuchungsgruppe (leer: Vorgabe des Kreditors) - Vorgabe für die Zeilen

  // ───────────────────────────────────────────────────────────
  // DIMENSIONEN - Kopfebene Dimensionen als Schlüssel-Wert-Paare
  // ───────────────────────────────────────────────────────────

  "Dimensions": {
    "DEPARTMENT": "SALES",
    "PROJECT": "PROJ001",
    "COSTCENTER": "CC-100"
  },

  // ───────────────────────────────────────────────────────────
  // BENUTZERDEFINIERTE FELDER - Zusätzliche Kopffelder (siehe unten)
  // ───────────────────────────────────────────────────────────

  "CustomFields": [
    {
      "Id": 50100,
      "Name": "CustomerNo",
      "Value": "CUST001",
      "Caption": "Customer Number"
    },
    {
      "Id": 50101,
      "Name": "DeliveryTerms",
      "Value": "EXW",
      "Caption": "Delivery Terms"
    }
  ],

  // ───────────────────────────────────────────────────────────
  // METADATEN - Systemgenerierte Feldzuordnungen
  // ───────────────────────────────────────────────────────────

  "Metadata": [
    {
      "DocumentClass": "DXP Invoice / Credit Memo",
      "FieldType": "Header",
      "FieldId": 101,
      "Value": "Additional Info"
    }
  ],

  // ═══════════════════════════════════════════════════════════
  // ZEILEN-BEREICH - Dokumentzeilen
  // ═══════════════════════════════════════════════════════════

  "Lines": [
    {
      // ─────────────────────────────────────────────────────────
      // Zeilen-Grundinformationen
      // ─────────────────────────────────────────────────────────

      "Type": "Item",                   // Item, G/L Account, Charge (Item), Fixed Asset
      "No": "ITEM001",                  // Artikel-/Kontonummer
      "Description": "Product A",       // Zeilenbeschreibung
      "VendorItemNo": "VEND-SKU-123",   // Kreditorenartikelnummer
      "Quantity": 10.0,                 // Menge
      "UnitOfMeasure": "PCS",          // Einheitencode
      "DirectUnitCost": 100.00,        // EK-Preis
      "LineDiscount": 5.0,             // Zeilenrabatt in Prozent

      // ─────────────────────────────────────────────────────────
      // Zeilen-Beträge & Steuern
      // ─────────────────────────────────────────────────────────

      "NetAmount": 950.00,             // Zeilennettobetrag
      "TotalAmount": 1130.50,          // Zeilenbruttobetrag
      "TaxRate": 19.0,                 // Steuersatz in Prozent
      "VATBusPostingGroup": "DOMESTIC",
      "VATProdPostingGroup": "STANDARD",
      "GenBusPostingGroup": "DOMESTIC",
      "GenProdPostingGroup": "RETAIL",

      // ─────────────────────────────────────────────────────────
      // Bestellreferenz (für Zuordnung)
      // ─────────────────────────────────────────────────────────

      "OrderNo": "PO-12345",           // Referenzierte Bestellnummer
      "OrderLineNo": 10000,            // Referenzierte Bestellzeilennummer
      "ReceiptNo": "RCP-001",          // Referenzierte Wareneingangsnummer
      "ReceiptLineNo": 10000,          // Referenzierte Wareneingangszeile

      // ─────────────────────────────────────────────────────────
      // Zeilen-Dimensionen
      // ─────────────────────────────────────────────────────────

      "Dimensions": {
        "DEPARTMENT": "PROD",
        "PROJECT": "PROJ001"
      },

      // ─────────────────────────────────────────────────────────
      // Zeilen-Benutzerdefinierte Felder
      // ─────────────────────────────────────────────────────────

      "CustomFields": [
        {
          "Id": 50200,
          "Name": "SerialNo",
          "Value": "SN-12345",
          "Caption": "Serial Number"
        }
      ],

      // ─────────────────────────────────────────────────────────
      // Zeilen-Metadaten
      // ─────────────────────────────────────────────────────────

      "Metadata": [
        {
          "DocumentClass": "DXP Invoice / Credit Memo",
          "FieldType": "Line",
          "FieldId": 201,
          "Value": "Line-specific metadata"
        }
      ]
    }
    // ... weitere Zeilen
  ]
}

```

### Benutzerdefinierte Felder vs. Metadaten

**Benutzerdefinierte Felder (Custom Fields):**

- Benutzerdefinierte Felder aus Ihrer App
- Ggfs. zugeordnet über Custom Field Mapping
- Können jedem Feld in der Squeeze-Validierung zugeordnet werden
- Beispiel: Hinzufügen einer "Kundennr." zur Squeeze-Validierung

**Metadaten:**

- Systemgenerierte Felder
- Vom Squeeze-System extrahiert, aber keinem Feld in BC zugeordnet

---

## Schnellstart: Einfache benutzerdefinierte Verarbeitung

### Szenario

Sie möchten einen benutzerdefinierten Dokumenttyp (z.B. einen Warenausgang) aus Dokumenten erstellen, die mit dem Status "Custom Processing" markiert sind.

### Schritt 1: Integration Event abonnieren

Erstellen Sie eine Codeunit, um Dokumente mit dem Status "Custom Processing" abzufangen:

```lang-al
codeunit 50100 "My Custom Document Handler"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Mgt.", 
        'OnAfterWriteProcessedJsonToBlob', '', true, true)]
    local procedure OnAfterWriteProcessedJsonToBlob(
        var Document: Record "DXP Document"; 
        var ProcessedJSONObj: JsonObject)
    begin
        // Nur Custom Processing Status behandeln
        if Document.Status <> Document.Status::"Custom Processing" then
            exit;

        // Ihr benutzerdefiniertes Dokument erstellen
        CreateMyCustomDocument(Document, ProcessedJSONObj);
    end;

    local procedure CreateMyCustomDocument(
        var Document: Record "DXP Document"; 
        ProcessedJSON: JsonObject)
    var
        CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
        JsonHelper: Codeunit "DXP Json Helper";
        MyCustomHeader: Record "My Custom Document Header";
        MyCustomLine: Record "My Custom Document Line";
        LineJArray: JsonArray;
        LineJToken: JsonToken;
        LineJObj: JsonObject;
    begin
        // ═══════════════════════════════════════════════════════
        // 1. KOPF ERSTELLEN
        // ═══════════════════════════════════════════════════════

        MyCustomHeader.Init();
        MyCustomHeader."No." := '';  // Wird durch Nummernserie zugewiesen

        // Standard-Kopffelder lesen
        MyCustomHeader."Vendor No." := 
            JsonHelper.ValAsTxt(ProcessedJSON, CoreTokenMgt.GetVendorNoTok(), false);
        MyCustomHeader."Document Date" := 
            JsonHelper.ValAsDate(ProcessedJSON, CoreTokenMgt.GetDocDateTok(), false);
        MyCustomHeader."Document Reference" := 
            JsonHelper.ValAsTxt(ProcessedJSON, CoreTokenMgt.GetDocReferenceTok(), false);

        MyCustomHeader.Insert(true);

        // ═══════════════════════════════════════════════════════
        // 2. DIMENSIONEN VERARBEITEN (wenn Ihr Dokument diese unterstützt)
        // ═══════════════════════════════════════════════════════

        ProcessHeaderDimensions(ProcessedJSON, MyCustomHeader);

        // ═══════════════════════════════════════════════════════
        // 3. BENUTZERDEFINIERTE FELDER VERARBEITEN
        // ═══════════════════════════════════════════════════════

        ProcessCustomFields(ProcessedJSON, MyCustomHeader);

        // ═══════════════════════════════════════════════════════
        // 4. ZEILEN ERSTELLEN
        // ═══════════════════════════════════════════════════════

        LineJArray := JsonHelper.ReadJArrayFromObj(ProcessedJSON, CoreTokenMgt.GetLinesTok());

        foreach LineJToken in LineJArray do begin
            LineJObj := LineJToken.AsObject();

            MyCustomLine.Init();
            MyCustomLine."Document No." := MyCustomHeader."No.";
            MyCustomLine."Line No." := GetNextLineNo(MyCustomHeader."No.");

            // Zeilenfelder lesen
            MyCustomLine."Item No." := 
                JsonHelper.ValAsTxt(LineJObj, CoreTokenMgt.GetNoTok(), false);
            MyCustomLine.Description := 
                JsonHelper.ValAsTxt(LineJObj, CoreTokenMgt.GetDescriptionTok(), false);
            MyCustomLine.Quantity := 
                JsonHelper.ValAsDec(LineJObj, CoreTokenMgt.GetQtyTok(), false);
            MyCustomLine."Unit of Measure" := 
                JsonHelper.ValAsTxt(LineJObj, CoreTokenMgt.GetUoMTok(), false);

            MyCustomLine.Insert(true);

            // Zeilen-Dimensionen und benutzerdefinierte Felder verarbeiten, falls erforderlich
            ProcessLineDimensions(LineJObj, MyCustomLine);
            ProcessLineCustomFields(LineJObj, MyCustomLine);
        end;

        // ═══════════════════════════════════════════════════════
        // 5. CORE-DOKUMENTSTATUS AKTUALISIEREN
        // ═══════════════════════════════════════════════════════

        UpdateCoreDocument(Document, MyCustomHeader);
    end;

    local procedure ProcessHeaderDimensions(ProcessedJSON: JsonObject; var MyCustomHeader: Record "My Custom Document Header")
    var
        CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
        DocTransferMgt: Codeunit "DXP Document Transfer Mgt.";
        DimensionsJObj: JsonObject;
        DimSetID: Integer;
    begin
        // Dimensionen aus JSON lesen
        if ProcessedJSON.Contains(CoreTokenMgt.GetDimensionsTok()) then begin
            ProcessedJSON.Get(CoreTokenMgt.GetDimensionsTok(), DimensionsJObj);

            // In Dimensionssatz-ID konvertieren
            if DocTransferMgt.GetDimSetIdFromJsonObj(DimensionsJObj, DimSetID) then begin
                MyCustomHeader."Dimension Set ID" := DimSetID;
                MyCustomHeader.Modify(true);
            end;
        end;
    end;

    local procedure ProcessCustomFields(ProcessedJSON: JsonObject; var MyCustomHeader: Record "My Custom Document Header")
    var
        CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
        JsonHelper: Codeunit "DXP Json Helper";
        CustomFieldsJArray: JsonArray;
        CustomFieldJToken: JsonToken;
        CustomFieldJObj: JsonObject;
        FieldName: Text;
        FieldValue: Text;
    begin
        // Benutzerdefinierte Felder-Array lesen
        if not ProcessedJSON.Contains(CoreTokenMgt.GetCustomFieldsTok()) then
            exit;

        CustomFieldsJArray := JsonHelper.ReadJArrayFromObj(ProcessedJSON, CoreTokenMgt.GetCustomFieldsTok());

        foreach CustomFieldJToken in CustomFieldsJArray do begin
            CustomFieldJObj := CustomFieldJToken.AsObject();
            FieldName := JsonHelper.ValAsTxt(CustomFieldJObj, CoreTokenMgt.GetNameTok(), false);
            FieldValue := JsonHelper.ValAsTxt(CustomFieldJObj, CoreTokenMgt.GetValueTok(), false);

            // Zu Ihren benutzerdefinierten Feldern zuordnen
            case FieldName of
                'CustomerNo':
                    MyCustomHeader."Customer No." := CopyStr(FieldValue, 1, 20);
                'DeliveryTerms':
                    MyCustomHeader."Delivery Terms" := CopyStr(FieldValue, 1, 10);
                // Weitere Feldzuordnungen nach Bedarf hinzufügen
            end;
        end;

        MyCustomHeader.Modify(true);
    end;

    local procedure ProcessLineDimensions(LineJObj: JsonObject; var MyCustomLine: Record "My Custom Document Line")
    var
        CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
        DocTransferMgt: Codeunit "DXP Document Transfer Mgt.";
        DimensionsJObj: JsonObject;
        DimSetID: Integer;
    begin
        if LineJObj.Contains(CoreTokenMgt.GetDimensionsTok()) then begin
            LineJObj.Get(CoreTokenMgt.GetDimensionsTok(), DimensionsJObj);

            if DocTransferMgt.GetDimSetIdFromJsonObj(DimensionsJObj, DimSetID) then begin
                MyCustomLine."Dimension Set ID" := DimSetID;
                MyCustomLine.Modify(true);
            end;
        end;
    end;

    local procedure ProcessLineCustomFields(LineJObj: JsonObject; var MyCustomLine: Record "My Custom Document Line")
    var
        CoreTokenMgt: Codeunit "DXP Core Token Mgt.";
        JsonHelper: Codeunit "DXP Json Helper";
        CustomFieldsJArray: JsonArray;
        CustomFieldJToken: JsonToken;
        CustomFieldJObj: JsonObject;
        FieldName: Text;
        FieldValue: Text;
    begin
        if not LineJObj.Contains(CoreTokenMgt.GetCustomFieldsTok()) then
            exit;

        CustomFieldsJArray := JsonHelper.ReadJArrayFromObj(LineJObj, CoreTokenMgt.GetCustomFieldsTok());

        foreach CustomFieldJToken in CustomFieldsJArray do begin
            CustomFieldJObj := CustomFieldJToken.AsObject();
            FieldName := JsonHelper.ValAsTxt(CustomFieldJObj, CoreTokenMgt.GetNameTok(), false);
            FieldValue := JsonHelper.ValAsTxt(CustomFieldJObj, CoreTokenMgt.GetValueTok(), false);

            // Zu Ihren benutzerdefinierten Zeilenfeldern zuordnen
            case FieldName of
                'SerialNo':
                    MyCustomLine."Serial No." := CopyStr(FieldValue, 1, 50);
                // Weitere Feldzuordnungen hinzufügen
            end;
        end;

        MyCustomLine.Modify(true);
    end;

    local procedure UpdateCoreDocument(var Document: Record "DXP Document"; MyCustomHeader: Record "My Custom Document Header")
    var
        DocumentMgt: Codeunit "DXP Document Mgt.";
    begin
        // Core-Dokument aktualisieren, um es mit Ihrem erstellten Dokument zu verknüpfen
        Document.Status := Document.Status::Transferred;
        Document."Linked-to Record Id" := MyCustomHeader.RecordId;
        Document.Modify(true);

        // Optional: Anhänge von Core zu Ihrem Dokument übertragen
        TransferAttachments(Document, MyCustomHeader);
    end;

    local procedure TransferAttachments(Document: Record "DXP Document"; MyCustomHeader: Record "My Custom Document Header")
    var
        DocAttachment: Record "DXP Document Attachment";
        MyDocAttachment: Record "Document Attachment";
        InStr: InStream;
    begin
        DocAttachment.SetRange("Document No.", Document."No.");
        if DocAttachment.FindSet() then
            repeat
                MyDocAttachment.Init();
                MyDocAttachment.ID := 0;

                DocAttachment."File Content".CreateInStream(InStr);
                MyDocAttachment.SaveAttachmentFromStream(
                    InStr, 
                    MyCustomHeader.RecordId, 
                    DocAttachment."File Name");
            until DocAttachment.Next() = 0;
    end;

    local procedure GetNextLineNo(DocumentNo: Code[20]): Integer
    var
        MyCustomLine: Record "My Custom Document Line";
    begin
        MyCustomLine.SetRange("Document No.", DocumentNo);
        if MyCustomLine.FindLast() then
            exit(MyCustomLine."Line No." + 10000);
        exit(10000);
    end;
}

```

### Wichtige Hilfs-Codeunits

<table id="bkmrk-codeunit-zweck-dxp-c"><thead><tr><th>Codeunit</th><th>Zweck</th></tr></thead><tbody><tr><td>**DXP Core Token Mgt.**</td><td>Stellt Token-Namen für JSON-Felder bereit (GetVendorNoTok(), GetDocDateTok(), usw.)</td></tr><tr><td>**DXP Json Helper**</td><td>JSON-Parsing-Hilfsfunktionen (ValAsTxt(), ValAsDate(), ReadJArrayFromObj(), usw.)</td></tr><tr><td>**DXP Document Transfer Mgt.**</td><td>Dimensionsverarbeitung, Metadatenübertragung, Behandlung benutzerdefinierter Felder</td></tr><tr><td>**DXP Document Mgt.**</td><td>Kern-Dokumentenverwaltung (UpdateDocument(), UpdateDocumentStatus(), usw.)</td></tr></tbody></table>

---

*Bei Fragen oder Unklarheiten wenden Sie sich bitte an die DEXPRO Solutions GmbH.*

# Einbetten des SQUEEZE Viewer‑Parts in eigene Pages

Diese Anleitung beschreibt, wie Sie den **SQUEEZE Viewer** in *beliebige* Seiten einbetten (eigene Pages oder Page Extensions) – über den wiederverwendbaren Viewer‑Part:

- Page: **"DXP SQZ Viewer Part"** (PageType = `CardPart`)
- Source table: **"DXP SQZ Document Header"**

Der Viewer‑Part hostet die SQUEEZE Control Add-ins und lädt die Preview‑URL anhand des aktuellen Datensatzes **DXP SQZ Document Header**.

Referenz‑Implementierung, die in dieser App bereits enthalten ist:

- Page **"DXP SQZ Document (Generic)"** (Card, SourceTable **DXP SQZ Document Header**) bettet den Viewer‑Part als FactBox ein und verdrahtet das Resident‑Sharing zur generischen Lines‑Subform.
- Page **"DXP SQZ Doc. Generic Subform"** (ListPart, SourceTable **DXP SQZ Document Line**) enthält eine bekannte, funktionierende Minimal‑Implementierung von `MarkRow()`.

Die Pages können Sie benutzen und mit ihren Feldern erweitern. Die Page **"DXP SQZ Document (Generic)"** verfügt über einen Viewer in der Factbox und die wichtigsten Actions.

---

## 1) Voraussetzungen

1. Ihre Extension muss von der DEXPRO SQUEEZE App abhängig sein (damit Page/Control Add-ins als Symbole verfügbar sind).
2. Der Host‑Datensatz muss eine Möglichkeit bieten, einen **DXP SQZ Document Header** Datensatz zu referenzieren.
    
    
    - Die `SourceTable` des Viewer‑Parts ist fest auf **DXP SQZ Document Header**.
    - Deshalb muss Ihre Seite ein Feld haben (oder bereitstellen), das sich in `SubPageLink` verwenden lässt, um den Header zu finden. Alternativ kann der Record in dem Viewer-Part gesetzt werden - Beispiele folgen weiter unten.
3. SQUEEZE muss aktiviert und konfiguriert sein (Setup + API Key). Der Viewer‑Part lädt absichtlich **nicht**, wenn das Modul nicht aktiviert ist.

---

## 2) Empfohlenes Einbettungsmuster

### 2.1 Als FactBox einbetten (empfohlen)

Für die meisten Szenarien (Card Pages, List Pages) platzieren Sie den Viewer in `area(FactBoxes)`.

#### Wenn die `SourceTable` Ihrer Seite **DXP SQZ Document Header** ist

```al
layout
{
    area(FactBoxes)
    {
        part(SQZViewer; "DXP SQZ Viewer Part")
        {
            ApplicationArea = All;
            Caption = 'Viewer';

            // Link the FactBox part to the current SQZ header
            SubPageLink = "No." = field("No.");
        }
    }
}

```

#### Wenn die `SourceTable` Ihrer Seite NICHT **DXP SQZ Document Header** ist

Sie können den Viewer‑Part trotzdem einbetten, sofern Ihr Datensatz ein Feld enthält, das die SQUEEZE Header‑Nummer speichert.

Beispiel: Ihr Datensatz hat ein Feld `"SQZ Document No." : Code[20]`

```al
layout
{
    area(FactBoxes)
    {
        part(SQZViewer; "DXP SQZ Viewer Part")
        {
            ApplicationArea = All;
            Caption = 'Viewer';

            // Link the viewer part’s "No." to your field
            SubPageLink = "No." = field("SQZ Document No.");
        }
    }
}

```

Wichtig:

- Setze am Part nicht `Enabled = false`. Wenn eine FactBox‑Part deaktiviert ist, kann das verhindern, dass das Control Add-in „ready“ wird – dadurch bleibt der Viewer ggf. dauerhaft leer.

### 2.2 Viewer dynamisch binden (ohne `SubPageLink`)

Wenn Ihre Host‑Seite keinen einfachen `SubPageLink` anbieten kann (z. B. weil es sich um eine Zielbeleg‑Seite wie **Purchase Invoice** handelt und dort die SQUEEZE Belegnummer nicht gespeichert ist), können Sie den Viewer‑Part trotzdem einbetten und im Code binden.

Konzept:

- Viewer‑Part als FactBox hinzufügen – **ohne** `SubPageLink`.
- In `OnAfterGetCurrRecord()` den relevanten `Record "DXP SQZ Document Header"` auflösen.
- Den Datensatz per `CurrPage.<PartName>.Page.SetSqzRecord(SqzHeader);` in den Part pushen.

Warum `SetSqzRecord`?

- Im DEXPRO SQUEEZE Viewer‑Part läuft das Laden der URL in `OnAfterGetCurrRecord()`.
- Beim Navigieren innerhalb einer Seite (z. B. Wechsel zwischen Purchase Invoices) kann `SetRecord(...)` allein dazu führen, dass die FactBox nicht sofort neu lädt.
- `SetSqzRecord(...)` ist dafür gedacht, den Header sauber neu zu binden und einen Refresh auszulösen, sodass die korrekte Preview ohne Schließen/Öffnen der Seite geladen wird.

Beispiel‑Gerüst:

```al
layout
{
    area(FactBoxes)
    {
        part(SQZViewer; "DXP SQZ Viewer Part")
        {
            ApplicationArea = All;
            Caption = 'Viewer';
        }
    }
}

trigger OnAfterGetCurrRecord()
var
    SqzHeader: Record "DXP SQZ Document Header";
begin
    if TryResolveSqzHeaderForCurrentRecord(SqzHeader) then
        CurrPage.SQZViewer.Page.SetSqzRecord(SqzHeader);
end;

```

Dieses Pattern ist besonders für Third‑party Pages hilfreich, weil es vermeidet, „SQUEEZE Document No.“ als Tabellenfeld persistieren zu müssen.

---

## 3) Viewer‑Modus (Belegübersicht / Positionsfokus / Abgedockt)

Wenn der Viewer als FactBox eingebettet ist, sind Felder typischerweise nicht editierbar. Deshalb bietet der Viewer‑Part **Actions**, um den Viewer‑Modus zu ändern.

Was beim Wechsel des Modus passiert:

- **Belegübersicht**: Zeigt eine Übersichtliche Darstellung des Viewers an.
- **Positionsfokus**: Zeigt eine schmalere Darstellung des Viewers an.
- **Abgedockt**: Öffnet den Viewer in einem externen Fenster

Für Third‑party Entwickler:

- Sie müssen keine eigene Mode‑Logik implementieren.
- Nutzen Sie die Actions des Viewer‑Parts (erscheinen im FactBox Action‑Menü).

---

## 4) Optional, aber wichtig: Zeilen‑Highlighting aktivieren (MarkRow)

Wenn Sie eine Lines‑Subform haben und die Benutzererfahrung „Zeile klicken → Viewer markiert Koordinaten“ wünschen, muss Ihre Lines‑Page Messages über **dieselbe Viewer‑Resident‑Instanz** posten, die der Viewer‑Part initialisiert.

Warum das wichtig ist:

- Die Viewer‑UI ist eine Control Add‑in Instanz, die in einer Codeunit `DXP SQUEEZE Viewer Resident` gespeichert wird.
- Wenn Ihre Lines‑Page eine *eigene* Variable `DXP SQUEEZE Viewer Resident` verwendet (die nicht vom Viewer‑Part initialisiert wurde), hat `ApiMgt.PostMessage(...)` keine Control‑Add‑in Instanz zum Ansprechen – es wird nichts markiert.

### 4.1 Pattern (Host‑Page verdrahtet Viewer‑Resident in Lines)

Annahmen:

- Ihre Header‑Page hat: 
    - `part(SQZViewer; "DXP SQZ Viewer Part")`
    - `part(DocumentLines; <Ihre Lines ListPart>)`
- Ihre Lines‑ListPart stellt eine Procedure bereit: 
    - `SetViewerResident(var NewResident: Codeunit "DXP SQUEEZE Viewer Resident")`

Das ist ein expliziter Vertrag/Annahme für interaktives Line‑Highlighting.

Ergänzen Sie das auf Ihrer Header‑Page:

```al
trigger OnAfterGetCurrRecord()
var
    SharedResident: Codeunit "DXP SQUEEZE Viewer Resident";
begin
    CurrPage.SQZViewer.Page.GetViewerResident(SharedResident);
    CurrPage.DocumentLines.Page.SetViewerResident(SharedResident);
end;

```

Hinweise:

- Das gehört in `OnAfterGetCurrRecord()` der Host‑Page (dort ist der aktuelle Header stabil, und die Parts existieren).
- Wenn Ihre Host‑Page andere Part‑Namen verwendet, passen Sie `CurrPage.<PartName>.Page...` entsprechend an.

### 4.2 Was die Lines‑Subform tun muss

Ihre Lines‑Page sollte `MarkRow()` in `OnAfterGetCurrRecord()` aufrufen und `MarkRow()` ähnlich zur Standard‑Seite implementieren:

- Wenn der externe Viewer aktiv ist (Abgedockt), nur die State‑Tabelle aktualisieren.
- Ansonsten `ApiMgt.PostMessage(ApiMgt.MarkFieldByCoordinatesObj(Rec.RecordId), Resident)` aufrufen.

Das ist die Mindestanforderung für interaktives Highlighting.

### 4.3 Referenz‑Implementierung: minimale Lines‑Subform mit `MarkRow`

Das ist ein bekannt funktionierendes Minimal‑Pattern (basierend auf der Standard SQUEEZE Lines‑Subform). Third‑party Entwickler können es kopieren und Felder/Repeater‑Spalten nach Bedarf anpassen:

```al
page 70954672 "DXP SQZ Doc. Generic Subform"
{
    Caption = 'Lines';
    PageType = ListPart;
    AutoSplitKey = true;
    DelayedInsert = true;
    SourceTable = "DXP SQZ Document Line";
    RefreshOnActivate = true;

    layout
    {
        area(content)
        {
            repeater(General)
            {
                field("Line No."; Rec."Line No.")
                {
                    ApplicationArea = All;
                    Visible = false;
                }
                // Add your visible SQZ fields here...
            }
        }
    }

    trigger OnAfterGetCurrRecord()
    begin
        MarkRow();
    end;

    var
        ApiMgt: Codeunit "DXP SQZ API Mgt.";
        Resident: Codeunit "DXP SQUEEZE Viewer Resident";
        MarkedLineNo: Integer;

    procedure SetViewerResident(var NewResident: Codeunit "DXP SQUEEZE Viewer Resident")
    begin
        Resident := NewResident;
        MarkedLineNo := 0;
    end;

    local procedure MarkRow()
    var
        DocHeader: Record "DXP SQZ Document Header";
        LineCoordMgt: Codeunit "DXP SQZ Coordinates Mgt.";
        ViewerState: Codeunit "DXP Viewer State";
    begin
        if MarkedLineNo = Rec."Line No." then
            exit;

        if not LineCoordMgt.CoordinateExists(Rec.RecordId) then
            exit;

        // Detached viewer: update the state table only
        if IsExternalViewerActive() then begin
            if DocHeader.Get(Rec."Document No.") then
                ViewerState.UpdateViewerStateWithCoordinates(DocHeader."API Document ID", Rec.RecordId);
        end else
            // Internal viewer: post message to the control add-in instance via the shared resident
            ApiMgt.PostMessage(ApiMgt.MarkFieldByCoordinatesObj(Rec.RecordId), Resident);

        MarkedLineNo := Rec."Line No.";
    end;

    local procedure IsExternalViewerActive(): Boolean
    var
        ViewerState: Codeunit "DXP Viewer State";
    begin
        exit(ViewerState.GetViewerMode() = "DXP SQZ Viewer Mode"::Detached);
    end;
}

```

---

## 5) Fehlersuche (Viewer bleibt leer)

### 5.1 Der Viewer lädt nie eine Preview

Prüfe zuerst:

- Ist das SQUEEZE Modul aktiviert und das Setup vollständig?
- Hat der verknüpfte **DXP SQZ Document Header** Datensatz eine gültige `"API Document ID"`?
- Ist der Viewer‑Modus aktuell **Abgedockt** und ein externer Viewer offen? 
    - Der interne Viewer lädt nicht, solange der externe Viewer geöffnet ist.

### 5.2 FactBox ist sichtbar, aber Control Add-in initialisiert nicht

- Deaktiviere den Viewer‑FactBox‑Part nicht über `Enabled = false`.
- Stelle sicher, dass die FactBox tatsächlich angezeigt wird (FactBoxes können vom Benutzer eingeklappt/ausgeblendet werden).

### 5.3 MarkRow hebt nichts hervor

- Stelle sicher, dass die Lines‑Page dieselbe Viewer‑Resident‑Instanz wie der Viewer‑Part nutzt (siehe Abschnitt 4).
- Stelle sicher, dass Koordinaten für den Zeilen‑Datensatz existieren (`DXP SQZ Coordinates Mgt.` muss Koordinaten zu `Rec.RecordId` finden).

---

## 6) Minimales Beispiel: Viewer in eine eigene Page Extension einbauen

```al
pageextension 50100 "MY SQZ Doc Ext." extends "DXP SQZ Document (Generic)"
{
    layout
    {
        addfirst(FactBoxes)
        {
            part(MySQZViewer; "DXP SQZ Viewer Part")
            {
                ApplicationArea = All;
                Caption = 'Viewer';
                SubPageLink = "No." = field("No.");
            }
        }
    }
}

```

---

## 7) Hinweise / Einschränkungen

- Der Viewer‑State ist session‑getrieben (via `DXP Viewer State`). Wenn mehrere Seiten mit Viewer gleichzeitig offen sind, können Modus/External‑Viewer‑State alle beeinflussen.
- Der Viewer‑Part ist für Datensätze mit SQUEEZE‑Bezug gedacht; er versucht nicht, automatisch „irgendeinen“ Header zu suchen.

---

## 8) Beispiel: Viewer auf einem Zielbeleg anzeigen (Purchase Invoice)

Dieser Abschnitt adressiert ein häufiges Third‑party Szenario:

Annahmen:

- Der Zielbeleg (z. B. **Purchase Invoice**) wurde aus einem Core‑Beleg erstellt.
- Der Core‑Beleg ist weiterhin in der Tabelle **"DXP Document"** verfügbar.
- Der Core‑Beleg speichert eine Rückverknüpfung zum Ziel‑Datensatz im Feld **"Linked-to Record Id"**.
- Der SQUEEZE Quell‑Header existiert noch und kann aus dem Core‑Beleg aufgelöst werden (typischerweise über **Core Document No.**).

### 8.1 Core‑Beleg aus dem Ziel‑Datensatz auflösen

```al
local procedure TryGetCoreDocumentForTarget(TargetRecId: RecordId; var CoreDoc: Record "DXP Document"): Boolean
begin
    CoreDoc.Reset();
    CoreDoc.SetRange("Linked-to Record Id", TargetRecId);
    exit(CoreDoc.FindFirst());
end;

```

### 8.2 SQUEEZE Header aus dem Core‑Beleg auflösen

```al
local procedure TryGetSqzHeaderForCore(CoreDocNo: Code[20]; var SqzHeader: Record "DXP SQZ Document Header"): Boolean
begin
    SqzHeader.Reset();
    SqzHeader.SetRange("Core Document No.", CoreDocNo);
    exit(SqzHeader.FindFirst());
end;

```

### 8.3 Viewer einbetten (dynamisches Binden)

Beispiel: **Purchase Invoice** erweitern (konzeptionell; Basis‑Page‑Name ggf. an Ihre Umgebung anpassen).

Diese Implementierung verwendet:

- Einen FactBox‑Part
- Ein `ShowViewer`‑Flag, um den Part auszublenden, wenn kein SQZ Header aufgelöst werden kann.
- `SetSqzRecord(...)`, damit die Preview beim Wechsel des Belegs sofort korrekt neu lädt.
- Ein `SingleInstance` Context‑Codeunit, um Viewer‑Resident und SQZ‑Kontext mit der **Purch. Invoice Subform** zu teilen (FactBoxes und Subforms sind separate Pages).

```al
pageextension 50100 "MY Purch. Invoice Viewer" extends "Purchase Invoice"
{
    layout
    {
        addfirst(FactBoxes)
        {
            part(DXPSQZViewer; "DXP SQZ Viewer Part")
            {
                ApplicationArea = All;
                Caption = 'SQUEEZE Viewer';
                Visible = ShowViewer;
            }
        }
    }

    var
        ShowViewer: Boolean;

    trigger OnAfterGetCurrRecord()
    var
        CoreDoc: Record "DXP Document";
        SqzHeader: Record "DXP SQZ Document Header";
        SharedResident: Codeunit "DXP SQUEEZE Viewer Resident";
        ViewerCtx: Codeunit "DXP SQZ Purch. Inv. Viewer Ctx";
    begin
        ShowViewer := false;
        if not TryGetCoreDocumentForTarget(Rec.RecordId, CoreDoc) then
            exit;

        if not TryGetSqzHeaderForCore(CoreDoc."No.", SqzHeader) then
            exit;

        ShowViewer := true;

        CurrPage.DXPSQZViewer.Page.SetSqzRecord(SqzHeader);

        CurrPage.DXPSQZViewer.Page.GetViewerResident(SharedResident);
        ViewerCtx.SetResident(SharedResident);
        ViewerCtx.SetSqzContextForPurchInv(Rec."No.", SqzHeader."No.", SqzHeader."API Document ID");
    end;

    local procedure TryGetCoreDocumentForTarget(TargetRecId: RecordId; var CoreDoc: Record "DXP Document"): Boolean
    begin
        CoreDoc.Reset();
        CoreDoc.SetRange("Linked-to Record Id", TargetRecId);
        exit(CoreDoc.FindFirst());
    end;

    local procedure TryGetSqzHeaderForCore(CoreDocNo: Code[20]; var SqzHeader: Record "DXP SQZ Document Header"): Boolean
    begin
        SqzHeader.Reset();
        SqzHeader.SetRange("Core Document No.", CoreDocNo);
        exit(SqzHeader.FindFirst());
    end;
}

```

Zugehöriges Context‑Codeunit (speichert Resident + SQZ‑Kontext, damit die Subform korrekt highlighten kann):

```al
codeunit 50101 "MY SQZ Purch. Inv. Viewer Ctx"
{
    SingleInstance = true;

    procedure SetResident(var NewResident: Codeunit "DXP SQUEEZE Viewer Resident")
    begin
        Resident := NewResident;
        HasResident := true;
    end;

    procedure TryGetResident(var OutResident: Codeunit "DXP SQUEEZE Viewer Resident"): Boolean
    begin
        if not HasResident then
            exit(false);

        OutResident := Resident;
        exit(true);
    end;

    procedure SetSqzContextForPurchInv(PurchInvNo: Code[20]; SqzDocNo: Code[20]; ApiDocumentId: Text[50])
    begin
        PurchInvToSqzDocNo.Set(PurchInvNo, SqzDocNo);
        PurchInvToApiDocumentId.Set(PurchInvNo, ApiDocumentId);
    end;

    procedure TryGetSqzContextForPurchInv(PurchInvNo: Code[20]; var SqzDocNo: Code[20]; var ApiDocumentId: Text[50]): Boolean
    begin
        if not PurchInvToSqzDocNo.Get(PurchInvNo, SqzDocNo) then
            exit(false);

        PurchInvToApiDocumentId.Get(PurchInvNo, ApiDocumentId);
        exit(true);
    end;

    var
        Resident: Codeunit "DXP SQUEEZE Viewer Resident";
        HasResident: Boolean;
        PurchInvToSqzDocNo: Dictionary of [Code[20], Code[20]];
        PurchInvToApiDocumentId: Dictionary of [Code[20], Text[50]];
}

```

### 8.4 Wichtiger Hinweis: SQUEEZE Header‑Status nach Verarbeitung

Sie haben ein häufiges Setup beschrieben, in dem der SQUEEZE Header nach dem Erstellen des Zielbelegs noch existiert, aber `Status = Deleted` ist.

Der Viewer‑Part kann die Preview trotzdem laden, solange `"API Document ID"` vorhanden ist und SQUEEZE aktiviert ist.

Optionen:

- Wenn Sie die Preview nach Zielbeleg‑Erstellung **nicht** anzeigen möchten, bauen Sie eine Guard‑Logik auf der Host‑Page ein (Viewer‑Part dann nicht binden, wenn der SQZ Header „Deleted“ ist).

Welche Option korrekt ist, hängt von Ihren Prozessanforderungen ab.

---

## 9) Sonderfall: Hervorheben aus der Purchase Invoice Subform (Purchase Line → SQZ line)

Manchmal mächten Sie diese Benutzererfahrung auf einer Zielbeleg‑Seite:

- User navigiert durch **Purchase Lines**.
- Der eingebettete SQUEEZE Viewer hebt den entsprechenden Bereich (Koordinaten) des originalen Belegs, bzw. der Viewer-Abbildung hervor.

In dieser Situation basiert Ihre Lines‑Page **nicht** auf `"DXP SQZ Document Line"`, daher können Sie `MarkFieldByCoordinatesObj(Rec.RecordId)` nicht direkt aufrufen.

Stattdessen müssen Sie die passende SQUEEZE Line auflösen und danach mit der `RecordId` dieser SQUEEZE Line highlighten.

### 9.1 Zwei mögliche Verknüpfungsstrategien

Es gibt zwei realistische Wege, eine Einkaufszeile wieder auf eine SQUEEZE Line zu mappen:

1. **Expliziter Allocation‑Link** (nur in manchen Szenarien verfügbar)
    
    
    - Verwendet Felder auf `"DXP SQZ Document Line"`: 
        - `"Allocated Document Type"` (enum `"DXP Order Match Document Type"`)
        - `"Allocated Document No."`
        - `"Allocated Document Line No."`
2. **Heuristischer Match nach Inhalt** (empfohlen als Fallback)
    
    
    - Verwendet Felder, die typischerweise auf beiden Seiten existieren (Type/No/Quantity/Unit Cost/Line Amount/Description).
    - Das funktioniert auch dann, wenn keine Allocation‑Beziehung gepflegt wird.
    - Es ist nicht mathematisch perfekt (Duplikate sind möglich), daher sollten Matching‑Regeln auf Ihren Use Case angepasst werden.

### 9.2 Empfohlenes Wiring (Host‑Page übergibt SQZ‑Kontext + Resident)

Sie benötigen in der Purchase‑Lines‑Subpage zwei Dinge:

1. Den Viewer‑Resident (damit `PostMessage(...)` die richtige Control‑Add‑in Instanz trifft)
2. Den aktuellen SQZ Header‑Kontext (damit Sie SQZ Lines auf das richtige Dokument filtern)

Empfohlenes Pattern auf der Host‑Page (nachdem Sie `SqzHeader` aufgelöst haben):

```al
trigger OnAfterGetCurrRecord()
var
    SharedResident: Codeunit "DXP SQUEEZE Viewer Resident";
    SqzHeader: Record "DXP SQZ Document Header";
begin
    if not TryResolveSqzHeaderForCurrentRecord(SqzHeader) then
        exit;

    CurrPage.DXPSQZViewer.Page.SetSqzRecord(SqzHeader);

    CurrPage.DXPSQZViewer.Page.GetViewerResident(SharedResident);
    ViewerCtx.SetResident(SharedResident);
    ViewerCtx.SetSqzContextForPurchInv(Rec."No.", SqzHeader."No.", SqzHeader."API Document ID");
end;

```

### 9.3 Minimales Beispiel: Purch. Invoice Subform triggert Highlighting im Viewer

Dieses Beispiel erweitert **Purch. Invoice Subform**. Beachten Sie: der Datensatz der Basis‑Subform ist ein `Record "Purchase Line"`, daher müssen die Resolver‑Prozeduren `Record "Purchase Line"` akzeptieren.

Das hier gezeigte Allocation‑Mapping ist die funktionierende Implementierung für Purchase‑Invoice‑Szenarien: es verknüpft über **Receipt** (`"Receipt No."` / `"Receipt Line No."`) statt über Belegnummer/Zeilennummer der Rechnung.

```al
pageextension 50101 "MY Purch. Inv. Sf Mark" extends "Purch. Invoice Subform"
{
    trigger OnAfterGetCurrRecord()
    begin
        MarkSqzLineForPurchInvLine();
    end;

    var
        ApiMgt: Codeunit "DXP SQZ API Mgt.";
        Resident: Codeunit "DXP SQUEEZE Viewer Resident";
        ViewerState: Codeunit "DXP Viewer State";
        LineCoordMgt: Codeunit "DXP SQZ Coordinates Mgt.";
        ViewerCtx: Codeunit "DXP SQZ Purch. Inv. Viewer Ctx";
        SqzDocNo: Code[20];
        ApiDocumentId: Text[50];

    local procedure MarkSqzLineForPurchInvLine()
    var
        SqzLine: Record "DXP SQZ Document Line";
    begin
        if not ViewerCtx.TryGetSqzContextForPurchInv(Rec."Document No.", SqzDocNo, ApiDocumentId) then
            exit;

        if not ViewerCtx.TryGetResident(Resident) then
            exit;

        if not TryResolveSqzLineForPurchLine(SqzDocNo, Rec, SqzLine) then
            exit;

        if not LineCoordMgt.CoordinateExists(SqzLine.RecordId) then
            exit;

        if ViewerState.GetViewerMode() = "DXP SQZ Viewer Mode"::Detached then
            ViewerState.UpdateViewerStateWithCoordinates(ApiDocumentId, SqzLine.RecordId)
        else
            ApiMgt.PostMessage(ApiMgt.MarkFieldByCoordinatesObj(SqzLine.RecordId), Resident);
    end;

    local procedure TryResolveSqzLineForPurchLine(SqzDocNo: Code[20]; PurchLine: Record "Purchase Line"; var SqzLine: Record "DXP SQZ Document Line"): Boolean
    begin
        // 1) Allocation link via receipt (Purchase Invoice Szenario)
        SqzLine.Reset();
        SqzLine.SetRange("Document No.", SqzDocNo);
        SqzLine.SetFilter("Allocated Document No.", '%1&<>%2', PurchLine."Receipt No.", '');
        SqzLine.SetFilter("Allocated Document Line No.", '%1&<>%2', PurchLine."Receipt Line No.", 0);
        if SqzLine.FindFirst() then
            exit(true);

        // 2) Fallback: content-based match (Type/No/Amounts)
        exit(TryResolveSqzLineByContent(SqzDocNo, PurchLine, SqzLine));
    end;

    local procedure TryResolveSqzLineByContent(SqzDocNo: Code[20]; PurchLine: Record "Purchase Line"; var BestSqzLine: Record "DXP SQZ Document Line"): Boolean
    var
        Candidate: Record "DXP SQZ Document Line";
        BestScore: Integer;
        Score: Integer;
        QtyTol: Decimal;
        AmtTol: Decimal;
    begin
        QtyTol := 0.00001;
        AmtTol := 0.01;

        BestScore := 0;
        Candidate.Reset();
        Candidate.SetRange("Document No.", SqzDocNo);

        // Prefer narrowing early on stable fields
        Candidate.SetRange(Type, PurchLine.Type);
        if PurchLine."No." <> '' then
            Candidate.SetRange("No.", PurchLine."No.");

        if not Candidate.FindSet() then
            exit(false);

        repeat
            Score := 0;

            // Strong signals
            if Candidate.Type = PurchLine.Type then
                Score += 20;
            if (PurchLine."No." <> '') and (Candidate."No." = PurchLine."No.") then
                Score += 40;

            // Weak/medium signals (tolerant)
            if (Candidate.Quantity <> 0) and (Abs(Candidate.Quantity - PurchLine.Quantity) <= QtyTol) then
                Score += 10;
            if (Candidate."Direct Unit Cost" <> 0) and (Abs(Candidate."Direct Unit Cost" - PurchLine."Direct Unit Cost") <= AmtTol) then
                Score += 10;
            if (Candidate."Line Amount" <> 0) and (Abs(Candidate."Line Amount" - PurchLine."Line Amount") <= AmtTol) then
                Score += 10;
            if (Candidate.Description <> '') and (PurchLine.Description <> '') and (Candidate.Description = PurchLine.Description) then
                Score += 5;

            if Score > BestScore then begin
                BestScore := Score;
                BestSqzLine := Candidate;
            end;
        until Candidate.Next() = 0;

        // Guard: avoid picking a random line when nothing matches well.
        exit(BestScore >= 30);
    end;
}
```

# Hinzufügen eines Feldes in der Validierung (bis Squeeze BC APP Version 1.*)

Im Folgenden wird anhand einer Beispielextension dargestellt, wie man als Entwickler Felder in der Validierung hinzufügen kann.

#### Benötigte Integration Events inkl. beispielhafter Prozeduren:

<div id="bkmrk-"></div>```Powershell
codeunit 50100 EventSubs
{
    //
    //Any header field that you want to transfer to the resulting document, has to be added to the source JSON Object
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforeAddLineToDocumentJObj', '', false, false)]
    local procedure SQZDocMgtOnBeforeAddLineToDocumentJObj(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")
    begin
        AddCustomHeaderFieldsToJson(DocumentJObj, DocHeader);
    end;

    //
    // Any line field that you want to transfer to the resulting document, has to be added to the source JSON Object
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforeAddLineJObjToLineJArray', '', false, false)]
    local procedure SQZDocMgtOnBeforeAddLineJObjToLineJArray(var LineJObj: JsonObject; DocLine: Record "DXP SQZ Document Line")
    begin
        AddCustomLineFieldsToJson(LineJObj, DocLine);
    end;

    //
    // [If you want to perform plausibility checks on the newly added header field, this is the place]
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnAfterDoHeaderPlausibilityChecks', '', false, false)]
    local procedure SQZDocMgtOnBeforeDoHeaderPlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
    begin
        CheckCustomer(PlausibilityCheck, DocHeader."Customer No.");
    end;

    //
    // [If you want to perform plausibility checks on the newly added line field, this is the place]
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnAfterDoLinePlausibilityChecks', '', false, false)]
    local procedure SQZDocMgtOnAfterDoLinePlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; DocLine: Record "DXP SQZ Document Line"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
    begin
        CheckCustomer(PlausibilityCheck, DocLine."Customer No.");
    end;

    //
    // The value of the previously extended JSON Object now has to saved to the corresponding field in the SQUEEZE Document Line
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforeModifySQUEEZEDocumentHeader', '', false, false)]
    local procedure SqzDocMgtOnBeforeModifySQUEEZEDocumentHeader(var DocHeader: Record "DXP SQZ Document Header"; RawJson: JsonObject)
    var
        JSONHelper: Codeunit "DXP Json Helper";
        SQZApiTokenMgt: Codeunit "DXP SQZ API Token Mgt.";
        TokenMgt: Codeunit TokenMgt;
    begin
        DocHeader."Customer No." := COPYSTR(JsonHelper.ValAsTxt(RawJson, SQZApiTokenMgt.GetHeaderValueByNameTok(TokenMgt.GetCustomerNoTok()), false), 1, MaxStrLen(DocHeader."Customer No."));
    end;

    //
    // The value of the previously extended JSON Object now has to saved to the corresponding field in the SQUEEZE Document Header
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues', '', false, false)]
    local procedure SQZDocMgtOnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues(RowJTok: JsonToken; var DocLine: Record "DXP SQZ Document Line")
    var
        JSONHelper: Codeunit "DXP Json Helper";
        SQZApiTokenMgt: Codeunit "DXP SQZ API Token Mgt.";
        TokenMgt: Codeunit TokenMgt;
    begin
        DocLine."Customer No." := CopyStr(JsonHelper.ValAsTxt(RowJTok.AsObject(), SQZApiTokenMgt.GetCellValueTok(TokenMgt.GetCustomerNoTok()), false), 1, MaxStrLen(DocLine."Customer No."));
    end;

    //
    // The newly added fields now have to be added to the field mapping
    // Otherwise the recognized values will be saved as meta data
    // This step is necessary to make sure that the fields can be highlighted in the SQUEEZE Viewer
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnAfterInitMapping', '', false, false)]
    local procedure SQZApiMgtOnAfterInitMapping(var HeaderMapping: Dictionary of [Text, Integer]; var LineMapping: Dictionary of [Text, Integer]; DocClass: Enum "DXP Document Class")
    var
        SQZDocHeader: Record "DXP SQZ Document Header";
        SQZDocLine: Record "DXP SQZ Document Line";
        TokenMgt: Codeunit TokenMgt;
    begin
        // The standard (without installed extensions) supports one Document Class
        case DocClass of
            DocClass::"DXP Invoice / Credit Memo":
                begin
                    HeaderMapping.Add(TokenMgt.GetCustomerNoTok(), SQZDocHeader.FieldNo("Customer No."));
                    LineMapping.Add(TokenMgt.GetCustomerNoTok(), SQZDocLine.FieldNo("Customer No."));
                end;
        end;
    end;

    //
    // The value in the JSON Object now has to be transferred to the Purchase Header
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Transfer Mgt.", 'OnAfterCreatePurchaseHeader', '', false, false)]
    local procedure DocTransferMgtOnAfterCreatePurchaseHeader(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header")
    begin
        TransferCustomHeaderFieldFromJsonToPurchaseHeader(JObject, PurchaseHeader);
    end;

    //
    // The value in the JSON Object now has to be transferred to the Purchase Line
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Transfer Mgt.", 'OnBeforeInsertPurchaseLine', '', false, false)]
    local procedure DocTransferMgtOnAfterInsertPurchaseLineOnBeforeAddDimensions(var JObjectLine: JsonObject; var PurchaseLine: Record "Purchase Line")
    begin
        TransferCustomHeaderFieldFromJsonToPurchaseLine(JObjectLine, PurchaseLine);
    end;
    
    local procedure TransferCustomHeaderFieldFromJsonToPurchaseHeader(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header")
    var
        JsonHelper: Codeunit "DXP Json Helper";
        TokenMgt: Codeunit TokenMgt;
    begin
        PurchaseHeader.Validate("DXP Customer No.", JsonHelper.ValAsTxt(JObject, TokenMgt.GetCustomerNoTok(), false));
        PurchaseHeader.Modify();
    end;

    local procedure TransferCustomHeaderFieldFromJsonToPurchaseLine(var JObjectLine: JsonObject; var PurchaseLine: Record "Purchase Line")
    var
        JsonHelper: Codeunit "DXP Json Helper";
        TokenMgt: Codeunit TokenMgt;
    begin
        PurchaseLine.Validate("DXP Customer No.", JsonHelper.ValAsTxt(JObjectLine, TokenMgt.GetCustomerNoTok(), false));
    end;

    local procedure AddCustomHeaderFieldsToJson(var DocumentJObj: JsonObject; SQZDocumentHeader: Record "DXP SQZ Document Header")
    var
        TokenMgt: Codeunit TokenMgt;
    begin
        DocumentJObj.Add(TokenMgt.GetCustomerNoTok(), SQZDocumentHeader."Customer No.");
    end;

    local procedure AddCustomLineFieldsToJson(var LineJObj: JsonObject; SQZDocumentLine: Record "DXP SQZ Document Line")
    var
        TokenMgt: Codeunit TokenMgt;
    begin
        LineJObj.Add(TokenMgt.GetCustomerNoTok(), SQZDocumentLine."Customer No.");
    end;

    [TryFunction]
    local procedure CustomerExists(CustomerNo: Code[20])
    var
        Customer: Record Customer;
    begin
        Customer.Get(CustomerNo);
    end;

    local procedure CheckCustomer(var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt."; CustomerNo: Code[20]): Boolean
    begin
        if CustomerNo = '' then
            exit(false);

        if not CustomerExists(CustomerNo) then begin
            PlausibilityCheck.AddPlausibilityCheckEntry(GetLastErrorText(), Page::"Customer List");
            exit(false);
        end;

        exit(true);
    end;
}
```

#### Table Extensions:

##### SQUEEZE 4 BC

```Python
tableextension 50100 "SQZ Doc. Header Ext." extends "DXP SQZ Document Header"
{
    fields
    {
        field(50100; "Customer No."; Code[20])
        {
            TableRelation = Customer;
            ValidateTableRelation = false;
            Caption = 'Customer No.';
        }
    }
}
```

```Python
tableextension 50101 "SQZ Doc. Line Ext." extends "DXP SQZ Document Line"
{
    fields
    {
        field(50100; "Customer No."; Code[20])
        {
            TableRelation = Customer;
            ValidateTableRelation = false;
            Caption = 'Customer No.';
        }
    }
}
```

##### Zielbeleg (hier: Einkaufsbeleg)

```Python
tableextension 50102 "Purchase Header Ext." extends "Purchase Header"
{
    fields
    {
        field(50100; "DXP Customer No."; Code[20])
        {
            DataClassification = CustomerContent;
            TableRelation = Customer;
            Caption = 'DEXPRO Customer No.';
        }
    }
}
```

#### Page Extensions:

##### SQUEEZE 4 BC

```Python
pageextension 50100 "SQZ Document Ext." extends "DXP SQZ Document"
{
    layout
    {
        addafter(BuyFromVendorInternal)
        {
            field("Customer No. Internal"; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
                trigger OnAssistEdit()
                begin
                    MarkField(Rec.FieldNo("Customer No."), Rec."Customer No.", Rec);
                end;

                trigger OnValidate()
                begin
                    CheckPlausibility();
                end;
            }
        }
        addafter(BuyFromVendor)
        {
            field("Customer No."; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
                trigger OnAssistEdit()
                var
                    ApiMgt: Codeunit "DXP SQZ API Mgt.";
                    ViewerResident: Codeunit "DXP SQUEEZE Viewer Resident";
                begin
                    MarkField(Rec.FieldNo("Customer No."), Rec."Customer No.", Rec);
                end;

                trigger OnValidate()
                begin
                    CheckPlausibility();
                end;
            }
        }
    }

    local procedure MarkField(AppFldNo: Integer; FieldVal: Variant; DocHeader: Record "DXP SQZ Document Header")
    var
        ApiMgt: Codeunit "DXP SQZ API Mgt.";
        ViewerResident: Codeunit "DXP SQUEEZE Viewer Resident";
    begin
        ViewerResident := GetViewerResident();
        ApiMgt.MarkField(AppFldNo, FieldVal, ViewerResident, DocHeader);
    end;
}

```

```Python
pageextension 50101 "SQZ Document Sf. Ext." extends "DXP SQZ Document Subform"
{
    layout
    {
        addafter("No.")
        {
            field("Customer No."; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
            }
        }
    }
}

```

##### Zielbeleg (hier: Einkaufsbeleg)

```Python
pageextension 50102 "Purchase Invoice Ext." extends "Purchase Invoice"
{
    layout
    {
        addafter("Buy-from Vendor No.")
        {
            field("DXP Customer No."; Rec."DXP Customer No.")
            {
                ToolTip = 'Specifies the value of the DEXPRO Customer No. field.';
                ApplicationArea = all;
            }
        }
    }
}

```

```Python
pageextension 50103 "Purchase Inv. Sf Ext." extends "Purch. Invoice Subform"
{
    layout
    {
        addafter("No.")
        {
            field("DXP Customer No."; Rec."DXP Customer No.")
            {
                ToolTip = 'Specifies the value of the DEXPRO Customer No. field.';
                ApplicationArea = all;
            }
        }
    }
}

```

##### Optionale Hilfsobjekte:

```Python
codeunit 50101 TokenMgt
{
    procedure GetCustomerNoTok(): Text
    begin
        exit(CustomerNoTok);
    end;

    var
        CustomerNoTok: Label 'customerNo', Locked = true;
}
```

# Hinzufügen eines Feldes in der Validierung (ab Version 2.0)

Im Folgenden wird anhand einer Beispielextension dargestellt, wie man als Entwickler Felder in der Validierung hinzufügen kann (hier: Dokumentenklasse Rechnung/Gutschrift).

#### Benötigte Integration Events inkl. beispielhafter Prozeduren:

<div id="bkmrk-"></div>```Powershell
codeunit 50100 EventSubs
{
    //
    //Any header field that you want to transfer to the resulting document, has to be added to the source JSON Object
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnBeforeAddLineToDocumentJObj', '', false, false)]
    local procedure SQZPInvCrdtMemoImplOnBeforeAddLineToDocumentJObj(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")
    begin
        AddCustomHeaderFieldsToJson(DocumentJObj, DocHeader);
    end;

    //
    // Any line field that you want to transfer to the resulting document, has to be added to the source JSON Object
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnBeforeAddLineJObjToLineJArray', '', false, false)]
    local procedure SQZPInvCrdtMemoImplOnBeforeAddLineJObjToLineJArray(var LineJObj: JsonObject; DocLine: Record "DXP SQZ Document Line")
    begin
        AddCustomLineFieldsToJson(LineJObj, DocLine);
    end;

    //
    // [If you want to perform plausibility checks on the newly added header field, this is the place]
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnAfterDoHeaderPlausibilityChecks', '', false, false)]
    local procedure SQZPInvCrdtMemoImplOnBeforeDoHeaderPlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
    begin
        CheckCustomer(PlausibilityCheck, DocHeader."Customer No.");
    end;

    //
    // [If you want to perform plausibility checks on the newly added line field, this is the place]
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.", 'OnAfterDoLinePlausibilityChecks', '', false, false)]
    local procedure SQZPInvCrdtMemoImplOnAfterDoLinePlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; DocLine: Record "DXP SQZ Document Line"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
    begin
        CheckCustomer(PlausibilityCheck, DocLine."Customer No.");
    end;

    //
    // The value of the previously extended JSON Object now has to saved to the corresponding field in the SQUEEZE Document Line
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforeModifySQUEEZEDocumentHeader', '', false, false)]
    local procedure SqzDocMgtOnBeforeModifySQUEEZEDocumentHeader(var DocHeader: Record "DXP SQZ Document Header"; RawJson: JsonObject)
    var
        JSONHelper: Codeunit "DXP Json Helper";
        SQZApiTokenMgt: Codeunit "DXP SQZ API Token Mgt.";
        TokenMgt: Codeunit TokenMgt;
    begin
        DocHeader."Customer No." := COPYSTR(JsonHelper.ValAsTxt(RawJson, SQZApiTokenMgt.GetHeaderValueByNameTok(TokenMgt.GetCustomerNoTok()), false), 1, MaxStrLen(DocHeader."Customer No."));
    end;

    //
    // The value of the previously extended JSON Object now has to saved to the corresponding field in the SQUEEZE Document Header
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.", 'OnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues', '', false, false)]
    local procedure SQZDocMgtOnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues(RowJTok: JsonToken; var DocLine: Record "DXP SQZ Document Line")
    var
        JSONHelper: Codeunit "DXP Json Helper";
        SQZApiTokenMgt: Codeunit "DXP SQZ API Token Mgt.";
        TokenMgt: Codeunit TokenMgt;
    begin
        DocLine."Customer No." := CopyStr(JsonHelper.ValAsTxt(RowJTok.AsObject(), SQZApiTokenMgt.GetCellValueTok(TokenMgt.GetCustomerNoTok()), false), 1, MaxStrLen(DocLine."Customer No."));
    end;

    //
    // The newly added fields now have to be added to the field mapping
    // Otherwise the recognized values will be saved as meta data
    // This step is also necessary to make sure that the fields can be highlighted in the SQUEEZE Viewer
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnAfterInitMapping', '', false, false)]
    local procedure SQZApiMgtOnAfterInitMapping(var HeaderMapping: Dictionary of [Text, Integer]; var LineMapping: Dictionary of [Text, Integer]; DocClass: Enum "DXP Document Class")
    var
        SQZDocHeader: Record "DXP SQZ Document Header";
        SQZDocLine: Record "DXP SQZ Document Line";
        TokenMgt: Codeunit TokenMgt;
    begin
        case DocClass of
            DocClass::"DXP Invoice / Credit Memo":
                begin
                    HeaderMapping.Add(TokenMgt.GetCustomerNoTok(), SQZDocHeader.FieldNo("Customer No."));
                    LineMapping.Add(TokenMgt.GetCustomerNoTok(), SQZDocLine.FieldNo("Customer No."));
                end;
        end;
    end;

    //
    // The value in the JSON Object now has to be transferred to the Purchase Header
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Transfer Mgt.", 'OnAfterCreatePurchaseHeader', '', false, false)]
    local procedure DocTransferMgtOnAfterCreatePurchaseHeader(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header")
    begin
        TransferCustomHeaderFieldFromJsonToPurchaseHeader(JObject, PurchaseHeader);
    end;

    //
    // The value in the JSON Object now has to be transferred to the Purchase Line
    //
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Transfer Mgt.", 'OnBeforeInsertPurchaseLine', '', false, false)]
    local procedure DocTransferMgtOnAfterInsertPurchaseLineOnBeforeAddDimensions(var JObjectLine: JsonObject; var PurchaseLine: Record "Purchase Line")
    begin
        TransferCustomHeaderFieldFromJsonToPurchaseLine(JObjectLine, PurchaseLine);
    end;
    
    local procedure TransferCustomHeaderFieldFromJsonToPurchaseHeader(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header")
    var
        JsonHelper: Codeunit "DXP Json Helper";
        TokenMgt: Codeunit TokenMgt;
    begin
        PurchaseHeader.Validate("DXP Customer No.", JsonHelper.ValAsTxt(JObject, TokenMgt.GetCustomerNoTok(), false));
        PurchaseHeader.Modify();
    end;

    local procedure TransferCustomHeaderFieldFromJsonToPurchaseLine(var JObjectLine: JsonObject; var PurchaseLine: Record "Purchase Line")
    var
        JsonHelper: Codeunit "DXP Json Helper";
        TokenMgt: Codeunit TokenMgt;
    begin
        PurchaseLine.Validate("DXP Customer No.", JsonHelper.ValAsTxt(JObjectLine, TokenMgt.GetCustomerNoTok(), false));
    end;

    local procedure AddCustomHeaderFieldsToJson(var DocumentJObj: JsonObject; SQZDocumentHeader: Record "DXP SQZ Document Header")
    var
        TokenMgt: Codeunit TokenMgt;
    begin
        DocumentJObj.Add(TokenMgt.GetCustomerNoTok(), SQZDocumentHeader."Customer No.");
    end;

    local procedure AddCustomLineFieldsToJson(var LineJObj: JsonObject; SQZDocumentLine: Record "DXP SQZ Document Line")
    var
        TokenMgt: Codeunit TokenMgt;
    begin
        LineJObj.Add(TokenMgt.GetCustomerNoTok(), SQZDocumentLine."Customer No.");
    end;

    [TryFunction]
    local procedure CustomerExists(CustomerNo: Code[20])
    var
        Customer: Record Customer;
    begin
        Customer.Get(CustomerNo);
    end;

    local procedure CheckCustomer(var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt."; CustomerNo: Code[20]): Boolean
    begin
        if CustomerNo = '' then
            exit(false);

        if not CustomerExists(CustomerNo) then begin
            PlausibilityCheck.AddPlausibilityCheckEntry(GetLastErrorText(), Page::"Customer List");
            exit(false);
        end;

        exit(true);
    end;
}
```

#### Table Extensions:

##### SQUEEZE 4 BC

```Python
tableextension 50100 "SQZ Doc. Header Ext." extends "DXP SQZ Document Header"
{
    fields
    {
        field(50100; "Customer No."; Code[20])
        {
            TableRelation = Customer;
            ValidateTableRelation = false;
            Caption = 'Customer No.';
        }
    }
}
```

```Python
tableextension 50101 "SQZ Doc. Line Ext." extends "DXP SQZ Document Line"
{
    fields
    {
        field(50100; "Customer No."; Code[20])
        {
            TableRelation = Customer;
            ValidateTableRelation = false;
            Caption = 'Customer No.';
        }
    }
}
```

##### Zielbeleg (hier: Einkaufsbeleg)

```Python
tableextension 50102 "Purchase Header Ext." extends "Purchase Header"
{
    fields
    {
        field(50100; "DXP Customer No."; Code[20])
        {
            DataClassification = CustomerContent;
            TableRelation = Customer;
            Caption = 'DEXPRO Customer No.';
        }
    }
}
```

#### Page Extensions:

##### SQUEEZE 4 BC

```Python
pageextension 50100 "SQZ Document Ext." extends "DXP SQZ Document v2"
{
    layout
    {
        addafter(BuyFromVendorInternal)
        {
            field("Customer No. Internal"; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
                trigger OnAssistEdit()
                begin
                    MarkField(Rec.FieldNo("Customer No."), Rec."Customer No.", Rec);
                end;

                trigger OnValidate()
                begin
                    CheckPlausibility();
                end;
            }
        }
        addafter(BuyFromVendorExternal)
        {
            field("Customer No."; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
                trigger OnAssistEdit()
                var
                    ApiMgt: Codeunit "DXP SQZ API Mgt.";
                    ViewerResident: Codeunit "DXP SQUEEZE Viewer Resident";
                begin
                    MarkField(Rec.FieldNo("Customer No."), Rec."Customer No.", Rec);
                end;

                trigger OnValidate()
                begin
                    CheckPlausibility();
                end;
            }
        }
    }

    local procedure MarkField(AppFldNo: Integer; FieldVal: Variant; DocHeader: Record "DXP SQZ Document Header")
    var
        ApiMgt: Codeunit "DXP SQZ API Mgt.";
        ViewerResident: Codeunit "DXP SQUEEZE Viewer Resident";
    begin
        ViewerResident := GetViewerResident();
        ApiMgt.MarkField(AppFldNo, FieldVal, ViewerResident, DocHeader);
    end;
}

```

```Python
pageextension 50101 "SQZ Document Sf. Ext." extends "DXP SQZ Document Subform"
{
    layout
    {
        addafter("No.")
        {
            field("Customer No."; Rec."Customer No.")
            {
                ApplicationArea = All;
                ToolTip = 'Specifies the value of the Customer No. field.';
            }
        }
    }
}

```

##### Zielbeleg (hier: Einkaufsbeleg)

```Python
pageextension 50102 "Purchase Invoice Ext." extends "Purchase Invoice"
{
    layout
    {
        addafter("Buy-from Vendor No.")
        {
            field("DXP Customer No."; Rec."DXP Customer No.")
            {
                ToolTip = 'Specifies the value of the DEXPRO Customer No. field.';
                ApplicationArea = all;
            }
        }
    }
}

```

```Python
pageextension 50103 "Purchase Inv. Sf Ext." extends "Purch. Invoice Subform"
{
    layout
    {
        addafter("No.")
        {
            field("DXP Customer No."; Rec."DXP Customer No.")
            {
                ToolTip = 'Specifies the value of the DEXPRO Customer No. field.';
                ApplicationArea = all;
            }
        }
    }
}

```

##### Optionale Hilfsobjekte:

```Python
codeunit 50101 TokenMgt
{
    procedure GetCustomerNoTok(): Text
    begin
        exit(CustomerNoTok);
    end;

    var
        CustomerNoTok: Label 'customerNo', Locked = true;
}
```

# Regelbasierter nächster Prozessschritt: Belege in „Individuelle Verarbeitung“ steuern

## Zielgruppe

Diese Anleitung richtet sich an Entwickler und Implementierer, die DEXPRO SQUEEZE in Business Central einsetzen und **vor** der eigentlichen „[Individuelle Verarbeitung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/erstellung-benutzerdefinierter-dokumente-individuelle-verarbeitung "Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)")“-Implementierung steuern möchten, **welche** Belege nach der Validierung in den Status **„Individuelle Verarbeitung“** wechseln sollen.

## Einordnung (kommt *vor* der bestehenden Custom-Processing-Anleitung)

Mit dieser Konfiguration sorgst du dafür, dass ein Beleg (abhängig von Regeln) den Status **„Individuelle Verarbeitung“** erhält. **Ab diesem Zeitpunkt** greift dann der in der bestehenden Dokumentation beschriebene Ablauf zur benutzerdefinierten Verarbeitung ([Erstellen von Zieldokumenten aus „JSON Processed“](https://docs.squeeze.one/link/862#bkmrk-%C3%9Cberblick-0 "Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)")).

Weiterführend (nächster Schritt, nach dieser Dokumentation):

- [Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/erstellung-benutzerdefinierter-dokumente-individuelle-verarbeitung "Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)")

## Verwendete (UI-)Begriffe

Die nachfolgenden Begriffe entsprechen den deutschen Beschriftungen aus den de-DE Übersetzungen:

- **„Individuelle Verarbeitung“** = `DXP Document Status` / `Custom Processing`
- **„Nächster Prozessschritt“** = `Next Process Step`
- **„Standardbeleg“** = Enum-Wert `Standard document`
- **„Regelsatz“**, **„Regelsatzcode“** = `Rule Set`, `Rule Set Code`
- **„Regelgruppe“**, **„Regelgruppencode“** = `Rule Group`, `Rule Group Code`

## Technischer Hintergrund

- Pro **Dokumentenklasse** gibt es eine **Dokumentenklasseneinrichtung** (`DXP Document Class Setup`).
- Für jede Dokumentenklasseneinrichtung wird automatisch ein SQUEEZE-Regelsatz angelegt (intern: Feld **„DXP Sqz Rule Set Code“**).
- In der Dokumentenklasseneinrichtung wird ein **Regelgruppencode** hinterlegt (intern: Feld **„DXP Sqz Next Step Rule Group“**).
- Beim Ermitteln des nächsten Prozessschritts werden die Regeln dieser Regelgruppe ausgewertet.
- Wenn eine Regel zutrifft und 
    - **Nächster Prozessschritt = „Standardbeleg“** und
    - **Individuelle Verarbeitung = Ja** dann wird der Dokumentstatus auf **„Individuelle Verarbeitung“** gesetzt.

Wichtig:

- Ist **keine** Regelgruppe hinterlegt oder **keine** Regel zutreffend, wird auf den Standardwert „Nächster Prozessschritt“ aus der Dokumentenklasseneinrichtung zurückgefallen.

## Voraussetzungen

- DEXPRO Core + DEXPRO SQUEEZE sind installiert.
- Du hast Zugriff auf die Einrichtung **Dokumentenklasseneinrichtung** (DXP Document Class Setup) sowie auf die Regel-Engine-Seiten (Regelgruppen/Regeln).

## Schritt-für-Schritt: Regelgruppe „DXP Sqz Next Step Rule Group“ anlegen und verknüpfen

### 1) Dokumentenklasseneinrichtung öffnen

1. Öffne die Seite **Dokumentenklasseneinrichtung**.
2. Wähle die Dokumentenklasse aus, für die du das Routing auf **„Individuelle Verarbeitung“** aktivieren willst.
3. Scrolle in den Bereich **Squeeze** → Gruppe **Regeln**.

[![image-1770121643866.png](https://docs.squeeze.one/uploads/images/gallery/2026-02/scaled-1680-/image-1770121643866.png)](https://docs.squeeze.one/uploads/images/gallery/2026-02/image-1770121643866.png)

### 2) Regelgruppe anlegen

1. In **Squeeze → Rules** wähle das Feld **„Nächster Prozessschritt“** (technisch: *DXP Sqz Next Step Rule Group*).
2. Öffne die **Auswahl/Lookup** (Regelgruppenliste).
3. Lege eine neue **Regelgruppe** an: 
    - **Regelgruppencode**: z. B. `Next Step Rules`
    - **Beschreibung**: z. B. „Routing nach Individuelle Verarbeitung“

Hinweis: Der Lookup ist durch die Dokumentenklasse bereits auf den passenden **Regelsatzcode** gefiltert. Du musst den Regelsatz nicht manuell suchen.

[![image-1770121713883.png](https://docs.squeeze.one/uploads/images/gallery/2026-02/scaled-1680-/image-1770121713883.png)](https://docs.squeeze.one/uploads/images/gallery/2026-02/image-1770121713883.png)

### 3) Regelgruppe in der Dokumentenklasseneinrichtung speichern

1. Stelle sicher, dass in der Dokumentenklasseneinrichtung im Feld **„Nächster Prozessschritt“** jetzt der Regelgruppencode `DXP Sqz Next Step Rule Group` steht.

[![image-1770121741544.png](https://docs.squeeze.one/uploads/images/gallery/2026-02/scaled-1680-/image-1770121741544.png)](https://docs.squeeze.one/uploads/images/gallery/2026-02/image-1770121741544.png)

## Schritt-für-Schritt: Regel erstellen, die auf „Individuelle Verarbeitung“ routet

### 4) Regeln der Regelgruppe öffnen

1. Öffne die soeben angelegte **Regelgruppe** `DXP Sqz Next Step Rule Group`.
2. Wähle die Aktion **„Regeln anzeigen“** (öffnet die Regeln dieser Regelgruppe).

[![image-1770121790623.png](https://docs.squeeze.one/uploads/images/gallery/2026-02/scaled-1680-/image-1770121790623.png)](https://docs.squeeze.one/uploads/images/gallery/2026-02/image-1770121790623.png)

### 5) Neue Regel anlegen

1. Lege eine neue **Regel** an.
2. Lege eine sinnvolle **Priorität** fest (niedriger Wert = höhere Priorität, falls eure Umgebung so konfiguriert ist).
3. Definiere die **Bedingungen** (Rule Conditions), die zutreffen müssen.

\[Best Practice\] Starte mit einer sehr klaren, testbaren Bedingung (z. B. anhand von Belegtyp, Lieferant, Betragsschwellen, Mandant/Company, etc.), bevor du komplexe Regelketten aufbaust.

[![image-1770121891420.png](https://docs.squeeze.one/uploads/images/gallery/2026-02/scaled-1680-/image-1770121891420.png)](https://docs.squeeze.one/uploads/images/gallery/2026-02/image-1770121891420.png)

### 6) SQUEEZE-spezifische Felder setzen (entscheidend für „Individuelle Verarbeitung“)

Auf der Regelkarte gibt es den Bereich **„DEXPRO Squeeze“** (CardPart). Setze dort:

1. **Nächster Prozessschritt** = **„Standardbeleg“**
2. **Individuelle Verarbeitung** = **Ja**

Ergebnis:

- Wenn diese Regel zutrifft, wird der Belegstatus auf **„Individuelle Verarbeitung“** gesetzt.

[![image-1770121986406.png](https://docs.squeeze.one/uploads/images/gallery/2026-02/scaled-1680-/image-1770121986406.png)](https://docs.squeeze.one/uploads/images/gallery/2026-02/image-1770121986406.png)

Optional:

- **Kontierungscode** \[*Account Assignment Code*\] (falls du zusätzlich eine Kontierungslogik über Regeln steuern möchtest; unabhängig vom Custom-Processing-Routing).

## Prüfen / Troubleshooting

### Beleg landet *nicht* in „Individuelle Verarbeitung“

Gehe diese Punkte durch:

1. **Regelgruppe hinterlegt?** In der Dokumentenklasseneinrichtung muss der Regelgruppencode gesetzt sein (sonst fällt das System auf Standard „**Nächster Prozessschritt**“ zurück).
2. **Trifft eine Regel zu?** Wenn keine Regel zutrifft, wird der nächste Prozessschritt nicht überschrieben.
3. **Ist „Individuelle Verarbeitung“ gesetzt UND Next Step = „Standardbeleg“?**
    - Wenn „Individuelle Verarbeitung“ = Ja, aber Next Step ≠ „Standardbeleg“, wird der Status nicht auf „Individuelle Verarbeitung“ gesetzt.
4. **Siehst du den Bereich „DEXPRO Squeeze“ auf der Regelkarte nicht?**
    - Dann befindest du dich sehr wahrscheinlich in einem Regelsatz, der nicht zur Dokumentenklasseneinrichtung (Quelltabelle) gehört.
    - Lege die Regelgruppe im besten Fall über den Lookup aus der Dokumentenklasseneinrichtung an. Damit sparst du dir den Weg über die allgemeine Regelverwaltng

### Beleg landet in „Fertig“ statt „Individuelle Verarbeitung“

Wenn eine Regel zutrifft und **Nächster Prozessschritt** auf einen Wert ungleich „Standardbeleg“ gesetzt wird, kann der Status auf **„Fertig“** gesetzt werden (damit wird weitere Verarbeitung übersprungen). Prüfe daher die Next-Step-Auswahl in der Regel. Das ist zum Beispiel der Fall, wenn die App [Breeze Interface](https://docs.squeeze.one/books/dexpro-microsoft-dynamics-365-business-central-apps/chapter/dexpro-breeze-interface "DEXPRO Breeze Interface") benutzt wird.

### Danach (Übergang in die bestehende [Doku, zur individuellen Belegerstellung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/erstellung-benutzerdefinierter-dokumente-individuelle-verarbeitung "Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)"))

Sobald ein Beleg im Status **„Individuelle Verarbeitung“** ist, ist es bereit für die Verarbeitung:

- „JSON Processed“ aus `DXP Document` lesen
- Zieldokumente erstellen
- finalen Status setzen

# Events nach der Erstellung eines SQUEEZE-Belegs (CreateSource)

## Zielgruppe

Diese Dokumentation richtet sich an Drittanbieter-Entwickler, die den **Erstellungsprozess eines SQUEEZE-Belegs** (Tabellen `DXP SQZ Document Header`/`DXP SQZ Document Line`) erweitern möchten.

Im Fokus stehen die **Integration Events**, die *nach* bzw. *während* `ISourceDocument.CreateSource(...)` ausgelöst werden.

## Einordnung: Wo wird `CreateSource` aufgerufen?

Der Einstiegspunkt für die SQUEEZE-Integration ist in der Codeunit **`DXP SQZ API Mgt.`**:

- Es wird ein Core-Beleg (`DXP Document`) angelegt (über `DXP Document Mgt.`).
- Anschließend wird über die Dokumentenklasse das Interface **`DXP ISource Document`** aufgelöst und `CreateSource(Document)` ausgeführt.

Vereinfachter Ablauf (aus `CreateCoreAndSQUEEZEDocument`):

1. `DocumentMgt.AddDocument(DocClass, ...)` (Core-Beleg anlegen)
2. `ISourceDocument.CreateSource(Document)` (SQUEEZE-Beleg erzeugen)
3. Import-Queue verarbeiten / SQUEEZE-Dokument „finishen“

## Dokumentenklassen &amp; Default-Verhalten

Welche `CreateSource`-Implementierung ausgeführt wird, ist in der Enum-Erweiterung **`DXP Document Class Ext.`** hinterlegt.

- **`DXP Invoice / Credit Memo`** → Codeunit **`DXP SQZ P. Inv/Crdt Memo Impl.`**
- **`DXP Order Confirmation`** → Codeunit **`DXP SQZ P. Order Conf. Impl.`**

**Default (wenn keine spezifische Implementierung gesetzt ist):** Die Enum `DXP Document Class` definiert eine `DefaultImplementation` auf **`DXP Source Document Def. Impl.`**. Diese Default-Implementierung:

- erzeugt **keinen** SQUEEZE-Beleg,
- `CreateSource(...)` gibt **`false`** zurück.

## Gemeinsame Pipeline innerhalb `CreateSource`

Beide SQUEEZE-Implementierungen folgen (verkürzt) diesem Muster:

1. Guard: Core-Dokument muss `Status = Imported` haben und `JSON Raw` muss existieren.
2. `DXP SQZ Document Mgt.`: 
    - `CreateSQUEEZEDocHeader(Document, DocHeader, RawJson)`
    - `CreateSQUEEZEDocLine(DocHeader, RawJson)`
3. `DXP Document Mgt.`: `UpdateDocumentAfterTransfer(...)` (Core-Dokument auf „Transferred“ setzen und mit SQZ-Header verknüpfen)
4. Ordermatch / Autocomplete / Attachments / Validierung (abhängig von Dokumentenklasse und Setup)

Die wichtigsten Events hängen daher an:

- der Header-/Line-Erzeugung in `DXP SQZ Document Mgt.`
- dem Abschluss der `CreateSource`-Prozedur in den jeweiligen Implementierungen
- optionalen Schritten wie Ordermatch oder Validierung

## Event-Matrix (Kurzüberblick)

<table id="bkmrk-bereich-event-zeitpu"><thead><tr><th>Bereich</th><th>Event</th><th>Zeitpunkt</th><th>Steuerung</th><th>Typische Use-Cases</th></tr></thead><tbody><tr><td>`DXP SQZ API Mgt.`</td><td>[`OnAfterInitMapping(...)`](https://docs.squeeze.one/link/939#bkmrk-onafterinitmapping)</td><td>nach Initialisierung Mapping/Token-Kontext</td><td>–</td><td>Mapping erweitern/prüfen</td></tr><tr><td>`DXP SQZ API Mgt.`</td><td>[`OnAfterSaveAttachment(...)`](https://docs.squeeze.one/link/939#bkmrk-onaftersaveattachmen)</td><td>nach erfolgreichem Speichern eines Attachments</td><td>–</td><td>Nachverarbeitung/Indexierung</td></tr><tr><td>`DXP SQZ API Mgt.`</td><td>[`OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment(...)`](https://docs.squeeze.one/link/939#bkmrk-onaftersetoriginfile)</td><td>vor dem Modify des Attachment-Datensatzes</td><td>–</td><td>Dateiname/Origin beeinflussen</td></tr><tr><td>`DXP SQZ P. Inv/Crdt Memo Impl.`</td><td>[`OnAfterCreateDocLines`](https://docs.squeeze.one/link/939#bkmrk-onaftercreatedocline)</td><td>direkt nach `CreateSQUEEZEDocLine(...)`</td><td>–</td><td>Lines/RawJson nach Anlage auswerten</td></tr><tr><td>`DXP SQZ P. Inv/Crdt Memo Impl.`</td><td>[`OnAfterCreateSource`](https://docs.squeeze.one/link/939#bkmrk-onaftercreatesource)</td><td>am Ende von `CreateSource(...)`</td><td>–</td><td>Post-Aktionen nach Autocomplete/Ordermatch/Validierung</td></tr><tr><td>`DXP SQZ P. Inv/Crdt Memo Impl.`</td><td>[`OnBeforeDoPlausibilityChecks`](https://docs.squeeze.one/link/939#bkmrk-plausibilit%C3%A4tspr%C3%BCfun)</td><td>vor Plausibilitätschecks</td><td>`IsHandled`</td><td>Checks ersetzen/erweitern</td></tr><tr><td>`DXP SQZ P. Inv/Crdt Memo Impl.`</td><td>[`OnAfterDoPlausibilityChecks`](https://docs.squeeze.one/link/939#bkmrk-plausibilit%C3%A4tspr%C3%BCfun)</td><td>nach Plausibilitätschecks</td><td>–</td><td>Ergebnis weiterverwenden (Entries)</td></tr><tr><td>`DXP SQZ P. Order Conf. Impl.`</td><td>[`OnBeforeDoPlausibilityChecks`](https://docs.squeeze.one/link/939#bkmrk-plausibilit%C3%A4tspr%C3%BCfun-0)</td><td>vor Plausibilitätschecks</td><td>`IsHandled`</td><td>Checks ersetzen/erweitern</td></tr><tr><td>`DXP SQZ Document Mgt.`</td><td>[`OnBeforeModifySQUEEZEDocumentHeader`](https://docs.squeeze.one/link/939#bkmrk-onbeforemodifysqueez)</td><td>in `CreateSQUEEZEDocHeader(...)` vor finalem Modify</td><td>–</td><td>Headerwerte aus `RawJson` ergänzen/normalisieren</td></tr><tr><td>`DXP SQZ Document Mgt.`</td><td>[`OnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues`](https://docs.squeeze.one/link/939#bkmrk-onbeforetransferreco)</td><td>im Standard-Line-Post-Processing vor `TransferRecognizedValues`</td><td>–</td><td>erkannte Werte pro Line korrigieren</td></tr><tr><td>`DXP SQZ Document Mgt.`</td><td>[`OnAfterTransferRecognizedValuesOnBeforeInsertDocLine`](https://docs.squeeze.one/link/939#bkmrk-onaftertransferrecog)</td><td>im Standard-Line-Post-Processing nach `TransferRecognizedValues`</td><td>–</td><td>line-basierte Ableitungen (Kontierung/Dimensionen)</td></tr><tr><td>`DXP SQZ Document Mgt.`</td><td>[`OnBeforePerformAutomaticOrdermatch`](https://docs.squeeze.one/link/939#bkmrk-onbeforeperformautom)</td><td>vor automatischem Ordermatch</td><td>`IsHandled`</td><td>Ordermatch komplett übernehmen/OrderNoList anpassen</td></tr><tr><td>JSON-Erzeugung</td><td>[`OnBeforeAddLineToDocumentJObj`](https://docs.squeeze.one/link/939#bkmrk-onbeforeaddlinetodoc)</td><td>vor dem Aufbau der Line-Struktur</td><td>–</td><td>Header-JSON erweitern</td></tr><tr><td>JSON-Erzeugung</td><td>[`OnBeforeAddLineJObjToLineJArray`](https://docs.squeeze.one/link/939#bkmrk-onbeforeaddlinejobjt)</td><td>vor `LineJArray.Add(LineJObj)`</td><td>–</td><td>Line-JSON erweitern</td></tr></tbody></table>

---

## Events in `DXP SQZ P. Inv/Crdt Memo Impl.` (Dokumentenklasse: Invoice / Credit Memo)

Diese Codeunit bietet die **stärksten Erweiterungspunkte direkt im `CreateSource`-Ablauf**.

### `OnAfterCreateDocLines`

Wird direkt nach `CreateSQUEEZEDocLine(...)` ausgelöst (also nachdem Header &amp; Lines existieren).

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterCreateDocLines(DocHeader: Record "DXP SQZ Document Header"; RawJson: JsonObject)

```

Typische Use-Cases:

- zusätzliche Initialisierung am Header (z. B. eigene Flags/Felder)
- zusätzliche line-basierte Auswertungen direkt nach Anlage
- eigene Metadaten aus `RawJson` extrahieren

### `OnAfterCreateSource`

Wird am Ende von `CreateSource(...)` ausgelöst (nach Autocomplete/Ordermatch/optionalem Attachment-Download/optionalem Auto-Validate).

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterCreateSource(DocHeader: Record "DXP SQZ Document Header"; RawJson: JsonObject)

```

Typische Use-Cases:

- nachgelagerte Automatisierungen starten (Workflows, Benachrichtigungen)
- zusätzliche Datenvalidierung oder eigene Statuslogik

### Plausibilitätsprüfung-Events

Diese Events betreffen die Methode `IsSourceDataPlausible(...)` und sind relevant, wenn ihr Plausibilitätschecks erweitert/ersetzt.

Signaturen (Auszug):

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeDoPlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; var TempPlausibilityCheckEntry: Record "DXP Plausibility Check Entry" temporary; var IsHandled: Boolean)

[IntegrationEvent(false, false)]
local procedure OnBeforeDoHeaderPlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")

[IntegrationEvent(false, false)]
local procedure OnBeforeDoLinePlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; DocLine: Record "DXP SQZ Document Line"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")

[IntegrationEvent(false, false)]
local procedure OnAfterDoPlausibilityChecks(DocHeader: Record "DXP SQZ Document Header"; var TempPlausibilityCheckEntry: Record "DXP Plausibility Check Entry" temporary)

```

### JSON-Erzeugung (Processed JSON aus dem SQZ-Beleg)

Die Implementierung enthält Events, bevor Line-JSON zur Header-Struktur hinzugefügt wird:

#### `OnBeforeAddLineToDocumentJObj`

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeAddLineToDocumentJObj(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")

```

#### `OnBeforeAddLineJObjToLineJArray`

```al

[IntegrationEvent(false, false)]
local procedure OnBeforeAddLineJObjToLineJArray(var LineJObj: JsonObject; DocLine: Record "DXP SQZ Document Line")

```

Use-Cases:

- zusätzliche Felder ins Header-JSON schreiben
- zusätzliche Felder pro Line ergänzen (Custom Tokens)

---

## Events in `DXP SQZ P. Order Conf. Impl.` (Dokumentenklasse: Order Confirmation)

Diese Codeunit hat **keine** dedizierten `OnAfterCreateSource`-Events in `CreateSource(...)`. Erweiterungen passieren hier typischerweise über:

- `DXP SQZ Document Mgt.` (Header/Line-Erzeugung, Ordermatch)
- die JSON-Erzeugung (`CreateProcessedJsonFromSource`)
- Plausibilitätsprüfung-Events

### JSON-Erzeugung

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeAddLineToDocumentJObj(var DocumentJObj: JsonObject; DocHeader: Record "DXP SQZ Document Header")

[IntegrationEvent(false, false)]
local procedure OnBeforeAddLineJObjToLineJArray(var LineJObj: JsonObject; DocLine: Record "DXP SQZ Document Line")

```

### Plausibilitätsprüfung-Events

Analog zur Invoice/Credit-Memo-Implementierung:

- `OnBeforeDoPlausibilityChecks`
- `OnBeforeDoHeaderPlausibilityChecks`
- `OnBeforeDoLinePlausibilityChecks`
- `OnAfterDoPlausibilityChecks`

---

## Events in `DXP SQZ Document Mgt.` (gemeinsam für alle Dokumentenklassen)

Diese Events sind besonders relevant, weil sie **innerhalb** der Header/Line-Erzeugung und Ordermatch-Pipeline ausgelöst werden.

### `OnBeforeModifySQUEEZEDocumentHeader`

Wird in `CreateSQUEEZEDocHeader(...)` ausgelöst, nachdem Werte über Field Mapping zugewiesen wurden und **bevor** der Header final modifiziert wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeModifySQUEEZEDocumentHeader(var DocHeader: Record "DXP SQZ Document Header"; RawJson: JsonObject)

```

Use-Cases:

- Header-Felder anpassen, bevor Standard-Post-Processing läuft
- zusätzliche Werte aus `RawJson` in den Header übernehmen

### `OnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues`

### `OnAfterTransferRecognizedValuesOnBeforeInsertDocLine`

Werden im Standard-Line-Post-Processing (für Standard-Dokumentenklassen) um `TransferRecognizedValues(DocLine)` herum ausgelöst.

Signaturen:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeTransferRecognizedValuesOnAfterAssignRecognizedValues(var DocLine: Record "DXP SQZ Document Line"; RowJTok: JsonToken)

[IntegrationEvent(false, false)]
local procedure OnAfterTransferRecognizedValuesOnBeforeInsertDocLine(var DocLine: Record "DXP SQZ Document Line")

```

Use-Cases:

- erkannte Werte pro Line korrigieren/normalisieren
- zusätzliche Ableitungen (z. B. Kontierung, Dimensionen) vorbereiten

### `OnBeforePerformAutomaticOrdermatch`

Wird in `PerformAutomaticOrdermatch(...)` ausgelöst, nachdem die Order-Nummern-Liste (`OrderNoList`) gefüllt wurde und **bevor** der automatische Ordermatch läuft.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforePerformAutomaticOrdermatch(DocHeader: Record "DXP SQZ Document Header"; var OrderNoList: List of [Code[20]]; var IsHandled: Boolean)

```

Use-Cases:

- automatische Ordermatch-Logik komplett übernehmen (`IsHandled := true`)
- OrderNoList anpassen (z. B. filtern/ergänzen)

---

## Events in `DXP SQZ API Mgt.` (kontextnah zur Anlage/Attachments)

Diese Events liegen „um“ die API-Kommunikation herum (z. B. Attachments).

### `OnAfterInitMapping`

Wird in `DownloadFieldMapping(...)` ausgelöst, **nachdem** die Dokumentenklasse über das Interface `DXP ISource Document` das Default-Mapping initialisiert hat (`ISourceDocument.InitFieldMapping(...)`) und **bevor** die Feldliste aus SQUEEZE in die BC-Field-Mapping-Strukturen synchronisiert wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterInitMapping(var HeaderMapping: Dictionary of [Text, Integer]; var LineMapping: Dictionary of [Text, Integer]; DocClass: Enum "DXP Document Class")

```

Parameter:

- `HeaderMapping` / `LineMapping`: Dictionaries mit Default-Zuordnung **SQZ-Feldname → BC-Feldnr.** (über `var` veränderbar)
- `DocClass`: Dokumentenklasse, für die das Mapping geladen wird

Typische Use-Cases:

- zusätzliche (kundenspezifische) Feldnamen als Default-Mapping ergänzen
- Default-Mapping korrigieren (z. B. wenn sich SQZ-Feldnamen geändert haben)
- Mapping-Validierung/Logging je Dokumentenklasse

### `OnAfterSaveAttachment`

Wird in `SaveAttachments(...)` **pro Attachment** ausgelöst, nachdem das Attachment über `DXP Document Attachment Mgt.` angelegt wurde und – falls das Attachment als Origin-Datei markiert ist – nach dem `Modify(true)` des Datensatzes.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterSaveAttachment(DocumentAttachment: Record "DXP Document Attachment")

```

Hinweis:

- `DocumentAttachment` wird **nicht** als `var` übergeben. Wenn ihr Felder am Datensatz persistent ändern möchtet, müsst ihr im Subscriber den Datensatz erneut laden und explizit `Modify(...)` ausführen.

Typische Use-Cases:

- Attachment extern indexieren/archivieren
- Metadaten ableiten (z. B. Klassifizierung nach MIME-Type/Dateiendung)
- Folgeprozesse triggern (z. B. OCR/Preview-Generierung in Drittsystem)

### `OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment`

Wird in `SaveAttachments(...)` ausgelöst, **wenn** das Attachment laut Payload als Origin-Datei markiert ist und nachdem `Is Source File` sowie `File Name` (Origin-Name) gesetzt wurden – aber **bevor** `DocumentAttachment.Modify(true)` aufgerufen wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment(var DocumentAttachment: Record "DXP Document Attachment")

```

Typische Use-Cases:

- Origin-Dateinamen normalisieren (z. B. verbotene Zeichen entfernen, Namensschema erzwingen)
- zusätzliche Felder am Attachment setzen, bevor gespeichert wird

## Minimalbeispiele: EventSubscriber für `DXP SQZ API Mgt.`

Die folgenden Beispiele zeigen typische, **kleine** Erweiterungen. Passt Objekt-IDs/Namen an euren Namespace an.

```al
codeunit 50101 "My SQZ API Mgt. Subs"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnAfterInitMapping', '', false, false)]
    local procedure OnAfterInitMapping(var HeaderMapping: Dictionary of [Text, Integer]; var LineMapping: Dictionary of [Text, Integer]; DocClass: Enum "DXP Document Class")
    var
        SqzDocHeader: Record "DXP SQZ Document Header";
        SqzDocLine: Record "DXP SQZ Document Line";
    begin
        // Beispiel: neues SQZ-Feld als Default-Mapping ergänzen.
        // Wichtig: Der Integer-Wert ist die BC-Feldnr. des Ziel-Feldes (abhängig von eurem Mapping-Konzept).
        if not HeaderMapping.ContainsKey('my_custom_header_token') then
            HeaderMapping.Add('my_custom_header_token', SqzDocHeader.FieldNo("Vendor No."));

        if not LineMapping.ContainsKey('my_custom_line_token') then
            LineMapping.Add('my_custom_line_token', SqzDocLine.FieldNo(Description));
    end;

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment', '', false, false)]
    local procedure OnAfterSetOriginFileNameOnBeforeModifyDocumentAttachment(var DocumentAttachment: Record "DXP Document Attachment")
    begin
        // Beispiel: Origin-Dateiname normalisieren (Whitespace entfernen).
        DocumentAttachment."File Name" := DelChr(DocumentAttachment."File Name", '=', ' ');
    end;

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnAfterSaveAttachment', '', false, false)]
    local procedure OnAfterSaveAttachment(DocumentAttachment: Record "DXP Document Attachment")
    begin
        // Beispiel: Nachverarbeitung anstoßen.
        // Falls ihr persistent am Attachment ändern wollt, könnt ihr den Parameter-Datensatz auch direkt modifizieren.
        // DocumentAttachment.Validate("Your Field", ...);
        // DocumentAttachment.Modify(true);
    end;
}

```

# Events nach der Erstellung eines Core-Belegs (DXP Document)

## Zielgruppe

Diese Dokumentation richtet sich an Drittanbieter-Entwickler, die den Lebenszyklus des Core-Belegs **`DXP Document`** erweitern möchten – insbesondere an den Punkten, an denen:

- Status / „Nächster Prozessschritt“ bewertet wird,
- `JSON Raw` / `JSON Processed` aktualisiert wird,
- Standardbelege erzeugt werden (z. B. Einkaufsbelege),
- Attachments übertragen werden.

## Einordnung: Core-Beleg-Erstellung vs. Weiterverarbeitung

### 1) Core-Beleg wird angelegt (`AddDocument`)

Die Anlage eines `DXP Document` erfolgt in **`DXP Document Mgt.`** über `AddDocument(...)`:

- Status wird auf **Imported** gesetzt.
- `JSON Raw` wird (falls vorhanden) in ein BLOB-Feld geschrieben.

### 2) Danach: Transfer/Verknüpfung und Verarbeitung

Typische nächste Schritte (abhängig vom App-Flow):

- Verknüpfung mit einem Quellbeleg (z. B. SQUEEZE Header) über `UpdateDocumentAfterTransfer(...)`
- Erzeugung eines Standardbelegs und Schreiben des `JSON Processed` über `UpdateDocument(...)`

Die meisten Erweiterungspunkte liegen daher **nicht direkt beim Insert**, sondern im Update-/Processing-Flow.

## Event-Matrix (Kurzüberblick)

<table id="bkmrk-bereich-event-zeitpu"><thead><tr><th>Bereich</th><th>Event</th><th>Zeitpunkt</th><th>Steuerung</th><th>Typische Use-Cases</th></tr></thead><tbody><tr><td>`DXP Document Mgt.`</td><td>[`OnAfterSetLinkedToRecIdOnBeforeModify`](https://docs.squeeze.one/link/940#bkmrk-onaftersetlinkedtore)</td><td>in `UpdateDocumentAfterTransfer(...)` vor `Modify(true)`</td><td>–</td><td>Zusatzinfos setzen, sobald `Linked-to Record Id` steht</td></tr><tr><td>`DXP Document Mgt.`</td><td>[`OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep`](https://docs.squeeze.one/link/940#bkmrk-onbeforegetdocumento)</td><td>früh in `UpdateDocument(...)` vor `Document.Get(DocNo)`</td><td>`IsHandled`</td><td>Status/NextStep überschreiben, Processing übernehmen</td></tr><tr><td>`DXP Document Mgt.`</td><td>[`OnAfterGetDocumentOnBeforeCheckStatusAndNextProcessStep`](https://docs.squeeze.one/link/940#bkmrk-onaftergetdocumenton)</td><td>in `UpdateDocument(...)` nach `Get(...)` vor Standardbeleg-Erzeugung</td><td>`Handled`</td><td>abhängig vom Dokument entscheiden, JSON/Status anpassen</td></tr><tr><td>`DXP Document Mgt.`</td><td>[`OnAfterUpdateRawJson`](https://docs.squeeze.one/link/940#bkmrk-onafterupdaterawjson)</td><td>nach Schreiben von `JSON Raw` in `UpdateRawJsonJson(...)`</td><td>–</td><td>Raw JSON normalisieren/zusätzliche Ableitungen</td></tr><tr><td>`DXP Document Mgt.`</td><td>[`OnAfterWriteProcessedJsonToBlob`](https://docs.squeeze.one/link/940#bkmrk-onafterwriteprocesse)</td><td>nach Schreiben von `JSON Processed` in `UpdateStatusAndProcessedJson(...)`</td><td>–</td><td>Processed JSON finalisieren, Tokens ergänzen</td></tr><tr><td>`DXP Document Mgt.`</td><td>[`OnBeforeTransferCoreAttachmentsToStandardDocument`](https://docs.squeeze.one/link/940#bkmrk-onbeforetransfercore)</td><td>vor Attachment-Transfer</td><td>`IsHandled`</td><td>Transfer ersetzen/selektiv steuern</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnBeforeExitProcessedJsonDocHeader`](https://docs.squeeze.one/link/940#bkmrk-onbeforeexitprocesse)</td><td>beim Erzeugen von Header-JSON (vor `exit(JObject)`)</td><td>–</td><td>Standard-Tokens ergänzen/normalisieren</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnBeforeExitProcessedJsonDocLine`](https://docs.squeeze.one/link/940#bkmrk-onbeforeexitprocesse-0)</td><td>beim Erzeugen von Line-JSON (vor `exit(JObject)`)</td><td>–</td><td>Line-Tokens ergänzen/normalisieren</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnAfterCreatePurchaseHeader`](https://docs.squeeze.one/link/940#bkmrk-onaftercreatepurchas)</td><td>nach Anlage/Validierung des Purchase Headers</td><td>–</td><td>Header-Felder ergänzen, Post-Processing</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnBeforeInsertPurchaseLine`](https://docs.squeeze.one/link/940#bkmrk-onbeforeinsertpurcha)</td><td>vor Insert einer Purchase Line</td><td>–</td><td>Purchase Line anpassen (z. B. Kontierung, Typ/No)</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnAfterInsertPurchaseLineOnBeforeAddDimensions`](https://docs.squeeze.one/link/940#bkmrk-onafterinsertpurchas)</td><td>nach Insert, vor Dimensionen</td><td>–</td><td>Dimensions/Additional-Info vorbereiten</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnAfterOnBeforeAddLineDimensions`](https://docs.squeeze.one/link/940#bkmrk-onafteronbeforeaddli)</td><td>bei Receipt-Lines: vor Dimensionen des zu aktualisierenden Lines</td><td>–</td><td>Update-Fälle (Receipt) anpassen</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnAfterProcessAdditionalInformation`](https://docs.squeeze.one/link/940#bkmrk-onafterprocessadditi)</td><td>nach Transfer zusätzlicher Informationen</td><td>–</td><td>Add-on-Felder pro Ziel-RecordRef ergänzen</td></tr><tr><td>`DXP Document Transfer Mgt.`</td><td>[`OnAfterCreatePurchaseDoc`](https://docs.squeeze.one/link/940#bkmrk-onaftercreatepurchas-0)</td><td>nach kompletter Erstellung des Purchase Dokuments</td><td>–</td><td>finaler Hook (Logging, Folgeaktionen)</td></tr></tbody></table>

---

## Events in `DXP Document Mgt.` (Core-Lebenszyklus)

### `OnAfterSetLinkedToRecIdOnBeforeModify`

Wird in `UpdateDocumentAfterTransfer(...)` ausgelöst – nachdem Status/`Linked-to Record Id` gesetzt wurden, aber **bevor** das `DXP Document` gespeichert wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterSetLinkedToRecIdOnBeforeModify(var Document: Record "DXP Document")

```

Use-Cases:

- Zusatzinformationen am Core-Beleg setzen, sobald er auf einen Quellbeleg verlinkt ist
- eigene Logging-/Audit-Informationen ergänzen

### `OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep`

Wird in `UpdateDocument(...)` als **frühester Hook** aufgerufen – noch bevor das `DXP Document` per `Get(DocNo)` geladen wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep(
    DocNo: Code[20];
    var Status: Enum "DXP Document Status";
    var NextStep: Enum "DXP Next Process Step";
    JObject: JsonObject;
    var IsHandled: Boolean)

```

Use-Cases:

- Status/NextStep vorab überschreiben (z. B. „Individuelle Verarbeitung“)
- komplette Verarbeitung übernehmen (`IsHandled := true`)

### `OnAfterGetDocumentOnBeforeCheckStatusAndNextProcessStep`

Wird in `UpdateDocument(...)` nach `Document.Get(DocNo)` ausgelöst, bevor Standardbelege erzeugt werden.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterGetDocumentOnBeforeCheckStatusAndNextProcessStep(
    var Document: Record "DXP Document";
    NewStatus: Enum "DXP Document Status";
    NextStep: Enum "DXP Next process step";
    var ProcessedJSONObj: JsonObject;
    var Handled: Boolean)

```

Use-Cases:

- abhängig vom aktuellen Core-Dokument entscheiden, ob Processing übernommen werden soll
- Anpassungen am `ProcessedJSONObj` vor der weiteren Verarbeitung

### `OnAfterUpdateRawJson`

Wird in `UpdateRawJsonJson(...)` nach dem Schreiben von `JSON Raw` ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterUpdateRawJson(var Document: Record "DXP Document"; var RawJSONObj: JsonObject)

```

Use-Cases:

- Validierungs-/Normalisierungsschritte auf `RawJSONObj`
- zusätzliche Datenextraktion direkt nach Raw-Update

### `OnAfterWriteProcessedJsonToBlob`

Wird in `UpdateStatusAndProcessedJson(...)` ausgelöst, nachdem `JSON Processed` in das BLOB geschrieben wurde.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterWriteProcessedJsonToBlob(var Document: Record "DXP Document"; var ProcessedJSONObj: JsonObject)

```

Use-Cases:

- zusätzliche Tokens ergänzen
- Datenstruktur finalisieren, bevor nachgelagerte Prozesse darauf zugreifen

### `OnBeforeTransferCoreAttachmentsToStandardDocument`

Wird in `TransferCoreAttachmentsToStandardDocument(...)` vor dem Transfer ausgelöst. Über `IsHandled` kann die Standardlogik ersetzt werden.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeTransferCoreAttachmentsToStandardDocument(Document: Record "DXP Document"; var IsHandled: Boolean)

```

Use-Cases:

- Attachment-Transfer komplett übernehmen (z. B. andere Ablage/Benennung)
- Transfer selektiv einschränken

---

## Events in `DXP Document Transfer Mgt.` (Standardbelege aus `JSON Processed`)

Diese Codeunit ist relevant, sobald aus `JSON Processed` Standardbelege (z. B. Einkaufsbelege) erzeugt werden.

### `OnBeforeExitProcessedJsonDocHeader`

Wird in `CreateDocHeaderJson(...)` unmittelbar vor `exit(JObject)` ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeExitProcessedJsonDocHeader(var JObject: JsonObject)

```

Use-Cases:

- zusätzliche Standard-Tokens ergänzen
- Token-Werte normalisieren (z. B. Typ-/Textdarstellung)

### `OnBeforeExitProcessedJsonDocLine`

Wird in `CreateDocLineJson(...)` unmittelbar vor `exit(JObject)` ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeExitProcessedJsonDocLine(var JObject: JsonObject)

```

Use-Cases:

- Line-Tokens ergänzen/normalisieren

### `OnAfterCreatePurchaseHeader`

Wird nach Anlage/Validierung des Purchase Headers ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterCreatePurchaseHeader(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header")

```

Use-Cases:

- zusätzliche Felder am `Purchase Header` setzen (z. B. eigene Referenzen)
- Post-Processing/Logging

### `OnBeforeInsertPurchaseLine`

Wird unmittelbar vor dem Insert einer Purchase Line ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeInsertPurchaseLine(var JObjectLine: JsonObject; var PurchaseLine: Record "Purchase Line")

```

Use-Cases:

- Purchase Line anpassen (z. B. Kontierung, Typ/No)

### `OnAfterInsertPurchaseLineOnBeforeAddDimensions`

Wird nach Insert der Purchase Line, aber vor Dimensions-Validierung ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterInsertPurchaseLineOnBeforeAddDimensions(var JObjectLine: JsonObject; PurchaseLine: Record "Purchase Line")

```

Use-Cases:

- Dimensions/Additional-Info vorbereiten

### `OnAfterOnBeforeAddLineDimensions`

Wird im Receipt-Line-Update-Fall ausgelöst, bevor Dimensionen für die zu aktualisierende Purchase Line gesetzt werden.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterOnBeforeAddLineDimensions(var JObjectLine: JsonObject; PurchaseLineToUpdate: Record "Purchase Line")

```

Use-Cases:

- Update-Fälle (Receipt) anpassen

### `OnAfterProcessAdditionalInformation`

Wird nach dem Transfer zusätzlicher Informationen (`ProcessAdditionalInformation`) ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterProcessAdditionalInformation(var RecRef: RecordRef; SourceJsonObject: JsonObject)

```

Use-Cases:

- Add-on Felder für unterschiedliche Zieltabellen (Header/Line) ergänzen

### `OnAfterCreatePurchaseDoc`

Wird nach kompletter Erstellung des Purchase Dokuments ausgelöst.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterCreatePurchaseDoc(var JObject: JsonObject; PurchaseHeader: Record "Purchase Header")

```

Use-Cases:

- finaler Hook (Post-Processing, Logging, Folgeaktionen)

---

## Minimalbeispiel: Status/NextStep in Richtung „Individuelle Verarbeitung“ beeinflussen

Beispiel: Vor dem Standard-Processing `Status` auf „Custom Processing“ setzen:

```al
codeunit 50101 "My Core Document Hooks"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP Document Mgt.", 'OnBeforeGetDocumentOnBeforeCheckStatusAndNextProcessStep', '', false, false)]
    local procedure OnBeforeGetDoc(
        DocNo: Code[20];
        var Status: Enum "DXP Document Status";
        var NextStep: Enum "DXP Next Process Step";
        JObject: JsonObject;
        var IsHandled: Boolean)
    begin
        Status := Status::"Custom Processing";
        // NextStep optional anpassen
    end;
}

```

\[Best Practice\] Nutze `IsHandled := true` nur, wenn du die Standardlogik vollständig ersetzt – sonst kann es zu inkonsistenten Status-/JSON-Zuständen kommen.

# Events beim Validieren eines SQUEEZE-Belegs (Aktion „Validieren")

## Zielgruppe

Diese Dokumentation richtet sich an Drittanbieter-Entwickler, die eigene Logik ausführen möchten, wenn ein Anwender auf der Seite **DXP SQZ Document v2** (Page `70954659`) die Aktion **Validieren** auslöst – etwa zusätzliche eigene Prüfungen vor der Validierung, das Setzen weiterer Werte auf dem SQUEEZE-Beleg oder Folgeaktionen auf dem erzeugten Zielbeleg.

Die beschriebenen Events stehen ab **SQUEEZE für Dynamics 365 BC Version 2.50** zur Verfügung.

## Einordnung: Was passiert beim Klick auf „Validieren"?

Die Aktion **Validieren** ruft nacheinander zwei Routinen der Belegseite auf:

### 1) `CheckPlausibility()`

Führt die **Plausibilitätsprüfung** der jeweiligen **Dokumentenklasse** aus und aktualisiert die **Plausibilitätseinträge** im unteren Bereich der Seite. Diese Routine läuft nicht nur beim Klick auf **Validieren**, sondern nach nahezu jeder Feldänderung. Sie ist deshalb **kein** geeigneter Aufhängepunkt für „einmalig beim Validieren".

Für Erweiterungen der Prüfung selbst existieren die bereits dokumentierten Events `OnBeforeDoPlausibilityChecks`, `OnAfterDoHeaderPlausibilityChecks`, `OnAfterDoLinePlausibilityChecks` und `OnAfterDoPlausibilityChecks`.

### 2) `FinishValidation()`

Bricht mit einer Fehlermeldung ab, solange noch Plausibilitätseinträge offen sind, behandelt gegebenenfalls die Dublettenprüfung und ruft anschließend die Methode `ValidateSQUEEZEDocument` der Codeunit **`DXP SQZ Document Mgt.`** (`70954632`) auf. Dort werden der verarbeitete JSON erzeugt, der Core-Beleg (**`DXP Document`**) weiterverarbeitet, der Zielbeleg erstellt und der SQUEEZE-Beleg abgeschlossen.

**Beide hier beschriebenen Events werden in `DXP SQZ Document Mgt.ValidateSQUEEZEDocument` ausgelöst.** Damit greifen sie einheitlich für:

- die Aktion **Validieren** auf **DXP SQZ Document v2** (`70954659`),
- die Aktion **Validieren** auf **DXP SQZ Document (Generic)** (`70954670`) und den älteren Belegseiten,
- die **automatische Validierung** (z. B. aus der Verarbeitungswarteschlange).

Es gibt bewusst kein Event direkt an der Aktion. Wenn Sie zwischen manuellem Klick und automatischer Validierung unterscheiden möchten, werten Sie den Parameter `AutomaticValidation` aus.

## Event-Matrix (Kurzüberblick)

<table class="code-line" data-line="47" dir="auto" id="bkmrk-bereich-event-zeitpu"><thead class="code-line" data-line="47" dir="auto"><tr class="code-line" data-line="47" dir="auto"><th>Bereich</th><th>Event</th><th>Zeitpunkt</th><th>Steuerung</th><th>Typische Use-Cases</th></tr></thead><tbody class="code-line" data-line="49" dir="auto"><tr class="code-line" data-line="49" dir="auto"><td>`DXP SQZ Document Mgt.`</td><td>`OnBeforeValidateSQUEEZEDocument`</td><td>Nach der Plausibilitäts- und Dublettenprüfung, bevor der verarbeitete JSON erzeugt und der Zielbeleg angelegt wird</td><td>`var IsHandled: Boolean` bricht die Validierung ab; `var DocHeader` erlaubt Änderungen am Beleg</td><td>Eigene Zusatzprüfungen mit Abbruch, Felder nachbefüllen, Freigabeworkflow anstoßen, externe Systeme abfragen</td></tr><tr class="code-line" data-line="50" dir="auto"><td>`DXP SQZ Document Mgt.`</td><td>`OnAfterValidateSQUEEZEDocument`</td><td>Nachdem der Core-Beleg verarbeitet und der Zielbeleg erstellt wurde, vor dem Validierungsdialog</td><td>Kein Abbruch möglich</td><td>Zielbeleg nachbearbeiten, eigene Protokolltabellen schreiben, Benachrichtigungen versenden, Drittsysteme informieren</td></tr></tbody></table>

## Abgrenzung zu `OnAfterWriteProcessedJsonToBlob`

Für Logik **nach** der Validierung existiert bereits ein Core-Event, beschrieben auf der Seite *Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)*:

```al
[IntegrationEvent(false, false)]
local procedure OnAfterWriteProcessedJsonToBlob(var Document: Record "DXP Document"; var ProcessedJSONObj: JsonObject)

```

Es wird in der Codeunit **`DXP Document Mgt.`** (Core) ausgelöst, nachdem der verarbeitete JSON in den Core-Beleg geschrieben wurde – innerhalb des Validierungsvorgangs, also ebenfalls beim Klick auf **Validieren**.

<table class="code-line" data-line="66" dir="auto" id="bkmrk-%C2%A0-onafterwriteproces"><thead class="code-line" data-line="66" dir="auto"><tr class="code-line" data-line="66" dir="auto"><th> </th><th>`OnAfterWriteProcessedJsonToBlob` (Core)</th><th>`OnAfterValidateSQUEEZEDocument` (SQUEEZE)</th></tr></thead><tbody class="code-line" data-line="68" dir="auto"><tr class="code-line" data-line="68" dir="auto"><td>Ausgelöst in</td><td>`DXP Document Mgt.`</td><td>`DXP SQZ Document Mgt.`</td></tr><tr class="code-line" data-line="69" dir="auto"><td>Gilt für</td><td>**alle** Core-Belege – auch aus anderen DEXPRO-Quell-Apps. Sie müssen selbst auf die Dokumentenklasse filtern.</td><td>ausschließlich SQUEEZE-Belege</td></tr><tr class="code-line" data-line="70" dir="auto"><td>Kontext</td><td>`DXP Document` und der verarbeitete JSON</td><td>zusätzlich der komplette **`DXP SQZ Document Header`** mit allen erkannten Werten, Bestellabgleich- und Splitting-Informationen</td></tr><tr class="code-line" data-line="71" dir="auto"><td>Manuell vs. automatisch</td><td>nicht unterscheidbar</td><td>über `AutomaticValidation` unterscheidbar</td></tr><tr class="code-line" data-line="72" dir="auto"><td>Zeitpunkt</td><td>direkt nach dem Schreiben des JSON, noch innerhalb der Core-Verarbeitung</td><td>am Ende der Validierung, nachdem der SQUEEZE-Beleg abgeschlossen wurde</td></tr><tr class="code-line" data-line="73" dir="auto"><td>JSON änderbar</td><td>ja (`var ProcessedJSONObj`)</td><td>nein</td></tr></tbody></table>

**Empfehlung:**

- Sie möchten den **verarbeiteten JSON** noch verändern oder einen Beleg in die **Individuelle Verarbeitung** übernehmen → `OnAfterWriteProcessedJsonToBlob`.
- Sie möchten SQUEEZE-spezifische Werte auswerten oder nur bei manueller Validierung reagieren → `OnAfterValidateSQUEEZEDocument`.
- Sie möchten **vor** der Erstellung des Zielbelegs eingreifen oder die Validierung abbrechen → `OnBeforeValidateSQUEEZEDocument`. Dafür gibt es im Core keine Entsprechung.

## `OnBeforeValidateSQUEEZEDocument`

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeValidateSQUEEZEDocument(var DocHeader: Record "DXP SQZ Document Header"; AutomaticValidation: Boolean; var IsHandled: Boolean)

```

<table class="code-line" data-line="91" dir="auto" id="bkmrk-parameter-beschreibu"><thead class="code-line" data-line="91" dir="auto"><tr class="code-line" data-line="91" dir="auto"><th>Parameter</th><th>Beschreibung</th></tr></thead><tbody class="code-line" data-line="93" dir="auto"><tr class="code-line" data-line="93" dir="auto"><td>`var DocHeader`</td><td>Der zu validierende SQUEEZE-Beleg. Änderungen an Feldern werden anschließend mitgeschrieben und fließen in den Zielbeleg ein.</td></tr><tr class="code-line" data-line="94" dir="auto"><td>`AutomaticValidation`</td><td>`false` beim Klick auf **Validieren**, `true` bei automatischer Validierung.</td></tr><tr class="code-line" data-line="95" dir="auto"><td>`var IsHandled`</td><td>Auf `true` gesetzt bricht die Validierung ab. Der SQUEEZE-Beleg bleibt unverändert offen.</td></tr></tbody></table>

Das Event wird ausgelöst, nachdem:

- der Beleg neu gelesen wurde und weder den Status **Gelöscht** noch **Abgelehnt** hat,
- bei automatischer Validierung die Plausibilitätsprüfung erfolgreich war,

und bevor der verarbeitete JSON erzeugt wird. Zu diesem Zeitpunkt existiert der Zielbeleg noch nicht.

## `OnAfterValidateSQUEEZEDocument`

```al
[IntegrationEvent(false, false)]
local procedure OnAfterValidateSQUEEZEDocument(DocHeader: Record "DXP SQZ Document Header"; CoreDocument: Record "DXP Document"; AutomaticValidation: Boolean)

```

<table class="code-line" data-line="111" dir="auto" id="bkmrk-parameter-beschreibu-1"><thead class="code-line" data-line="111" dir="auto"><tr class="code-line" data-line="111" dir="auto"><th>Parameter</th><th>Beschreibung</th></tr></thead><tbody class="code-line" data-line="113" dir="auto"><tr class="code-line" data-line="113" dir="auto"><td>`DocHeader`</td><td>Der validierte SQUEEZE-Beleg. Sein Status ist zu diesem Zeitpunkt bereits **Gelöscht** – das ist der reguläre Endzustand eines validierten Belegs und **kein** Fehler.</td></tr><tr class="code-line" data-line="114" dir="auto"><td>`CoreDocument`</td><td>Der zugehörige Core-Beleg (**`DXP Document`**), inklusive `Status` und `Linked-to Record Id` des erstellten Zielbelegs.</td></tr><tr class="code-line" data-line="115" dir="auto"><td>`AutomaticValidation`</td><td>`false` beim Klick auf **Validieren**, `true` bei automatischer Validierung.</td></tr></tbody></table>

Ob der Zielbeleg tatsächlich erstellt wurde, ermitteln Sie über den Core-Beleg:

- `CoreDocument.Status = CoreDocument.Status::Transferred` – der Zielbeleg wurde erstellt, `CoreDocument."Linked-to Record Id"` verweist darauf.
- `CoreDocument.Status = CoreDocument.Status::"Custom Processing"` – der Beleg wurde in die **Individuelle Verarbeitung** übergeben; ein Standard-Zielbeleg existiert nicht.

## Wichtig: eigene Prüfungen gehören **nicht** in dieses Event

Für Prüfungen, die eine Validierung verhindern sollen, ist `OnBeforeValidateSQUEEZEDocument` der falsche Ort. Ein `Error` an dieser Stelle erscheint erst *nach* dem Klick auf **Validieren** als Dialog – der Anwender sieht das Problem also erst am Ende der Bearbeitung. Nutzen Sie stattdessen einen der beiden folgenden Wege. Beide sorgen dafür, dass das Problem als **Plausibilitätseintrag** angezeigt und die Aktion **Validieren** deaktiviert wird.

### Weg 1 (ohne Entwicklung): Plausibilitätsregelgruppe

In der **Dokumentenklassen-Einrichtung** legen Sie unter **Plausibilitätsregelgruppe** Regeln an. Jede aktive und gültige Regel, deren Bedingungen **zutreffen**, beschreibt ein Problem und erzeugt automatisch einen Plausibilitätseintrag. Regeln, die sich auf die Belegzeilen beziehen, werden je Zeile ausgewertet, sodass der Eintrag auf die betroffene Zeile verweist.

Für Prüfungen wie „Shortcutdimensionscode 1 darf nicht leer sein" ist das der bevorzugte Weg – kein Code, keine Erweiterung, vom Anwender selbst pflegbar.

### Weg 2 (mit Entwicklung): `OnAfterDoPlausibilityChecks`

Dieses Event wird von allen Dokumentenklassen mit `var TempPlausibilityCheckEntry` veröffentlicht und ist damit der zuverlässige Weg. Sie fügen Ihren Eintrag direkt in den temporären Datensatz ein:

```al
codeunit 50100 "My SQZ Plausibility Checks"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.",
        'OnAfterDoPlausibilityChecks', '', false, false)]
    local procedure OnAfterChecks(DocHeader: Record "DXP SQZ Document Header"; var TempPlausibilityCheckEntry: Record "DXP Plausibility Check Entry" temporary)
    var
        CostCenterMissingLbl: Label 'Please enter a cost center.';
    begin
        if DocHeader."Shortcut Dimension 1 Code" <> '' then
            exit;

        AddEntry(TempPlausibilityCheckEntry, CostCenterMissingLbl, DocHeader.RecordId(), 0);
    end;

    local procedure AddEntry(var TempPlausibilityCheckEntry: Record "DXP Plausibility Check Entry" temporary; MessageText: Text; LinkedToRecId: RecordId; LookupPageId: Integer)
    var
        NewEntryNo: Integer;
    begin
        NewEntryNo := 1;
        TempPlausibilityCheckEntry.Reset();
        TempPlausibilityCheckEntry.SetCurrentKey("Entry No.");
        if TempPlausibilityCheckEntry.FindLast() then
            NewEntryNo := TempPlausibilityCheckEntry."Entry No." + 1;

        TempPlausibilityCheckEntry.Init();
        TempPlausibilityCheckEntry."Entry No." := NewEntryNo;
        TempPlausibilityCheckEntry.Text := CopyStr(MessageText, 1, MaxStrLen(TempPlausibilityCheckEntry.Text));
        TempPlausibilityCheckEntry."Linked to Record Id" := LinkedToRecId;
        TempPlausibilityCheckEntry."Lookup Page Id" := LookupPageId;
        if TempPlausibilityCheckEntry.Insert() then;
    end;
}

```

Das passende Publisher-Objekt richtet sich nach der **Dokumentenklasse**:

<table class="code-line" data-line="184" dir="auto" id="bkmrk-dokumentenklasse-cod"><thead class="code-line" data-line="184" dir="auto"><tr class="code-line" data-line="184" dir="auto"><th>Dokumentenklasse</th><th>Codeunit</th></tr></thead><tbody class="code-line" data-line="186" dir="auto"><tr class="code-line" data-line="186" dir="auto"><td>Einkaufsrechnung / Gutschrift</td><td>`DXP SQZ P. Inv/Crdt Memo Impl.`</td></tr><tr class="code-line" data-line="187" dir="auto"><td>Auftragsbestätigung</td><td>`DXP SQZ P. Order Conf. Impl.`</td></tr><tr class="code-line" data-line="188" dir="auto"><td>Generische Dokumentenklassen</td><td>`DXP SQZ Document Mgt.`</td></tr></tbody></table>

Setzen Sie `Linked to Record Id` und `Lookup Page Id` (für Zeilen: `Page::"DXP SQZ Document Subform"`), damit der Plausibilitätseintrag anklickbar wird und zum betroffenen Datensatz springt.

### Alternative: `OnAfterDoHeaderPlausibilityChecks`

Mit `PlausibilityCheck.AddPlausibilityCheckEntry(...)` steht eine bequemere API zur Verfügung, die Ihnen das manuelle Einfügen in den temporären Datensatz erspart:

```al
[EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ P. Inv/Crdt Memo Impl.",
    'OnAfterDoHeaderPlausibilityChecks', '', false, false)]
local procedure OnAfterHeaderChecks(DocHeader: Record "DXP SQZ Document Header"; var PlausibilityCheck: Codeunit "DXP Plausiblity Check Mgt.")
var
    CostCenterMissingLbl: Label 'Please enter a cost center.';
begin
    if DocHeader."Shortcut Dimension 1 Code" = '' then
        PlausibilityCheck.AddPlausibilityCheckEntry(CostCenterMissingLbl, 0);
end;

```

Für Zeilenprüfungen gilt `OnAfterDoLinePlausibilityChecks` analog; über die Überladung `AddPlausibilityCheckEntry(Text; LinkedToRecId; LookupPageId)` wird der Eintrag anklickbar.

> **Achtung bei der Dokumentenklasse Auftragsbestätigung:** In **`DXP SQZ P. Order Conf. Impl.`** wurden `OnBeforeDoHeaderPlausibilityChecks`, `OnBeforeDoLinePlausibilityChecks`, `OnAfterDoHeaderPlausibilityChecks` und `OnAfterDoLinePlausibilityChecks` ursprünglich ohne `var` auf dem Parameter `PlausibilityCheck` veröffentlicht. Ein Subscriber erhält dort eine Kopie, sodass hinzugefügte Einträge verloren gehen. Verwenden Sie in dieser Dokumentenklasse ab **Version 2.50** stattdessen die Varianten mit dem Suffix **`V2`** – zum Beispiel `OnAfterDoHeaderPlausibilityChecksV2`. Sie sind signaturgleich zu den Events der übrigen Dokumentenklassen. Die alten Events bleiben erhalten, sind aber als veraltet markiert.

## Beispiel 1: Werte vor der Übergabe an den Zielbeleg ergänzen

```al
[EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.",
    'OnBeforeValidateSQUEEZEDocument', '', false, false)]
local procedure OnBeforeValidateSetPostingDescription(var DocHeader: Record "DXP SQZ Document Header"; AutomaticValidation: Boolean; var IsHandled: Boolean)
begin
    if DocHeader."Posting Description" = '' then
        DocHeader."Posting Description" := CopyStr(DocHeader."Document Reference", 1, MaxStrLen(DocHeader."Posting Description"));
    // Kein Modify notwendig – der Beleg wird im Anschluss geschrieben.
end;

```

## Zielbeleg nachbearbeiten: bitte die Core-Events verwenden

Wenn Sie den **erzeugten Zielbeleg** verändern möchten, ist keines der beiden Events auf dieser Seite der richtige Ort. Der Core stellt dafür Events bereit, die den Zielbeleg direkt übergeben – bei den meisten sogar als typisierten `Purchase Header`, sodass der Umweg über `Linked-to Record Id` und einen `RecordRef` entfällt. Diese Events sind auf der Seite *Events nach der Erstellung eines Core-Belegs (DXP Document)* beschrieben:

<table class="code-line" data-line="245" dir="auto" id="bkmrk-zielbeleg-codeunit-e"><thead class="code-line" data-line="245" dir="auto"><tr class="code-line" data-line="245" dir="auto"><th>Zielbeleg</th><th>Codeunit</th><th>Event</th></tr></thead><tbody class="code-line" data-line="247" dir="auto"><tr class="code-line" data-line="247" dir="auto"><td>Einkaufsrechnung / Gutschrift</td><td>`DXP P. Inv. CredMemo. Creation`</td><td>`OnAfterProcessStandardDocument(JObject; DocRecRef)`</td></tr><tr class="code-line" data-line="248" dir="auto"><td>Einkaufsbeleg allgemein</td><td>`DXP Document Transfer Mgt.`</td><td>`OnAfterCreatePurchaseDoc(var JObject; PurchaseHeader)`</td></tr><tr class="code-line" data-line="249" dir="auto"><td>Einkaufskopf</td><td>`DXP Document Transfer Mgt.`</td><td>`OnAfterCreatePurchaseHeader(var JObject; PurchaseHeader)`</td></tr><tr class="code-line" data-line="250" dir="auto"><td>Bestellung</td><td>`DXP P. Order Creation`</td><td>`OnAfterCreatePurchaseOrder(var JObject; var PurchaseHeader)`</td></tr><tr class="code-line" data-line="251" dir="auto"><td>Auftragsbestätigung</td><td>`DXP P. Order Confirmation`</td><td>`OnAfterProcessStandardDocument(JObject; var PurchaseHeader)`</td></tr></tbody></table>

`OnAfterValidateSQUEEZEDocument` ist erst dann die bessere Wahl, wenn Sie zusätzlich Werte aus dem **`DXP SQZ Document Header`** benötigen – etwa erkannte Werte, Bestellabgleich- oder Splitting-Informationen, die im JSON des Core-Belegs nicht enthalten sind.

## Beispiel 2: Nur bei manueller Validierung reagieren

```al
[EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ Document Mgt.",
    'OnAfterValidateSQUEEZEDocument', '', false, false)]
local procedure OnAfterValidateNotifyUser(DocHeader: Record "DXP SQZ Document Header"; CoreDocument: Record "DXP Document"; AutomaticValidation: Boolean)
var
    ValidatedMsg: Label 'Document %1 has been forwarded.', Comment = '%1 = SQUEEZE document no.';
begin
    if AutomaticValidation then
        exit;
    if not GuiAllowed() then
        exit;

    Message(ValidatedMsg, DocHeader."No.");
end;

```

## Hinweise und Einschränkungen

- **Kein Dialog in der automatischen Verarbeitung.** Prüfen Sie vor `Message`, `Confirm` oder `Page.RunModal` immer `AutomaticValidation` und `GuiAllowed()`. Andernfalls läuft die Verarbeitungswarteschlange auf einen Fehler.
- **`OnBeforeValidateSQUEEZEDocument` läuft nach der Plausibilitätsprüfung.** Eigene Prüfungen, die in den **Plausibilitätseinträgen** der Seite erscheinen und die Aktion **Validieren** deaktivieren sollen, gehören stattdessen in `OnAfterDoHeaderPlausibilityChecks` bzw. `OnAfterDoLinePlausibilityChecks`.
- **`IsHandled := true` bricht vollständig ab.** Es wird kein Zielbeleg erstellt, der Core-Beleg bleibt unverändert und der SQUEEZE-Beleg behält seinen Status. Der Anwender erhält keine Meldung – geben Sie bei Bedarf selbst eine aus.
- **Kein Event bei gelöschten oder abgelehnten Belegen.** Hat der Beleg den Status **Gelöscht** oder **Abgelehnt**, wird die Validierung vorher beendet und keines der beiden Events ausgelöst.
- **`OnAfterValidateSQUEEZEDocument` läuft nach einem `Commit`.** Ein `Error` in einem Subscriber macht die Validierung nicht rückgängig, sondern hinterlässt einen validierten Beleg mit einer Fehlermeldung für den Anwender.

## Verwandte Seiten

- Erstellung benutzerdefinierter Dokumente (Individuelle Verarbeitung)
- Events nach der Erstellung eines SQUEEZE-Belegs (CreateSource)
- Events nach der Erstellung eines Core-Belegs (DXP Document)
- Regelbasierter nächster Prozessschritt (Belege in Individuelle Verarbeitung steuern)

# Events vor dem Abholen und Anlegen von SQUEEZE-Belegen

## Zielgruppe

Diese Dokumentation richtet sich an Drittanbieter-Entwickler, die steuern möchten, **ob** Business Central Belege aus SQUEEZE abholt – typischerweise, um das Abholen in einem Testsystem zu unterbinden.

Im Fokus stehen die beiden **Integration Events** in der Codeunit `DXP SQZ API Mgt.`, die *vor* dem Abholen ausgelöst werden.

<p class="callout info">Die beiden Events sind ab SQUEEZE Version 2.54.0.0 verfügbar.</p>

## Hintergrund: Warum ein Testsystem keine Belege abholen sollte

Ist ein Testsystem mit derselben SQUEEZE-Instanz verbunden wie das Produktivsystem – etwa weil es als Kopie der Produktion angelegt wurde –, holt es dort ebenfalls Belege ab.

<p class="callout warning">Beim Anlegen wird ein Beleg in SQUEEZE auf `FINISHED` gesetzt. Ein Beleg, den ein Testsystem abgeholt hat, steht dem Produktivsystem danach nicht mehr zur Verfügung.</p>

Soll das Testsystem gar nicht mit SQUEEZE kommunizieren, geht das auch ohne Erweiterung, siehe [Testsystem holt Belege aus Squeeze ab](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/testsystem-holt-belege-aus-squeeze-ab). Die Events sind für die Fälle gedacht, in denen das Testsystem das Abholen selbst erkennen und unterbinden soll oder nur bestimmte Belege zurückgehalten werden sollen.

## Einordnung: Ablauf des Abholens

Das Abholen läuft in zwei Schritten, beide in der Codeunit `DXP SQZ API Mgt.`:

1. `DownloadDocumentData` ruft die IDs der Belege ab, die in SQUEEZE zum Export bereitstehen, und trägt sie in die [Importwarteschlange](https://docs.squeeze.one/link/524) ein. Außerdem ruft es Belege im Status „Neu erstellen“ (Resynchronize) erneut ab.
2. `CreateCoreAndSQUEEZEDocument` ruft für jeden offenen Eintrag der Importwarteschlange den Beleg ab, legt den Core-Beleg (`DXP Document`) und den SQUEEZE-Beleg an, markiert den Eintrag als verarbeitet und setzt den Beleg in SQUEEZE auf `FINISHED`.

Beide Schritte laufen in der Aufgabenwarteschlange und bei der Aktion **Belege jetzt herunterladen** auf den Seiten Squeeze Belege, Squeeze Importwarteschlange und Squeeze Warteschlange. Vor jedem der beiden Schritte wird ein Event mit `IsHandled` ausgelöst.

## Event-Matrix (Kurzüberblick)

<table id="bkmrk-event-zeitpunkt-steu"><thead><tr><th>Event</th><th>Zeitpunkt</th><th>Steuerung</th><th>Typische Use-Cases</th></tr></thead><tbody><tr><td>`OnBeforeDownloadDocumentData`</td><td>vor dem Abruf der Beleg-IDs aus SQUEEZE</td><td>`IsHandled`</td><td>Abholen im Testsystem vollständig unterbinden</td></tr><tr><td>`OnBeforeCreateCoreAndSQUEEZEDocumentV2`</td><td>vor dem Abruf und der Anlage eines einzelnen Belegs</td><td>`IsHandled`</td><td>bereits eingereihte Belege nicht anlegen; einzelne Dokumentenklassen oder Belege zurückhalten</td></tr></tbody></table>

## Events in `DXP SQZ API Mgt.`

### `OnBeforeDownloadDocumentData`

Wird ganz am Anfang von `DownloadDocumentData` ausgelöst, bevor eine Verbindung zu SQUEEZE aufgebaut wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeDownloadDocumentData(var IsHandled: Boolean)

```

Mit `IsHandled := true` wird der gesamte Schritt übersprungen: Es werden keine Beleg-IDs abgerufen, keine Einträge in die Importwarteschlange geschrieben und keine Belege im Status „Neu erstellen“ erneut abgerufen.

### `OnBeforeCreateCoreAndSQUEEZEDocumentV2`

Wird in `CreateCoreAndSQUEEZEDocument` für jeden Beleg ausgelöst, bevor er aus SQUEEZE abgerufen wird.

Signatur:

```al
[IntegrationEvent(false, false)]
local procedure OnBeforeCreateCoreAndSQUEEZEDocumentV2(DocClass: Enum "DXP Document Class"; SQUEEZEDocId: Text[50]; var IsHandled: Boolean)

```

Parameter:

- `DocClass` – Dokumentenklasse des Belegs, z. B. `DXP Invoice / Credit Memo` oder `DXP Order Confirmation`
- `SQUEEZEDocId` – ID des Belegs in SQUEEZE
- `IsHandled` – auf `true` setzen, um den Beleg zu überspringen

Mit `IsHandled := true`:

- wird weder ein Core-Beleg noch ein SQUEEZE-Beleg angelegt,
- bleibt der Beleg in SQUEEZE unverändert – er wird nicht auf `FINISHED` gesetzt,
- bleibt der Eintrag in der Importwarteschlange unverarbeitet und wird beim nächsten Lauf erneut angeboten.

<p class="callout info">Um ein Testsystem vollständig abzuschirmen, braucht ihr dieses Event zusätzlich zu `OnBeforeDownloadDocumentData`: Eine Kopie des Produktivsystems bringt auch die Einträge mit, die dort bereits in der Importwarteschlange standen. Ohne dieses Event würden sie im Testsystem angelegt.</p>

<p class="callout warning">Übersprungene Einträge werden bei jedem Lauf erneut versucht und zählen dabei zu den bis zu 10 Einträgen, die ein Lauf verarbeitet. Haltet ihr nur einzelne Belege zurück, können diese Einträge die Verarbeitung der übrigen aufhalten.</p>

Das ältere Event `OnBeforeCreateCoreAndSQUEEZEDocument` ist obsolet und wird nicht mehr ausgelöst. Verwendet stattdessen `OnBeforeCreateCoreAndSQUEEZEDocumentV2`.

## Minimalbeispiel: Abholen in einer Sandbox unterbinden

Das Beispiel behandelt jede Sandbox als Testsystem. Passt Objekt-IDs/Namen an euren Namespace und die Prüfung in `IsTestSystem` an eure Regeln an.

```al
codeunit 50102 "My SQZ Test System Guard"
{
    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnBeforeDownloadDocumentData', '', false, false)]
    local procedure SkipDownloadInTestSystem(var IsHandled: Boolean)
    begin
        if IsTestSystem() then
            IsHandled := true;
    end;

    [EventSubscriber(ObjectType::Codeunit, Codeunit::"DXP SQZ API Mgt.", 'OnBeforeCreateCoreAndSQUEEZEDocumentV2', '', false, false)]
    local procedure SkipCreationInTestSystem(DocClass: Enum "DXP Document Class"; SQUEEZEDocId: Text[50]; var IsHandled: Boolean)
    begin
        if IsTestSystem() then
            IsHandled := true;
    end;

    local procedure IsTestSystem(): Boolean
    var
        EnvironmentInformation: Codeunit "Environment Information";
    begin
        // Beispiel: jede Sandbox gilt als Testsystem.
        // On-Premises oder bei anderen Regeln eine eigene Prüfung einsetzen,
        // z. B. ein Kennzeichen in einer eigenen Einrichtungstabelle.
        exit(EnvironmentInformation.IsSandbox());
    end;
}

```

Bei der Aktion **Belege jetzt herunterladen** erhält der Benutzer keine Rückmeldung, dass das Abholen übersprungen wurde. Wenn ihr das möchtet, zeigt im Subscriber eine Meldung an – nur wenn `GuiAllowed()` zutrifft, damit die Aufgabenwarteschlange davon unberührt bleibt.

# FAQ

Hier finden sie Fragen und Antworten zu verschiedenen Szenarien.

# Stammdaten können nicht synchronisiert werden

### Prüfen der Squeeze Stammdatentabellen in BC

In der Einrichtung zu den [Squeeze Stammdatentabellen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/squeeze-stammdatentabellen) sehen Sie welche Stammdaten Tabellen synchronisiert werden sollen, bzw. schon synchronisiert worden sind. Dort können Sie auch für einzelne Tabellen die Synchronisation gen Squeeze deaktivieren.

### Prüfen der Bestellsynchronisierung

Bestellungen werden nicht sofort, sondern vom Aufgabenwarteschlangenposten „DEXPRO Squeeze - Stammdatensynchronisierung“ alle 5 Minuten übertragen. Eine freigegebene Bestellung kann daher bis zu 5 Minuten später in Squeeze erscheinen. Prüfen Sie in den Aufgabenwarteschlangenposten, ob dieser Posten vorhanden ist und den Status „Bereit“ hat. Fehlt er, legen Sie ihn über die Aktion [Hintergrundjobs anlegen](https://docs.squeeze.one/link/303#bkmrk-hintergrundjob) in der SQUEEZE Einrichtung an.

### Prüfen der Squeeze Stammdaten

Auf der Squeeze Seite können Sie prüfen, ob alle Stammdatentabellen bereits vorhanden sind. Sollten welche fehlen, so kann es zu einem 404 Fehler beim Synchronisierungsversuch kommen. Dies wird in der aktuellsten App Version umgangen, indem die Tabelle im Zweifelsfall nachträglich in Squeeze angelegt wird.

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

### Prüfen der Einrichtungen

#### Squeeze Einrichtung

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

Stimmt die [Squeeze URL](https://docs.squeeze.one/link/303#bkmrk-api) überein? Ist das korrekte Squeeze System hinterlegt? Prüfen Sie hierfür die URL.

Wie ist der [Verbindungsstatus](https://docs.squeeze.one/link/303#bkmrk-api-schl%C3%BCssel-holen-0)? Ist der Haken grün? Wenn nicht holen Sie sich einen aktuellen API Schlüssel.

Hat der [initiale Stammdaten-Upload](https://docs.squeeze.one/link/303#bkmrk-stammdaten-erstmalig) bereits stattgefunden?

#### Dokumentenklassen Einrichtung

Stimmen die [API Einstellungen](https://docs.squeeze.one/link/320#bkmrk-api-einstellungen) der Dokumentenklasse? Bitte prüfen Sie ob die eingetragenen Ids mit denen auf der DEXPRO Plattform überein stimmen.

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

##### Prüfen der Dokumentenklassen Id

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

#####  

##### Prüfen der Export Schnittstellen Id

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

##### Prüfen der Line Table Id

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

# Belege werden nicht aus Squeeze abgeholt und verbleiben dort im Export Schritt

### Prüfen der Importwarteschlange

Gibt es bereits einen Eintrag in der [Importwarteschlange](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/importwarteschlange) mit der Squeeze docId? Bitte beim Prüfen die Systemfilterung ebenfalls entfernen.

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

Nach klicken auf "Systemfilter anzeigen" werden die Systemfilter eingeblendet.

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

Sobald diese Filter entfernt worden sind, werden alle Belege mandantenübergreifend angezeigt. Prüfen Sie, ob die Squeeze docid in der Spalte "Beleg Id" vorhanden und ob der Eintrag bereits verarbeitet worden ist. Wenn ja, kann dieser nicht erneut runtergeladen werden. Dann muss der Beleg auf der Squeeze Seite (DEXPRO Plattform) manuell in den Schritt "Verarbeitet" gesetzt werden.

Sollte der Beleg nicht in der Liste sein, so kann der nicht abgeholte Beleg über den Importpuffer direkt gezogen werden.

### Prüfen der Einrichtungen

#### Squeeze Einrichtung

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

Stimmt die [Squeeze URL](https://docs.squeeze.one/link/303#bkmrk-api) überein? Ist das korrekte Squeeze System hinterlegt? Prüfen Sie hierfür die URL.

Wie ist der [Verbindungsstatus](https://docs.squeeze.one/link/303#bkmrk-api-schl%C3%BCssel-holen-0)? Ist der Haken grün? Wenn nicht holen Sie sich einen aktuellen API Schlüssel.

#### Dokumentenklassen Einrichtung

Stimmen die [API Einstellungen](https://docs.squeeze.one/link/320#bkmrk-api-einstellungen) der Dokumentenklasse? Bitte prüfen Sie ob die eingetragenen Ids mit denen auf der DEXPRO Plattform überein stimmen.

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

##### Prüfen der Dokumentenklassen Id

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

#####  

##### Prüfen der Export Schnittstellen Id

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

##### Prüfen der Line Table Id

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

# Kontierungen anhand von Bedingungen auswählen

<div class="scriptor-paragraph" id="bkmrk-bei-uns-gibt-es-die-">Bei uns gibt es die Möglichkeit Kontierungen an Bedingungen zu knüpfen und diese automatisiert anwenden zu lassen.</div><div class="scriptor-paragraph" id="bkmrk-"></div><div class="scriptor-paragraph" id="bkmrk-hierzu-geht-man-in-d">Hierzu geht man in die Dokumentenklassen Einrichtung.</div><div class="scriptor-paragraph" id="bkmrk-unten-bei-dem-regel-">Unten bei dem Regel-Abschnitt legt man einen neuen Wert bei dem Feld "Kontierungscode" an.</div><div class="scriptor-paragraph" id="bkmrk--1">![embedded-image-g4cmioid.png](https://docs.squeeze.one/uploads/images/gallery/2026-08/embedded-image-g4cmioid.png)</div><div class="scriptor-paragraph" id="bkmrk-dadurch-k%C3%B6nnen-konti">Dadurch können Kontierungen nun anhand von Regeln gesetzt werden.</div><div class="scriptor-paragraph" id="bkmrk-nun-kann-man-in-dies">Nun kann man in diesem Kontierungsregelsatz einzelne Regeln zu den jeweiligen Kreditoren anlegen und definieren.</div><div class="scriptor-paragraph" id="bkmrk--2">![embedded-image-ye2pkpyx.png](https://docs.squeeze.one/uploads/images/gallery/2026-08/embedded-image-ye2pkpyx.png)</div><div class="scriptor-paragraph" id="bkmrk-nehmen-wir-nun-ein-b">Nehmen wir nun ein Beispiel:</div><div class="scriptor-paragraph" id="bkmrk-regel-f%C3%BCr-die-%22olden">Regel für die "oldenburgische Industrieversicherung":</div><div class="scriptor-paragraph" id="bkmrk--4">![embedded-image-pcuwp1il.png](https://docs.squeeze.one/uploads/images/gallery/2026-08/embedded-image-pcuwp1il.png)</div><div class="scriptor-paragraph" id="bkmrk-im-oberen-bereich-de">Im oberen Bereich definiert man das "Wenn". Hier kann man Bezug zu allen Inhalten des Squeeze Belegkopfes und zu allen Verknüpften Informationen zum Belegkopf hernehmen und durch verschiedene Vergleichsoperatoren abgleichen lassen. Die einzelnen Bedingungen können "UND" oder "ODER" verknüpft werden.</div><div class="scriptor-paragraph" id="bkmrk-beispiel%3A-wenn-die-k">Beispiel: Wenn die Kreditoren Nummer = 4711 ist UND in der Position enthält das Feld Beschreibung "Prüfungsgebühr Zwischenprüfung", dann soll das "Dann" ausgeführt werden. Dies ist im unteren "DEXPRO Squeeze" Bereich definiert.</div><div class="scriptor-paragraph" id="bkmrk-dort-wird-die-passen">Dort wird die passende Kontierungsvorlage ausgewählt.</div><div class="scriptor-paragraph" id="bkmrk-in-der-kontierungsvo">In der Kontierungsvorlage selber definiert man die MwSt. Raten die beachtet und kontiert werden sollen. So kann man spezifisch auf die MwSt. Sätze der Lieferanten eingehen und dadurch später in einem Schritt automatisiert Rechnungen mit mehreren Steuersätzen in einem Rutsch abarbeiten lassen.</div><div class="scriptor-paragraph" id="bkmrk-hier-das-beispiel-f%C3%BC">Hier das Beispiel für eine MwSt. Rate von 19%:</div><div class="scriptor-paragraph" id="bkmrk--7">![embedded-image-ykbwu3lt.png](https://docs.squeeze.one/uploads/images/gallery/2026-08/embedded-image-ykbwu3lt.png)</div><div class="scriptor-paragraph" id="bkmrk-oben-steht-die-mwst.">Oben steht die MwSt. Rate welche kontiert werden soll.</div><div class="scriptor-paragraph" id="bkmrk-in-der-mitte-befinde">In der Mitte befindet sich die Kontierung selber.</div><div class="scriptor-paragraph" id="bkmrk-unten-sind-die-short">Unten sind die Shortcut Dimensionen zu sehen. Wie Kostenstelle, Kostenträger und co. welche bei der automatischen Kontierung ebenfalls mit gesetzt werden.</div><p class="callout info">Welche Kontierungseinrichtung verwendet wird: Greift eine Regel der Regelgruppe und enthält sie einen Kontierungscode, wird dieser verwendet. Andernfalls nimmt SQUEEZE den Kontierungscode aus der [Kreditorenbezogenen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/kreditorenbezogene-einrichtung) des Kreditors und, wenn dort keiner hinterlegt ist, den aus der Dokumentenklassen Einrichtung.</p>

<div class="scriptor-paragraph" id="bkmrk-so-k%C3%B6nnte-diese-beis">So könnte diese Beispiel-Anforderung im Standard ohne Programmierung umgesetzt werden.</div>## Einzelne Zeilen per Regel kontieren

Der Kontierungscode oben wählt eine Kontierungseinrichtung für den ganzen Beleg. Regeln zur Zeilenkontierung arbeiten dagegen auf jeder Belegzeile einzeln: Eine Regel weist jeder Zeile, auf die sie zutrifft, ein Konto und Dimensionen zu. So lassen sich z. B. alle Zeilen, deren Beschreibung „Fracht“ enthält, auf ein Frachtkonto mit der Kostenstelle der Logistik kontieren.

### Einrichtung

1. Öffnen Sie die [Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung) der Dokumentenklasse. Legen Sie im Abschnitt **Regeln** einen neuen Wert im Feld **Zeilenkontierung** an. Wie beim Kontierungscode ist dieser Wert eine Regelgruppe.
2. Legen Sie in dieser Regelgruppe die Regeln an. Ihre Bedingungen können sich auf die Belegzeile beziehen, aber auch auf den Squeeze Belegkopf und die übrigen verknüpften Informationen. Bedingungen auf die Belegzeile werden für jede Zeile einzeln geprüft; deshalb zeigt die Regelkarte bei diesen Regeln keine **Datensatz-Abgleichsart** an.
3. Das „Dann“ legen Sie im unteren Bereich **DEXPRO Squeeze** der Regel fest, Gruppe **Zeilenkontierung**: 
    - **Kontoart** und **Kontonr.**: das Sachkonto, der Artikel, die Ressource, die Anlage oder der Artikel Zu-/Abschlag, den die Zeile erhält. Lassen Sie **Kontonr.** leer, um nur Dimensionen hinzuzufügen.
    - **Produktbuchungsgruppe** und **MwSt. Produktbuchungsgruppe**: ersetzen die Buchungsgruppen, die die Zeile vom Konto übernimmt, z. B. passend zum MwSt.-Satz des Belegs. Bleiben die Felder leer, gelten die des Kontos.
    - **Dimensionen**: die Shortcutdimensionen, die die Zeile erhält. Über die Aktion **Zeilendimensionen** der Regel bearbeiten Sie alle Dimensionen der Regel, auch solche ohne Shortcut.

{add screenshot of Regel mit der Gruppe Zeilenkontierung here}

### Wie die Regeln angewendet werden

Die Regeln laufen automatisch, wenn eine Rechnung, Gutschrift oder Auftragsbestätigung aus SQUEEZE importiert wird. Sie laufen nach den übrigen automatischen Schritten des Imports wie Autovervollständigen, Bestellabgleich und Kontierung nach MwSt.-Satz und sehen deshalb die endgültigen Zeilen. Sie laufen vor einer automatischen Validierung, damit die zugewiesenen Konten in den Zielbeleg übernommen werden.

- Für jede Zeile werden die Regeln in der Reihenfolge ihrer **Sequenz Nr.** geprüft, und zwar nur aktive Regeln, die derzeit gültig sind. Die erste Regel, deren Bedingungen zutreffen, wird angewendet; für diese Zeile wird keine weitere Regel geprüft. Eine Zeile, auf die keine Regel zutrifft, bleibt unverändert.
- Eine zutreffende Regel ohne Konto und ohne Dimensionen lässt die Zeile unverändert und hält die nachfolgenden Regeln von ihr fern. So schließen Sie Zeilen aus.
- Eine zutreffende Regel überschreibt das Konto, das eine Zeile bereits hat, auch eines aus der Kontierungseinrichtung.
- Menge, EK-Preis, Rabatte und Zeilenbetrag bleiben genau so, wie sie aus dem Beleg gelesen wurden.
- Zeilen, die einer Bestell- oder Wareneingangszeile zugeordnet sind, werden übersprungen: Ihr Konto kommt aus dieser Zeile.
- Die Dimensionen der Regel kommen zu denen hinzu, die die Zeile bereits hat, z. B. den Vorgabedimensionen des Kontos. Haben beide einen Wert für dieselbe Dimension, gilt der Wert der Regel.
- Das Feld **Artikelabgleichsmethode** der Zeile zeigt, welche Regel das Konto zugewiesen hat, z. B. **Zugeordnet durch Kontierungsregel FRACHT (Frachtkosten).** Das Feld ist standardmäßig ausgeblendet; blenden Sie es über das Anpassen der Seite in den Zeilen ein.

<p class="callout info">Ein Konto, das seit dem Einrichten der Regel gesperrt wurde, hält den Import nicht auf. Die [Plausibilitätsprüfung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/plausibilitatsprufungen) des Belegs meldet es.</p>

### Regeln erneut anwenden

Wenn Sie eine Regel geändert oder die Zeilen korrigiert haben, wählen Sie in den Zeilen des SQUEEZE Belegs **Funktionen** → **Kontierungsregeln anwenden**. Eine Meldung zeigt, auf wie viele Zeilen eine Regel angewendet wurde, z. B. **Die Kontierungsregeln wurden auf 3 von 5 Zeilen angewendet.**

Ist für die Dokumentenklasse keine Regelgruppe im Feld **Zeilenkontierung** hinterlegt, bricht die Aktion mit **Zeilenkontierung ist für die Dokumentenklasse … nicht eingerichtet.** ab, wobei an Stelle der Punkte die Dokumentenklasse steht.

# Testsystem holt Belege aus Squeeze ab

Ein Testsystem, das mit derselben SQUEEZE-Instanz verbunden ist wie das Produktivsystem – zum Beispiel weil es als Kopie der Produktion angelegt wurde –, holt dort ebenfalls Belege ab.

<p class="callout warning">Ein abgeholter Beleg wird in SQUEEZE als verarbeitet markiert. Belege, die das Testsystem abholt, fehlen danach im Produktivsystem.</p>

### SQUEEZE im Testsystem deaktivieren

Soll das Testsystem gar nicht mit SQUEEZE kommunizieren, deaktivieren Sie SQUEEZE dort:

1. Öffnen Sie im Testsystem die Seite [Squeeze Einrichtung](https://docs.squeeze.one/link/303).
2. Entfernen Sie den Haken im Feld **Aktiviert**.

Gleichwertig ist das Feld **Aktiv** bei der App DEXPRO SQUEEZE im Bereich **DEXPRO Apps** der Seite **Core Einrichtung**. Beide Felder werden miteinander abgeglichen.

Danach holt das Testsystem keine Belege mehr ab – weder über die Aufgabenwarteschlange noch über die Aktion **Belege jetzt herunterladen**. Wird die Aktion trotzdem ausgeführt, erscheint die Meldung **App DEXPRO SQUEEZE ist nicht aktiviert.**

<p class="callout info">Alle Funktionen, die SQUEEZE aufrufen, stehen im Testsystem dann nicht zur Verfügung. Da die Einrichtung bei jeder neuen Kopie der Produktion mitkopiert wird, ist SQUEEZE danach wieder aktiviert. Wiederholen Sie die Deaktivierung deshalb nach jeder Kopie – oder lassen Sie sie automatisch erledigen (siehe nächster Abschnitt).</p>

### Automatisch oder nur für bestimmte Belege

Soll das Testsystem das Abholen selbst erkennen und unterbinden, oder sollen nur bestimmte Belege zurückgehalten werden, kann ein Entwickler das ab SQUEEZE Version 2.54.0.0 über zwei Integration Events umsetzen. Beschreibung und Beispiel: [Events vor dem Abholen und Anlegen von SQUEEZE-Belegen](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/events-vor-dem-abholen-und-anlegen-von-squeeze-belegen).