Update tracking number

Requires write_orders access scope.
For more info, refer to:
access permission.
POST https://{handle}.myshopline.com/admin/openapi/v20260301/orders/:order_id/fulfillments/:fulfillment_id/update_tracking.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 .
Update tracking number
Path Parameters
  • fulfillment_id string required
    Package ID
  • order_id string required
    Order number
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
  • fulfillmentobject required
    Package information
  • tracking_infoobject
    Logistics information.
    DEPRECATED: This parameter is deprecated from API version v20250601. Refer to tracking_info_list.
  • number string
    Tracking number
    Example: "1123212"
  • url string
    Logistics tracking URL
    Example: "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345"
  • company string
    For logistics companies, see the document for enumeration: https://shopline.yuque.com/docs/share/cfb1e1ca-aede-43e9-b1e6-59ab47fd7d0f?# "Logistics company name enumeration information"
    Example: "4PX"
  • tracking_info_listobject[]
    If this parameter is specified, the individual parameters tracking_url, tracking_number, and tracking_company will be ignored.Maximum of 10 tracking infos allowed.
  • tracking_company string
    Logistics company name.
  • tracking_number string
    Tracking number.
  • tracking_url string
    Logistics tracking URL.
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
  • fulfillmentobject
    Package information
  • status string
    Logistics delivery status, success-shipped; cancelled-cancelled;
    Example: "success-shipped"
  • tracking_number string
    Tracking number
    DEPRECATED: This parameter is deprecated from API version v20250601. Refer to tracking_info_list for related information.
    Example: "UG198768340YP"
  • tracking_numbers array
    Tracking number array
    Example: ["[\"UG198768340YP\"]"]
  • tracking_url string
    Logistics tracking URL
    DEPRECATED: This parameter is deprecated from API version v20250601. Refer to tracking_info_list for related information.
    Example: "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345"
  • name string
    Package
    Example: "#21057116277667827637773776.1"
  • shipment_status string
    Package tracking
    Example: "delivered"
  • tracking_company string
    Logistics company name
    DEPRECATED: This parameter is deprecated from API version v20250601. Refer to tracking_info_list for related information.
    Example: "Other"
  • tracking_info_listobject[]
    If this parameter is specified, the individual parameters tracking_url, tracking_number, and tracking_company will be ignored.Maximum of 10 tracking infos allowed.
  • tracking_company string
    The logistics service provider.
  • tracking_number string
    The tracking number.
  • tracking_url string
    The URL for tracking the package.
  • tracking_urls array
    Logistics tracking URL group
    Example: ["[\"\"https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345\"\"]"]
  • updated_at string
    Update time
    Example: 2022-10-21T08:56:20-04:00
  • created_at string
    Creation date
  • id string
    Package ID
    Example: "4005740193290131085320"
  • line_itemsobject[]
    Item group
  • requires_shipping boolean
    Shipping or not
    Example: true
  • sku string
    Product code
    Example: "183423409238904944"
  • tax_linesobject[]
    Tax
  • price string
    Amount
    Example: "10.00"
  • price_setobject
    Multi-currency amount
  • presentment_moneyobject
    Settlement currency
  • amount string
    Amount
    Example: "10.00"
  • currency_code string
    Currency
    Example: "USD"
  • shop_moneyobject
    Store currency
  • currency_code string
    Currency
    Example: "USD"
  • amount string
    Amount
    Example: "10.00"
  • rate string
    Tax rate
    Example: "1.00"
  • title string
    Tax name
    Example: " Product tax "
  • variant_id string
    Product variant ID
    Example: "183423409238904944"
  • name string
    Product name
    Example: Trade name
  • quantity integer
    Product quantity shipped
    Example: 1
  • total_discount string
    Discount amount
    Example: "0.00"
  • fulfillable_quantity integer
    Available quantity
    Example: 1
  • id string
    Product ID
    Example: "466157049"
  • price string
    Price
    Example: "100.00"
  • price_setobject
    Multi-currency prices
  • presentment_moneyobject
    Settlement currency
  • amount string
    Amount
    Example: "100.00"
  • currency_code string
    Currency
    Example: "USD"
  • shop_moneyobject
    Store currency
  • amount string
    Amount
    Example: "100.00"
  • currency_code string
    Currency
    Example: "USD"
  • title string
    Product title
    Example: "Draft"
  • total_discount_setobject
    Multi-currency discount
  • presentment_moneyobject
    Settlement currency
  • amount string
    Amount
    Example: "0.00"
  • currency_code string
    Currency
    Example: "USD"
  • shop_moneyobject
    Store currency
  • currency_code string
    Currency
    Example: "USD"
  • amount string
    Amount
    Example: "0.00"
  • taxable boolean
    Tax or not？
    Example: true
  • variant_title string
    Product variant name
    Example: "Black / Bracelet / Bracelet""
  • version string
    Product version
    Example: "1"
  • grams double
    Weight
    Example: 10.5
  • product_id string
    Product ID
    Example: "343342675"
  • order_id string
    Order number
    Example: "21057116277667827637773776"
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— path required
— path required
— header required

Body

required
{
  "fulfillment": {
    "tracking_info": {
      "company": "\"4PX\"",
      "number": "\"1123212\"",
      "url": "\"https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2345\""
    },
    "tracking_info_list": [
      {
        "tracking_company": "",
        "tracking_number": "",
        "tracking_url": ""
      }
    ]
  }
}

Language

curl --request POST \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/orders/order_id/fulfillments/fulfillment_id/update_tracking.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
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.