Shopify 条码 GTIN 校验与元字段设置

现象#

填了 12 位条码却提示格式不正确；或者条码保存成功，但 Google Merchant Center 抓不到。

原因#

• GTIN 有 8、12、13、14 位四种长度，位数与校验位都必须符合 GS1 规则
• 把内部编码当 GTIN 填，校验位算不对就被判无效
• 条码填在变体 barcode 字段，而渠道要求的是 gtin 元字段
• 同一 GTIN 被多个变体共用，渠道侧判为重复

处理步骤#

1. 先确认编码来源：GS1 前缀的正规 GTIN 才用于渠道，内部码另建字段
2. 用校验位算法验证：前 n-1 位按奇偶位加权求和，补足到 10 的倍数
3. 变体 barcode 存实际条码，需要给渠道读的再写入 custom.gtin 元字段
4. 在 设置 → 自定义数据 为商品变体创建 metafield 定义，类型选单行文本并开启店面访问
5. 批量导入后用 productVariants 查询回读，抽查 10 条与实物条码比对

验收标准#

所有变体条码通过校验位验证，渠道后台无 GTIN 报错，重复值已清理。