REST API for Oracle Commerce Cloud December 2017

updateReason

put

/ccadmin/v1/reasons

Update Reason. Update the given reason type with given reason id

Request

Supported Media Types

application/json

Body Parameter

Root Schema : updateReason_request

Example


[
    "PUT /ccadmin/v1/reasons?type=priceOverrideReasons&id=agentPriceOverride",
    {
        "readableDescription":"Agent Price Override",
        "active":false,
        "description":"agentPriceOverride"
    }
]

Properties

id: Type: string

Required: true

id of the reason to be updated.
type: Type: string

Required: true

type of the reason valid values are cancelReasons, priceOverrideReasons, returnReasons and returnItemDisposition

Response

Supported Media Types

application/json

200 Response

Following model is returned when operation succeeds.

Body

Root Schema : updateReason_response

Properties

Example application/json


[
    {
        "readableDescription":"Agent Price Override",
        "description":"agentPriceOverride",
        "active":false,
        "links":[
            {
                "rel":"self",
                "href":"http://localhost:9080/ccadminui/v1/reasons?type=priceOverrideReasons&id=agentPriceOverride"
            }
        ],
        "id":"agentPriceOverride"
    }
]

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| |------------------|------------------| |200216|Error while updating the reason| |200217|Error while validating the input reason json| |200214|Reason id is required.| |200213|Invalid reason type passed.|

Body

Root Schema : errorModel

Type: object

Properties

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 errors

Additional 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

Type: array

An optional list of errors if multiple errors were encountered

Items

Type: object items

Additional Properties Allowed:

Nested Schema : items

Type: object

Properties

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 Request:

[
  "PUT /ccadmin/v1/reasons?type=priceOverrideReasons&id=agentPriceOverride",
  {
    "readableDescription": "Agent Price Override",
    "active": false,
    "description": "agentPriceOverride"
  }
]

Sample Response Payload returned by endpoint:

[{
  "readableDescription": "Agent Price Override",
  "description": "agentPriceOverride",
  "active": false,
  "links": [{
    "rel": "self",
    "href": "http://localhost:9080/ccadminui/v1/reasons?type=priceOverrideReasons&id=agentPriceOverride"
  }],
  "id": "agentPriceOverride"
}]