Fecify-待处理订单-列表

接口信息

  • 接口地址: {your-site-url}/api/skill/order/get-order-list
  • 基础 URL: {your-site-url} 需替换为你自己的独立站 URL 地址，如 https://your-domain.com/admin
  • 请求方式: GET
  • Content-Type: application/json
  • 说明: 获取待处理的订单分页列表（order_processing_status=1），即"待发货"状态的订单。支持按订单号、顾客、店铺、时间范围等条件筛选，以及排序。

认证

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

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

请求参数

参数 类型 必填 说明
pageNum Number 否 页码，默认 1
pageSize Number 否 每页条数
shop_id Number 否 店铺 ID，店铺列表可以通过api获取：Fecify-B2C店铺-select下拉条列表
orderBy String 否 排序字段，如 id、recalled_at
orderDirect String 否 排序方向：desc = 降序，asc = 升序
order_processing_status Number 否 订单处理状态：1 = 待发货，2 = 已发货，3 = 已完成，4 = 已存档
created_at_begin String 否 创建时间起始，格式 YYYY-MM-DD HH:mm:ss（URL 中空格替换为 +）
created_at_end String 否 创建时间结束 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&shop_id=352&order_processing_status=1' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json'

返回结果

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

成功响应

{
    "code": 200,
    "data": {
        "orders": {
            "list": [
                {
                    "id": 6520,
                    "shop_id": 15,
                    "order_number": "FECE714976202808921",
                    "items_count": 1,
                    "created_at": "2026-07-14 10:53:40",
                    "updated_at": "2026-07-14 10:53:41",
                    "customer_email": "sb-dufqu16184183@personal.example.com",
                    "over_sold_count": 0,
                    "payment_method": "cod",
                    "payment_name": "Pay On Delivery",
                    "shipping_method_name": "strandard Shipping",
                    "customer_phone": "+1 8632132",
                    "payment_status": 2,
                    "currency_code": "USD",
                    "curr_grand_total": "94.99",
                    "payed_at": 0,
                    "fulfillment_status": 1,
                    "recalled_at": "2026-07-14 10:53:49",
                    "order_status": 2,
                    "items": [
                        {
                            "id": 7920,
                            "shop_id": 15,
                            "order_id": 6520,
                            "product_id": 7103,
                            "variant_id": 49053,
                            "spu": "",
                            "sku": "",
                            "variant_title": "Pink / L",
                            "product_title": "Denim Jacket Shirt Wholesale from China Factory",
                            "image": "/product/15/image/2026/06/16/ad21da0c112f93aaf047dd8d61393696.jpg",
                            "gram": "200.00",
                            "base_price": "39.99",
                            "curr_price": "39.99",
                            "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": "39.99",
                            "row_gram": "200.00",
                            "base_row_price": "39.99",
                            "is_reviewed": 2,
                            "over_sold_count": 0,
                            "created_at": 1783997620,
                            "updated_at": 1783997621,
                            "product_source_id": "",
                            "variant_source_id": "",
                            "source_type": 0
                        }
                    ],
                    "shippingAddress": {
                        "id": 4395,
                        "shop_id": 15,
                        "order_id": 6520,
                        "first_name": "John",
                        "last_name": "Doe",
                        "phone": "+1 8632132",
                        "company": "",
                        "address_1": "82 I Street Southeast",
                        "address_2": "4-4-4031",
                        "city": "Washington",
                        "country_code": "CN",
                        "province_code": "AH",
                        "zip": "20003",
                        "created_at": 1783997621,
                        "updated_at": 1783997621,
                        "province_name": "AnHui"
                    },
                    "txnid": null,
                    "payment_method_show": "Cod"
                }
            ],
            "total": 1,
            "pageSize": 50,
            "totalPage": 1
        },
        "shop_urls": [
            {
                "shop_id": 15,
                "manager_url": "https://diydomain.fecmall.cn/apimanager666",
                "fornt_url": "https://diydomain.fecmall.cn"
            }
        ]
    },
    "message": "success"
}

返回字段说明

字段 类型 说明
code Number 状态码，200 表示成功
message String 执行结果的文字描述
data.orders Object 订单分页数据
data.shop_urls Array 关联店铺的商家端和前台 URL

订单分页

字段 类型 说明
list Array 订单记录列表
total Number 总记录数
pageSize Number 每页条数
totalPage Number 总页数

list 子项（订单主字段）

字段 类型 说明
id Number 订单 ID
shop_id Number 店铺 ID
order_number String 订单编号
items_count Number 订单商品总件数
customer_email String 下单用户邮箱
customer_phone String 用户手机号
payment_method String 支付方式标识
payment_name String 支付方式名称
payment_status Number 支付状态：1 = 初始，2 = 待支付，21 = 待审核，3 = 已支付，4 = 部分退款，5 = 全部退款
currency_code String 下单当前货币
curr_grand_total String 订单总额（当前货币）
shipping_method_name String 货运方式名称
order_status Number 订单状态：1 = 结账初始，2 = 已创建，3 = 归档，4 = 已取消
fulfillment_status Number 发货状态：1 = 初始，2 = 未发货，3 = 挂起，4 = 部分发货，5 = 全部发货，6 = 部分收货，7 = 全部收货，8 = 全部退货
over_sold_count Number 超卖个数
payed_at Number 支付时间（Unix 时间戳），0 = 未支付
recalled_at String / Number 召回成功时间
created_at String 创建时间
updated_at String 最后更新时间
payment_method_show String 支付方式前端显示名称
items Array 订单商品明细
shippingAddress Object 收货地址
txnid Object / Null 支付交易详情，未支付时为 null

items 子项

字段 类型 说明
id Number 订单商品记录 ID
shop_id Number 店铺 ID
order_id Number 所属订单 ID
product_id Number 商品 ID
variant_id Number 规格变体 ID
spu String 商品 SPU
sku String 规格 SKU
variant_title String 规格名称，如 "Pink / L"
product_title String 商品标题
image String 商品图片路径（相对路径，需拼接基础 URL）
gram String 单品重量（克）
base_price String 单品单价（基础货币）
curr_price String 单品单价（当前货币）
qty Number 购买数量
curr_row_price String 行总金额 = 单价 × 数量（当前货币）
row_gram String 行总重量（克）
base_row_price String 行总金额（基础货币）
base_row_tax String 行税费（基础货币）
curr_row_tax String 行税费（当前货币）
addition_attr_base_price String 自定义属性附加价格（基础货币）
addition_attr_curr_price String 自定义属性附加价格（当前货币）
addition_attr String 自定义属性内容（JSON 或文本）
glasses_custom_base_price String 眼镜定制价格（基础货币）
glasses_custom_curr_price String 眼镜定制价格（当前货币）
glasses_customized Object / Null 眼镜定制详情，无定制时为 null
is_reviewed Number 是否已评价：1 = 已评价，2 = 未评价
over_sold_count Number 超卖个数
source_type Number 商品来源：0 = 自建，1 = 1688
product_source_id String 商品来源 ID（如 1688 商品 ID）
variant_source_id String 规格来源 ID（如 1688 SKU ID）
created_at Number 创建时间（Unix 时间戳）
updated_at Number 最后更新时间（Unix 时间戳）

shippingAddress 子项

字段 类型 说明
id Number 地址记录 ID
order_id Number 所属订单 ID
first_name String 收货人名字
last_name String 收货人姓氏
phone String 收货人电话
company String 公司名称
address_1 String 地址行 1
address_2 String 地址行 2
city String 城市
country_code String 国家简码（ISO 3166-1）
province_code String 省/州简码
province_name String 省/州名称
zip String 邮政编码

txnid 子项

字段 类型 说明
order_id Number 所属订单 ID
txn_id String 支付交易号
payment_method String 支付方式标识

注意事项

  1. 时间参数在 URL 中需将空格替换为 +（如 2026-07-01+00:00:00）。
  2. items[].image 为相对路径，完整 URL 需拼接 店铺-存储基础URL 返回的 image_base_url。
  3. 待处理订单通常指 order_processing_status=1（待发货）且 order_status=2（已创建/进入流程）的订单。

results matching ""

    No results matching ""