Get Return Information

The Get Return API retrieves information about a return. The request requires for the return to be in existence, so the Create Return API must have been called first.

The data returned by this request is the exact same as in the previous version of OMS, as the Unified Commerce platform supports backwards compatibility for this API. The only change to this request is the format of the base endpoint, as shown in the below table. Remember to provide the x-vol-tenant key for authentication in the headers.

Example

The Get Return API call requires only one piece of data to be appended to the endpoint: the Return ID that was generated when the return case was created. Otherwise, it is a standard GET call as defined with the above table. In this example, the return includes these particular properties:

• Status – CLOSED
• Disposition Reason – Item did not fit
• Refund Type – STANDARD

The response will provide general information about the return and its associated order or shipment, if one was provided, followed by the details of the item.

General Information

The following information about the return will also be included in the response:

• Totals
• Timestamps
• Order and Shipment IDs
• Item Being Returned

"returnID": 000000,
    "status": "CLOSED",
    "returnTotal": 76.95,
    "fulfillerTotal": 69.64,
    "createdTime": "2017-01-13T19:27:27+0000",
    "confirmTime": "2017-01-13T19:27:41+0000",
    "clearedTime": "2017-01-16T08:10:47+0000",
    "orderID": 1234567,
    "shipmentID": 101010101,
    "returnLocation": 555555,

Item Information

Details about the item or items being returned follow the general information. This includes various identification parameters as well as subtotal, status, item options, and the reason for the return.

"item": [
        {
            "returnItemID": 111111,
            "orderItemID": 0101010,
            "quantity": 1,
            "returnSubtotal": 76.95,
            "fulfillerSubtotal": 69.64,
            "partNumber": "000-11111-22-3",
            "UPC": "0123456789",
            "partName": "Shirt",
            "status": "ACCEPTED",
            "reason": "Item did not fit.",
            "options": [
                "color: Blue"
            ]
        }

The Full Request

Using the URL format as outlined above, the entire call is simple to put together. This will return all of the information for the return used in the previous example snippets.

https://{tenantId}-translation.mozu.com/api/v2/return/000000

The Full Response

This is the complete payload returned by the API. It is the simple combination of the above general and item information sections.

{
    "returnID": 000000,
    "status": "CLOSED",
    "returnTotal": 76.95,
    "fulfillerTotal": 69.64,
    "createdTime": "2017-01-13T19:27:27+0000",
    "confirmTime": "2017-01-13T19:27:41+0000",
    "clearedTime": "2017-01-16T08:10:47+0000",
    "orderID": 1234567,
    "shipmentID": 101010101,
    "returnLocation": 555555,
    "item": [
        {
            "returnItemID": 111111,
            "orderItemID": 0101010,
            "quantity": 1,
            "returnSubtotal": 76.95,
            "fulfillerSubtotal": 69.64,
            "partNumber": "000-11111-22-3",
            "UPC": "0123456789",
            "partName": "Shirt",
            "status": "ACCEPTED",
            "reason": "Item did not fit.",
            "options": [
                "color: Blue"
            ]
        }
    ],
    "externalOrderID": "000000000",
    "refundType": "STANDARD"
}