UNTP DPP Schema¶

The UN Trade Facilitation and Electronic Business Centre (UN/CEFACT) has developed the United Nations Transparency Protocol (UNTP) for Digital Product Passports.

Overview¶

The UNTP Digital Product Passport (DPP) is a standardized format for sharing product sustainability and circularity information across supply chains.

Schema Version¶

dppvalidator supports UNTP DPP Schema versions 0.6.0, 0.6.1 (default), and 0.7.0. Both wire shapes are first-class and coexist in the same release. See UNTP DPP versions for the full version-handling story; this page describes the schema itself.

The structure diagram below covers the v0.6.x shape — the wire format used by the engine when no $schema or @context URL pins a different version. The v0.7.0 shape is summarised at the end of this page; the canonical v0.7.0 reference is the upstream DPP schema at https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json.

Schema Structure¶

classDiagram
    direction TB

    class DigitalProductPassport {
        +URI id
        +String[] type
        +CredentialIssuer issuer
        +DateTime validFrom
        +DateTime validUntil
        +ProductPassport credentialSubject
    }

    class CredentialIssuer {
        +URI id
        +String name
    }

    class ProductPassport {
        +URI id
        +Product product
        +ConformityClaim[] conformityClaim
        +CircularityScorecard circularityScorecard
        +EmissionsScorecard emissionsScorecard
    }

    class Product {
        +URI id
        +String name
        +String description
        +String registeredId
        +String idScheme
    }

    DigitalProductPassport --> CredentialIssuer : issuer
    DigitalProductPassport --> ProductPassport : credentialSubject
    ProductPassport --> Product : product

Key Components¶

DigitalProductPassport¶

The root credential containing:

id — Unique identifier (URI)
type — Credential types
issuer — Who issued the passport
validFrom / validUntil — Validity period
credentialSubject — The actual passport data

CredentialSubject (ProductPassport)¶

Contains product-specific information:

product — Product details
conformityClaim — Compliance declarations
cirularityScorecard — Circularity metrics
emissionsScorecard — Carbon footprint data
traceabilityInformation — Supply chain data

Product¶

Core product information:

id — Product identifier
name — Product name
description — Product description
registeredId — Official registration ID
idScheme — ID scheme (GTIN, etc.)

JSON Schema¶

Bundled SHA-pinned copies live under src/dppvalidator/schemas/data/; the upstream production URLs are:

Version	Production URL
0.6.1	https://test.uncefact.org/vocabulary/untp/dpp/untp-dpp-schema-0.6.1.json
0.7.0	https://untp.unece.org/artefacts/schema/v0.7.0/dpp/DigitalProductPassport.json

v0.6.x example¶

JSON

{
  "@context": [
    "https://www.w3.org/ns/credentials/v2",
    "https://test.uncefact.org/vocabulary/untp/dpp/0.6.1/"
  ],
  "type": ["DigitalProductPassport", "VerifiableCredential"],
  "id": "https://example.com/dpp/battery-001",
  "issuer": {
    "id": "https://example.com/manufacturer",
    "name": "Battery Manufacturer Inc."
  },
  "validFrom": "2024-01-01T00:00:00Z",
  "validUntil": "2029-01-01T00:00:00Z",
  "credentialSubject": {
    "id": "https://example.com/product/battery-001",
    "type": ["ProductPassport"],
    "product": {
      "id": "https://example.com/product/battery-001",
      "name": "EV Battery Pack",
      "description": "High-capacity lithium-ion battery"
    }
  }
}

v0.7.0 example¶

The structural shift in v0.7.0: credentialSubject IS the Product directly, the ProductPassport envelope is gone, and the top-level name field is required. Full v0.7.0-required Product fields: id, name, idScheme, idGranularity, productCategory, producedAtFacility, countryOfProduction.