---
id: object/page/9307
type: object
title: Page 9307 "Purchase Order List"
summary: Page 9307 "Purchase Order List" in Base Application (Microsoft.Purchases.Document). 1 public procedures. Present since at least BC23, still in BC30, changed in BC27.
tier: official
language: en
tags:
  - page
  - base application
versions:
  introduced: null
  last_changed: "27"
  deprecated: null
review:
  state: derived
  by: null
  at: null
  flags: []
generated:
  at: "2026-10-11T00:31:51.816Z"
  pipeline: 0.2.0
  prompts: {}
  input_hash: 1a9309f5f9136e12bfbb5c99e3bebb6b8de58a206334e5c2c625a7c8a2ca6f8d
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Purchases/Document/PurchaseOrderList.Page.al
    title: src/Layers/W1/BaseApp/Purchases/Document/PurchaseOrderList.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/ad-hoc-analysis-purchasing
    title: Ad-hoc analyses in purchasing
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/analysis-assist
    title: Analyze data in lists with Copilot (preview)
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/analysis-mode
    title: Analyze list page and query data using data analysis
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/finance-how-to-correct-prepayments
    title: Correct prepayments
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/finance-how-to-create-prepayment-invoices
    title: Create prepayment invoices
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/finance-how-use-edocuments-purchase
    title: Use E-Documents in the purchase process
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/finance-invoice-prepayments
    title: Invoice prepayments
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-analytics-overview
    title: Analytics in purchasing
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-how-process-purchase-returns-cancellations
    title: Process returns or cancellations
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchase-price-discount-payment-agreements
    title: Record special purchase prices and discounts
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchases
    title: Record purchases with purchase invoices
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-manage-purchasing
    title: Overview of tasks to manage to purchase
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/ad-hoc-analysis-purchasing
    - https://learn.microsoft.com/dynamics365/business-central/analysis-assist
    - https://learn.microsoft.com/dynamics365/business-central/analysis-mode
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-to-correct-prepayments
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-to-create-prepayment-invoices
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-use-edocuments-purchase
    - https://learn.microsoft.com/dynamics365/business-central/finance-invoice-prepayments
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-analytics-overview
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-how-process-purchase-returns-cancellations
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchase-price-discount-payment-agreements
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchases
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-manage-purchasing
  objects: []
  features: []
  topics:
    - topic/business-central/analytics-business-intelligence-and-repo/ad-hoc-data-analysis
    - topic/business-central/business-functionality/finance/invoicing-prepayments
    - topic/business-central/business-functionality/finance/set-up-and-use-e-documents
    - topic/business-central/business-functionality/purchasing
    - topic/business-central/business-functionality/purchasing/purchasing-analytics
    - topic/business-central/business-functionality/set-up-business-central/set-up-purchase
    - topic/business-central/copilot-and-agent-capabilities/analysis-assist
    - topic/dev-itpro/development/data-analytics-and-reporting
    - topic/dev-itpro/development/programming-in-the-al-language/tables-and-data/using-query-objects
  localizations: []
  videos: []
  posts: []
  guidelines: []
  changes:
    - change/bcapps/9549
object_type: page
object_id: 9307
name: Purchase Order List
caption: Purchase Orders
namespace: Microsoft.Purchases.Document
app: Base Application
extends: null
first_version: "23"
last_version: "30"
present_in:
  - "23"
  - "24"
  - "25"
  - "26"
  - "27"
  - "28"
  - "29"
  - "30"
changed_in:
  - "27"
source_major: "29"
obsolete: null
countries: []
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/ad-hoc-analysis-purchasing.md
  - docs/learn-smb-docs/business-central/analysis-assist.md
  - docs/learn-smb-docs/business-central/analysis-mode.md
  - docs/learn-smb-docs/business-central/finance-how-to-correct-prepayments.md
  - docs/learn-smb-docs/business-central/finance-how-to-create-prepayment-invoices.md
  - docs/learn-smb-docs/business-central/finance-how-use-edocuments-purchase.md
  - docs/learn-smb-docs/business-central/finance-invoice-prepayments.md
  - docs/learn-smb-docs/business-central/purchasing-analytics-overview.md
  - docs/learn-smb-docs/business-central/purchasing-how-process-purchase-returns-cancellations.md
  - docs/learn-smb-docs/business-central/purchasing-how-record-purchase-price-discount-payment-agreements.md
  - docs/learn-smb-docs/business-central/purchasing-how-record-purchases.md
  - docs/learn-smb-docs/business-central/purchasing-manage-purchasing.md
counts:
  fields: 0
  procedures: 3
  events: 0
  subscribers: 0
  controls: 44
  actions: 31
relations:
  out: 2
  referenced_by: 0
  pages: 0
  extended_by: 2
  event_subscribers: 0
  calls: 2
  called_by: 3
  implements: 0
---

# Page 9307 "Purchase Order List"

> Page 9307 "Purchase Order List" in Base Application (Microsoft.Purchases.Document). 1 public procedures. Present since at least BC23, still in BC30, changed in BC27.

Base Application · Microsoft.Purchases.Document · captioned "Purchase Orders" · BC23-30 · [source at ea08af5e](https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Purchases/Document/PurchaseOrderList.Page.al) · facts from BC29

## Properties

| Property | Value |
|---|---|
| Caption | Purchase Orders |
| SourceTable | Purchase Header |
| PageType | List |
| UsageCategory | Lists |
| ApplicationArea | Basic, Suite |

## 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 | No. | [No.](../table/38.md#fields) | Specifies a unique number that identifies the purchase order. The number can be generated automatically from a number series, or you can number each of them manually. <small>from the table field</small> |
|  | Buy-from Vendor No. | [Buy-from Vendor No.](../table/38.md#fields) | Specifies the vendor who will deliver the goods or services. Each vendor has a unique number to help you track related documents. The number can come from a number series or be added manually. <small>from the table field</small> |
|  | Order Address Code | [Order Address Code](../table/38.md#fields) | Specifies the order address of the related vendor. <small>from the table field</small> |
|  | Buy-from Vendor Name | [Buy-from Vendor Name](../table/38.md#fields) | Specifies the name of the vendor that you’re buying from. By default, the same vendor is suggested as the pay-to vendor. If needed, you can specify a different pay-to vendor on the document. <small>from the table field</small> |
|  | Vendor Authorization No. | [Vendor Authorization No.](../table/38.md#fields) | Specifies the compensation agreement identification number, sometimes referred to as the RMA No. (Returns Materials Authorization). <small>from the table field</small> |
|  | Buy-from Post Code | [Buy-from Post Code](../table/38.md#fields) | Specifies the post code of the vendor who delivered the items. <small>from the table field</small> |
|  | Buy-from Country/Region Code | [Buy-from Country/Region Code](../table/38.md#fields) | Specifies the city of the vendor who delivered the items. <small>from the table field</small> |
|  | Buy-from Contact | [Buy-from Contact](../table/38.md#fields) | Specifies the name of the contact person at the vendor who delivered the items. <small>from the table field</small> |
|  | Pay-to Vendor No. | [Pay-to Vendor No.](../table/38.md#fields) | Specifies the number of the vendor that you received the invoice from. <small>from the table field</small> |
|  | Pay-to Name | [Pay-to Name](../table/38.md#fields) | Specifies the name of the vendor who you received the invoice from. <small>from the table field</small> |
|  | Pay-to Post Code | [Pay-to Post Code](../table/38.md#fields) | Specifies the post code of the vendor that you received the invoice from. <small>from the table field</small> |
|  | Pay-to Country/Region Code | [Pay-to Country/Region Code](../table/38.md#fields) | Specifies the country/region code of the address. <small>from the table field</small> |
|  | Pay-to Contact | [Pay-to Contact](../table/38.md#fields) | Specifies the name of the person to contact about an invoice from this vendor. <small>from the table field</small> |
|  | Ship-to Code | [Ship-to Code](../table/38.md#fields) | Specifies a code for an alternate shipment address if you want to ship to another address than the one that has been entered automatically. This field is also used in case of drop shipment. <small>from the table field</small> |
|  | Ship-to Name | [Ship-to Name](../table/38.md#fields) | Specifies the name of the customer at the address that the items are shipped to. <small>from the table field</small> |
|  | Ship-to Post Code | [Ship-to Post Code](../table/38.md#fields) | Specifies the postal code of the address that the items are shipped to. <small>from the table field</small> |
|  | Ship-to Country/Region Code | [Ship-to Country/Region Code](../table/38.md#fields) | Specifies the country/region code of the address that the items are shipped to. <small>from the table field</small> |
|  | Ship-to Contact | [Ship-to Contact](../table/38.md#fields) | Specifies the name of the contact person at the address that the items are shipped to. <small>from the table field</small> |
|  | Posting Date | [Posting Date](../table/38.md#fields) | Specifies the date when the posting of the purchase document will be recorded. <small>from the table field</small> |
|  | Shortcut Dimension 1 Code | [Shortcut Dimension 1 Code](../table/38.md#fields) | 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. <small>from the table field</small> |
|  | Shortcut Dimension 2 Code | [Shortcut Dimension 2 Code](../table/38.md#fields) | 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. <small>from the table field</small> |
|  | Location Code | [Location Code](../table/38.md#fields) | Specifies the code for the location where the items are to be received. When you select the vendor and the vendor has a location assigned, the value is taken from the Vendor card. If the vendor has no location, but a Responsibility Center is populated, the location code is taken from the Responsibil... <small>from the table field</small> |
|  | Purchaser Code | [Purchaser Code](../table/38.md#fields) | Specifies which purchaser is assigned to the vendor. <small>from the table field</small> |
|  | Assigned User ID | [Assigned User ID](../table/38.md#fields) | Specifies the ID of the user who is responsible for the document. <small>from the table field</small> |
|  | Currency Code | [Currency Code](../table/38.md#fields) | Specifies the code of the currency of the amounts on the purchase lines. <small>from the table field</small> |
|  | Document Date | [Document Date](../table/38.md#fields) | Specifies the date when the related document was created. <small>from the table field</small> |
|  | Status | [Status](../table/38.md#fields) | Specifies whether the record is open, waiting to be approved, invoiced for prepayment, or released to the next stage of processing. <small>from the table field</small> |
|  | Payment Terms Code | [Payment Terms Code](../table/38.md#fields) | Specifies a formula that calculates the payment due date, payment discount date, and payment discount amount. <small>from the table field</small> |
|  | Due Date | [Due Date](../table/38.md#fields) | Specifies when the purchase invoice is due for payment. <small>from the table field</small> |
|  | Payment Discount % | [Payment Discount %](../table/38.md#fields) | Specifies the payment discount percent granted if payment is made on or before the date in the Pmt. Discount Date field. <small>from the table field</small> |
|  | Payment Method Code | [Payment Method Code](../table/38.md#fields) | Specifies how to make payment, such as with bank transfer, cash, or check. <small>from the table field</small> |
|  | Shipment Method Code | [Shipment Method Code](../table/38.md#fields) | Specifies the delivery conditions of the related shipment, such as free on board (FOB). <small>from the table field</small> |
|  | Requested Receipt Date | [Requested Receipt Date](../table/38.md#fields) | 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. <small>from the table field</small> |
|  | Job Queue Status | [Job Queue Status](../table/38.md#fields) | Specifies the status of a job queue entry that handles the posting of purchase orders. <small>from the table field</small> |
|  | Amount Received Not Invoiced excl. VAT (LCY) | [A. Rcd. Not Inv. Ex. VAT (LCY)](../table/38.md#fields) | Specifies the amount excluding VAT for the items on the order that have been received but are not yet invoiced. <small>from the table field</small> |
|  | Amount Received Not Invoiced (LCY) | [Amt. Rcd. Not Invoiced (LCY)](../table/38.md#fields) | Specifies the sum, in LCY, for items that have been received but have not yet been invoiced. The value in the Amt. Rcd. Not Invoiced (LCY) field is used for entries in the Purchase Line table of document type Order to calculate and update the contents of this field. <small>from the table field</small> |
|  | Amount | [Amount](../table/38.md#fields) | Specifies the sum of amounts on all the lines in the document. This will include invoice discounts. <small>from the table field</small> |
|  | Amount Including VAT | [Amount Including VAT](../table/38.md#fields) | Specifies the sum of amounts, including VAT, on all the lines in the document. This will include invoice discounts. <small>from the table field</small> |
|  | Posting Description | [Posting Description](../table/38.md#fields) | Specifies additional posting information for the document. After you post the document, the description can add detail to vendor and customer ledger entries. <small>from the table field</small> |
|  | Your Reference | [Your Reference](../table/38.md#fields) | Specifies the vendor's reference. <small>from the table field</small> |
|  | Vendor Order No. | [Vendor Order No.](../table/38.md#fields) | Specifies the vendor's order number. <small>from the table field</small> |
| FactBoxes | Documents | part [Page 1178 "Doc. Attachment List Factbox"](../page/1178.md) | — |
|  | IncomingDocAttachFactBox | part [Page 193 "Incoming Doc. Attach. FactBox"](../page/193.md) | — |
|  | Control1901138007 | part [Page 9093 "Vendor Details FactBox"](../page/9093.md) | — |

## Actions

| Group | Action | ToolTip | Runs |
|---|---|---|---|
| Order | 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. |  |
|  | Statistics | View statistical information, such as the value of posted entries, for the record. | [Page 403 "Purchase Order Statistics"](../page/403.md) |
|  | Vendor Statistics | View statistical information, such as the value of posted entries, for the buy-from vendor on the purchase document. | [Page 152 "Vendor Statistics"](../page/152.md) |
|  | Approvals | View a list of the records that are waiting to be approved. For example, you can see who requested the record to be approved, when it was sent, and when it is due to be approved. |  |
|  | Comments | View or add comments for the record. | [Page 66 "Purch. Comment Sheet"](../page/66.md) |
| Documents | Receipts | View a list of posted purchase receipts for the order. | [Page 145 "Posted Purchase Receipts"](../page/145.md) |
|  | Invoices | View a list of ongoing purchase invoices for the order. |  |
|  | Prepayment Invoices | View related posted purchase invoices that involve a prepayment. | [Page 146 "Posted Purchase Invoices"](../page/146.md) |
|  | Prepayment Credit Memos | View related posted purchase credit memos that involve a prepayment. | [Page 147 "Posted Purchase Credit Memos"](../page/147.md) |
| Warehouse | Invt. Put-away/Pick Lines | View items that are inbound or outbound on inventory put-away or inventory pick documents for the purchase order. | [Page 5774 "Warehouse Activity List"](../page/5774.md) |
|  | Whse. Receipt Lines | View ongoing warehouse receipts for the document, in advanced warehouse configurations. | [Page 7342 "Whse. Receipt Lines"](../page/7342.md) |
|  | Warehouse Put-away Lines | View items that are inbound on warehouse put-away documents for the purchase order. | [Page 5785 "Warehouse Activity Lines"](../page/5785.md) |
| Print | Print | Prepare to print the document. The report request window for the document opens where you can specify what to include on the print-out. |  |
|  | Send by Email | Finalize and prepare to email the document. The Send Email window opens prefilled with the vendor's email address so you can add or edit information. |  |
|  | Send | Prepare to send the document according to the vendor's sending profile, such as attached to an email. The Send document to window opens first so you can confirm or select a sending profile. |  |
|  | Attach as PDF | Create a PDF file and attach it to the document. |  |
| Release | Release | Release the document to the next stage of processing. You must reopen the document before you can make changes to it. |  |
|  | Reopen | Reopen the document to change it after it has been approved. Approved documents have the Released status and must be opened before they can be changed |  |
| Functions | Send IC Purchase Order | Send the document to the intercompany outbox or directly to the intercompany partner if automatic transaction sending is enabled. |  |
|  | Delete Invoiced Orders | — | [Report 499 "Delete Invoiced Purch. Orders"](../report/499.md) |
| Request Approval | Send Approval Request | Request approval of the document. |  |
|  | Cancel Approval Request | Cancel the approval request. |  |
| Warehouse | Create Whse. Receipt | Create a warehouse receipt to start a receive and put-away process according to an advanced warehouse configuration. |  |
|  | Create Inventory Put-away/Pick | Create an inventory put-away or inventory pick to handle items on the document according to a basic warehouse configuration that does not require warehouse receipt or shipment documents. |  |
| Posting | Test Report | View a test report so that you can find and correct any errors before you perform the actual posting of the journal or document. |  |
|  | Post | Finalize the document or journal by posting the amounts and quantities to the related accounts in your company books. |  |
|  | Preview Posting | Review the different types of entries that will be created when you post the document or journal. |  |
|  | Post and Print | Finalize and prepare to print the document or journal. The values and quantities are posted to the related accounts. A report request window where you can specify what to include on the print-out. |  |
|  | Post Batch | Post several documents at once. A report request window opens where you can specify which documents to post. |  |
|  | Remove From Job Queue | Remove the scheduled processing of this record from the job queue. |  |
| Reporting | Analyze Purchase Orders | Analyze (group, summarize, pivot) your Purchase Order performance against vendors and goods/services bought, including outstanding vs. posted quantities and amounts. | [Query 488 "Purch. Order Perf. Analysis"](../query/488.md) |

## Procedures

- `SkipShowingLinesWithoutVAT()`

Plus 2 local procedures.

## Triggers

OnAfterGetRecord, OnAfterGetCurrRecord, OnOpenPage

## Relations

- card page [Page 50 "Purchase Order"](../page/50.md)
- source table [Table 38 "Purchase Header"](../table/38.md)

## Extended by

- [Page extension 20525 "Subc. PurchOrderList"](../pageextension/20525.md)
- [Page extension 6137 "E-Doc. Purchase Order List"](../pageextension/6137.md)

## 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 1535 "Approvals Mgmt."](../codeunit/1535.md) (2 calls: `SetControlAppearance → CanCancelApprovalForRecord`, `SetControlAppearance → HasOpenApprovalEntries`)
- [Codeunit 1543 "Workflow Webhook Management"](../codeunit/1543.md) (1 call: `SetControlAppearance → GetCanRequestAndCanCancel`)

## Called by

- [Codeunit 1018 "Purchase Doc. From Job"](../codeunit/1018.md) (1 call: `CreatePurchaseOrder → (object)`)
- [Codeunit 1314 "Purch. Doc. From Sales Doc."](../codeunit/1314.md) (1 call: `CreatePurchaseOrder → (object)`)
- [Table 9055 "Purchase Cue"](../table/9055.md) (1 call: `ShowOrders → (object)`)

## Recent changes

- 2026-08-04 [#9549 636017 Move Purchases report action tooltips to report objects](../../changes/bcapps/9549.md) (main, BC30, refactor)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC27

## Documented on Microsoft Learn

- [Ad-hoc analyses in purchasing](https://learn.microsoft.com/dynamics365/business-central/ad-hoc-analysis-purchasing)
- [Analyze data in lists with Copilot (preview)](https://learn.microsoft.com/dynamics365/business-central/analysis-assist)
- [Analyze list page and query data using data analysis](https://learn.microsoft.com/dynamics365/business-central/analysis-mode)
- [Correct prepayments](https://learn.microsoft.com/dynamics365/business-central/finance-how-to-correct-prepayments)
- [Create prepayment invoices](https://learn.microsoft.com/dynamics365/business-central/finance-how-to-create-prepayment-invoices)
- [Use E-Documents in the purchase process](https://learn.microsoft.com/dynamics365/business-central/finance-how-use-edocuments-purchase)
- [Invoice prepayments](https://learn.microsoft.com/dynamics365/business-central/finance-invoice-prepayments)
- [Analytics in purchasing](https://learn.microsoft.com/dynamics365/business-central/purchasing-analytics-overview)
- [Process returns or cancellations](https://learn.microsoft.com/dynamics365/business-central/purchasing-how-process-purchase-returns-cancellations)
- [Record special purchase prices and discounts](https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchase-price-discount-payment-agreements)
- [Record purchases with purchase invoices](https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchases)
- [Overview of tasks to manage to purchase](https://learn.microsoft.com/dynamics365/business-central/purchasing-manage-purchasing)

Source: AL metadata extracted from the code (names, ids, signatures, properties); no code bodies (D10).

## 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 List")`, then `bcatlas_get_procedure_body` or `bcatlas_get_neighbors` on the returned id.