Jump to

• Request
• Response

getAppeasement

get

/ccagent/v1/appeasements/{id}

Get Appeasement. Gets a detailed appeasement information based on the appeasement ID provided.

Request

Supported Media Types

• application/json

Path Parameters

• id(required): string
  ID corresponding to the appeasement to be fetched.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Following model is returned when operation succeeds.

Body ()

Root Schema : getAppeasement_response

Type: object

Show Source

• agentId: string
  Id of the agent who created the appeasement.
• appeasementRefunds: array appeasementRefunds
  Array of appeasement Refunds represents the list of payment instrument details that we want to use for giving the appeasement.
• comments: array comments
  Array of comments given on an appeasement.
• creationDate: string
  Date and timestamp when the appeseasement is created.
• id: string
  Id of the appeasement.
• lastModifiedDate: string
  Date and timestamp when the appeseasement is modified recently.
• notes: string
  Notes to describe the appeasement.
• orderId: string
  Id of the order, to which appeasement is given.
• originOfAppeasement: string
  Origin of appeasement signifies the channel of appeasement creation.
• profileId: string
  Id of the user, to whom appeasement is given.
• reason: string
  Reason for the appeasement, among the configured appeasement reason in the system.
• state: string
  Current state of the appeasement. It is among the predefined appeasement states.
• submittedDate: string
  Date and timestamp when the appeseasement is submitted.
• type: string
  Type of appeasement, among the configured appeasement type in the system.

{
    "properties":{
        "reason":{
            "description":"Reason for the appeasement, among the configured appeasement reason in the system.",
            "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":"Array of comments given on an appeasement.",
            "type":"array",
            "items":{
                "description":"Properties of a comment",
                "type":"object",
                "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"
                    }
                }
            }
        },
        "orderId":{
            "description":"Id of the order, to which appeasement is given.",
            "type":"string"
        },
        "lastModifiedDate":{
            "description":"Date and timestamp when the appeseasement is modified recently.",
            "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 an appeasement refund.,",
                "type":"object",
                "properties":{
                    "paymentGroupId":{
                        "description":"Payment group id associated to order, to which appeasement is issued.",
                        "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"
                    }
                }
            }
        },
        "type":{
            "description":"Type of appeasement, among the configured appeasement type in the system.",
            "type":"string"
        },
        "creationDate":{
            "description":"Date and timestamp when the appeseasement is created.",
            "type":"string"
        },
        "submittedDate":{
            "description":"Date and timestamp when the appeseasement is submitted.",
            "type":"string"
        },
        "profileId":{
            "description":"Id of the 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 creation.",
            "type":"string"
        }
    },
    "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"
            }
        ],
        "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"
    }
}

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"
        }
    ],
    "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 an 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 an appeasement refund.,",
        "type":"object",
        "properties":{
            "paymentGroupId":{
                "description":"Payment group id associated to order, to which appeasement is issued.",
                "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: array

Array of comments given on an appeasement.

Show Source

• Array of: object items
  Properties of a comment

{
    "description":"Array of comments given on an appeasement.",
    "type":"array",
    "items":{
        "description":"Properties of a comment",
        "type":"object",
        "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 : items

Type: object

Properties of an appeasement refund.,

Show Source

• amount: number
  Appeasement refund amount issued to the customer.
• currencyCode: string
  Currency code for the appeasement refund amount.
• id: string
  Id of the Appeasement refund associated to an appeasement.
• paymentGroupId: string
  Payment group id associated to order, to which appeasement is issued.
• refundType: string
  Type of appeasement refund, among the predefined appeasement refund types.
• state: string
  Current state of the appeasement refund. It is among the predefined appeasement refund states.

{
    "description":"Properties of an appeasement refund.,",
    "type":"object",
    "properties":{
        "paymentGroupId":{
            "description":"Payment group id associated to order, to which appeasement is issued.",
            "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

Properties of a comment

Show Source

• agentId: string
  Agent who saved the comment.
• comment: string
  Comment text.
• creationDate: string
  Date and timestamp of the comment.
• id: string
  Id of the comment associated to the appeasement.

{
    "description":"Properties of a comment",
    "type":"object",
    "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 while processing input request.| |900002|No Appeasement found with given appeasement id| |900004|An internal error occured.|

Body ()

Root Schema : errorModel

Type: object

Show Source

• devMessage: string
  An optional non-localized message containing technical information for developers
• errorCode: string
  The numerical code identifying the error
• errors: array errors
  An optional list of errors if multiple errors were encountered
• message: string
  The localized message describing the error
• moreInfo: string
  An optional non-localized message with more information
• o:errorPath: string
  An optional machine readable description of where the error occurred
• status: string
  The HTTP status code
• type: 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: string
  An optional non-localized message containing technical information for developers
• errorCode: string
  The numerical code identifying the error
• message: string
  The localized message describing the error
• moreInfo: string
  An optional non-localized message with more information
• o:errorPath: string
  An optional machine readable description of where the error occurred
• status: 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