报单接口列表 (店铺信息描述)

需要授权

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

保存店铺信息请求接口:

POST请求地址:

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

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
agentNum String 32 代理商编号 10001014717752778430001
customerNum String 32 商户编号 10001114749829775330009
shopName String 32 店铺名称 哆啦宝店铺
address String 32 店铺地址 国贸
oneIndustry String 32 店铺一级行业(参见1.3) 美食
twoIndustry String 32 店铺二级行业(参见1.4) 湘菜
mobilePhone String 32 店铺联系人手机号 15511580251
mapLng String 32 经度 121.499641
mapLat String 32 纬度 31.238298

请求JSON示例:

  • JSON示例
  • 1 {
    2 "agentNum":"10001014717752778430001",
    3 "customerNum":"10001114749829775330009",
    4 "shopName":"哆啦宝店铺",
    5 "address":"国贸",
    6 "oneIndustry":"美食",
    7 "twoIndustry":"湘菜",
    8 "mobilePhone":"13311580250",
    9 "mapLng": 121.499641,
    10 "mapLat": 31.238298
    11 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
shopNum String 32 店铺编码 10001214746261301330003

响应JSON示例:

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

修改店铺信息请求接口:

POST请求地址:

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

公共请求参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
shopNum String 32 店铺编号 10001214746261301330003
agentNum String 32 代理商编号 10001014717752778430001
customerNum String 32 商户编号 10001114749829775330009
shopName String 32 店铺名称 哆啦宝店铺
address String 32 店铺地址 国贸
oneIndustry String 32 店铺一级行业(参见1.3) 美食
twoIndustry String 32 店铺二级行业(参见1.4) 湘菜
mobilePhone String 32 店铺联系人手机号 15511580251
mapLng String 32 经度 121.499641
mapLat String 32 纬度 31.238298

请求JSON示例:

  • JSON示例
  • 1 {
    2 "shopNum":"10001214746261301330003",
    3 "agentNum":"10001014717752778430001",
    4 "customerNum":"10001114749829775330009",
    5 "shopName":"哆啦宝店铺",
    6 "address":"国贸",
    7 "oneIndustry":"美食",
    8 "twoIndustry":"湘菜",
    9 "mobilePhone":"13311580250"
    10 "mapLng": 121.499641,
    11 "mapLat": 31.238298
    12 }

返回参数JSON格式:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
shopNum String 32 店铺编码 10001214746261301330003

响应JSON示例:

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

查询店铺信息接口:

GET请求地址:

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

返回参数JSON格式:

返回信息参数:

参数名称 参数类型 是否必填 最大长度 参数说明 示例值
shopList address String 32 店铺地址 国贸
mobilePhone String 32 店铺电话 13311580250
shopName String 32 店铺名称 哆啦宝店铺
shopNum String 32 店铺编号 10001214746261301330003

请求JSON示例:

  • JSON示例
  • 1 {
    2 "data": {
    3 "shopList": [
    4 {
    5 "address": "国贸",
    6 "mobilePhone": "13311580250",
    7 "shopName": "哆啦宝店铺",
    8 "shopNum": "10001214746261301330003"
    9 }
    10 ]
    11 },
    12 "result": "success"
    13 }

错误码解释:

错误码 错误描述 解决方案
invalidIndustry industry invalid 行业无效
shopExsit shop exsit 店铺已存在
declareNotExsit declare not exsit 报单不存在
customerNotExist customer not exist 商户不存在
shopNotExsit shop not match 店铺不存在
invalidIndustry industry invalid 行业不存在