上线前必确认事项
以下事项必须在开发启动前（第 1 阶段）完成确认，否则将阻塞后续开发工作。
金蝶 formId 确认
| 序号 | 单据类型 | formId | 确认人 | 状态 |
|---|---|---|---|---|
| 1 | 分布式调出单 | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 2 | 分布式调入单 | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 3 | 赠品补发单 | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 4 | 销售订单（写入） | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 5 | 销售退货单（写入） | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 6 | 其他出库单（写入） | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 7 | 应收单（写入） | 待确认 | 金蝶实施方 | ⬜ 待确认 |
| 8 | 采购订单（写入） | 待确认 | 金蝶实施方 | ⬜ 待确认 |
旺店通接口确认
| 序号 | 接口/字段 | 用途 | 确认人 | 状态 |
|---|---|---|---|---|
| 1 | 分布式调出单写入接口 | 调拨推送 | 旺店通实施方 | ⬜ 待确认 |
| 2 | 分布式调入单写入接口 | 调拨推送 | 旺店通实施方 | ⬜ 待确认 |
| 3 | 其他入库单写入接口 | 调拨推送 | 旺店通实施方 | ⬜ 待确认 |
| 4 | 销售出库单完成状态码 | 销售回传 | 旺店通实施方 | ⬜ 待确认 |
| 5 | 退还管理已结算状态码 | 退款回传 | 旺店通实施方 | ⬜ 待确认 |
| 6 | 退还类型字段（退货退款/退款不退货） | 退款回传 | 旺店通实施方 | ⬜ 待确认 |
| 7 | 分摊后总价字段 | 销售回传 | 旺店通实施方 | ⬜ 待确认 |
金蝶关键字段确认
| 序号 | 字段 | 用途 | 确认人 | 状态 |
|---|---|---|---|---|
| 1 | ”客户主体”字段位置与标识 | 源组织拆分 | 金蝶实施方 | ⬜ 待确认 |
| 2 | 各组织账套编码 | 多组织写入 | 金蝶实施方 | ⬜ 待确认 |
| 3 | API 认证方式（OAuth / Token） | 接口对接 | 金蝶实施方 | ⬜ 待确认 |
仓库货品映射确认
| 序号 | 映射类型 | 数量 | 确认人 | 状态 |
|---|---|---|---|---|
| 1 | 金蝶 ↔ 旺店通仓库映射 | 待统计 | 业务方 | ⬜ 待确认 |
| 2 | 金蝶 ↔ 旺店通货品映射 | 待统计 | 业务方 | ⬜ 待确认 |
| 3 | 客户主体 → 目标组织路由表 | 待确认 | 业务方 | ⬜ 待确认 |
采购订单取值规则确认
| 序号 | 取值规则 | 说明 | 确认人 | 状态 |
|---|---|---|---|---|
| 1 | 供应商取值 | 固定供应商 / 按组织配置 | 财务方 | ⬜ 待确认 |
| 2 | 采购价取值 | 参考价 / 最近采购价 / 合同价 | 财务方 | ⬜ 待确认 |
| 3 | 税率取值 | 默认税率 / 按货品配置 | 财务方 | ⬜ 待确认 |
| 4 | 结算组织取值 | 与目标组织相同 / 单独配置 | 财务方 | ⬜ 待确认 |
常见问题
新增组织相关
| # | 问题 | 回答 |
|---|---|---|
| 1 | 新增一个目标组织需要多长时间？ | 只需 3 步配置（组织凭证 + 路由规则 + 表单映射），约 1 小时内完成，无需开发。 |
| 2 | 新增组织是否需要重新部署？ | 不需要。所有配置即时生效，下一次业务流触发时自动使用新配置。 |
| 3 | 新增组织是否支持部分业务流？ | 支持。可以只为新组织开启部分业务流（如只做调拨推送，不做销售回传），灵活配置。 |
| 4 | 最多支持多少个目标组织？ | 架构上无限制。实际数量取决于金蝶 API 的并发能力和网络带宽。 |
异常处理相关
| # | 问题 | 回答 |
|---|---|---|
| 5 | 推送失败后怎么处理？ | 系统自动重试（指数退避，最多 5 次）。超过阈值后标记为”需人工介入”并触发告警。 |
| 6 | 重复推送会导致重复单据吗？ | 不会。每个业务流都有幂等键（源系统 + 源单号 + 业务类型），重复推送会被自动跳过。 |
| 7 | 网络中断期间的单据怎么处理？ | 恢复后系统会自动拉取中断期间的所有未处理单据并补推。 |
| 8 | 如何查看某笔单据的推送状态？ | 在同步日志中通过源单号查询，可看到完整的推送记录（时间、结果、错误信息、重试次数）。 |
数据与安全相关
| # | 问题 | 回答 |
|---|---|---|
| 9 | 金蝶和旺店通的 API 凭证如何存储？ | 凭证加密存储在配置中心，仅系统运行时可解密使用。支持按组织独立配置凭证。 |
| 10 | 同步日志保留多长时间？ | 默认保留 90 天，支持按需调整。历史日志可导出归档。 |
| 11 | 修改字段映射是否影响正在处理的单据？ | 不会。配置变更后，只有新触发的业务流使用新配置，正在处理中的单据不受影响。 |
性能相关
| # | 问题 | 回答 |
|---|---|---|
| 12 | 单次推送的最大单据量是多少？ | 单次任务支持处理数千条单据明细行。实际吞吐量取决于金蝶/旺店通 API 的限流策略。 |
| 13 | 推送延迟是多少？ | 正常情况下，源单触发后 1–5 分钟内完成目标单写入（不含重试）。 |
| 14 | 是否支持批量推送？ | 支持。系统按批次拉取和推送单据，每批次大小可配置。 |
风险评估
| 风险项 | 影响 | 概率 | 应对措施 |
|---|---|---|---|
| 金蝶 formId 确认延迟 | 阻塞第 2 阶段开发 | 中 | 第 1 阶段优先确认，预留 1 天缓冲 |
| 旺店通 API 限流严格 | 影响推送吞吐量 | 低 | 实现限流自适应，自动调整推送速率 |
| 客户主体字段位置不明确 | 影响拆分逻辑 | 中 | 提前与金蝶实施方确认字段路径 |
| 仓库/货品映射数据不完整 | 影响单据推送准确性 | 中 | 第 1 阶段收集完整映射数据，建立 SKU 上架检查点 |
| 多组织并发写入冲突 | 影响数据一致性 | 低 | 按组织串行化写入，避免并发冲突 |
最后更新