HomeGuidesAPI ReferenceChangelog
Log In
Guides

Step 1: Gather Savings Analysis Inputs

Gather the account, profile, tariff, and export-rate inputs needed to validate a Savings Analysis with hourly Account Cost Calculations.

Gather the account, profile, tariff, and export-rate inputs you need before recreating Savings Analysis calculations.

Use this step to identify the objects and IDs from an existing Savings Analysis before you run hourly Account Cost Calculations. The rest of the validation workflow depends on using the same account, profiles, tariffs, and date range that were used in the Savings Analysis.

How validation works

A Savings Analysis compares a pre-solar scenario and a post-solar scenario. To validate the calculation, you recreate those scenarios with Account Cost Calculation requests and inspect the hourly results.

The validation calls use the same load curve over the same time range, but apply different tariffs and profile inputs to represent the pre-solar and post-solar cases. For NEM3 tariffs, you can also retrieve hourly export rates and compare them to export credit behavior when net consumption is negative.

Input gathering workflow

  1. Identify the Savings Analysis you want to validate.
  2. Retrieve the account used in the Savings Analysis.
  3. Identify the pre-solar consumption profile.
  4. Identify the solar production profile used in the post-solar scenario.
  5. Identify the pre-solar and post-solar masterTariffId values.
  6. If the post-solar tariff uses NEM3 export rates, identify the export-rate property key.
  7. Confirm the date range you want to inspect with hourly calculations.

Required inputs

InputPurpose
accountId or providerAccountIdIdentifies the account used in the Savings Analysis.
Pre-solar consumption profileRecreates baseline usage.
Solar production profileRecreates post-solar net load.
Pre-solar masterTariffIdCalculates baseline utility cost.
Post-solar masterTariffIdCalculates post-solar utility cost.
Date rangeLimits the hourly validation period.
Export-rate property keyRetrieves NEM3 hourly export rates when applicable.

Example identifiers used in this workflow

The validation examples in this workflow use an account with a providerAccountId (pid) of example-1.

ObjectExample value
Account providerAccountIdexample-1
Pre-solar masterTariffId522
Post-solar masterTariffId3424821
Solar profile ID448ea77c-dcbf-4405-bb5a-568197cf8687
Export-rate property keyavoidedCostCalculatorHourlyExportRate2023PGECZ3B

Where to find the inputs

Use the Savings Analysis response to identify the inputs used in each scenario. The scenarios[] array includes the account-level and scenario-level inputs, including masterTariffId, profile IDs, rate inflation, solar degradation, territory, and other modeling parameters.

For example, the after scenario can include both the baseline consumption profile and the solar production profile. The solar profile is applied with operator: "-" to subtract solar production from load and create post-solar net load.

Optional: Set up a validation example from scratch

If you do not already have a Savings Analysis to inspect, follow Optional: Set Up a Validation Example from Scratch before continuing through the validation workflow. The setup requires an account, a consumption profile, a solar production profile, and a Savings Analysis request that uses those profiles.

The original validation example uses example-1 as the account identifier. You can use the same identifier in a test environment or replace it with your own stable providerAccountId.

Next step

After you gather these inputs, retrieve hourly pre-solar cost for the baseline scenario.