Skip to main content

 

 

Coupa Success Portal

Supplier Items API

Use the supplier items API to create, update, or query goods provided by suppliers that your employees will select from when creating a requisition.

The URL to access supplier items is: https://<instance>/api/supplier items

See Integration Best Practices for more info.

Actions

The Supplier Items API allows you to:

Verb Path Action Description
POST /api/items/:item_id/supplier_items create Create supplier item
POST /api/supplier_items create Create supplier item
GET /api/items/:item_id/supplier_items index Query supplier items
GET /api/supplier_items index Query supplier items
GET /api/supplier_items/search search Advanced supplier item search
GET /api/items/:item_id/supplier_items/:id show Show supplier item
GET /api/supplier_items/:id show Show supplier item
PATCH /api/items/:item_id/supplier_items/:id update Update supplier item
PUT /api/items/:item_id/supplier_items/:id update Update supplier item
PATCH /api/supplier_items/:id update Update supplier item
PUT /api/supplier_items/:id update Update supplier item

Elements

The following elements are available for the Supplier Items API:

Element Description Required Field? Unique? Allowable Value Api_In Field? Api_Out Field? Data Type
catalog catalog       yes yes
contract contract       yes yes Contract
contract-term contract_term       yes yes ContractTerm
created-at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ         yes datetime
created-by User who created         yes User
currency Currency of transaction       yes yes Currency
id Coupa unique identifier         yes integer
item item       yes yes Item
lead-time lead_time       yes yes integer
manufacturer manufacturer       yes yes string
preferred-flag preferred_flag       yes yes boolean
price price       yes yes decimal
price-change price_change       yes yes float
price-tier-1 price_tier_1       yes yes decimal
price-tier-10 price_tier_10       yes yes decimal
price-tier-11 price_tier_11       yes yes decimal
price-tier-12 price_tier_12       yes yes decimal
price-tier-13 price_tier_13       yes yes decimal
price-tier-14 price_tier_14       yes yes decimal
price-tier-15 price_tier_15       yes yes decimal
price-tier-16 price_tier_16       yes yes decimal
price-tier-17 price_tier_17       yes yes decimal
price-tier-18 price_tier_18       yes yes decimal
price-tier-19 price_tier_19       yes yes decimal
price-tier-2 price_tier_2       yes yes decimal
price-tier-20 price_tier_20       yes yes decimal
price-tier-3 price_tier_3       yes yes decimal
price-tier-4 price_tier_4       yes yes decimal
price-tier-5 price_tier_5       yes yes decimal
price-tier-6 price_tier_6       yes yes decimal
price-tier-7 price_tier_7       yes yes decimal
price-tier-8 price_tier_8       yes yes decimal
price-tier-9 price_tier_9       yes yes decimal
savings-pct savings_pct       yes yes decimal
supplier supplier yes     yes yes Supplier
supplier-aux-part-num supplier_aux_part_num       yes yes string
supplier-part-num supplier_part_num yes     yes yes string
updated-at Automatically created by Coupa in the format YYYY-MM-DDTHH:MM:SS+HH:MMZ         yes datetime
updated-by User who updated         yes User

 The supplier_number, contract_name, item_name, and currency_code must already exist in the system.

  • Was this article helpful?