获取订单下的所有发货单
GET https://{handle}.myshopline.com/admin/openapi/v20260301/orders/:order_id/fulfillments.json
handle :店铺的唯一标识符,值为店铺域名的前缀。例如,域名为 open001.myshopline.com 的店铺,其 handle 是 open001 。获取某个订单下的所有发货单。
路径参数
- order_id string required订单的的唯一标识 ID。最大长度限制:26例子:
21057401932826316666967110
请求头
- Content-Type string required字段值固定为
application/json; charset=utf-8。 - Authorization string required资源的访问令牌。参考 应用授权 获取访问令牌,然后将获取到的访问令牌以 Bearer 格式传入。例子:
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
状态码
- 200
- 401
- 429
更多状态码信息,参考 HTTP 状态码。
响应头
traceId
请求的全局唯一标识符。用于追踪请求在系统中的流转,以便于问题发生时进行定位和调试。
响应体
fulfillmentsobject[]
发货单详情。id string发货单 ID。例子:4005740193290131085320line_itemsobject[]
订单包裹的商品列表。fulfillable_quantity integer商品行维度剩余可履约的商品数量。fulfillment_quantity integer已发货数量。fulfillment_status string发货状态。有效枚举值包含:unshipped:未发货partial:部分发货shipped:已发货
grams double商品总重量,单位:g。id string商品快照表的唯一标识 ID,系统生成,与订单号唯一确认一个商品。name string商品款式的标题。price string商品价格。price_setobject
商品售价, 以店铺币种金额和买家币种金额展示。product_id string商品的唯一标识符 ID。例子:"343342675"propertiesobject[]
附加信息详情。additional string附加信息。例子:" add-on information "name string自定义属性名称。例子:" picture "type string附加信息类型。有效枚举值包含:text:文本类型picture:图片类型link:链接类型
urls array商品域名列表。例子:["[\"https://www.myshopline.com\"]"]value string自定义属性值。例子:valuequantity integer商品款式的数量。例子:1requires_shipping boolean该商品是否需要发货。true:需要发货false:不需要发货
例子:truesku string商品条码。例子:"183423409238904944"tax_linesobject[]
税费列表。name string税费名。例子:" item tax "price string税费金额。商品实际收税以此字段金额为准。例子:"10.00"price_setobject
税费金额。分别以买家币种金额和店铺币种金额展示。rate string税率。该信息只做展示作用。title string税费说明标题。该信息只做展示作用。taxable boolean该商品是否需要收税。true:需要收税false:不需要收税
例子:truetitle string商品标题,用于展示给买家。最大长度限制:255total_discount string总共的优惠价格。total_discount_setobject
商品折扣总和,分别以店铺币种金额和买家币种金额展示。variant_id string商品款式的唯一标识 ID,即 SKU。最大长度限制:64variant_title string商品属性值。vendor string供应商。version string商品版本。name string包裹名称。order_id string订单的的唯一标识 ID。最大长度限制:26例子:21057401932826316666967110shipment_status string物流状态。有效枚举值包含:out_for_delivery:正在配送delivered:已送达faliure:配送失败picked_up:已取货
status string订单包裹的发货状态。有效枚举值包含:success:发货成功cancelled:已取消发货
tracking_company string物流公司名称。废弃: 该字段自 API 版本 v20250601 起已废弃。参考tracking_info_list字段查看相关信息。tracking_info_listobject[]
物流追踪信息列表,若指定该入参,则单个入参的tracking_url、tracking_number、tracking_company被拦截。最多传入 10 个追踪信息。tracking_company string物流服务商。tracking_number string物流单号。tracking_url string追踪链接。tracking_number string第三方物流单号。废弃: 该字段自 API 版本 v20250601 起已废弃。参考tracking_info_list字段查看相关信息。tracking_numbers array第三方物流单号列表。废弃:该字段自 API 版本 v20250301 起已废弃。tracking_url string物流跟踪 URL。废弃: 该字段自 API 版本 v20250601 起已废弃。参考tracking_info_list字段查看相关信息。tracking_urls array物流追踪域名列表。废弃:该字段自 API 版本 v20250301 起已废弃。updated_at string物流信息的更新的时间。格式:ISO 8601。例子:2021-08-31T02:20:26+08:00
API Explorer
调试台
这篇文章对你有帮助吗?