报单接口列表 (附件信息描述)

需要授权

通过该接口录入商户附件信息。

保存附件信息请求接口:

POST请求地址:

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

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
attachType String 32
对私(个人/个体):
3张商务合作协议照
2身份证(正反)
1银行卡正
1张授权书照 (仅个人需要)
1组织机构代码(仅个体需要)
1营业执照(仅个体需要)
1 门头照
1 店内照
1 收银台
对私新增手持身份证(仅个人需要)
(个体必须且最多可上传13张图片)
(个人必须且最多可上传11张图片)


对公:
3张商务合作协议照
1张营业执照
1张门头照片
1组织机构代码
2法人身份证照片(正反)
1银行卡(正面)
1店内照
1收银台
税务登记
统一社会信用代码(必须且最多可上传15张图片)
对私:
PROTOCAL
IDENTITYFRONT, IDENTITYOPPOSITE
BANKFRONT
AUTHORIZATION
ORGANIZATIONCODE
LICENCE
IDENTITYDOOR
SHOP
CASHIERDESK
IDENTIFYHANDHOLD




对公:
PROTOCAL
LICENCE
IDENTITYDOOR
ORGANIZATIONCODE
IDENTITYFRONT,IDENTITYOPPOSITE
BANKFRONT
SHOP
CASHIERDESK
TAXREGISTRATION
UNIFIEDSOCIALCREDITCODE
customerNum String 32 商户编号 10001114749829775330009
file String 32(200k以内) 图片的流json格式 iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAOwUlEQV

请求JSON示例:

  • JSON示例
  • 1 {
    2 "attachType": "PROTOCAL", PROTOCAL PERMIT LICENCE
    3 "customerNum": "10001114749829775330009",
    4 "file": "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAOwUlEQV"
    5 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
attachNum String 32 附件编号 10001714747826278800071
fileName String 32 附件名称 1475141273337.png
url String 32 附件地址 https://7xl70k.com2.z0.glb.qiniucdn.com/1475141273337.png?e=3313381273&token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:FbJ_knJ3KnPVKhKTvolGn-u8PAw=

响应JSON示例:

  • JSON示例
  • 1 {
    2 "data": {
    3 "attachNum": "10001714747826278800071",
    4 "fileName": "1475141273337.png",
    5 "fileName": "1475141273337.png",
    6 "url":https://7xl70k.com2.z0.glb.qiniucdn.com/1475141273337.png?e=331
    3381273&token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:FbJ_kn
    J3KnPVKhKTvolGn-u8PAw="
    7 },
    8 "result": "success"
    9 }

修改附件信息请求接口:

POST请求地址:

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

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
attachNum String 32 附件编号 10001714747826278800071
attachType String 32 附件类型 PROTOCAL, PROTOCAL PERMIT LICENCE
customerNum String 32 商户编号 10001114749829775330009
file String 32 图片的流json格式 iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAOwUlEQV

请求JSON示例

  • JSON示例
  • 1 {
    2 "attachNum": "10001714747826278800071",
    3 "attachType": "PROTOCAL",
    4 "customerNum": "10001114748070341320175",
    4 "file": "iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAA"
    5 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
attachNum String 32 附件编号 10001714747826278800071
fileName String 32 附件名称 1475141273337.png
url String 32 附件地址 https://7xl70k.com2.z0.glb.qiniucdn.com/1475141273337.png?e=3313381273&token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:FbJ_knJ3KnPVKhKTvolGn-u8PAw=

响应JSON示例:

  • JSON示例
  • 1 {
    2 "data": {
    3 "attachNum": "10001714747826278800071",
    4 "fileName": "1475141273337.png",
    5 "fileName": "1475141273337.png",
    6 "url":https://7xl70k.com2.z0.glb.qiniucdn.com/1475141273337.png?e=331
    3381644&token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:dxBD1G
    dXhgwH5jMtegBuvkGFFGw="
    7 },
    8 "result": "success"
    9 }

查询附件接口:

GET请求地址:

环境 https请求地址
正式环境 https://openapi.duolabao.com/v1/agent/declare/attach/list/{商户编号}
示例值 https://openapi.duolabao.com/v1/agent/declare/attach/list/10001114745491441190171

返回参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
accountType String 32 账户类型 PUBLIC
attachList attachNum String 32 附件编号 10001714747826278800071
attachType String 32 附件类型 PROTOCAL
fileName String 32 图片名称 1474782627397.png
url String 32 图片地址 https://7xl70k.com2.z0.glb.qiniucdn.com/1474782627397.png?e=3313022627&token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:hEfKXpXbjJZPNa7VDsRihQR7ae0=

返回JSON示例值:

  • JSON示例
  • 1 {
    2 "data": {
    3 "accountType": "PUBLIC",
    4 "attachList": [
    5 {
    6 "attachNum": "10001714747826278800071",
    7 "city": "北京",
    8 "attachType": "PROTOCAL",
    9 "fileName": "1474782627397.png",
    10 "url": "http://7xl70k.com2.z0.glb.qiniucdn.com/1474782627397.png?e=3313022627&
    11 token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:hEfKXpXbjJZPNa7VDsRihQR7ae0="
    12 },
    13 {
    14 "attachNum": "10001714747826850970072",
    15 "attachType": "PROTOCAL",
    16 "fileName": "1474782684661.png",
    17 "url": "http://7xl70k.com2.z0.glb.qiniucdn.com/1474782684661.png?e=3313022685&
    18 token=pegl5Fe4wRa6Q4laBtUh8TDg4gqfsJbCb0I7r3DP:fbSVbypnIza6stR2jbDIBGRABi8="
    19 }
    20 ]
    21 },
    22 "result": "success"
    23 }

错误码解释:

错误码 错误描述 解决方案
declareNotExsit declare not exsit 报单不存在
declareStatusError notaudit or pass 报单状态有误
uploadUpdateFail update image fail 更新图片失败
uploadFail upload image fail 上传图片失败
limitAttach public attach limit 13 超过13张限制
pictureSizeOut picture size limit 200 超过200k限制