> ## 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.

# SupplyChain

> The SupplyChain type models a product's supplier hierarchy from Tier 1 to Tier N.

## SupplyChain type

```graphql theme={null}
type SupplyChain {
  productId: ID!
  product: Product!
  tiers: [SupplyChainTier!]!
  totalTiers: Int!
  totalSuppliers: Int!
  aggregatedImpact: ImpactScore!
}

type SupplyChainTier {
  level: Int!
  suppliers: [Supplier!]!
}

type Supplier {
  id: ID!
  name: String!
  country: String!
  tier: Int!
  transportMethod: TransportMethod
  certificationId: String
  co2Contribution: Float!
  percentage: Float!
  children: [Supplier!]!
}

type SupplyChainHotspot {
  supplier: Supplier!
  contribution: Float!
  percentage: Float!
  recommendation: String
}
```

## Fields

### SupplyChain

| Field              | Type                 | Description                     |
| ------------------ | -------------------- | ------------------------------- |
| `productId`        | ID!                  | Associated product              |
| `tiers`            | \[SupplyChainTier!]! | Tiered supplier list            |
| `totalTiers`       | Int!                 | Depth of supply chain           |
| `totalSuppliers`   | Int!                 | Total number of suppliers       |
| `aggregatedImpact` | ImpactScore!         | Combined impact of entire chain |

### Supplier

| Field             | Type            | Description                        |
| ----------------- | --------------- | ---------------------------------- |
| `id`              | ID!             | Unique supplier identifier         |
| `name`            | String!         | Supplier name                      |
| `country`         | String!         | ISO country code                   |
| `tier`            | Int!            | Tier level (1 = direct supplier)   |
| `transportMethod` | TransportMethod | Goods transport method             |
| `certificationId` | String          | Environmental certification        |
| `co2Contribution` | Float!          | CO2 contribution in kg CO2e        |
| `percentage`      | Float!          | Percentage of total product impact |
| `children`        | \[Supplier!]!   | Sub-suppliers (next tier)          |

## Example query

```graphql theme={null}
query {
  supplyChain(productId: "prod_abc123") {
    totalTiers
    totalSuppliers
    tiers {
      level
      suppliers {
        name
        country
        co2Contribution
        percentage
        transportMethod
        children {
          name
          country
          co2Contribution
        }
      }
    }
    aggregatedImpact {
      co2Equivalent
      mkiScore
    }
  }
}
```