报单接口列表 (完成报单描述)

需要授权

通过该接口完成商户报单。

完成报单信息接口:

POST请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.com/v2/agent/declare/complete

返回参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerNum String 32 商户编号 10001114749829775330009
licenseId String 32 账户对公类型,营业执照必填。 371702228008810
licenseStartTime String 32 账户对公类型,营业执照起始日期。 2016-10-09
licenseEndTime String 32 账户对公类型,营业执照结束日期,需比起始日期大于一天。 2016-10-10
callbackUrl String 255 运营人员审核完成会请求该回调地址 https://www.duolaba.cn

请求JSON示例:

  • JSON示例
  • 1 {
    2 "customerNum":"10001114751584307070007",
    3 "licenseId":"371702228008810",
    4 "licenseStartTime":"2016-10-09",
    5 "licenseEndTime":"2016-10-10",
    6 "callbackUrl":"www.duolabao.com"
    7 }

响应JSON示例:

  • JSON示例
  • 1 {
    2 "data": {
    3 "customerNum": "10001114677154068412775",
    4 "fullName": "风扇商户",
    5 "mail": "aa@163.com",
    6 "mobile": 13000000000,
    7 "activeAddress": "有效地址",
    8 "declareStatus": "PASS",
    9 "success": true
    10 },
    11 "result": "success"
    12 }

查询报单信息请求接口:

POST请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.com/v1/agent/declare/list

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
agentNum String 32 代理商编号 10001014691580767561778
customerNum String 32 商户编号 10001114748070341320175
customerShortName String 32 商户简称 哆啦宝
status String 32 INIT(未完成)/NOTPASS(未通过)/NOTAUDIT(未审核)/PASS(已通过) SUCCESS
pageNum String 32 页面,当前页(每页20条记录) 1

请求JSON示例:

  • JSON示例
  • 1 {
    2 "agentNum":"10001014691580767561778",
    3 "customerNum":"10001114748070341320175",
    4 "customerShortName":"555555555555",
    5 "status":"PASS"
    6 "pageNum":"1"
    7 }

错误码解释:

错误码 错误描述 解决方案
invalidDate licenseStartTime: invalil 开始时间无效
outTimeRange out of time range 超出时间范围
limitAttach individual attach limit 13 超出13张限制
declareNotExsit declare not exsit 报单不存在
declareStatusError declare status is error,customer is [customerNum],daclare status is [INIT] 报单状态有误
customerNotExist customer[customerNum] is not exist 商户不存在
createCustomerManagerFail create customerManager fail while complete declare,cusomterNum[customerNum] 创建商户管理员失败
activeCustomerFail active cusomter[customerNum] fail while complete declare,cusomterNum[customerNum] 激活商户失败