HomeGuidesAPI ReferenceChangelog
Log In
Guides

Step 3: Retrieve Hourly Post-Solar Cost

Run an hourly Account Cost Calculation for the post-solar scenario and identify net export intervals for validation.

Retrieve hourly post-solar cost so you can compare net-load costs against the pre-solar baseline.

Use this step to recreate the post-solar scenario with an Account Cost Calculation. The request subtracts the solar production profile from the electricity load and returns hourly cost line items for comparison against the pre-solar calculation.

Post-solar cost workflow

  1. Use the same account and date range from Step 2.
  2. Confirm the account or request uses the post-solar tariff.
  3. Add the solar production profile in propertyInputs.
  4. Set operator to - so solar production is subtracted from load.
  5. Set detailLevel to CHARGE_TYPE.
  6. Set groupBy to HOUR.
  7. Inspect hourly itemQuantity, rateAmount, and cost values.

Retrieve hourly post-solar cost

You can use a providerAccountId (pid) or system-generated account ID.

POST /rest/v1/accounts/pid/example-1/calculate/

Or use the system-generated account ID:

POST /rest/v1/accounts/{accountId}/calculate/

This request inspects one day in July 2023 and subtracts the solar production profile from the load:

{
  "fromDateTime": "2023-07-01",
  "toDateTime": "2023-07-02",
  "useIntelligentBaselining": "true",
  "includeDefaultProfile": "true",
  "autoBaseline": "true",
  "minimums": "false",
  "detailLevel": "CHARGE_TYPE",
  "groupBy": "HOUR",
  "fields": "EXT",
  "propertyInputs": [
    {
      "keyName": "profileId",
      "dataValue": "448ea77c-dcbf-4405-bb5a-568197cf8687",
      "operator": "-"
    }
  ]
}
FieldPurpose
propertyInputs[].keyNameIdentifies the solar production profile input.
propertyInputs[].dataValueUses the solar profile ID from the Savings Analysis.
propertyInputs[].operatorSubtracts solar production from electricity load when set to -.
detailLevelReturns line items grouped by charge type.
groupByReturns results by hour.

In this example, 448ea77c-dcbf-4405-bb5a-568197cf8687 is the solar profile ID used in the example Savings Analysis.

Review the response summary

The following response has been shortened to show the beginning of the post-solar calculation response:

{
  "status": "success",
  "count": 1,
  "type": "CalculatedCost",
  "requestId": "a4eb5019-b6ed-41ec-b90a-9bd8343ae4b2",
  "results": [
    {
      "calculatedCostId": "71e814bf-bb5a-41c8-9576-ab3f4e88fda2",
      "masterTariffId": 3424821,
      "tariffName": "Residential Time-Of-Use - Electric Home - NEM 3.0",
      "totalCost": 1.28000000,
      "fromDateTime": "2023-07-01T00:00:00-07:00",
      "toDateTime": "2023-07-02T00:00:00-07:00",
      "currency": "USD",
      "summary": {
        "SOLAR_PV": {
          "kWh": 46.12,
          "kW": 0.00,
          "systemSize": 8
        },
        "ELECTRICITY": {
          "kWh": 28.82,
          "kW": 3.75
        },
        "subTotalCost": 1.28,
        "taxCost": 0.00,
        "totalCost": 1.28,
        "adjustedTotalCost": 1.28,
        "kWh": -17.30,
        "kW": 1.62,
        "import": 12.42,
        "export": 29.73
      }
    }
  ]
}

In the summary, import and export show how much energy was imported from or exported to the grid over the calculation period. A negative total kWh indicates net export over the period.

Identify export intervals

To validate export credit behavior, inspect hourly CONSUMPTION_BASED line items where itemQuantity is negative. A negative itemQuantity indicates that the account exported energy back to the grid during that interval.

In this example, the first export occurs between 8 AM and 9 AM:

{
  "fromDateTime": "2023-07-01T08:00:00-07:00",
  "toDateTime": "2023-07-01T09:00:00-07:00",
  "quantityKey": "consumption",
  "rateAmount": 0.07187955,
  "itemQuantity": -1.46189600,
  "cost": -0.10508043,
  "chargeType": "CONSUMPTION_BASED"
}

For each export interval, save the hourly fromDateTime, toDateTime, rateAmount, itemQuantity, and cost. You will use those values when you compare against NEM3 export rates in Step 4.

Compare against the pre-solar calculation

Compare post-solar intervals against the pre-solar intervals from Step 2 using the same timestamp and charge type.

FieldHow to compare
fromDateTime / toDateTimeMatch the same hourly interval in both responses.
chargeTypeCompare the same charge bucket, such as CONSUMPTION_BASED.
itemQuantityShows how solar changed the net hourly quantity.
rateAmountShows the rate applied under the post-solar tariff.
costShows the hourly post-solar cost or credit.

Next step

After you identify export intervals, verify NEM3 export rates.