# 商品发品调用接口流程指南
# 1、商品发品接口调用流程图
# 2、商家发品前置准备&资质申请
# 相关接口操作流程
| 接口名称 | 需求参数 | 主要功能 |
|---|---|---|
| 增加运费模板 addShopOpenComponentV1FreightTemplate | freight_template （运费模板详细信息） | 完成添加新的运费模板ID，用于在添加商品时填写express_info 参数 |
| 添加地址 addaddress | address_detail （地址信息) | 完成添加新的地址ID，用于在添加商品时填写after_sale_info参数 |
| 新增品牌资质 addbrandlogic | brand （品牌详情) | 完成添加新的品牌ID，用于在添加商品时填写brand_id参数 |
| 申请类目 addcategory | category_info （申请资质) | 完成申请新的类目申请，用于在添加商品时填写cats参数 |
# 3、API端核心发品流程
# 3.1、相关接口操作流程
| 序号 | 接口名称 | 需求参数 | 主要功能 |
|---|---|---|---|
| 1 | 上传图片 uploadShopImg | img_url（图片url）upload_type=1时必填media（图片文件buffer）upload_type=0时必填 | 本接口可用于上传图片目的：上传后获取 media_id 支持其他接口使用 |
| 2 | 类目推荐 product_classify | req_type（请求类型）title（商品标题）head_imgs（商品主图）cat_id（类目id） | req_type为1时 1、获取推荐类目2、推荐类目是否权限 req_type为2时1、判断商品类目是否错挂 目的：用于在添加商品时填写cats参数 |
| 3 | 发品前校验 categoryprecheck | cat_id（叶子类目id） | 1、店铺维度权限校验 校验店铺是否有发品权限 校验店铺是否需要开通运费险 校验店铺保证金是否充足 （如只校验店铺权限无需上传类目参数） 2、类目权限校验 校验店铺是否具备所需类目权限 校验当前类目是否暂停新增商品 目的：发品前校验店铺及类目权限 |
| 4 | 发品前校验 categoryprecheck | cat_id（叶子类目id）release_mode（发布模式） | 获取类目的相关信息 目的：用于在添加商品时填写product_qua_infos、attrs、size_chart等参数及商品编辑要求 |
| 5 | 获取品牌库列表 getallbrandslogic | page_size（每页数量）next_key（记录翻页的上下文） | 获取小店品牌库中的品牌信息 目的：用于在添加商品时填写brand_id参数 |
| 6 | 获取运费模板列表 getfreighttemplatelist | offset（起始位置）limit（获取个数） | 获取小店运费模板id列表 目的：用于在添加商品时填写express_info 参数 |
| 7 | 获取地址列表 getaddresslist | offset（获取的偏移量）limit（获取的个数） | 获取小店地址id列表 目的：用于在添加商品时填写after_sale_info参数 |
| 8 | 站内外商品属性映射 externalproductmapping | cat_id（叶子类目id）external_attribute_name（外部商品属性key）external_attribute_value（外部商品属性值）external_category_name（外部商品类目名称） | 1、获取小店平台对应的商品属性key 2、获取小店平台对应的商品属性value 目的：用于根据入参的站外类目名称、属性key和属性value，映射小店平台站内的属性key与属性value，在添加商品时填写attr_key和attr_value |
| 9 | 添加商品 addproduct | 商品的各级、各字段商品信息，具体参照接口文档参数 | 1、完成添加商品进入商品审核 2、获得商品创建完成时间目的：完成商品上架 |
（注：1、接口调用失败会返回errcode、errmsg错误码及错误信息，可根据每个调用接口文档的错误码进行排查原因 2、具体接口请求参数及返回参数以接口文档为准）
# 3.2、常见问题
| 序号 | 接口名称 | 需求参数 | 主要功能 |
|---|---|---|---|
| 1 | 调用添加商品接口发生报错，错误码:6600120 原因:查询模板ID失败 | [errcode] => 10020110 [errmsg] => 商品信息检查不通过, 错误码:6600120 原因:查询模板ID失败 rid:68bea6a5-4235ce80-3a96c676 | 需确认运费信息接口的设置逻辑是否通顺product/add下 相关接口：1、Body.express_info/template id（运费信息）是否设置正确；2、deliver_method 是否设置为 0 走的快递发货 |
| 2 | 调用 product/add(新增商品)接口 会报错"商品信息检查不通过, 错误码:6600031 原因:商家退货退款率位于类目头部10%，需要开通运费险，但是发品前校验接口校验通过 | [errcode]=＞10020110,[errmsg]=＞商品信息检查不通过, 错误码:6600031 原因:商家退货退款率位于类目头部10%，需要开通运费险rid: 691466e6-7b1978ee-3f308613 | 发品前校验接口收到的出参【"all_pass":true】代表该店铺已开通运费险；但发品时提示未开通运费险是指商品维度没有打开运费险的开关，所以这两个出参不矛盾，辛苦关注下商家是否打开待发布商品的运费险开关 |
| 3 | 运费险必填是否接口和后台有不一致的情况，因为有客户反馈后台不支持运费险可以发品，但是接口要求必须支持才可发品 | / | 商家疑似遇到运费险拦截策略受限，需根据运费险管理规则排查店铺情况 |
文档变更日志（1条）2025 年 12 月 01 日
新增 商品发品核心环节调用接口指南