Back

Search

Search

Methods

Inventory

Orders

ReturnsRefunds /SearchReturnsRefundsPaged

Response: GenericPagedResult<ReturnsRefundsWeb>



Searches through returns/refunds history that meets the parameters' criteria

Parameters

NameTypeDescription
fromNullable<DateTime>The lower end of the date range to search. Can be null if searching for 'all dates'. Maximum range is 3 months.
toNullable<DateTime>The upper end of the date range to search. Can be null if searching for 'all dates'. Maximum range is 3 months.
dateTypeReturnsRefundsSearchDateTypeThe search type (e.g. ALLDATES)
searchFieldStringThe field to search by. Can be found by calling GetSearchTypes.
exactMatchBooleanSet to true if an exact match is required for the search data.
searchTermStringThe term which you are searching for.
pageNumInt32The page number of the request.
numEntriesPerPageInt32The number of entries required on a page. Maximum 200.
historyTypeHistoryTypeSearch type. Allow RETURNS or REFUNDS

HTTP Endpoint

Server /ReturnsRefunds / SearchReturnsRefundsPaged

Permissions

GlobalPermissions.OrderBook.ReturnsRefunds.ReturnsRefundsNode

Example Code

Example Request

The following request format is required for this method.

POST https://eu-ext.linnworks.net//api/ReturnsRefunds/SearchReturnsRefundsPaged HTTP/1.1
Host: eu-ext.linnworks.net
Connection: keep-alive
Accept: application/json, text/javascript, */*; q=0.01
Origin: https://www.linnworks.net
Accept-Language: en
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/42.0.2311.90 Safari/537.36
Content-Type: application/x-www-form-urlencoded; charset=UTF-8
Referer: https://www.linnworks.net/
Accept-Encoding: gzip, deflate
Authorization: INSERT_YOUR_TOKEN_HERE

from=2018-02-19T16:57:06.1802155+00:00&to=2018-02-19T16:57:06.1802155+00:00&dateType=0&searchField=sample string 1&exactMatch=true&searchTerm=sample string 1&pageNum=1&numEntriesPerPage=1&historyType=0

Response

This is an example response. Results may vary depending on your data.

{
  "PageNumber": 1,
  "EntriesPerPage": 2,
  "TotalEntries": 3,
  "TotalPages": 2,
  "Data": [
    {
      "Row": 1,
      "pkOrderID": "a440f363-258c-4080-b912-5d999ee33ac6",
      "cShippingAddress": "sample string 3",
      "dProcessedOn": "2018-02-19T16:57:07.6398711+00:00",
      "fPostageCost": 5.1,
      "fTotalCharge": 6.1,
      "PostageCostExTax": 7.1,
      "Subtotal": 8.1,
      "fTax": 9.1,
      "TotalDiscount": 10.1,
      "CountryTaxRate": 11.1,
      "nOrderId": 12,
      "cCurrency": "sample string 13",
      "PostalTrackingNumber": "sample string 14",
      "cCountry": "sample string 15",
      "Source": "sample string 16",
      "PostalServiceName": "sample string 17",
      "PostalServiceCode": "sample string 18",
      "Vendor": "sample string 19",
      "ReferenceNum": "sample string 20",
      "SecondaryReference": "sample string 21",
      "ExternalReference": "sample string 22",
      "Address1": "sample string 23",
      "Address2": "sample string 24",
      "Address3": "sample string 25",
      "Town": "sample string 26",
      "Region": "sample string 27",
      "BuyerPhoneNumber": "sample string 28",
      "Company": "sample string 29",
      "SubSource": "sample string 30",
      "ChannelBuyerName": "sample string 31",
      "AccountName": "sample string 32",
      "cFullName": "sample string 33",
      "cEmailAddress": "sample string 34",
      "cPostCode": "sample string 35",
      "dPaidOn": "2018-02-19T16:57:07.641375+00:00",
      "cBillingAddress": "sample string 37",
      "BillingName": "sample string 38",
      "BillingCompany": "sample string 39",
      "BillingAddress1": "sample string 40",
      "BillingAddress2": "sample string 41",
      "BillingAddress3": "sample string 42",
      "BillingTown": "sample string 43",
      "BillingRegion": "sample string 44",
      "BillingPostCode": "sample string 45",
      "BillingCountryName": "sample string 46",
      "BillingPhoneNumber": "sample string 47",
      "cItemNumber": "sample string 48",
      "cItemName": "sample string 49",
      "pkReturnId": 50,
      "RowType": "sample string 51",
      "ReturnReference": "sample string 52",
      "PendingRefundAmount": 53.1,
      "LastDate": "2018-02-19T16:57:07.6423774+00:00",
      "Reason": "sample string 55",
      "ChannelReason": "sample string 56",
      "ChannelReasonSec": "sample string 57",
      "Category": "sample string 58",
      "ReturnQty": 59,
      "fkReturnLocationId": "4aca3c96-0313-4cff-9fcb-bcada644de9a",
      "Scrapped": true,
      "ScrapQty": 1,
      "ReturnDate": "2018-02-19T16:57:07.6433804+00:00",
      "Location": "sample string 63",
      "ItemNumber": "sample string 64",
      "ItemTitle": "sample string 65",
      "NewQty": 66,
      "RefundReference": "sample string 67",
      "pkRefundRowId": "e0e1c766-791b-4513-b7a2-0c8870844614",
      "Amount": 69.1,
      "CreateDate": "2018-02-19T16:57:07.6438819+00:00",
      "CancellationQuantity": 71,
      "fkOrderItemReturnId": "a15f9323-26ed-4c79-aa95-9465df77cba3",
      "ActionDate": "2018-02-19T16:57:07.6438819+00:00",
      "RefundStatus": 0
    },
    {
      "Row": 1,
      "pkOrderID": "a440f363-258c-4080-b912-5d999ee33ac6",
      "cShippingAddress": "sample string 3",
      "dProcessedOn": "2018-02-19T16:57:07.6398711+00:00",
      "fPostageCost": 5.1,
      "fTotalCharge": 6.1,
      "PostageCostExTax": 7.1,
      "Subtotal": 8.1,
      "fTax": 9.1,
      "TotalDiscount": 10.1,
      "CountryTaxRate": 11.1,
      "nOrderId": 12,
      "cCurrency": "sample string 13",
      "PostalTrackingNumber": "sample string 14",
      "cCountry": "sample string 15",
      "Source": "sample string 16",
      "PostalServiceName": "sample string 17",
      "PostalServiceCode": "sample string 18",
      "Vendor": "sample string 19",
      "ReferenceNum": "sample string 20",
      "SecondaryReference": "sample string 21",
      "ExternalReference": "sample string 22",
      "Address1": "sample string 23",
      "Address2": "sample string 24",
      "Address3": "sample string 25",
      "Town": "sample string 26",
      "Region": "sample string 27",
      "BuyerPhoneNumber": "sample string 28",
      "Company": "sample string 29",
      "SubSource": "sample string 30",
      "ChannelBuyerName": "sample string 31",
      "AccountName": "sample string 32",
      "cFullName": "sample string 33",
      "cEmailAddress": "sample string 34",
      "cPostCode": "sample string 35",
      "dPaidOn": "2018-02-19T16:57:07.641375+00:00",
      "cBillingAddress": "sample string 37",
      "BillingName": "sample string 38",
      "BillingCompany": "sample string 39",
      "BillingAddress1": "sample string 40",
      "BillingAddress2": "sample string 41",
      "BillingAddress3": "sample string 42",
      "BillingTown": "sample string 43",
      "BillingRegion": "sample string 44",
      "BillingPostCode": "sample string 45",
      "BillingCountryName": "sample string 46",
      "BillingPhoneNumber": "sample string 47",
      "cItemNumber": "sample string 48",
      "cItemName": "sample string 49",
      "pkReturnId": 50,
      "RowType": "sample string 51",
      "ReturnReference": "sample string 52",
      "PendingRefundAmount": 53.1,
      "LastDate": "2018-02-19T16:57:07.6423774+00:00",
      "Reason": "sample string 55",
      "ChannelReason": "sample string 56",
      "ChannelReasonSec": "sample string 57",
      "Category": "sample string 58",
      "ReturnQty": 59,
      "fkReturnLocationId": "4aca3c96-0313-4cff-9fcb-bcada644de9a",
      "Scrapped": true,
      "ScrapQty": 1,
      "ReturnDate": "2018-02-19T16:57:07.6433804+00:00",
      "Location": "sample string 63",
      "ItemNumber": "sample string 64",
      "ItemTitle": "sample string 65",
      "NewQty": 66,
      "RefundReference": "sample string 67",
      "pkRefundRowId": "e0e1c766-791b-4513-b7a2-0c8870844614",
      "Amount": 69.1,
      "CreateDate": "2018-02-19T16:57:07.6438819+00:00",
      "CancellationQuantity": 71,
      "fkOrderItemReturnId": "a15f9323-26ed-4c79-aa95-9465df77cba3",
      "ActionDate": "2018-02-19T16:57:07.6438819+00:00",
      "RefundStatus": 0
    }
  ]
}