72242980 SOUDHL Packing Mgt
Verantwortung
Erzeugt aus Verkaufszeilen konsistente Package Header und Lines. Die Codeunit zentralisiert Gewicht, Maße, Boxauswahl und mehrere Verteilalgorithmen.
Öffentliche Procedures
Paketbildung
CreatePackages(var SalesHeader: Record "Sales Header"; FixedPackageCount: Integer; BoxCode: Code[20])– nutzt den Packing Mode der Konfiguration.CreatePackagesWithPackingMode(var SalesHeader: Record "Sales Header"; FixedPackageCount: Integer; BoxCode: Code[20]; PackingMode: Enum "SOUDHL Packing Mode")– expliziter Mode für Host-Apps.
Ist FixedPackageCount > 0, hat die feste Anzahl Vorrang vor dem Mode.
Gewicht
ResolveUnitWeightKg(Item: Record Item): DecimalResolveUnitWeightKg(Item: Record Item; UOMCode: Code[10]): Decimal
Reihenfolge: Item-UoM-Gewicht bei entsprechender Gewichtsquelle, sonst Gross oder Net Weight × Qty. per Unit of Measure. Gramm werden in Kilogramm konvertiert.
Maße
ResolveItemUnitDimensions(ItemNo: Code[20]; UOMCode: Code[10]; var LengthCm: Decimal; var WidthCm: Decimal; var HeightCm: Decimal)ResolvePackageDimensionsCm(PackageHeader: Record "SOUDHL Package Header"; var LengthCm: Decimal; var WidthCm: Decimal; var HeightCm: Decimal)
Item-UoM-Maße und Paket-/Boxmaße werden in Zentimeter normalisiert.
Limits und Hilfen
ResolveMaxPackageWeightKg(BoxCode: Code[20]): Decimal– Boxlimit, Setupdefault, danach 31,5 kg.MaxPackageWeightKg(): Decimal– Setupdefault ohne Box.UnitFitsInBox(UnitLengthCm: Decimal; UnitWidthCm: Decimal; UnitHeightCm: Decimal; BoxLengthCm: Decimal; BoxWidthCm: Decimal; BoxHeightCm: Decimal): Boolean– sortierter Achsenvergleich; fehlende Maße blockieren nicht.SuggestPackageCount(TotalWeightKg: Decimal; TotalVolumeCm3: Decimal; BoxCode: Code[20]): Integer– Maximum aus Gewichts- und Volumenbedarf.ComputeOrderTotals(SalesHeader: Record "Sales Header"; var TotalWeightKg: Decimal; var TotalVolumeCm3: Decimal)– Summen packbarer Verkaufszeilen.ClearExistingPackages(OrderNo: Code[20])– löscht nur nicht hochgeladene Sales-Order-Pakete und Lines.
Integration Events
Vollständige Subscriber-Signaturen stehen unter Integration Events.
OnBeforeCreatePackages läuft nach der Standardauflösung und vor Validierung oder Löschen. OnBeforePackageHeaderInsert erlaubt sichere Anreicherung vor dem Insert. OnAfterPackageCreated folgt nach vollständigen Lines. OnAfterCreatePackages schließt den Lauf ab.
Interner Ablauf
CreatePackagesInternal → OnBeforeCreatePackages → BuildPackingPlan → CreateDhlPackages → OnAfterCreatePackages.
Vor dem Löschen bestehender Pakete werden alle Einheiten auf Maximalgewicht und Box-Fit validiert. Dadurch zerstört ein ungültiger Vorschlag keine vorhandenen Pending-Pakete.
Algorithmen
BuildPlanBinPacking: schwerste Zeilen zuerst, First-Fit.BuildPlanAllOnFirst: Auftragsreihenfolge; separate Artikel schließen das Paket.BuildPlanSmartDistribute: separat zu packende Einheiten zuerst; Rest auf leichtestes passendes Paket.BuildPlanFixedCount: exakt N Pakete, Fehler bei Restmenge oder leeren Paketen.
Relevante Helper: CollectOrderLines, ValidateOrderUnits, ResolveBoxCode, FindFirstFitPackage, FindLightestFittingPackage, FindEmptyPackage, ChunkCapFor, PackingQuantity, CeilDiv und Listen-Mutatoren.
Boxauswahl
expliziter
BoxCode,Preferred Box der Item Category,
kleinste passende Kategoriebox,
kleinste passende aktive Box.
Datenwirkung
Die Codeunit löscht und erzeugt Package Header/Lines, aber committet nicht explizit. Headergewicht wird in Gramm gespeichert, Linegewicht in Kilogramm pro Einheit.
Fehlerfälle
Keine Box, keine packbare Position, Einzelstück zu schwer oder zu groß, feste Paketanzahl unzureichend. Qty. to Ship wird bevorzugt; andernfalls gilt Quantity. Ein Fehler in OnBeforeCreatePackages bricht ab, bevor Pending-Pakete gelöscht werden.
Externe Verwendung
Die öffentlichen Methoden sind die unterstützte Packing-Fassade. Consumer-Apps sollen nicht eigene Varianten der Algorithmen gegen dieselben Tabellen parallel pflegen.
