- 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
Possible Values: A string such as “House” or “East Solar System”.
Default: When omitted, Name defaults to Type.
Scenario
Possible Values: A string equal to “Current”, “Proposed”, or “Both”.
Default: Proposed.
EquipmentLife_Years
Possible Values: An integer value greater than 0 and less than or equal to 30.
Default: 20.
SystemDegradationPerYear_Percent
Possible Values: Any decimal value between 0 and 100 inclusive.
Default: 0.
ProductionEnergyProfileName
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
Required.
CashPayment
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
LoanPayment
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
LeasePayment
Conditionally required. One of CashPayment, LoanPayment, LeasePayment, or PpaPayment must be specified.
PpaPayment
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
Default: none (optional).