- Rates Request
- Rates Response
- Bill Request
- Bill Response
- BillSavings Request
-
- CustomerInfo{...}
- Meters[{...}]
-
- Name
- CurrentRate{...}
- ProposedRate{...}
- AnnualUtilityBillEscalation_Percent
- EnergyProfiles[{...}]
-
- {"Type": "Consumption", ...}
- {"Type": "Production"}
- {"Type": "Pv", ...}
-
- Name
- Scenario
- EquipmentLife_Years
- SystemDegradationPerYear_Percent
- ProductionEnergyProfileName
- PvSimulation{...}
- CashPayment{...}
- LoanPayment{...}
- LeasePayment{...}
- PpaPayment{...}
- MaintenanceCosts{...}
- BillPeriods[{...}]
- BillPeriodEnd
- EstimationOptions{...}
- BillSavings Response
EnergyProfiles{Pv}
Meters.EnergyProfiles{Pv}
You can provide your own solar production profile by using an energy profile of Type “Production”, or BillSavings can simulate solar production for you. An energy profile of Type “Pv” contains all of the details required for simulating solar production.
{
"Type": "Pv",
"Name": "Solar System",
"Scenario": "Proposed",
"EquipmentLife_Years": 20.0,
"SystemDegradationPerYear_Percent": 0.5,
"ProductionEnergyProfileName": "System1",
"PvSimulation": {
"EnergySite": {
"Location": {
"Latitude": 33.400264739990234,
"Longitude": -111.84458923339844
},
"PvSystems": [{
"Albedo_Percent": 17.0,
"GeneralDerate_Percent": 90.0,
"Inverters": [{
"Count": 1,
"MaxPowerOutputAC_kW": 4.5,
"EfficiencyRating_Percent": 95.0
}],
"PvArrays": [{
"PvModules": [{
"Count": 15,
"NameplateDCRating_kW": 0.3,
"PtcRating_kW": 0.27,
}],
"ArrayConfiguration": {
"Azimuth_Degrees": 175.0,
"Tilt_Degrees": 4.0,
},
"MonthlyShadings": [{
"MonthNumber": 1,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 2,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 3,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 4,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 5,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 6,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 7,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 8,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 9,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 10,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 11,
"SolarAccess_Percent": 100.0
},
{
"MonthNumber": 12,
"SolarAccess_Percent": 100.0
}]
}]
}]
}
},
"LoanPayment": {
"Cost": 16000.00,
"InterestRate_Percent": 5.0,
"LoanType": "Secured",
"Term_Years": 20,
"DownPaymentAmount": 1600,
"SaleMonth": 12,
"SaleYear": 2015
},
"MaintenanceCosts": {
"AnnualMaintenanceCost": 40.00,
"OneTimeMaintenanceCost": 1600.00,
"OneTimeMaintenanceYear": 12.0
}
}
Name
A unique string to identify an energy profile. This is used in the response to associate things like incentives that apply to a specific energy profile.
Possible Values: A string such as “House” or “East Solar System”.
Default: When omitted, Name defaults to Type.
Scenario
Defines which scenario the energy profile is part of for the savings analysis.
Possible Values: A string equal to “Current”, “Proposed”, or “Both”.
Default: Proposed.
EquipmentLife_Years
The equipment lifetime in years. This affects CashFlow in the response.
Possible Values: An integer value greater than 0 and less than or equal to 30.
Default: 20.
SystemDegradationPerYear_Percent
The amount in percent per year that solar system output will decrease due to module degradation.
Possible Values: Any decimal value between 0 and 100 inclusive.
Default: 0.
ProductionEnergyProfileName
The Name of an energy profile with Type “Production” that specifies the production date for a specific PV system. This is used when the caller prefers to provide production data rather than using the production simulation provided by the PowerBill API, and also wishes to have the PowerBill API calculate incentives. Incentive calculations require PV specification information, so both energy profiles Type “Pv” and Type “Production” need to be specified in this case.
Possible Values: A string matching Name for an energy profile with Type “Production”.
Default: When omitted and two energy profiles, one with Type “Production” and another with Type “Pv”, are provided, the production profiles will be combined in the bill calculation process.
PvSimulation
Contains the required parameters for simulating solar system production and calculating applicable incentives.
Required.
CashPayment
A set of inputs defining the simulation parameters for cash financing. One, and only one, of CashPayment, LoanPayment, LeasePayment, or PpaPayment can be specified.
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
LoanPayment
A set of inputs defining the simulation parameters for loan financing. One, and only one, of CashPayment, LoanPayment, LeasePayment, or PpaPayment can be specified.
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
LeasePayment
A set of inputs defining the simulation parameters for lease financing. One, and only one, of CashPayment, LoanPayment, LeasePayment, or PpaPayment can be specified.
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
PpaPayment
A set of inputs defining the simulation parameters for Power Purchase Agreement (PPA) financing. One, and only one, of CashPayment, LoanPayment, LeasePayment, or PpaPayment can be specified.
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
"CashPayment": {
"Cost": 9750.00,
"SaleMonth": 11,
"SaleYear": 2015
}
"LoanPayment": {
"Cost": 16000.00,
"InterestRate_Percent": 5.0,
"LoanType": "Secured",
"Term_Years": 20,
"DownPaymentAmount": 1600,
"SaleMonth": 11,
"SaleYear": 2015
}
"LeasePayment": {
"Cost": 16000.00,
"FirstYearMonthlyPayment": 0.0,
"AnnualPaymentEscalation_Percent": 2.9,
"TerminationOption": "Return",
"Term_Years": 20,
"DownPaymentAmount": 0.0,
"SaleMonth": 11,
"SaleYear": 2015
}
"PpaPayment": {
"Cost": 16000.00,
"AnnualPaymentEscalation_Percent": 2.9,
"PaymentPerkWh": 0.11,
"TerminationOption": "Return",
"Term_Years": 20,
"DownPaymentAmount": 0.0,
"SaleMonth": 11,
"SaleYear": 2015
}
MaintenanceCosts
Contains information on maintenance costs that will occur during the equipment lifetime. These costs will be included in CashFlow in the response.
Default: none (optional).