Overview

The Recommendations Report provides a set of practical recommendations designed to help end-users reduce their energy consumption through simple and realistic actions.

The report answers questions such as:

“What actions can this end-user take to reduce energy consumption based on their measured energy behavior?”

Recommendations are derived from the installation’s energy profile and insights, and may relate to a disaggregation category (e.g. laundry, refrigeration)

Recommendations are grouped into the following action types:

• BEHAVIOUR
• SETTINGS
• SMALL_INVESTMENT
• INVESTMENT
• MAINTENANCE

These recommendations are intended to encourage actionable changes that can improve energy efficiency without requiring complex analysis by the end-user.

Key Characteristics

• Action-oriented guidance
  The report provides concrete recommendations that the end-user can act upon.

• Based on detected energy behavior
  Recommendations are generated based on the installation’s measured consumption patterns and insights.

• Category-specific
  Recommendations may refer to an energy category.

• Estimated savings
  Each recommendation includes an estimated energy saving potential.

• NET2GRID EnergyAI® estimation
  Recommendations are derived from insights and disaggregation results.

Understanding the Data

Each recommendation represents an opportunity for improved energy behavior or equipment efficiency.

A recommendation contains:

• a unique recommendation identifier
• the related disaggregation category
• the related appliance
• the excess consumption percentage compared to the benchmark
• the action type
• the estimated monthly or weekly energy savings

Recommendations may be generated for areas such as:

• Always on
• Laundry
• Cooking
• Lighting
• Refrigeration
• Space heating
• Space cooling
• Water heating
• Pool pump

Report Generation Logic

Monthly Recommendations

• The monthly report is generated once per month
• It covers the previous calendar month
• The report is generated only when saving opportunities are identified for at least one disaggregation category.

Weekly Recommendations

• The weekly report is generated once per week
• It covers the previous week (Monday–Sunday)
• The report is generated only when saving opportunities are identified for at least one disaggregation category.
• By default, weekly reports are disabled.

Requirements

The Recommendations Report is generated only if measurement data is available for the reporting period.

In addition, recommendations depend on the availability of the corresponding Insights Report for the same installation and period.

Installation Profile Impact

When profile information is incomplete, the report may still be generated using a more general demographics-based approach.

For more personalized recommendations, the following minimum profile information should be provided:

• Ownership
• Property Type
• Property Age

If this information is missing, recommendations may still be produced, but with lower personalization.

Technical Specifications

Storage Location

Monthly Reports

The monthly recommendations reports are generated under the S3 export bucket using the following format:

s3://{exportBucket}/{labelpartner}/reports/{installationIdentifier}/{serviceType}/recommendations/{filename}

Path Parameters

• exportBucket: the name of the AWS S3 bucket that contains the reports
• labelpartner: the identifier of the label partner
• installationIdentifier: the external installation identifier provided during end-user provisioning
• serviceType: SM

Filename Format

{internalInstallationIdentifier}_{reportMonth}_recommendations.json

Where:

• internalInstallationIdentifier: the internal installation identifier used in NET2GRID EnergyAI®
• reportMonth: the reporting month in YYYYMM format

Weekly Reports

The weekly recommendations reports are generated under the following format:

s3://{exportBucket}/{labelpartner}/reports/{installationIdentifier}/{serviceType}/weekly-recommendations/{filename}

Weekly Filename Format

{internalInstallationIdentifier}_{reportWeek}_weekly_recommendations.json

Where:

• reportWeek: the reporting week in xxxxWww ISO-8601 format

Report Format

The report is provided in JSON format.

Main Fields

Recommendation Object

Each recommendation object contains:

Recommendation ID Descriptions

The following table defines the mapping between recommendation IDs and their descriptions.

Error Codes

Notes

• Monthly Applicable indicates whether the error code may appear in monthly recommendations reports.
• Weekly Applicable indicates whether the error code may appear in weekly recommendations reports.
• Recommendations Provided indicates whether the report still contains recommendation results.

Example Report Files

Monthly Report File

A monthly recommendations report may be generated in a location such as:

s3://s3-export-ABC/labelpartnerB/reports/installationX/SM/recommendations/abc123456_202304_recommendations.json

Example data:

{
   "error": "null",
   "timestamp": 1737072233081,
   "version": "3.5",
   "recommendations": [
      {
         "id": "T50",
         "disaggregationCategory": "laundry",
         "appliance": "dishWasher",
         "deltaPerc": 0.25,
         "actionType": "SMALL_INVESTMENT",
         "savingCostsKWh": 19.25
      },
      {
         "id": "T10",
         "disaggregationCategory": "alwaysOn",
         "appliance": "alwaysOn",
         "deltaPerc": 0.16,
         "actionType": "BEHAVIOUR",
         "savingCostsKWh": 10.05
      }
   ],
   "serviceType": "SM"
}

Weekly Report File

A weekly recommendations report may be generated in a location such as:

s3://s3-export-ABC/labelpartnerB/reports/installationX/SM/weekly-recommendations/abc123456_2023W05_weekly_recommendations.json

Example data:

{
   "error": "null",
   "timestamp": 1737072233081,
   "version": "3.5",
   "recommendations": [
      {
         "id": "T50",
         "disaggregationCategory": "laundry",
         "appliance": "dishWasher",
         "deltaPerc": 0.25,
         "actionType": "SMALL_INVESTMENT",
         "savingCostsKWh": 19.25
      },
      {
         "id": "T10",
         "disaggregationCategory": "alwaysOn",
         "appliance": "alwaysOn",
         "deltaPerc": 0.16,
         "actionType": "BEHAVIOUR",
         "savingCostsKWh": 10.05
      }
   ],
   "serviceType": "SM"
}

Notification Mechanism

Monthly Reports

A message is published when a monthly recommendations report is generated.

Queue: recommendations_{labelpartner}

Message Format

{
  "bucket": "s3-export-customerA",
  "filename": "/labelpartnerB/reports/installationX/SM/recommendations/abc123456_202401_recommendations.json"
}

Routing key:

{installationIdentifier}.recommendations

Weekly Reports

A message is published when a weekly recommendations report is generated.

Queue: weekly_recommendations_{labelpartner}

Message Format

{
  "bucket": "s3-export-customerA",
  "filename": "/labelpartnerB/reports/installationX/SM/weekly-recommendations/abc123456_2024W32_weekly_recommendations.json"
}

Routing key:

{installationIdentifier}.weekly_recommendations