← 返回教程列表
字段与单据金蝶云星辰
销售订单币种字段取得之后,如何与金额和汇率一起验收
发布于 更新于 华远智联科技有限公司技术团队
接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。
适用于已经定位到订单币种来源,需要把订单金额传给外部业务或财务系统的场景。取得一个币种名称,不等于多币种数据映射已经完成;下游还需要知道金额属于哪种货币、采用哪一层的汇率。
先建立字段口径表
将币种标识、币种名称、原币金额、本位币金额、汇率及金额精度分别列出。每一项记录当前接口字段、所在层级、空值处理与目标字段。响应中未公开的字段保持待确认,不根据名称相似就补出一个值。
不要把默认币种当作订单币种
账套默认设置和具体单据的币种可能承担不同职责。只有当前产品文档与业务人员确认适用条件后,才能设置缺省规则;否则应把缺失币种的数据转到待核对队列,避免静默入账。也不要在接入程序里擅自用实时汇率重算历史单据。
逐层检查金额
检查金额来自表头还是分录,是否包含税、折扣及费用。明确目标系统需要的是单据总额还是逐行金额。币种、汇率及金额字段应作为同一份同步快照处理,避免一部分是旧数据、一部分是新数据。
用什么样本验收
至少覆盖本位币、外币、存在折扣或费用的订单,以及已更新的订单。按双方确认的精度核对单据汇总与分录,不预设任何状态枚举或取最大值规则。若列表和详情采用不同字段范围,先完成币种来源核对,再开展这里的金额语义验收。
参考与适用边界
- 金蝶开发者社区原始问题:社区历史讨论,用于定位问题现象;技术规则请核对当前官方文档。
- 精斗云开放平台文档入口:接入前选择对应产品与版本,核对当前接口说明。
本文提供问题排查与集成设计建议;具体字段、权限和业务限制需按当前文档在授权测试环境验证。
下一步:确认对接范围
需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。