Back

Search

Search

Methods

Inventory

OrderPrintStatus
Orders

ReturnsRefunds /GetReturnOptions

Allows 150 calls per minute

Response: GetReturnOptionsResponse



Returns channel-specific information regarding the types of refund that can be applied to the given order

Parameters

NameTypeDescription
requestGetReturnOptionsRequestThe request class for this call

Permissions

GlobalPermissions.OrderBook.ReturnsRefunds.ReturnsExchanges.ViewReturnsExchangesNode

Example Request

The following request format is required for this method.

Endpoint URL

GET | POST https://eu-ext.linnworks.net/api/ReturnsRefunds/GetReturnOptions

Headers

Connection: keep-alive
Accept: application/json
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Accept-Encoding: gzip, deflate
Authorization: INSERT_YOUR_TOKEN_HERE

Request Body

This is an example of the request structure. Results will vary depending on your data.

request={
  "OrderId": "49e65846-51de-47a5-b32b-9d65bbd4fd7e",
  "RMAHeaderId": 1
}

Response

This is an example of the response JSON. Results will vary depending on your data.

{
  "ReturnOptions": {
    "CanReturn": false,
    "CanReturnInternally": true,
    "MustHaveRefund": false,
    "RefundAutoPopulated": false,
    "CanHaveRefund": false,
    "ReturnReasons": [],
    "SubStatuses": [
      {
        "StatusTag": "BOOKED_BY_SELLER",
        "StatusDescription": "RMA is booked in the system by the seller. Awaiting confirmation.",
        "Actionable": true,
        "ActionDescription": "Actioning this refund will trigger it to be sent to the channel, if RMA Notes feature is enabled in the config.",
        "EditableFields": []
      },
      {
        "StatusTag": "BOOKED_BY_BUYER",
        "StatusDescription": "RMA request created by the buyer and is booked in the system. Awaiting confirmation.",
        "Actionable": true,
        "ActionDescription": "Actioning this refund will trigger it to be confirmed on the channel, if RMA Notes feature is enabled in the config.",
        "EditableFields": []
      },
      {
        "StatusTag": "UNKNOWN",
        "StatusDescription": "Status is unknown, please check on the channel",
        "Actionable": false,
        "ActionDescription": null,
        "EditableFields": []
      },
      {
        "StatusTag": "PENDING",
        "StatusDescription": "RMA is currently pending to be sent to the channel",
        "Actionable": false,
        "ActionDescription": null,
        "EditableFields": []
      },
      {
        "StatusTag": "SUBMITTED",
        "StatusDescription": "RMA was submitted to the channel and awaiting confirmation.",
        "Actionable": false,
        "ActionDescription": null,
        "EditableFields": []
      },
      {
        "StatusTag": "REFUNDED_ON_CHANNEL",
        "StatusDescription": "RMA has been processed as part of the return.",
        "Actionable": false,
        "ActionDescription": null,
        "EditableFields": []
      }
    ],
    "RefundOptions": {
      "CanRefund": false,
      "CanRefundInternally": true,
      "CanRefundItems": true,
      "CanRefundServices": true,
      "CanRefundShipping": true,
      "CanRefundShippingIndependently": true,
      "CanRefundAdditionally": true,
      "CanRefundFreeText": true,
      "CanInsufficientRefundFreeText": true,
      "RefundFreeTextOrNoteMaxLength": 255,
      "SubStatuses": [
        {
          "StatusTag": "BOOKED_BY_SELLER",
          "StatusDescription": "Refund is booked in the system by the seller. Awaiting confirmation.",
          "Actionable": true,
          "ActionDescription": "Actioning this refund will trigger it to be sent to the channel, if Refund Notes feature is enabled in the config.",
          "EditableFields": []
        },
        {
          "StatusTag": "BOOKED_BY_BUYER",
          "StatusDescription": "Refund request created by the buyer and is booked in the system. Awaiting confirmation.",
          "Actionable": true,
          "ActionDescription": "Actioning this refund will trigger it to be confirmed on the channel, if Refund Notes feature is enabled in the config.",
          "EditableFields": []
        },
        {
          "StatusTag": "UNKNOWN",
          "StatusDescription": "Status is unknown, please check on the channel",
          "Actionable": false,
          "ActionDescription": null,
          "EditableFields": []
        },
        {
          "StatusTag": "PENDING",
          "StatusDescription": "Refund is currently pending to be sent to the channel",
          "Actionable": false,
          "ActionDescription": null,
          "EditableFields": []
        },
        {
          "StatusTag": "SUBMITTED",
          "StatusDescription": "Refund was submitted to the channel and awaiting confirmation.",
          "Actionable": false,
          "ActionDescription": null,
          "EditableFields": []
        },
        {
          "StatusTag": "REFUNDED_ON_CHANNEL",
          "StatusDescription": "Refund has been processed as part of the return.",
          "Actionable": false,
          "ActionDescription": null,
          "EditableFields": []
        }
      ],
      "InsufficientRefundReasons": [],
      "ItemRefundReasons": [],
      "ServiceRefundReasons": [],
      "ShippingRefundReasons": [],
      "CannotRefundReason": 0,
      "Order": null,
      "RefundHeader": {
        "RefundHeaderId": 1,
        "OrderId": "c14a3f45-9fbd-4787-9603-2f5b52523b65",
        "NumOrderId": 3,
        "ExternalReference": "sample string 4",
        "CreatedDate": "2023-01-10T13:49:46.7838804+00:00",
        "Currency": "sample string 6",
        "Amount": 7.0,
        "Status": {
          "StatusHeader": 0,
          "StatusDetail": {
            "StatusTag": "sample string 1",
            "StatusDescription": "sample string 2",
            "Actionable": true,
            "ActionDescription": "sample string 4",
            "EditableFields": [
              "sample string 1"
            ]
          }
        },
        "Actioned": true,
        "LastActionDate": "2023-01-10T13:49:46.7838804+00:00",
        "OrderSource": "sample string 10",
        "OrderSubSource": "sample string 11",
        "ChannelInitiated": true,
        "RefundLines": null,
        "RefundLink": "sample string 13"
      },
      "AllExistingRefunds": null,
      "Errors": [
        "The ConnectionString property has not been initialized."
      ]
    },
    "CannotReturnReason": 0,
    "Order": null,
    "RMAHeader": {
      "RMAHeaderId": 1,
      "OrderId": "7d893c01-e07a-4236-b070-8f31125689f4",
      "NumOrderId": 3,
      "OrderSource": "sample string 4",
      "OrderSubSource": "sample string 5",
      "ExternalReference": "sample string 6",
      "ChannelInitiated": true,
      "CreatedDate": "2023-01-10T13:49:46.7892218+00:00",
      "Status": {
      },
      "Actioned": true,
      "LastActionDate": "2023-01-10T13:49:46.7892218+00:00",
      "RMALines": [
        {
          "RMARowId": 1,
          "RMAHeaderId": 2,
          "Type": 0,
          "Status": {
          },
          "ExternalReference": "sample string 3",
          "CreatedDate": "2023-01-10T13:49:46.7892218+00:00",
          "Actioned": true,
          "ActionedDate": "2023-01-10T13:49:46.7892218+00:00",
          "Deleted": true,
          "ResendQuantity": 7,
          "NewOrderId": "8383642e-d46f-4769-9b73-3b6a524c7544",
          "ValidationError": "sample string 10",
          "Error": "sample string 10",
          "Errors": [
            {
              "RMARowId": 1,
              "ErrorMessage": "sample string 2",
              "DateStamp": "2023-01-10T13:49:46.7892218+00:00",
              "Acknowledged": true
            }
          ],
          "Info": "sample string 11",
          "ExchangeStockItemId": "a7a2ade9-8859-45bb-ad40-afc8ebd7defc",
          "ExchangeSKU": "sample string 13",
          "ExchangeTitle": "sample string 14",
          "ExchangeQuantity": 15,
          "DespatchLocationId": "52a67a43-efa3-4a6d-8427-14cf4206d4ee",
          "AdditionalCost": 17.0,
          "OrderItemRowId": "335ae172-cac2-4221-a47a-5aad77753ba5",
          "ReturnItemSKU": "sample string 19",
          "ReturnItemTitle": "sample string 20",
          "BatchInventoryId": 1,
          "ReturnLocation": "f8d8399c-f7a8-491c-ae8a-b4d36fe0d77e",
          "ReturnQuantity": 22,
          "RefundAmount": 23.0,
          "RefundRowId": "260df609-8e7f-4a6a-af44-94f1bdce1e2f",
          "ScrapQuantity": 24,
          "ReasonCategory": "sample string 25",
          "IsFreeText": false,
          "Reason": "sample string 26",
          "ReasonTag": "sample string 27",
          "SubReasonTag": "sample string 28",
          "BinrackOverride": "sample string 29"
        }
      ]
    },
    "AllExistingRMAs": null,
    "Errors": [
      "The ConnectionString property has not been initialized."
    ],
    "Info": []
  }
}