Skip to content

商城平台定价 ​

价格口径 ​

  • xd_mall_sku.price_fen / 商户接口 priceFen:商家供货结算价,保留既有商户接口契约。
  • xd_mall_sku.sale_price_fen / 管理端 salePriceFen:平台逐 SKU 设置的售价,未配置时为空。
  • 用户端 SKU priceFen、列表最低价、购物车购买价均为平台售价;有效秒杀使用秒杀价。用户端不返回供货结算价。
  • 商品明细结算额 = 下单时供货结算价 × 数量,不再按商品金额的 90% 计算。原有优惠分摊、支付手续费和退款处理规则继续生效。
  • 平台售价、秒杀价必须大于零且不低于供货结算价。若以后需要平台承担亏损的补贴销售,应单独设计资金承担规则。

操作流程 ​

  1. 商家提交供货结算价,商品进入待审核。
  2. 管理端「商城商品」列表点击「定价审核」,填写全部 SKU 的平台售价,再点击「保存售价并通过」。
  3. 审核通过或已下架的商品可在详情中「保存售价」,不会改变上下架状态。
  4. 商家再次编辑商品时重新进入待审核;保留已有 SKU 的平台售价供审核确认,新 SKU 未定价。商户接口不能修改平台售价。
  5. 审核或改价时若 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 指定本地环境。

携岛 XieDao · 内部文档