renewService
post
/ccstore/v1/services/{id}/renew
Renew a service associated with a user.
Request
Supported Media Types
- application/json
Path Parameters
- id
-
Type:
string
Required:true
ID of an asset.
Header Parameters
- X-CCAsset-Language
-
Type:
string
The asset language of the request
Body Parameter
Root Schema : action_request
- transactionDate
-
Type:
string
The 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:
object
configuratorItemAdditional Properties Allowed:The configured item
Nested Schema : configuratorItem
Type:
object
The configured item
- actionCode
-
Type:
string
The configuration session identifier. - activationDate
-
Type:
string
Date on which the service contract starts. - amount
-
Type:
string
The total amount of this item and sub items. - assetId
-
Type:
string
The id of the account asset. - billingAccountId
-
Type:
string
The id of the billing account. - catalogRefId
-
Type:
string
The item sku id. - childItems
-
Type:
array
childItemsAdditional Properties Allowed: - configuratorId
-
Type:
string
The configuration session identifier. - customerAccountId
-
Type:
string
The id of the customer account. - deactivationDate
-
Type:
string
Date on which the service contract ends. - externalData
-
Type:
array
externalDataAdditional Properties Allowed:Information about the configured item. - externalPrice
-
Type:
string
The price of this item. - externalRecurringCharge
-
Type:
string
The items recurring charge. - externalRecurringChargeFrequency
-
Type:
string
The frequency of the recurring charges, E.g Per Month. - externalRecurringDuration
-
Type:
string
The duration of the recurring charges, E.g 1 Year. - quantity
-
Type:
integer
The items quantity. - serviceAccountId
-
Type:
string
The id of the service account. - serviceId
-
Type:
string
An 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:
object
action_responseAdditional Properties Allowed:
Nested Schema : externalData
Nested Schema : items
Type:
object
- name
-
Type:
string
Name of the externalData item. - values
-
Type:
object
valuesAdditional Properties Allowed:The externalData values.
Nested Schema : values
Type:
object
The externalData values.
- displayValue
-
Type:
string
externalData vaulue value. - label
-
Type:
string
externalData vaulue label. - name
-
Type:
string
externalData 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:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - errors
-
Type:
array
errorsAdditional Properties Allowed:An optional list of errors if multiple errors were encountered - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The HTTP status code - type
-
Type:
string
The URI to the HTTP state code definition
Nested Schema : errors
Nested Schema : items
Type:
object
- devMessage
-
Type:
string
An optional non-localized message containing technical information for developers - errorCode
-
Type:
string
The numerical code identifying the error - message
-
Type:
string
The localized message describing the error - moreInfo
-
Type:
string
An optional non-localized message with more information - o:errorPath
-
Type:
string
An optional machine readable description of where the error occurred - status
-
Type:
string
The 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": "" }}