沃尔玛Marketplace Item Spec 5.0：10.15发布，二手翻新机新增conditionNotes选填字段

沃尔玛开发者平台（Walmart Developer Platform）在 2026 年 10 月 15 日发布了 Item Spec 5.0 版本，版本号为 5.0.20260829-12_49_39，适用于 MP_ITEM、MP_MAINTENANCE、MP_WFS_ITEM 和 OMNI_WFS 四个 feed 类型。最核心的变化是新增了一个可选字段 conditionNotes，供合资格的非新品 Resold 商品填写具体成色细节。对二手电子、翻新家电、退货转售这类卖家来说，这个字段是把"东西到底什么状态"讲清楚的新位置；但对所有卖家来说，更该关注的是它同时带来的第二项变更——那影响的人群比第一项大得多。

第二项变更才是覆盖面更广的那条

官方公告把 5.0 拆成两节。第一节是新增 conditionNotes，第二节是 Expanded condition eligibility for additional Product Types —— 现有 Marketplace 成色值现在向更多已批准的 Product Type 开放，包括部分 Baby（婴童）、Nursery（婴幼儿）、Sporting Goods（运动户外）、Automotive（汽车）与 Electronics（电子产品） 类目下的 Product Type。

这一节的核心机制是：这些 Product Type 现在可以使用既有的成色值，包括 Pre-Owned、Open Box、New without box、New with defects 和 Restored（视适用情况）。官方给出的原因是过去存在 Product Type 配置缺口，导致这部分库存无法被准确表达。

这里有个容易被读反的地方：这是"把既有成色值开放给更多 Product Type"，不是"新增成色值"。 官方在第二节的结尾明确写：本次更新不引入新的成色值，也不改变现有 Marketplace 成色定义与政策。能力被解锁的方向是 Product Type 的覆盖面，不是成色枚举本身。

官方还附了一张按 Product Type 列出支持成色的完整表。可以看到解锁范围相当具体：婴童类目下 Baby Play Yards、Baby Scales、Baby Feeding Chairs、Baby Walkers、Baby Strollers、Baby Car Seat Trays 等支持 Pre-Owned: Like New / Good / Fair；汽车类目下 Towing Winches 支持 Restored 全部四档加 Pre-Owned 三档；Filming Cameras 支持 New without box、New with defects、Open Box、Pre-Owned 三档、Restored 四档；园艺类目下泳池相关 Product Type（Fountain/Pond & Pool Pumps、Pool Filter Cartridges、Pool Heaters、Spa Covers 等）只支持 Restored: Like New；电动工具类目下大量 Power Tools 子类支持 New without box。

conditionNotes 字段本身：填什么、怎么填

官方给的定义是：为合资格的非新品 Resold 商品新增可选属性 conditionNotes，明确包含 Pre-Owned（二手）与 Restored（翻新） offer。

有几条使用规则值得记清。它补充而不替代：官方原文是"Condition notes 补充所选的 Condition 值，不替代产品级描述（does not replace the product-level description）"。所以它是 offer 级别的补充说明，不是让你改写商品描述。可以在维护时改：卖家可在商品创建时添加，也可在商品维护阶段更新，无需下架该 offer。

位置随 spec 变化：属性在各spec 中的位置不同——受支持时紧邻现有的 Condition 属性出现，在其他 spec 中则位于 Optional/Recommended 部分。这意味着不同 feed 的字段位置要分别核对，不能照搬。

本期能力边界：官方写明 10 月这一版里 conditionNotes 是可选的，支持创建、维护、基础质量与成色一致性校验，以及在商品页展示卖家提供的成色细节。Seller Center 可用现有的生成式 AI（GenAI）能力帮助卖家提升填写内容的质量。官方还给了填写要求：应当简洁、事实性、与商品相关，并与所选 Condition 一致。

官方给的 JSON 示例很能说明它的用法：

{
  "condition": "Pre-Owned: Good",
  "conditionNotes": "Fully functional and tested. Light scratches on the back casing; screen has no scratches. Includes a USB-C cable and ships in secure generic packaging."
}

这个示例的写法有两个可借鉴的点：一是它把可验证的事实写具体（功能已测试、机身背面有划痕、屏幕无划痕、含USB-C 线、原厂通用包装），而不是写"轻微使用痕迹"这种无法核验的描述；二是它主动交代了配件与包装，减少了买家收货时的预期落差。

官方给的填写方法：可以照抄的写法逻辑

官方在公告里给的不只是字段定义，还有一段填写要求和一段 GenAI 提示，这两段决定了这个字段实际能写到什么程度。

填写要求是官方原话：内容应当简洁、事实性（concise, factual）、与商品相关（relevant to the item）、并与所选的 Condition 一致（consistent with the selected Condition）。四个词里，"一致"两个字是硬约束——官方在本期支持的校验项里明确包含 condition-consistency validation（成色一致性校验），也就是说写一段与所选成色档次不符的描述，系统会拦。

GenAI 提示来自 Seller Center 侧：卖家中心可使用现有的生成式 AI 能力帮助卖家提升所填内容的质量。注意这写的是提升质量，不是代写内容——用 GenAI 生成成色描述时，最终的真实性责任仍在卖家，而成色一致性校验这一关恰恰是 AI 容易翻车的地方。

提交渠道官方写明是 SFF 与 WFS 的商品创建与维护流程（Sellers can use this attribute in SFF and WFS item setup and maintenance flows）。SFF 是 Seller Fulfilled（卖家自发货）的缩写，WFS 是 Walmart Fulfillment Services。这两个流程覆盖了自发货与沃尔玛仓配两种履约方式。

结合前面提到的填写要求，一个实用判断是：**这个字段适合写可核验的客观事实，不适合写主观形容。**官方示例里"功能已测试""背面有划痕""屏幕无划痕""含USB-C 线""原厂通用包装"都属于可核验事实；而"轻微使用痕迹""成色良好"这类描述既无法核验，也容易与所选成色档次打架。

风险点：不是必填，但不迁移会有代价

conditionNotes 是可选字段，不填不会违规。但官方公告同时提醒了技术侧的连带影响：未迁移到新接口、或未及时更新 Feed 格式的卖家，可能遇到数据校验失败、成色信息不展示、产品维护任务报错三类问题。

这三类问题的触发条件不是"你用了二手类目"，而是"你的接口和 Feed 没跟上新版本"。用 MP_ITEM、MP_MAINTENANCE、MP_WFS_ITEM、OMNI_WFS 的卖家都需要确认这四个 feed 是否已支持该可选字段，并保留一次提交校验的结果作为记录。

对二手电子、翻新手机与电脑、家电、汽车配件、退货转售商品、收藏品这几类卖家，conditionNotes 提供的是一个不改商品级描述就能讲清成色的位置——考虑到它支持成色一致性校验，填写质量本身也会影响后续的表现。

注意事项

第一，下载最新版 spec 文件并看 diff report。 官方要求在 Item spec reporting and version table 里查看与上一版本的差异报告（diff reports），这一步不能跳过。

第二，先确认你的 Product Type 在不在解锁名单里。 婴童、婴幼儿、运动户外、汽车、电子类目下的 Product Type 现在能用既有成色值了，但如果你的具体 Product Type 不在官方那张表里，这项变更对你无效。查表，不要按大类推。

第三，三个 feed 的字段位置分别核对。 官方明确说属性位置随 spec 变化，受支持时紧邻 Condition 属性，其他 spec 里在 Optional/Recommended 部分。

第四，填写内容要与所选的 Condition 一致。 官方把"与所选 Condition 一致"写成了明确要求，并配了成色一致性校验。选了 Pre-Owned: Good 却写严重磕碰，属于不一致。

第五，加拿大站情况不同。 沃尔玛加拿大站（walmart.ca）的 Marketplace Learn 指南明确写着：目前只支持"New"成色的商品，填非"New"成色的 offer 会被自动下架。这与美区的 5.0 变更不是一回事，按站点分别核对。

FAQ

Q：conditionNotes 是必填的吗？ A：不是，官方明确是可选属性。本期支持创建、维护、基础质量与成色一致性校验，以及在商品页展示。

Q：新增了 Remanufactured（翻新再制造）这个成色吗？ A：没有。官方公告写明本次更新不引入新的成色值，也不改变现有 Marketplace 成色定义与政策。conditionNotes 适用于合资格的非新品 Resold 商品，明确包含 Pre-Owned 与 Restored。

Q：这次变更会影响哪些卖家？ A：影响面分两层。直接用到 conditionNotes 的是二手电子、翻新家电、退货转售、收藏品卖家；间接受影响的是使用 MP_ITEM、MP_MAINTENANCE、MP_WFS_ITEM、OMNI_WFS 的所有卖家——即使不用新字段，接口与 Feed 未跟上新版本也可能出现校验失败或维护报错。

Q：填了 conditionNotes 还要改商品描述吗？ A：不需要。官方明确 conditionNotes 是补充所选的 Condition 值，不替代产品级描述。它是 offer 级别的说明。

Q：可以用 AI 帮我写这个字段吗？ A：官方写的是 Seller Center 可用现有 GenAI 能力帮助提升所填内容的质量，不是代写内容。本期支持的校验包含成色一致性校验，生成内容最容易在这关上与所选 Condition 档次不符，最终真实性责任仍在卖家。

Q：更新 conditionNotes 需要先下架商品吗？ A：不需要。卖家可在商品创建时添加，也可在商品维护阶段更新，无需下架该 offer。

参考来源

• Walmart Developer Platform 官方公告：《New: Item spec 5.0 version, October 2026》（发布日期 October 15, 2026，版本号 5.0.20260829-12_49_39，四个 feed 类型，conditionNotes 全部七条 What changed、JSON 示例、Product Type 成色资格完整对照表、官方"不引入新成色值"表述）
• 亿邦动力/行业媒体对 Item Spec 5.0 的转述（发布日期 10 月 15 日、未迁移可能遇到数据校验失败/成色不展示/维护任务报错三类风险）
• Walmart Marketplace Learn 加拿大站指南：《Item Spec 5.0- Item Setup Methods &Overview》（walmart.ca 目前只支持 New 成色，非New 成色 offer 会被自动下架）