查询履约列表

GET 
/openapi/2026-07/orders/:order_id/fulfillments

分页返回订单的履约列表。

请求

Path参数

order_id string必填

订单 ID

Query参数

cursor string

分页游标

page_size int32

每页记录数

created_at_min string

筛选创建时间不早于该时间点的履约；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

created_at_max string

筛选创建时间不晚于该时间点的履约；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

updated_at_min string

筛选最后更新时间不早于该时间点的履约；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

updated_at_max string

筛选最后更新时间不晚于该时间点的履约；ISO-8601 格式（例如 2023-01-01T00:00:00Z）

响应

200

OK

application/json

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

fulfillments object[]

履约列表

Array [

idstring

履约 ID

order_idstring

订单 ID

statusstring

物流单状态：

• pending: 待发货
• shipped: 已发货
• finished: 已完成
• cancelled: 已取消

created_atstring

创建时间（ISO-8601 格式）

updated_atstring

最后更新时间（ISO-8601 格式）

tracking_companystring

物流商

tracking_numberstring

运单号

tracking_company_codestring

物流商编码

line_items object[]

本次履约包含的订单商品项列表

Array [

idstring

订单商品项 ID

product_idstring

商品 ID

product_titlestring

已购商品名称

variant_idstring

子款式 ID

variant_titlestring

子款式标题，例如 Blue, Size M

quantityuint32

已购该商品的数量

notestring

订单商品项的商品备注

image object

商品图片

srcstring

图片来源 URL

widthint32

图片宽度（像素）

heightint32

图片高度（像素）

altstring

图片替代文本

pricestring

售价

compare_at_pricestring

划线价

total_pricestring

总价

fulfillment_statusstring

订单商品项的履约状态，例如 fulfilled（已履约）、unfulfilled（未履约）；详见履约状态文档

skustring

SKU

weightstring

商品重量

weight_unitstring

商品重量的计量单位，例如 kg、lbs

vendorstring

商品供应商

product_urlstring

商品页面 URL

created_atstring

创建时间（ISO-8601 格式）

updated_atstring

最后更新时间（ISO-8601 格式）

options object[]

订单商品项关联的商品款式属性列表

Array [

namestring

商品款式属性名称

valuestring

商品款式属性值

]

product_slugstring

商品的 URL 友好标识

taxableboolean

是否需要纳税

requires_shippingboolean

订单商品项是否需要物流

spustring

标准商品单元（SPU）

product_tagsstring

商品标签

refund_quantity_totaluint32

退款数量

ship_quantityuint32

发货数量

customboolean

是否为自定义商品项

trunk_pricestring

主干价格

discount_applicationsstring

订单商品项运费的折扣应用数量

tax_pricestring

订单商品项的税费

duty_pricestring

关税费用

payment_discount_pricestring

应用于订单商品项的支付折扣金额

custom_propertiesobject

订单商品项的自定义属性（如尺码、颜色等），JSON 格式

]

tracking_urlstring

物流链接

phone_numberstring

电话号码

]

cursorstring

下一页游标

has_moreboolean

是否有更多记录

示例

{
  "code": "string",
  "message": "string",
  "data": {
    "fulfillments": [
      {
        "id": "string",
        "order_id": "string",
        "status": "string",
        "created_at": "string",
        "updated_at": "string",
        "tracking_company": "string",
        "tracking_number": "string",
        "tracking_company_code": "string",
        "line_items": [
          {
            "id": "string",
            "product_id": "string",
            "product_title": "string",
            "variant_id": "string",
            "variant_title": "string",
            "quantity": 0,
            "note": "string",
            "image": {
              "src": "string",
              "width": 0,
              "height": 0,
              "alt": "string"
            },
            "price": "string",
            "compare_at_price": "string",
            "total_price": "string",
            "fulfillment_status": "string",
            "sku": "string",
            "weight": "string",
            "weight_unit": "string",
            "vendor": "string",
            "product_url": "string",
            "created_at": "string",
            "updated_at": "string",
            "options": [
              {
                "name": "string",
                "value": "string"
              }
            ],
            "product_slug": "string",
            "taxable": true,
            "requires_shipping": true,
            "spu": "string",
            "product_tags": "string",
            "refund_quantity_total": 0,
            "ship_quantity": 0,
            "custom": true,
            "trunk_price": "string",
            "discount_applications": "string",
            "tax_price": "string",
            "duty_price": "string",
            "payment_discount_price": "string",
            "custom_properties": {}
          }
        ],
        "tracking_url": "string",
        "phone_number": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}