Bewerken: PurchaseRequest (Bestelaanvraag)

Sectie: Functionaliteit & property-gedrag

Reden:

## Functionaliteit & property-gedrag

Veel PurchaseRequest- en PurchaseRequestLine-properties worden niet handmatig gevuld maar door workflows berekend of overgenomen. Onderstaande paragrafen beschrijven het gedrag van de belangrijkste velden; gebruik `lookup_property_usage("PurchaseRequest", "<property>")` voor de volledige, actuele lijst workflows per property en `lookup_workflow("<naam>")` voor de XML.

- **Statusverloop & initialisatie (`Status`)** — De levenscyclus van een bestelaanvraag wordt volledig door workflows beheerd. `PurchaseRequest_Concept` zet de aanvraag op de Concept-status en vult tegelijk `Site`, `CostCenter`, `Department`, `RequestEmployee`, `Account`, `Charge` en `CostType` vanuit de aanvrager of de gekoppelde job. `PurchaseRequest_ApproveAndActivate` schakelt door naar Goedgekeurd (8), en `PurchaseRequest_Deliver` markeert de aanvraag als Geleverd (512). `PurchaseRequest_PostClose` leest `StatusDeliveredEmployee` om de afrondende medewerker vast te leggen. Consultanttip: negen workflows schrijven `Status`; filter erop met de statusmatrix in [[reference/properties/PurchaseRequest]] voordat je een aangepaste statusovergang bouwt.

- **Goedkeuring & drempelwaarden (`StandardTotalPrice`, `CostCenter`, `Department`)** — De fiatteerketen start met `PurchaseRequest_GenerateApprovals`, die `StandardTotalPrice`, `CostCenter` en `Department` leest om het juiste goedkeuringsniveau te bepalen. `PurchaseRequest_PreRequested` valideert diezelfde velden en blokkeert de overgang als kostenzuil of bedrag ontbreekt. `PurchaseRequest_PreApprove` voert een laatste controle uit op `CostCenter`, `Department`, `Account` en `Charge`. Bedragen worden niet op de PurchaseRequest zelf gezet, maar worden via triggers opgehaald uit de totalen van de onderliggende PurchaseRequestLines (`PchrStdTotalPrice`).

- **Omzetten naar bestelling via besteladvies (`PurchaseAdvice`)** — De route van bestelaanvraag naar bestelling loopt in veel gevallen via een besteladvies. `PurchaseAdvice_CreatePurchaseLine` leest op de PurchaseRequestLine de velden `Article`, `PurchaseQuantity`, `Site`, `Vendor`, `CostCenter`, `Department`, `Warehouse`, `GrossPrice`, `Currency` en `LeadTime` om de corresponderende bestelregel samen te stellen. `PurchaseAdvice_CreatePurchaseWithPurchaseLine` combineert header- en regelaanmaak in één stap.

- **Artikeldata op aanvraagregels (`Article`, `GrossPrice`, `Currency`, `LeadTime`, `Vendor`)** — Zodra een artikel op een PurchaseRequestLine wordt gekozen, vult `PurchaseRequestLine_CopyArticleData` alle handelsgegevens in: eenheidsprijs (`GrossPrice`), valuta (`Currency`), levertijd (`LeadTime`) en de preferente leverancier. `PurchaseRequestLine_GetPreferredVendor` bepaalt de leverancier op basis van artikel + vestiging. `PurchaseRequestLine_CopyStandByContractData` overschrijft prijs en leverancier wanneer er een standby-contract actief is. Bij een prijsmutatie update `PriceMutationLine_UpdatePurchaseRequestLine` rechtstreeks `GrossPrice` op openstaande aanvraagregels.

- **Bezorgdatum & levertijd (`RequestedDeliveryDate`, `LeadTime`, `CalculateDeliveryDateMethod`)** — `PurchaseRequestLine_CalculateRequestedDeliveryDate` berekent `RequestedDeliveryDate` op basis van de methode in `CalculateDeliveryDateMethod` (bijv. levertijd van leverancier, of vaste datum), gecombineerd met `LeadTime` en `Vendor`. `Job_ValidatePurchaseRequestDeliveryDates` controleert achteraf of de berekende datum nog aansluit bij de jobplanning. Consultanttip: de berekeningswijze wordt gezet door `PurchaseRequestLine_SetValuesDependingOnJob` en `Job_CreatePurchaseRequestLine`; wijzig die workflows als de berekeningslogica niet voldoet.

- **Reservering & magazijn (`ReservedQuantity`, `Warehouse`)** — Bij de pre-Reserved-transitie zet `PurchaseRequestLine_PreReserved` `Warehouse` en `ReservedQuantity`. `PurchaseRequestLine_UpdateArticleQuantity` actualiseert daarna de beschikbare artikelvoorraad in het magazijn. Bij annulering van de reservering reset `PurchaseRequestLine_PreReservedToApproved` de gereserveerde hoeveelheid. Webshop-aanvragen synchroniseren voorraad via `ArticleWarehouse_UpdateWebShopWarehouse`.

- **Offertetraject (`Tender`, context 2)** — Aanvraagregels kunnen worden doorgezet naar een offerte-traject. De `Tender`-property (verwijst naar een tweede PurchaseRequest met context Tender) wordt gezet door `ActionField590`, `ActionField591`, `ActionField603` en `ActionField608`. De workflows `PurchaseRequestLine_PreConceptToTender`, `PurchaseRequestLine_PreApprovedToTender`, `PurchaseRequestLine_PreNoneToTender` en `PurchaseRequestLine_PrePurchaseAdviceToTender` sturen de statustransitie van de regel naar het offertetraject. `RequestForQuotation_PreSent` leest `FinalReplyDate` van de bestelaanvraag om de uiterste reactiedatum op de offerte-aanvraag door te zetten. `JobSelected` (Boolean op PurchaseRequestLine) wordt gezet zodra een aanvraagregel is gekoppeld aan een bestelling; negen overgangsworkflows schrijven dit veld als `true` om dubbelbestelling te voorkomen.

> Het volledige overzicht van álle PurchaseRequest-properties met hun schrijvende/lezende/filterende workflows staat in [[reference/properties/PurchaseRequest]] (en [[reference/properties/PurchaseRequestLine]]).

---