Update a Part
put
/rest/v16/partSetups/{id}
Use this endpoint to update the specified CPQ part. Note: Any property not specified in the request payload will be implicitly set to blank when making PUT calls. Therefore, all required and numeric Part Custom Fields must be included in the request payload.
Request
Supported Media Types
- application/json
Path Parameters
-
id(required): integer
The unique identifier for the part.
Root Schema : Part Setup Create Request Definitions
Type:
object
Title:
Show Source
Part Setup Create Request Definitions
-
_part_custom_field1:
string
Title:
Product Group
-
_part_custom_field10:
object Product type
Title:
Product type
-
_part_custom_field2:
object Part Availability
Title:
Part Availability
-
_part_custom_field3:
string
Title:
Max discount %
-
_part_custom_field4:
object Price Period
Title:
Price Period
-
_part_custom_field5:
number
Title:
Cost
-
_part_custom_field8:
object Price Type
Title:
Price Type
-
_part_custom_field9:
string
Title:
product
-
dateAdded:
string
Title:
Date Added
System field indicating the date on which the Resource was created. -
dateModified:
string
Title:
Date Modified
System field indicating the date on which the Resource was last modified. -
defaultUOMCode:
string
Title:
Default UOM Code
Default Unit of Measure. -
description:
string
Title:
Description
Description of the part. -
directBuy:
object Direct Buy
Title:
Direct Buy
Determines how the part must be purchased. -
eligibleForService:
string
Title:
Eligible for Service
Enable this option when integrating with a service request application. -
eligibleToSell:
string
Title:
Eligible to Sell
Check this if the part should be visible to a sales person (If the part is sellable or not). -
enableSelfService:
string
Title:
Enable Customer Self-Service
When integrating with any customer self service application- enable this option to identify parts as self-service eligible. -
extendedDescriptions:
object Part Extended Descriptions
Title:
Part Extended Descriptions
-
externalKey1:
string
Title:
External Key 1
References for parts coming in from external third party system. -
externalKey2:
string
Title:
External Key 2
References for parts coming in from external third party system. -
leadTime:
integer
Title:
Lead Time
Time taken in days for the part to be shipped. -
numberOfPricePeriods:
integer
Title:
Number of Price Periods
Default number of price periods for a part. -
partDisplayNumber:
string
Title:
Part Display Number
Part Number for display purpose. -
partnerOrganizationId:
string
Title:
Partner Organization Id
The integrated partner organization id. -
partnerPartId:
string
Title:
Partner Part Id
The integrated partner part id. -
partnerStandardPriceBookEntryId:
string
Title:
Partner Standard Pricebook Entry Id
The integrated partner id for the standard pricebook. -
partNumber:
string
Title:
Part Number
Part Number used to identify a part. -
pricePeriod:
string
Title:
Price Period
Default price period for the part. -
prices:
object Part Prices
Title:
Part Prices
-
priceType:
string
Title:
Price Type
Default price type applicable to the part- e.g. One-Time, Recurring or Usage-based. -
salesProductType:
string
Title:
Sales Product Type
Categorize the product by selecting a product type. -
translations:
object Part Translations
Title:
Part Translations
-
units:
string
Title:
Units
Units for the part.
Nested Schema : Product type
Type:
object
Title:
Show Source
Product type
-
displayValue:
string
Title:
Display Value
Translated display name of the type for which fixed list of values can be defined. -
id:
integer
Title:
Id
Primary Key of the fixed list of value resource. -
lookupCode:
string
Title:
Lookup Code
Language independent code of the fixed list of value.
Nested Schema : Part Availability
Type:
object
Title:
Show Source
Part Availability
-
displayValue:
string
Title:
Display Value
Translated display name of the type for which fixed list of values can be defined. -
id:
integer
Title:
Id
Primary Key of the fixed list of value resource. -
lookupCode:
string
Title:
Lookup Code
Language independent code of the fixed list of value.
Nested Schema : Price Period
Type:
object
Title:
Show Source
Price Period
-
displayValue:
string
Title:
Display Value
Translated display name of the type for which fixed list of values can be defined. -
id:
integer
Title:
Id
Primary Key of the fixed list of value resource. -
lookupCode:
string
Title:
Lookup Code
Language independent code of the fixed list of value.
Nested Schema : Price Type
Type:
object
Title:
Show Source
Price Type
-
displayValue:
string
Title:
Display Value
Translated display name of the type for which fixed list of values can be defined. -
id:
integer
Title:
Id
Primary Key of the fixed list of value resource. -
lookupCode:
string
Title:
Lookup Code
Language independent code of the fixed list of value.
Nested Schema : Direct Buy
Type:
object
Title:
Direct Buy
Determines how the part must be purchased.
Show Source
-
displayValue:
string
Title:
Display Value
Translated display name of the type for which fixed list of values can be defined. -
id:
integer
Title:
Id
Primary Key of the fixed list of value resource. -
lookupCode:
string
Title:
Lookup Code
Language independent code of the fixed list of value.
Nested Schema : Part Extended Descriptions
Type:
object
Title:
Show Source
Part Extended Descriptions
Nested Schema : items
Type:
Show Source
array
-
Array of:
object Part Extended Descriptions
Title:
Part Extended Descriptions
Nested Schema : Part Extended Descriptions
Type:
object
Title:
Show Source
Part Extended Descriptions
-
dateAdded:
string
Title:
Date Added
System field indicating the date on which the Resource was created. -
dateModified:
string
Title:
Date Modified
System field indicating the date on which the Resource was last modified. -
id:
integer
Title:
Id
Identifier for the resource -
partExtendedDescription1:
string
Title:
Extended Description 1
Part extended description 1 -
partExtendedDescription2:
string
Title:
Extended Description 2
Part extended description 2 -
translations:
object Part Extended Description Translations
Title:
Part Extended Description Translations
Nested Schema : Part Extended Description Translations
Type:
object
Title:
Show Source
Part Extended Description Translations
Nested Schema : items
Type:
Show Source
array
-
Array of:
object Part Extended Description Translations
Title:
Part Extended Description Translations
Nested Schema : Part Extended Description Translations
Type:
object
Title:
Show Source
Part Extended Description Translations
-
dateAdded:
string
Title:
Date Added
System field indicating the date on which the Resource was created. -
dateModified:
string
Title:
Date Modified
System field indicating the date on which the Resource was last modified. -
id:
integer
Title:
Id
Identifier for the resource -
language:
object Language
Title:
Language
The defined language of the rows translated columns. -
partExtendedDescription1:
string
Title:
Extended Description 1
Part extended description 1 -
partExtendedDescription2:
string
Title:
Extended Description 2
Part extended description 2
Nested Schema : Language
Type:
object
Title:
Language
The defined language of the rows translated columns.
Show Source
-
id:
integer
Title:
Id
Primary Key of the language resource. -
languageCode:
string
Title:
Language Code
Unique language code -
languageNumber:
integer
Title:
Language Number
Unique language number.
Nested Schema : items
Type:
Show Source
array
-
Array of:
object Part Prices Setup Create Request Definitions
Title:
Part Prices Setup Create Request Definitions
Nested Schema : Part Prices Setup Create Request Definitions
Type:
object
Title:
Show Source
Part Prices Setup Create Request Definitions
-
dateAdded:
string
Title:
Date Added
System field indicating the date on which the Resource was created. -
dateModified:
string
Title:
Date Modified
System field indicating the date on which the Resource was last modified. -
id:
integer
Title:
Id
Primary Key of the Resource -
price:
object Price
Title:
Price
Price of the part.
Nested Schema : Price
Type:
object
Title:
Price
Price of the part.
Show Source
-
currency:
string
Title:
currency
-
value:
number
Title:
value
Nested Schema : items
Type:
Show Source
array
-
Array of:
object Part Translation Setup Create Request Definitions
Title:
Part Translation Setup Create Request Definitions
Nested Schema : Part Translation Setup Create Request Definitions
Type:
object
Title:
Show Source
Part Translation Setup Create Request Definitions
-
dateAdded:
string
Title:
Date Added
System field indicating the date on which the Resource was created. -
dateModified:
string
Title:
Date Modified
System field indicating the date on which the Resource was last modified. -
description:
string
Title:
Translated description
Translated description of the part. -
id:
integer
Title:
Id
Identifier for the resource -
language:
object Language
Title:
Language
The defined language of the rows translated columns. -
units:
string
Title:
Translated Units
Translated units of the part
Nested Schema : Language
Type:
object
Title:
Language
The defined language of the rows translated columns.
Show Source
-
id:
integer
Title:
Id
Primary Key of the language resource. -
languageCode:
string
Title:
Language Code
Unique language code -
languageNumber:
integer
Title:
Language Number
Unique language number.
Response
Supported Media Types
- application/json
Default Response
Examples
The following example shows how to update the specified CPQ part by submitting a PUT request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl - X PUT - i - H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" - H "Content-type: application/json" https://sitename.oracle.com/rest/v16/partSetups/38644116
Request Body
{ "eligibleForService": "N", "directBuy": { "lookupCode": "1", "displayValue": "Direct Buy" }, "description": "The premium Maintenance covers multi-point inspections, as well as preventive care and replacement of normal wear and tear items that require periodic attention.", "enableSelfService": "N", "leadTime": -1, "_part_custom_field10": { "lookupCode": "External", "displayValue": "External" }, "eligibleToSell": "N", "_part_custom_field9": "subscription", "_part_custom_field4": { "lookupCode": "Per Month", "displayValue": "Per Month" }, "_part_custom_field1": "Service", "_part_custom_field2": { "lookupCode": "Available", "displayValue": "Available" }, "_part_custom_field8": { "lookupCode": "Recurring", "displayValue": "Recurring" }, "_part_custom_field5": 0.0, "numberOfPricePeriods": 0, "partnerOrganizationId": null, "partDisplayNumber": "MTN2", "partNumber": "Premium Maintenance Plan" }