GS1 数字链接 常用示例

使用指南 / 作者：

中文翻译（保留全部示例）

本节为说明性内容。

GTIN

https://id.gs1.org/01/09520123456788

是 GTIN 的规范化 Digital Link URI，等效于以下 GS1 元素串：9520123456788

(01)09520123456788

以下是使用自定义域名（例如 example.com 而非 id.gs1.org）的 GTIN 的其他有效非规范化 GS1 Digital Link URI：

https://id.gtin.xin/01/09520123456788
https://id.gtin.xin/some-extra/pathinfo/01/09520123456788

GTIN + CPV（消费品变体）

https://id.gs1.org/01/09520123456788/22/2A

是 GTIN 结合消费品变体（Consumer Product Variant）的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：9520123456788 '2A'

(01)09520123456788(22)2A

以下是 GTIN 结合消费品变体 9520123456788 '2A' 的其他有效非规范化 GS1 Digital Link URI：

https://id.gtin.xin/01/09520123456788/22/2A

GTIN + 批次/批号（Batch/Lot）

https://id.gs1.org/01/09520123456788/10/ABC123

是 GTIN 结合批次/批号的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：9520123456788 'ABC123'

(01)09520123456788(10)ABC123

以下是 GTIN 结合批次/批号 9520123456788 'ABC123' 的其他有效非规范化 GS1 Digital Link URI：

https://id.gtin.xin/01/09520123456788/10/ABC123

GTIN + 序列号（Serial Number）

https://id.gs1.org/01/09520123456788/21/12345

是 GTIN 结合序列号的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：9520123456788 '12345'

(01)09520123456788(21)12345

以下是 GTIN 结合序列号 9520123456788 '12345' 的其他有效 GS1 Digital Link URI：

https://id.gtin.xin/01/09520123456788/21/12345

GTIN + 批次/批号 + 序列号 + 有效期

https://id.gs1.org/01/09520123456788/10/ABC1/21/12345?17=180426

是 GTIN 结合批次/批号和序列号、且有效期为 2018 年 4 月 26 日的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：9520123456788 'ABC1' '12345'

(01)09520123456788(17)180426(10)ABC1(21)12345

以下也是 GTIN 结合批次/批号和序列号、且有效期为 2018 年 4 月 26 日的有效非规范化 GS1 Digital Link URI：9520123456788 'ABC1' '12345'

https://example.com/01/09520123456788/10/ABC1/21/12345?17=180426

GTIN + 净重（Net Weight）

https://id.gs1.org/01/09520123456788?3103=000195

是 GTIN 结合净重 0.195 kg 的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：9520123456788

(01)09520123456788(3103)000195

以下是 GTIN 结合净重 0.195 kg 的其他有效非规范化 GS1 Digital Link URI：9520123456788

https://example.com/01/09520123456788?3103=000195

GTIN + 净重 + 应付金额 + 有效期

https://example.com/01/09520123456788?3103=000195&3922=0299&17=201225

该 GS1 Digital Link URI 包含给定 GTIN 的三个数据属性，它们在查询串中可以任意顺序排列。等效的 GS1 元素串为：

(01)09520123456788(3103)000195(3922)0299(17)201225

以下 GS1 Digital Link URI 也是等效的，但只有最后一个是规范化的，因为数据属性已按 GS1 AI 的词典序排列：

https://id.gs1.org/01/09520123456788?3103=000195&3922=0299&17=201225
https://id.gs1.org/01/09520123456788?17=201225&3103=000195&3922=0299

SSCC（系列货运包装箱代码）

https://id.gs1.org/00/195201234567891232

是 SSCC 的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：195201234567891232

(00)195201234567891232

以下是 SSCC 的其他有效非规范化 GS1 Digital Link URI：195201234567891232

https://example.com/00/195201234567891232

SSCC + 内含物品 + 数量 + 批次/批号

https://id.gs1.org/00/195201234567891232?02=09520123456788&37=25&10=ABC123

是 SSCC 的规范化 GS1 Digital Link URI，表示该 SSCC 包含 25 个（AI 37）内含物品（AI 02，GTIN），且具有批次/批号标识符（AI 10），等效于以下 GS1 元素串：195201234567891232 09520123456788 'ABC123'

(00)195201234567891232(02)09520123456788(37)25(10)ABC123

以下是该 SSCC（含 25 个内含物品及批次）的其他有效非规范化 GS1 Digital Link URI：195201234567891232 09520123456788 'ABC123'

https://example.com/00/195201234567891232?02=09520123456788&37=25&10=ABC123

物理位置：GLN 或 GLN + GLN 扩展

https://id.gs1.org/414/9520123456788

是 GLN 的规范化 GS1 Digital Link URI，等效于以下 GS1 元素串：9520123456788

(414)9520123456788

https://id.gs1.org/414/9520123456788/254/32a%2Fb

是 GLN 结合 GLN 扩展的规范化 GS1 Digital Link URI。注意：由于正斜杠字符 / 在 Web URI 中具有特殊含义，当它作为字面值而非 URI 路径分隔符使用时，必须替换为其百分号编码 %2F（详见字符集章节）。等效于：9520123456788 '32a/b'

(414)9520123456788(254)32a/b

以下也是 GLN 的有效但非规范化 GS1 Digital Link URI：9520123456788

https://example.com/414/9520123456788

以下是 GLN 结合 GLN 扩展的其他有效非规范化 GS1 Digital Link URI：9520123456788 '32a/b'

https://example.com/414/9520123456788/254/32a%2Fb

GIAI + GTIN（重点：语义差异）

https://example.com/8004/9520614141234567?01=09520123456788
https://example.com/01/09520123456788?8004=9520614141234567

这两个 GS1 Digital Link URI 表达了相同的 GS1 应用标识符组合，但它们并不等效。

  • 第一个示例中，GIAI 出现在 URI 路径信息中，该 GIAI 资产标识符的发行方是权威方；
  • 第二个示例中，GTIN 出现在 URI 路径信息中，GTIN 的被许可方（通常是品牌方或制造商）是该 GS1 Digital Link URI 的权威方。

虽然两者都标识了一个”具有 GIAI 且是 GTIN 实例”的物品，但将哪个标识符放在 URI 路径信息中，从语义角度来看会产生差异：

  • 第一个示例表达：“此物品是一个由该 GIAI 标识的资产——它同时也是/曾经是一个由该 GTIN 标识的产品。”
  • 第二个示例表达：“此物品是一个产品，同时它也携带此资产标识符。”

第二个示例不太可能由制造商或品牌方编码到数据载体中，除非某个产品实例是为特定已知客户/资产所有者而生产的。大多数批量生产的产品是按库存生产（make to stock），而非按订单/定制生产（make to order/bespoke）。

这是一个在单个 GS1 Digital Link URI 中存在两个 GS1 标识符、但只有一个能作为主键表达的示例。等效的 GS1 元素串为：9520614141234567 9520123456788

(01)09520123456788(8004)9520614141234567

虽然没有具体规则规定两个 GS1 标识符中哪个应放在路径中作为主键、哪个应放在查询串中作为数据属性，但顺序很可能由上下文决定。在本例中，GIAI 将由从分配 GTIN 的制造商处购得该物品的所有者分配。在此场景下，是所有者创建 GS1 Digital Link URI，因此极有可能是 GIAI 放在路径中——即所有者的主键——而非制造商的 GTIN。

多个 GS1 标识符的存在以及哪个作为主键的决定，会影响可从 URI 推断出的语义。更多内容参见 GS1 Digital Link Standard。

结构化总结

一、URI 结构规律总览

元素类型位置示例 AI说明
主键路径第一段01(GTIN), 00(SSCC), 414(GLN), 8004(GIAI)核心标识，决定权威方
键限定符路径后续段22(CPV), 10(批次), 21(序列号), 254(GLN扩展)与主键构成复合标识，有层级顺序
属性数据查询串 ? 后17(有效期), 3103(净重), 3922(金额), 02(内含), 37(数量)无内在层级，可任意排序

二、规范化判定要点

条件规范化非规范化
域名id.gs1.org任意自定义域名
协议HTTPSHTTP 或 HTTPS
查询串参数仅 GS1 AI，且按词典序排列可含其他参数，顺序任意
路径前缀直接以 AI 开头可含额外路径段（如 /some-extra/pathinfo/）

示例：?3103=000195&3922=0299&17=201225 非规范化（未排序）；?17=201225&3103=000195&3922=0299 规范化（按 AI 词典序：17 < 3103 < 3922）。

三、特殊编码规则

  • 正斜杠 / 作为字面值时必须百分号编码为 %2F，避免被误解析为路径分隔符。示例：GLN 扩展值 32a/b → URI 中写为 32a%2Fb。
  • GTIN-8/12/13 需补齐至 14 位（示例中均为 14 位 09520123456788）。

四、GIAI + GTIN 语义差异（核心考点）

路径主键查询串属性语义权威方典型场景
8004(GIAI)01(GTIN)“这是一个资产，同时也是某产品”资产所有者资产购入后由所有者编码
01(GTIN)8004(GIAI)“这是一个产品，同时携带资产标识”品牌方/制造商按订单定制生产

关键结论：同一组 AI 组合，选择哪个作为路径主键会改变 URI 的语义含义，不存在”唯一正确”的排列，由业务上下文和创建 URI 的权威方决定。

五、示例覆盖的 AI 速查表

AI含义位置
00SSCC主键
01GTIN主键 / 属性
02内含物品 GTIN属性
10批次/批号键限定符 / 属性
17有效期属性
21序列号键限定符
22消费品变体(CPV)键限定符
37数量属性
254GLN 扩展键限定符
3922应付金额属性
3103净重(kg, 3位小数)属性
414GLN(物理位置)主键
8004GIAI(全球资产标识符)主键 / 属性

相关文章