代理商接口列表 (代理商批量查询订单)

需要授权

哆啦宝用户通过该接口可以对所有订单记录进行分页查询。

请求参数:

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
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.cn/v1/agent/order/customer/batch/query
  • JSON示例
  • 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.cn/v1/agent/order/shop/batch/query
  • JSON示例
  • 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

响应JSON示例:

  • 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 "status": "REFUND"
    12 },
    13 {
    14 "completeTime": "2016-07-08 16:54:08",
    15 "orderAmount": "0.01",
    16 "orderNum": "10021014679680366408447",
    17 "requestNum": "1467968309017215",
    18 "status": "SUCCESS"
    19 },
    20 {
    21 "orderAmount": "0.01",
    22 "orderNum": "10021014679487197128438",
    23 "requestNum": "1467948989004654",
    24 "status": "INIT"
    25 },
    26 ]
    27 }
    28 "result": "success"
    29 }

错误响应示例:

  • 错误响应示例
  • 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 商户无效