Query Return Fulfillment Order

Requires read_returns access scope.

For more info, refer to:

GET https://{handle}.myshopline.com/admin/openapi/v20260301/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 string required

The field must be set to the fixed value application/json; charset=utf-8.
Authorization string required

The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
Example:

Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Status Codes

For the complete list of codes and messages, see Http status code.

Response Headers

traceId

A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.

Response Body

order_return_fulfillment_listobject[]

Return order
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
fulfillment_line_itemobject

Invoice Product line detail node
quantity integer

Number of invoices
line_itemobject

Fahuodan line information associated with invoice
product_id string

Spu serial number , Product unique identification number
Example: 16056898121352174690861487
quantity integer

Product quantity
Example: 1
tags string

Product tag , separated by ',' when there are multiple
Example: sales
fulfillment_status string

Product delivery status : fulfilled- shipped ; partial- partially shipped ; null- not shipped
Example: fulfilled
fulfillable_quantity integer

Remaining Product number of required
Example: 1
image_url string

Product link url
Example: https://image.shopline.com/abc.jpg
price string

Product selling price , Product detail page sale price
Example: 100.0
vendor string

Product supplier
Example: product supplier
title string

Gpu Product title
Example: It's good Product
variant_id string

Product SKU serial number
Example: 18056898121355865678441487
attribute string

Product attribute information : name-attribute value , multiple attribute values are measured comma
Example: Color-red , size-x
taxable boolean

Product incl . : false、true
Example: true
fulfillment_service string

Logistics company name
Example: Sf international
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
grams double

Product weight ( grams )
Example: 1
name string

SKU title, same as title
Example: It's good Product
id string

Product row id
Example: 405
sku string

Merchant custom number
Example: SKU1234
variant_title string

Product attribute value , multiple divided by " / "
Example: L/Red
requires_shipping boolean

Product need to be shipped : false、true
Example: true
gift_card boolean

Wei for gift cards or not : false、true
Example: true
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
fulfillable_quantity integer

Return quantity of order
Example: 1
status string

Return item order status
Example: OPEN
third_party_confirmation string

Third party logistics carrier confirmation results
Example: success
id string

Unique business id
Example: 2605860580357012238342

API Explorer

Debugger

Base URL

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

ParamOptions

Authorization — header required

return_id — query

Language

curl --request GET \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/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