Sage Earth Carbon Accounting

Sage Earth helps you measure, manage, and reduce your company's carbon emissions. It simplifies sustainability and enables you to track progress toward net-zero carbon emission goals.

Sage Earth has developed a powerful API that enables businesses to calculate an industry estimate of their carbon footprint in seconds.

By understanding the factors that contribute to the carbon footprint, you can begin to make conscious decisions regarding your actions and purchases.Taking simple steps can lead to significant changes in the future.

Sage Earth only requires inputs of business revenue and industry sector to generate emissions for all scopes of the greenhouse gas (GHG) protocol (Scopes 1, 2 and 3, including all 15 emissions categories). Using the carbon emissions dashboard, your company can learn what ‘hot-spot’ areas require greater focus and can access Sage’s Net Zero Hub to learn how to take action in reducing emissions. The dashboard integrates with external APIs that fetch industry benchmarks and allow you to track their emissions data.

Install and configure Sage Earth Carbon Accounting

Before you can start using Carbon Accounting and the Industry Average Footprints dashboard, you need to install the software patch and take some steps to configure Sage Intacct to work with Carbon Accounting.

Step 1. Add custom fields to be used in each of your entities

Step 2. Download and install the Carbon Accounting patch

  1. Download the Carbon Accounting patch file to your local hard drive.

  2. Go to Platform ServicesAll > Platform tools and select Add (circle) next to Applications.

  3. Select Install from XML from the options menu at the top of the page.

  4. Select the patch file (Carbon_Accounting_1_5.xml) from the local directory where you downloaded it, and then select Install.

    If this application has been previously installed, it will be updated to the newest version.
  5. After the confirmation page appears, select Done.

Step 3. Add the new module to the user profiles that will access Carbon Accounting

Step 4. Configure the Web Services user and allow the Content security policy

  1. Go to Company > SetupConfigurationCompany

  2. Select Edit, located at the top right of the Company information page.

  3. Navigate to the Security tab, and select Add in the Web Services authorisations section.

    1. In the Sender ID field, enter ajax

    2. In the Description field, enter ajax

    3. In the Status field, select Active.

  4. Select Save.

Step 5. Configure your entities to use Carbon Accounting

  1. Go to CompanySetup > ConfigurationEntities.

  2. Find the entity you want to set up and select Edit.

  3. In the Industry Sector field, select the Industry.

  4. In the Last Year Revenue field, enter the last year's revenue for this entity.

  5. Repeat for any other entities for which you want to configure Carbon Accounting.

Access the Industry Average Footprints dashboard

Once you've installed the Sage Earth, the Industry Average Footprints dashboard will be available to all users with the appropriate permissions, determined by their defined roles.

To access the dashboard, go to Carbon Accounting > AllComponents > Industry Average Footprints.

The dashboard displays the average Carbon Footprint for the specified industry sector associated with the entity. Additionally, it considers the revenue provided to calculate the carbon values.

About the Industry Average Footprints dashboard

Additional tabs are available as knowledge base (KB) resources that outline factors influencing the calculation of actuals for each Carbon Footprint scope. These resources are intended to illustrate and assist users in understanding the various contributors to carbon emissions. However, it is important to note that not all measures are considered by the Industry Averages Footprint API.

Carbon accounting dashboard showing the page layout

Dashboard Components

Doughnut Chart: Visualises the proportion of emissions across Scope 1, Scope 2, and Scope 3.

  • Data Source: API response containing benchmark data.

  • Customisation

    • Labels: Scope 1, Scope 2, Scope 3.

    • Colours: Green shades for Scope 1 and Scope 2, orange for Scope 3.

    • Tooltip: Displays emissions in tonnes (tCO₂e).

Bar Chart: Provides a detailed breakdown of emissions by scope and subcategories.

  • Data Source: API response with Scope 3 details.

  • Customisation

    • Labels: Scope 1, Scope 2, and Scope 3 subcategories.

    • Colours: A palette of distinct colours for each category.

    • Tooltip: Displays emissions in tonnes (tCO₂e).

KPI Cards: Displays total emissions for Scope 1, Scope 2, and Scope 3.

  • Data Source: Aggregated values from API response.

  • Customisation

    • Icons: Fire for Scope 1, Bolt for Scope 2, People for Scope 3.

    • Values: Converted from kilograms to tonnes.

Scope 1

View of the scope 1 dashboard

Scope 2

Scope 3

Technical details: Data input and API integration

Data input page

Entity information

  • Fields

    • Entity Name

    • Industry Sector

    • Industry Sector Code

    • Last Year Revenue

  • Purpose: Displays entity-specific data fetched from the API

API Benchmark Response

  • Field: Displays raw API response for debugging and transparency

API integration

Sage Earth API

  • Endpoint: Configurable via environment variables.

  • Request Payload:

    • Country Code

    • Industry Sector Code

    • Currency Code

    • Revenue

  • Response: Industry benchmark data for GHG emissions.

Supabase integration

  • Purpose: Tracks user interactions and data submissions

  • Payload

    • Entity, user, email, company details

    • Emissions data

Visualisation library

  • Library: Chart.js

  • Charts

    • Doughnut Chart

    • Bar Chart

Technical details: Front end, back end, and data mapping

Front end

HTML structure

  • File: carbonv4.html

  • Components

    • Charts (<canvas> elements)

    • KPI Cards

    • CTAs

    • Popup for entity selection

Styling

  • CSS Framework: Acuity24 Design Language.

  • External Libraries

    • Font Awesome for icons

JavaScript

  • File: Inline script in carbonv4.html

  • Global variables

    • doughnutChart, barChart: Chart instances

    • API_ENDPOINT: URL for Sage Earth API

  • Functions

    • readEntity(): Fetches entity data

    • makeApiCall(): Sends request to Sage Earth API

    • generateDashboards(): Creates charts based on API response

Back end

Netlify function

  • File: sageearth-industry-averages.js

  • Purpose: Handles API requests and sends tracking data to Supabase

  • Environment variables

    • SAGE_EARTH_ENDPOINT, SAGE_EARTH_CLIENT_ID, SAGE_EARTH_CLIENT_KEY

    • SUPABASE_URL, SUPABASE_KEY

Data mapping

Scope labels

  • Fixed mapping for Scope 3 subcategories

  • Example:

    • "3.1": Purchased Goods

    • "3.2": Capital Goods

Country to ISO3 mapping

  • Predefined dictionary for converting country names to ISO3 codes

Deployment

Hosting

  • Platform: Netlify

  • Files:

    • carbonv4.html: Main dashboard

    • carbonv4_data.html: Data input page

    • sageearth-industry-averages.js: Back end function

Environment variables

  • Required:

    • Sage Earth API credentials

    • Supabase credentials