Paketbildung und Paket-Lifecycle

Ausgangspunkt

Ein DHL-Paket gehört entweder zu einem Verkaufsauftrag oder zu einem Warenausgang. Der Dokumenttyp steht in SOUDHL Package Header."Document Type"; Order No enthält die jeweilige Dokumentnummer.

Paketbildung

SOUDHL Packing Mgt liest packbare Verkaufszeilen, normalisiert Gewicht und Abmessungen und erzeugt einen Plan. Danach werden ausschließlich nicht hochgeladene Auftragspakete ersetzt.

Erweiterungspunkte

Nach Auflösung von Box und Packing Mode, vor Validierung und Löschen:

1. OnBeforeCreatePackages – Box, Mode oder gewünschte Paketanzahl ändern.
2. je Paket OnBeforePackageHeaderInsert – Header vor dem Insert anreichern.
3. je Paket OnAfterPackageCreated – Follow-up nach vollständigen Lines.
4. OnAfterCreatePackages – Abschluss des Laufs.

Ohne Subscriber bleibt der Ablauf unverändert. Signaturen stehen unter Integration Events.

Packing-Modi

• Bin Packing: schwerste Positionen zuerst; First-Fit-Verteilung.
• All On First Package: Auftragsreihenfolge; erstes passendes Paket wird gefüllt.
• Smart Distribute: separate Artikel zuerst, übrige Mengen auf das jeweils leichteste passende Paket.
• Fixed Count: exakt die vorgegebene Anzahl; Fehler, wenn Limits damit nicht eingehalten werden können.

Zustände eines Pakets

Neu / Pending

• Uploaded = false
• Paket und Inhalt dürfen noch angepasst werden.
• Empfänger wird vor der Labelanforderung aus dem Quellbeleg aktualisiert.

Hochgeladen

• Uploaded = true
• DHL-Sendungsnummer und Label sind gespeichert.
• Empfänger-Snapshot bleibt historisch erhalten.
• Das Paket darf nicht durch eine neue Paketvorschlagsberechnung gelöscht werden.

Gebuchter Beleg

Je nach Prozess werden Posted Sales Shipment No. oder Posted Whse. Shipment No. gesetzt. Dadurch bleibt das Paket nach dem Buchen auffindbar.

Kartonverbrauch

Optional durchläuft das Paket Not Required, Pending, Posted oder Error. Dieser Status ist vom Labelstatus getrennt.

Einheitenvertrag

• Package Header Weight: Gesamtgewicht in Gramm als Integer
• Package Line Weight: Gewicht pro Einheit in Kilogramm
• generierte Line-Abmessungen: Zentimeter
• Box-Abmessungen: gemäß UOMOptions
• Zollgewicht: Netto-Kilogramm pro Einheit, unabhängig von der Packing-Gewichtsquelle

Empfänger-Snapshot

Vor dem Upload aktualisiert SOUDHL Package Recipient Mgt Name, Adresse, Land, E-Mail und Telefon. OnAfterSnapshotFromSalesHeader läuft vor dem Persistieren und erlaubt Packstation-, Kontakt- oder Adressnormalisierung. Bei Warenausgangspaketen müssen alle beteiligten Aufträge denselben normalisierten Empfänger besitzen.

Löschregeln

• ClearExistingPackages löscht nur nicht hochgeladene Verkaufsauftragspakete.
• Die Paketkarte verhindert das Löschen hochgeladener Pakete.
• Beim Löschen eines Headers werden Zolldaten entfernt; Package Lines müssen durch die aufrufende Logik ebenfalls bereinigt werden.

Empfehlung für externe Apps

Pakete über CreatePackages oder CreatePackagesWithPackingMode erzeugen. Direkte Inserts sind nur nach expliziter Abstimmung sinnvoll, weil AutoIncrement, Quellreferenzen, Gewichtseinheiten, Empfänger und Billing gemeinsam konsistent sein müssen.