主题
商城平台定价
价格口径
xd_mall_sku.price_fen/ 商户接口priceFen:商家供货结算价,保留既有商户接口契约。xd_mall_sku.sale_price_fen/ 管理端salePriceFen:平台逐 SKU 设置的售价,未配置时为空。- 用户端 SKU
priceFen、列表最低价、购物车购买价均为平台售价;有效秒杀使用秒杀价。用户端不返回供货结算价。 - 商品明细结算额 = 下单时供货结算价 × 数量,不再按商品金额的 90% 计算。原有优惠分摊、支付手续费和退款处理规则继续生效。
- 平台售价、秒杀价必须大于零且不低于供货结算价。若以后需要平台承担亏损的补贴销售,应单独设计资金承担规则。
操作流程
- 商家提交供货结算价,商品进入待审核。
- 管理端「商城商品」列表点击「定价审核」,填写全部 SKU 的平台售价,再点击「保存售价并通过」。
- 审核通过或已下架的商品可在详情中「保存售价」,不会改变上下架状态。
- 商家再次编辑商品时重新进入待审核;保留已有 SKU 的平台售价供审核确认,新 SKU 未定价。商户接口不能修改平台售价。
- 审核或改价时若 SKU、供货价或原平台售价已改变,服务端拒绝提交,需刷新后重新确认。
首次发布
- 迁移文件:
Api/ruoyi-system/src/main/resources/db/migration/V20260915_001__mall_platform_sale_price.sql。 - 迁移只新增售价列,并将原在售、已下架且未删除的商品转为待审核,不将供货价自动复制成平台售价。
- 首次发布需要安排商城暂停销售与运营补价窗口。待审核、已拒绝商品保留原状态。
- 数据迁移、API 与 AdminWeb 应作为同一发布协调切换。旧 API 不识别平台售价,切换完成前不得恢复商城审核上架;回退旧 API 也必须先暂停商城销售。
- 已有订单、支付记录、结算快照不回算;新下单才使用新的供货价结算口径。
- 已配置秒杀价低于供货价的商品,需要先调整或关闭秒杀,再通过定价审核。
- 本变更不自动部署,也不执行线上迁移。
本地验证
bash
cd Api
LOG_PATH=/tmp/xiedao-test-logs mvn -pl ruoyi-admin -am test \
'-Dtest=*Mall*Test' -Dsurefire.failIfNoSpecifiedTests=false管理端浏览器测试为 AdminWeb/tests/mall-pricing.browser.mjs,使用本地 Vite 和模拟 API,不连接线上。可通过 TEST_BASE_URL、PLAYWRIGHT_MODULE、 PLAYWRIGHT_EXECUTABLE_PATH 指定本地环境。