待处理订单订单-列表

待处理订单指订单已提交完成的订单，包括：等待发货，部分发货，全部发货，已收货的订单

订单 - 待处理订单列表

接口信息

  • 接口地址: {your-site-url}/api/skill/order/get-order-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)

字段 类型 必填 说明
pageNum int 否 页码，默认 1
pageSize int 否 每页记录数
customer_id int 否 顾客 ID，筛选指定顾客的订单
orderBy string 否 排序字段，如 id、recalled_at
orderDirect string 否 排序方向。desc = 降序，asc = 升序
order_processing_status int 否 订单处理状态。1 = 待发货，2 = 已发货，3 = 已完成, 4 = 已存档
created_at_begin string 否 订单创建时间区间起始
created_at_end string 否 订单创建时间区间结束
payed_at_begin string 否 订单支付时间区间起始
payed_at_end string 否 订单支付时间区间结束
fulfilled_at_begin string 否 订单发货时间区间起始
fulfilled_at_end string 否 订单发货时间区间结束
search_key string 否 搜索字段，配合 search_val 使用。可选值：order_number、order_id、fist_loading_url、customer_email、customer_phone、coupon_code
search_val string 否 搜索值，配合 search_key 使用

请求示例

cURL

curl --location --request GET '{your-site-url}/api/skill/order/get-order-list?pageNum=1&pageSize=50' \
--header 'skill-access-token: {your-skill-access-token}'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "list": [
            {
                "id": 6409,
                "shop_id": 15,
                "order_number": "E528504573115869",
                "items_count": 1,
                "created_at": "2026-05-28 14:40:57",
                "updated_at": "2026-05-28 14:41:26",
                "customer_email": "1186735711@qq.com",
                "over_sold_count": 0,
                "payment_method": "Payzl",
                "payment_name": "Payzl Inside",
                "shipping_method_name": "价格运费",
                "customer_phone": "13133333333",
                "payment_status": 3,
                "currency_code": "USD",
                "curr_grand_total": "418.50",
                "payed_at": "2026-05-28 14:41:40",
                "fulfillment_status": 1,
                "recalled_at": "2026-05-28 14:41:40",
                "order_status": 2,
                "items": [
                    {
                        "id": 7795,
                        "shop_id": 15,
                        "order_id": 6409,
                        "product_id": 7036,
                        "variant_id": 48940,
                        "spu": "",
                        "sku": "crossbody-bag-black-backpack-0",
                        "variant_title": "",
                        "product_title": "Crossbody bag black backpack",
                        "image": "/product/15/image/2026/05/23/42fb5fc3d3f7af099f78ae558ab36347.jpg",
                        "gram": "0.00",
                        "base_price": "315.00",
                        "curr_price": "315.00",
                        "base_row_tax": "0.00",
                        "curr_row_tax": "0.00",
                        "addition_attr_base_price": "0.00",
                        "addition_attr_curr_price": "0.00",
                        "addition_attr": "",
                        "glasses_custom_base_price": "0.00",
                        "glasses_custom_curr_price": "0.00",
                        "glasses_customized": null,
                        "qty": 1,
                        "curr_row_price": "315.00",
                        "row_gram": "0.00",
                        "base_row_price": "315.00",
                        "is_reviewed": 2,
                        "over_sold_count": 0,
                        "created_at": 1779950457,
                        "updated_at": 1779950486,
                        "product_source_id": "",
                        "variant_source_id": "",
                        "source_type": 0
                    }
                ],
                "shippingAddress": {
                    "id": 4300,
                    "shop_id": 15,
                    "order_id": 6409,
                    "first_name": "张",
                    "last_name": "三",
                    "phone": "13133333333",
                    "company": "",
                    "address_1": "辽源路街道",
                    "address_2": "4-4-403",
                    "city": "青岛",
                    "country_code": "AX",
                    "province_code": "",
                    "zip": "266300",
                    "created_at": 1779950457,
                    "updated_at": 1779950486
                },
                "txnid": {
                    "order_id": 6409,
                    "txn_id": "N202605281441407207042",
                    "payment_method": "payzl"
                }
            }
        ],
        "total": 1827,
        "pageSize": 50,
        "totalPage": 37
    },
    "message": "success"
}

返回字段说明

订单主字段

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data.list Array[Object] 订单列表
data.total int 总记录数
data.pageSize int 每页记录数
data.totalPage int 总页数
data.list[].id int 订单 ID
data.list[].shop_id int 店铺 ID
data.list[].order_number string 订单编号
data.list[].items_count int 订单商品总件数
data.list[].customer_email string 下单用户邮箱
data.list[].customer_phone string 用户手机号
data.list[].payment_method string 支付方式标识
data.list[].payment_name string 支付方式名称
data.list[].payment_status int 支付状态。1 = 初始状态，2 = 待支付，21 = 等待支付审核，3 = 已支付，4 = 部分退款，5 = 已全部退款
data.list[].currency_code string 下单当前货币
data.list[].curr_grand_total string 订单总额（当前货币）
data.list[].shipping_method_name string 货运方式名称
data.list[].order_status int 订单状态。1 = 结账初始，2 = 已创建/进入订单流程，3 = 归档，4 = 已取消
data.list[].fulfillment_status int 发货/履行状态。1 = 初始，2 = 未发货，3 = 挂起，4 = 部分发货，5 = 已全部发货，6 = 部分收货，7 = 全部收货，8 = 已全部退货
data.list[].over_sold_count int 超卖个数
data.list[].payed_at string/int 支付时间
data.list[].recalled_at string/int 召回成功时间
data.list[].created_at string 创建时间
data.list[].updated_at string 最后更新时间

订单商品 items

字段 类型 说明
data.list[].items[].id int 订单商品记录 ID
data.list[].items[].order_id int 所属订单 ID
data.list[].items[].product_id int 商品 ID
data.list[].items[].variant_id int 规格变体 ID
data.list[].items[].spu string 商品 SPU
data.list[].items[].sku string 规格 SKU
data.list[].items[].variant_title string 规格变体名称
data.list[].items[].product_title string 商品标题
data.list[].items[].image string 商品图片。可能是相对路径或完整 URL。相对路径需拼接 attachment_url来组合成完整url（从 得到网站基础URL 获取）
data.list[].items[].gram string 单品重量（克）
data.list[].items[].base_price string 单品单价（基础货币）
data.list[].items[].curr_price string 单品单价（当前货币）
data.list[].items[].qty int 购买数量
data.list[].items[].curr_row_price string 行总金额 = 单价 × 数量（当前货币）
data.list[].items[].row_gram string 行总重量（克）
data.list[].items[].base_row_price string 行总金额（基础货币）
data.list[].items[].base_row_tax string 行税费（基础货币）
data.list[].items[].curr_row_tax string 行税费（当前货币）
data.list[].items[].is_reviewed int 是否已评价。1 = 已评价，2 = 未评价
data.list[].items[].over_sold_count int 超卖个数
data.list[].items[].source_type int 商品来源类型。0 = 自建，1 = 1688
data.list[].items[].product_source_id string 商品来源 ID
data.list[].items[].variant_source_id string 规格来源 ID

收货地址 shippingAddress

字段 类型 说明
data.list[].shippingAddress.id int 地址记录 ID
data.list[].shippingAddress.order_id int 所属订单 ID
data.list[].shippingAddress.first_name string 收货人名字
data.list[].shippingAddress.last_name string 收货人姓氏
data.list[].shippingAddress.phone string 收货人电话
data.list[].shippingAddress.company string 公司名称
data.list[].shippingAddress.address_1 string 地址行 1
data.list[].shippingAddress.address_2 string 地址行 2
data.list[].shippingAddress.city string 城市
data.list[].shippingAddress.country_code string 国家简码
data.list[].shippingAddress.province_code string 省/州简码
data.list[].shippingAddress.province_name string 省/州名称
data.list[].shippingAddress.zip string 邮政编码

支付交易 txnid

字段 类型 说明
data.list[].txnid Object/null 支付交易信息。未支付时为 null
data.list[].txnid.order_id int 所属订单 ID
data.list[].txnid.txn_id string 支付交易号
data.list[].txnid.payment_method string 支付方式标识

注意事项

  1. 所有筛选参数均为选填，不传时返回全部订单
  2. items[].image 为相对路径时，完整图片 URL = attachment_url + image，attachment_url 从 得到网站基础URL 获取
  3. 时间筛选（created_at_begin 等）可单独传起始或结束，也可组合使用
  4. 排序可同时使用 orderBy + orderDirect 指定字段和方向
Copyright © fecify.com 2025 all right reserved，powered by Gitbook该文件修订时间： 2026-06-02 14:03:28

results matching ""

    No results matching ""