Update logistics information for a Return Fulfillment

Requires write_return access scope.

For more info, refer to:

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

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

Request Body

id string

Return invoice id
Example: RPP5873267430525507606
reunrn_id string

Return shipping idy
Example: 2605873267426331203599
tracking_infoobject

Logistics information
tracking_company string

Logistics company name
Example: DHL Express (Piece ID)
tracking_number string

Third party tracking number
Example: 5345345345
tracking_url string

Logistics tracking URL
Example: http://www.dhl.com/

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

return_packagesobject[]

Return invoice
id string

Return invoice unique business id
Example: RPP5873267430525507605
return_id string

Associated return id
Example: 2605873267426331203599
reverse_delivery_line_itemsobject[]

Return invoice Product line information
id string

Return invoice Product line number
Example: 2605860580357012238342
quantity integer

Return invoice Product quantity
Example: 1
reverse_fulfillment_order_line_itemobject

Return shipping list Product line information node associated with return invoice
line_itemobject

Fahuodan line information associated with invoice
tags string

Product tag , separated by ',' when there are multiple
Example: sales
fulfillable_quantity integer

Remaining Product number of required
Example: 1
fulfillment_service string

Logistics company name
Example: Sf international
taxable boolean

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

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

Wei for gift cards or not : false、true
Example: true
variant_title string

Product attribute value , multiple divided by " / "
Example: L/Red
image_url string

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

Merchant custom number
Example: SKU1234
quantity integer

Product quantity
Example: 1
id string

Product row id
Example: 405
name string

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

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

Product delivery status : fulfilled- shipped ; partial- partially shipped ; null- not shipped
Example: fulfilled
requires_shipping boolean

Product need to be shipped : false、true
Example: true
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
vendor string

Product supplier
variant_id string

Product SKU serial number
Example: 18056898121355865678441487
grams double

Product weight ( grams )
Example: 1
propertiesobject[]

Product customization information
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
name string

Custom information object
Example: Text
quantity integer

Associated return units approximately Product line quantity
Example: 2
reverse_fulfillment_seq string

Related return item order number
tracking_informationobject

Logistics information
tracking_company string

Logistics company name
Example: DHL Express (Piece ID)
tracking_number string

Third party tracking number
Example: 5345345345
tracking_url string

Logistics tracking URL
Example: http://www.dhl.com/

API Explorer

Debugger

Base URL

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

ParamOptions

Authorization — header required

Body

Body required

{
  "id": "RPP5873267430525507606",
  "reunrn_id": "2605873267426331203599",
  "tracking_info": {
    "tracking_number": "5345345345",
    "tracking_url": "http://www.dhl.com/",
    "tracking_company": "DHL Express (Piece ID)"
  }
}

Language

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