PurchaseRequest (Bestelaanvraag)

De PurchaseRequest-entiteit beheert bestelaanvragen in Ultimo. Een bestelaanvraag is het voorstadium van een bestelling en doorloopt een fiattering/goedkeuringsproces voordat er daadwerkelijk wordt besteld. Bestelaanvragen kunnen handmatig worden aangemaakt of automatisch vanuit jobs.

Entiteitsnaam: PurchaseRequest Databasetabel: PurchaseRequest Primaire sleutel: PCHRID (nvarchar 11)

Contextsbewerken

Statussenbewerken

Belangrijkste propertiesbewerken

Functionaliteit & property-gedragbewerken

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).

Relaties met andere entiteitenbewerken

Tips voor consultantsbewerken

• Statusflow: Aangemaakt (1) -> Aanvraag (2) -> Goedgekeurd (8) -> Bestelling aangemaakt (16) -> Actief (64) -> Deels geleverd (256) -> Geleverd (512) -> Gesloten (128).
• Fiattering: De fiattering werkt op basis van het ApprovalLevel van de medewerker en bedragen op de aanvraagregels.
• Offertetraject: Context Tender (2) wordt gebruikt voor offerteaanvragen waarbij leveranciers offertes kunnen uitbrengen.
• Vanuit job: Als CreatedFromJob = true, is de aanvraag automatisch aangemaakt vanuit een werkorder.
• Regels: De daadwerkelijke artikelen en bedragen staan op de PurchaseRequestLine-entiteit.

Database Detailsbewerken

De tabel dba.PurchaseRequest bevat 49 kolommen. PurchaseRequest heeft geen computed columns.

Kolommen gezet door triggersbewerken

Belangrijke defaultsbewerken

Triggers en externe triggersbewerken

PurchaseRequest heeft geen eigen triggers en wordt beinvloed door 2 externe triggers:

• PurchaseRequestLine-triggers: Bij INSERT/UPDATE/DELETE van aanvraagregels worden PchrStdTotalPrice, PchrStdVatPrice en PchrStdTotPriceInclVat herberekend

Consultanttip: Alle prijsberekeningen op de PurchaseRequest worden gestuurd vanuit de PurchaseRequestLine-tabel. De PurchaseRequest zelf heeft geen eigen triggers, wat het een relatief eenvoudige entiteit maakt qua database-gedrag. Het fiattering/goedkeuringsproces wordt afgehandeld via workflows, niet via triggers.

Brondatabewerken

Let op: De wiki-samenvatting hierboven toont een curated subset van properties en praktische consultant-tips. Voor ground truth (exacte kolomnamen, alle properties, defaults, triggers) gebruik de onderstaande tools.

• Entity-definitie — lookup_entity("PurchaseRequest") · reference/entities/PurchaseRequest Alle properties, contexts en statussen. Bron: Entities.xml.
• DB-schema — lookup_table_schema("PurchaseRequest") · reference/tables/PurchaseRequest Alle DB-kolommen, triggers, computed columns en defaults. Bron: database-schema.json.
• Gerelateerde workflows — find_workflows("", entity="PurchaseRequest") Alle Before/After Save events en andere workflow-ActionFields voor PurchaseRequest. Bron: workflows.xml.
• Property-gebruik — lookup_property_usage("PurchaseRequest", "Status") · reference/properties/PurchaseRequest Welke workflows een specifieke PurchaseRequest-property (of die van reference/properties/PurchaseRequestLine) lezen/schrijven/filteren. Bron: workflows.xml.
• Workflow-XML van een vuller — lookup_workflow("PurchaseRequest_Concept") De volledige initialisatielogica: hoe Site, CostCenter, Department, RequestEmployee en statusovergangen worden gevuld bij het aanmaken van een bestelaanvraag. Bron: workflows.xml.

Zie ookbewerken

• purchase - Bestellingen (volgende stap na goedkeuring)
• job - Werkorders die bestelaanvragen genereren
• supplier - Leveranciers
• article - Artikelen op aanvraagregels