订单--已发货的包裹信息

订单 - 获取已发货包裹列表

接口信息

  • 接口地址: {your-site-url}/api/skill/order/get-shiped-package-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/apimanager666
  • 请求方式: GET
  • 说明: 此接口用于获取指定订单已发货的包裹信息。一个订单可以分为多个快递包裹发货，每个包裹包含若干商品。

认证

请求头中需要携带 skill-access-token：

Header 值
skill-access-token {your-skill-access-token} （请替换为你自己的 token）

请求参数 (Query String)

字段 类型 必填 说明
order_id int 是 订单 ID

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/order/get-shiped-package-list?order_id=6414' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

code 为 200 表示调用成功；code 不为 200 表示调用失败。

成功响应

{
    "code": 200,
    "data": [
        {
            "id": 304,
            "shop_id": 15,
            "order_id": 6414,
            "status": 2,
            "items_count": 1,
            "total_gram": "0.00",
            "zip": "323232",
            "city": "qingdao21",
            "email": "",
            "phone": "8632132",
            "company": "",
            "country_code": "AL",
            "province_code": "",
            "address_1": "chong qing zhong lu 227",
            "address_2": "",
            "first_name": "Terry1",
            "last_name": "zhao23443",
            "tracking_company_name": "dhl",
            "tracking_number": "3421432423",
            "tracking_url": "",
            "created_at": "2026-06-02 20:56:37",
            "updated_at": "2026-06-02 20:56:37",
            "received_at": 0,
            "fulfillmentItems": [
                {
                    "id": 377,
                    "shop_id": 15,
                    "fulfillment_id": 304,
                    "order_id": 6414,
                    "order_item_id": 7800,
                    "product_id": 7047,
                    "variant_id": 48962,
                    "variant_title": "",
                    "product_title": "Diamond signet ring, Gold rings jewelry复制",
                    "image": "/product/15/image/2026/05/23/7f8a8ba65ddfb20c68fe55276d5e548c.jpg?x-oss-process=image/resize,w_400/quality,q_90",
                    "sku": "diamond-signet-ring-gold-rings-jewelry-0",
                    "spu": "",
                    "qty": 1,
                    "gram": "0.0",
                    "row_gram": "0.00",
                    "created_at": 1780404997,
                    "updated_at": 1780404997,
                    "product": {
                        "handle": "diamond-signet-ring-gold-rings-jewelry-faoqu8hv-jafztfkd",
                        "id": 7047
                    }
                }
            ],
            "can_cancel_fulfill": false
        },
        {
            "id": 303,
            "shop_id": 15,
            "order_id": 6414,
            "status": 2,
            "items_count": 1,
            "total_gram": "0.00",
            "zip": "323232",
            "city": "qingdao21",
            "email": "",
            "phone": "8632132",
            "company": "",
            "country_code": "AL",
            "province_code": "",
            "address_1": "chong qing zhong lu 227",
            "address_2": "",
            "first_name": "Terry1",
            "last_name": "zhao23443",
            "tracking_company_name": "SF",
            "tracking_number": "432432432",
            "tracking_url": "",
            "created_at": "2026-06-02 20:56:17",
            "updated_at": "2026-06-02 20:56:17",
            "received_at": 0,
            "fulfillmentItems": [
                {
                    "id": 376,
                    "shop_id": 15,
                    "fulfillment_id": 303,
                    "order_id": 6414,
                    "order_item_id": 7801,
                    "product_id": 7041,
                    "variant_id": 48946,
                    "variant_title": "M / Black",
                    "product_title": "Denim Jacket Shirt",
                    "image": "/product/15/image/2026/05/23/42faa31c715a3e62900d908b86e4087c.jpg?x-oss-process=image/resize,w_400/quality,q_90",
                    "sku": "denim-jacket-1",
                    "spu": "",
                    "qty": 1,
                    "gram": "0.0",
                    "row_gram": "0.00",
                    "created_at": 1780404977,
                    "updated_at": 1780404977,
                    "product": {
                        "handle": "denim-jacket-pw4hziw1",
                        "id": 7041
                    }
                }
            ],
            "can_cancel_fulfill": false
        }
    ],
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data Array[Object] 已发货包裹列表，每个子项为一个包裹

包裹主字段

字段 类型 说明
~.id int 包裹 ID（shipment/fulfillment ID）
~.shop_id int 店铺 ID
~.order_id int 所属订单 ID
~.status int 包裹物流状态。1 = 等待发货，2 = 已发货，3 = 已收货
~.items_count int 包裹内商品件数
~.total_gram string 包裹总重量（克）
~.first_name string 收货人名字
~.last_name string 收货人姓氏
~.phone string 收货人电话
~.email string 收货人邮箱
~.company string 公司名称
~.country_code string 国家简码
~.province_code string 省/州简码
~.city string 城市
~.address_1 string 详细地址行 1
~.address_2 string 详细地址行 2
~.zip string 邮政编码
~.tracking_company_name string 物流公司名称
~.tracking_number string 物流单号/快递单号
~.tracking_url string 物流跟踪 URL
~.created_at string 发货时间
~.updated_at string 最后更新时间
~.received_at int 收货时间。0 表示未收货
~.can_cancel_fulfill bool 是否可取消收货。当订单存在多个包裹，部分已收货、部分未收货时，已收货的包裹该值为 true，可将已收货改为未收货
~.fulfillmentItems Array[Object] 包裹中的商品列表

fulfillmentItems - 包裹内商品

字段 类型 说明
~.id int 记录 ID
~.fulfillment_id int 所属包裹 ID
~.order_id int 所属订单 ID
~.order_item_id int 订单商品记录 ID
~.product_id int 商品 ID
~.variant_id int 规格变体 ID
~.spu string 商品 SPU
~.sku string 规格 SKU
~.variant_title string 规格变体名称
~.product_title string 商品标题
~.image string 商品图片。可能是相对路径或完整 URL。相对路径需拼接 attachment_url（从 得到网站基础URL 获取）
~.qty int 数量
~.gram string 单品重量（克）
~.row_gram string 行总重量（克）
~.product.handle string 商品 handle（URL 标识）
~.product.id int 商品 ID

注意事项

  1. data 是一个数组，每个子项代表一个独立的发货包裹，一个订单可包含多个包裹
  2. 每个包裹包含若干商品（fulfillmentItems），一个包裹可以包含多个商品
  3. status 用于判断包裹可执行的操作：当 status 为 2（已发货），可执行取消发货操作，参看: 订单-已发货包裹-取消发货
  4. can_cancel_fulfill 用于多包裹场景：当值为 true 时，可执行取消收货操作，参看: 订单-已收货包裹-取消收货
Copyright © fecify.com 2025 all right reserved，powered by Gitbook该文件修订时间： 2026-06-02 21:29:45

results matching ""

    No results matching ""