pagePurchasing & Payablesofficial - Microsoftderived - from the source, no model text

Page 6640 "Purchase Return Order"

Base Application · Microsoft.Purchases.Document

88controls
43actions
23procedures
6events
3Learn pages
1countries replace it
2event subscribers
9objects it calls
4objects call it

Across versions

BC23-24present
BC251 events added
BC26-30unchanged

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

Properties

Property	Value
Caption	Purchase Return 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.	Specifies the number of the involved entry or record, according to the specified number series.
	Vendor No.	Buy-from Vendor No.	Specifies the number of the vendor who returns the products.
	Vendor Name	Buy-from Vendor Name	Specifies the name of the vendor who returns the products.
	Vendor Name 2	Buy-from Vendor Name 2	Specifies an additional part of the name of the vendor that you’re buying from. from the table field
Buy-from	Address	Buy-from Address	Specifies the vendor’s buy-from address.
	Address 2	Buy-from Address 2	Specifies an additional part of the vendor’s buy-from address.
	City	Buy-from City	Specifies the city of the vendor on the purchase document. from the table field
Control69	Buy-from County	Buy-from County	Specifies the county of the address.
Buy-from	Post Code	Buy-from Post Code	Specifies the postal code.
	Country/Region	Buy-from Country/Region Code	Specifies the country or region of the address.
	Contact No.	Buy-from Contact No.	Specifies the number of your contact at the vendor. from the table field
	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	Specifies the name of the vendor contact person.
	Document Date	Document Date	Specifies the date when the related document was created. from the table field
	Posting Date	Posting Date	Specifies the posting date of the record.
	VAT Reporting Date	VAT Reporting Date	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. from the table field
	No. of Archived Versions	No. of Archived Versions	Specifies the number of archived versions for this document. from the table field
	Order Date	Order Date	Specifies the date when the order was created. from the table field
	Vendor Authorization No.	Vendor Authorization No.	Specifies the identification number of a compensation agreement. This number is sometimes referred to as the RMA No.(Returns Materials Authorization).
	Vendor Cr. Memo No.	Vendor Cr. Memo No.	Specifies the number that the vendor uses for the credit memo you are creating in this purchase return order.
	Purchaser Code	Purchaser Code	Specifies which purchaser is assigned to the vendor. from the table field
	Campaign No.	Campaign No.	Specifies the campaign number the document is linked to. from the table field
	Responsibility Center	Responsibility Center	Specifies the code of the responsibility center, such as a distribution hub, that is associated with the involved user, company, customer, or vendor. from the table field
	Assigned User ID	Assigned User ID	Specifies the ID of the user who is responsible for the document. from the table field
	Job Queue Status	Job Queue Status	Specifies the status of a job queue entry that handles the posting of purchase return orders.
	Status	Status	Specifies whether the document is open, released, pending approval, or pending prepayment.
	Language Code	Language Code	Specifies the language to be used on printouts for this document. from the table field
	Format Region	Format Region	Specifies the format to be used on printouts for this document. from the table field
Content	PurchLines	part Page 6641 “Purchase Return Order Subform”	—
Invoice Details	Currency Code	Currency Code	Specifies the currency that is used on the entry.
	Expected Receipt Date	Expected Receipt Date	Specifies the date you expect the items to be available in your warehouse. If you leave the field blank, it will be calculated as follows: Planned Receipt Date + Safety Lead Time + Inbound Warehouse Handling Time = Expected Receipt Date. from the table field
	Prices Including VAT	Prices Including VAT	Specifies if the Unit Price and Line Amount fields on document lines should be shown with or without VAT. from the table field
	VAT Bus. Posting Group	VAT Bus. Posting Group	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. from the table field
	Vendor Posting Group	Vendor Posting Group	Specifies the vendor’s market type to link business transactions to. from the table field
	Payment Terms Code	Payment Terms Code	Specifies a formula that calculates the payment due date, payment discount date, and payment discount amount. from the table field
	Payment Method Code	Payment Method Code	Specifies how to make payment, such as with bank transfer, cash, or check. 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
	Location Code	Location Code	Specifies the code for the location from where the items are shipped. 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 Responsibilit…
	Applies-to Doc. Type	Applies-to Doc. Type	Specifies the type of the posted document that this document or journal line will be applied to when you post, for example to register payment. from the table field
	Applies-to Doc. No.	Applies-to Doc. No.	Specifies the number of the posted document that this document or journal line will be applied to when you post, for example to register payment. from the table field
	Applies-to ID	Applies-to ID	Specifies the ID of entries that will be applied to when you choose the Apply Entries action. from the table field
	Journal Templ. Name	Journal Templ. Name	Specifies the name of the journal template in which the purchase header is to be posted. from the table field
	Tax Liable	Tax Liable	Specifies that purchases from the vendor on the purchase header are liable for sales tax.
	Tax Area Code	Tax Area Code	Specifies the tax area code used for this purchase to calculate and post sales tax. from the table field
Control45	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. Custom Address: Any ship-to address that you specify in the fiel…
Control48	Alternate Vendor Address Code	Order Address Code	Specifies the order address of the related vendor. from the table field
Control62	Name	Ship-to Name	Specifies the name of the vendor sending the order.
	Name 2	Ship-to Name 2	Specifies an additional part of the name for the order address of the vendor.
	Address	Ship-to Address	Specifies the vendor’s buy-from address.
	Address 2	Ship-to Address 2	Specifies an additional part of the vendor’s buy-from address.
	City	Ship-to City	Specifies the city of the vendor on the purchase document. from the table field
Control174	Ship-to County	Ship-to County	Specifies the county of the address.
Control62	Post Code	Ship-to Post Code	Specifies the postal code.
	Country/Region Code	Ship-to Country/Region Code	Specifies the country or region of the address.
	Phone No.	Ship-to Phone No.	Specifies the telephone number of the company’s shipping address. from the table field
	Contact	Ship-to Contact	Specifies the name of the vendor contact person.
Pay-to	Name	Pay-to Name	Specifies the name of the vendor sending the order.
	Name 2	Pay-to Name 2	Specifies an additional part of the name of the vendor who you receive the invoice or credit memo from. from the table field
	Address	Pay-to Address	Specifies the vendor’s buy-from address.
	Address 2	Pay-to Address 2	Specifies an additional part of the vendor’s buy-from address.
	City	Pay-to City	Specifies the city of the vendor on the purchase document. from the table field
Control79	Pay-to County	Pay-to County	Specifies the county of the address.
Pay-to	Post Code	Pay-to Post Code	Specifies the postal code.
	Country/Region	Pay-to Country/Region Code	Specifies the country or region of the address.
	Contact No.	Pay-to Contact No.	Specifies the number of the contact who sends the invoice. from the table field
	Phone No.	`PayToContact."Phone No."`	Specifies the telephone number of the vendor contact person.
	Mobile Phone No.	`PayToContact."Mobile Phone No."`	Specifies the mobile telephone number of the vendor contact person.
	Email	`PayToContact."E-Mail"`	Specifies the email address of the vendor contact person.
	Contact	Pay-to Contact	Specifies the name of the vendor contact person.
Foreign Trade	Transaction Specification	Transaction Specification	Specifies a specification of the document’s transaction, for the purpose of reporting to INTRASTAT. from the table field
	Transaction Type	Transaction Type	Specifies the type of transaction that the document represents, for the purpose of reporting to INTRASTAT. from the table field
	Transport Method	Transport Method	Specifies the transport method, for the purpose of reporting to INTRASTAT. from the table field
	Entry Point	Entry Point	Specifies the code of the port of entry where the items pass into your country/region, for reporting to Intrastat. from the table field
	Area	Area	Specifies the destination country or region for the purpose of Intrastat reporting. from the table field
FactBoxes	Document Check	part Page 9118 “Purch. Doc. Check Factbox”	—
	Documents	part Page 1178 “Doc. Attachment List Factbox”	—
	Control21	part Page 9103 “Pending Approval FactBox”	—
	ApprovalFactBox	part Page 9092 “Approval FactBox”	—
	Control1901138007	part Page 9093 “Vendor Details FactBox”	—
	Control1904651607	part Page 9094 “Vendor Statistics FactBox”	—
	IncomingDocAttachFactBox	part Page 193 “Incoming Doc. Attach. FactBox”	—
	Control1903435607	part Page 9095 “Vendor Hist. Buy-from FactBox”	—
	Control1906949207	part Page 9096 “Vendor Hist. Pay-to FactBox”	—
	Control3	part Page 9100 “Purchase Line FactBox”	—
	WorkflowStatus	part Page 1528 “Workflow Status FactBox”	—

Actions

Group	Action	ToolTip	Runs
Return Order	Statistics	View statistical information, such as the value of posted entries, for the record.	Page 403 “Purchase Order Statistics”
	Vendor	View or edit detailed information about the vendor on the purchase document.	Page 26 “Vendor Card”
	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”
	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.
	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”
Documents	Return Shipments	Open the posted return shipments related to this order.	Page 6652 “Posted Return Shipments”
	Credit Memos	View a list of ongoing credit memos for the order.
Warehouse	Warehouse Shipment Lines	View ongoing warehouse shipments for the document, in advanced warehouse configurations.	Page 7341 “Whse. Shipment Lines”
	Invt. Put-away/Pick Lines	View items that are inbound or outbound on inventory put-away or inventory pick documents for the purchase return order.	Page 5774 “Warehouse Activity List”
	Warehouse Pick Lines	View ongoing warehouse picks for the document, in advanced warehouse configurations.	Page 5785 “Warehouse Activity Lines”
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.
Processing	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	Get Posted Document Lines to Reverse	Copy one or more posted purchase document lines in order to reverse the original order.
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.
Functions	Apply Entries	Apply open entries for the relevant account type.
	Calculate Invoice Discount	Calculate the discount that can be granted based on all lines in the purchase document.
	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.
	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 IC Return Order	Prepare to send the return order to an intercompany partner.
Request Approval	Send Approval Request	Request approval of the document.
	Cancel Approval Request	Cancel the approval request.
Warehouse	Create Warehouse Shipment	Create a warehouse shipment to start a pick a ship 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.
	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 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.
	Attachments	Add a file as an attachment. You can attach images as well as documents.

Events published

OnAfterOnAfterGetRecord(var PurchaseHeader: Record "Purchase Header") (integration)
- subscribers: Codeunit 9070 “Document Errors Mgt.” OnAfterOnAfterGetRecordPurchaseReturnOrder
OnBeforeValidateShipToOptions(var PurchaseHeader: Record "Purchase Header"; ShipToOptions: Option) (integration)
OnAfterValidateShipToOptions(var PurchaseHeader: Record "Purchase Header"; ShipToOptions: Option) (integration)
OnPostDocumentBeforeNavigateAfterPosting(var PurchaseHeader: Record "Purchase Header"; var PostingCodeunitID: Integer; DocumentIsPosted: Boolean; var IsHandled: Boolean) (integration)
OnQueryClosePageOnAfterCalcShowConfirmCloseUnposted(var PurchaseHeader: Record "Purchase Header"; var ShowConfirmCloseUnposted: Boolean) (integration)
OnPostDocumentOnAfterCalcDocumentIsScheduledForPosting(var PurchaseHeader: Record "Purchase Header"; var DocumentIsScheduledForPosting: Boolean; var DocumentIsPosted: Boolean) + BC25 (integration)

Trigger event subscribers

OnModifyRecordEvent: Codeunit 9070 “Document Errors Mgt.” OnModifyRecordEventPurchaseReturnOrder

Procedures

CallPostDocument(PostingCodeunitID: Integer)
RunBackgroundCheck()
SetPostingGroupEditable()

Plus 14 local procedures.

Triggers

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

Relations

source table Table 38 “Purchase Header”

Pages and codeunits on this table

Page 9311 “Purchase Return Order List” (card page)

Extended by

Calls

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

Codeunit 1330 “Instruction Mgt.” (5 calls: PostDocument → IsEnabled, PostDocument → ShowPostedConfirmationMessageCode, ShowPostedConfirmationMessage → ShowConfirm, …)
Codeunit 1535 “Approvals Mgmt.” (3 calls: SetControlAppearance → CanCancelApprovalForRecord, SetControlAppearance → HasOpenApprovalEntries, SetControlAppearance → HasOpenApprovalEntriesForCurrentUser)
Codeunit 9070 “Document Errors Mgt.” (2 calls: CheckShowBackgrValidationNotification → CheckShowEnableBackgrValidationNotification, SetControlAppearance → BackgroundValidationEnabled)
Codeunit 1320 “Lines Instruction Mgt.” (1 call: PostDocument → PurchaseCheckAllLinesHaveQuantityAssigned)
Codeunit 1400 “DocumentNoVisibility” (1 call: SetDocNoVisible → PurchaseDocumentNoIsVisible)
Codeunit 365 “Format Address” (1 call: ActivateFields → UseCounty)
Codeunit 57 “Document Totals” (1 call: SaveInvoiceDiscountAmount → PurchaseRedistributeInvoiceDiscountAmountsOnDocument)
Codeunit 5700 “User Setup Management” (1 call: OnNewRecord → GetPurchasesFilter)
Codeunit 799 “VAT Reporting Date Mgt” (1 call: OnOpenPage → IsVATDateEnabled)

Called by

Codeunit 5992 “Purchases Warehouse Mgt.” (2 calls: OnShowSourceDocCard → (object), OnShowSourceDocumentCard → (object))
Codeunit 5530 “Calc. Item Availability” (1 call: RunPurchHeaderPage → (object))
Codeunit 6620 “Copy Document Mgt.” (1 call: ShowPurchDoc → (object))
Codeunit 99000834 “Purch. Line-Reserve” (1 call: OnLookupDocument → (object))

Recent changes

2026-07-15 #9044 [Master] Contact email is no validated during creation purchase documents_New (main, BC30, fix)

Countries that replace it

Documented on Microsoft Learn

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

Evidence 4 sources

In the galaxy

Neighbourhood

8 links in the explorer →

Provenance

Tier: official
Review: derived
Generated: 2026-10-11
Pipeline: 0.2.0
Input: c8df88fb9173
Id: object/page/6640