---
id: object/page/50
type: object
title: Page 50 "Purchase Order"
summary: Page 50 "Purchase Order" in Base Application (Microsoft.Purchases.Document). 4 public procedures, 11 events. Present since at least BC23, still in BC30, changed in BC24-25.
tier: official
language: en
tags:
  - page
  - base application
versions:
  introduced: null
  last_changed: "25"
  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: 27311bc156771fc26fcc339f7257c66c2a3fa05db58bcd8479b76e1806798137
evidence:
  - kind: code
    url: https://github.com/microsoft/BCApps/blob/ea08af5ef2d6a9b5c5af4a029288abbe2c883220/src/Layers/W1/BaseApp/Purchases/Document/PurchaseOrder.Page.al
    title: src/Layers/W1/BaseApp/Purchases/Document/PurchaseOrder.Page.al (releases/29.x)
    date: null
    commit: ea08af5ef2d6a9b5c5af4a029288abbe2c883220
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/across-how-to-archive-documents
    title: Archive sales, purchase, project, and service documents
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/across-how-to-track-document-lines
    title: Track order lines to related documents
    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-to-eu3party-trade-purchase
    title: EU third-party purchase transactions
    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-how-use-non-deductible-vat
    title: Use non-deductible VAT
    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/finance-sustainability-journal
    title: Record sustainability entries
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/how-to-1099-use
    title: Track data and use the IRS 1099 form
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/set-up-use-irs1099-form
    title: Set up and use the IRS 1099 form [US]
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/purchasing-how-purchase-products-sale
    title: Purchase items for a sale
    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/quick-start-procurement
    title: Procurement Quick Start
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/subcontract-order
    title: Order subcontracting
    date: null
    commit: null
    t: null
    quote: null
  - kind: learn
    url: https://learn.microsoft.com/dynamics365/business-central/value-chain-howto-purchase
    title: Sustainability value chain in purchasing
    date: null
    commit: null
    t: null
    quote: null
links:
  learn:
    - https://learn.microsoft.com/dynamics365/business-central/across-how-to-archive-documents
    - https://learn.microsoft.com/dynamics365/business-central/across-how-to-track-document-lines
    - 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-to-eu3party-trade-purchase
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-use-edocuments-purchase
    - https://learn.microsoft.com/dynamics365/business-central/finance-how-use-non-deductible-vat
    - https://learn.microsoft.com/dynamics365/business-central/finance-invoice-prepayments
    - https://learn.microsoft.com/dynamics365/business-central/finance-sustainability-journal
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/how-to-1099-use
    - https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/set-up-use-irs1099-form
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-how-purchase-products-sale
    - https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchases
    - https://learn.microsoft.com/dynamics365/business-central/quick-start-procurement
    - https://learn.microsoft.com/dynamics365/business-central/subcontract-order
    - https://learn.microsoft.com/dynamics365/business-central/value-chain-howto-purchase
  objects: []
  features: []
  topics:
    - 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/finance/working-with-value-added-tax-vat
    - topic/business-central/business-functionality/general-business-functionality
    - topic/business-central/business-functionality/local-functionality/united-states/tax
    - topic/business-central/business-functionality/manufacturing/subcontracting
    - topic/business-central/business-functionality/purchasing
    - topic/business-central/business-functionality/sustainability-management
    - topic/business-central/business-functionality/sustainability-management/sustainability-value-chain
    - topic/business-central/get-started/quick-starts
  localizations:
    - localization/ca
    - localization/it
    - localization/mx
    - localization/us
  videos: []
  posts: []
  guidelines: []
  changes:
    - change/bcapps/8959
    - change/bcapps/9044
object_type: page
object_id: 50
name: Purchase Order
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:
  - "24"
  - "25"
source_major: "29"
obsolete: null
countries:
  - ca
  - it
  - mx
  - us
ms_search_form_ids:
  - docs/learn-smb-docs/business-central/across-how-to-archive-documents.md
  - docs/learn-smb-docs/business-central/across-how-to-track-document-lines.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-to-eu3party-trade-purchase.md
  - docs/learn-smb-docs/business-central/finance-how-use-edocuments-purchase.md
  - docs/learn-smb-docs/business-central/finance-how-use-non-deductible-vat.md
  - docs/learn-smb-docs/business-central/finance-invoice-prepayments.md
  - docs/learn-smb-docs/business-central/finance-sustainability-journal.md
  - docs/learn-smb-docs/business-central/LocalFunctionality/UnitedStates/how-to-1099-use.md
  - docs/learn-smb-docs/business-central/LocalFunctionality/UnitedStates/set-up-use-irs1099-form.md
  - docs/learn-smb-docs/business-central/purchasing-how-purchase-products-sale.md
  - docs/learn-smb-docs/business-central/purchasing-how-record-purchases.md
  - docs/learn-smb-docs/business-central/quick-start-procurement.md
  - docs/learn-smb-docs/business-central/subcontract-order.md
  - docs/learn-smb-docs/business-central/value-chain-howto-purchase.md
counts:
  fields: 0
  procedures: 37
  events: 11
  subscribers: 0
  controls: 122
  actions: 59
relations:
  out: 1
  referenced_by: 0
  pages: 1
  extended_by: 8
  event_subscribers: 7
  calls: 20
  called_by: 14
  implements: 0
---

# Page 50 "Purchase Order"

> Page 50 "Purchase Order" in Base Application (Microsoft.Purchases.Document). 4 public procedures, 11 events. Present since at least BC23, still in BC30, changed in BC24-25.

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

## Properties

| Property | Value |
|---|---|
| Caption | Purchase Order |
| SourceTable | Purchase Header |
| PageType | Document |

## 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 |
|---|---|---|---|
| General | No. | [No.](../table/38.md#fields) | Specifies the number of the involved entry or record, according to the specified number series. |
|  | Vendor No. | [Buy-from Vendor No.](../table/38.md#fields) | Specifies the number of the vendor who delivers the products. |
|  | Vendor Name | [Buy-from Vendor Name](../table/38.md#fields) | Specifies the name of the vendor who delivers the products. |
|  | Vendor Name 2 | [Buy-from Vendor Name 2](../table/38.md#fields) | Specifies an additional part of the name of the vendor that you’re buying from. <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> |
| Buy-from | Address | [Buy-from Address](../table/38.md#fields) | Specifies the vendor's buy-from address. |
|  | Address 2 | [Buy-from Address 2](../table/38.md#fields) | Specifies an additional part of the vendor's buy-from address. |
|  | City | [Buy-from City](../table/38.md#fields) | Specifies the city of the vendor on the purchase document. <small>from the table field</small> |
| Control122 | Buy-from County | [Buy-from County](../table/38.md#fields) | Specifies the state, province or county of the address. <small>from the table field</small> |
| Buy-from | Post Code | [Buy-from Post Code](../table/38.md#fields) | Specifies the postal code. |
|  | Country/Region | [Buy-from Country/Region Code](../table/38.md#fields) | Specifies the country or region of the address. |
|  | Contact No. | [Buy-from Contact No.](../table/38.md#fields) | Specifies the number of contact person of the vendor's buy-from. |
|  | Phone No. | `BuyFromContact."Phone No."` | Specifies the telephone number of the vendor contact person. |
|  | Mobile Phone No. | `BuyFromContact."Mobile Phone No."` | Specifies the mobile telephone number of the vendor contact person. |
|  | Email | `BuyFromContact."E-Mail"` | Specifies the email address of the vendor contact person. |
| General | Contact | [Buy-from Contact](../table/38.md#fields) | Specifies the name of the person to contact about an order from this vendor. |
|  | Document Date | [Document Date](../table/38.md#fields) | Specifies the date when the related document was created. <small>from the table field</small> |
|  | Invoice Received Date | [Invoice Received Date](../table/38.md#fields) | Specifies the date when the related document was received. <small>from the table field</small> |
|  | Posting Date | [Posting Date](../table/38.md#fields) | Specifies the posting date of the record. |
|  | VAT Reporting Date | [VAT Reporting Date](../table/38.md#fields) | Specifies the date used to include entries on VAT reports in a VAT period. This is either the date that the document was created or posted, depending on your setting on the General Ledger Setup page. <small>from the table field</small> |
|  | Due Date | [Due Date](../table/38.md#fields) | Specifies when the related purchase invoice must be paid. |
|  | Vendor Invoice No. | [Vendor Invoice No.](../table/38.md#fields) | Specifies the document number of the original document you received from the vendor. You can require the document number for posting, or let it be optional. By default, it's required, so that this document references the original. Making document numbers optional removes a step from the posting proc... <small>from the table field</small> |
|  | Spend Request No. | [Spend Request No.](../table/38.md#fields) | Specifies the spend request that this purchase document relates to. <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> |
|  | Purchaser Code | [Purchaser Code](../table/38.md#fields) | Specifies which purchaser is assigned to the vendor. <small>from the table field</small> |
|  | No. of Archived Versions | [No. of Archived Versions](../table/38.md#fields) | Specifies the number of archived versions for this document. <small>from the table field</small> |
|  | Order Date | [Order Date](../table/38.md#fields) | Specifies the date the order was created. The order date is also used to determine the prices and discounts on the document. |
|  | Quote No. | [Quote No.](../table/38.md#fields) | Specifies the quote number for the purchase order. <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> |
|  | Vendor Shipment No. | [Vendor Shipment No.](../table/38.md#fields) | Specifies the vendor's shipment number. <small>from the table field</small> |
|  | Alternate Vendor Address Code | [Order Address Code](../table/38.md#fields) | Specifies the order address of the related vendor. <small>from the table field</small> |
|  | Responsibility Center | [Responsibility Center](../table/38.md#fields) | Specifies the code of the responsibility center, such as a distribution hub, that is associated with the involved user, company, customer, or 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> |
|  | 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> |
|  | 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> |
|  | Language Code | [Language Code](../table/38.md#fields) | Specifies the language to be used on printouts for this document. <small>from the table field</small> |
|  | Format Region | [Format Region](../table/38.md#fields) | Specifies the format to be used on printouts for this document. <small>from the table field</small> |
| Content | PurchLines | part [Page 54 "Purchase Order Subform"](../page/54.md) | — |
| Invoice Details | Currency Code | [Currency Code](../table/38.md#fields) | Specifies the currency of amounts on the purchase document. |
|  | Expected Receipt Date | [Expected Receipt Date](../table/38.md#fields) | 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. <small>from the table field</small> |
|  | Prices Including VAT | [Prices Including VAT](../table/38.md#fields) | Specifies if the Unit Price and Line Amount fields on document lines should be shown with or without VAT. <small>from the table field</small> |
|  | VAT Bus. Posting Group | [VAT Bus. Posting Group](../table/38.md#fields) | Specifies the VAT specification of the involved customer or vendor to link transactions made for this record with the appropriate general ledger account according to the VAT posting setup. <small>from the table field</small> |
|  | Vendor Posting Group | [Vendor Posting Group](../table/38.md#fields) | Specifies the vendor's market type to link business transactions to. <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> |
|  | 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> |
|  | 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> |
|  | 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> |
|  | Pmt. Discount Date | [Pmt. Discount Date](../table/38.md#fields) | Specifies the date on which the amount in the entry must be paid for a payment discount to be granted. <small>from the table field</small> |
|  | Journal Templ. Name | [Journal Templ. Name](../table/38.md#fields) | Specifies the name of the journal template in which the purchase header is to be posted. <small>from the table field</small> |
|  | Tax Liable | [Tax Liable](../table/38.md#fields) | Specifies if this vendor charges you sales tax for purchases. <small>from the table field</small> |
|  | Tax Area Code | [Tax Area Code](../table/38.md#fields) | Specifies the tax area code used for this purchase to calculate and post sales tax. <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> |
|  | Payment Reference | [Payment Reference](../table/38.md#fields) | Specifies the payment of the purchase invoice. <small>from the table field</small> |
|  | Creditor No. | [Creditor No.](../table/38.md#fields) | Specifies the number of the vendor. <small>from the table field</small> |
|  | On Hold | [On Hold](../table/38.md#fields) | Specifies that the related entry represents an unpaid invoice for which either a payment suggestion, a reminder, or a finance charge memo exists. <small>from the table field</small> |
|  | Inbound Whse. Handling Time | [Inbound Whse. Handling Time](../table/38.md#fields) | Specifies the time it takes to make items part of available inventory, after the items have been posted as received. <small>from the table field</small> |
|  | Lead Time Calculation | [Lead Time Calculation](../table/38.md#fields) | Specifies a date formula for the amount of time it takes to replenish the item. <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. |
|  | Promised Receipt Date | [Promised Receipt Date](../table/38.md#fields) | Specifies the date that the vendor has promised to deliver the order. <small>from the table field</small> |
|  | Receipt on Invoice | [Receipt on Invoice](../table/38.md#fields) | Specifies whether the receipt is posted on the invoice. |
| Control94 | Ship-to | `ShipToOptions` | Specifies the address that the products on the purchase document are shipped to. Default (Company Address): The same as the company address specified in the Company Information window. Location: One of the company's location addresses. Customer Address: Used in connection with drop shipment. Custom ... |
| Control101 | Customer | [Sell-to Customer No.](../table/38.md#fields) | Specifies the number of the customer that the items are shipped to directly from your vendor, as a drop shipment. <small>from the table field</small> |
|  | Ship-to Code | [Ship-to Code](../table/38.md#fields) | Specifies the code for another delivery address than the vendor's own address, which is entered by default. |
| Control98 | 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> |
| Control99 | Name | [Ship-to Name](../table/38.md#fields) | Specifies the name of the company at the address that you want the items on the purchase document to be shipped to. |
|  | Name 2 | [Ship-to Name 2](../table/38.md#fields) | Specifies an additional part of the name of the customer that items on the purchase order were shipped to, as a drop shipment. <small>from the table field</small> |
|  | Address | [Ship-to Address](../table/38.md#fields) | Specifies the address that you want the items on the purchase document to be shipped to. |
|  | Address 2 | [Ship-to Address 2](../table/38.md#fields) | Specifies additional address information. <small>from the table field</small> |
|  | City | [Ship-to City](../table/38.md#fields) | Specifies the city of the vendor on the purchase document. <small>from the table field</small> |
| Control124 | Ship-to County | [Ship-to County](../table/38.md#fields) | Specifies the state, province or county of the address. <small>from the table field</small> |
| Control99 | Post Code | [Ship-to Post Code](../table/38.md#fields) | Specifies the postal code of the address that you want the items on the purchase document to be shipped to. |
|  | Country/Region | [Ship-to Country/Region Code](../table/38.md#fields) | Specifies the country/region code of the address that you want the items on the purchase document to be shipped to. |
|  | Phone No. | [Ship-to Phone No.](../table/38.md#fields) | Specifies the telephone number of the company's shipping address. <small>from the table field</small> |
|  | Contact | [Ship-to Contact](../table/38.md#fields) | Specifies the name of a contact person for the address of the address that you want the items on the purchase document to be shipped to. |
| Control71 | Pay-to | `PayToOptions` | Specifies the vendor that the purchase document will be paid to. Default (Vendor): The same as the vendor on the purchase document. Another Vendor: Any vendor that you specify in the fields below. |
| Control95 | Name | [Pay-to Name](../table/38.md#fields) | Specifies the name of the vendor sending the invoice. |
|  | Name 2 | [Pay-to Name 2](../table/38.md#fields) | Specifies an additional part of the name of the vendor who you receive the invoice or credit memo from. <small>from the table field</small> |
|  | Address | [Pay-to Address](../table/38.md#fields) | Specifies the address of the vendor sending the invoice. <small>from the table field</small> |
|  | Address 2 | [Pay-to Address 2](../table/38.md#fields) | Specifies additional address information. <small>from the table field</small> |
|  | City | [Pay-to City](../table/38.md#fields) | Specifies the city of the vendor on the purchase document. <small>from the table field</small> |
| Control123 | Pay-to County | [Pay-to County](../table/38.md#fields) | Specifies the state, province or county of the address. <small>from the table field</small> |
| Control95 | Post Code | [Pay-to Post Code](../table/38.md#fields) | Specifies the postal code. |
|  | Country/Region | [Pay-to Country/Region Code](../table/38.md#fields) | Specifies the country/region code of the vendor on the purchase document. |
|  | Contact No. | [Pay-to Contact No.](../table/38.md#fields) | Specifies the number of contact person of the vendor's buy-from. |
|  | Contact | [Pay-to Contact](../table/38.md#fields) | Specifies the name of the person to contact about an order from this vendor. |
|  | Phone No. | `PayToContact."Phone No."` | Specifies the telephone number of the person to contact about an order from this vendor. |
|  | Mobile Phone No. | `PayToContact."Mobile Phone No."` | Specifies the mobile telephone number of the person to contact about an order from this vendor. |
|  | Email | `PayToContact."E-Mail"` | Specifies the email address of the person to contact about an order from this vendor. |
| Remit-to | Remit-to Code | [Remit-to Code](../table/38.md#fields) | Specifies the code for the vendor's remit address for this order. |
| Remit-to information | Name | `RemitAddressBuffer.Name` | Specifies the name of the company at the address that you want the order to be remitted to. |
|  | Address | `RemitAddressBuffer.Address` | Specifies the address that you want the items on the purchase document to be remitted to. |
|  | Address 2 | `RemitAddressBuffer."Address 2"` | Specifies additional address information. |
|  | City | `RemitAddressBuffer.City` | Specifies the city of the address that you want the items on the purchase document to be remitted to. |
| Remit-to County group | County | `RemitAddressBuffer.County` | Specifies the state, province or county of the address. |
| Remit-to information | Post Code | `RemitAddressBuffer."Post Code"` | Specifies the postal code of the address that you want the items on the purchase document to be remitted to. |
|  | Country/Region | `RemitAddressBuffer."Country/Region Code"` | Specifies the country/region code of the address that you want the items on the purchase document to be remitted to. |
|  | Contact | `RemitAddressBuffer.Contact` | Specifies the name of a contact person for the address that you want the items on the purchase document to be remitted to. |
| Foreign Trade | Transaction Specification | [Transaction Specification](../table/38.md#fields) | Specifies a specification of the document's transaction, for the purpose of reporting to INTRASTAT. <small>from the table field</small> |
|  | Transaction Type | [Transaction Type](../table/38.md#fields) | Specifies the type of transaction that the document represents, for the purpose of reporting to INTRASTAT. <small>from the table field</small> |
|  | Transport Method | [Transport Method](../table/38.md#fields) | Specifies the transport method, for the purpose of reporting to INTRASTAT. <small>from the table field</small> |
|  | Entry Point | [Entry Point](../table/38.md#fields) | Specifies the code of the port of entry where the items pass into your country/region, for reporting to Intrastat. <small>from the table field</small> |
|  | Area | [Area](../table/38.md#fields) | Specifies the destination country or region for the purpose of Intrastat reporting. <small>from the table field</small> |
| Prepayment | Prepayment % | [Prepayment %](../table/38.md#fields) | Specifies the prepayment percentage to use to calculate the prepayment for purchase. <small>from the table field</small> |
|  | Compress Prepayment | [Compress Prepayment](../table/38.md#fields) | Specifies that prepayments on the purchase order are combined if they have the same general ledger account for prepayments or the same dimensions. <small>from the table field</small> |
|  | Prepmt. Payment Terms Code | [Prepmt. Payment Terms Code](../table/38.md#fields) | Specifies the code that represents the payment terms for prepayment invoices related to the purchase document. <small>from the table field</small> |
|  | Prepayment Due Date | [Prepayment Due Date](../table/38.md#fields) | Specifies when the prepayment invoice for this purchase order is due. <small>from the table field</small> |
|  | Prepmt. Payment Discount % | [Prepmt. Payment Discount %](../table/38.md#fields) | Specifies the payment discount percent granted on the prepayment if the vendor pays on or before the date entered in the Prepmt. Pmt. Discount Date field. <small>from the table field</small> |
|  | Prepmt. Pmt. Discount Date | [Prepmt. Pmt. Discount Date](../table/38.md#fields) | Specifies the last date the vendor can pay the prepayment invoice and still receive a payment discount on the prepayment amount. <small>from the table field</small> |
|  | Vendor Cr. Memo No. | [Vendor Cr. Memo No.](../table/38.md#fields) | Specifies the number that the vendor uses for the purchase order. |
| FactBoxes | Document Check | part [Page 9118 "Purch. Doc. Check Factbox"](../page/9118.md) | — |
|  | Documents | part [Page 1178 "Doc. Attachment List Factbox"](../page/1178.md) | — |
|  | Control23 | part [Page 9103 "Pending Approval FactBox"](../page/9103.md) | — |
|  | Control1903326807 | part [Page 9090 "Item Replenishment FactBox"](../page/9090.md) | — |
|  | ApprovalFactBox | part [Page 9092 "Approval FactBox"](../page/9092.md) | — |
|  | Control1901138007 | part [Page 9093 "Vendor Details FactBox"](../page/9093.md) | — |
|  | Control1904651607 | part [Page 9094 "Vendor Statistics FactBox"](../page/9094.md) | — |
|  | IncomingDocAttachFactBox | part [Page 193 "Incoming Doc. Attach. FactBox"](../page/193.md) | — |
|  | Control1903435607 | part [Page 9095 "Vendor Hist. Buy-from FactBox"](../page/9095.md) | — |
|  | Control1906949207 | part [Page 9096 "Vendor Hist. Pay-to FactBox"](../page/9096.md) | — |
|  | Control3 | part [Page 9100 "Purchase Line FactBox"](../page/9100.md) | — |
|  | WorkflowStatus | part [Page 1528 "Workflow Status FactBox"](../page/1528.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 | View or edit detailed information about the vendor on the purchase document. | [Page 26 "Vendor Card"](../page/26.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) |
|  | Attachments | Add a file as an attachment. You can attach images as well as documents. |  |
| 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) |
| Drop Shipment | Get Sales Order | Select the sales order that must be linked to the purchase order, for drop shipment or special order. | [Codeunit 76 "Purch.-Get Drop Shpt."](../codeunit/76.md) |
| Special Order | Get Sales Order | Select the sales order that must be linked to the purchase order, for drop shipment or special order. |  |
| Approval | Approve | Approve the requested changes. |  |
|  | Reject | Reject the requested changes. |  |
|  | Delegate | Delegate the requested changes to the substitute approver. |  |
|  | Comments | View or add comments for the record. |  |
| 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 | Calculate Invoice Discount | Calculate the discount that can be granted based on all lines in the purchase document. |  |
|  | Get Recurring Purchase Lines | Insert purchase document lines that you have set up for the vendor as recurring. Recurring purchase lines could be for a monthly replenishment order or a fixed freight expense. |  |
|  | Create Tracking Information | Create item tracking information for the entire purchase order. |  |
|  | Copy Document | Copy document lines and header information from another purchase document to this document. You can copy a posted purchase invoice into a new purchase invoice to quickly create a similar document. |  |
|  | Move Negative Lines | Prepare to create a replacement purchase order in a purchase return process. |  |
| Drop Shipment | Get Sales Order | Select the sales order that must be linked to the purchase order, for drop shipment or special order. | [Codeunit 76 "Purch.-Get Drop Shpt."](../codeunit/76.md) |
| Special Order | Get Sales Order | Select the sales order that must be linked to the purchase order, for drop shipment or special order. |  |
| Functions | Archive Document | Send the document to the archive, for example because it is too soon to delete it. Later, you delete or reprocess the archived document. |  |
|  | Send Intercompany Purchase Order | Send the purchase order to the intercompany outbox or directly to the intercompany partner if automatic transaction sending is enabled. |  |
|  | Reject IC Purchase Order | Deletes the order and sends the rejection to the company that created it. |  |
| Incoming Document | View Incoming Document | View any incoming document records and file attachments that exist for the entry or document, for example for auditing purposes |  |
|  | Select Incoming Document | Select an incoming document record and file attachment that you want to link to the entry or document. |  |
|  | Create Incoming Document from File | Create an incoming document from a file that you select from the disk. The file will be attached to the incoming document record. |  |
|  | Remove Incoming Document | Remove any incoming document records and file attachments. |  |
| Request Approval | Send Approval Request | Request approval of the document. |  |
|  | Cancel Approval Request | Cancel the approval request. |  |
| Power Automate | Create approval flow | Create a new flow in Power Automate from a list of relevant flow templates. |  |
| 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 | 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 and New | Post the purchase document and create a new, empty one. |  |
|  | 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 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. |  |
| Prepayment | Prepayment Test Report | Preview the prepayment transactions that will results from posting the purchase document as invoiced. |  |
|  | Post Prepayment Invoice | Post the specified prepayment information. |  |
|  | Post and Print Prepmt. Invoice | Post the specified prepayment information and print the related report. |  |
|  | Preview Prepmt. Invoice Posting | Review the different types of entries that will be created when you post the prepayment invoice. |  |
|  | Post Prepayment Credit Memo | Create and post a credit memo for the specified prepayment information. |  |
|  | Post and Print Prepmt. Cr. Memo | Create and post a credit memo for the specified prepayment information and print the related report. |  |
|  | Preview Prepmt. Cr. Memo Posting | Review the different types of entries that will be created when you post the prepayment credit memo. |  |
| 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. |  |

## Events published

- `OnAfterCalculateCurrentShippingAndPayToOption(var ShipToOptions: Option "Default (Company Address)",Location,"Customer Address","Custom Address"; var PayToOptions: Option "Default (Vendor)","Another Vendor","Custom Address"; PurchaseHeader: Record "Purchase Header")` (integration)
- `OnAfterOnAfterGetRecord(var PurchaseHeader: Record "Purchase Header")` (integration)
  - subscribers: [Codeunit 9070 "Document Errors Mgt."](../codeunit/9070.md) OnAfterOnAfterGetRecordPurchaseOrder
- `OnPostDocumentOnBeforePurchaseHeaderInsert(var PurchaseHeader: Record "Purchase Header")` (integration)
- `OnPostDocumentBeforeNavigateAfterPosting(var PurchaseHeader: Record "Purchase Header"; var PostingCodeunitID: Integer; var Navigate: Enum "Navigate After Posting"; var DocumentIsPosted: Boolean; var IsHandled: Boolean)` (integration)
- `OnQueryClosePageOnAfterCalcShowConfirmCloseUnposted(var PurchaseHeader: Record "Purchase Header"; var ShowConfirmCloseUnposted: Boolean)` (integration)
- `OnAfterSetOpenPage()` (integration)
- `OnAfterSetControlAppearance()` (integration)
- `OnBeforeValidateShippingOption(var PurchaseHeader: Record "Purchase Header"; ShipToOptions: Option "Default (Company Address)",Location,"Customer Address","Custom Address"; var IsHandled: Boolean)` (integration)
- `OnBeforeCalculateCurrentShippingAndPayToOption(var PurchaseHeader: Record "Purchase Header"; var ShipToOptions: Option "Default (Company Address)",Location,"Customer Address","Custom Address"; var PayToOptions: Option "Default (Vendor)","Another Vendor","Custom Address"; var IsHandled: Boolean)` (integration)
- `OnBeforeCurrencyCodeOnAssistEdit(var PurchaseHeader: Record "Purchase Header"; xPurchaseHeader: Record "Purchase Header"; var IsHandled: Boolean)` (integration)
- `OnPostDocumentOnAfterCalcDocumentIsScheduledForPosting(var PurchaseHeader: Record "Purchase Header"; var DocumentIsScheduledForPosting: Boolean; var DocumentIsPosted: Boolean)` (integration)

## Trigger event subscribers

- OnAfterGetCurrRecordEvent: [Codeunit 1854 "Sales Forecast Notifier"](../codeunit/1854.md) OnAfterCurrPurchaseOrder
- OnAfterValidateEvent(Buy-from Vendor Name): [Codeunit 170 "Standard Codes Mgt."](../codeunit/170.md) OnAfterValidatePurchaseOrderSellToVendorName
- OnAfterValidateEvent(Buy-from Vendor No.): [Codeunit 170 "Standard Codes Mgt."](../codeunit/170.md) OnAfterValidatePurchaseOrderSellToVendorNo
- OnClosePageEvent: [Codeunit 1508 "Notification Lifecycle Handler"](../codeunit/1508.md) OnClosePurchaseOrder
- OnModifyRecordEvent: [Codeunit 9070 "Document Errors Mgt."](../codeunit/9070.md) OnModifyRecordEventPurchaseOrder
- OnOpenPageEvent: [Codeunit 1508 "Notification Lifecycle Handler"](../codeunit/1508.md) OnOpenPurchaseOrder

## Procedures

- `CallPostDocument(PostingCodeunitID: Integer; Navigate: Enum "Navigate After Posting")`
- `SaveInvoiceDiscountAmount()` (protected)
- `RunBackgroundCheck()`
- `SetPostingGroupEditable()`

Plus 22 local procedures.

## Triggers

OnAfterGetCurrRecord, OnAfterGetRecord, OnDeleteRecord, OnInit, OnNewRecord, OnInsertRecord, OnOpenPage, OnQueryClosePage

## Relations

- source table [Table 38 "Purchase Header"](../table/38.md)

## Pages and codeunits on this table

- [Page 9307 "Purchase Order List"](../page/9307.md) (card page)

## Extended by

- [Page extension 1856 "PurchaseOrderForecastExtension"](../pageextension/1856.md)
- [Page extension 20251 "Purchase Order Ext"](../pageextension/20251.md)
- [Page extension 20523 "Subc. Purch. Order"](../pageextension/20523.md)
- [Page extension 4887 "EU3 Purch. Order"](../pageextension/4887.md)
- [Page extension 5038 "SD Purchase Order"](../pageextension/5038.md)
- [Page extension 5593 "Digital Voucher Purch. Order"](../pageextension/5593.md)
- [Page extension 6132 "E-Doc. Purchase Order"](../pageextension/6132.md)
- [Page extension 6796 "Withholding Purchase Order"](../pageextension/6796.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 1330 "Instruction Mgt."](../codeunit/1330.md) (6 calls: `OnQueryClosePage → ShowConfirmUnreleased`, `PostDocument → IsEnabled`, `PostDocument → ShowPostedConfirmationMessageCode`, …)
- [Codeunit 1535 "Approvals Mgmt."](../codeunit/1535.md) (3 calls: `SetControlAppearance → CanCancelApprovalForRecord`, `SetControlAppearance → HasOpenApprovalEntries`, `SetControlAppearance → HasOpenApprovalEntriesForCurrentUser`)
- [Codeunit 427 "ICInboxOutboxMgt"](../codeunit/427.md) (3 calls: `OnAfterGetRecord → IsPurchaseHeaderFromIncomingIC`, `OnOpenPage → IsPurchaseHeaderFromIncomingIC`, `OnOpenPage → ShowDuplicateICDocumentWarning`)
- [Codeunit 109 "Lookup State Manager"](../codeunit/109.md) (2 calls: `OnNewRecord → ClearSavedRecord`, `OnNewRecord → IsRecordSaved`)
- [Codeunit 365 "Format Address"](../codeunit/365.md) (2 calls: `ActivateFields → UseCounty`, `FillRemitToFields → VendorRemitToAddress`)
- [Codeunit 445 "Purch.-Post Prepmt. (Yes/No)"](../codeunit/445.md) (2 calls: `ShowPrepmtCrMemoPreview → Preview`, `ShowPrepmtInvoicePreview → Preview`)
- [Codeunit 9070 "Document Errors Mgt."](../codeunit/9070.md) (2 calls: `CheckShowBackgrValidationNotification → CheckShowEnableBackgrValidationNotification`, `SetControlAppearance → BackgroundValidationEnabled`)
- [Codeunit 9179 "Application Area Mgmt. Facade"](../codeunit/9179.md) (2 calls: `OnInit → IsAllDisabled`, `OnInit → IsLocationEnabled`)
- [Codeunit 1320 "Lines Instruction Mgt."](../codeunit/1320.md) (1 call: `PostDocument → PurchaseCheckAllLinesHaveQuantityAssigned`)
- [Codeunit 1400 "DocumentNoVisibility"](../codeunit/1400.md) (1 call: `SetDocNoVisible → PurchaseDocumentNoIsVisible`)
- [Codeunit 1543 "Workflow Webhook Management"](../codeunit/1543.md) (1 call: `SetControlAppearance → GetCanRequestAndCanCancel`)
- [Codeunit 1563 "Privacy Notice"](../codeunit/1563.md) (1 call: `OnInit → GetPrivacyNoticeApprovalState`)
- [Codeunit 404 "IC Feedback"](../codeunit/404.md) (1 call: `ShowPostedConfirmationMessage → ShowIntercompanyMessage`)
- [Codeunit 457 "Environment Information"](../codeunit/457.md) (1 call: `SetOpenPage → IsSaaS`)
- [Codeunit 57 "Document Totals"](../codeunit/57.md) (1 call: `SaveInvoiceDiscountAmount → PurchaseRedistributeInvoiceDiscountAmountsOnDocument`)
- [Codeunit 5700 "User Setup Management"](../codeunit/5700.md) (1 call: `OnNewRecord → GetPurchasesFilter`)
- [Codeunit 6400 "Flow Service Management"](../codeunit/6400.md) (1 call: `OnInit → GetPowerAutomatePrivacyNoticeId`)
- [Codeunit 799 "VAT Reporting Date Mgt"](../codeunit/799.md) (1 call: `OnOpenPage → IsVATDateEnabled`)
- [Codeunit 8510 "Over-Receipt Mgt."](../codeunit/8510.md) (1 call: `ShowOverReceiptNotification → ShowOverReceiptNotificationFromOrder`)
- [Codeunit 91 "Purch.-Post (Yes/No)"](../codeunit/91.md) (1 call: `ShowPreview → Preview`)

## Called by

- [Codeunit 5992 "Purchases Warehouse Mgt."](../codeunit/5992.md) (2 calls: `OnShowSourceDocCard → (object)`, `OnShowSourceDocumentCard → (object)`)
- [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)`)
- [Codeunit 1324 "Correct PstdPurchInv (Yes/No)"](../codeunit/1324.md) (1 call: `CancelPostedInvoiceAndOpenPurchaseOrder → (object)`)
- [Codeunit 1637 "Office Document Handler"](../codeunit/1637.md) (1 call: `OpenIndividualPurchaseDocument → (object)`)
- [Codeunit 1854 "Sales Forecast Notifier"](../codeunit/1854.md) (1 call: `CreateAndShowPurchaseDocument → (object)`)
- [Codeunit 5530 "Calc. Item Availability"](../codeunit/5530.md) (1 call: `RunPurchHeaderPage → (object)`)
- [Codeunit 5826 "Matched Order Line Mgmt."](../codeunit/5826.md) (1 call: `ShowPurchaseInvoiceDocument → (object)`)
- [Codeunit 6620 "Copy Document Mgt."](../codeunit/6620.md) (1 call: `ShowPurchDoc → (object)`)
- [Codeunit 93 "Purch.-Quote to Order (Yes/No)"](../codeunit/93.md) (1 call: `OnRun → (object)`)
- [Codeunit 99000834 "Purch. Line-Reserve"](../codeunit/99000834.md) (1 call: `OnLookupDocument → (object)`)
- [Page 1872 "Item Availability Check"](../page/1872.md) (1 call: `ShowNewPurchaseDocument → (object)`)
- [Table 23 "Vendor"](../table/23.md) (1 call: `CreateAndShowNewPurchaseOrder → (object)`)
- [Table 246 "Requisition Line"](../table/246.md) (1 call: `LookupRefOrderNo → (object)`)

## Recent changes

- 2026-07-31 [#8959 Deliverable 638799: Spend Requests in Base App](../../changes/bcapps/8959.md) (main, BC30, feature)
- 2026-07-15 [#9044 [Master] Contact email is no validated during creation purchase documents_New](../../changes/bcapps/9044.md) (main, BC30, fix)

## Across versions

- Present in: BC23-30
- Changed (declaration) in: BC24-25

## Countries that replace it

[CA](../../localizations/ca.md), [IT](../../localizations/it.md), [MX](../../localizations/mx.md), [US](../../localizations/us.md)

## Documented on Microsoft Learn

- [Archive sales, purchase, project, and service documents](https://learn.microsoft.com/dynamics365/business-central/across-how-to-archive-documents)
- [Track order lines to related documents](https://learn.microsoft.com/dynamics365/business-central/across-how-to-track-document-lines)
- [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)
- [EU third-party purchase transactions](https://learn.microsoft.com/dynamics365/business-central/finance-how-to-eu3party-trade-purchase)
- [Use E-Documents in the purchase process](https://learn.microsoft.com/dynamics365/business-central/finance-how-use-edocuments-purchase)
- [Use non-deductible VAT](https://learn.microsoft.com/dynamics365/business-central/finance-how-use-non-deductible-vat)
- [Invoice prepayments](https://learn.microsoft.com/dynamics365/business-central/finance-invoice-prepayments)
- [Record sustainability entries](https://learn.microsoft.com/dynamics365/business-central/finance-sustainability-journal)
- [Track data and use the IRS 1099 form](https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/how-to-1099-use)
- [Set up and use the IRS 1099 form [US]](https://learn.microsoft.com/dynamics365/business-central/LocalFunctionality/UnitedStates/set-up-use-irs1099-form)
- [Purchase items for a sale](https://learn.microsoft.com/dynamics365/business-central/purchasing-how-purchase-products-sale)
- [Record purchases with purchase invoices](https://learn.microsoft.com/dynamics365/business-central/purchasing-how-record-purchases)
- [Procurement Quick Start](https://learn.microsoft.com/dynamics365/business-central/quick-start-procurement)
- [Order subcontracting](https://learn.microsoft.com/dynamics365/business-central/subcontract-order)
- [Sustainability value chain in purchasing](https://learn.microsoft.com/dynamics365/business-central/value-chain-howto-purchase)

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