← 返回教程列表
字段与单据金蝶云星辰
销售退货单提示“数量不能为空”:检查分录层级、类型与单位精度
发布于 更新于 华远智联科技有限公司技术团队
接口字段、权限与调用限制可能随产品版本调整。本文用于说明对接与排查思路,实际接入请核对当前官方文档,并在测试环境验证。
适用于销售退货单保存时,请求看似已包含数量,业务响应却提示数量为空的场景。错误提示说明校验未取得有效数量,不能仅凭这个提示就认定一定是小数精度或平台缺陷。
从最终发出的请求开始
查看序列化后的实际请求体,而不是程序中打印的对象变量。核对数量字段是否位于正确分录、字段名大小写及类型是否符合当前接口。特别检查零值是否被条件表达式过滤、数字是否变成空字符串,以及分录数组是否在转换时丢失。
用最小数据区分原因
在允许的测试环境中,只保留一行已确认有效的商品、单位与数量,先验证整数数量能否保存,再测试业务需要的小数数量。这样可以区分字段层级问题与精度问题。数量方向、负数是否允许和退货业务类型,按当前接口的明确要求测试,不套用其他单据规则。
再查单位与精度
核对商品基本单位、业务单位及换算关系;接口需要单位内码时,不能直接用显示名称替代。检查本地数据库、JSON处理及下游字段是否提前截断小数。不要为了绕过报错,把应退的小数数量直接取整,也不要未经评估修改生产账套的全局精度。
验收标准
保存后回查退货单的商品、单位、数量与金额,并核对前台显示。覆盖零值、整数、允许的小数及多单位样本;错误数据应有明确提示而不是被悄悄修正。保留脱敏的最小失败请求、业务响应及成功对照,才能继续向平台核实具体校验条件。
参考与适用边界
- 金蝶开发者社区原始问题:社区历史讨论,用于定位问题现象;技术规则请核对当前官方文档。
- 精斗云开放平台文档入口:接入前选择对应产品与版本,核对当前接口说明。
本文提供问题排查与集成设计建议;具体字段、权限和业务限制需按当前文档在授权测试环境验证。
下一步:确认对接范围
需要将接口能力落地到业务系统?可先了解对应产品的实施范围与交付方式。