Jump to

• Request
• Response

createAppeasement

post

/ccadmin/v1/appeasements

Create Appeasement. Creates a new appeasement.

Request

Supported Media Types

• application/json

Body ()

Root Schema : createAppeasement_request

Type: object

Show Source

• 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.
• id(optional): string
  Appeasement ID of the appeasement to be submitted. Optional. Needed in case an existing appeasement needs to be submitted.
• notes(optional): string
  Notes to describe the appeasement.
• orderId(optional): string
  Id of the order in SUBMITTED or FULFILLED state, to which appeasement is given. Required for an order based appeasement.
• profileId(optional): string
  Id of an registered user, to whom appeasement is given.
• reason(optional): string
  Reason to create appeasement, among the configured appeasement reason in the system.
• type(optional): string
  Type of appeasement, among the configured appeasement type in the system.

{
    "properties":{
        "reason":{
            "description":"Reason to create appeasement, among the configured appeasement reason in the system.",
            "type":"string"
        },
        "notes":{
            "description":"Notes to describe the appeasement.",
            "type":"string"
        },
        "comments":{
            "description":"Array of comments given on an appeasement.",
            "type":"array",
            "items":{
                "description":"Properties of the comments",
                "type":"object",
                "required":[
                    "comment"
                ],
                "properties":{
                    "comment":{
                        "description":"Comment text.",
                        "type":"string"
                    }
                }
            }
        },
        "orderId":{
            "description":"Id of the order in SUBMITTED or FULFILLED state, to which appeasement is given. Required for an order based appeasement.",
            "type":"string"
        },
        "appeasementRefunds":{
            "description":"Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.",
            "type":"array",
            "items":{
                "description":"Properties of the appeasement refund.",
                "type":"object",
                "properties":{
                    "paymentGroupId":{
                        "description":"Payment group id of the refund type",
                        "type":"string"
                    },
                    "refundType":{
                        "description":"Type of appeasement refund, among the predefined appeasement refund types.",
                        "type":"string"
                    },
                    "amount":{
                        "description":"Appeasement refund amount to be given to the customer.",
                        "type":"number"
                    },
                    "id":{
                        "description":"Id of the Appeasement refund to be updated, in case an existing appeasement is being updated.",
                        "type":"string"
                    },
                    "currencyCode":{
                        "description":"Curency code in which the amount should be refunded",
                        "type":"string"
                    }
                }
            }
        },
        "profileId":{
            "description":"Id of an registered user, to whom appeasement is given.",
            "type":"string"
        },
        "id":{
            "description":"Appeasement ID of the appeasement to be submitted. Optional. Needed in case an existing appeasement needs to be submitted.",
            "type":"string"
        },
        "type":{
            "description":"Type of appeasement, among the configured appeasement type in the system.",
            "type":"string"
        }
    },
    "example":{
        "reason":"itemArrivedDamaged",
        "notes":"Customer complained that the order has arrived damaged, and asked for a refund. Providing 15 USD.",
        "comments":[
            {
                "comment":"Appeasement to be settled on priority. Valued customer."
            }
        ],
        "damagedLineItemId":"ci123547",
        "appeasementRefunds":[
            {
                "paymentGroupId":1223434,
                "refundType":"externalRefund",
                "amount":5,
                "customerPreferredGiftCardId":"GC12345",
                "currencyCode":"USD"
            },
            {
                "paymentGroupId":1223434,
                "refundType":"creditCard",
                "amount":10,
                "customerPreferredGiftCardId":"GC12345",
                "currencyCode":"USD"
            }
        ],
        "orderId":"o10068",
        "profileId":"se-570031",
        "type":"order"
    }
}

Example:

{
    "reason":"itemArrivedDamaged",
    "notes":"Customer complained that the order has arrived damaged, and asked for a refund. Providing 15 USD.",
    "comments":[
        {
            "comment":"Appeasement to be settled on priority. Valued customer."
        }
    ],
    "damagedLineItemId":"ci123547",
    "appeasementRefunds":[
        {
            "paymentGroupId":1223434,
            "refundType":"externalRefund",
            "amount":5,
            "customerPreferredGiftCardId":"GC12345",
            "currencyCode":"USD"
        },
        {
            "paymentGroupId":1223434,
            "refundType":"creditCard",
            "amount":10,
            "customerPreferredGiftCardId":"GC12345",
            "currencyCode":"USD"
        }
    ],
    "orderId":"o10068",
    "profileId":"se-570031",
    "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.

{
    "description":"Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.",
    "type":"array",
    "items":{
        "description":"Properties of the appeasement refund.",
        "type":"object",
        "properties":{
            "paymentGroupId":{
                "description":"Payment group id of the refund type",
                "type":"string"
            },
            "refundType":{
                "description":"Type of appeasement refund, among the predefined appeasement refund types.",
                "type":"string"
            },
            "amount":{
                "description":"Appeasement refund amount to be given to the customer.",
                "type":"number"
            },
            "id":{
                "description":"Id of the Appeasement refund to be updated, in case an existing appeasement is being updated.",
                "type":"string"
            },
            "currencyCode":{
                "description":"Curency code in which the amount should be refunded",
                "type":"string"
            }
        }
    }
}

Nested Schema : comments

Type: array

Array of comments given on an appeasement.

Show Source

• Array of: object items
  Properties of the comments

{
    "description":"Array of comments given on an appeasement.",
    "type":"array",
    "items":{
        "description":"Properties of the comments",
        "type":"object",
        "required":[
            "comment"
        ],
        "properties":{
            "comment":{
                "description":"Comment text.",
                "type":"string"
            }
        }
    }
}

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
  Curency code in which the amount should be refunded
• id(optional): string
  Id of the Appeasement refund to be updated, in case an existing appeasement is being updated.
• paymentGroupId(optional): string
  Payment group id of the refund type
• refundType(optional): string
  Type of appeasement refund, among the predefined appeasement refund types.

{
    "description":"Properties of the appeasement refund.",
    "type":"object",
    "properties":{
        "paymentGroupId":{
            "description":"Payment group id of the refund type",
            "type":"string"
        },
        "refundType":{
            "description":"Type of appeasement refund, among the predefined appeasement refund types.",
            "type":"string"
        },
        "amount":{
            "description":"Appeasement refund amount to be given to the customer.",
            "type":"number"
        },
        "id":{
            "description":"Id of the Appeasement refund to be updated, in case an existing appeasement is being updated.",
            "type":"string"
        },
        "currencyCode":{
            "description":"Curency code in which the amount should be refunded",
            "type":"string"
        }
    }
}

Nested Schema : items

Type: object

Properties of the comments

Show Source

• comment: string
  Comment text.

{
    "description":"Properties of the comments",
    "type":"object",
    "required":[
        "comment"
    ],
    "properties":{
        "comment":{
            "description":"Comment text.",
            "type":"string"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

Following model is returned when operation succeeds.

Body ()

Root Schema : createAppeasement_response

Type: object

Show Source

• 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): object comments
  Properties of the comments
• 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 in SUBMITTED or FULFILLED state, to which appeasement is given.
• originOfAppeasement(optional): string
  Origin of appeasement signifies the channel of appeasement created.
• profileId(optional): string
  Id of an registered user, to whom appeasement is given.
• reason(optional): object reason
  Reason used for the appeasement. Detailed information
• state(optional): string
  Current state of the appeasement. It is among the predefined appeasement states.
• type(optional): object type
  Type of appeasement, among the configured appeasement type in the system.

{
    "properties":{
        "reason":{
            "description":"Reason used for the appeasement. Detailed information",
            "type":"object",
            "properties":{
                "readableDescription":{
                    "description":"Readable description of the appeasemen reason",
                    "type":"string"
                },
                "key":{
                    "description":"Key of the Appeasement reason",
                    "type":"string"
                }
            }
        },
        "agentId":{
            "description":"Id of the agent who created the appeasement.",
            "type":"string"
        },
        "notes":{
            "description":"Notes to describe the appeasement.",
            "type":"string"
        },
        "comments":{
            "description":"Properties of the comments",
            "type":"object",
            "items":{
                "properties":{
                    "agentId":{
                        "description":"Agent who saved the comment.",
                        "type":"string"
                    },
                    "comment":{
                        "description":"Comment text.",
                        "type":"string"
                    },
                    "id":{
                        "description":"Id of the comment associated to the appeasement.",
                        "type":"string"
                    },
                    "creationDate":{
                        "description":"Date and timestamp of the comment.",
                        "type":"string"
                    }
                }
            }
        },
        "appeasementRefunds":{
            "description":"Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.",
            "type":"array",
            "items":{
                "description":"Properties of the appeasemen refund.",
                "type":"object",
                "properties":{
                    "paymentGroupId":{
                        "description":"Current state of the appeasement refund. It is among the predefined appeasement refund states.",
                        "type":"string"
                    },
                    "refundType":{
                        "description":"Type of appeasement refund, among the predefined appeasement refund types.",
                        "type":"string"
                    },
                    "amount":{
                        "description":"Appeasement refund amount issued to the customer.",
                        "type":"number"
                    },
                    "id":{
                        "description":"Id of the Appeasement refund associated to an appeasement.",
                        "type":"string"
                    },
                    "state":{
                        "description":"Current state of the appeasement refund. It is among the predefined appeasement refund states.",
                        "type":"string"
                    },
                    "currencyCode":{
                        "description":"Currency code for the appeasement refund amount.",
                        "type":"string"
                    }
                }
            }
        },
        "orderId":{
            "description":"Id of the order in SUBMITTED or FULFILLED state, to which appeasement is given.",
            "type":"string"
        },
        "lastModifiedDate":{
            "description":"Date and timestamp when the appeseasement is modified recently.",
            "type":"string"
        },
        "type":{
            "description":"Type of appeasement, among the configured appeasement type in the system.",
            "type":"object",
            "properties":{
                "displayName":{
                    "description":"Display name of the appeasemen reason",
                    "type":"string"
                },
                "description":{
                    "description":"Readable description of the appeasemen reason",
                    "type":"string"
                },
                "key":{
                    "description":"Key of the Appeasement reason",
                    "type":"string"
                }
            }
        },
        "creationDate":{
            "description":"Date and timestamp when the appeseasement is created.",
            "type":"string"
        },
        "profileId":{
            "description":"Id of an registered user, to whom appeasement is given.",
            "type":"string"
        },
        "id":{
            "description":"Id of the appeasement.",
            "type":"string"
        },
        "state":{
            "description":"Current state of the appeasement. It is among the predefined appeasement states.",
            "type":"string"
        },
        "originOfAppeasement":{
            "description":"Origin of appeasement signifies the channel of appeasement created.",
            "type":"string"
        }
    },
    "example":{
        "reason":"itemArrivedDamaged",
        "agentId":"service",
        "notes":"Customer complained that the order has arrived damaged, and asked for a refund. Providing 15 USD.",
        "comments":[
            {
                "agentId":"service",
                "comment":"Appeasement to be settled on priority. Valued customer.",
                "id":100001,
                "creationDate":"2020-03-20T04:56:13.935Z"
            }
        ],
        "orderId":"o10068",
        "damagedLineItemId":"ci123547",
        "lastModifiedDate":"2020-04-05T15:52:22.622Z",
        "appeasementRefunds":[
            {
                "paymentGroupId":123556,
                "refundType":"creditCard",
                "amount":5,
                "id":"3200006",
                "state":"INCOMPLETE",
                "currencyCode":"USD"
            },
            {
                "paymentGroupId":123456,
                "refundType":"externalRefund",
                "amount":10,
                "customerPreferredGiftCardId":null,
                "id":"3200007",
                "state":"INCOMPLETE",
                "currencyCode":"USD"
            }
        ],
        "submittedDate":"2020-04-05T15:52:22.622Z",
        "creationDate":"2020-04-05T15:52:22.622Z",
        "type":"order",
        "profileId":"se-570031",
        "links":[
            {
                "rel":"self",
                "href":"http://localhost:9080/ccagentui/v1/appeasements/app370003/update"
            }
        ],
        "state":"INCOMPLETE",
        "id":"app370003",
        "originOfAppeasement":"agent"
    }
}

Example:

{
    "reason":"itemArrivedDamaged",
    "agentId":"service",
    "notes":"Customer complained that the order has arrived damaged, and asked for a refund. Providing 15 USD.",
    "comments":[
        {
            "agentId":"service",
            "comment":"Appeasement to be settled on priority. Valued customer.",
            "id":100001,
            "creationDate":"2020-03-20T04:56:13.935Z"
        }
    ],
    "orderId":"o10068",
    "damagedLineItemId":"ci123547",
    "lastModifiedDate":"2020-04-05T15:52:22.622Z",
    "appeasementRefunds":[
        {
            "paymentGroupId":123556,
            "refundType":"creditCard",
            "amount":5,
            "id":"3200006",
            "state":"INCOMPLETE",
            "currencyCode":"USD"
        },
        {
            "paymentGroupId":123456,
            "refundType":"externalRefund",
            "amount":10,
            "customerPreferredGiftCardId":null,
            "id":"3200007",
            "state":"INCOMPLETE",
            "currencyCode":"USD"
        }
    ],
    "submittedDate":"2020-04-05T15:52:22.622Z",
    "creationDate":"2020-04-05T15:52:22.622Z",
    "type":"order",
    "profileId":"se-570031",
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:9080/ccagentui/v1/appeasements/app370003/update"
        }
    ],
    "state":"INCOMPLETE",
    "id":"app370003",
    "originOfAppeasement":"agent"
}

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.

{
    "description":"Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.",
    "type":"array",
    "items":{
        "description":"Properties of the appeasemen refund.",
        "type":"object",
        "properties":{
            "paymentGroupId":{
                "description":"Current state of the appeasement refund. It is among the predefined appeasement refund states.",
                "type":"string"
            },
            "refundType":{
                "description":"Type of appeasement refund, among the predefined appeasement refund types.",
                "type":"string"
            },
            "amount":{
                "description":"Appeasement refund amount issued to the customer.",
                "type":"number"
            },
            "id":{
                "description":"Id of the Appeasement refund associated to an appeasement.",
                "type":"string"
            },
            "state":{
                "description":"Current state of the appeasement refund. It is among the predefined appeasement refund states.",
                "type":"string"
            },
            "currencyCode":{
                "description":"Currency code for the appeasement refund amount.",
                "type":"string"
            }
        }
    }
}

Nested Schema : comments

Type: object

Properties of the comments

Show Source

• Array of: object items

{
    "description":"Properties of the comments",
    "type":"object",
    "items":{
        "properties":{
            "agentId":{
                "description":"Agent who saved the comment.",
                "type":"string"
            },
            "comment":{
                "description":"Comment text.",
                "type":"string"
            },
            "id":{
                "description":"Id of the comment associated to the appeasement.",
                "type":"string"
            },
            "creationDate":{
                "description":"Date and timestamp of the comment.",
                "type":"string"
            }
        }
    }
}

Nested Schema : reason

Type: object

Reason used for the appeasement. Detailed information

Show Source

• key(optional): string
  Key of the Appeasement reason
• readableDescription(optional): string
  Readable description of the appeasemen reason

{
    "description":"Reason used for the appeasement. Detailed information",
    "type":"object",
    "properties":{
        "readableDescription":{
            "description":"Readable description of the appeasemen reason",
            "type":"string"
        },
        "key":{
            "description":"Key of the Appeasement reason",
            "type":"string"
        }
    }
}

Nested Schema : type

Type: object

Type of appeasement, among the configured appeasement type in the system.

Show Source

• description(optional): string
  Readable description of the appeasemen reason
• displayName(optional): string
  Display name of the appeasemen reason
• key(optional): string
  Key of the Appeasement reason

{
    "description":"Type of appeasement, among the configured appeasement type in the system.",
    "type":"object",
    "properties":{
        "displayName":{
            "description":"Display name of the appeasemen reason",
            "type":"string"
        },
        "description":{
            "description":"Readable description of the appeasemen reason",
            "type":"string"
        },
        "key":{
            "description":"Key of the Appeasement reason",
            "type":"string"
        }
    }
}

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
  Current state of the appeasement refund. It is among the predefined appeasement refund states.
• 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.

{
    "description":"Properties of the appeasemen refund.",
    "type":"object",
    "properties":{
        "paymentGroupId":{
            "description":"Current state of the appeasement refund. It is among the predefined appeasement refund states.",
            "type":"string"
        },
        "refundType":{
            "description":"Type of appeasement refund, among the predefined appeasement refund types.",
            "type":"string"
        },
        "amount":{
            "description":"Appeasement refund amount issued to the customer.",
            "type":"number"
        },
        "id":{
            "description":"Id of the Appeasement refund associated to an appeasement.",
            "type":"string"
        },
        "state":{
            "description":"Current state of the appeasement refund. It is among the predefined appeasement refund states.",
            "type":"string"
        },
        "currencyCode":{
            "description":"Currency code for the appeasement refund amount.",
            "type":"string"
        }
    }
}

Nested Schema : items

Type: object

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.

{
    "properties":{
        "agentId":{
            "description":"Agent who saved the comment.",
            "type":"string"
        },
        "comment":{
            "description":"Comment text.",
            "type":"string"
        },
        "id":{
            "description":"Id of the comment associated to the appeasement.",
            "type":"string"
        },
        "creationDate":{
            "description":"Date and timestamp of the comment.",
            "type":"string"
        }
    }
}

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.| |900005|An internal error occured while processing the input request| |900009|An error for appeasement id duplication.| |13001|Input validation error.|

Body ()

Root Schema : errorModel

Type: object

Show Source

• 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

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "type":{
            "description":"The URI to the HTTP state code definition",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "errors":{
            "description":"An optional list of errors if multiple errors were encountered",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "errorCode":{
                        "description":"The numerical code identifying the error",
                        "type":"string"
                    },
                    "message":{
                        "description":"The localized message describing the error",
                        "type":"string"
                    },
                    "devMessage":{
                        "description":"An optional non-localized message containing technical information for developers",
                        "type":"string"
                    },
                    "moreInfo":{
                        "description":"An optional non-localized message with more information",
                        "type":"string"
                    },
                    "o:errorPath":{
                        "description":"An optional machine readable description of where the error occurred",
                        "type":"string"
                    },
                    "status":{
                        "description":"The HTTP status code",
                        "type":"string"
                    }
                }
            }
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Show Source

• Array of: object items

{
    "description":"An optional list of errors if multiple errors were encountered",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "errorCode":{
                "description":"The numerical code identifying the error",
                "type":"string"
            },
            "message":{
                "description":"The localized message describing the error",
                "type":"string"
            },
            "devMessage":{
                "description":"An optional non-localized message containing technical information for developers",
                "type":"string"
            },
            "moreInfo":{
                "description":"An optional non-localized message with more information",
                "type":"string"
            },
            "o:errorPath":{
                "description":"An optional machine readable description of where the error occurred",
                "type":"string"
            },
            "status":{
                "description":"The HTTP status code",
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• 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

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Back to Top