外部商品
功能说明
外部商品用于记录来源于星辰或其他外部系统的商品资料，并与商城商品建立对应关系。
当商品不直接从商城创建，或存在多个系统共同维护商品时，外部商品表可以帮助追踪来源编码、绑定状态和同步结果。
所属栏目
- 帮助中心栏目：集成手册 > 集成星辰
- 商家端菜单：金蝶云星辰集成 > 商品集成 > 外部商品
- 固定外部标识：kdcloud.integration.xingchen.external-product
- 固定访问路径：xingchen-external-product
适用场景
- 星辰物料已经同步，但尚未导入或绑定商城商品。
- 外部系统的商品编码与商城商品编码不一致，需要单独维护映射。
- 历史商品需要补齐外部编码，方便后续单据同步。
- 多规格、辅助属性或条码存在差异，需要人工确认绑定关系。
业务流程
- 系统读取外部商品资料并形成外部商品列表。
- 管理员根据编码、名称、规格、条码等信息匹配商城商品。
- 未匹配商品按导入方案创建商城商品，或标记为暂不处理。
- 绑定完成后，订单、库存、采购等业务按绑定关系识别商品。
- 后续外部商品变更通过同步字段配置决定是否更新商城商品。
操作步骤
- 进入【外部商品】页面，按来源、绑定状态、商品名称或编码筛选。
- 查看外部商品编码、外部商品名称、规格、辅助属性、条码和同步状态。
- 对未绑定商品，优先搜索是否已有商城商品。
- 确认是同一商品后建立绑定关系；如果商城不存在，则按导入方案创建商品。
- 对不需要进入商城的外部商品，可标记为忽略或保持未启用。
- 绑定后回到商品集成或业务单据中重新验证同步。
关键逻辑
- 外部商品编码应保持稳定，不建议随意修改。
- 同名商品需要结合规格、辅助属性、条码、单位和分类判断是否为同一商品。
- 一对多或多对一绑定会影响库存和单据同步，启用前应明确业务规则。
- 被忽略的外部商品不参与自动导入，但历史记录仍应保留，方便追溯。
常见异常问题
- 外部商品无法绑定：检查是否存在同名多规格、编码冲突或商城商品已绑定其他外部商品。
- 单据同步提示商品不存在：回到外部商品或商品集成页面补齐商品绑定。
- 商品重复导入：检查外部商品是否已经绑定，避免再次按导入方案创建新商品。
- 规格不匹配：核对星辰辅助属性、商城规格和条码信息。
注意事项
- 首次启用建议先使用测试商品、测试客户和测试单据验证完整链路。
- 批量同步前请确认星辰账套、组织、仓库、客户和商品映射关系正确。
- 删除、作废或停用已同步数据前，应同步检查星辰侧是否已经生成正式资料或单据。
- 不同账号可见按钮和字段会受角色权限、数据权限、应用套餐和星辰授权范围影响。
- 后续更新将继续使用本文的固定 external_key 和访问路径，避免文档链接变化。