GS1 Digital Link 详解
最后更新:2026年6月12日
一个码同时服务于人和系统
传统条码只承载一个数字。网页链接只打开一个页面。GS1 Digital Link 将二者结合:一个其路径 就是 产品 GS1 标识的 URL。这正是每个 PassportCraft 二维码所采用的格式,而它对数字产品护照很重要,因为同一个实物码必须服务于买家、零售商、海关和回收方。我们的洞察文章 产品护照二维码与 GS1 Digital Link 介绍了欧盟为何选定这一标准;本页则介绍它在 PassportCraft 中如何运作。
您护照 URL 的构成
https://passportcraft.com/01/05060123456781——01是 GTIN 的 GS1 应用标识符,后跟补齐至 14 位的您的 GTIN(GS1 Digital Link 格式要求恰好 14 位)。https://passportcraft.com/01/05060123456781/21/SER123——当护照的 序列号 字段已填写时,URL 会加上21(序列号的应用标识符),从而标识单件物品而非整条产品线。
这些 URL 不用您自己构造;二维码面板会根据护照的 GTIN 和序列号来构建它们,如 下载与打印二维码 中所述。
扫码时会发生什么
passportcraft.com 上的 /01/ 路径是一个 GS1 Digital Link 解析器,按 GS1 一致性解析器标准(1.2.0 版)构建。扫码时:
- 解析器从 URL 中读取 GTIN(以及序列号,如存在)。所有标准 GTIN 长度(8、12、13 和 14 位)都被接受并匹配到您的护照。
- 它查找该 GTIN 对应的护照。一个序列化 URL(
/21/...)只匹配同时具有该确切 GTIN 和 序列号的护照。 - 它重定向到护照的公开页面——人类访问者的默认目的地。
软件可以请求默认页面以外的内容。带 ?linkType=linkset 的请求会返回一份机器可读的列表,列出该产品可用的一切——护照页面外加一个结构化的 JSON-LD 数据端点。这只对已发布护照有效:对未发布护照的 linkset 请求会返回 404。解析器还在 /.well-known/gs1resolver 处发布一份关于自身的标准描述,支持 GS1 的工具正是借此了解它支持哪些功能。
扫描器可能附加的其他 GS1 限定符(批号/批次、有效期)不会造成任何问题——解析器会忽略它们,并回退到产品级护照。
护照未上线时
扫描器看到什么取决于护照的状态,完整内容见 草稿与已发布护照的区别:
| 护照状态 | 扫码显示的内容 |
|---|---|
| 已发布 | 已上线的护照页面 |
| 草稿(包括取消发布之后) | “此护照尚未发布”——并带有登录链接,供您自己的团队预览它 |
| 已停用(方案降级后) | “此数字产品护照已临时停用。请联系品牌方获取产品信息。” |
| 该 GTIN 没有对应护照 | “此数字产品护照不可用” |
在任何非已发布状态下,都不会暴露任何产品数据——访问者得到的是一个中性提示页面。
取消发布不会让 URL 失效——它只改变 URL 所显示的内容
您二维码中印的 URL 永不停止解析。取消发布会把已上线的护照换成 “尚未发布” 提示,重新发布则换回来——已印好的码会立即体现这一变化,无需任何重印。操作步骤见 发布数字产品护照。
与零售商扫描器的兼容性
由于 GS1 Digital Link 是一个标准二维码中的普通 https URL:
- 消费者 无需任何特殊工具——任何手机摄像头都能打开护照页面。
- 懂得 GS1 Digital Link 的 零售和物流系统 可以直接从 URL 中解析 GTIN,因此二维码可在其工作流程中兼作产品标识。
- 集成方 可以利用解析器的 linkset 响应,以编程方式拉取结构化的护照数据。
如果护照没有 GTIN 怎么办?
没有 GTIN 的护照无法拥有 GS1 Digital Link——其二维码面板会改为编码一个形如 passportcraft.com/passport/{id} 的回退 URL,并显示提示 “添加 GTIN 以获得符合 GS1 的 URL”。该回退对人管用,但对系统而言不承载产品标识,这也是发布必须有 GTIN 的原因之一。
常见问题
我必须把 GTIN 输入为 14 位吗?
不必。按您条码下印的样子输入即可:8、12、13 或 14 位。PassportCraft 会在 URL 中自动将它补齐至 14 位,无论输入的是哪种形式,解析器都会把扫描的码匹配回您的护照。
买家能用普通手机摄像头扫描这个码吗?
能。GS1 Digital Link 就是一个普通的 https URL,因此任何手机摄像头或二维码应用都能直接打开护照页面,无需专门的应用。GS1 结构是供懂得读取它的系统使用的额外信息。
如果有人扫描了一个未发布护照的码,会看到什么?
一条中性提示,而非错误。草稿会显示 “此护照尚未发布”,并为所有者提供登录选项;因方案降级而被停用的护照会显示 “此数字产品护照已临时停用”。两种情况下都不会暴露任何产品数据。