金蝶云星辰集成总览
功能说明
金蝶云星辰集成用于连接快叮云商家端与金蝶云星辰账套，统一维护商品、客户、仓库、单据、零售门店等资料和业务数据。
通过该集成，商家可以先同步星辰基础资料，再将商城业务单据推送到星辰，减少重复录入，并通过同步状态和异常日志追踪处理结果。
本文适合作为启用金蝶云星辰集成前的总览说明，正式操作时应结合各子模块文档逐项配置。
所属栏目
- 帮助中心栏目：集成手册 > 集成星辰
- 商家端菜单：金蝶云星辰集成
- 固定外部标识：kdcloud.integration.xingchen.overview
- 固定访问路径：xingchen-overview
适用场景
- 已经开通金蝶云星辰，并希望快叮云商城、采购、仓储或零售门店数据与星辰保持一致。
- 需要把星辰物料、客户、仓库等基础资料同步到快叮云，作为商城业务数据来源。
- 需要把快叮云产生的销售、采购、出入库、收退款等单据推送到星辰做财务和库存处理。
- 需要在同步失败时快速定位授权、映射、字段、状态或接口返回问题。
业务流程
- 完成星辰账号授权，确认企业、账套、组织和操作员权限。
- 进入星辰配置，维护接口参数、同步开关、默认组织、默认仓库和字段策略。
- 先同步基础资料，包括商品分类、商品品牌、商品、客户、仓库和门店。
- 维护字段映射、反写字段、绑定关系和默认值，确保两边资料可以互相识别。
- 启用业务单据同步，在测试客户、测试商品和测试订单上验证推送结果。
- 上线后定期查看同步状态、异常日志和未绑定数据，及时补齐映射关系。
操作步骤
- 进入快叮云商家端，打开【金蝶云星辰集成】。
- 按左侧菜单从上到下检查：商品集成、采购集成、客户集成、仓储集成、单据集成、零售门店、星辰配置。
- 先在【星辰配置】完成授权和基础参数，再处理各业务模块。
- 每完成一个模块配置，都使用少量测试数据进行同步验证。
- 确认基础资料和业务单据都能同步成功后，再安排正式业务启用。
- 上线后保留专人定期处理同步失败和未绑定记录。
关键逻辑
- 基础资料优先于业务单据。商品、客户、仓库、门店等资料未同步或未绑定时，业务单据推送容易失败。
- 字段映射决定双方字段如何匹配，反写字段决定星辰返回的数据如何回写到商城。
- 同步状态通常包括未同步、同步中、同步成功、同步失败、已忽略等；失败数据需要处理原因后重试。
- 删除或停用配置前，应先确认没有待同步数据和仍在使用的业务流程。
常见异常问题
- 授权失效或接口无权限：重新授权星辰账号，确认操作员具备对应资料和单据的查询、新增、修改权限。
- 同步失败提示字段为空：检查同步字段配置、默认值和星辰必填字段，补齐后重新同步。
- 数据重复：检查编码规则、绑定关系和历史同步记录，避免同一对象用不同编码重复创建。
- 星辰中查不到数据：确认同步状态是否成功，核对账套、组织、仓库、门店和时间范围。
- 部分按钮不可见：检查当前账号权限、应用套餐、集成授权和页面数据权限。
注意事项
- 首次启用建议先使用测试商品、测试客户和测试单据验证完整链路。
- 批量同步前请确认星辰账套、组织、仓库、客户和商品映射关系正确。
- 删除、作废或停用已同步数据前，应同步检查星辰侧是否已经生成正式资料或单据。
- 不同账号可见按钮和字段会受角色权限、数据权限、应用套餐和星辰授权范围影响。
- 后续更新将继续使用本文的固定 external_key 和访问路径，避免文档链接变化。