Systemarchitektur

Ziel der App

Der DHL Connector bildet DHL-Versandprozesse innerhalb von Business Central ab. Er trennt fachliche Versanddaten, Paketbildung, API-Kommunikation, Druck, Tarife und Buchungsnachverfolgung in eigenständige AL-Objekte.

Schichten

Benutzeroberfläche

Pages und Page Extensions stellen Einrichtung, Boxen, Pakete, Zoll, Tarife und Labelaktionen bereit. Die UI ruft keine DHL-Endpunkte direkt auf, sondern delegiert an Management-Codeunits.

Fachliche Orchestrierung

• 72242980 SOUDHL Packing Mgt: Paketbildung und Einheiten
• 72242965 SOUDHL Package Recipient Mgt: Empfänger-Snapshots
• 72242967 SOUDHL Customs Mgt: Zollpflicht und CN23-Daten
• 72242984 SOUDHL Box Inventory Mgt: Kartonverbrauch
• 72242986 SOUDHL Sales Shipment Mgt: Zuordnung zu gebuchten Lieferungen

Transport und DHL-APIs

72242952 SOUDHL API Management ist der einzige zentrale Transport-Orchestrator. Er dispatcht abhängig von SOUDHL Configuration."API Service" an Parcel DE oder Express. Authentifizierung, Request-Aufbau, Response-Parsing und Persistenz bleiben in dieser Schicht.

Persistenz

• SOUDHL Configuration, Box, Billing Number und Billing Map: Setup und Stammdaten
• SOUDHL Package Header und Package Line: Paket und Inhalt
• SOUDHL Customs Data und Customs Line: Zollerklärung
• Tarif-Tabellen: versionierte lokale Preisberechnung

Druck und Ausgabe

• Report 72242951 SOUDHL Generate Label: Processing-Report zur automatischen Paketerzeugung und Labelanforderung
• Report 72242960 SOUDHL Labels Report: RDLC-Ausgabe gespeicherter Labelbilder

Abhängigkeitsrichtung

Öffentlicher Vertrag

Eine externe App soll nur die dokumentierten High-Level-Codeunits, Integration Events und Datenobjekte verwenden. Dass weitere Objekte wegen des AL-Standardzugriffs technisch sichtbar sind, macht sie nicht automatisch zu einem stabilen Vertrag.

Firmen- und Mandantenkontext

Setup, Secrets und Versanddaten werden je Company verarbeitet. Die meisten Codeunits verwenden FindFirst() auf der Konfiguration und erwarten fachlich genau einen Setup-Datensatz je Company.

Verantwortungsgrenzen

• Der Connector verwaltet DHL-Authentifizierung und Request-Struktur.
• Die Consumer-App liefert fachliche Auswahl, etwa Carrier, Box, Produkt oder Sichtbarkeit.
• Credentials gehören nie in die Consumer-App.
• Direkte Tabellenwrites dürfen Invarianten nicht umgehen; bevorzugt werden Management-Codeunits und Events.