# 商品寻源询价接入指南
商品寻源询价的 商品参考价智能搜索 接口可以实现通过商品搜索词获取到 5 条匹配度最高的商品信息。
商品信息主要包括：商品编码、商品名称、商品属性、商品参考价(不同周期参考价)、单位、商品分类ID。
商品寻源询价 API 请按以下指南顺序接入：
- 接入 商品品类地区配置
- 接入 商品分类配置
- 接入 商品参考价智能搜索
- 接入 根据商品编码查询有价格的地区列表（请根据实际业务选择接入）
- 接入 根据商品编码查询历史价格数据（请根据实际业务选择接入）
- 接入 根据商品编码查询价格详情
- 接入 根据商品编码查询供应商列表（请根据实际业务选择接入）
# 商品品类地区配置接入说明
商品品类地区配置中的数据用于 商品参考价智能搜索 中 areaCode(地区编码) 参数。
建议将 获取商品品类地区配置 接口的数据存储到本地数据库，便于后续使用。
请注意：此接口有调用频率限制，调用间隔60秒，日限10次。
# 商品分类接入说明
由于商品分类会随着商品的增加不定时会产生变化，商品分类变更后，商品分类版本号会顺序递增。
商品分类配置数据下载地址和商品分类版本号可以通过 获取商品分类配置 接口获取。
建议每天调用一次 获取商品分类配置 接口，根据version判断商品分类是否有变化，
如有变化则可以通过商品分类文件下载地址下载商品分类配置数据。
商品分类配置数据下载后是 CSV 格式，字符集编码为 UTF-8。
CSV 文件的 header 依次为：
id： 分类ID
name：分类名称
parentId：父级分类ID（最顶级父级分类ID为 0）
level：分类层级
sort：排序
hasData：此分类下是否有商品数据
status：分类状态：1-生效中；0-未生效
# 商品参考价智能搜索接入说明
商品参考价智能搜索 接口可通过keyword(商品搜索词)来获取最匹配的 5 条商品参考价信息， 此接口支持根据 categoryId(商品分类ID) 及 areaCode(地区编码) 进行更细粒度的查询。
其中areaCode的配置数据接入请参见 商品品类地区配置接入说明，categoryId的配置数据接入请参见 商品分类接入说明。
商品信息主要包括：商品编码、商品名称、商品属性、商品参考价(不同周期参考价)、单位、商品分类ID。
商品参考价的周期范围支持以下四种：
| 参考价周期编号 | 参考价周期描述 |
|---|---|
| 1 | 前一个月 |
| 2 | 前三个月 |
| 3 | 近半年 |
| 4 | 近一年 |
| 5 | 上周 |
# 根据商品编码查询有价格的地区列表接入说明
根据商品编码查询有价格的地区列表 接口适用于已知商品编码，使用goodsCode(商品编码)查询有价格地区列表的业务场景。
# 根据商品编码查询历史价格数据接入说明
根据商品编码查询历史价格数据 接口适用于已知商品编码，使用goodsCode(商品编码)根据商品编码查询历史月价格数据与历史周价格数据的业务场景。
# 根据商品编码查询价格详情接入说明
根据商品编码查询价格详情 接口适用于已知商品编码，使用goodsCode(商品编码)查询商品参考价的业务场景。
# 根据商品编码查询供应商列表接入说明
根据商品编码查询供应商列表 接口适用于已知商品编码，使用goodsCode(商品编码)查询商品供应商列表的业务场景。