Get a Part
get
/rest/v16/partSetups/{id}
Use this endpoint to retrieve the specified CPQ part.
Request
Supported Media Types
- application/json
Path Parameters
-
id(required): integer
The unique identifier for the part.
Query Parameters
-
expand: string
Allows expansion of relationships.
Response
Supported Media Types
- application/json
Default Response
Root Schema : Part Setup Instance Definitions
Type:
object
Title:
Show Source
Part Setup Instance 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. -
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. -
id:
integer
Title:
Id
The unique identifier for the part. -
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. -
partNumberLower:
string
Title:
Part Number Lower
Used to store part number in lower case. -
pricePeriod:
string
Title:
Price Period
Default price period for the part. -
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. -
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.
Examples
The following example shows how to retrieve the specified CPQ part by submitting a GET request to the REST resource using cURL. For more information about cURL, see Use cURL.
curl - X GET - i - H "Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQg" - H "Content-type: application/json" https://sitename.oracle.com/rest/v16/partSetups/38644116
Response Body
{ "eligibleForService": "N", "partnerPartId": null, "directBuy": { "lookupCode": "1", "displayValue": "Direct Buy", "id": 36549639, "links": [{ "rel": "domain", "href": "https://sitename.oracle.com/rest/v16/lookupValues?q=%7B%22lookupType%22%3A%7B%22%24eq%22%3A%22BM_PARTS_DIRECT_BUY%22%7D%7D" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v16/lookupValues/36549639" } ] }, "defaultUOMCode": null, "description": "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, "units": null, "_part_custom_field10": { "lookupCode": "External", "displayValue": "External", "id": 38272229, "links": [{ "rel": "domain", "href": "https://sitename.oracle.com/rest/v16/lookupValues?q=%7B%22lookupType%22%3A%7B%22%24eq%22%3A%22_PART_field10%22%7D%7D" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v16/lookupValues/38272229" } ] }, "eligibleToSell": "N", "dateAdded": "2021-09-17T11:45:34.000Z", "partnerStandardPriceBookEntryId": null, "_part_custom_field9": "subscription", "id": 38644116, "_part_custom_field3": null, "_part_custom_field4": { "lookupCode": "Per Month", "displayValue": "Per Month", "id": 36657628, "links": [{ "rel": "domain", "href": "https://sitename.oracle.com/rest/v16/lookupValues?q=%7B%22lookupType%22%3A%7B%22%24eq%22%3A%22_PART_field4%22%7D%7D" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v16/lookupValues/36657628" } ] }, "_part_custom_field1": "Service", "_part_custom_field2": { "lookupCode": "Available", "displayValue": "Available", "id": 38547619, "links": [{ "rel": "domain", "href": "https://sitename.oracle.com/rest/v16/lookupValues?q=%7B%22lookupType%22%3A%7B%22%24eq%22%3A%22_PART_field2%22%7D%7D" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v16/lookupValues/38547619" } ] }, "_part_custom_field8": { "lookupCode": "Recurring", "displayValue": "Recurring", "id": 36657634, "links": [{ "rel": "domain", "href": "https://sitename.oracle.com/rest/v16/lookupValues?q=%7B%22lookupType%22%3A%7B%22%24eq%22%3A%22_PART_field8%22%7D%7D" }, { "rel": "canonical", "href": "https://sitename.oracle.com/rest/v16/lookupValues/36657634" } ] }, "_part_custom_field5": 0.0, "salesProductType": null, "priceType": null, "numberOfPricePeriods": 0, "dateModified": "2023-03-02T20:47:12.000Z", "partnerOrganizationId": null, "partDisplayNumber": "MTN2", "pricePeriod": null, "partNumberLower": "premium maintenance plan", "partNumber": "Premium Maintenance Plan", "externalKey1": null, "externalKey2": null, "links": [{ "rel": "self", "href": "https://sitename.oracle.com/rest/v16/partSetups/38644116" }, { "kind": "", "rel": "child", "name": "extendedDescriptions", "href": "https://sitename.oracle.com/rest/v16/partSetups/38644116/extendedDescriptions" }, { "kind": "", "rel": "child", "name": "prices", "href": "https://sitename.oracle.com/rest/v16/partSetups/38644116/prices" }, { "kind": "", "rel": "child", "name": "translations", "href": "https://sitename.oracle.com/rest/v16/partSetups/38644116/translations" } ] }