Routes
Purchase Orders
Items

Update Purchase Order Item

This request updates a Purchase Order Item. Considering the validation for this route is non-trivial -- keep in mind that before this update takes place, we validate the resulting PO Item, so the itemType must be valid with any existing or updated properties. For example, if you have a PO Item of itemType 1 (Part) and attempt to send a PATCH that only provides a checklistID, you will get an error back saying that this is an invalid combination.

To remove an associated ID, pass in the value 0.

ParameterTypeRequiredDescription
itemTypeIntOptionalA number describing what type of PO Item this is. Valid values are: 1 (Part), 2 (Service), 4 (Other). If itemType is 1, name and taskID cannot be present and partID is required. If itemType is 2 or 4, name is required and partID cannot be present. If itemType is 2, a checklistID is required.
nameStringOptionalA short line-item title for this PO Item.
descriptionStringOptionalA more detailed description for this PO Item.
glIDIntOptionalThe ID of the General Ledger that this PO Item will belong to.
taskIDIntOptionalThe ID of the Task that this PO Item will belong to.
assetIDIntOptionalThe ID of the Asset that this PO Item will belong to.
partIDIntOptionalThe ID of the Part that this PO Item will belong to.
quantityIntOptionalA number for how many items are represented in this line. If not provided, the minimum and default values are 1.
rateFloatOptionalA decimal (precision 4) representing the cost of one of the item(s). Default is 0.0000
taxFloatOptionalA decimal (precision 4) representing the amount of tax on the item(s) as a percent. Default is 0.0000
discountFloatOptionalA decimal (precision 4) representing the discounted cost on the item(s) as a percent. Default is 0.0000
shippingFloatOptionalA decimal (precision 4) representing the cost of shipping for the item(s). Default is 0.0000
patch/v2/po/{poID}/items/{poItemID}

Request

Request body

itemTypeinteger
glIDinteger
assetIDinteger
partIDinteger
quantityinteger
ratenumber
taxnumber
discountinteger
shippingnumber

Response

Update Purchase Order Item

successboolean

Changes

No recorded changes to this operation across all 4 revisions of this API.