商品分类
功能说明
商品分类用于维护星辰商品分类与商城商品分类的对应关系，保证商品导入和商品同步时可以落到正确分类。
分类映射不正确会导致商品无法导入、导入后分类错误或前台展示位置不符合预期。
所属栏目
- 帮助中心栏目：集成手册 > 集成星辰
- 商家端菜单：金蝶云星辰集成 > 商品集成 > 商品分类
- 固定外部标识：kdcloud.integration.xingchen.product-category
- 固定访问路径：xingchen-product-category
适用场景
- 星辰中已有商品分类，需要同步到商城作为商城分类基础。
- 商城分类已按前台运营重新规划，需要和星辰分类做映射而不是完全一致。
- 商品导入时提示分类为空、分类不存在或分类不允许使用。
业务流程
- 从星辰读取商品分类列表。
- 系统按分类编码、名称或人工配置尝试匹配商城分类。
- 未匹配分类由管理员手动绑定或创建商城分类。
- 商品导入时根据分类映射结果写入商城分类。
- 分类变更后重新检查受影响商品。
操作步骤
- 进入【商品分类】页面，先刷新或同步星辰分类列表。
- 检查星辰分类编码、分类名称、上级分类和启用状态。
- 对未绑定分类，选择已有商城分类进行绑定，或按规则创建新的商城分类。
- 确认商城分类是否允许前台显示、是否参与商品筛选和导航展示。
- 保存分类映射后，回到商品集成页面重新处理商品导入或商品同步。
- 如果星辰分类调整了层级，重新核对商城分类层级和商品归属。
关键逻辑
- 分类编码适合作为稳定匹配依据，分类名称仅适合辅助判断。
- 商城分类可按前台运营口径维护，不一定必须与星辰分类层级完全一致。
- 分类停用后，新商品不建议继续绑定到该分类；历史商品需要按运营规则处理。
- 批量同步分类前，应先确认是否会影响前台菜单、筛选条件和商品展示。
常见异常问题
- 商品导入提示分类不存在：先在商品分类中完成分类同步或绑定，再重新导入商品。
- 商品导入后分类错误：检查星辰分类与商城分类映射是否被误绑定。
- 分类层级不一致：按商城前台展示要求重新绑定目标商城分类。
- 分类停用后商品不可见：检查商城分类状态、商品上下架状态和前台展示开关。
注意事项
- 首次启用建议先使用测试商品、测试客户和测试单据验证完整链路。
- 批量同步前请确认星辰账套、组织、仓库、客户和商品映射关系正确。
- 删除、作废或停用已同步数据前，应同步检查星辰侧是否已经生成正式资料或单据。
- 不同账号可见按钮和字段会受角色权限、数据权限、应用套餐和星辰授权范围影响。
- 后续更新将继续使用本文的固定 external_key 和访问路径，避免文档链接变化。