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.

​
SupplyChain type

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

FieldTypeDescription
productIdID!Associated product
tiers[SupplyChainTier!]!Tiered supplier list
totalTiersInt!Depth of supply chain
totalSuppliersInt!Total number of suppliers
aggregatedImpactImpactScore!Combined impact of entire chain

​
Supplier

FieldTypeDescription
idID!Unique supplier identifier
nameString!Supplier name
countryString!ISO country code
tierInt!Tier level (1 = direct supplier)
transportMethodTransportMethodGoods transport method
certificationIdStringEnvironmental certification
co2ContributionFloat!CO2 contribution in kg CO2e
percentageFloat!Percentage of total product impact
children[Supplier!]!Sub-suppliers (next tier)

​
Example query

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