72242952 SOUDHL API Management
Verantwortung
Zentrale Transport- und Label-Codeunit für Parcel DE und MyDHL Express. Sie kapselt Authentifizierung, Request-Aufbau, HTTP, Response-Parsing, Persistenz, Labeldownload und PDF-Vorschau.
Wichtig: Technisch öffentliche Hilfsmethoden sind nicht automatisch unterstützte Partner-APIs. Externe Apps sollen die High-Level-Methoden und Events verwenden.
Unterstützte High-Level-API
IsExpress(): Boolean
Liest den ersten Konfigurationsdatensatz und liefert, ob Express aktiv ist. Keine Schreibwirkung.
GenerateLabel(PackageHeader: Record "SOUDHL Package Header"; var ExtraMessage: Text): Boolean
Hauptentry für beide Services. Prüft Service, erzeugt und speichert das Label, committet den Labelerfolg und stößt danach optional die Kartonbestandsbuchung an. ExtraMessage enthält fachliche Fehler oder Inventurwarnungen.
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
Live-Preisabfrage für Express. Keine Tabellenwrites. Für Parcel DE wird false geliefert.
DownloadLabel(PackageHeader: Record "SOUDHL Package Header")
Lädt das gespeicherte Label im Print Format herunter. Meldung statt Fehler, wenn kein Blob vorhanden ist.
DownloadCustomsDoc(PackageHeader: Record "SOUDHL Package Header")
Lädt das gespeicherte CN23-/Customs-Dokument herunter.
Integration Events
Vollständige Subscriber-Signaturen, Timing und Beispiele stehen unter Integration Events.
OnBeforeGenerateLabel läuft nach dem Empfänger-Snapshot in beiden Labelpfaden. OnAfterGenerateLabel deckt Erfolg und Fehler ab. OnBeforeSendShipmentRequest bleibt Express-only. OnBeforeSendParcelDEShipmentRequest ist der symmetrische Parcel-DE-Hook. GetRate behält seine öffentliche Signatur; Before und After werden intern um den Aufruf gelegt.
Technisch öffentlich, aber kein stabiler Partnervertrag
BaseUrl(): Text
Ermittelt Express-Live- oder Test-URL. Endpunktdetails bleiben Implementierung der App.
GenerateToken(var Token: Text): Boolean
Gemeinsamer Authentifizierungstest. Wird vom Setup verwendet. Consumer-Apps sollen weder Token beziehen noch speichern.
CallPostAPI(ApiUrl: Text; RequestJson: Text; var ResponseText: Text; var ExtraMessage: Text): Boolean
Low-Level-HTTP-POST. Umgeht fachliche Invarianten und kann sich mit DHL-Versionen ändern.
GetErrorDetail(APIResponseText: Text; var ErrorMessage: Text)
Dispatcht auf Parcel- oder Express-Fehlerparser.
TryGetByProduct(Product: Enum SOUDHLProducts; var Map: Record "SOU DHL Billing Map"): Boolean
Sucht die erste gültige Billing-Map-Zeile des Produkts.
ConvertPdfLabelToJpgAndStore(var PackageHeader: Record "SOUDHL Package Header"; var ExtraMessage: Text): Boolean
Sendet ein PDF an den konfigurierten Konvertierungsdienst und speichert die Media-Vorschau. Wird intern und vom Labels Report genutzt.
Lokale Parcel-DE-Methoden
GenerateTokenParcelDE: OAuth-ZugriffstokenCallPostAPIParcelDE: Bearer-POSTGenerateLabelParcelDE: Request, Call und PersistenzGetErrorDetailParcelDE:validationMessagesParcelClientId/ParcelClientSecret: Secret-AuflösungResolveParcelCountryCode: Alpha-3-LandResolveParcelBillingNumber: EKP + Produkt + Service
Lokale Express-Methoden
GenerateTokenExpress: Basic-Auth-MaterialCallPostAPIExpress: Headers und HTTPGenerateLabelExpress: Shipment-OrchestrierungParseShipmentResponse: Tracking und LabelBuildShipperObject,BuildReceiverObject,BuildPackageObject: Payload-TeileBuildExportDeclaration: Exportpositionen aus Package LinesAddAccount,AddNotification: ArraysWeightInKg,NetWeightKg,DimensionInCm: NormalisierungIncotermOrDefault,PlannedShippingDateTime,NewMessageReference: DefaultsParseRateResponse,BuildRateAddress,GetErrorDetailExpress: Rate und Fehler
Gemeinsame interne Methoden
ResolveAzureUrl und ResolveAzureKey lösen den PDF-Konvertierungsdienst auf. Konkrete Secret-Werte sind kein Dokumentationsbestandteil.
Abhängigkeiten
Configuration, Box, Package Header/Line, Billing Number/Map, Sales Header/Line, Country/Region; Secret Mgt, Recipient Mgt, Customs Mgt, Packing Mgt, Express Helper, Box Inventory Mgt und Installation.
Seiteneffekte
Empfänger-Snapshot
Tracking auf Quellaufträgen
Label-/Customs-Blobs und Media
Uploadstatus und Datum
expliziter Commit nach Labelerfolg
optionale Inventurbuchung in separater Transaktion
additive Integration Events ohne zusätzlichen
Commit()
Fehler und Grenzen
FindFirst()erwartet einen Setupdatensatz.Parcel kann bei fehlendem Land oder Billing hart abbrechen.
Express-Rate nimmt den ersten Produktpreis.
Das Express-Request-Event existiert nur für Express; Parcel DE nutzt
OnBeforeSendParcelDEShipmentRequest.Labeldaten enthalten personenbezogene Informationen und dürfen nicht unkontrolliert geloggt werden.
