变体条码改为 barcodes 连接,单个变体最多 20 条
ProductVariant.barcode 弃用,旧字段只返回第一条,UPC/EAN 同步逻辑要改读新连接。
发生了什么#
2026-10 起,ProductVariant.barcode 被弃用,取而代之的是 barcodes 连接,一个变体最多可以保存 20 条带类型的条码。旧的 barcode 字段仍然存在,但只返回第一条,这让「看起来还能用」的代码变得危险。
关键细节#
- barcodes 支持多条条码,适合多包装、多供应商、多渠道场景
- 旧 barcode 字段只返回首条,不做报错也不做提示
- 同步 UPC、EAN、GTIN 的脚本需要改读 barcodes 连接
- 零售与仓储扫码匹配若依赖单条码,遇到多码商品会匹配失败
- 新连接支持为条码标注类型,便于区分 UPC、EAN 与内部编码
对商家与开发者的影响#
多包装商品(单支、三支装、整箱)终于可以在一个变体上记录多条条码,减少重复建变体。
不改造的同步脚本会静默只取第一条,导致扫码枪扫到第二、第三条时查不到商品。这类问题通常要等到仓库现场才发现。
如果仓库系统只支持一个条码字段,需要在同步层做映射,明确哪一条是主条码、其余如何回退。
多包装商品建议把外箱条码与单件条码都录进去,退货入库时才能按实际包装匹配。
建议动作#
- 检查所有读取 barcode 的同步任务与打印模板
- 改读 barcodes,并明确业务上以哪一条为主条码
- 在仓库用多码商品做一次实际扫码测试
原文与编译说明
- 原文标题
- Product variant barcodes
- 发布来源
- Shopify 2026-10 release notes
- 发布时间
- 2026-10-01
本文为中文编译摘要,包含站方补充的背景与影响分析,不是原文的逐字翻译。版权归原作者与发布方所有。若原文后续更新或信息有误,以官方页面为准;发现错误可发邮件到 admin@fgwljs.com 指出。
新闻栏目由 风格技术 技术团队维护,每个工作日筛选 Shopify 官方渠道与行业媒体的更新。功能是否可用,以店铺后台实际显示与官方文档为准。