terminateService
post
/ccstore/v1/services/{id}/terminate
Renew a service associated with a user.
Request
Supported Media Types
- application/json
Path Parameters
- id
-
Type:
stringRequired:trueID of an asset.
Header Parameters
- X-CCAsset-Language
-
Type:
stringThe asset language of the request
Body Parameter
Root Schema : action_request
- transactionDate
-
Type:
stringThe date and time on which the service request was made.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : action_response
- configuratorItem
-
Type:
objectconfiguratorItemAdditional Properties Allowed:The configured item
Nested Schema : configuratorItem
Type:
objectThe configured item
- actionCode
-
Type:
stringThe configuration session identifier. - activationDate
-
Type:
stringDate on which the service contract starts. - amount
-
Type:
stringThe total amount of this item and sub items. - assetId
-
Type:
stringThe id of the account asset. - billingAccountId
-
Type:
stringThe id of the billing account. - catalogRefId
-
Type:
stringThe item sku id. - childItems
-
Type:
arraychildItemsAdditional Properties Allowed: - configuratorId
-
Type:
stringThe configuration session identifier. - customerAccountId
-
Type:
stringThe id of the customer account. - deactivationDate
-
Type:
stringDate on which the service contract ends. - externalData
-
Type:
arrayexternalDataAdditional Properties Allowed:Information about the configured item. - externalPrice
-
Type:
stringThe price of this item. - externalRecurringCharge
-
Type:
stringThe items recurring charge. - externalRecurringChargeFrequency
-
Type:
stringThe frequency of the recurring charges, E.g Per Month. - externalRecurringDuration
-
Type:
stringThe duration of the recurring charges, E.g 1 Year. - quantity
-
Type:
integerThe items quantity. - serviceAccountId
-
Type:
stringThe id of the service account. - serviceId
-
Type:
stringAn invariant key that uniquely identifies the asset / component for the lifetime of the asset. It will be unique across all asset repositories.
Nested Schema : childItems
Type:
array-
Type:
objectaction_responseAdditional Properties Allowed:
Nested Schema : externalData
Nested Schema : items
Type:
object- name
-
Type:
stringName of the externalData item. - values
-
Type:
objectvaluesAdditional Properties Allowed:The externalData values.
Nested Schema : values
Type:
objectThe externalData values.
- displayValue
-
Type:
stringexternalData vaulue value. - label
-
Type:
stringexternalData vaulue label. - name
-
Type:
stringexternalData vaulue description.
Example application/json
{
"configuratorItem":{
"serviceAccountId":"",
"deactivationDate":"",
"amount":"",
"quantity":0,
"externalRecurringCharge":"",
"externalData":[
{
"values":{
"displayValue":"",
"name":"",
"label":""
},
"name":""
}
],
"billingAccountId":"",
"externalRecurringChargeFrequency":"",
"childItems":[
"#/configuratorItem"
],
"catalogRefId":"",
"configuratorId":"",
"externalRecurringChargeDuration":"",
"externalPrice":"",
"customerAccountId":"",
"assetId":"",
"actionCode":"",
"serviceId":"",
"activationDate":""
}
}
Default Response
The error response.
The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud:
|Error Code|Description|
|------------------|------------------|
|551000|Could not get customers profile.|
|551001|Customer has no service account.|
|551002|Error retrieving customers service account.|
|551003|Error retrieving account assets.|
|551004|Error validating contact account ids in Order.
|551005|Invalid account asset id.
|551006|Account asset authorization error.
|551007|Owner of the account asset could not be determined.
|551008|Error submitting action request.
|551009|Invalid transactionDate.
Body
Root Schema : errorModel
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - errors
-
Type:
arrayerrorsAdditional Properties Allowed:An optional list of errors if multiple errors were encountered - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code - type
-
Type:
stringThe URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object- devMessage
-
Type:
stringAn optional non-localized message containing technical information for developers - errorCode
-
Type:
stringThe numerical code identifying the error - message
-
Type:
stringThe localized message describing the error - moreInfo
-
Type:
stringAn optional non-localized message with more information - o:errorPath
-
Type:
stringAn optional machine readable description of where the error occurred - status
-
Type:
stringThe HTTP status code
Examples
Sample Response Payload returned by endpoint:
{"configuratorItem": {
"serviceAccountId": "",
"deactivationDate": "",
"amount": "",
"quantity": 0,
"externalRecurringCharge": "",
"externalData": [{
"values": {
"displayValue": "",
"name": "",
"label": ""
},
"name": ""
}],
"billingAccountId": "",
"externalRecurringChargeFrequency": "",
"childItems": ["#/configuratorItem"],
"catalogRefId": "",
"configuratorId": "",
"externalRecurringChargeDuration": "",
"externalPrice": "",
"customerAccountId": "",
"assetId": "",
"actionCode": "",
"serviceId": "",
"activationDate": ""
}}