---
schema_version: "1"
id: 93f7945b76d8885aa30cce428fb44063decf8ce50010dff58b3cb6c0205d7b51
title: PurchaseOrderItem
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/mfg_api_devguide/sforce_api_objects_purchaseorderitem.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.mfg_api_devguide.meta/mfg_api_devguide/sforce_api_objects_purchaseorderitem.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8935b65ca198c6d47b085efbe4bb29f5d4aa773d0dd5e8cd1d1b6e16c39b4dff
description: Represents an individual line on a parent Purchase Order, detailing a specific product or service being procured. It captures the core transactional data including the Quantity, UnitPrice, a reference to the Product, and the calculated LineTotal. This object is available in API version 65.0 and later.
---
# PurchaseOrderItem

Represents an individual line on a parent Purchase Order, detailing a specific product or service being procured. It captures the core transactional data including the Quantity, UnitPrice, a reference to the Product, and the calculated LineTotal. 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

### PurchaseOrderItemNumber

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

### PurchaseOrder

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The parent purchase order associated with the product.

### ProductId

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The Id of the product associated with the purchase order.

### PricebookEntry

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The pricebook entry that defines the price for the specified product.

### ListPrice

- **Type**: currency
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The list price of the product.

### DiscountPercentage

- **Type**: percent
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The percentage of discount applied to the unit price of the product.

### NetUnitPrice

- **Type**: currency
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The price of the product per unit after applying discounts.

### OrderedQuantity

- **Type**: double
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The number of units ordered for the product.

### QuantityUnitOfMeasure

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The unit of measure for the ordered quantity.

### TotalAmount

- **Type**: currency
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The total cost for the specified product.

### StatusCode

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

### 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.

### ShipToContact

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

### ShippingAddress

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

### QuantityReceived

- **Type**: double
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The quantity of the product received to date.

### AdditionalInfo

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

## Associated Objects

This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later.

**[PurchaseOrderItemHistory](https://developer.salesforce.com/docs/atlas.en-us.mfg_api_devguide.meta/mfg_api_devguide/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object."):** History is available for tracked fields of the object.