---
schema_version: "1"
id: f5f72fd046323b61408047de74a46d492f428d1fb02db26e55fa5fcb37123407
title: PurchaseOrder
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/mfg_api_devguide/sforce_api_objects_purchaseorder.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.mfg_api_devguide.meta/mfg_api_devguide/sforce_api_objects_purchaseorder.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 0ffe60c55ea1b5e0e0807f861fd722bfcf493a2e3e81951ee7a37cb785619c29
description: Represents the Purchase Order entity that captures a formal request from a Buyer to a Supplier to supply goods or services. It is identified by a unique PurchaseOrderNumber and tracks the order's lifecycle via a StatusCode. It defines commercial terms like the TotalAmount, BillingAccount, and the governing PriceBook. This object is available in API version 65.0 and later.
---
# PurchaseOrder

Represents the Purchase Order entity that captures a formal request from a Buyer to a Supplier to supply goods or services. It is identified by a unique PurchaseOrderNumber and tracks the order's lifecycle via a StatusCode. It defines commercial terms like the TotalAmount, BillingAccount, and the governing PriceBook. This object is available in API version 65.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### PurchaseOrderNumber

- **Type**: autonumber
- **Properties**: Filter, Group, idLookup, Sort
- **Description**: A unique identifier for the purchase order.

### PurchaseOrderDate

- **Type**: datetime
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The date and time when the purchase order was created.

### PurchaseOrderType

- **Type**: picklist
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The type of the purchase order such as standard, blanket, and contract.
- **Possible values**:
    - Standard Purchase Order
    - Blanket Purchase Order

### BuyerAccount

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The buyer account that initiated the purchase order.
    
    This field is a relationship field.
- **Relationship Name**: BuyerAccount
- **Refers To**: Account

### SupplierAccount

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The supplier account that received the purchase order.
    
    This field is a relationship field.
- **Relationship Name**: SupplierAccount
- **Refers To**: Account

### BuyerContact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The primary contact person associated with the buyer account.
    
    This field is a relationship field.
- **Relationship Name**: BuyerContact
- **Refers To**: Contact

### SupplierContact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The primary contact person associated with the supplier account.
    
    This field is a relationship field.
- **Relationship Name**: SupplierContact
- **Refers To**: Contact

### StatusCode

- **Type**: picklist
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The current status of the product in the purchase order.
- **Possible values**:
    - Approved
    - AwaitingApproval
    - Cancelled
    - Closed
    - Delivered
    - Draft
    - Invoiced
    - PartiallyReceived
    - Received
    - Shipped
    - Submitted

### BillingAccount

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The account to which invoices are issued for the purchase order.
    
    This field is a relationship field.
- **Relationship Name**: BillingAccount
- **Refers To**: Account

### BillToContact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The contact associated with the billing account.
    
    This field is a relationship field.
- **Relationship Name**: BillToContact
- **Refers To**: Contact

### PriceBook

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The price book that specifies the item prices applicable to the purchase order.
    
    This field is a relationship field.

### AdditionalInfo

- **Type**: text
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Additional notes or remarks related to the purchase order.

### TotalAmount

- **Type**: text
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Sum of all total amounts from the PO Lines.

### ExternalPurchaseOrderNumber

- **Type**: text
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The reference number associated with the purchase order.

### UsageType

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: Specify the context in which the Purchase Order is created.
- **Possible values**:
    - DistributorManagement
    - PurchaseOrderManagement

### RequestedDeliveryDate

- **Type**: datetime
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The requested delivery date for the product.

### ShippingLocation

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The location to which the product is to be shipped.
    
    This field is a relationship field.

### ShippingAddress

- **Type**: address
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The address to which the product is to be shipped.

### ShipToContact

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The contact associated with the shipping location.
    
    This field is a relationship field.

### ShipToAccount

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The account associated with the shipping location.
    
    This field is a relationship field.