Page 54 "Purchase Order Subform"

Base Application · Microsoft.Purchases.Document · captioned “Lines” · BC23-30 · source at ea08af5e · facts from BC29

Properties

Property	Value
Caption	Lines
SourceTable	Purchase Line
PageType	ListPart

Fields on this page

Layout controls in source order, grouped by the container they sit in. Shows: the table field a control is bound to (or its expression as written); ToolTip: the control’s own, else the bound field’s (marked).

Group	Control	Shows	ToolTip
Control1	Type	Type	Specifies the line type. from the table field
	Type	`TypeAsText`	Specifies the type of transaction that will be posted with the document line. If you select Comment, then you can enter any text in the Description field, such as a message to a customer.
	No.	No.	Specifies what you are buying, such as a product or a fixed asset. You’ll see different lists of things to choose from depending on your choice in the Type field.
	Item Reference No.	Item Reference No.	Specifies the referenced item number. from the table field
	IC Partner Code	IC Partner Code	Specifies the code of the intercompany partner that the transaction is related to if the entry was created from an intercompany transaction. from the table field
	IC Partner Ref. Type	IC Partner Ref. Type	Specifies the item or account in your IC partner’s company that corresponds to the item or account on the line. from the table field
	IC Partner Reference	IC Partner Reference	Specifies the IC partner. If the line is being sent to one of your intercompany partners, this field is used together with the IC Partner Ref. Type field to indicate the item or account in your partner’s company that corresponds to the line. from the table field
	Variant Code	Variant Code	Specifies the variant of the item on the line. from the table field
	Nonstock	Nonstock	Specifies that this item is a catalog item. from the table field
	Gen. Bus. Posting Group	Gen. Bus. Posting Group	Specifies the vendor’s or customer’s trade type to link transactions made for this business partner with the appropriate general ledger account according to the general posting setup. from the table field
	Gen. Prod. Posting Group	Gen. Prod. Posting Group	Specifies the item’s product type to link transactions made for this item with the appropriate general ledger account according to the general posting setup. from the table field
	VAT Bus. Posting Group	VAT Bus. Posting Group	Specifies the vendor’s VAT specification to link transactions made for this vendor with the appropriate general ledger account according to the VAT posting setup. from the table field
	VAT Prod. Posting Group	VAT Prod. Posting Group	Specifies the VAT product posting group. Links business transactions made for the item, resource, or G/L account with the general ledger, to account for VAT amounts resulting from trade with that record. from the table field
	Description	Description	Describes what is being purchased. The suggested text comes from the item itself. You can change it to suit your needs for this document. If you change it here, the source of the text will not change. If the line’s Type field is set to Comment, you can use this field to write the comment, and leave …
	Description 2	Description 2	Specifies information in addition to the description. from the table field
	Receipt on Invoice	Receipt on Invoice	Specifies whether the receipt is posted automatically with the invoice. from the table field
	Drop Shipment	Drop Shipment	Specifies if your vendor ships the items directly to your customer. from the table field
	Return Reason Code	Return Reason Code	Specifies the code explaining why the item was returned. from the table field
	Location Code	Location Code	Specifies a code for the location where you want the items to be placed when they are received.
	Bin Code	Bin Code	Specifies the bin where the items are picked or put away. from the table field
	Quantity	Quantity	Specifies the quantity of what you’re buying. The number is based on the unit chosen in the Unit of Measure Code field.
	Reserved Quantity	Reserved Quantity	Specifies how many item units on this line have been reserved. from the table field
	Job Remaining Qty.	Job Remaining Qty.	Specifies the quantity that remains to complete a project. from the table field
	Unit of Measure Code	Unit of Measure Code	Specifies how each unit of the item or resource is measured, such as in pieces or hours. By default, the value in the Base Unit of Measure field on the item or resource card is inserted. from the table field
	Unit of Measure	Unit of Measure	Specifies the unit of measure. from the table field
	Direct Unit Cost	Direct Unit Cost	Specifies the price of one unit of what you’re buying.
	Indirect Cost %	Indirect Cost %	Specifies the percentage of the item’s last purchase cost that includes indirect costs, such as freight that is associated with the purchase of the item. from the table field
	Unit Cost (LCY)	Unit Cost (LCY)	Specifies the unit cost of the item on the line.
	Unit Price (LCY)	Unit Price (LCY)	Specifies the price, in LCY, for one unit of the item.
	Tax Liable	Tax Liable	Specifies if this vendor charges you sales tax for purchases. from the table field
	Tax Area Code	Tax Area Code	Specifies the tax area that is used to calculate and post sales tax. from the table field
	Tax Group Code	Tax Group Code	Specifies the tax group that is used to calculate and post sales tax. from the table field
	Use Tax	Use Tax	Specifies a U.S. sales tax that is paid on items purchased by a company that are used by the company, instead of being sold to a customer. from the table field
	Line Discount %	Line Discount %	Specifies the discount percentage that is granted for the item on the line. from the table field
	Line Amount	Line Amount	Specifies the net amount, excluding any invoice discount amount, that must be paid for products on the line. from the table field
	Line Discount Amount	Line Discount Amount	Specifies the discount amount that is granted for the item on the line. from the table field
	NonDeductibleVATBase	Non-Deductible VAT Base	Specifies the amount of VAT that is not deducted due to the type of goods or services purchased. from the table field
	NonDeductibleVATAmount	Non-Deductible VAT Amount	Specifies the amount of the transaction for which VAT is not applied, due to the type of goods or services purchased. from the table field
	Prepayment %	Prepayment %	Specifies the prepayment percentage to use to calculate the prepayment for purchases. from the table field
	Prepmt. Line Amount	Prepmt. Line Amount	Specifies the prepayment amount of the line in the currency of the purchase document if a prepayment percentage is specified for the purchase line. from the table field
	Prepmt. Amt. Inv.	Prepmt. Amt. Inv.	Specifies the prepayment amount that has already been invoiced to the customer for this purchase line. from the table field
	Allow Invoice Disc.	Allow Invoice Disc.	Specifies if the invoice line is included when the invoice discount is calculated. from the table field
	Inv. Discount Amount	Inv. Discount Amount	Specifies the total calculated invoice discount amount for the line. from the table field
	Inv. Disc. Amount to Invoice	Inv. Disc. Amount to Invoice	Specifies the actual invoice discount amount that will be posted for the line on the invoice. from the table field
	Qty. to Receive	Qty. to Receive	Specifies the quantity of items that remains to be received. from the table field
	Quantity Received	Quantity Received	Specifies how many units of the item on the line have been posted as received. from the table field
	Qty. to Invoice	Qty. to Invoice	Specifies the quantity that remains to be invoiced. It is calculated as Quantity - Qty. Invoiced. from the table field
	Quantity Invoiced	Quantity Invoiced	Specifies how many units of the item on the line have been posted as invoiced. from the table field
	Matched Invoice Lines	Matched Inv./Cr. Memo Lines	Specifies the number of purchase invoice lines to which this purchase order line is matched.
	Prepmt Amt to Deduct	Prepmt Amt to Deduct	Specifies the prepayment amount that has already been deducted from ordinary invoices posted for this purchase order line. from the table field
	Prepmt Amt Deducted	Prepmt Amt Deducted	Specifies the prepayment amount that has already been deducted from ordinary invoices posted for this purchase order line. from the table field
	Allow Item Charge Assignment	Allow Item Charge Assignment	Specifies that you can assign item charges to this line. from the table field
	Qty. to Assign	Qty. to Assign	Specifies how many units of the item charge will be assigned to the line. from the table field
	Item Charge Qty. to Handle	Item Charge Qty. to Handle	Specifies how many items the item charge will be assigned to on the line. It can be either equal to Qty. to Assign or to zero. If it is zero, the item charge will not be assigned to the line. from the table field
	Qty. Assigned	Qty. Assigned	Specifies how much of the item charge that has been assigned. from the table field
	Allocation Account No.	Selected Alloc. Account No.	Specifies the allocation account number that will be used to distribute the amounts during the posting process. from the table field
	Job No.	Job No.	Specifies the number of the related project. If you fill in this field and the Project Task No. field, then a project ledger entry will be posted together with the purchase line. from the table field
	Job Task No.	Job Task No.	Specifies the number of the related project task. from the table field
	Job Planning Line No.	Job Planning Line No.	Specifies the project planning line number that the usage should be linked to when the project journal is posted. You can only link to project planning lines that have the Apply Usage Link option enabled. from the table field
	Job Line Type	Job Line Type	Specifies the type of planning line that was created when the project ledger entry is posted from the purchase line. If the field is empty, no planning lines were created for this entry.
	Job Unit Price	Job Unit Price	Specifies the sales price per unit that applies to the item or general ledger expense that will be posted. from the table field
	Job Line Amount	Job Line Amount	Specifies the line amount of the project ledger entry that is related to the purchase line. from the table field
	Job Line Discount Amount	Job Line Discount Amount	Specifies the line discount amount of the project ledger entry that is related to the purchase line. from the table field
	Job Line Discount %	Job Line Discount %	Specifies the line discount percentage of the project ledger entry that is related to the purchase line. from the table field
	Job Total Price	Job Total Price	Specifies the gross amount of the line that the purchase line applies to. from the table field
	Job Unit Price (LCY)	Job Unit Price (LCY)	Specifies the sales price per unit that applies to the item or general ledger expense that will be posted.
	Job Total Price (LCY)	Job Total Price (LCY)	Specifies the gross amount of the line, in the local currency.
	Job Line Amount (LCY)	Job Line Amount (LCY)	Specifies the line amount of the project ledger entry that is related to the purchase line.
	Job Line Disc. Amount (LCY)	Job Line Disc. Amount (LCY)	Specifies the line discount amount of the project ledger entry that is related to the purchase line.
	Requested Receipt Date	Requested Receipt Date	Specifies the date that you want the vendor to deliver to the ship-to address. The value in the field is used to calculate the latest date you can order the items to have them delivered on the requested receipt date. If you do not need delivery on a specific date, you can leave the field blank. from the table field
	Promised Receipt Date	Promised Receipt Date	Specifies the date that the vendor has promised to deliver the order. from the table field
	Planned Receipt Date	Planned Receipt Date	Specifies the date when the item is planned to arrive in inventory. Forward calculation: planned receipt date = order date + vendor lead time (per the vendor calendar and rounded to the next working day in first the vendor calendar and then the location calendar). If no vendor calendar exists, then:… from the table field
	Expected Receipt Date	Expected Receipt Date	Specifies the date you expect the items to be available in your warehouse. If you leave the field blank, it will be calculated as follows: Planned Receipt Date + Safety Lead Time + Inbound Warehouse Handling Time = Expected Receipt Date.
	Order Date	Order Date	Specifies the date when the order was created. from the table field
	Lead Time Calculation	Lead Time Calculation	Specifies a date formula for the amount of time it takes to replenish the item. from the table field
	Planning Flexibility	Planning Flexibility	Specifies whether the supply represented by this line is considered by the planning system when calculating action messages. from the table field
	Whse. Outstanding Qty. (Base)	Whse. Outstanding Qty. (Base)	Specifies how many units on the purchase order line remain to be handled in warehouse documents.
	Inbound Whse. Handling Time	Inbound Whse. Handling Time	Specifies the time it takes to make items part of available inventory, after the items have been posted as received. from the table field
	Blanket Order No.	Blanket Order No.	Specifies the number of the blanket order that the record originates from. from the table field
	Blanket Order Line No.	Blanket Order Line No.	Specifies the number of the blanket order line that the record originates from. from the table field
	Appl.-to Item Entry	Appl.-to Item Entry	Specifies the number of the item ledger entry that the document or journal line is applied -to. from the table field
	Deferral Code	Deferral Code	Specifies the deferral template that governs how expenses paid with this purchase document are deferred to the different accounting periods when the expenses were incurred. from the table field
	Shortcut Dimension 1 Code	Shortcut Dimension 1 Code	Specifies the code for Shortcut Dimension 1, which is one of two global dimension codes that you set up in the General Ledger Setup window. from the table field
	Shortcut Dimension 2 Code	Shortcut Dimension 2 Code	Specifies the code for Shortcut Dimension 2, which is one of two global dimension codes that you set up in the General Ledger Setup window. from the table field
	ShortcutDimCode3	`ShortcutDimCode[3]`	—
	ShortcutDimCode4	`ShortcutDimCode[4]`	—
	ShortcutDimCode5	`ShortcutDimCode[5]`	—
	ShortcutDimCode6	`ShortcutDimCode[6]`	—
	ShortcutDimCode7	`ShortcutDimCode[7]`	—
	ShortcutDimCode8	`ShortcutDimCode[8]`	—
	Document No.	Document No.	Specifies the document number. from the table field
	Line No.	Line No.	Specifies the number of this line.
	Over-Receipt Quantity	Over-Receipt Quantity	Specifies over-receipt quantity. from the table field
	Over-Receipt Code	Over-Receipt Code	Specifies over-receipt code. from the table field
	Unit Gross Weight	Gross Weight	Specifies the gross weight of one unit of the item. In the purchase statistics window, the gross weight on the line is included in the total gross weight of all the lines for the particular purchase document. from the table field
	Unit Net Weight	Net Weight	Specifies the net weight of one unit of the item. In the purchase statistics window, the net weight on the line is included in the total net weight of all the lines for the particular purchase document. from the table field
	Unit Volume	Unit Volume	Specifies the volume of one unit of the item. In the purchase statistics window, the volume of one unit of the item on the line is included in the total volume of all the lines for the particular purchase document. from the table field
	Units per Parcel	Units per Parcel	Specifies the number of units per parcel of the item. In the purchase statistics window, the number of units per parcel on the line helps to determine the total number of units for all the lines for the particular purchase document. from the table field
	FA Posting Date	FA Posting Date	Specifies the FA posting date if you have selected Fixed Asset in the Type field for this line. from the table field
	No. of Fixed Asset Cards	No. of Fixed Asset Cards	Specifies the number of fixed assets that is being purchased. from the table field
	Attached to Line No.	Attached to Line No.	Specifies the line number to which this purchase line is attached. from the table field
	Attached Lines Count	Attached Lines Count	Specifies the number of non-inventory product lines attached to the purchase line. from the table field
	Spend Request No.	Spend Request No.	Specifies the spend request that this purchase document relates to. from the table field
Control37	Subtotal Excl. VAT	`TotalPurchaseLine."Line Amount"`	Specifies the sum of the value in the Line Amount Excl. VAT field on all lines in the document.
	Invoice Discount Amount	`InvoiceDiscountAmount`	Specifies a discount amount that is deducted from the value of the Total Incl. VAT field, based on purchase lines where the Allow Invoice Disc. field is selected. You can enter or change the amount manually.
	Invoice Discount %	`InvoiceDiscountPct`	Specifies a discount percentage that is applied to the invoice, based on purchase lines where the Allow Invoice Disc. field is selected. The percentage and criteria are defined in the Vendor Invoice Discounts page, but you can enter or change the percentage manually.
Control19	Total Amount Excl. VAT	`TotalPurchaseLine.Amount`	Specifies the sum of the value in the Line Amount Excl. VAT field on all lines in the document minus any discount amount in the Invoice Discount Amount field.
	Total VAT	`VATAmount`	Specifies the sum of VAT amounts on all lines in the document.
	Total Amount Incl. VAT	`TotalPurchaseLine."Amount Including VAT"`	Specifies the sum of the value in the Line Amount Incl. VAT field on all lines in the document minus any discount amount in the Invoice Discount Amount field.

Actions

Group	Action	ToolTip	Runs
Processing	Select items	Add two or more items from the full list of your inventory items.
Item Availability by	Event	View how the actual and the projected available balance of an item will develop over time according to supply and demand events.
	Period	Show the projected quantity of the item over time according to time periods, such as day, week, or month.
	Variant	View or edit the item’s variants. Instead of setting up each color of an item as a separate item, you can set up the various colors as variants of the item.
	Location	View the actual and projected quantity of the item per location.
	Lot	View the current and projected quantity of the item in each lot.	Page 520 “Item Availability by Lot No.”
	BOM Level	View availability figures for items on bills of materials that show how many units of a parent item you can make based on the availability of child items.
Line	Reservation Entries	View all reservation entries for the selected item. This action is available only for lines that contain an item.
	Item Tracking Lines	View or edit serial, lot and package numbers for the selected item. This action is available only for lines that contain an item.
	Dimensions	View or edit dimensions, such as area, project, or department, that you can assign to sales and purchase documents to distribute costs and analyze transaction history.
	Comments	View or add comments for the record.
	Item Charge Assignment	Record additional direct costs, for example for freight. This action is available only for Charge (Item) line types.
	Document Line Tracking	View related open, posted, or archived documents or document lines.
	Deferral Schedule	View or edit the deferral schedule that governs how revenue made with this purchase document is deferred to different accounting periods when the document is posted.
	Redistribute Account Allocations	Use this action to redistribute the account allocations for this line.
	Generate lines from Allocation Account Line	Use this action to replace the Allocation Account line with the actual lines that would be generated from the line itself.
	Attachments	Add a file as an attachment. You can attach images as well as documents.
	Matched Invoice Lines	View the invoice lines matched to this order line.
Functions	Explode BOM	Add a line for each component on the bill of materials for the selected item. For example, this is useful for selling the parent item as a kit. CAUTION: The line for the parent item will be deleted and only its description will display. To undo this action, delete the component lines and add a line …
	Insert Ext. Texts	Insert the extended item description that is set up for the item that is being processed on the line.
	Attach to inventory item line	Attach the selected non-inventory product lines to a inventory item line in this purchase order.
	Reserve	Reserve the quantity of the selected item that is required on the document line from which you opened this page. This action is available only for lines that contain an item.
	Order Tracking	Track the connection of a supply to its corresponding demand for the selected item. This can help you find the original demand that created a specific production order or purchase order. This action is available only for lines that contain an item.
Drop Shipment	Sales Order	View the sales order that is the source of the line. This applies only to drop shipments and special orders.
Special Order	Sales Order	View the sales order that is the source of the line. This applies only to drop shipments and special orders.
Order	Blanket Order	View the blanket purchase order.
Issues	Show Lines with Issues	View a list of purchase lines that have issues before you post the document.
	Show All Lines	View all purchase lines, including lines with and without issues.
Page	Edit in Excel	Send the data in the sub page to an Excel file for analysis or editing

Events published

OnAfterNoOnAfterValidate(var PurchaseLine: Record "Purchase Line"; var xPurchaseLine: Record "Purchase Line") Δ BC24 (integration)
OnAfterUpdateEditableOnRow(PurchaseLine: Record "Purchase Line"; var IsCommentLine: Boolean; var IsBlankNumber: Boolean) (integration)
OnAfterValidateShortcutDimCode(var PurchaseLine: Record "Purchase Line"; var ShortcutDimCode: array[8] of Code[20]; DimIndex: Integer) (integration)
OnBeforeCalculateTotals(var PurchLine: Record "Purchase Line"; SuppressTotals: Boolean; var DocumentTotals: Codeunit "Document Totals"; var IsHandled: Boolean) (integration)
OnBeforeCheckSendLineInvoiceDiscountResetNotification(var PurchaseLine: Record "Purchase Line"; var IsHandled: Boolean) (integration)
OnBeforeInsertExtendedText(var PurchaseLine: Record "Purchase Line"; var IsHandled: Boolean) (integration)
OnBeforeOpenSpecOrderSalesOrderForm(var PurchaseLine: Record "Purchase Line"; var SalesHeader: Record "Sales Header"; var SalesOrder: Page "Sales Order"; var IsHandled: Boolean) (integration)
OnBeforeSetDefaultType(var PurchaseLine: Record "Purchase Line"; var xPurchaseLine: Record "Purchase Line"; var IsHandled: Boolean) (integration)
OnBeforeUpdateTypeText(var PurchaseLine: Record "Purchase Line") (integration)
OnItemReferenceNoOnLookup(var PurchaseLine: Record "Purchase Line") (integration)
OnBeforeOpenSalesOrderForm(var PurchaseLine: Record "Purchase Line"; var SalesHeader: Record "Sales Header"; var SalesOrder: Page "Sales Order"; var IsHandled: Boolean) (integration)
OnBeforeSetOpenPage() (integration)
OnAfterSetDimensionsVisibility() (integration)
OnBeforeDeltaUpdateTotals(var PurchaseLine: Record "Purchase Line"; xPurchaseLine: Record "Purchase Line") (integration)
OnBeforeDeleteReservationEntries(var PurchaseLine: Record "Purchase Line") (integration)
OnBeforeOnDeleteRecord(var PurchaseLine: Record "Purchase Line"; var Result: Boolean; var IsHandled: Boolean) (integration)

Trigger event subscribers

OnModifyRecordEvent: Codeunit 9070 “Document Errors Mgt.” OnModifyRecordEventPurchaseOrderSubform

Procedures

ApproveCalcInvDisc()
InsertExtendedText(Unconditionally: Boolean)
ShowTracking()
OpenSpecOrderSalesOrderForm() (protected)
UpdateForm(SetSaveRecord: Boolean)
NoOnAfterValidate()
ShowDocumentLineTracking()
RedistributeTotalsOnAfterValidate()
ClearTotalPurchaseHeader()
CalculateTotals()
DeltaUpdateTotals()
ForceTotalsCalculation()
UpdateEditableOnRow()
UpdateTypeText()

Plus 11 local procedures.

Triggers

OnAfterGetCurrRecord, OnAfterGetRecord, OnDeleteRecord, OnFindRecord, OnInit, OnModifyRecord, OnNewRecord, OnOpenPage

Relations

source table Table 39 “Purchase Line”

Extended by

Calls

From the extracted call graph of BC29 (graphify-al on the snapshot checkout): calls whose target is known from a declared type or an Object::"Name" argument. Interface dispatch and calls through events are not counted, so the list is not complete.

Codeunit 57 “Document Totals” (13 calls: ApproveCalcInvDisc → PurchaseDocTotalsNotUpToDate, CalculateTotals → CalculatePurchaseSubPageTotals, CalculateTotals → PurchaseCheckIfDocumentChanged, …)
Codeunit 378 “Transfer Extended Text” (3 calls: InsertExtendedText → InsertPurchExtText, InsertExtendedText → MakeUpdate, InsertExtendedText → PurchCheckIfAnyExtText)
Codeunit 99000834 “Purch. Line-Reserve” (2 calls: OnDeleteRecord → DeleteLine, OnDeleteRecord → DeleteLineConfirm)
Codeunit 2675 “Allocation Account Mgt.” (1 call: OnOpenPage → UseAllocationAccountNoField)
Codeunit 27 “Confirm Management” (1 call: ValidateInvoiceDiscountAmount → GetResponseOrDefault)
Codeunit 408 “DimensionManagement” (1 call: SetDimensionsVisibility → UseShortcutDims)
Codeunit 6200 “Non-Deductible VAT” (1 call: SetOpenPage → ShowNonDeductibleVATInLines)
Codeunit 66 “Purch - Calc Disc. By Type” (1 call: ValidateInvoiceDiscountAmount → ApplyInvDiscBasedOnAmt)
Codeunit 6723 “Server Setting” (1 call: SetOpenPage → GetIsSaasExcelAddinEnabled)
Codeunit 71 “Purch.-Disc. (Yes/No)” (1 call: ApproveCalcInvDisc → (object))
Codeunit 73 “Purch.-Explode BOM” (1 call: ExplodeBOM → (object))
Codeunit 8510 “Over-Receipt Mgt.” (1 call: SetOverReceiptControlsVisibility → IsOverReceiptAllowed)
Codeunit 9070 “Document Errors Mgt.” (1 call: SetOpenPage → BackgroundValidationEnabled)
Codeunit 9179 “Application Area Mgmt. Facade” (1 call: OnInit → IsFoundationEnabled)

Recent changes

2026-09-01 #10700 29.x: PO matching API, E-Documents integration and receipt-on-invoice line tracking (releases/29.x, BC29, feature)
2026-08-31 #10528 Track receipt on invoice per purchase order line (main, BC30, feature)
2026-08-27 #9196 [Master] - What If Impact on Planning and Supply (main, BC30, feature)
2026-07-31 #8959 Deliverable 638799: Spend Requests in Base App (main, BC30, feature)

Ask your agent

Procedure bodies are not stored here (D10). The call sections above are our own, per object, from the BC29 call graph. For a procedure body or the calls of one procedure, ask bc-code-atlas (external, by Stefan Maron, MIT; default corpus w1-28), which the bc-observatory plugin connects: bcatlas_resolve_node(object_type: "page", object_name: "Purchase Order Subform"), then bcatlas_get_procedure_body or bcatlas_get_neighbors on the returned id.