updateAppeasement
put
/ccadmin/v1/appeasements/{id}
Update Appeasement. Updates the specified appeasement.
Request
Supported Media Types
- application/json
Path Parameters
-
id: string
ID corresponding to the appeasement to be fetched.
Root Schema : updateAppeasement_request
Type:
Show Source
object
-
agentId(optional):
string
Id of the agent who is creating appeasement. It is an optional property
-
appeasementRefunds(optional):
array appeasementRefunds
Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.
-
comments(optional):
array comments
Array of comments given on an appeasement.
-
creationDate(optional):
string
Date and timestamp when the appeseasement is created.
-
notes(optional):
string
Notes to describe the appeasement.
-
orderId(optional):
string
Id of the order, to which appeasement is associated. OrderId is required only in case of certain appeaesement types which are configured to mandate order as required.
-
originOfAppeasement(optional):
string
Origin of appeasement signifies the channel of appeasement creation. By default, it is "external".
-
profileId(optional):
string
Id of the user, to whom appeasement is given. It can be any valid string and can be updated to a mask string value to support GDPR.
-
reason(optional):
string
Reason to create appeasement, among the configured appeasement reason in the system.
-
state(optional):
string
Current state of the appeasement.
-
type(optional):
string
Type of appeasement, among the configured appeasement type in the system.
Example:
{
"reason":"incorrectItem",
"agentId":"service",
"notes":"Providing an appeasement of 20 USD which is 20% of the Order Total, according to the appeasement policy.",
"comments":[
{
"agentId":"AgentBob",
"comment":"Appeasement to be settled on priority. Valued customer.",
"id":100001,
"creationDate":"2020-03-20T04:56:13.935Z"
},
{
"agentId":"AgentBob",
"comment":"Appeasement settled",
"creationDate":"2020-04-20T04:56:13.935Z"
}
],
"orderId":"o1234",
"appeasementRefunds":[
{
"paymentGroupId":"pg1001",
"refundType":"externalRefund",
"amount":20,
"id":"ar1234",
"state":"COMPLETE",
"currencyCode":"USD"
}
],
"profileId":"se-570031",
"state":"SUBMITTED",
"type":"order"
}
Nested Schema : appeasementRefunds
Type:
array
Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.
Show Source
-
Array of:
object items
Properties of the appeasement refund.
Nested Schema : comments
Type:
array
Array of comments given on an appeasement.
Show Source
-
Array of:
object items
Properties of the comments
Nested Schema : items
Type:
object
Properties of the appeasement refund.
Show Source
-
amount(optional):
number
Appeasement refund amount to be given to the customer.
-
currencyCode(optional):
string
Currency code for the appeasement refund amount.
-
id:
string
Id of the Appeasement refund to be updated. If not provided, a new appeasement refund will be created, removing unmatched refund(s).
-
paymentGroupId(optional):
string
Payment group id associated to order, to which appeasement is to be issued. It is a required property for out-of-the-box refund type.
-
refundType:
string
Type of appeasement refund, among the predefined appeasement refund types.
-
state(optional):
string
Current state of the appeasement refund. It is among the predefined appeasement refund states. By default, it is "INCOMPLETE".
Nested Schema : items
Type:
object
Properties of the comments
Show Source
-
agentId(optional):
string
Agent who saved the comment.
-
comment:
string
Comment text.
-
creationDate(optional):
string
Date and timestamp of the comment.
-
id(optional):
string
Id of the comment associated to the appeasement, in order to update an existing comment. If not provided, a new comment will be added to the comments.
Response
Supported Media Types
- application/json
200 Response
Following model is returned when operation succeeds.
Root Schema : updateAppeasement_response
Type:
Show Source
object
-
agentId(optional):
string
Id of the agent who created the appeasement.
-
appeasementRefunds(optional):
array appeasementRefunds
Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.
-
comments(optional):
array comments
Array of comments given on an appeasement.
-
creationDate(optional):
string
Date and timestamp when the appeseasement is created.
-
id(optional):
string
Id of the appeasement.
-
lastModifiedDate(optional):
string
Date and timestamp when the appeseasement is modified recently.
-
notes(optional):
string
Notes to describe the appeasement.
-
orderId(optional):
string
Id of the order, to which appeasement is given.
-
originOfAppeasement(optional):
string
Origin of appeasement signifies the channel of appeasement created.
-
profileId(optional):
string
Id of the user, to whom appeasement is given.
-
reason(optional):
string
Reason for the appeasement, among the configured appeasement reason in the system.
-
state(optional):
string
Current state of the appeasement. It is among the predefined appeasement states.
-
submittedDate(optional):
string
Date and timestamp when the appeseasement is submitted.
-
type(optional):
string
Type of appeasement, among the configured appeasement type in the system.
Example:
{
"reason":"incorrectItem",
"agentId":"service",
"notes":"Providing an appeasement of 20 USD which is 20% of the Order Total, according to the appeasement policy.",
"comments":[
{
"agentId":"AgentBob",
"comment":"Appeasement to be settled on priority. Valued customer.",
"id":100001,
"creationDate":"2020-03-20T04:56:13.935Z"
},
{
"agentId":"AgentBob",
"comment":"Appeasement settled",
"id":100010,
"creationDate":"2020-04-20T04:56:13.935Z"
}
],
"orderId":"o1234",
"appeasementRefunds":[
{
"paymentGroupId":"pg1001",
"amount":20,
"id":"ar1234",
"state":"COMPLETE",
"type":"externalRefund",
"currencyCode":"USD"
}
],
"lastModifiedDate":"2020-03-20T05:15:05.645Z",
"type":"order",
"creationDate":"2020-03-20T04:56:13.935Z",
"submittedDate":"2020-04-20T04:56:13.935Z",
"profileId":"se-570031",
"id":"app1234",
"state":"SUBMITTED",
"originOfAppeasement":"external"
}
Nested Schema : appeasementRefunds
Type:
array
Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.
Show Source
-
Array of:
object items
Properties of the appeasemen refund.
Nested Schema : comments
Type:
array
Array of comments given on an appeasement.
Show Source
-
Array of:
object items
Properties of the comments
Nested Schema : items
Type:
object
Properties of the appeasemen refund.
Show Source
-
amount(optional):
number
Appeasement refund amount issued to the customer.
-
currencyCode(optional):
string
Currency code for the appeasement refund amount.
-
id(optional):
string
Id of the Appeasement refund associated to an appeasement.
-
paymentGroupId(optional):
string
Payment group id associated to order, to which appeasement is issued.
-
refundType(optional):
string
Type of appeasement refund, among the predefined appeasement refund types.
-
state(optional):
string
Current state of the appeasement refund. It is among the predefined appeasement refund states.
Nested Schema : items
Type:
object
Properties of the comments
Show Source
-
agentId(optional):
string
Agent who saved the comment.
-
comment(optional):
string
Comment text.
-
creationDate(optional):
string
Date and timestamp of the comment.
-
id(optional):
string
Id of the comment associated to the appeasement.
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|
|------------------|------------------|
|900001|An internal error occurred.|
|900002|No Appeasement found with given appeasement id|
|900004|An internal error occured while fetching the appeasement.|
|900006|An internal error occured while updating the appeasement.|
|13001|Input validation error|
Root Schema : errorModel
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
errors(optional):
array errors
An optional list of errors if multiple errors were encountered
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code
-
type(optional):
string
The URI to the HTTP state code definition
Nested Schema : errors
Type:
array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type:
Show Source
object
-
devMessage(optional):
string
An optional non-localized message containing technical information for developers
-
errorCode(optional):
string
The numerical code identifying the error
-
message(optional):
string
The localized message describing the error
-
moreInfo(optional):
string
An optional non-localized message with more information
-
o:errorPath(optional):
string
An optional machine readable description of where the error occurred
-
status(optional):
string
The HTTP status code