Skip to content
This repository was archived by the owner on Apr 24, 2026. It is now read-only.
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 4 additions & 9 deletions website/docs/specification/IdentityResolver.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import Disclaimer from '../\_disclaimer.mdx';

## Overview

Identifiers of **businesses** (eg tax registration numbers), of **locations** (eg google pins or cadastral/lot numbers), and of **products** (eg GS1 GTINs or other schemes) are ubiquitous throughout supply chains and underpin the integrity of the system. The diagram shows an example of a global and a local scheme for three types of entity. These are just a few of thousands of existing identifier schemes. This identity resolver specification builds upon these identifier schemes so that existing investments and high integrity registers can be leveraged. This specification also supports the use of self-issued decentralised identifiers.
Identifiers of **businesses** (eg tax registration numbers), of **locations** (eg google pins or cadastral/lot numbers), and of **products** (eg from product registers or self-issued) are ubiquitous throughout supply chains and underpin the integrity of the system. The diagram shows an example of identifers schemes for three types of entity. These are just a few of thousands of existing identifier schemes. This identity resolver specification builds upon these identifier schemes so that existing investments and high integrity registers can be leveraged. This specification also supports the use of self-issued decentralised identifiers.

![Identifier examples](IdentityResolverIdentifiers.png)

Expand Down Expand Up @@ -107,9 +107,6 @@ In patterns below,
Use your IANA registered [URN namespace](https://www.iana.org/assignments/urn-namespaces/urn-namespaces.xhtml).

* pattern `urn:{ns}:{identifier-scheme}:{identifier-value}`
* examples:
* `urn:epc:id:sgtin:1234567.089123.2`
* `urn:lei:7LTWFZYICNSX8D621K86`

#### For all other schemes

Expand Down Expand Up @@ -193,8 +190,6 @@ For example:
- **DI `2B`** identifies gas cylinders per U.S. D.O.T. standards.
- **AI `01`** represents a **Global Trade Item Number (GTIN)**.

DIs are managed by **ANSI**, while AIs fall under **GS1**.

### Mapping to consistent URIs

A key challenge is to ensure that all these different data carrier representations are mapped to a consistent globally unique identifier when building value chain transparency graphs.
Expand Down Expand Up @@ -285,7 +280,7 @@ A typical response the the sample query `https://resolver.sample-register.exampl
},
{
"anchor": "https://resolver.sample-register.example/products/ABCD9876",
"gs1:pip": [
"sample:pip": [
{
"href": "https://sample-company.example/productInformation/ABCD9876",
"type": "text/html",
Expand Down Expand Up @@ -405,7 +400,7 @@ Even though there are a dozen DPP links maintained by the IDR service, only one

There are some cases where an identifier scheme owner manages identifiers at a coarse granularity by issuing globally unique prefixes but allows the subject to manage more fine grained identifiers themselves. For example

* GS1 maintains GTIN product identifiers in a single global register but management of SGTIN (serialised items) is left to the owner of the GTIN.
* A product register maintains product identifiers in a single global register but management of serialised items is left to the owner of the GTIN.
* IATA issues 3 character carrier identifiers but allows each carrier to add the 7 digit suffix for each cargo consignment to make a globally unique 11 digit consignment number.
* Australian government manages 8 alpha-numeric character farm identifications codes such as `QDBH0132` and allows each farmer to add a unique suffix to identify each unique livestock animal born on the farm.
* and many more examples exist.
Expand All @@ -424,7 +419,7 @@ May return a link to a secondary resolver that maintains data at serialised item
"linkset": [
{
"href": "https://resolver.sample-company.example/products/ABCD9876/items/1234",
"rel": ["untp:idr", "gs1:handledBy"],
"rel": ["untp:idr", "ns1:handledBy"],
"title": "Secondary Identity Resolver",
"hreflang":["en"],
"type": "application/linkset+json"
Expand Down
Binary file modified website/docs/specification/IdentityResolverIdentifiers.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified website/docs/specification/UNTP-Diagrams-Specification.pptx
Binary file not shown.