Returns channel-specific information regarding the types of refund that can be applied to the given order
Name | Type | Description |
---|---|---|
request | GetReturnOptionsRequest | The request class for this call |
The following request format is required for this method.
GET | POST https://eu-ext.linnworks.net/api/ReturnsRefunds/GetReturnOptions
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
This is an example of the request structure. Results will vary depending on your data.
request={
"OrderId": "49e65846-51de-47a5-b32b-9d65bbd4fd7e",
"RMAHeaderId": 1
}
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": []
}
}