Page 55 "Purch. Invoice Subform"
Base Application · Microsoft.Purchases.Document
Across versions
- BC23present
- BC241 events changed
- BC25-27unchanged
- BC281 events added, 1 events removed
- BC29-30unchanged
Neighbourhood 23 connected objects and pages
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 |
|---|---|---|---|
| PurchDetailLine | 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/Comment | 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 | |
| Return Reason Code | Return Reason Code | Specifies the code explaining why the item was returned. from the table field | |
| Location Code | Location Code | Specifies the code for the location where the items on the line will be located. from the table field | |
| 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. | |
| 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 name of the unit of measure for the item, such as 1 bottle or 1 piece. | |
| Direct Unit Cost | Direct Unit Cost | Specifies the price of one unit of what you are 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 for one unit of the item. | |
| Matched Order Lines | Matched Order Lines | Specifies the number of purchase order lines to which this line is matched. | |
| Tax Liable | Tax Liable | Specifies if the customer or vendor is liable for sales tax. | |
| 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 that the purchase is subject to use tax. Use tax is a sales tax that is paid on items that are purchased by a company and are used by that company instead of being sold to a customer. | |
| 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 | |
| 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 invoice discount amount for the line. | |
| 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 | |
| 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 | |
| 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. | |
| 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 | |
| Insurance No. | Insurance No. | Specifies an insurance number if you have selected the Acquisition Cost option in the FA Posting Type field. 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 | |
| Budgeted FA No. | Budgeted FA No. | Specifies the number of a fixed asset with the Budgeted Asset check box selected. When you post the journal or document line, an additional entry is created for the budgeted fixed asset where the amount has the opposite sign. from the table field | |
| FA Posting Type | FA Posting Type | Specifies the FA posting type if you have selected Fixed Asset in the Type field for this line. from the table field | |
| Depreciation Book Code | Depreciation Book Code | Specifies the code for the depreciation book to which the line will be posted if you have selected Fixed Asset in the Type field for this line. from the table field | |
| Depr. until FA Posting Date | Depr. until FA Posting Date | Specifies if depreciation was calculated until the FA posting date of the line. from the table field | |
| Depr. Acquisition Cost | Depr. Acquisition Cost | Specifies if, when this line was posted, the additional acquisition cost posted on the line was depreciated in proportion to the amount by which the fixed asset had already been depreciated. from the table field | |
| Duplicate in Depreciation Book | Duplicate in Depreciation Book | Specifies a depreciation book code if you want the journal line to be posted to that depreciation book, as well as to the depreciation book in the Depreciation Book Code field. from the table field | |
| Use Duplication List | Use Duplication List | Specifies, if the type is Fixed Asset, that information on the line is to be posted to all the assets defined depreciation books. | |
| No. of Fixed Asset Cards | No. of Fixed Asset Cards | Specifies the number of fixed assets that is being purchased. 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 line’s number. 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 | |
| Spend Request No. | Spend Request No. | Specifies the spend request that this purchase document relates to. from the table field | |
| Control33 | 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. | |
| Control15 | 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 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 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. | |
| 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. | ||
| Get Receipt Lines | Select a posted purchase receipt for the item that you want to assign the item charge to. | ||
| Get Order Lines | Select order lines related to this purchase invoice line. | ||
| 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. | ||
| 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. | ||
| Related Information | 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. | ||
| 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. | ||
| Deferral Schedule | View or edit the deferral schedule that governs how expenses incurred with this purchase document is deferred to different accounting periods when the document is posted. | ||
| Attachments | Add a file as an attachment. You can attach images as well as documents. | ||
| Matched Order Lines | View and match order lines related to this purchase invoice line. | ||
| 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; var InvDiscAmountEditable: Boolean; CurrPageIsEditable: Boolean; TotalPurchaseHeader: Record "Purchase Header"; var UnitofMeasureCodeIsChangeable: Boolean)+ BC28 − BC28 (integration)OnAfterValidateShortcutDimCode(var PurchaseLine: Record "Purchase Line"; var ShortcutDimCode: array[8] of Code[20]; DimIndex: Integer)(integration)OnBeforeCheckSendLineInvoiceDiscountResetNotification(var PurchaseLine: Record "Purchase Line"; var IsHandled: Boolean)(integration)OnBeforeDeleteRecord(var PurchaseLine: Record "Purchase Line")(integration)OnBeforeInsertExtendedText(var PurchaseLine: Record "Purchase Line"; 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)OnBeforeValidateDescription(var PurchaseLine: Record "Purchase Line"; var IsHandled: Boolean)(integration)OnItemReferenceNoOnLookup(var PurchaseLine: Record "Purchase Line")(integration)OnBeforeSetOpenPage()(integration)OnAfterSetDimensionsVisibility()(integration)OnBeforeDeltaUpdateTotals(var PurchaseLine: Record "Purchase Line"; xPurchaseLine: Record "Purchase Line")(integration)
Trigger event subscribers
- OnAfterValidateEvent(Invoice Disc. Pct.): Codeunit 8074 “Document Change Management” PreventChangePurchHeaderInvoiceDiscPct
- OnAfterValidateEvent(InvoiceDiscountAmount): Codeunit 8074 “Document Change Management” PreventChangePurchHeaderInvoiceDiscAmount
- OnModifyRecordEvent: Codeunit 9070 “Document Errors Mgt.” OnModifyRecordEventPurchaseInvoiceSubform
Procedures
ApproveCalcInvDisc()GetReceipt()InsertExtendedText(Unconditionally: Boolean)UpdateForm(SetSaveRecord: Boolean)NoOnAfterValidate()UpdateEditableOnRow()RedistributeTotalsOnAfterValidate()ClearTotalPurchaseHeader()CalculateTotals()DeltaUpdateTotals()ForceTotalsCalculation()UpdateTypeText()SetItemChargeFieldsStyle()
Plus 8 local procedures.
Triggers
OnAfterGetCurrRecord, OnAfterGetRecord, OnDeleteRecord, OnFindRecord, OnInit, OnInsertRecord, OnModifyRecord, OnNewRecord, OnOpenPage
Relations
- source table Table 39 “Purchase Line”
Extended by
- Page extension 20636 “Purch Invoice Subform BF”
- Page extension 4862 “AutoAcc Purch. Invoice Subform”
- Page extension 5016 “SD Purch. Inv. Subform”
- Page extension 6214 “Sust. Purch. Inv. Subform”
- Page extension 6789 “WHT Purch. Invoice Subform”
- Page extension 8071 “Purch Invoice Subform”
- Page extension 99000769 “Mfg. Purch. Invoice Subform”
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” (14 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 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 74 “Purch.-Get Receipt” (1 call:
GetReceipt → (object)) - Codeunit 9070 “Document Errors Mgt.” (1 call:
SetOpenPage → BackgroundValidationEnabled) - Codeunit 9179 “Application Area Mgmt. Facade” (1 call:
OnInit → IsFoundationEnabled)
Recent changes
- 2026-09-14 #11339 Prevent order matching for invoice lines created by Get Receipt Lines (main, BC30, fix)
- 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: "Purch. Invoice Subform"), then bcatlas_get_procedure_body or bcatlas_get_neighbors on the returned id.