Unterstützte AL-Schnittstellen

Nur die auf dieser Seite aufgeführten Methoden gelten für Version 25.23.0.0 als dokumentierter Integrationsvertrag. Weitere öffentliche Symbole können Implementierungsdetails sein und sich ohne Integrationszusage ändern.

Die additiven Integration Events aus 25.23.0.0 gehören zum unterstützten Vertrag. Ihre Signaturen und das Timing stehen auf der Seite Integration Events.

Codeunit 72242952 SOUDHL API Management

Service erkennen

procedure IsExpress(): Boolean

Liefert true, wenn die DHL-Konfiguration den Service Express verwendet. Bei fehlender Konfiguration wird false geliefert.

Label erzeugen

procedure GenerateLabel(
    SOUDHLPackageHeaderRecord: Record "SOUDHL Package Header";
    var ExtraMessage: Text): Boolean

Die Methode wählt automatisch Parcel DE oder Express, aktualisiert Empfängerdaten, validiert das Paket, ruft DHL auf und speichert Label sowie Sendungsnummer.

Wichtige Laufzeiteigenschaften:

• true bedeutet, dass DHL das Label erfolgreich erstellt hat.
• Bei false enthält ExtraMessage nach Möglichkeit die Fehlerbeschreibung.
• Auch bei true kann ExtraMessage eine nachgelagerte Warnung enthalten, etwa zur optionalen Kartonbestandsbuchung.
• Nach einem erfolgreichen Aufruf sollte der Consumer den Paketdatensatz erneut lesen.
• Die Methode führt nach erfolgreicher externer Labelerzeugung einen Commit() aus. Aufrufer dürfen daher keine atomare Transaktion über den Labelaufruf hinweg voraussetzen.
• Vor Zoll- und Request-Verarbeitung wird OnBeforeGenerateLabel ausgelöst. Am Ende jedes Pfads folgt OnAfterGenerateLabel.

Express-Preis abrufen

procedure GetRate(
    ReceiverCountry: Code[10];
    ReceiverPostalCode: Text;
    ReceiverCity: Text;
    WeightKg: Decimal;
    LengthCm: Decimal;
    WidthCm: Decimal;
    HeightCm: Decimal;
    ProductCode: Code[5];
    var Price: Decimal;
    var Currency: Text;
    var ExtraMessage: Text): Boolean

Diese Methode verwendet den MyDHL-Endpoint /rates und ist nur bei DHL Express verfügbar. Abmessungen werden in Zentimetern und Gewicht in Kilogramm übergeben. Ein leerer Product Code verwendet den Standardcode des Connectors.

OnBeforeGetRate kann die fachlichen Eingaben ändern. OnAfterGetRate läuft auf jedem Rückgabepfad. Die öffentliche Signatur von GetRate bleibt unverändert.

Dokumente herunterladen

procedure DownloadLabel(
    SOUDHLPackageHeaderRecord: Record "SOUDHL Package Header")

procedure DownloadCustomsDoc(
    SOUDHLPackageHeaderRecord: Record "SOUDHL Package Header")

Diese Methoden starten einen Client-Download und sind nur für interaktive Sitzungen geeignet. Für Hintergrundprozesse sollte ein eigener, mit Solutioo abgestimmter Stream- oder Export-Hook verwendet werden.

Codeunit 72242980 SOUDHL Packing Mgt

Pakete erzeugen

procedure CreatePackages(
    var SalesHeader: Record "Sales Header";
    FixedPackageCount: Integer;
    BoxCode: Code[20])

procedure CreatePackagesWithPackingMode(
    var SalesHeader: Record "Sales Header";
    FixedPackageCount: Integer;
    BoxCode: Code[20];
    PackingMode: Enum "SOUDHL Packing Mode")

• FixedPackageCount = 0 aktiviert die automatische Ermittlung.
• Ein Wert größer 0 fordert genau diese Anzahl an, sofern Gewichts-, Dimensions- und Mengenlimits eingehalten werden können.
• Bereits hochgeladene Pakete bleiben erhalten.
• Nicht hochgeladene Auftragspakete werden bei einer neuen Ermittlung neu aufgebaut.
• Ungültige oder nicht passende Einheiten führen zu einem AL-Fehler, bevor neue Pakete angelegt werden.
• OnBeforeCreatePackages läuft nach der Standardauflösung von Box und Mode. Pro Paket folgen OnBeforePackageHeaderInsert und OnAfterPackageCreated, danach OnAfterCreatePackages.

Unterstützte Berechnungshelfer

procedure ResolveUnitWeightKg(Item: Record Item): Decimal
procedure ResolveUnitWeightKg(Item: Record Item; UOMCode: Code[10]): Decimal

procedure ResolveItemUnitDimensions(
    ItemNo: Code[20]; UOMCode: Code[10];
    var LengthCm: Decimal; var WidthCm: Decimal; var HeightCm: Decimal)

procedure ResolvePackageDimensionsCm(
    PackageHeader: Record "SOUDHL Package Header";
    var LengthCm: Decimal; var WidthCm: Decimal; var HeightCm: Decimal)

procedure ResolveMaxPackageWeightKg(BoxCode: Code[20]): Decimal
procedure MaxPackageWeightKg(): Decimal

procedure UnitFitsInBox(
    ItemLengthCm: Decimal; ItemWidthCm: Decimal; ItemHeightCm: Decimal;
    BoxLengthCm: Decimal; BoxWidthCm: Decimal; BoxHeightCm: Decimal): Boolean

procedure SuggestPackageCount(
    TotalWeightKg: Decimal; TotalVolumeCm3: Decimal;
    BoxCode: Code[20]): Integer

procedure ComputeOrderTotals(
    SalesHeader: Record "Sales Header";
    var TotalWeightKg: Decimal; var TotalVolume: Decimal)

procedure ClearExistingPackages(OrderNo: Code[20])

ClearExistingPackages löscht nur nicht hochgeladene Pakete des Dokumenttyps Verkaufsauftrag. Vor dem Aufruf muss geprüft werden, dass dieses Verhalten fachlich gewünscht ist.

Codeunit 72242972 SOUDHL Rate Provider

Der Rate Provider berechnet Preise aus den im Connector importierten Tariftabellen. Er führt keinen Live-DHL-Aufruf aus.

procedure CalculateRate(
    ProductCode: Code[20]; ServiceCode: Code[20];
    BillingAccountCode: Code[20]; ShipmentDate: Date;
    OriginCountry: Code[10]; OriginPostCode: Code[20];
    DestinationCountry: Code[10]; DestinationPostCode: Code[20];
    ActualWeight: Decimal; Length: Decimal; Width: Decimal; Height: Decimal;
    PackageCount: Integer;
    var ResultBuffer: Record "SOUDHL Rate Result Buffer" temporary;
    var ErrorCode: Code[30]; var ErrorText: Text): Boolean

Bei Erfolg enthält der temporäre Result Buffer Basispreis, Zuschläge und Zusammenfassung. Bei Fehlern werden ErrorCode und ErrorText gesetzt.

Codeunit 72242962 SOUDHL Express Helper

procedure MapProductCode(
    Product: Enum "SOUDHL Express Product"): Code[5]

procedure IsDocumentProduct(
    Product: Enum "SOUDHL Express Product"): Boolean

Diese Methoden dürfen für die Auswahl eines Express-Produktcodes verwendet werden.

Ergänzende High-Level-Objekte

Folgende Objekte sind öffentlich erreichbar, sollten aber nur nach Abstimmung verwendet werden:

• SOUDHL Package Recipient Mgt für Empfänger-Snapshots und Quellaufträge
• SOUDHL Customs Mgt für Zollprüfung und Zolldaten
• SOUDHL Sales Shipment Mgt für die Zuordnung offener Auftragspakete zu gebuchten Verkaufslieferungen
• SOUDHL Box Inventory Mgt für die optionale Kartonbestandsbuchung

Ihre Verwendung koppelt die Consumer-App stärker an das interne Datenmodell. Die Recipient-Events OnAfterSnapshotFromSalesHeader und OnAfterUpdateTrackingOnSourceOrder sind der bevorzugte Erweiterungspunkt vor direkten Tabellenwrites.

Nicht unterstützte Aufrufe

Nicht als Integrationsvertrag unterstützt werden insbesondere:

• GenerateToken
• CallPostAPI
• GetErrorDetail
• BaseUrl
• ConvertPdfLabelToJpgAndStore
• die komplette Codeunit SOUDHL Secret Mgt
• Installations-, Upgrade-, Import- und interne Posting-Codeunits
• direkte Verwendung interner HTTP-, Token-, JSON- oder Credential-Logik

Diese Symbole dürfen auch dann nicht verwendet werden, wenn der aktuelle Compiler sie auflösen kann.