Rates Request
Rates Response
Bill Request
Bill Response
BillSavings Request
CustomerInfo{...}
Sector
Location{...}
Address{...}
PostalCode
Income
TaxFilingStatus
Meters[{...}]
Name
CurrentRate{...}
Id
ProposedRate{...}
Id
AnnualUtilityBillEscalation_Percent
EnergyProfiles[{...}]
{"Type": "Consumption", ...}
Name
Scenario
IntervalData{...}
Interpolation
IntervalConvention
Interval
Data[{...}]
Time
Energy_kWh
BillAmount
{"Type": "Production"}
Name
Scenario
IntervalData{...}
Interpolation
IntervalConvention
Interval
Data[{...}]
Time
Energy_kWh
{"Type": "Pv", ...}
Name
Scenario
EquipmentLife_Years
SystemDegradationPerYear_Percent
ProductionEnergyProfileName
PvSimulation{...}
EnergySite{...}
Location{...}
Latitude
Longitude
PvSystems[{...}]
Albedo_Percent
GeneralDerate_Percent
Inverters[{...}]
Count
MaxPowerOutputAC_kW
EfficiencyRating_Percent
PvArrays[{...}]
PvModules[{...}]
Count
NameplateDCRating_kW
PtcRating_kW
PowerTemperatureCoefficient_PercentPerDegreeC
NominalOperatingCellTemperature_DegreesC
ArrayConfiguration{...}
Azimuth_Degrees
Tilt_Degrees
Tracking
TrackingRotationLimit_Degrees
MonthlyShadings[{...}]
MonthNumber
SolarAccess_Percent
CashPayment{...}
Cost
SaleMonth
SaleYear
LoanPayment{...}
Cost
InterestRate_Percent
LoanType
Term_Years
DownPaymentAmount
SaleMonth
SaleYear
LeasePayment{...}
Cost
FirstYearMonthlyPayment
PaymentFactor
AnnualPaymentEscalation_Percent
Term_Years
DownPaymentAmount
SaleMonth
SaleYear
PpaPayment{...}
Cost
PaymentPerkWh
AnnualPaymentEscalation_Percent
Term_Years
DownPaymentAmount
SaleMonth
SaleYear
MaintenanceCosts{...}
AnnualMaintenanceCost
OneTimeMaintenanceCost
OneTimeMaintenanceCostYear
BillPeriods[{...}]
Name
StartDate
BillPeriodEnd
EstimationOptions{...}
IncludeTaxEffects
OutputData[...]
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).