getReturnRequest

get

/ccstore/v1/returnRequests/{id}

Get Return Request. Gets the return request details for a given Return Request ID. Optionally takes the x-ccasset-language headers to get translated content in another language. Also, additionally takes X-CCOrganization and x-ccsite headers.

Request

Supported Media Types
Path Parameters
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : getReturnRequest_response
Type: object
Show Source
Example:
{
    "shippingTaxRefund":3,
    "agentId":"service",
    "secondaryCurrencyShippingTaxRefund":0,
    "actualShippingRefund":25,
    "actualTaxRefund":6,
    "otherRefund":0,
    "secondaryCurrencyActualTaxRefund":0,
    "refundMethodList":[
        {
            "refundType":"manualRefund",
            "amount":86,
            "state":"INCOMPLETE"
        }
    ],
    "returnLabel":null,
    "authorizationNumber":"100001",
    "returnFee":0,
    "requestId":"100001",
    "secondaryCurrencyActualShippingRefund":0,
    "links":[
        {
            "rel":"self",
            "href":"http://localhost:9080/ccadminui/v1/returnRequests/100001"
        }
    ],
    "state":"FULL_RETURN",
    "additionalProperties":{
        "abc":"123"
    },
    "originOfReturn":"contactCenter",
    "trackingNumber":null,
    "returnItemList":[
        {
            "secondaryCurrencyActualTaxRefundShare":0,
            "comments":"this is comment 112222",
            "shippingGroupId":"sg40412",
            "secondaryCurrencyActualShippingSurchargeRefundShare":0,
            "quantityWithFractionReceived":0,
            "commerceItemId":"ci3000414",
            "secondaryCurrencyActualShippingRefundShare":0,
            "disposition":"acceptedWithRefund",
            "actualShippingSurchargeRefundShare":0,
            "returnReason":"defective",
            "actualShippingRefundShare":25,
            "state":"RETURNED",
            "additionalProperties":{
            },
            "actualTaxRefundShare":6,
            "quantityReceived":1,
            "refundAmount":49.99
        }
    ],
    "actualShippingSurchargeRefund":10,
    "secondaryCurrencyActualShippingSurchargeRefund":0
}
Nested Schema : additionalProperties
Type: object
Map of Additional properties for return request
Show Source
Nested Schema : refundMethodList
Type: array
List of refund methods
Show Source
Nested Schema : returnItemList
Type: array
List of returnable Items
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : additionalProperties
Type: object
Map of Additional properties for each return item
Show Source
Example Response (application/json)
{
    "returnRequestStatus":"Full return",
    "isExchangeRequest":false,
    "returnItems":[
        {
            "quantityReturned":2,
            "dynamicProperties":[
                {
                    "id":"ReferralCode",
                    "label":"ReferralCode",
                    "value":null
                },
                {
                    "id":"OfferEndsDate",
                    "label":"OfferEndsDate",
                    "value":"2020-07-02T03:42:42.962Z"
                },
                {
                    "id":"Discount",
                    "label":"Discount",
                    "value":0
                },
                {
                    "id":"GiftWrapping",
                    "label":"Gift Wrapping",
                    "value":false
                },
                {
                    "id":"CustomMessage",
                    "label":"Custom Message",
                    "value":null
                },
                {
                    "id":"name",
                    "label":"Name on product(Mug)",
                    "value":"My name"
                },
                {
                    "id":"ShippingInstructions",
                    "label":"Shipping Instructions",
                    "value":null
                }
            ],
            "billingProfileId":"billingProfile-123",
            "billingAccountId":"billingAcc-123",
            "childItems":[
                {
                    "serviceAccountId":"serviceAcc-123",
                    "deactivationDate":"2018-06-27T12:59:59Z",
                    "quantity":2,
                    "productId":"prod10040",
                    "displayName":"Super Smash Brothers Brawl",
                    "externalData":[
                    ],
                    "parentAssetKey":null,
                    "billingProfileId":"billingProfile-123",
                    "billingAccountId":"billingAcc-123",
                    "rootAssetKey":null,
                    "transactionDate":"2018-06-27T12:59:59Z",
                    "catRefId":"sku10041",
                    "assetKey":null,
                    "route":"product/prod10040",
                    "customerAccountId":"customerAcc-123",
                    "assetId":"asset10001",
                    "selectedOptions":[
                    ],
                    "actionCode":"Add",
                    "activationDate":"2017-06-27T15:30:00Z",
                    "serviceId":"service-123",
                    "asset":false
                },
                {
                    "serviceAccountId":"serviceAcc-123",
                    "deactivationDate":"2018-06-27T12:59:59Z",
                    "quantity":1,
                    "productId":"prod10038",
                    "displayName":"Wii Music",
                    "externalData":[
                    ],
                    "parentAssetKey":null,
                    "billingProfileId":"billingProfile-123",
                    "billingAccountId":"billingAcc-123",
                    "rootAssetKey":null,
                    "transactionDate":"2018-06-27T12:59:59Z",
                    "catRefId":"sku10042",
                    "assetKey":null,
                    "route":"product/prod10038",
                    "customerAccountId":"customerAcc-123",
                    "assetId":"asset10001",
                    "selectedOptions":[
                    ],
                    "actionCode":"Add",
                    "activationDate":"2017-06-27T15:30:00Z",
                    "serviceId":"service-123",
                    "asset":false
                }
            ],
            "skuOptionInfo":[
            ],
            "configuratorId":"12345677",
            "assetKey":null,
            "quantityAvailableForReturn":3,
            "unAdjustedRefundAmount":25,
            "suggestedShippingRefund":5.83,
            "price":115,
            "actionCode":"Add",
            "promotionAdjustments":[
            ],
            "quantityReceived":1,
            "dispositionReason":{
                "displayKey":"rejectedWithRefund",
                "displayName":"Rejected With Refund"
            },
            "unitPrice":25,
            "productId":"prod10013",
            "parentAssetKey":null,
            "catRefId":"sku10030",
            "customerAccountId":"customerAcc-123",
            "quantityShipped":5,
            "additionalProperties":{
                "key1":"value1",
                "key2":"value2"
            },
            "activationDate":"2017-06-27T15:30:00Z",
            "actualRefundAmount":25,
            "suggestedRefundAmount":25,
            "deactivationDate":"2018-06-27T12:59:59Z",
            "nonreturnable":false,
            "displayName":"Playstation",
            "externalData":[
            ],
            "orderDiscountShare":0,
            "commerceItemId":"ci9000467",
            "assetId":"asset10001",
            "returnReason":"Incorrect Item",
            "serviceId":"service-123",
            "serviceAccountId":"serviceAcc-123",
            "quantityToReturn":1,
            "shippingGroup":{
                "shippingMethod":{
                    "shippingMethod":"standardShippingMethod",
                    "shippingMethodDescription":"Standard"
                },
                "shippingGroupId":"sg40411",
                "shippingAddress":{
                    "lastName":"Spencers",
                    "country":"US",
                    "address3":null,
                    "address2":null,
                    "city":"Montgomery",
                    "prefix":null,
                    "address1":"600 Dexter Avenue",
                    "postalCode":"36130",
                    "companyName":null,
                    "jobTitle":null,
                    "county":null,
                    "suffix":null,
                    "firstName":"Mark",
                    "phoneNumber":"973-974-1234",
                    "faxNumber":null,
                    "alias":null,
                    "middleName":null,
                    "state":"AL",
                    "email":"mspens@abc.com"
                }
            },
            "comments":null,
            "returnItemId":"300002",
            "nonReturnableReaon":"No items in order are returnable",
            "detailedItemPriceInfo":[
                {
                    "discounted":false,
                    "secondaryCurrencyTaxAmount":0,
                    "amount":25,
                    "quantity":1,
                    "tax":2.5,
                    "orderDiscountShare":0,
                    "detailedUnitPrice":25,
                    "currencyCode":"USD"
                }
            ],
            "quantityToReceive":0,
            "suggestedTaxRefund":2.01,
            "manualAdjustmentShare":0,
            "rootAssetKey":null,
            "transactionDate":"2018-06-27T12:59:59Z",
            "skuProperties":[
                {
                    "propertyType":"sku-base",
                    "name":"Name",
                    "id":"displayName",
                    "value":null
                },
                {
                    "propertyType":"sku-base",
                    "name":"Id",
                    "id":"id",
                    "value":"camerasku_1_1"
                },
                {
                    "propertyType":"sku-custom",
                    "name":"dynamicskuprop1",
                    "id":"dynamicskuprop1",
                    "value":"dynamicskuprop1"
                }
            ],
            "adjustedPromotionReferences":"",
            "asset":false
        }
    ],
    "profileInfo":{
        "lastName":"Anderson",
        "firstName":"Kim",
        "organization":{
            "name":"Oracle India Pvt Ltd",
            "id":"oracle"
        },
        "middleName":null,
        "email":"kim@example.com"
    },
    "returnLabel":"r1234",
    "isManuallyAdjusted":false,
    "orderInfo":{
        "priceInfo":{
            "total":156.82,
            "amount":110.2,
            "shipping":35,
            "isTaxIncluded":false,
            "tax":23.31,
            "subTotal":200,
            "orderDiscountAmount":2,
            "currencyCode":"USD",
            "totalWithoutTax":129.89
        },
        "orderId":"o10042",
        "priceListGroup":{
            "deleted":false,
            "displayName":"UsDollar",
            "repositoryId":"UsDollar",
            "listPriceList":{
                "repositoryId":"listPrices"
            },
            "active":true,
            "salePriceList":{
                "repositoryId":"salePrices"
            },
            "currency":{
                "symbol":"$",
                "displayName":"US Dollar",
                "repositoryId":"hi_US",
                "fractionalDigits":2,
                "currencyCode":"USD",
                "numericCode":"356"
            },
            "id":"UsDollar",
            "locale":"hi_US",
            "shippingSurchargePriceList":{
                "repositoryId":"shippingSurchargePrices"
            }
        },
        "siteId":"siteUS",
        "creationDate":"2015-05-16T04:50:53.000Z",
        "submittedDate":"2015-06-16T04:50:53.000Z"
    },
    "refundInfo":{
        "shippingTaxRefund":2,
        "refundDue":32.84,
        "suggestedShippingRefund":5.83,
        "returnFee":0,
        "suggestedOrderRefund":25,
        "suggestedTaxRefund":2.01,
        "suggestedTotalRefund":32.84,
        "unAdjustedRefundSubtotal":25,
        "actualShippingRefund":5.83,
        "actualTaxRefund":2.01,
        "otherRefund":0
    },
    "isSetteled":false,
    "promotionAdjustments":{
        "promotionAdjustmentsCount":0,
        "orderPromotionValueAdjustments":[
        ],
        "totalOrderDiscountAdjustment":0,
        "nonReturnItemCostAdjustment":[
        ],
        "itemPromotionValueAdjustments":[
        ],
        "manyToManyPromotionCouponAdjustment":{
        }
    },
    "links":[
        {
            "rel":"self",
            "href":"http://example.com/ccstoreui/v1/returnRequests/300002"
        }
    ],
    "additionalProperties":{
        "key1":"value1",
        "key2":"value2"
    },
    "state":{
        "displayKey":"FULL_RETURN",
        "displayName":"Full return"
    },
    "quoteInfo":{
        "providerNote":null,
        "notes":[
            {
                "providerDate":"2016-11-25T13:33:48.000Z",
                "providerNote":"The quote is approved as per the request",
                "profileType":null,
                "profileId":"se-570031"
            },
            {
                "profileType":null,
                "profileId":"se-570031",
                "requestDate":"2016-10-25T13:33:48.000Z",
                "requesterNote":"provide 10 percent off on the total quantity"
            }
        ],
        "rejectionDate":null,
        "requestDate":"2016-10-25T13:33:48.000Z",
        "errorInfo":null,
        "externalID":null,
        "rejectionNote":null,
        "quoteDate":"2016-10-25T13:35:32.000Z",
        "expirationDate":"2026-04-28T18:53:48.000Z"
    },
    "trackingNumber":[
        "t1234",
        "t2345"
    ],
    "operation":"refund",
    "paymentReversalInfo":[
        {
            "paymentGroupId":"pg10042",
            "refundType":"tokenizedCreditCard",
            "amount":32.84,
            "creditCardInfo":{
                "cardNumber":"xxxxxxxxxxxx1111"
            },
            "creditCardType":null,
            "reversalMethod":"Card Payment Reversal",
            "maxRefundAmount":156.82
        }
    ]
}

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| |------------------|------------------| |100094|Organization passed in the header is currently inactive| |100095|The order or return request does not belong to the current organization of the shopper profile| |100096|The organization associated to the order or return request was deleted / does not exist| |100097|The organization associated to the order or return request is currently inactive| |100098|Current operation is being performed in an organization context and the shopper profile is not associated to any organization| |100099|Current operation is being performed in an organization context and the order or return request does not belong to any organization| |200127|Internal error occurred.| |200131|Return Request Id passed in is null.| |30015|SiteId passed in x-ccsite header is currently inactive| |30014|SiteId passed in x-ccsite header is invalid or the site was deleted| |30020|The Site to which the order belongs was deleted| |30021|The Site to which the order belongs is currently inactive| |100101|The shopper profile does not belong to organization passed in the header| |100102|Organization passed in the header is invalid or does not exist| |30019|SiteId passed in x-ccsite header is not related to the order being worked upon|
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top