• Last edited on: 08 November 2023

Purchase Order Line Change API

Use the purchase order line change API to modify orders that are already in flight, either in approvals or sent to the supplier.

Associations

This resource is associated with Purchase Order Change API.

Elements

Element Description Req'd Unique Allowable Value In Out Data Type
account The account object. See Account payload behavior below. yes     yes yes Account 
account-allocations account_allocations       yes yes OrderLineChangeAllocation 
asset-tags Asset tags       yes   AssetTag 
attachments attachments         yes Attachment 
commodity commodity       yes yes Commodity 
contract contract       yes yes Contract 
created-at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ         yes datetime
currency Currency of transaction yes       yes Currency 
department department         yes Department 
description description yes     yes yes string(255)
easy-form-response-id Easy Form Response Id         yes  
extra-line-attribute Extra line attribute       yes yes ExtraLineAttributes::OrderLineChangeAttribute 
id Coupa unique identifier         yes integer
item item       yes yes Item 
line-num line_num         yes string(255)
line-owner Line owner         yes  
manufacturer-name Manufacturer Name       yes yes string(255)
manufacturer-part-number Manufacturer Part Number       yes yes string(255)
milestones Milestones       yes yes  
minimum-order-quantity Minimum order quantity         yes decimal(30,6)
need-by-date need_by_date       yes yes datetime
order-header-change-id order_header_change_id         yes integer
order-increment Order increment         yes decimal(30,6)
order-line-change-tax-detail Order line change tax detail yes     yes    
order-line-id order_line_id       yes yes integer
pending-delete Pending delete       yes yes boolean
period period       yes yes Period 
price price yes     yes yes decimal(30,6)
quantity quantity yes     yes yes decimal(30,6)
recurring-rules Recurring rules         yes  
savings-pct savings_pct       yes yes decimal(8,2)
service-type Service type         yes string
source-part-num Source part num       yes yes string(255)
supplier supplier         yes Supplier 
total total yes       yes decimal(30,4)
uom unit of measure       yes yes Uom 
updated-at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ         yes datetime

Account payload behavior

The Account payload can differ depending on whether you're using static or dynamic accounts:

  • For lines that use static accounts, the account object uses account_type_id to reference the account type.
  • For lines that use dynamic accounts, the account object uses the  account type object's id element to reference the account type. 

Static account payload sample

<account>
  <account_type_id>1</account_type_id>
  <code>account-code-goes-here</code>
</account>

Dynamic account payload sample

<account>
  <account_type>
    <id>1</id>
  </account_type>
  <code>account-code-goes-here</code>
</account>

Related Items


Differences between XML and JSON in Coupa

16 December 2016

Tagging API

24 April 2017

Use the Tagging API to bring in and export tags to your third-party system.

Integration Runs API

24 April 2017

Use this API to create, query, or update an integration run, as well as update the status.

Dispute Reason API

05 August 2017