商家查询订单明细 | 微信开放文档

# 商家查询订单明细

# 接口说明

查询、筛选订单列表

# 请求地址

GET https://api.weixin.qq.com/union/shop/order/search_normal_order?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
offset	number	是	分页查询起始位置
limit	number	是	每页查询个数
query	string	否	关键词
allianceAppid	string	否	推客appid
orderId	number	否	交易组件订单号
outOrderId	string	否	商家自定义订单号
tradeNo	string	否	微信支付交易单号
startPayTime	number	否	支付开始时间
endPayTime	number	否	支付结束时间
commissionStatus	string	否	分佣状态，多个用英文逗号隔开，参考枚举值commissionStatusEnum
outOrderIdList	string	否	商家自定义订单号列表，多个用英文逗号隔开
transactionIdList	string	否	微信支付交易单号列表，多个用英文逗号隔开
startStatusUpdateTime	number	否	订单状态更新开始时间戳
endStatusUpdateTime	number	否	订单状态更新结束时间戳
sortBy	string	否	排序方式，参考枚举值sortByEnum，默认为 SORT_BY_PAY_TIME
sortOrder	string	否	排序方式，参考枚举值 sortOrderEnum，默认为 SORT_ORDER_DESC

# commissionStatusEnum 示例

属性	值	说明
COMMISSION_PAY_SUCCESS	2、5、8	待扣费
COMMISSION_PAY_CANCEL	4	取消扣费
COMMISSION_SHOP_FINISH_DEDUCTION	6	已扣费
COMMISSION_SHOP_DEDUCTION_NOT_ENOUGH_MONEY	7	余额不足

# sortByEnum 示例

属性	值	说明
SORT_BY_PAY_TIME	1	按支付时间排序
SORT_BY_STATUS_UPDATE_TIME	2	按订单状态更新时间排序

# sortOrderEnum 示例

属性	值	说明
SORT_ORDER_DESC	1	降序
SORT_ORDER_ASC	2	升序

# GET 数据示例

{
  "offset": 0,
  "limit": 10
}

# 返回值

属性	类型	说明
errcode	number	错误码
errmsg	string	错误信息
orderList	Array.<Object>	订单列表
total	number	订单总数

orderList 的结构

属性	类型	说明
orderInfo	object	订单信息
productList	array	商品信息

orderInfo 的结构

属性	类型	说明
orderId	string	交易组件订单号
outOrderId	string	商家自定义订单号
transactionId	string	微信支付交易单号
payTime	number	成交时间
orderPrice	number	订单实际支付金额，单位是分
freight	number	运费，单位是分
discountedPrice	number	优惠金额，单位是分
additionalPrice	number	附加金额，单位是分
additionalRemarks	string	附加金额备注
status	number	订单状态，枚举值参考交易组件文档
createTime	number	订单创建时间
statusUpdateTime	number	订单状态更新时间
path	string	小程序订单详情页的path

productList 的结构

属性	类型	说明
title	string	商品名称
headImg	string	商品缩略图 url
salePrice	number	商品售价，单位是分
realPrice	number	实际支付价格，单位是分
productCnt	number	成交数量
productId	string	商家组件商品id
outProductId	string	商家自定义商品id
skuId	string	组件skuid
outSkuId	string	商家outskuid
skuAttr	Array.<Object>	sku的销售属性
ratio	number	佣金比例，万分之一，如8000为80%
commissionValue	number	预估分佣金额，单位是分
commissionStatus	string	佣金状态
commissionStatusUpdateTime	number	分佣状态更新时间
promoterInfo	object	推客信息

promoterInfo 的结构

属性	类型	说明
appId	string	推客appid
nickName	string	推客昵称
finderNickname	string	推客的视频号昵称，仅当推客在视频号场景推广商品时有该值

skuAttr 的结构

属性	类型	说明
attrKey	string	sku的销售属性
attrValue	string	sku的销售属性值

# 返回数据示例

{
    "errcode": 0,
    "errmsg": "ok",
    "total": 1,
    "orderList": [
        {
            "orderInfo": {
                "orderId": "2020966986280665096",
                "outOrderId": "1000010000100301",
                "transactionId": "893921061043139",
                "payTime": 1630051304,
                "orderPrice": 40,
                "freight": 10,
                "discountedPrice": 0,
                "additionalPrice": 0,
                "additionalRemarks": "",
                "status": 200,
                "createTime": 1630051290,
                "statusUpdateTime": 0,
                "path": "/pages/commercePlace/index"
            },
            "productList": [
                {
                    "title": "219 男女同款鞋",
                    "headImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SH/reserved/60e32624000cf9e50000000023e74f09000000a000004f50?imageView2/3/w/544",
                    "salePrice": 10,
                    "realPrice": 10,
                    "productCnt": 2,
                    "productId": "411628841",
                    "outProductId": "1625138165000",
                    "outSkuId": "411628841",
                    "skuAttrs": [],
                    "ratio": 8800,
                    "commissionValue": 17,
                    "commissionStatus": "COMMISSION_SHOP_FINISH_DEDUCTION",
                    "commissionStatusUpdateTime": 1630932191,
                    "promoterInfo": {
                        "appId": "wx1cea54f8a2094",
                        "nickName": "旗舰店"
                    }
                },
                {
                    "title": "219 男女同款鞋",
                    "headImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SH/reserved/60e32624000cf9e50000000023e74f09000000a000004f50?imageView2/3/w/544",
                    "salePrice": 1,
                    "realPrice": 10,
                    "productCnt": 2,
                    "productId": "411622998",
                    "outProductId": "1625194252000",
                    "skuId": "350263118",
                    "outSkuId": "1625194251990",
                    "skuAttrs": [
                        {
                            "attrKey": "选择颜色",
                            "attrValue": "红蓝主机"
                        },
                        {
                            "attrKey": "选择套装",
                            "attrValue": "主机+保护套"
                        }
                    ],
                    "ratio": 9000,
                    "commissionValue": 0,
                    "commissionStatus": "COMMISSION_PAY_CANCEL",
                    "commissionStatusUpdateTime": 1630058665,
                    "promoterInfo": {
                        "appId": "wx1cea54f8a2094",
                        "nickName": "旗舰店"
                    }
                }
            ]
        }
    ]
}