背景
当前团长采购详情只能计算实际商品金额,无法准确得到各需求行的跑腿费;买家订单详情也没有包装费分摊字段。进入收款后,买家可能看到最终账单高于前端汇总,却无法核对差额来源。
需求
团长采购阶段
在 GetShoppingTaskDetail 中提供足以生成结算预览的数据,推荐直接返回服务端聚合结果:
- 实际采购商品种类数和数量
- 商品实际金额
- 跑腿费合计
- 当前预估合计
如果返回明细而非聚合值,需要保留每个需求行的数量与单件跑腿费,使前端能够无歧义汇总。
买家订单详情
在 BuyerErrandOrderDetail 中增加:
packaging_fee_share_cents
- 最终应付金额或与账单一致的金额构成
- 如包装费按商品行分摊,再为对应 product item 返回该行分摊值
金额不变量
- 所有金额使用整数分,限制在 Protobuf 字段范围内。
- 商品金额 + 跑腿费 + 包装费分摊 = 买家最终应付金额。
- 买家详情汇总金额应与关联 Bill 的
amount_cents 一致。
- 未采购和未分发商品不应产生商品金额;跑腿费规则按现行业务规则执行。
验收标准
- Proto、服务实现和测试同步更新并发布到 Buf。
- 覆盖零包装费、不能整除的向上取整分摊、部分采购、部分分发和不采购场景。
- 团长采购完成前与买家付款前都能从接口数据完整解释金额。
背景
当前团长采购详情只能计算实际商品金额,无法准确得到各需求行的跑腿费;买家订单详情也没有包装费分摊字段。进入收款后,买家可能看到最终账单高于前端汇总,却无法核对差额来源。
需求
团长采购阶段
在
GetShoppingTaskDetail中提供足以生成结算预览的数据,推荐直接返回服务端聚合结果:如果返回明细而非聚合值,需要保留每个需求行的数量与单件跑腿费,使前端能够无歧义汇总。
买家订单详情
在
BuyerErrandOrderDetail中增加:packaging_fee_share_cents金额不变量
amount_cents一致。验收标准