商品集成
功能说明
商品集成用于维护快叮云商城商品与金蝶云星辰物料之间的对应关系，是后续订单、采购、仓储和财务单据同步的基础。
页面通常包含商城商品表、星辰商品表、导入方案列表、指定分类同步商品、同步商品配置、同步字段配置、反写字段配置等页签。
商家可以从星辰拉取物料列表，将星辰物料导入商城，也可以把商城商品与星辰物料进行绑定。
所属栏目
- 帮助中心栏目：集成手册 > 集成星辰
- 商家端菜单：金蝶云星辰集成 > 商品集成
- 固定外部标识：kdcloud.integration.xingchen.product-integration
- 固定访问路径：xingchen-product-integration
适用场景
- 星辰已经维护物料，希望将物料同步到快叮云商城成为可销售商品。
- 商城已有商品，需要绑定星辰物料编码，确保订单和库存同步时能准确识别。
- 需要配置商品名称、规格、辅助属性、分类、品牌、单位、图片等字段的同步规则。
- 需要星辰或商城某些字段变化后自动回写到另一侧。
业务流程
- 在星辰配置中确认授权和物料读取权限。
- 点击更新星辰商品列表，拉取最新星辰物料、辅助属性和规格信息。
- 在星辰商品表中筛选未绑定物料，确认物料编码、名称、辅助属性、规格和分类。
- 按业务需要选择导入到商城或绑定到已有商城商品。
- 维护同步字段配置和反写字段配置，确认哪些字段由星辰维护、哪些字段由商城维护。
- 同步后检查绑定状态、商品分类、规格和前台销售状态。
操作步骤
- 进入【商品集成】后，先查看【商城商品表】和【星辰商品表】两个列表。
- 在【星辰商品表】点击【更新星辰商品列表】，等待系统拉取星辰物料。
- 通过绑定状态、绑定方式、物料搜索、商品分类等条件筛选需要处理的物料。
- 勾选目标物料，点击【导入到商城】，按导入方案生成商城商品。
- 如果商城已存在商品，进入绑定或匹配操作，将商城商品编码和星辰物料编码建立关系。
- 进入【导入方案列表】，维护不同商品分类、规格或辅助属性的导入规则。
- 进入【同步字段配置】，配置名称、分类、品牌、规格、单位、价格等字段来源。
- 进入【反写字段配置】，配置商城字段变更后是否需要回写星辰。
- 保存配置后，用一个测试商品验证同步结果，再批量处理正式商品。
关键逻辑
- 绑定状态用于判断星辰物料是否已经关联商城商品；未绑定物料不能直接参与依赖商城商品编码的业务同步。
- 绑定方式用于区分自动匹配、手动绑定、导入生成等来源，便于排查后续问题。
- 辅助属性会影响规格维度。多规格商品应重点核对星辰辅助属性编码与商城规格编码是否一致。
- 字段同步配置决定商品资料以哪一侧为准。建议上线前固定维护来源，避免两边互相覆盖。
- 反写字段适合需要把商城生成或变更的信息回写到星辰的场景，启用前应确认星辰字段允许修改。
常见异常问题
- 星辰商品表没有数据：确认授权、账套、物料权限和筛选条件，再点击更新星辰商品列表。
- 导入到商城失败：检查必填字段、商品分类、单位、规格、图片和导入方案配置。
- 多规格商品规格错位：核对辅助属性编码、辅助属性名称、商城规格编码和规格名称。
- 商品重复生成：检查绑定状态和商城商品编码，避免未绑定历史商品被再次导入。
- 字段被覆盖：检查同步字段配置和反写字段配置，确认字段维护主责。
注意事项
- 首次启用建议先使用测试商品、测试客户和测试单据验证完整链路。
- 批量同步前请确认星辰账套、组织、仓库、客户和商品映射关系正确。
- 删除、作废或停用已同步数据前，应同步检查星辰侧是否已经生成正式资料或单据。
- 不同账号可见按钮和字段会受角色权限、数据权限、应用套餐和星辰授权范围影响。
- 后续更新将继续使用本文的固定 external_key 和访问路径，避免文档链接变化。