Bewerken: WarehouseServeOut (Magazijnuitgifte)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel WarehouseServeOut-properties worden niet handmatig ingevuld maar door workflows aangemaakt en bijgewerkt. Het werkelijke gedrag zit voor een groot deel in de regel-entiteit `WarehouseServeOutline`, die ~60 workflows als writer heeft. Onderstaande paragrafen beschrijven het uitgifte-proces van aanvraag tot voorraadmutatie; gebruik `lookup_property_usage("WarehouseServeOut", "<property>")` of `lookup_property_usage("WarehouseServeOutline", "<property>")` voor de actuele werkflow-lijsten per property.

- **Aanmaak van de uitgifte** — Een WarehouseServeOut wordt op drie manieren aangemaakt: (1) via een werkorder-koppeling door `Job_CreateWarehouseServeOut` of `JobMaterial_CreateWarehouseServeOut`, waarbij `BookDate`, `Job`, `Warehouse` en de kostendragers direct worden overgenomen; (2) via een picklijst door `PickList_PreProcess_CreateWarehouseServeOut` of `PickList_PreProcess_CreateWarehouseServeOutFromJobMaterial`, die ook `Site` en `InvoiceCost` per regel vullen; (3) via de barcode-scanner door `BarcodeScanner_CreateWarehouseServeOut`, dat `Type`, `Project`, `ChargeRaisePercentage` en `RaisePercentage` op de regels zet. In alle gevallen is de `Status` na aanmaak `Created` (1).

- **Picklijst-koppeling en reserveringen** — Via `PickList` (kolom `WHSOPLTID`) wordt de uitgifte aan een picklijst gehangen. De picklijst-workflows bepalen bij aanmaak welk magazijn (`Warehouse`) en welke vestiging (`Site`) worden gehanteerd, en vullen per uitgifteregel de `WarehouseLocation` en `ToWarehouseLocation` in via `WarehouseServeOutline_SetDefaultWarehouseLocation` en `WarehouseServeOutline_SetWareHouseLocations`. Zolang de uitgifte nog niet is goedgekeurd, leest `WarehouseServeOut_PreApprove` de `BookDate` en de regelstatussen om te controleren of alle regels klaar zijn voor boeking.

- **Status en goedkeuringsflow** — De status van de uitgifte loopt van `Created` (1) naar `Approved` (2) bij een gewone uitgifte, of van `TransferCreated` (4) naar `TransferApproved` (8) bij een interne magazijnoverdracht. De statuswijziging wordt aangestuurd door twaalf schrijvende workflows, waaronder `Job_ApproveJobMaterials`, `PickList_PreProcess_CreateWarehouseServeOut` en `WarehouseServeOut_PostImport`. `WarehouseServeOut_PreApprove` leest `BookDate` en `Job` vóór de statusovergang ter validatie; `WarehouseServeOut_PreTransferApprove` doet hetzelfde voor transfers en schrijft tevens `BookDate` en `Type`. `ActionField1831` schrijft en filtert op `Status` voor bulkacties op meerdere uitgiften tegelijk.

- **Voorraadmutatie via uitgifteregels** — De werkelijke magazijnmutatie vindt volledig op regelniveau (`WarehouseServeOutline`) plaats. Bij goedkeuring wordt `WarehouseServeOutline_PreApprove` aangeroepen: dit workflow schrijft `WarehouseLocation`, `Price`, `ChargeRaisePercentage` en `RaisePercentage` op de regel en voert de inventarisatie-methodeprocedure uit via `WarehouseServeOutline_PreApprove_InventoryMethod`. De daadwerkelijke object-batchregistratie (seriële nummering of partijbeheer) verloopt via `WarehouseServeOutline_CreateObjectBatchForMutation`, dat `QuantityOut`, `QuantityIn` en `InvoiceQuantity` leest. Na goedkeuring worden de kolommen `WhsoCost` en `WhsoTotalPrice` op het uitgifte-hoofd bijgewerkt door de databasetriggers `TRSD_WHSSERVEOUTLINE` en `TRSM_WHSSERVEOUTLINE`.

- **Interne overdracht (Type = T)** — Bij een interne overdracht tussen magazijnen geldt een aparte statuslijn (`TransferCreated` / `TransferApproved`) en wordt ook `ToWarehouse` en `ToWarehouseLocation` per regel gevuld. `WarehouseServeOutline_TransferStock` leest `PickListLine` en voert de daadwerkelijke voorraadverschuiving uit; `WarehouseServeOutline_TransferStock_Validation` controleert vooraf of `WarehouseLocation` en `ToWarehouseLocation` beschikbaar zijn. `WarehouseServeOut_PostTransferApprove` leest daarna `PickList` op het hoofd om de picklijst bij te werken.

- **Kostendragers en doorbelasting** — `CostCenter`, `Department`, `CostType`, `SkillCategory` en `ProcessFunction` worden grotendeels gelezen door `WarehouseServeOut_CalculateCosts` (samen met `Equipment`, `Job`, `Project` en `Site`) om de interne kostentoewijzing te berekenen. `ProcessFunction` wordt als enige property op het hoofd ook geschreven: `ActionField243` zet dit veld op basis van het gekoppelde equipment. Bij intern doorbelasten (`Charge = true`) leest `ActionField1065` de `ChargeRaisePercentage` en `RaisePercentage` van elke regel, en registreert de koppeling naar `InternalChargeLine`. De vier `WarehouseServeOutline_PreInvoice*`-workflows beheren de facturatiestatus van doorbelaste regels.

- **Bulk- en scannerstromen** — `BarcodeScanner_CreateWarehouseServeOut_Transfer` zet de status direct op `TransferCreated` (4) en vult `QuantityIn` en `QuantityOut` op de regels. `StockCount_PostClosed` maakt uitgiften aan vanuit een afgesloten voorraadtelling en filtert op `Type` en `Status` om dubbele boekingen te voorkomen. `Article_ToggleRegisterStock` schrijft de `Status` van een uitgifte als onderdeel van de activering of deactivering van het artikelregistratiebeheer.

> Het volledige, gegenereerde overzicht van álle WarehouseServeOut- en WarehouseServeOutline-properties met hun schrijvende/lezende/filterende workflows staat in [[reference/properties/WarehouseServeOut]] respectievelijk [[reference/properties/WarehouseServeOutline]].

---