星辰配置
功能说明
星辰配置是金蝶云星辰集成的基础配置入口，用于维护授权信息、账套信息、同步开关、默认参数、字段映射和异常处理策略。
配置是否正确会直接影响所有资料同步和单据同步。
所属栏目
- 帮助中心栏目：集成手册 > 集成星辰
- 商家端菜单：金蝶云星辰集成 > 星辰配置
- 固定外部标识：kdcloud.integration.xingchen.settings
- 固定访问路径：xingchen-settings
适用场景
- 首次启用金蝶云星辰集成，需要完成账号授权和账套配置。
- 同步规则、字段映射或默认值需要调整。
- 同步任务需要启用、停用、重试或排查异常。
- 星辰接口权限、账套、组织或操作员发生变化，需要重新检查配置。
业务流程
- 填写或更新星辰授权信息，确认授权有效。
- 选择企业、账套、组织、门店、仓库等业务范围。
- 配置资料同步、单据同步、自动任务和错误重试规则。
- 维护字段同步、反写字段、默认值和映射策略。
- 保存后用测试商品、客户、仓库和订单做端到端验证。
- 上线后定期查看异常日志和授权有效期。
操作步骤
- 进入【星辰配置】页面，检查授权状态、账套信息和接口连通性。
- 确认默认组织、默认仓库、默认客户、默认结算方式等基础参数。
- 按业务需要开启商品、客户、仓库、采购、单据、门店等同步开关。
- 进入字段配置，明确字段来源、默认值、是否覆盖和是否反写。
- 配置自动同步任务的执行时间、重试次数和失败提醒。
- 保存配置后，依次测试商品同步、客户同步、仓库同步和单据同步。
- 如需停用集成，先关闭自动同步任务，再处理待同步和失败记录。
配置逻辑
- 授权配置决定能否访问星辰接口；账套和组织配置决定数据写入范围。
- 同步开关决定哪些模块参与自动同步，未启用模块可手动维护或暂不处理。
- 字段映射决定数据写入星辰时的字段来源，默认值用于补齐星辰必填字段。
- 反写配置决定星辰返回的单号、状态或字段是否写回快叮云。
- 自动任务应先在测试范围运行，确认稳定后再扩大到正式数据。
常见异常问题
- 授权失败：重新授权并确认星辰账号、应用权限、企业和账套选择正确。
- 保存配置后仍同步失败：检查字段映射、默认值、业务模块开关和星辰必填字段。
- 自动任务不执行：检查任务开关、执行时间、系统定时任务和最近一次执行日志。
- 配置变更后业务异常：回滚到上一套配置或关闭相关同步开关，再用测试数据验证。
- 接口频繁超时：降低同步批量、错峰执行任务，并查看星辰接口状态。
注意事项
- 首次启用建议先使用测试商品、测试客户和测试单据验证完整链路。
- 批量同步前请确认星辰账套、组织、仓库、客户和商品映射关系正确。
- 删除、作废或停用已同步数据前，应同步检查星辰侧是否已经生成正式资料或单据。
- 不同账号可见按钮和字段会受角色权限、数据权限、应用套餐和星辰授权范围影响。
- 后续更新将继续使用本文的固定 external_key 和访问路径，避免文档链接变化。