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 ESG & CSRD module aggregates transaction-level sustainability data into reporting-ready datasets that align with the Corporate Sustainability Reporting Directive (CSRD) and Environmental, Social & Governance (ESG) frameworks.

​
How it works

Every order and transaction processed through Hey Chocolate automatically contributes to your aggregated sustainability metrics. The API provides endpoints to pull reporting data at any time — no manual data collection required.

​
Generating a report

query {
  csrdReport(input: {
    period: { from: "2025-01-01", to: "2025-12-31" }
    scope: [SCOPE_1, SCOPE_2, SCOPE_3]
    format: ESRS
  }) {
    period { from to }
    totalTransactions
    emissions {
      scope1 { total unit breakdown { category value } }
      scope2 { total unit breakdown { category value } }
      scope3 { total unit breakdown { category value } }
    }
    products {
      totalTracked
      averageCo2
      bestPerformer { id name co2Equivalent }
      worstPerformer { id name co2Equivalent }
    }
    supplyChain {
      totalSuppliers
      certifiedPercentage
      averageTierDepth
    }
    trends {
      period
      co2Equivalent
      transactionCount
    }
  }
}

​
Scope breakdown

ScopeDescriptionHey Chocolate coverage
Scope 1Direct emissionsOperational data from your organization
Scope 2Indirect (energy)Energy consumption data
Scope 3Value chainAutomatically calculated from all product and order data

​
ESRS alignment

The report output aligns with European Sustainability Reporting Standards (ESRS):
ESRS TopicHey Chocolate data
E1 - Climate changeCO2 equivalents, emission trends, reduction targets
E2 - PollutionMaterial toxicity, chemical safety profiles
E3 - Water & marineWater footprint per product and aggregate
E5 - Circular economyRecycled content, end-of-life scenarios, circularity scores
S2 - Workers in value chainSupply chain certification data

​
Audit trail

All calculations feeding into CSRD reports are logged in an immutable audit trail: 
query {
  reportAuditTrail(reportId: "report_2025") {
    entries {
      timestamp
      calculationId
      productId
      inputHash
      resultHash
      methodology
    }
    totalEntries
    integrityChecksum
  }
}
This is essential to prevent greenwashing claims and withstand regulatory scrutiny.

​
Export formats

FormatDescription
ESRSESRS-aligned JSON structure
GRIGlobal Reporting Initiative format
CDPCarbon Disclosure Project format
CSVRaw data export for custom analysis
PDFFormatted report document

​
Scheduling

Set up automated periodic reports: 
mutation {
  scheduleReport(input: {
    frequency: QUARTERLY
    scope: [SCOPE_1, SCOPE_2, SCOPE_3]
    format: ESRS
    webhookUrl: "https://your-app.com/webhooks/report"
    recipients: ["sustainability@company.com"]
  }) {
    scheduleId
    nextRunAt
  }
}