> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/entwicklerdokumentationen-business-central-dhl-connector/dhl-connector-entwicklerdokumentation/kompatibilitat-und-supportgrenzen.md). # Kompatibilität und Supportgrenzen ## Aktueller Vertragsstand * DHL Connector: `25.23.0.0` * App-ID: `9d801b56-1d24-42d4-a98b-5663f28bdb4f` * Publisher: `Solutioo` * Application: mindestens `24.0.0.0` * Runtime: mindestens `13.0` * Objektbereich des Connectors: `72242951` bis `72242991` Für neue Integrationen soll grundsätzlich die aktuelle freigegebene Connector-Version als Mindestversion eingetragen werden. ## Funktionsbezogene Mindeststände * `25.12.0.0`: DHL Express und UI-Override-Integration * `25.13.0.0`: Dokumenttyp, Warenausgangspakete und Empfänger-Snapshots * `25.17.0.0`: öffentlicher lokaler Rate Provider * `25.19.0.0`: öffentliche Packing-Codeunit mit Paketmodi und Berechnungshelfern * `25.20.0.0`: paketbezogene Abmessungen, aktualisierte Empfänger und Kartonbestandsbuchung * `25.21.0.0`: zentrale Dimensions- und Gewichtseinheiten der DHL-Konfiguration * `25.22.0.0`: automatische Zuordnung von Auftragspaketen zu gebuchten Verkaufslieferungen * `25.23.0.0`: additive Before-/After-Integration Events für Packing, Empfänger, Label und Rate Diese Liste dient zur Orientierung. Eine Consumer-App sollte nicht mehrere alte Feature-Floors kombinieren, sondern auf die aktuelle Version zielen. ## Was als stabil gilt Als unterstützt gelten nur: * die auf der Seite **Unterstützte AL-Schnittstellen** aufgeführten Methoden, * die dokumentierten Integration Events inklusive der additiven Events aus 25.23.0.0, * die beschriebenen Core-Tabellen und Enums für die angegebenen Zwecke, * additive Felder oder Enum-Werte, sofern sie die bestehende Signatur nicht brechen. Bestehende Events aus 25.12 behalten Signatur und Timing. Neue Events sind additiv: ohne Subscriber ändert sich das Laufzeitverhalten nicht. Solutioo prüft veröffentlichte Versionen gegen die AppSource-Kompatibilitätsbaseline. Dennoch sollte jede Consumer-App vor einem Connector-Update neu kompiliert und in einer Sandbox getestet werden. ## Was nicht als stabil gilt Nicht vom Integrationsvertrag umfasst sind: * Methoden, die nur aufgrund des derzeitigen Standardzugriffs öffentlich erscheinen, * Secret-, Token-, Authentifizierungs- und Low-Level-HTTP-Methoden, * konkrete interne URLs, Header oder Request-Builder, * Installations-, Upgrade- und Migrationscodeunits, * Seiten-Control-Namen und Layoutdetails, * direkte Inserts, Deletes oder unkoordinierte Modifies auf Connector-Tabellen, * interne Tarif-, Billing- und Posting-Hilfslogik außerhalb der dokumentierten Facades. ## Bekannte Einschränkungen in 25.23.0.0 * `OnBeforeSendShipmentRequest` wird nur für Express ausgelöst. * `OnBeforeSendParcelDEShipmentRequest` ist der symmetrische Parcel-DE-Hook. * Beide Request-Hooks übergeben das Frontend-`JsonObject` und koppeln Subscriber an dokumentierte Carrier-Felder. * Die Download-Methoden benötigen eine interaktive Business-Central-Sitzung. * `GenerateLabel` setzt nach erfolgreicher DHL-Antwort eine Transaktionsgrenze. `OnAfterGenerateLabel` mit `Success = true` läuft nach diesem `Commit()`. * Direkte Zugriffe auf Package Header und Package Line erfordern genaue Kenntnis des Einheiten- und Snapshot-Vertrags. * Es gibt kein `IsHandled`. Subscriber können den Standardablauf nicht ersetzen, nur anreichern oder abbrechen. ## Quellcode und Symbole Externe Entwickler erhalten das kompilierte App-Paket beziehungsweise Symbole des installierten Connectors. Die Symbolbereitstellung enthält keine AL-Quelldateien. Der Entwickler kann damit öffentliche Objekte referenzieren und kompilieren. Ein möglicher Debug-Zugriff ist keine zugesagte Integrationsfunktion und darf nicht zur Ermittlung oder Nutzung undokumentierter Implementierungsdetails verwendet werden. ## Vorgehen bei fehlenden Hooks Eine Anfrage für einen neuen Erweiterungspunkt sollte enthalten: 1. den fachlichen Anwendungsfall, 2. den betroffenen Prozess und Zeitpunkt, 3. benötigte Eingaben und veränderbare Ergebnisse, 4. gewünschtes Verhalten bei Fehlern, 5. Parcel DE, Express oder beide Services, 6. Anforderungen an Background Sessions und UI-Freiheit. Bevorzugt werden fachliche Events mit stabilen Parametern statt Events, die komplette Transport-JSONs offenlegen. ## Update-Checkliste für Consumer-Apps Vor Freigabe mit einer neuen DHL-Version: * Symbole neu laden, * Consumer-App ohne Warnungsunterdrückung kompilieren, * Paketerzeugung für alle verwendeten Packing-Modi testen, * Parcel-DE- und/oder Express-Label in der Sandbox erzeugen, * Event Subscriber ausführen und das Ergebnis prüfen, * Berechtigungen mit einem Nicht-SUPER-Benutzer testen, * Hintergrund- und Posting-Prozesse separat prüfen, * Entwickler-Changelog auf geänderte Signaturen und Verhaltenshinweise prüfen. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.solutioo.de/entwicklerdokumentationen-business-central-dhl-connector/dhl-connector-entwicklerdokumentation/kompatibilitat-und-supportgrenzen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.