JSON-LD Format

TrackVision DPPs are W3C Verifiable Credentials encoded in JSON-LD. This page describes the complete structure of a DPP document.

Full Example

{
  "@context": [
    "https://www.w3.org/ns/credentials/v2",
    "https://ref.gs1.org/voc/",
    "https://untp.unece.org/contexts/v1"
  ],
  "type": ["VerifiableCredential", "gs1:DigitalProductPassport"],
  "id": "urn:uuid:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "issuer": "did:web:acme.trackvision.ai",
  "issuanceDate": "2024-01-15T10:00:00Z",
  "credentialSubject": {
    "id": "https://resolver.acme.trackvision.ai/01/09506000134352",
    "gs1:gtin": "09506000134352",
    "gs1:productDescription": "Organic Cotton T-Shirt",
    "composition": {
      "materials": [
        {
          "name": "Organic Cotton",
          "percentage": 95,
          "origin": "India",
          "certification": "GOTS"
        },
        {
          "name": "Elastane",
          "percentage": 5,
          "origin": "Germany"
        }
      ]
    },
    "supplyChain": {
      "tiers": [
        {
          "tier": 1,
          "role": "Garment Manufacturer",
          "name": "EcoWeave Factory",
          "country": "Bangladesh",
          "facilityId": "GLNID-001"
        },
        {
          "tier": 2,
          "role": "Fabric Mill",
          "name": "GreenFibre Co.",
          "country": "India"
        }
      ]
    },
    "environmental": {
      "carbonFootprintTotal": 2.4,
      "carbonFootprintUnit": "kgCO2e",
      "waterConsumption": 1800,
      "waterConsumptionUnit": "litres",
      "renewableEnergyPercent": 72
    },
    "identifiers": {
      "gtin": "09506000134352",
      "sku": "TSHIRT-001",
      "batchNumber": "BATCH-2024-01"
    }
  },
  "proof": {
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "created": "2024-01-15T10:00:00Z",
    "verificationMethod": "did:web:acme.trackvision.ai#key-1",
    "proofPurpose": "assertionMethod",
    "proofValue": "z5h5KzDHcLXwDLNHqRv8..."
  }
}

---

Section Reference

@context

Declares the JSON-LD vocabularies used:

• https://www.w3.org/ns/credentials/v2 — W3C Verifiable Credentials v2 terms
• https://ref.gs1.org/voc/ — GS1 vocabulary (product identifiers, DPP types)
• https://untp.unece.org/contexts/v1 — UNTP Digital Product Passport data model

type

Always ["VerifiableCredential", "gs1:DigitalProductPassport"]. The gs1:DigitalProductPassport type identifies this as a GS1-conformant DPP.

id

A urn:uuid: URI using the product's internal UUID. This uniquely identifies the DPP document itself.

issuer

The DID (Decentralized Identifier) of the brand that issued the DPP. TrackVision uses did:web DIDs so the public key can be resolved via HTTPS. See DID Web.

issuanceDate

ISO 8601 UTC timestamp of when the DPP was signed and issued.

credentialSubject

The main DPP data. The id field is the GS1 Digital Link resolver URL for the product (using the GTIN). The remaining fields are the 15 DPP categories.

Key	Category	Description
composition	Composition	Materials and fibres
supplyChain	Supply Chain	Tier-by-tier supply chain
transport	Transport	Logistics and shipping legs
documentation	Documentation	Regulatory documents
environmental	Environmental	Carbon, water, energy
social	Social	Labour conditions
animalWelfare	Animal Welfare	Animal welfare certs
circularity	Circularity	Recyclability, end-of-life
health	Health	Substances of concern
brandInfo	Brand Info	CSR commitments
identifiers	Identifiers	GS1 and other IDs
commercial	Commercial	Manufacturing origin
technicalPerformance	Technical Performance	Durability, test results
costScale	Cost Scale	Volume and cost band
afterSales	After Sales	Repair events, warranty

proof

The Ed25519 signature that allows anyone to verify the DPP was issued by the stated issuer and has not been tampered with. See Verifiable Credentials.