# 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

<table class="code-line" data-line="67" dir="auto" id="bkmrk-app-gepr%C3%BCfte-version"><thead class="code-line" data-line="67" dir="auto"><tr class="code-line" data-line="67" dir="auto"><th>App</th><th>Geprüfte Version</th><th>App-ID</th></tr></thead><tbody class="code-line" data-line="69" dir="auto"><tr class="code-line" data-line="69" dir="auto"><td>DEXPRO Core</td><td>3.11.0.0</td><td>`9762f101-ae8a-4a0e-be42-66ec871d1ca0`</td></tr><tr class="code-line" data-line="70" dir="auto"><td>DEXPRO SQUEEZE</td><td>2.49.0.0</td><td>`368db399-65f5-4250-9afd-b2a67a49e809`</td></tr><tr class="code-line" data-line="71" dir="auto"><td>DEXPRO Breeze Interface</td><td>1.30.0.0</td><td>`7c431886-108e-44c3-9328-30e2b93edfa6`</td></tr><tr class="code-line" data-line="72" dir="auto"><td>DEXPRO Advanced Workflow</td><td>1.12.0.0</td><td>`11a79c49-1645-4cf9-9b27-3d2eaafcf9f4`</td></tr><tr class="code-line" data-line="73" dir="auto"><td>DEXPRO Freeze</td><td>1.29.0.0</td><td>`b9c8c9cc-8cd1-41cc-bf86-7da37ac74c71`</td></tr><tr class="code-line" data-line="74" dir="auto"><td>DEXPRO eInvoice Sender</td><td>2.0.1.0</td><td>`37f06ebc-53f0-4d9c-9572-7229113363f9`</td></tr></tbody></table>

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

<table class="code-line" data-line="111" dir="auto" id="bkmrk-app-target-cloud-kom"><thead class="code-line" data-line="111" dir="auto"><tr class="code-line" data-line="111" dir="auto"><th>App</th><th>`target`</th><th>Cloud-Kompilierung</th><th>`Target` im Artefakt</th><th>Blockierende Feststellungen</th></tr></thead><tbody class="code-line" data-line="113" dir="auto"><tr class="code-line" data-line="113" dir="auto"><td>DEXPRO Core</td><td>Cloud</td><td>**0 Fehler**</td><td>`Cloud`</td><td>keine</td></tr><tr class="code-line" data-line="114" dir="auto"><td>DEXPRO SQUEEZE</td><td>Cloud</td><td>**0 Fehler**</td><td>`Cloud`</td><td>keine</td></tr><tr class="code-line" data-line="115" dir="auto"><td>DEXPRO Breeze Interface</td><td>Cloud</td><td>**0 Fehler**</td><td>`Cloud`</td><td>keine</td></tr><tr class="code-line" data-line="116" dir="auto"><td>DEXPRO Advanced Workflow</td><td>Cloud</td><td>**0 Fehler**</td><td>`Cloud`</td><td>keine</td></tr><tr class="code-line" data-line="117" dir="auto"><td>DEXPRO Freeze</td><td>Cloud</td><td>**0 Fehler**</td><td>`Cloud`</td><td>keine</td></tr><tr class="code-line" data-line="118" dir="auto"><td>DEXPRO eInvoice Sender</td><td>Cloud</td><td>**0 Fehler**</td><td>`Cloud`</td><td>keine</td></tr></tbody></table>

### 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**:

<table class="code-line" data-line="124" dir="auto" id="bkmrk-disqualifizierendes-"><thead class="code-line" data-line="124" dir="auto"><tr class="code-line" data-line="124" dir="auto"><th>Disqualifizierendes Konstrukt</th><th>Vorkommen</th></tr></thead><tbody class="code-line" data-line="126" dir="auto"><tr class="code-line" data-line="126" dir="auto"><td>`dotnet`-Blöcke / Assembly-Referenzen</td><td>0</td></tr><tr class="code-line" data-line="127" dir="auto"><td>`Codeunit … Subtype = DotNet`</td><td>0</td></tr><tr class="code-line" data-line="128" dir="auto"><td>`[Scope('OnPrem')]`-Attribute</td><td>0</td></tr><tr class="code-line" data-line="129" dir="auto"><td>Tabellen oder Methoden mit `Scope = OnPrem`</td><td>0</td></tr><tr class="code-line" data-line="130" dir="auto"><td>COM- / `Automation`-Variablen</td><td>0</td></tr><tr class="code-line" data-line="131" dir="auto"><td>`SHELL()` / Aufruf externer Prozesse</td><td>0</td></tr><tr class="code-line" data-line="132" dir="auto"><td>Direkter Dateisystemzugriff (Datentyp `File`)</td><td>0</td></tr><tr class="code-line" data-line="133" dir="auto"><td>`.dll`-Assemblies oder `.netpackages` im Repository</td><td>0</td></tr><tr class="code-line" data-line="134" dir="auto"><td>Änderungen an der Basisanwendung</td><td>0 (strukturell unmöglich — nur Erweiterungsobjekte)</td></tr><tr class="code-line" data-line="135" dir="auto"><td>Abhängigkeiten zu Drittanbieter-Apps</td><td>0</td></tr></tbody></table>

### 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 &amp; 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

<table class="code-line" data-line="156" dir="auto" id="bkmrk-merkmal-status-in-al"><thead class="code-line" data-line="156" dir="auto"><tr class="code-line" data-line="156" dir="auto"><th>Merkmal</th><th>Status in allen sechs Apps</th></tr></thead><tbody class="code-line" data-line="158" dir="auto"><tr class="code-line" data-line="158" dir="auto"><td>Runtime-Version</td><td>14.0</td></tr><tr class="code-line" data-line="159" dir="auto"><td>Application (Mindest-BC-Version)</td><td>25.0.0.0</td></tr><tr class="code-line" data-line="160" dir="auto"><td>`target`</td><td>Cloud</td></tr><tr class="code-line" data-line="161" dir="auto"><td>`resourceExposurePolicy`</td><td>`allowDebugging: false`, `allowDownloadingSource: false`</td></tr><tr class="code-line" data-line="162" dir="auto"><td>`propagateDependencies`</td><td>true</td></tr><tr class="code-line" data-line="163" dir="auto"><td>Features</td><td>`TranslationFile`, `NoImplicitWith`</td></tr><tr class="code-line" data-line="164" dir="auto"><td>Objekt-Präfix (AppSourceCop-Affix)</td><td>`DXP` (reserviert)</td></tr><tr class="code-line" data-line="165" dir="auto"><td>Unterstützte Sprachen</td><td>de-DE, en-US</td></tr><tr class="code-line" data-line="166" dir="auto"><td>Datenschutzerklärung / EULA / Hilfe-URLs</td><td>vorhanden</td></tr><tr class="code-line" data-line="167" dir="auto"><td>Telemetrie</td><td>Application Insights (partnerseitig konfigurierbar)</td></tr></tbody></table>

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:

<table class="code-line" data-line="206" dir="auto" id="bkmrk-modul-erforderlich%2C-"><thead class="code-line" data-line="206" dir="auto"><tr class="code-line" data-line="206" dir="auto"><th>Modul</th><th>Erforderlich, wenn</th></tr></thead><tbody class="code-line" data-line="208" dir="auto"><tr class="code-line" data-line="208" dir="auto"><td>*Implemented code is not in extensions*</td><td>Die Basisanwendung verändert wird</td></tr><tr class="code-line" data-line="209" dir="auto"><td>*Implemented code is not cloud-optimized*</td><td>Der gesamte Code liegt in Erweiterungen, aber mindestens eine Erweiterung ist nicht cloudfähig</td></tr></tbody></table>

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)