代理商接口列表 (代理商批量查询订单)
需要授权
哆啦宝用户通过该接口可以对所有订单记录进行分页查询。
请求参数：
公共请求参数：
| 参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
| agentNum |
String |
是 |
32 |
代理商编号 |
10001114677121319732773 |
| customerNum |
String |
是 |
32 |
商户编号 |
10001114677149187482777 |
| shopNum |
String |
是 |
32 |
店铺编号 |
10001214677149716953054 |
| status |
String |
是 |
32 |
INIT(待支付)/SUCCESS(成功)/CANCEL(已取消)/REFUND(已退款)/REFUNDING(退款中)/REFUNDFAIL(退款失败)
|
SUCCESS |
| startTime |
String |
是 |
32 |
必填，日期格式错误或者不填日期，默认查今天，最大时间间隔不超过30天 |
2016-07-06 15:19:08 |
| endTime |
String |
是 |
32 |
必填，日期格式错误或者不填日期，默认查今天，最大时间间隔不超过30天 |
2016-08-05 15:19:08 |
| pageNum |
String |
是 |
32 |
页码，当前页(每页20条记录) |
1 |
根据商户编号请求示例：
POST请求地址：
| 环境 |
https请求地址 |
| 正式环境 |
https://openapi.duolabao.com/v1/agent/order/customer/batch/query |
-
|
1
|
{
|
|
2
|
"agentNum": "10001114677121319732773",
|
|
3
|
"customerNum": "10001114677149187482777",
|
|
4
|
"status": "SUCCESS",
|
|
5
|
"startTime": "2016-07-06 15:19:08",
|
|
6
|
"endTime": "2016-08-05 15:19:08",
|
|
7
|
"pageNum": "1"
|
|
8
|
}
|
根据店铺编号请求示例：
POST请求地址：
| 环境 |
https请求地址 |
| 正式环境 |
https://openapi.duolabao.com/v1/agent/order/shop/batch/query |
-
|
1
|
{
|
|
2
|
"agentNum": "10001114677121319732773",
|
|
3
|
"customerNum": "10001114677149187482777",
|
|
4
|
"shopNum": "10001214677149716953054",
|
|
5
|
"status": "SUCCESS",
|
|
6
|
"startTime": "2016-07-06 15:19:08",
|
|
7
|
"endTime": "2016-08-05 15:19:08",
|
|
8
|
"pageNum": "1"
|
|
9
|
}
|
返回参数JSON格式：
| 参数名称 |
参数类型 |
是否必填 |
最大长度 |
参数说明 |
示例值 |
| result |
String |
是 |
32 |
success表示成功，fail表示失败，error表示异常 |
success |
| status |
String |
是 |
32 |
INIT(待支付)/SUCCESS(成功)/CANCEL(已取消)/REFUND(已退款)/REFUNDING(退款中)/REFUNDFAIL(退款失败)
|
SUCCESS |
| requestNum |
String |
是 |
32 |
流水号(用户系统内唯一) |
建议时间戳+5位以上随机数(纯数字) |
| shopNum |
String |
否 |
32 |
如果根据商户查询，则返回店铺编号 |
10001214677149716953054 |
| orderNum |
String |
否 |
32 |
订单编号 |
10001214641783052104486 |
| completeTime |
String |
是 |
32 |
订单完成时间 |
2016-04-03 17:27:10 |
| orderAmount |
String |
是 |
15, 2 |
订单金额 |
100.00 |
| refundTime |
String |
否 |
32 |
时间格式,2016-6-24 21:42:40 |
2016-6-24 21:42:40 |
| errorCode |
String |
否 |
32 |
错误码 |
shopNumNotExist |
| errorMsg |
String |
否 |
32 |
错误信息 |
shopNum not exist |
| payWay |
String |
是 |
32 |
支付方式 |
wx |
响应JSON示例：
-
|
1
|
{
|
|
2
|
"data": {
|
|
3
|
"orderList": [
|
|
4
|
{
|
|
5
|
"completeTime": "2016-07-12 15:43:13",
|
|
6
|
"orderAmount": "0.01",
|
|
7
|
"shopNum": "10001214677149716953054",
|
|
8
|
"orderNum": "10021014683093339018474",
|
|
9
|
"refundTime": "2016-07-12 15:43:13",
|
|
10
|
"requestNum": "12778823432427",
|
|
11
|
"payWay":"WX",
|
|
12
|
"status": "REFUND"
|
|
13
|
},
|
|
14
|
{
|
|
15
|
"completeTime": "2016-07-08 16:54:08",
|
|
16
|
"orderAmount": "0.01",
|
|
17
|
"orderNum": "10021014679680366408447",
|
|
18
|
"requestNum": "1467968309017215",
|
|
19
|
"status": "SUCCESS",
|
|
20
|
"payWay":"WX"
|
|
21
|
},
|
|
22
|
{
|
|
23
|
"orderAmount": "0.01",
|
|
24
|
"orderNum": "10021014679487197128438",
|
|
25
|
"requestNum": "1467948989004654",
|
|
26
|
"status": "INIT",
|
|
27
|
"payWay":"WX"
|
|
28
|
},
|
|
29
|
]
|
|
30
|
}
|
|
31
|
"result": "success"
|
|
32
|
}
|
错误响应示例：
-
|
1
|
{
|
|
2
|
"error": {
|
|
3
|
"errorCode": "shopNumNotExist",
|
|
4
|
"errorMsg":"shopNum not exist"
|
|
5
|
},
|
|
6
|
"result": "fail"
|
|
7
|
}
|
异常示例：
-
|
1
|
{
|
|
2
|
"error": {
|
|
3
|
"errorCode": "systemError",
|
|
4
|
"errorMsg":"错误描述"
|
|
5
|
},
|
|
6
|
"result": "error"
|
|
7
|
}
|
错误码解释：
| 错误码 |
错误描述 |
解决方案 |
| paramsError |
requestNum must be specified |
参数不正确，请确认参数 |
| outTimeRange |
out of time range |
查询时间超出范围 |
| agentInvalid |
agent invalid |
代理商无效 |
| customerInvalid |
customer invalid |
商户无效 |