Query Return Fulfillment Order

Requires read_returns access scope.

For more info , refer to:

[]

access permission

GET https://{handle}.myshopline.com/admin/openapi/v20250601/return_fulfillment.json

[]

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

[]

Query return fulfillment order

Query Parameters

return_id string
[]
Return id

Request Headers

Content-Type required
[]
The value of this field is fixed to application/json; charset=utf-8
Authorization string required
[]
The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
Example:
[]
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Response

[]

For more information about status codes, see Http status code.

Response Headers

traceId
[]
traceId

Response Body

order_return_fulfillment_listobject[]
[]
Return order
id string
[]
Unique business id
[]
Example: 2605860580357012238342
order_id string
[]
Associated order number
[]
Example: 21058605762597644309430942
return_id string
[]
Associated return id
[]
Example: SL201AS4571636204541382726
reverse_fulfillment_order_line_itemsobject[]
[]
Return Product line information
fulfillable_quantity integer
[]
Return quantity of order
[]
Example: 1
fulfillment_line_itemobject
[]
Invoice Product line detail node
line_itemobject
[]
Fahuodan line information associated with invoice
attribute string
[]
Product attribute information : name-attribute value , multiple attribute values are measured comma
[]
Example: Color-red , size-x
fulfillable_quantity integer
[]
Remaining Product number of required
[]
Example: 1
fulfillment_service string
[]
Logistics company name
[]
Example: Sf international
fulfillment_status string
[]
Product delivery status : fulfilled- shipped ; partial- partially shipped ; null- not shipped
[]
Example: fulfilled
gift_card boolean
[]
Wei for gift cards or not : false、true
[]
Example: true
grams double
[]
Product weight ( grams )
[]
Example: 1
id string
[]
Product row id
[]
Example: 405
image_url string
[]
Product link url
[]
Example: https://image.shopline.com/abc.jpg
name string
[]
SKU title, same as title
[]
Example: It's good Product
price string
[]
Product selling price , Product detail page sale price
[]
Example: 100.0
product_id string
[]
Spu serial number , Product unique identification number
[]
Example: 16056898121352174690861487
propertiesobject[]
[]
Product customization information
name string
[]
Custom information object
[]
Example: Text
type string
[]
Custom information type : text、picture、link 1 ) when type is text , take name and value ;2 ) when type is picture , the display type is name , and the details of the thumb of urls to obtain Product 3 ) when type is link , support click urls to use the picture .
[]
Example: text
urls array
[]
Address link information
[]
Example: https://image.shopline.com
value string
[]
Customized information content
[]
Example: Freedom
quantity integer
[]
Product quantity
[]
Example: 1
requires_shipping boolean
[]
Product need to be shipped : false、true
[]
Example: true
sku string
[]
Merchant custom number
[]
Example: SKU1234
tags string
[]
Product tag , separated by ',' when there are multiple
[]
Example: sales
taxable boolean
[]
Product incl . : false、true
[]
Example: true
title string
[]
Gpu Product title
[]
Example: It's good Product
variant_id string
[]
Product SKU serial number
[]
Example: 18056898121355865678441487
variant_title string
[]
Product attribute value , multiple divided by " / "
[]
Example: L/Red
vendor string
[]
Product supplier
[]
Example: product supplier
quantity integer
[]
Number of invoices
id string
[]
Return order Product line number
[]
Example: RDP5860580372212396041
return_reason string
[]
The return reasons for the product line: COLOR(Incorrect color), DEFECTIVE(Product is damaged or defective), NOT_AS_DESCRIBED(Product does not match the description), OTHER(Other reasons), SIZE_TOO_LARGE(Size is too large), SIZE_TOO_SMALL(Size is too small), STYLE(Issues with the style), UNWANTED(Customer changed their mind), WRONG_ITEM(Received the wrong item)
[]
Example: NOT_AS_DESCRIBED
return_reason_note string
[]
Product line return reason detailed notes, maximum 128 characters supported
[]
Example: Product does not match the description
total_quantity integer
[]
Return item about the number of returns
[]
Example: 1
status string
[]
Return item order status
[]
Example: OPEN
third_party_confirmation string
[]
Third party logistics carrier confirmation results
[]
Example: success

API Explorer

Debugger

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

Authorization — header required

return_id — query

Language

curl --request GET \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/return_fulfillment.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Was this article helpful to you?

SHOPLINE

Legal