Salesforce Docs Portal

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: History is available for tracked fields of the object.