Supply Chain - Hey Chocolate

supplyChain

Retrieve the full supply chain graph for a product.

query {
  supplyChain(productId: "prod_abc123", maxTier: 3) {
    product { id name }
    totalTiers
    totalSuppliers
    tiers {
      level
      suppliers {
        id
        name
        country
        transportMethod
        certificationId
        co2Contribution
        percentage
        children {
          id
          name
          country
          co2Contribution
        }
      }
    }
    aggregatedImpact {
      co2Equivalent
      mkiScore
    }
  }
}

Arguments:

Argument	Type	Required	Description
`productId`	ID!	Yes	Product identifier
`maxTier`	Int	No	Maximum tier depth to return (default: all)

supplyChainHotspots

Identify the biggest impact contributors in the supply chain.

query {
  supplyChainHotspots(
    productId: "prod_abc123"
    metric: CO2_EQUIVALENT
    limit: 5
  ) {
    supplier {
      id
      name
      country
      tier
    }
    contribution
    percentage
    recommendation
  }
}

Arguments:

Argument	Type	Required	Description
`productId`	ID!	Yes	Product identifier
`metric`	ImpactMetric!	Yes	Metric to analyze
`limit`	Int	No	Number of hotspots (default: 10)

Response example:

{
  "data": {
    "supplyChainHotspots": [
      {
        "supplier": {
          "id": "sup_002",
          "name": "BioResin GmbH",
          "country": "DE",
          "tier": 2
        },
        "contribution": 3.1,
        "percentage": 25.0,
        "recommendation": "Consider local sourcing to reduce transport impact"
      }
    ]
  }
}