登录 热线：400-088-8816
开放资源

商户平台

第三方平台

报单接口列表 (商户信息描述)

需要授权

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

保存商户基础信息请求接口：

POST请求地址：

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

公共请求参数：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
agentNum String 是 32 代理商编号 10001014717752778430001
fullName String 是 32 哆啦宝商户全称 哆啦宝商户
shortName String 是 32 哆啦宝商户简称 哆啦宝商户
industry String 是 32 商户所属行业（参见1.3） 美食
province String 是 32 商户所属省份（参见1.1） 北京
city String 是 32 商户所属城市（参见1.2） 北京
email String 否 32 电子邮箱 670442447@qq.com
linkMan String 是 32 商户联系人 哆啦宝
linkPhone String 是 32 商户联系电话 15777777777
customerType String 是 32 商户类型,NONE(默认)/COMPANY(公司)/PERSON(个人) NONE
certificateType String 是 32 证件类型,IDENTIFICATION(身份证)/PASSPORT(护照) IDENTIFICATION
certificateCode String 是 32 证件编号 230604199304163012
district String 是 32 地区 朝阳
certificateName String 是 32 证件人姓名 张三
organizationCode String 否 32 组织结构代码 00022475X
taxCertification String 否 32 税务登记证 510106784749182
accountOpenLicense String 否 32 开户许可证 J1234543534533
certificateStartDate String 是 32 法人证件开始日期 2015-01-01
certificateEndDate String 否 32 法人证件结束日期 2018-01-01

请求JSON示例：

  • JSON示例
  • 1 {
    2 "agentNum": "10001014717752778430001",
    3 "fullName": "哆啦宝商户",
    4 "shortName": "哆啦宝商户",
    5 "industry": "美食",
    6 "province": "北京",
    7 "city": "北京",
    8 "email": "670442447@qq.com",
    9 "linkMan": "哆啦宝",
    10 "linkPhone": "15777777777",
    11 "certificateType": "IDENTIFICATION",
    12 "customerType": "NONE",
    13 "certificateCode": "230604199304163012"
    14 "district": "朝阳区"
    15 "certificateName": "张三"
    16 "organizationCode": "00022475X"
    17 "taxCertification": "510106784749182"
    18 "accountOpenLicense": "J1234543534533"
    19 "certificateStartDate": "2015-01-01"
    20 "certificateEndDate": "2018-01-01"
    21 }

返回参数JSON格式：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerNum String 是 32 商户编码 10001114748070341320175

响应JSON示例：

  • JSON示例
  • 1 {
    2 "data": {
    3 "customerNum": "10001114748070341320175"
    4 },
    5 "result": "success"
    6 }

修改商户基础信息请求接口：

POST请求地址：

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

公共请求参数：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
agentNum String 是 32 代理商编号 10001014717752778430001
customerNum String 是 32 商户编号 10001114748070341320175
fullName String 是 32 哆啦宝商户全称 哆啦宝商户
shortName String 是 32 哆啦宝商户简称 哆啦宝商户
industry String 是 32 商户所属行业（参见1.3） 美食
province String 是 32 商户所属省份（参见1.1） 北京
city String 是 32 商户所属城市（参见1.2） 北京
email String 否 32 电子邮箱 670442447@qq.com
linkMan String 是 32 商户联系人 哆啦宝
linkPhone String 是 32 商户联系电话 15777777777
customerType String 是 32 商户类型,NONE(默认)/COMPANY(公司)/PERSON(个人) NONE
certificateType String 是 32 证件类型,IDENTIFICATION(身份证)/PASSPORT(护照) IDENTIFICATION
certificateCode String 是 32 证件编号 230604199304163012
district String 是 32 地区 朝阳
certificateName String 是 32 证件人姓名 张三
certificateStartDate String 是 32 法人证件开始日期 2015-01-01
certificateEndDate String 否 32 法人证件结束日期 2018-01-01

请求JSON示例：

  • JSON示例
  • 1 {
    2 "agentNum": "10001014717752778430001",
    3 "customerNum": "10001114748070341320175",
    4 "fullName": "哆啦宝商户",
    5 "shortName": "哆啦宝商户",
    6 "industry": "美食",
    7 "province": "北京",
    8 "city": "北京",
    9 "email": "670442447@qq.com",
    10 "linkMan": "哆啦宝",
    11 "linkPhone": "15777777777",
    12 "certificateType": "IDENTIFICATION",
    13 "customerType": "NONE",
    14 "certificateCode": "230604199304163012"
    15 "district": "朝阳区"
    16 "certificateName": "张三"
    17 "certificateStartDate": "2015-01-01"
    18 "certificateEndDate": "2018-01-01"
    17 }

返回参数JSON格式：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
customerNum String 是 32 商户编码 10001114748070341320175

响应JSON示例：

  • JSON示例
  • 1 {
    2 "data": {
    3 "customerNum": "10001114748070341320175"
    4 },
    5 "result": "success"
    6 }

查询商户基础信息请求接口：

GET请求地址：

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

返回参数JSON格式：

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
canUpdate String 是 32 可修改 false
certificateCode String 是 32 证件编号 230604199304163012
certificateType String 否 32 证件类型,IDENTIFICATION(身份证)/PASSPORT(护照) IDENTIFICATION
city String 是 32 所属城市 北京
customerNum String 是 32 商户编号 10001114748070341320175
fullName String 是 32 商户全称 哆啦宝商户
haseAttach String 是 32 含有附件 true
hashMobile String 是 32 含有手机号码 false
industry String 是 32 行业 美食
linkMan String 是 32 联系人 哆啦宝
linkPhone String 是 32 商户联系电话 15777777777
province String 是 32 所属省份 北京
shortName String 是 32 商户简称 哆啦宝商户
district String 是 32 地区 朝阳
certificateName String 是 32 证件人姓名 张三
certificateStartDate String 是 32 法人证件开始日期 2015-01-01
certificateEndDate String 否 32 法人证件结束日期 2018-01-01

返回JSON示例：

  • JSON示例
  • 1 {
    2 "data": {
    3 "canUpdate": false,
    4 "certificateCode": "230604199304163012",
    5 "certificateType": "IDENTIFICATION",
    6 "city": "北京",
    7 "customerNum": "10001114748070341320175",
    8 "fullName": "哆啦宝商户",
    9 "haseAttach": true,
    10 "industry": "美食",
    11 "linkMan": "哆啦宝",
    12 "linkPhone": "15777777777",
    13 "province": "北京",
    14 "shortName": "哆啦宝商户"
    15 "district": "朝阳区"
    16 "certificateName": "张三"
    17 "certificateStartDate": "2015-01-01"
    18 "certificateEndDate": "2018-01-01"
    19 },
    20 "result": "success"
    21 }

错误码解释：

错误码 错误描述 解决方案
invalidProvince province invalid 省份无效
invalidCity city invalid 城市无效
invalidAddress address invalid 地址无效
invalidIndustry industry invalid 行业无效
userExist email exist 邮箱无效
invalidIdCard idCard invalid 无效身份证
invalidCardType CardType invalid 证件类型无效

平台热线：400-088-8816 工作日：周一至周五 9:00—18:00

哆啦宝（北京）科技有限公司

Copyright © 2016 Duolabao. All Rights Reserved. 京ICP备15047477号-2 网站支持IPV6