Description
Endpoint used to retrieve a list of return orders of a customer. These orders will come directly from the ERP system and can contain our web orders but also orders placed in the shop or by phone.
Note that the orders should be returned in reversed order. The return order history is shown on the shop in a paged manner. The first page contains the most recent orders with the latest order on top of the list.
A new field "context" is introduced in the request body. When configured this object contains key value pairs (e.g. divisionCode).
URL: /Shoxl/v1/GetReturnOrders Method: POST
Request body:
}
Response body:
}
}
Parameter
Type
Description
accountNumber
string required
The (project) account number of the customer.
pageNumber
integer($int32)
The number of the page. The page numbering is 1-based: first page has number 1.
pageSize
integer($int32)
The maximum number of items to be returned on a page.
context
object
A generic object designed to hold key-value pairs for the purpose of providing customer-specific fields.
Parameter
Type
Description
errorCode
string nullable: true
An error code returned by the ERP system
errorDescription
string nullable: true
The error description related to the error code returned by the ERP system
orders
[ReturnOrderItem]
A list of ReturnOrderItems, the ComplexType ReturnOrderItem contains some order details like; order date and order number. For the complete description check the ReturnOrderItem section in the documentation. The maximum number of orders returned by ERP is determined by the pageSize parameter of the request.
request
GetReturnOrdersRequest
The request sent by the Shoxl Shop.
totalPages
integer($int32)
Total number of pages with results
pageNumber
integer($int32)
The number of the page
Parameter
Type
Description
orderDate
string($date-time)
The order date
orderNumber
string nullable: true
The Shoxl Shop unique order number
orderState
integer($int32)
Orderstate: 1 = Open, 2 = Closed. State should be derived form orderlinestates: 1 means 1 or more lines have state ToReturn, PartiallyReturned or Returned, 2 means all lines have status Credited or Cancelled.
reference
string nullable: true
The customer order reference