← 返回教程列表
接入准备金蝶云星辰 / 精斗云

金蝶 API 沙箱调通后,切换正式账套要检查哪些内容?

发布于 华远智联科技有限公司技术团队

接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。

沙箱调通,说明某组测试数据和配置下的调用链路可用。正式上线还需要核对授权对象、数据映射和业务约束,不能仅替换一组凭证就直接批量推送。

金蝶官方将沙箱定义为 API 调试用的非正式环境,并说明沙箱数据会定期清理,不能用作正式业务环境。使用沙箱环境

第一步:确认正式授权对应哪个账套

由客户确认公司、产品服务、账套与业务期间,再检查开发者后台中的授权记录。多账套客户尤其应建立“业务主体—应用—授权账套”的对应关系,不要依靠相似的账套名称判断。

官方企业授权说明要求核对授权服务和账套。购买服务后仍需按所选应用类型完成授权,具体操作以当前后台为准。自建应用企业授权

建议在配置中给环境明确命名,并在管理界面显示脱敏的目标账套标识。只有授权记录、程序配置和业务确认三者一致,才打开正式写入开关。

第二步:重新核对凭证与映射

沙箱与正式环境的凭证、基础资料和消息地址应分别管理。不要从沙箱复制商品、仓库、单位或客户的内部 ID 后直接写入正式账套。

建议先执行只读验证:

  1. 从正式账套读取一条由客户指定的基础资料。
  2. 核对其编码、名称、状态与前台记录。
  3. 重新建立外部编码与正式内部标识的映射。
  4. 检查未知编码、停用资料与多单位的处理方式。

凭证缓存也应区分环境和授权对象,避免某一账套刷新凭证后覆盖另一账套的配置。凭证有效期及更新方式需按对应产品当前文档实现。

第三步:验证消息和网络链路

分别核对正式消息接收地址、证书、网络访问与订阅配置。测试回调地址可访问,只能证明接收链路中的一部分;还要检查消息是否落库、业务处理是否成功、失败是否有记录。

若产品与业务场景支持消息订阅,建议用一笔经客户同意的测试业务验证从变更到消费的全过程,避免沿用沙箱订阅而遗漏正式配置。

第四步:小范围写入,逐项查回

正式测试可能形成实际业务记录,应由业务负责人确认测试范围及清理方式。先用少量可追踪的业务数据验证新增、修改、失败处理与重复提交,再决定批量上线。

验收时至少核对单据编号、商品和单位、数量、金额、税额、业务状态及目标账套。接口返回成功后仍要查询结果,并与前台或报表按同一业务口径比对。

第五步:准备暂停与补偿方案

建议保留切换前配置、首批单据清单和可恢复的处理进度。异常时先暂停新写入,确认影响范围,再按业务规则更正;不要通过反复提交碰运气。

“可回退”不意味着已经写入的业务单据能直接删除。已审核、已下推或进入后续核算的单据,应由业务人员确认冲销、更正或其他合规处理路径。

需要联调协助时,可提供脱敏的授权页面信息、环境标识、调用时间与一笔可复现单据。授权准备清单可用于补齐前置条件。

下一步:确认对接范围

需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。

相关教程

需要专业的接口对接服务?

华远智联科技有限公司专注金蝶系列产品 API 对接,提供定制化开发方案,快速打通您的业务系统。

免费获取对接方案