Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.heychocolate.com/llms.txt

Use this file to discover all available pages before exploring further.

The Supply Chain module provides a graph-based view of a product’s entire supply chain, from direct suppliers (Tier 1) down to raw material origins (Tier N). This enables full transparency and Scope 3 emissions tracking.

​
Querying a supply chain

query {
  supplyChain(productId: "prod_abc123") {
    product {
      id
      name
    }
    tiers {
      level
      suppliers {
        id
        name
        country
        certificationId
        transportMethod
        co2Contribution
        percentage
        children {
          id
          name
          country
          co2Contribution
        }
      }
    }
    totalTiers
    totalSuppliers
    aggregatedImpact {
      co2Equivalent
      mkiScore
    }
  }
}
Response: 
{
  "data": {
    "supplyChain": {
      "product": {
        "id": "prod_abc123",
        "name": "Bio-based Window Frame"
      },
      "tiers": [
        {
          "level": 1,
          "suppliers": [
            {
              "id": "sup_001",
              "name": "FrameWorks BV",
              "country": "NL",
              "certificationId": "ISO14001-2024",
              "transportMethod": "TRUCK",
              "co2Contribution": 4.2,
              "percentage": 34,
              "children": [
                {
                  "id": "sup_002",
                  "name": "BioResin GmbH",
                  "country": "DE",
                  "co2Contribution": 3.1
                }
              ]
            }
          ]
        }
      ],
      "totalTiers": 3,
      "totalSuppliers": 12,
      "aggregatedImpact": {
        "co2Equivalent": 12.4,
        "mkiScore": 0.87
      }
    }
  }
}

​
Supply chain graph

The supply chain is modeled as a directed graph. Each node represents a supplier with the following properties:
FieldTypeDescription
idIDUnique supplier identifier
nameStringSupplier name
countryStringISO country code
tierIntTier level (1 = direct supplier)
transportMethodEnumHow goods are transported to the next tier
certificationIdStringEnvironmental certification reference
co2ContributionFloatThis supplier’s CO2 contribution in kg CO2e
percentageFloatPercentage of total product impact
children[Supplier]Nested sub-suppliers

​
Filtering by tier

query {
  supplyChain(productId: "prod_abc123", maxTier: 2) {
    tiers {
      level
      suppliers { name country co2Contribution }
    }
  }
}

​
Hotspot analysis

Identify the biggest contributors to a product’s environmental impact across the chain: 
query {
  supplyChainHotspots(
    productId: "prod_abc123"
    metric: CO2_EQUIVALENT
    limit: 5
  ) {
    supplier { id name country tier }
    contribution
    percentage
    recommendation
  }
}

​
Use cases

  • Transparency pages: Interactive supply chain visualizations on product pages
  • Scope 3 reporting: Automated upstream and downstream emissions tracking
  • Supplier evaluation: Identify high-impact suppliers for improvement programs
  • DPP compliance: Supply chain data is a required component of Digital Product Passports