单据集成
功能说明
单据集成用于将快叮云产生的业务单据同步到金蝶云星辰，支撑后续财务、库存和经营分析。
常见单据包括销售订单、销售出库、销售退货、收款、退款、采购相关单据和其他出入库单据，具体以实际启用模块为准。
所属栏目
- 帮助中心栏目：集成手册 > 集成星辰
- 商家端菜单：金蝶云星辰集成 > 单据集成
- 固定外部标识：kdcloud.integration.xingchen.bill-integration
- 固定访问路径：xingchen-bill-integration
适用场景
- 商城销售订单需要推送到星辰形成销售业务单据。
- 发货、退货或退款后，需要同步星辰库存和财务结果。
- 需要通过星辰单号追踪快叮云单据是否已经入账。
- 同步失败后需要重试、忽略、作废或人工处理。
业务流程
- 基础资料完成绑定后，业务单据进入待同步队列。
- 系统按单据类型、业务状态、审核状态和同步配置判断是否允许推送。
- 推送成功后记录星辰单号和同步成功状态。
- 星辰审核、反审核、作废或异常返回时，快叮云记录状态和错误信息。
- 异常单据修复资料或配置后重新同步。
操作步骤
- 进入【单据集成】页面，选择单据类型或同步状态。
- 检查单据编号、客户、商品、仓库、金额、数量和业务日期。
- 对待同步单据执行同步，或等待自动同步任务处理。
- 同步成功后查看星辰单号、同步时间和同步人。
- 同步失败时打开错误详情，根据提示修复资料、字段或权限。
- 需要作废时，先确认星辰单据是否已审核，再按页面提供的作废、取消同步或重试规则处理。
- 删除业务数据前，先确认星辰侧是否已产生正式单据，避免两边数据不一致。
关键逻辑
- 未审核、已作废、已删除或业务状态不完整的单据通常不应自动推送。
- 已同步成功的单据再次修改时，应按变更规则判断是更新原单、重新推送还是生成反向单据。
- 客户、商品、仓库、门店、结算方式等映射不完整时，单据同步会失败。
- 同步失败不代表业务单据无效，只表示未成功写入星辰，需要按错误信息处理。
常见异常问题
- 星辰提示必填字段为空：检查字段同步配置、默认值和单据类型设置。
- 星辰提示商品或客户不存在：回到商品集成或客户集成补齐绑定关系。
- 单据重复：检查外部单号、星辰单号和是否重复点击同步。
- 作废失败：确认星辰单据是否已审核、是否已被下游单据引用。
- 金额或数量不一致：检查单位换算、优惠分摊、税率、运费和退款规则。
注意事项
- 首次启用建议先使用测试商品、测试客户和测试单据验证完整链路。
- 批量同步前请确认星辰账套、组织、仓库、客户和商品映射关系正确。
- 删除、作废或停用已同步数据前，应同步检查星辰侧是否已经生成正式资料或单据。
- 不同账号可见按钮和字段会受角色权限、数据权限、应用套餐和星辰授权范围影响。
- 后续更新将继续使用本文的固定 external_key 和访问路径，避免文档链接变化。