Bewerken: Article (Artikel)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel Article-properties worden niet alleen handmatig ingesteld, maar door workflows bewaakt, berekend of opnieuw gezet bij configuratiewijzigingen. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik `lookup_property_usage("Article", "<property>")` voor de volledige, actuele lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **`InventoryMethod` en `UseOwnInventoryMethod`** — De voorraadmethode bepaalt hoe Ultimo inkoopadvies en batchbeheer afhandelt voor een artikel. `Article_SetInventoryMethod` is de centrale orchestrator: zodra de methode wijzigt, toont hij een dialoogvenster (`Dialog_Article_SetInventoryMethod`) waarmee de gebruiker kiest of het artikel de methode van zijn artikelgroep overneemt (`UseOwnInventoryMethod = false`) of een eigen methode krijgt. De vlag `DeviateFromInventoryMethod` registreert of het artikel afwijkt van de groepsinstelling. Aan de groepskant bewaakt `ArticleGroup_UpdateInventoryMethodWhenAllArticlesHaveSameInventoryMethod` of alle artikelen in een groep dezelfde methode hebben; zo ja, dan wordt de groepsinstelling automatisch bijgewerkt. Consultanttip: wijzig de inventarismethode nooit direct in de database — de workflow verzorgt ook de validatie op `MinimumNumberOfDaysBetweenDeliveryAndExpiryDate` voor artikelen met een vervaldatum.

- **`RegisterStock`** — Deze Boolean bestuurt of Ultimo fysieke voorraad bijhoudt voor het artikel. `Article_ToggleRegisterStock` verwerkt de schakelaar: als `RegisterStock` wordt uitgezet terwijl er nog geen `InventoryMethod` is, maakt de workflow automatisch WarehouseServeOut-boekingen aan om de resterende voorraad uit alle magazijnlocaties weg te boeken. Staat er wél een `InventoryMethod`, dan worden openstaande batches verwerkt. `RegisterStock` wordt door 41 workflows gelezen — onder andere bij het aanmaken van een magazijnlocatiekoppeling (`Article_AddWarehouseLocation`) en bij bestelprocesvalidaties — wat het tot een van de meest invloedrijke velden maakt.

- **`Purchase`, `PurchaseLevel` en `MaximumStock`** — Deze drie velden sturen het automatisch inkoopadvies aan. `Article_ResetArticlePurchase` zet alle drie op nul/false wanneer bij de systeeminstelling `ManageStockPerWarehouse` wordt omgeschakeld en een artikel geen magazijnkoppeling meer heeft. De bredere workflow `Article_ActionField1106_UpdateWarehouse` (systeeminstelling-toggle) itereert over alle artikelen en roept `Article_ResetArticlePurchase` aan voor artikelen zonder `ArticleWarehouse`. Consultanttip: als na een instellingswijziging bestelniveaus verdwenen zijn, controleer dan of deze workflow correct is uitgevoerd.

- **`PurchasePrice`, `Raise`, `ChargeRaiseInternal` en `ChargeRaiseExternal`** — Prijzen en opslagpercentages bepalen de kostprijsberekening bij materiaalgebruik op een werkorder (via `JobMaterial_UpdateMaterialCost`) en bij magazijn-uitgifte (`WarehouseServeOutline_PreApprove`). `ActionField1775` (toggle `UltimoSettings.PurchasePricePerSite`) kopieert bij activering de artikel-niveau-prijzen naar alle `ArticleSite`-records en leegt daarna de waarden op artikel-niveau. Vanaf dat moment zijn `PurchasePrice`, `Raise`, `ChargeRaiseInternal` en `ChargeRaiseExternal` georganiseerd per vestiging in plaats van per artikel. Bij import via `REST_Article_Import` of `Article_ImportMicrosoftDynamics` worden deze velden direct gevuld.

- **`VendorPerSite` en voorkeursleverancier** — `Article_GetPreferredVendor` is de lookup-workflow die bij inkoopregelverwerking (`PurchaseLine_ValidateAndCopyArticleData_ArticleVendor`) de juiste leverancier ophaalt. De logica is: als `UltimoSettings.StockLevelPerSite` én `Article.VendorPerSite` allebei `true` zijn, wordt de voorkeursleverancier opgezocht in `ArticleSiteVendor` (per vestiging); anders in `ArticleVendor` (artikel-breed). De keuze voor vestigingsspecifieke leveranciers (`VendorPerSite = true`) wordt gezet via `ActionField660`. Consultanttip: zet `VendorPerSite` alleen aan als de klant daadwerkelijk per vestiging inkoopt bij andere leveranciers; de extra configuratielast is aanzienlijk.

- **`ReplacedByArticle`** — Wordt gezet door `ActionField1801` en `ActionField1807` wanneer een artikel wordt vervangen door een nieuwere versie. Workflows die een verouderd artikel tegenkomen (bijv. `ActionField1803`) lezen dit veld om automatisch naar het vervangartikel door te verwijzen. Zolang `ReplacedByArticle` gevuld is, blokkeert `ActionField1801` verdere vervangingsketens via een filtercheck.

- **`Stock` (voorraad)** — `Stock` wordt door de database-triggers bijgehouden op basis van transacties, maar drie workflows raken het direct: `Article_PostImport` en `Article_PreImport` gebruiken het voor beginstanden bij bulkimport, en `Article_ToggleRegisterStock` leegt het impliciet bij het uitschakelen van voorraadregistratie. De berekende kolom `ArtStckStatCode` (`B`/`F`/`E`/`V`) is direct afgeleid van `Stock`, `PurchaseLevel`, `ReservedQuantity` en lopende bestelhoeveelheden — zie de tabel in **Database Details** voor de formule.

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

---