← 返回教程列表
字段与单据金蝶云星辰

销售退货单提示“数量不能为空”:检查分录层级、类型与单位精度

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

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

适用于销售退货单保存时,请求看似已包含数量,业务响应却提示数量为空的场景。错误提示说明校验未取得有效数量,不能仅凭这个提示就认定一定是小数精度或平台缺陷。

从最终发出的请求开始

查看序列化后的实际请求体,而不是程序中打印的对象变量。核对数量字段是否位于正确分录、字段名大小写及类型是否符合当前接口。特别检查零值是否被条件表达式过滤、数字是否变成空字符串,以及分录数组是否在转换时丢失。

用最小数据区分原因

在允许的测试环境中,只保留一行已确认有效的商品、单位与数量,先验证整数数量能否保存,再测试业务需要的小数数量。这样可以区分字段层级问题与精度问题。数量方向、负数是否允许和退货业务类型,按当前接口的明确要求测试,不套用其他单据规则。

再查单位与精度

核对商品基本单位、业务单位及换算关系;接口需要单位内码时,不能直接用显示名称替代。检查本地数据库、JSON处理及下游字段是否提前截断小数。不要为了绕过报错,把应退的小数数量直接取整,也不要未经评估修改生产账套的全局精度。

验收标准

保存后回查退货单的商品、单位、数量与金额,并核对前台显示。覆盖零值、整数、允许的小数及多单位样本;错误数据应有明确提示而不是被悄悄修正。保留脱敏的最小失败请求、业务响应及成功对照,才能继续向平台核实具体校验条件。

参考与适用边界

本文提供问题排查与集成设计建议;具体字段、权限和业务限制需按当前文档在授权测试环境验证。

下一步:确认对接范围

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

相关教程

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

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

免费获取对接方案