# DEXPRO Microsoft Dynamics 365 Business Central Apps
Hier finden Sie eine Übersicht über unsere Microsoft Dynamics 365 Business Central Apps.
# Systemvoraussetzungen / System Requirements
Systemvoraussetzungen zur Nutzung unserer Microsoft Dynamics 365 BC Apps.
System requirements for using SQUEEZE for Dynamics 365 BC
# Microsoft Dynamics 365 Business Central Versionen
Die Microsoft Dynamics 365 Business Central Integration ist auf Grund von technischen Mindestvoraussetzungen ab folgender Version möglich:
Microsoft Dynamics 365 Business Central integration is possible from the following version due to minimum technical requirements:
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.
The prerequisite for operation is that the respective Microsoft Dynamics 365 Business Central version is still in regular support. The extended support is excluded.
[Microsoft.com Product Lifecycle Dynamics 365 Business Central](https://learn.microsoft.com/en-us/lifecycle/products/dynamics-365-business-central-onpremises-modern-policy)
[Microsoft.com Lifecycle Policy](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/terms/lifecycle-policy-on-premises)
# Business Central Lizenzen / License
### Microsoft
Bei OnPrem Installationen muss der Dynamics Business Central Kunden Lizenz die DEXPRO [Module](https://docs.squeeze.one/books/dexpro-microsoft-dynamics-365-business-central-apps/page/bezug-der-dexpro-module) hinzugefügt werden. Dies kann nur durch einen registrierten Partner der DEXPRO Solutions GmbH durchgeführt werden. Dieser muss bei Microsoft als offizieller Reseller hinterlegt werden.
Dies entfällt bei Downloads aus dem Microsoft AppSource.
For OnPrem installations, the DEXPRO modules must be added to the Dynamics Business Central customer license. This can only be done by a registered partner of DEXPRO Solutions GmbH. This partner must be registered with Microsoft as an official reseller.
This does not apply to downloads from the Microsoft AppSource.
# Bezug der DEXPRO Module / Obtaining the DEXPRO modules
### OnPrem
Für OnPrem Installationen wird auf Anfrage eines registrierten Resellers / Partners ein Runtime Package mit den benötigten Apps in der BC Version des Kunden zur Verfügung gestellt. Diese werden durch den Partner der Kundenlizenz hinzugefügt und im Anschluss in das Microsoft Dynamics Business Central eingespielt. Hierbei ist zu beachten, dass die DEXPRO Core App die Grundlage für alle DEXPRO Apps bildet und zuerst installiert werden muss.
For OnPrem installations, a runtime package with the required apps is provided in the customer's BC version at the request of a registered reseller/partner. These are added to the customer license by the partner and then imported into Microsoft Dynamics Business Central. Please note that the DEXPRO Core App forms the basis for all DEXPRO Apps and must be installed first.
Um als Reseller/Partner registriert zu werden muss ein Partner-Rahmenvertrag mit der DEXPRO Solutions GmbH abgeschlossen werden.
In order to be registered as a reseller/partner, a partner framework agreement must be concluded with DEXPRO Solutions GmbH.
### Cloud
Für Cloud Installationen benötigt man lediglich Zugriff auf den Microsoft AppSource. Hier werden die benötigten DEXPRO Apps heruntergeladen. Zu beachten ist, dass die DEXPRO Core App automatisch installiert wird, sobald eine andere DEXPRO App installiert wird.
For cloud installations, you only need access to the Microsoft AppSource. The required DEXPRO apps are downloaded here. Please note that the DEXPRO Core app is automatically installed as soon as another DEXPRO app is installed.
### Apps
Granule der Apps
|  | DEXPRO Core | 70954575 |
| [](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.69470%7CPAPPID.368db399-65f5-4250-9afd-b2a67a49e809?tab=Overview) | DEXPRO Squeeze | 70954630 |
| [](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.72374%7CPAPPID.b9c8c9cc-8cd1-41cc-bf86-7da37ac74c71?exp=ubp8&tab=Overview) | DEXPRO Freeze | 70954890 |
| [](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.69468%7CPAPPID.7c431886-108e-44c3-9328-30e2b93edfa6?exp=ubp8&tab=Overview) | DEXPRO Breeze Interface | 70954895 |
| [](https://appsource.microsoft.com/de-de/product/dynamics-365-business-central/PUBID.dexprosolutionsgmbh%7CAID.78769%7CPAPPID.37f06ebc-53f0-4d9c-9572-7229113363f9?tab=Overview) | DEXPRO eInvoice Sender | 70954900 |
| [](https://marketplace.microsoft.com/de-de/product/PUBID.dexprosolutionsgmbh%7CAID.69471%7CPAPPID.11a79c49-1645-4cf9-9b27-3d2eaafcf9f4?tab=Overview)
| DEXPRO Advanced Workflow | 70954790 |
# 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 Nachverfolgung 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.
The DEXPRO Core manages the individual DEXPRO apps and their documents per client.
All documents that have been entered and processed via the various DEXPRO modules in Microsoft Dynamics 365 Business Central are displayed. A global number series, which is used across all DEXPRO apps, is used to complete individual documents. This offers the advantage that users only have to work with one number series per document.
# Core Einrichtung / Setup
In der Core Einrichtung werden die einzelnen DEXPRO Apps pro Mandant verwaltet. Eine globale Nummernserie über alle DEXPRO Apps bietet den Vorteil, dass die Anwender mit nur einer Nummernserie pro Beleg arbeiten. Diese Belegnummern bleiben auch bei der Übergabe an andere DEXPRO Apps vorhanden.
The individual DEXPRO apps are managed per client in the core setup. A global number series across all DEXPRO apps offers the advantage that users only work with one number series per document. These document numbers also remain available when transferred to other DEXPRO apps.
[](https://docs.squeeze.one/uploads/images/gallery/2022-02/image-1645615058402.png)
### Protokolle der verarbeiteten Daten / Logging of processed data
Administratoren haben die Möglichkeit die Protokollierung zu aktivieren.
Administrators have the option to activate a logging of document creation.
[](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737717288258.png)
##### Übersicht der Protokolle
Unter der Schaltfläche "Protokolle der Dokumentenerstellung" können diese dann eingesehen werden.
These can then be viewed under the “Document creation logs” button.
[](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737717320487.png)
##### JSON Vergleich / Compare JSON
Unter "JSON vergleichen" werden die Quelldaten und die angelegten Daten im JSON Format angezeigt und können manuell verglichen werden.
Under “Compare JSON”, the source data and the created data are displayed in JSON format and can be compared manually.
[](https://docs.squeeze.one/uploads/images/gallery/2025-01/image-1737717344613.png)
# Core Belege / Documents
Diese Ansicht dient zur Nachverfolgung von einzelnen Belegen.
Hier werden alle Belege, welche über die unterschiedlichen DEXPRO Module in Microsoft Dynamics 365 Business Central eingelaufen und verarbeitet worden sind, angezeigt.
This view is used to track individual documents.
All documents that have been entered and processed via the various DEXPRO modules in Microsoft Dynamics 365 Business Central are displayed here.
[](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1646216502031.png)
Pro Beleg wird neben der globalen Belegnummer und der Dokumentenklasse auch der aktuelle Status und eine Verknüpfung zum aktuellen Datensatz mit angezeigt. Hierdurch lassen sich alle Belege und deren Zustände schnell auswerten.
In addition to the global document number and the document class, the current status and a link to the current data record are also displayed for each document. This allows all documents and their statuses to be evaluated quickly.
# Dokumentenklassen Einrichtung / Documentclass Setup
In der 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.
In the document class setup, the assignment between the respective document class and your export interface is made. Furthermore, the field mapping of each document class is downloaded here, creating a set of standard fields and their use in Microsoft Dynamics 365 Business Central.
### Vorgang / Process
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761301592944.png)
#### Feldzuordnung herunterladen / Download field mapping
Hiermit wird die Feldstruktur der SQUEEZE Dokumentenklasse heruntergeladen. Diese werden für die [Metadaten-Zuordnung](#bkmrk-metadaten-zuordnung) benötigt.
This downloads the field structure of the SQUEEZE document class. These are required for the [metadata assignment](#bkmrk-metadaten-zuordnung).
### Navigation
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761301615961.png)
#### Feldmapping / Field Mapping
Über diesen Menüpunkt erreichen Sie die [Metadaten-Zuordnung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-admin-handbuch/page/metadaten-zuordnung). In dieser wird definiert welche Felder wie an Microsoft Dynamics 365 Business Central übertragen werden sollen.
You can access the [metadata mapping](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-en-us/page/field-mapping) via this menu item. This defines which fields are to be transferred to Microsoft Dynamics 365 Business Central and how.
#### Kreditorenbezogene Einrichtung / Vendor Related Setup
Ü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.
Via this menu item you reach the [vendor-related setup](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-manual/page/vendor-related-setup). In this, deviating rules can be deposited per creditor.
### Liste / List
#### Dokumentenklassen / Documentclasses
In dieser Übersicht werden alle eingerichteten Dokumentenklassen aufgelistet.
This overview lists all the document classes that have been set up.
[](https://docs.squeeze.one/uploads/images/gallery/2022-12/image-1671447413471.png)
### Karte / Card
#### Dokumentenklasse
Hier wird jede Dokumentenklasse individuell eingerichtet.
Each document class is set up individually.
### Allgemein / General
[](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677144005353.png)
In diesem Fastab wird der Name der Dokumentenklasse, der nächste Prozessschritt, sowie die automatische Anreicherung der Positionen eingerichtet.
In this Fastab, the name of the document class, the next process step and the automatic enrichment of the items are set up.
### Squeeze
Dokumentation der [Squeeze Dokumentenklassen Einrichtung](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de/page/dokumentenklassen-einrichtung)
Documentation of the [squeeze document class setup](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-en-us/page/document-classes-setup)
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761291449747.png)
#### API Einstellungen / API Settings
In diesem Fastab werden die SQUEEZE spezifischen Tabellen und Export Schnittstellen eingerichtet.
The SQUEEZE-specific tables and export interfaces are set up in this Fastab.
#### Bestellabgleich / Order Match
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- & 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, werden die Beträge und Beschreibungen der Positionen mit denen der Bestellung/Lieferung nach dem Abgleich ersetzt.
The purchase [order reconciliation](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-manual/page/order-goods-receipt-reconciliation) is used for the automated check of the read out positions with those of the still open purchase orders in Microsoft Dynamics 365 Business Central. In this Fasttab, the permissible amount & quantity tolerances for the matching are set up. Additionally, it can be defined whether the matching should take place on purchase orders or deliveries. If "Replace data" is active, the amounts and descriptions of the items will be replaced with those of the order/delivery after matching.
#### Plausibilitätsprüfung / Plausibility Check
An dieser Stelle können Sie einzelne Plausibilitätsprüfungen deaktivieren.
Here you can deactivate individual plausibility checks.
#### Regeln / Rules
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. Beispielsweise können Sie für die Bestimmung des nächsten Prozessschrittes Regeln definieren, welche Entscheiden wie welcher Beleg weitergegeben wird.
Here, you can use the [Rules Engine](https://docs.squeeze.one/books/dexpro-microsoft-dynamics-365-business-central-apps/page/regel-engine-rules-engine) to set up rule-based configurations. For example, you can define rules for determining the next process step, which decide how a document is forwarded.
### Freeze
[](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677144317341.png)
Hier legt man die Standard Suchmaske fest.
The standard search mask is defined here.
### Breeze Interface
[](https://docs.squeeze.one/uploads/images/gallery/2023-02/image-1677144339201.png)
Hier legt man die Standard Zielvorlage fest.
The standard target template is defined here.
# Regel-Engine / Rules Engine
Der DEXPRO Core bietet die Möglichkeit über einfache Wenn-Dann Regeln automatisierte Entscheidungen pro Beleg zu treffen. Diese Verwaltung von Geschäftsregeln wird in der Rules Engine in Regelsätzen verwaltet.
The DEXPRO Core offers the option of making automated decisions for each document using simple if-then rules. These business rules are managed in rule sets in the Rules Engine.
### Regelsätze / Rule Set
Hier finden Sie alle bisher angelegten Regelsätze und deren Ursprung, sowie deren Verwendungsort.
Here you will find all rule sets created to date and their origin, as well as where they are used.
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761291966284.png)
### Regeln / Rules
Hier finden Sie die hinterlegten Regeln pro Regelsatz und deren Reihenfolge wie sie geprüft werden (Priorität). Sie können die Reihenfolge jederzeit über das Menü ändern. Zusätzlich können Sie sowohl die Regelgruppe, als auch einzelne Regeln anhand von Beispieldatensätzen [testen](https://docs.squeeze.one/link/864#bkmrk-regeltest).
Here you will find the stored rules for each rule set and the order in which they are checked (priority). You can change the order at any time via the menu. In addition, you can [test](https://docs.squeeze.one/link/864#bkmrk-regeltest) both the rule group and individual rules using sample data records.
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761294607234.png)
### Regelkarte / Rule Card
Hier können Sie die Konfiguration der Regel vornehmen und die Bedingungen eintragen. Die Verknüpfung der Bedingungen kann entweder per "UND" oder per "ODER" erfolgen.
Here you can configure the rule and enter the conditions. The conditions can be linked using either “AND” or “OR.”
[](https://docs.squeeze.one/uploads/images/gallery/2026-01/image-1769675755282.png)
#### Zugehörige Tabellen / Related Tables
Hier können Sie Bezüge von weiteren Tabellen zur verwendeten Quelle einrichten, so dass deren Felder mit in den Regelbedingungen genutzt werden können.
Here you can set up references from other tables to the source used so that their fields can be used in the rule conditions.
#### DEXPRO Squeeze
Hier setzen Sie die auszuführenden Dinge für die DEXPRO Squeeze App, die gelten, wenn die Regel zutrifft.
Here you set the actions to be performed for the DEXPRO Squeeze app that apply when the rule is true.
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761294220275.png)
### Regeltest / Rule Check
Hier können Sie die Regel anhand von vorhandenen Datensätzen testen.
Sie wählen den Testdatensatz aus und klicken auf "Regel testen". Im Anschluss wird Ihnen dann das Resultat des Tests angezeigt. Auf der rechten Seite sieht man zusätzlich die Ergebnisse der einzelnen Regelbedingungen.
Here you can test the rule using existing data records.
Select the test data record and click on “Test rule.” The result of the test will then be displayed. On the right-hand side, you can also see the results of the individual rule conditions.
[](https://docs.squeeze.one/uploads/images/gallery/2025-10/image-1761294380939.png)
# DEXPRO Squeeze
Squeeze Extract 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.
Squeeze Extract is a client-enabled software solution for document classification and content extraction.
It is a fully web-based system for processing electronic documents, with a significant focus on the recognition and extraction of incoming documents in the B2B sector.
# Handbuch / User manual
Das Handbuch zur Administration und Nutzung von Squeeze für Microsoft Dynamics 365 Business Central finden Sie hier:
- [Deutsch](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-de-de)
The manual for the administration and use of Squeeze for Microsoft Dynamics 365 Business Central can be found here:
- [Englisch](https://docs.squeeze.one/books/squeeze-for-dynamics-365-bc-en-us)
# DEXPRO Breeze Interface
Die Breeze Interface App stellt eine schlüsselfertige Schnittstelle für die Abholung von Stammdaten und Buchung von Einkaufsbelegen für DEXPRO Breeze Solutions und andere externe Workflow- bzw. ECM-Systeme bereit. Mithilfe der Interface App können XML- (JSON) basierte Daten empfangen und direkt in Dynamics 365 Business Central als Standard-Eingangsbeleg verarbeitet bzw. als Buchungssatz bereitgestellt werden.
The Breeze Interface App provides a turnkey interface for retrieving master data and posting purchasing documents for DEXPRO Breeze Solutions and other external workflow or ECM systems. Using the Interface App, XML (JSON) based data can be received and processed directly in Dynamics 365 Business Central as a standard incoming document or provided as a posting record.
# Handbuch / User manual
Das Handbuch zur Administration und Nutzung von Breeze Interface für Microsoft Dynamics 365 Business Central finden Sie hier:
- [Deutsch](https://docs.squeeze.one/books/breeze-interface-for-dynamics-365-bc-de-de)
The manual for the administration and use of Breeze for Microsoft Dynamics 365 Business Central can be found here:
- [Englisch](https://docs.squeeze.one/books/breeze-interface-for-dynamics-365-bc-en-us)
# DEXPRO Freeze
Mit der Freeze Archive Integration für Microsoft Dynamics 365 Business Central greifen Sie direkt über die bewährte Microsoft-Oberfläche auf Ihre revisionssicher gespeicherten Daten und Dokumente zu. Freeze Archive verlinkt die Dokumente automatisch zu ihren Business-Objekten und bietet darüber hinaus detaillierte Recherche-Möglichkeiten über die Indexmerkmale und den Volltext Ihrer Dokumente.
With the Freeze Archive integration for Microsoft Dynamics 365 Business Central, you can access your audit-proof stored data and documents directly via the tried-and-tested Microsoft interface. Freeze Archive automatically links the documents to their business objects and also offers detailed search options via the index features and the full text of your documents.
# Handbuch / User manual
Das Handbuch zur Administration und Nutzung von FREEZE für Microsoft Dynamics 365 Business Central finden Sie hier:
- [Deutsch](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-de-de)
The manual for the administration and use of Freeze for Microsoft Dynamics 365 Business Central can be found here:
- [Englisch](https://docs.squeeze.one/books/freeze-for-dynamics-365-bc-en-us)
# DEXPRO eInvoice Sender
DEXPRO eInvoice Sender ist eine unternehmenstaugliche elektronische Rechnungslösung für Microsoft Dynamics 365 Business Central, die nahtlose Konformität mit europäischen E-Invoicing-Standards (ZUGFeRD/Factur-X, XRechnung) bietet. Mit fortschrittlicher Automatisierung und intelligenter Feldzuordnung unterstützt sie Verkaufsrechnungen, Gutschriften, Dienstleistungsrechnungen und Einkaufsgutschriften für Gutschriftsszenarien.
DEXPRO eInvoice Sender is an enterprise-grade electronic invoicing solution for Microsoft Dynamics 365 Business Central that delivers seamless compliance with European e-invoicing standards (ZUGFeRD/Factur-X, XRechnung). Built with advanced automation and intelligent field mapping, supports sales invoices, credit memos, service invoices, and purchase credit memos for self-billing scenarios.
# Handbuch / User manual
Das Handbuch zur Administration und Nutzung des eInvoice Senders für Microsoft Dynamics 365 Business Central finden Sie hier:
- [Deutsch](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-de-de)
The manual for the administration and use of the eInvoice Sender for Microsoft Dynamics 365 Business Central can be found here:
- [Englisch](https://docs.squeeze.one/books/einvoice-sender-for-microsoft-dynamics-365-bc-en-us)
# Universal Code Compliance-Erklärung
**Für Microsoft Dynamics 365 Business Central Partner, die DEXPRO Apps vertreiben**
Dokumentversion: 1.1 · Stand der Prüfung: 30. Juli 2026 · Herausgeber: DEXPRO Solutions GmbH
---
## 1. Zusammenfassung
Alle sechs DEXPRO Apps für Microsoft Dynamics 365 Business Central erfüllen die Definition von **Universal Code** nach Microsoft: Jede App wird mit `"target": "Cloud"` kompiliert, und keine App verändert die Basisanwendung. Nachgewiesen wurde dies durch Kompilierung jeder App gegen das Cloud-Target — siehe Abschnitt 5.
**Bitte lesen Sie Abschnitt 6, bevor Sie einem Kunden Zusagen machen.** Microsoft bewertet die Universal-Code-Konformität über **den gesamten Code der Business Central Lizenz des Kunden** hinweg, nicht pro App. Die Konformität von DEXPRO bedeutet, dass keine DEXPRO App eine Lizenzpflicht für nicht-Universal-Code auslöst. Sie garantiert jedoch **nicht** von sich aus, dass für einen konkreten Kunden keine Gebühren anfallen — dessen eigene Per-Tenant-Extensions und Apps anderer Hersteller werden ebenfalls bewertet.
---
## 2. Was Universal Code bedeutet (Definition von Microsoft)
Die FAQ von Microsoft zur *Business Central Universal Code Initiative* definiert die Begriffe wörtlich wie folgt (englisches Original):
> **Universal Code**: Extensions which are compiled with `"target": "Cloud"` in the app.json.
>
> **Non-Universal Code**: Extensions which are compiled with target other than `"target": "Cloud"` in the app.json, and any solutions/customizations which modify the base application.
Übersetzt: Universal Code sind Erweiterungen, die mit `"target": "Cloud"` in der `app.json` kompiliert werden. Nicht-Universal-Code sind Erweiterungen, die mit einem anderen Target kompiliert werden, sowie alle Lösungen und Anpassungen, die die Basisanwendung verändern.
Die gleiche FAQ beschreibt den Zweck allgemeiner: *„Universal Code refers to partner code isolated in cloud-optimized extensions for Dynamics 365 Business Central so it can be implemented on-premises or online."*
Daraus folgen zwei für DEXPRO maßgebliche Punkte:
1. Technisch entscheidend ist die Eigenschaft `target`, durchgesetzt durch den AL-Compiler. Mit `"target": "Cloud"` weist der Compiler .NET-Interoperabilität, `Scope('OnPrem')`-Member, OnPrem-beschränkte Tabellen und jede weitere API außerhalb der cloud-unterstützten Oberfläche ab.
2. Eine Veränderung der Basisanwendung ist unabhängig vom Target disqualifizierend. DEXPRO liefert ausschließlich AL-Erweiterungsobjekte aus und kann die Basisanwendung daher nicht verändern.
Microsoft bestätigt außerdem: *„When you have successfully published your app on AppSource, your code is already Universal Code."* Eine AppSource-Veröffentlichung ist jedoch **nicht erforderlich**, um Universal Code zu sein: *„As long as all apps used by a customer are implemented as Universal Code (cloud-optimized extensions), these modules and associated fees are not required."*
### Geltungsbereich von Universal Code
Universal Code ist ein **Lizenzkonstrukt für On-Premises-Installationen** von Business Central. In Business Central online (SaaS) stellt sich die Frage nicht: SaaS akzeptiert ausschließlich cloud-optimierte Erweiterungen, sodass jede in SaaS installierbare App per Definition Universal Code ist. Die in Abschnitt 7 beschriebenen kostenpflichtigen Module existieren ausschließlich für On-Premises-Lizenzen.
---
## 3. Prüfungsumfang
| App | Geprüfte Version | App-ID |
|---|
| DEXPRO Core | 3.11.0.0 | `9762f101-ae8a-4a0e-be42-66ec871d1ca0` |
| DEXPRO SQUEEZE | 2.49.0.0 | `368db399-65f5-4250-9afd-b2a67a49e809` |
| DEXPRO Breeze Interface | 1.30.0.0 | `7c431886-108e-44c3-9328-30e2b93edfa6` |
| DEXPRO Advanced Workflow | 1.12.0.0 | `11a79c49-1645-4cf9-9b27-3d2eaafcf9f4` |
| DEXPRO Freeze | 1.29.0.0 | `b9c8c9cc-8cd1-41cc-bf86-7da37ac74c71` |
| DEXPRO eInvoice Sender | 2.0.1.0 | `37f06ebc-53f0-4d9c-9572-7229113363f9` |
DEXPRO Core ist eine erforderliche Abhängigkeit der übrigen fünf Apps. Es bestehen **keine Abhängigkeiten zu Drittanbieter-Apps** — der Abhängigkeitsgraph umfasst ausschließlich Microsoft Base-/System-Applications und DEXPRO Core. Somit kann über eine DEXPRO App keine externe Komponente eine Non-Compliance einbringen.
---
## 4. Prüfmethodik
Die Konformität wurde nicht allein anhand der Manifest-Dateien beurteilt:
1. **Kompilierung gegen das Cloud-Target.** Jede App wurde mit dem AL-Compiler (`alc.exe`, AL Language Extension 17.0) gegen ihr deklariertes Cloud-Target kompiliert, mit aktiviertem AppSourceCop-Analyzer und dem jeweiligen Ruleset des Repositories. Der Compiler ist die maßgebliche Instanz: Jedes ausschließlich OnPrem verfügbare Konstrukt führt unter `"target": "Cloud"` zu einem harten Kompilierfehler. Alle sechs Builds erzeugten ein gültiges `.app`-Artefakt, was bestätigt, dass die Builds vollständig durchliefen und nicht vorzeitig abbrachen.
2. **Prüfung des kompilierten Artefakts.** Das im erzeugten `.app`-Paket eingebettete Manifest wurde zurückgelesen. Alle sechs Pakete tragen im ausgelieferten Binärartefakt `Target="Cloud"`, `Runtime="14.0"`, `Application="25.0.0.0"` und `ShowMyCode="False"` — ein Nachweis am Auslieferungsgegenstand selbst, nicht an der Quellkonfiguration.
3. **Quellcode-Prüfung.** Der gesamte AL-Quellcode aller sechs Apps (**887 Dateien** unter `app/`) wurde auf die in Abschnitt 5.2 genannten disqualifizierenden Konstrukte untersucht.
Die Apps deklarieren eine Mindest-Application-Version von **25.0.0.0**. Die zum Prüfzeitpunkt in den Repositories verfügbaren Symbolpakete reichten je Repository von Business Central 27.3 bis 28.3; damit ist zusätzlich belegt, dass die Apps gegen aktuelle BC-Symbole kompilieren.
---
## 5. Ergebnisse
### 5.1 Kompilierung gegen das Cloud-Target
| App | `target` | Cloud-Kompilierung | `Target` im Artefakt | Blockierende Feststellungen |
|---|
| DEXPRO Core | Cloud | **0 Fehler** | `Cloud` | keine |
| DEXPRO SQUEEZE | Cloud | **0 Fehler** | `Cloud` | keine |
| DEXPRO Breeze Interface | Cloud | **0 Fehler** | `Cloud` | keine |
| DEXPRO Advanced Workflow | Cloud | **0 Fehler** | `Cloud` | keine |
| DEXPRO Freeze | Cloud | **0 Fehler** | `Cloud` | keine |
| DEXPRO eInvoice Sender | Cloud | **0 Fehler** | `Cloud` | keine |
### 5.2 Quellcode-Prüfung auf nicht-cloudfähige Konstrukte
Über alle 887 AL-Dateien hinweg sind die folgenden Werte in **jeder App gleich null**:
| Disqualifizierendes Konstrukt | Vorkommen |
|---|
| `dotnet`-Blöcke / Assembly-Referenzen | 0 |
| `Codeunit … Subtype = DotNet` | 0 |
| `[Scope('OnPrem')]`-Attribute | 0 |
| Tabellen oder Methoden mit `Scope = OnPrem` | 0 |
| COM- / `Automation`-Variablen | 0 |
| `SHELL()` / Aufruf externer Prozesse | 0 |
| Direkter Dateisystemzugriff (Datentyp `File`) | 0 |
| `.dll`-Assemblies oder `.netpackages` im Repository | 0 |
| Änderungen an der Basisanwendung | 0 (strukturell unmöglich — nur Erweiterungsobjekte) |
| Abhängigkeiten zu Drittanbieter-Apps | 0 |
### 5.3 Cloud-konforme Implementierungsmuster
Die Apps verwenden durchgängig die cloud-zulässigen AL-Alternativen:
- **Ausgehende HTTP-Aufrufe** nutzen die AL-eigenen Typen `HttpClient` / `HttpRequestMessage`, niemals .NET `WebRequest`. Dies betrifft Core (`WebRequestMgt`, `OAuth2Mgt`, `OpenIDMgt`), SQUEEZE, Freeze, Advanced Workflow und eInvoice Sender.
- **Umgang mit Geheimnissen** erfolgt über `IsolatedStorage` für Token und Zugangsdaten (Core, SQUEEZE) — nie über Klartext-Tabellenfelder oder Dateien.
- **Dateiverarbeitung** nutzt die Microsoft-Standard-Codeunit `"File Management"` (`BLOBExport`, `GetExtension`, `GetFileNameMimeType`) in Verbindung mit `TempBlob` / `InStream` / `OutStream`. Dies ist die cloud-unterstützte API, kein OnPrem-Dateizugriff.
- **UI-Erweiterbarkeit** erfolgt über JavaScript/HTML Control Add-ins (Dokumentenviewer, Drag & Drop, Workflow-Visualisierung). Alle 11 Control Add-ins sind skriptbasiert; keines referenziert eine .NET-Assembly.
- **Authentifizierung** erfolgt über OAuth2 / OpenID Connect auf Basis der Standardplattform.
### 5.4 Weitere Plattform- und Marketplace-Merkmale
| Merkmal | Status in allen sechs Apps |
|---|
| Runtime-Version | 14.0 |
| Application (Mindest-BC-Version) | 25.0.0.0 |
| `target` | Cloud |
| `resourceExposurePolicy` | `allowDebugging: false`, `allowDownloadingSource: false` |
| `propagateDependencies` | true |
| Features | `TranslationFile`, `NoImplicitWith` |
| Objekt-Präfix (AppSourceCop-Affix) | `DXP` (reserviert) |
| Unterstützte Sprachen | de-DE, en-US |
| Datenschutzerklärung / EULA / Hilfe-URLs | vorhanden |
| Telemetrie | Application Insights (partnerseitig konfigurierbar) |
Jede App liefert eigene Berechtigungssätze für die rollenbasierte Zugriffssteuerung, beispielsweise `DXP CORE Admin` / `DXP CORE User`, `DXP SQUEEZE Admin` / `DXP SQUEEZE User`, `DXP Breeze IF Admin` / `DXP Breeze IF User`, `DXP AWF Admin` / `DXP AWF User`, `DXP Freeze Admin` / `DXP Freeze User` sowie `DXP eInvoice Admin` / `DXP eInvoice Support` / `DXP eInvoice User`.
---
## 6. Was diese Erklärung abdeckt — und was nicht
**Abgedeckt.** Jede in Abschnitt 3 genannte DEXPRO App ist in der genannten Version Universal Code. Keine DEXPRO App löst für Ihren Kunden eine Lizenzpflicht für nicht-Universal-Code aus.
**Nicht abgedeckt.** Microsoft bewertet die Installation des Kunden als Ganzes. Die FAQ beantwortet die Frage *„How can a customer avoid the fees?"* mit: *„Ensure that all code implemented on license \[is\] cloud-optimized extensions."* Die Gebühr *„applies to code modifications associated with both repeatable solutions (ISV apps) and individual customer modifications (PTEs)."*
Ein Kunde, der DEXPRO Apps einsetzt, kann daher weiterhin die kostenpflichtigen Module benötigen, wenn **irgendein anderer** Bestandteil seiner Installation nicht Universal Code ist, zum Beispiel:
- eine für diesen Kunden erstellte Per-Tenant-Extension (PTE) mit `"target": "OnPrem"`,
- eine nicht cloud-optimierte App eines anderen Herstellers,
- eine noch vorhandene Änderung an der Basisanwendung.
Prüfen Sie bei der Kundenberatung **jede** App und Anpassung auf der Lizenz des Kunden. Diese Erklärung deckt ausschließlich die DEXPRO Komponenten ab.
---
## 7. Lizenzrechtliche Folgen und Rollout-Hinweise
### Lizenzrechtlicher Hintergrund (On-Premises)
Für Kunden mit einer On-Premises-Lizenz von Business Central erfordert nicht-Universal-Code eines oder beide der folgenden kostenpflichtigen Module:
| Modul | Erforderlich, wenn |
|---|
| *Implemented code is not in extensions* | Die Basisanwendung verändert wird |
| *Implemented code is not cloud-optimized* | Der gesamte Code liegt in Erweiterungen, aber mindestens eine Erweiterung ist nicht cloudfähig |
Gemäß der Microsoft-FAQ gilt:
- **Ausnahme nach Datum.** On-Premises-Installationen von Business Central mit einem *First Registration Date* vor dem **3. Oktober 2022** im PartnerSource Business Center benötigen diese Module und Gebühren nicht. Kunden, die BC On-Premises am oder nach diesem Datum lizenzieren — einschließlich über einen Transition-Auftrag aus NAV/GP/SL — benötigen sie, sofern nicht-Universal-Code eingesetzt wird.
- **Gebührenbasis.** Die Module müssen *„at a quantity equal to the number of full users (Premium or Essentials) in the Business Central on-premises license"* lizenziert werden; die Gebühren sind proportional zur Anzahl der Full User. Bei perpetuellen Lizenzen erscheinen sie im Angebot zur Verlängerung des Enhancement Plans und werden zum Jahrestag des Enhancement Plans abgerechnet; bei Subscription-Lizenzen werden sie monatlich dem Partner of Record in Rechnung gestellt.
- **Technische Durchsetzung.** Die Durchsetzung ist nicht nur vertraglich. Microsoft führt aus: *„For Business Central on-premises customer licenses registered after October 3, 2022, you will be unable to start sessions running code that modifies the base application or is targeted for on-premises without licenses for the required modules."* Da alle DEXPRO Apps Universal Code sind, verursachen sie keine solche Sitzungsblockade.
Die aktuellen Modulpreise werden hier nicht wiedergegeben; bitte entnehmen Sie diese dem PartnerSource Business Center oder Ihrem Microsoft Regional Operations Center, da sich Gebührenmodelle ändern.
### Rollout-Hinweise
- **Business Central online (SaaS):** Alle Apps lassen sich ohne Universal-Code-Implikationen installieren.
- **On-Premises / Hybrid:** Alle Apps werden als cloud-optimierte Erweiterungen installiert und erfordern aus eigenem Anlass kein kostenpflichtiges Modul für nicht cloud-optimierten Code. Zu beachten ist, dass ausgehende HTTP-Aufrufe von Erweiterungen in der On-Premises-Serverkonfiguration freigegeben sein müssen (`Allow HttpClient Requests` an der Erweiterung). Dies ist eine übliche administrative Einstellung und kein Compliance-Thema.
- **Upgrade-Sicherheit:** DEXPRO verfolgt eine strikte Obsoletion-Richtlinie. Öffentliche Prozeduren, Tabellenfelder, Enum-Werte, Events und Interface-Methoden werden mit `ObsoleteState = Pending`, einer benannten Ersatzlösung und einem Versions-Tag gekennzeichnet; sie werden nie ohne Vorankündigung entfernt. Im Build-Log sichtbare Deprecation-Warnungen sind beabsichtigt und stellen keine Konformitätsmängel dar.
- **Mindestplattform:** Business Central 25.0 oder höher.
---
## 8. Pflege dieser Erklärung
Die Universal-Code-Konformität wird bei jedem Release der App-Familie erneut geprüft, indem jede App mit aktiviertem AppSourceCop-Analyzer gegen das Cloud-Target kompiliert wird. Die Empfehlung von Microsoft an Partner lautet, *„set the `"target": "Cloud"` in the app.json, and enable PerTenantExtensionCop and/or AppSourceCop"* — DEXPRO folgt dieser Praxis.
Diese Erklärung bezieht sich auf die in Abschnitt 3 genannten App-Versionen. Fordern Sie eine aktualisierte Erklärung an, wenn Sie neuere Versionen vertreiben.
Bei technischen Fragen wenden Sie sich an die DEXPRO Solutions GmbH unter [https://www.dexpro.de/](https://www.dexpro.de/).
---
## 9. Quellen
Die oben zitierten technischen Definitionen und lizenzrechtlichen Mechanismen stammen aus *Business Central Universal Code Initiative — Frequently asked questions* (Microsoft Partnerdokumentation, erreichbar über [https://aka.ms/BCUniversalCode](https://aka.ms/BCUniversalCode)). Die für diese Prüfung herangezogene Fassung ist vom 27. September 2022 und als Pre-Release gekennzeichnet; lizenzrechtliche Einzelheiten wie Preise sollten gegen aktuelle Microsoft-Lizenzunterlagen und das PartnerSource Business Center abgeglichen werden.
- - [Overview of the Business Central Universal Code initiative (Microsoft Partner)](https://partner.microsoft.com/resources/detail/overview-of-the-dynamics-365-business-central-universal-code-initiative-pdf) — `aka.ms/BCUniversalCode`
- [The Dynamics 365 Business Central Universal Code initiative is live (Microsoft)](https://www.microsoft.com/en-us/dynamics-365/blog/it-professional/2022/10/28/the-dynamics-365-business-central-universal-code-initiative-is-live/)
- [Compilation scope overview / Eigenschaft `target` (Microsoft Learn)](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-compilation-scope-overview) — der in der Microsoft-FAQ referenzierte Artikel zur erforderlichen Konfiguration
- [JSON files reference — app.json (Microsoft Learn)](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-json-files)
- [Technical validation checklist (Microsoft Learn)](https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-checklist-submission)