Collaborative Quote Queue REST APIs
Overview
The Collaborative Quote Queue REST APIs allow administrators to manage the collaborative quote queue.
Administration
Clear Current Collaborative Quote Queue
Description |
Use this endpoint to clear the collaborative operation queue for the specified transaction. This will cancel every operation that is executing or queued at the time that the request is processed.
|
URI Endpoint |
/rest/v17/collabOperationQueues/{bsId}/actions/clearCurrentQueue
|
Endpoint Parameters |
bsId
|
The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site. |
HTTP Method |
POST |
Request Body Parameters |
None
|
Success Response |
204 Not Content
|
Error Responses |
400
|
Collaborative quote editing is not enabled for process
|
403
|
User with restricted access (Sales agent etc)
|
404
|
Invalid bsId provided in the endpoint
|
URI Endpoint Sample
https://site.oracle.com/rest/v17/collabOperationQueues/30221276251/actions/clearCurrentQueue
Get Collaborative Quote Queue
Description |
Use this endpoint to retrieve queued tasks for the specified transaction.
|
URI Endpoint |
/rest/v17/collabOperationQueues/{bsId}
|
Endpoint Parameters
|
bsId
|
The commerce transaction Id. This is the unique identifier for a transaction within an Oracle CPQ site. |
HTTP Method |
GET |
Request Body Parameters |
None
|
Response Body Parameters |
currentlyExecutingOperation
|
Operation which is currently executing. Omitted if the next queued operation has not started executing yet.
|
node
|
Name of the node that is currently responsible for executing all operations for the bsId.
|
operationCount
|
The total number of incomplete operations, including executing and queued operations.
|
queuedOperations
|
Operations which are queued and have not started execution. The order of the items in the array is the order in which they will execute.
|
Error Responses |
400
|
Collaborative quote editing is not enabled for process
|
403
|
User with restricted access (Sales agent etc)
|
404
|
Invalid bsId provided in the endpoint
|
URI Endpoint Sample
https://sitename.oracle.com/rest/v17/collabOperationQueues/30221276251
Sample Response Body
{
"queuedOperations": [{
"uuid": "eaf67e0f-65fc-4ecc-8bfd-09a3dd9c82c0",
"submitterLoginName": "alex",
"submitterCompanyName": "mumbai54488",
"submissionTime": "2024-03-14T09:54:07.649Z",
"description": "ResourceCmActionOperation[docNum=1,actionVarName=_open_main]"
}, {
"uuid": "4bbd4008-aed7-4cc1-b616-6d1ebcd2fbeb",
"submitterLoginName": "alex",
"submitterCompanyName": "mumbai54488",
"submissionTime": "2024-03-14T09:54:09.798Z",
"description": "ResourceCmActionOperation[docNum=1,actionVarName=_open_main]"
}],
"currentlyExecutingOperation": {
"uuid": "6cc3a88c-4921-4b21-95de-2709d44cf8d5",
"submitterLoginName": "alex",
"submitterCompanyName": "mumbai54488",
"submissionTime": "2024-03-14T09:54:02.593Z",
"description": "ResourceCmActionOperation[docNum=1,actionVarName=test_c]"
},
"operationCount": 3,
"node": "node1"
}
Related Topics
See Also