沃尔玛 Marketplace 上线促销价校验：API 卖家可在沙盒先模拟下单验证成交价
大促期间促销价没生效，最容易出事的不是价格本身，而是宣传价和订单实际扣款不一致。
沃尔玛开发者平台近日在动态沙盒（Dynamic Sandbox）里新增一份校验配方，用途是把促销价的验证步骤串成一条链路：为测试 SKU 创建促销，在促销生效后模拟下单，再确认订单是否正确套用了促销价。配套还给出了前置条件、校验指引，以及 cURL、Python、Java 三套代码示例。
这不是一次佣金或费率调整，也不改变面向消费者的促销规则。它的价值在于把配置错误挡在上线之前，而不是等买家下单后才发现成交价和宣传不符。
一、面向谁
工具的适用对象很明确：用沃尔玛 Marketplace API、ERP、PIM、订单管理系统或第三方软件批量管理商品与促销的卖家。
据沃尔玛开发者平台说明，动态沙盒现已支持选定的定价与促销接口。合作方可以用自定义测试商品更新基础价，也可以创建、更新、删除、查询促销价，再决定是否把同一套流程推到生产环境。
换句话说，它服务的是有技术改造能力的团队。只靠在卖家后台手工设置促销的卖家，并不在这份配方的覆盖范围内。
二、校验三步骤
第一步是确认基础价。沃尔玛开发者平台在本次更新中专门补充了指引，要求在建促销之前先核对测试 SKU 的基础价格，避免基础价本身就设错。
第二步是创建并核对促销。配方给出了建促销、验证促销状态的步骤，并在请求层面使用定价与促销接口，基础价走价格更新接口，促销价走带 promo 参数的更新接口与对应的查询接口。
第三步是模拟下单。促销生效后提交一笔测试订单，再核对这笔订单最终是否按促销价成交。这一环是传统改价流程里最缺的，因为过去很难在不影响真实订单的前提下看到成交结果。
从接口字段看，这套流程还有几处细节。促销的生效日与到期日都要填写，到期日距当前时间不能超过 365 天；价格类型可标记为 REDUCED 或 CLEARANCE；更新与删除通过 processMode 字段区分，取值 UPSERT 或 DELETE。理解这些字段的含义，是看懂校验结果的前提。
三、适用边界
接入方式有技术门槛。据开发者平台文档，沙盒请求需指向 sandbox.walmartapis.com，并在需要走动态沙盒的请求里带上 WM_SANDBOX: v2 请求头；而依赖静态模拟响应的集成，则应保留或取消该头。
地域也有限制。开发者平台在接口文档中标注，动态沙盒仅在美国市场可用。做美国站的卖家可以直接使用，其他站点的卖家暂时无法套用同一套流程。
批量口径则要看清楚。促销价支持批量更新，单次最多可处理 10000 个商品；平台为了提高处理效率，建议单次不超过 1000 个商品，且文件大小控制在 10MB 以内。校验配方针对的是单 SKU 的测试链路，与批量改价是两件事。
四、落地清单
对走 API 的团队，第一件事是先用测试 SKU 跑通整套代码，把基础价核对、建促销、模拟下单、读回成交价四个动作连成一次验证。
第二件事是把校验常态化。大促期间同时在跑的促销往往几十上百条，可以在活动开始前用测试 SKU 验证配置，活动开始后对在跑促销抽样比对宣传价与订单金额，先看那些折扣力度大、变动频繁的链接。
第三件事是留痕。把每个促销的生效时间、覆盖 SKU 和校验结果记录下来，一旦出现价格争议，这份记录就是排查问题的起点。
五、校验通不过不等于安全
工具的边界要先说清楚。它只覆盖走 API 的批量链路，手工在后台设置促销的卖家不受益；动态沙盒也仅限美国市场。这些限制决定了它解决的不是普遍问题。
更关键的是，校验通过不等于定价绝对安全。基础价被错误覆盖，源头往往不在促销接口，而在 ERP 与平台之间的字段映射错误——比如系统把折后价写回成了基础价。这类问题需要从数据源头上排查，单靠一次沙盒校验发现不了。
从行业惯例看，沃尔玛对促销价与划线价有独立的核价规则。按沃尔玛 Marketplace 的公告口径，促销价通常要比历史价至少低 10%，才能拿到划线展示与降价或清仓标识；而历史价的认定，取的是过去 90 天买家成交价的中位数，或者平台与卖家在过去 90 天中至少 28 天提供的中位价。校验工具能保证接口层面配置正确，却不能替代卖家对这条核价规则的理解。
对已经把改价流程交给系统的团队，这套配方补上了最后一公里的验证环节。真正决定效果的，仍是团队愿不愿意在每次大促前把测试链路完整跑一遍。
参考资料
- 沃尔玛开发者平台：《New: Validate promotional pricing in Dynamic sandbox》
- 沃尔玛开发者平台：《New: Sandbox Pricing and Promo Simulations》
- 沃尔玛开发者平台：《Promotional prices》接口文档
- 沃尔玛开发者平台：《Update a promotional price》接口文档
- 沃尔玛 Marketplace：《Promotional pricing updates》公告