Skip to content

补齐跑腿订单金额构成与采购结算预览字段 #63

Description

@Serein207

背景

当前团长采购详情只能计算实际商品金额,无法准确得到各需求行的跑腿费;买家订单详情也没有包装费分摊字段。进入收款后,买家可能看到最终账单高于前端汇总,却无法核对差额来源。

需求

团长采购阶段

GetShoppingTaskDetail 中提供足以生成结算预览的数据,推荐直接返回服务端聚合结果:

  • 实际采购商品种类数和数量
  • 商品实际金额
  • 跑腿费合计
  • 当前预估合计

如果返回明细而非聚合值,需要保留每个需求行的数量与单件跑腿费,使前端能够无歧义汇总。

买家订单详情

BuyerErrandOrderDetail 中增加:

  • packaging_fee_share_cents
  • 最终应付金额或与账单一致的金额构成
  • 如包装费按商品行分摊,再为对应 product item 返回该行分摊值

金额不变量

  • 所有金额使用整数分,限制在 Protobuf 字段范围内。
  • 商品金额 + 跑腿费 + 包装费分摊 = 买家最终应付金额。
  • 买家详情汇总金额应与关联 Bill 的 amount_cents 一致。
  • 未采购和未分发商品不应产生商品金额;跑腿费规则按现行业务规则执行。

验收标准

  • Proto、服务实现和测试同步更新并发布到 Buf。
  • 覆盖零包装费、不能整除的向上取整分摊、部分采购、部分分发和不采购场景。
  • 团长采购完成前与买家付款前都能从接口数据完整解释金额。

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions