# 查询小商店&标准交易组件订单明细
# 1. 根据订单ID查询订单详情
# 接口说明
支持联盟开发者根据订单ID查询订单详情
# 请求地址
POST https://api.weixin.qq.com/union/promoter/order/info?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | string | 是 | 接口调用凭证 | |
orderIdList | Array.<string> | 是 | 订单 id 列表 |
# 返回值
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
orderList | Array.<Object> | 订单列表 |
orderList 的结构
属性 | 类型 | 说明 |
---|---|---|
orderId | string | 订单ID |
payTime | number | 支付时间戳,单位为s |
confirmReceiptTime | number | 确认收货时间戳,单位为s,没有时为0 |
shopName | string | 店铺名称 |
shopAppid | string | 店铺 Appid |
productList | Array.<Object> | 商品列表 |
customizeInfo | string | 自定义信息 |
customUserId | string | 自定义用户参数 |
userNickName | string | 用户昵称 |
productList 的结构
属性 | 类型 | 说明 |
---|---|---|
productId | string | 商品SPU ID |
skuId | string | sku ID |
title | string | 商品名称 |
thumbImg | string | 商品缩略图 url |
price | string | 商品成交总价,前带单位 ¥ |
productCnt | number | 成交数量 |
ratio | number | 分佣比例,单位为万分之一 |
commissionStatus | string | 分佣状态 |
commissionStatusUpdateTime | string | 分佣状态更新时间戳,单位为s |
profitShardingSucTime | string | 结算时间,当分佣状态为已结算才有值,单位为s |
commission | string | 分佣金额,前带单位 ¥ |
estimatedCommission | number | 预估分佣金额,单位为分 |
categoryStr | string | 类目名称,多个用英文逗号分隔 |
promotionInfo | <Object> | 推广信息 |
promotionInfo 的结构
属性 | 类型 | 说明 |
---|---|---|
promotionSourcePid | string | 推广位 id |
promotionSourceName | string | 推广位名称 |
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"orderList": [
{
"orderId": "1952315038682581",
"payTime": 1612355317,
"shopName": "xxx小商店",
"productList": [
{
"productId": "4085505",
"title": "身体护理",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥0.20",
"ratio": 9000,
"commissionStatus": "SETTLEMENT_CANCELED",
"commission": "¥0",
"categoryStr": "11",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
},
"customizeInfo": "customizeInfo"
}
]
}
]
}
# 错误码
值 | 说明 |
---|---|
200002 | 未传入 orderIdList 或 orderIdList 超过上限 200 |
# 2. 根据订单支付时间、订单分佣状态拉取订单详情
# 接口说明
查询、筛选订单列表
# 请求地址
GET https://api.weixin.qq.com/union/promoter/order/search?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token | string | 是 | 接口调用凭证 | |
page | number | 1 | 否 | 页码,起始为 1 |
pageSize | number | 10 | 否 | 分页大小,最大 200 |
startTimestamp | string | 否 | 起始时间戳,单位为秒 | |
endTimestamp | string | 否 | 结束时间戳,单位为秒 | |
commissionStatus | string | 否 | 分佣状态 | |
sortByCommissionUpdateTime | string | 0 | 否 | 是否按照分佣状态更新时间排序和筛选订单,1:是,0:否 |
startCommissionUpdateTime | string | 否 | 分佣状态更新时间起始时间戳,单位为秒 | |
endCommissionUpdateTime | string | 否 | 分佣状态更新时间结束时间戳,单位为秒 |
# GET 数据示例
{
"page": 1
}
commissionStatus 的枚举
值 | 类型 | 说明 |
---|---|---|
SETTLEMENT_PENDING | string | 待结算 |
SETTLEMENT_SUCCESS | string | 已结算 |
SETTLEMENT_CANCELED | string | 取消结算 |
# 返回值
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
orderList | Array.<Object> | 订单列表 |
pageSize | number | 分页大小 |
totalNum | number | 订单总数 |
orderList 的结构
属性 | 类型 | 说明 |
---|---|---|
orderId | string | 订单ID |
payTime | number | 支付时间戳,单位为s |
confirmReceiptTime | number | 确认收货时间戳,单位为s,没有时为0 |
shopName | string | 店铺名称 |
shopAppid | string | 店铺 Appid |
productList | Array.<Object> | 商品列表 |
customizeInfo | string | 自定义信息 |
customUserId | string | 自定义用户参数 |
userNickName | string | 用户昵称 |
productList 的结构
属性 | 类型 | 说明 |
---|---|---|
productId | string | 商品SPU ID |
skuId | string | sku ID |
title | string | 商品名称 |
thumbImg | string | 商品缩略图 url |
price | string | 商品成交总价,前带单位 ¥ |
productCnt | number | 成交数量 |
ratio | number | 分佣比例,单位为万分之一 |
commissionStatus | string | 分佣状态 |
commissionStatusUpdateTime | string | 分佣状态更新时间戳,单位为s |
profitShardingSucTime | string | 结算时间,当分佣状态为已结算才有值,单位为s |
commission | string | 分佣金额,前带单位 ¥ |
estimatedCommission | number | 预估分佣金额,单位为分 |
categoryStr | string | 类目名称,多个用英文逗号分隔 |
promotionInfo | <Object> | 推广信息 |
customizeInfo | string | 自定义信息 |
promotionInfo 的结构
属性 | 类型 | 说明 |
---|---|---|
promotionSourcePid | string | 推广位 id |
promotionSourceName | string | 推广位名称 |
# 返回数据示例
{
"errcode": 0,
"errmsg": "ok",
"orderList": [
{
"orderId": "1952315038682581",
"payTime": 1612355317,
"shopName": "xxx小商店",
"productList": [
{
"productId": "4085505",
"title": "身体护理",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥0.20",
"ratio": 9000,
"commissionStatus": "SETTLEMENT_CANCELED",
"commission": "¥0",
"categoryStr": "11",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
},
"customizeInfo": "customizeInfo"
}
]
},
{
"orderId": "1952881854014581",
"payTime": 1612354844,
"shopName": "xxx小商店",
"productList": [
{
"productId": "4085505",
"title": "身体护理",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥0.20",
"ratio": 9000,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "11",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1540485153563887",
"payTime": 1612346038,
"shopName": "xxx",
"productList": [
{
"productId": "6363741",
"title": "美工刀",
"thumbImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥1.00",
"ratio": 500,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "美工刀",
"promotionInfo": {
"promotionSourcePid": "oqt8u5NJAsZ4TN0eNVDN5J_1KUOs_1497740816",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1140092624903333",
"payTime": 1612345602,
"shopName": "xxx",
"productList": [
{
"productId": "6363741",
"title": "美工刀",
"thumbImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥1.00",
"ratio": 500,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "美工刀",
"promotionInfo": {
"promotionSourcePid": "oqt8u5NJAsZ4TN0eNVDN5J_1KUOs_1497740816",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1952328751053581",
"payTime": 1612333478,
"shopName": "xxx小商店",
"productList": [
{
"productId": "4085505",
"title": "身体护理",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥0.20",
"ratio": 9000,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "11",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1952872372026581",
"payTime": 1612233926,
"shopName": "xxx小商店",
"productList": [
{
"productId": "4085505",
"title": "身体护理",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥0.20",
"ratio": 9000,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "11",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1508732341607753",
"payTime": 1612233673,
"shopName": "xxx小商店",
"productList": [
{
"productId": "4085505",
"title": "身体护理",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥0.20",
"ratio": 9000,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "11",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1976456848299426",
"payTime": 1611893169,
"shopName": "xxx小商店",
"productList": [
{
"productId": "5622638",
"title": "垃圾袋",
"thumbImg": "https://snsdy.tc.qq.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥9.90",
"ratio": 200,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "黑色",
"promotionInfo": {
"promotionSourcePid": "oqt8u5NJAsZ4TN0eNVDN5J_1KUOs_1497740816",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1508676280185753",
"payTime": 1611578393,
"shopName": "xxx小商店",
"productList": [
{
"productId": "12432937",
"title": "收纳盒",
"thumbImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥1.00",
"ratio": 8000,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "1",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
}
}
]
},
{
"orderId": "1508813362517753",
"payTime": 1611576663,
"shopName": "xxx小商店",
"productList": [
{
"productId": "12432937",
"title": "收纳盒",
"thumbImg": "https://store.mp.video.tencent-cloud.com/161/20304/snscosdownload/SZ/reserved/xxx",
"price": "¥1.00",
"ratio": 8000,
"commissionStatus": "SETTLEMENT_PENDING",
"commission": "-",
"categoryStr": "1",
"promotionInfo": {
"promotionSourcePid": "oqt8u5E4_3XcsaMicK_E2gNyvBfM_1290469201",
"promotionSourceName": "xxx"
}
}
]
}
],
"pageSize": 10,
"totalNum": 133
}