# 根据商品编码查询供应商列表
# 接口描述
根据商品编码查询对应商品的供应商列表
注意:当搜索请求携带areaCode
(地区编码)参数时,如果所查询的地区无供应商数据,但此地区的上级地区(市-省-国)有供应商数据,则会返回上级地区供应商数据。
例如:查询水泥 P.O 42.5、济南市的数据时,如果济南市无数据,则返回山东省的数据,如果山东省无数据,则返回全国的数据。
# 字符编码
UTF-8
# 请求地址
/openapi/price-track/goods-supplier
# 请求 Header 参数
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
accessToken | String | 是 | 请求发起时需要在 header 中,携带 accessToken,获取方式详见获取 accessToken |
# 版本号(ver)
1
# 请求方式
POST(application/json)
# 请求参数
参数名 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
ver | Integer | - | 是 | api 接口版本,参见具体 API 的版本。示例:1 |
goodsCode | String | 32 | 是 | 商品编码,可以在商品参考价智能检索接口中获取 |
areaCode | String | 10 | 是 | 地区编码 默认0(全国) |
pageNum | Integer | - | 否 | pageNum 默认1 |
pageSize | Integer | - | 否 | pageSize 默认10,最大支持100 |
# 请求示例
{
"ver": "1",
"areaCode": "0",
"goodsCode": "000000000006AD0A8",
"pageNum": "1",
"pageSize": "10"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 应用级返回结果
参数名 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
total | Integer | 11 | 是 | 总条数 |
pageNum | Integer | 11 | 是 | pageNum |
pageSize | Integer | 11 | 是 | pageSize |
supplierList | GoodsSupplierVO[] | - | 是 | 供应商列表 |
# GoodsSupplierVO[] 商品供应商对象
参数名 | 类型 | 长度 | 必填 | 说明 |
---|---|---|---|---|
creditCode | String | 30 | 是 | 企业统一社会信用代码 |
companyName | String | 255 | 是 | 企业名称 |
legalPerson | String | 30 | 是 | 法人 |
Long | 100 | 是 | 邮箱 | |
phone | String | 20 | 是 | 电话 |
companyAddress | String | 200 | 是 | 公司地址 |
registeredCapital | Number | 30 | 是 | 注册资本 |
regDateTime | String | 10 | 是 | 注册时间,格式: YYYY-MM-DD |
creditLevel | String | 100 | 是 | 供应商信用认证类型详见:creditLevel 认证类型代码,多个用,隔开。例如:basic |
# creditLevel 认证类型代码
认证类型代码 | 供应商信用认证类型 |
---|---|
basic | 基础认证 |
universal | 通用认证 |
architecture1 | 建筑业-咨询服务认证 |
architecture2 | 建筑业-材料设备认证 |
architecture3 | 建筑业-工程建设认证 |
# 返回结果示例
{
"code": 200,
"msg": "成功",
"data": {
"total": 2,
"pageSize": 10,
"pageNum": 1,
"supplierList": [
{
"creditCode": "913************1P",
"companyName": "********有限公司",
"legalPerson": "陈**",
"email": "yan.***@***360.com",
"phone": "021-5080****",
"companyAddress": "上海市***********T4座4-7层",
"registeredCapital": "2583230400",
"regDateTime": "1996-05-27",
"creditLevel": "basic,universal"
},
{
"creditCode": "911*************X9",
"companyName": "北京******有限公司",
"legalPerson": "汪**",
"email": "**@xin****.com",
"phone": "6126****",
"companyAddress": "北京市*******9号",
"registeredCapital": "50000000",
"regDateTime": "1999-06-03",
"creditLevel": "basic"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
返回code码见 API 返回码说明