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

金蝶云星辰零售单src_bill_id与优惠券:关联标识和核销流程如何验证

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

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

适用于零售单保存中不清楚src_bill_id来源,或错误提示要求先进行优惠券预核销的场景。关联单据标识与优惠券核销属于不同的问题,应分别确认后再验证完整交易流程。

关联标识从业务关系确认

查当前接口对src_bill_id的定义、适用业务和必填条件,确认它指向哪一方的哪类单据。不要仅凭名称就认定它是调用方任意生成的UUID,也不要将显示单号与内部标识直接互换。若必须先创建关联对象,按公开流程取得其真实标识。

优惠券先画状态流程

向当前产品文档确认是否存在预核销、确认、释放或撤销,以及每一步的调用主体和关联标识。前台可用的优惠券,不一定能在API请求中直接核销。超时与有效期按当前规则处理,不写未经核对的固定分钟数。

重点测试不确定结果

预核销成功但零售单失败、保存成功但响应丢失、取消交易、重复提交,都需要有明确处理方式。先查询已确认的业务状态,再决定重试或补偿。不要在每次重试时生成新的关联标识,否则可能造成重复单据或重复占用优惠权益。

验收标准

一笔交易的源单、零售单、优惠券及金额能够对应;失败或取消后,权益不会长期悬挂;重复通知或重复请求不会产生额外核销。若相关能力没有公开接口,应先确认业务支持范围。本文是流程核对建议,不将历史社区问答等同于当前零售接口规范。

参考与适用边界

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

下一步:确认对接范围

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

相关教程

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

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

免费获取对接方案