Power.Dev Optimization Services

CommonOptimizerYearlyRequest

The following routes are available for this service:
POST	/optimizer/yearly

**CommonOptimizerYearlyRequest** Parameters:
Name	Parameter	Data Type	Required
Month	body	int	No
Group	body	BatteryScenarioKeyGroup	Yes
Key	body	BatteryScenarioKeyItem	Yes
ProjectGroup	body	BatteryProjectGroup	No

**MonthlyRequestBase** Parameters:
Name	Parameter	Data Type	Required
ProjectId	form	Guid	No
NodeAltId	form	int	No
Iso	form	DataProvider	No
UseEnergy	form	BooleanValue	No
UseAncillary	form	BooleanValue	No
UseCapacityTod	form	bool	No
BaseMarket	form	PriceMarketType	No
CapacityTODs	form	IEnumerable<BatteryProjectTodItem>	Yes
UseRegup	form	decimal	No
UseRegdown	form	decimal	No
UseSpinning	form	decimal	No
UseNonSpinning	form	decimal	No
ParaciticLossesOperation	form	decimal	No
ParaciticLossesResting	form	decimal	No
HVACLosses	form	decimal	No
AcCablingLosses	form	decimal	No
TransformatorLosses	form	decimal	No
OtherLosses	form	decimal	No
RepresentativeYear	form	int	No
IncrementReferanceYear	form	int	No
UseFutureData	form	int	No
MaxDailyCycle	form	decimal	No
MinDailyProfitPerMw	form	decimal	No
AncillaryFileId	form	int	No
LmpFileId	form	int	No
MaxChargingPriceCap	form	decimal	No
MaxDischargingPriceCap	form	decimal	No
MaxAncillaryPriceCap	form	decimal	No
RevenueStackingMode	form	RevenueStackingMode	No
OptimizationQuality	form	int	No
EnsureExlusive	form	int	No
NodeRefId	form	int	No
UseInternalSolver	form	bool	No

**DataProvider** Enum:
Name	Value
Undefined	0
SPP	1
ERCOT	2
MISO	3
CAISO	4
PJM	5
ISONE	6
NYISO	7
NW	8
SW	9
SE	10
AESO	11
IESO	12
CENACE	20
NONISO	99
EIA	100
PNM	150
NREL	200
NOAA	210
ENTSOE	1000
EPIAS	1010
SELF	10000

**BooleanValue** Enum:
Undefined
Yes
No
Custom

**PriceMarketType** Enum:
Name	Value
Undefined	0
Realtime	1
DayAhead	10
DART	101

**BatteryProjectTodItem** Parameters:
Name	Parameter	Data Type	Required
Month	form	int	No
WeekDay	form	int	No
Hour	form	int	No
Price	form	decimal	No
Id	form	string	No

**RevenueStackingMode** Enum:
SolveWithoutAncillary
SolveWithAncillary

**BatteryScenarioKeyGroup** Parameters:
Name	Parameter	Data Type	Required
KeyId	form	int	No
Year	form	int	No
NodeId	form	int	No
Provider	form	DataProvider	No
ZoneId	form	int	No
PlantType	form	PowerPlantType	No
SolarId	form	int	No
WindId	form	int	No
IsServerless	form	bool	No

**PowerPlantType** Enum:
Undefined
Solar
Wind
Hybrid

**BatteryScenarioKeyItem** Parameters:
Name	Parameter	Data Type	Required
ProjectId	form	Guid	No
KeyId	form	int	No
KeyType	form	BatteryScenarioType	No
RecordKey	form	string	No
JobStatus	form	int	No
Status	form	int	No
MinDate	form	DateTime	No
MaxDate	form	DateTime	No
Year	form	int	No
YoyStatus	form	int	No
UsableCapacity	form	decimal	No
UsableCapacityFactor	form	decimal	No
SolarUsableCapacity	form	decimal	No
SolarUsableCapacityFactor	form	decimal	No
BaseMarket	form	PriceMarketType	No
BaseCapacityRate	form	decimal	No
CapacityRate	form	decimal	No
SolarCapacityRate	form	decimal	No
WindCapacityRate	form	decimal	No
ChargeEfficinecy	form	decimal	No
DischargeEfficinecy	form	decimal	No
NodeId	form	int	No
Provider	form	DataProvider	No
ZoneId	form	int	No
LmpFileId	form	int	No
ProductionFileId	form	int	No
LoadFileId	form	int	No
CapacityFileId	form	int	No
PlantType	form	PowerPlantType	No
SolarId	form	int	No
WindId	form	int	No
AncillaryIncrementFactor	form	decimal	No
EnergyIncrementFactor	form	decimal	No
CapacityIncrementFactor	form	decimal	No

**BatteryScenarioType** Enum:
Undefined
Optimization
Sum
OptiSum
FullTod
CapacityTod

**BatteryProjectGroup** Enum:
Undefined
StandAlone
FTM
BTM

**YearlyApiStatusResponse** Parameters:
Name	Parameter	Data Type	Required	Description
FailedCount	form	int	No
Message	form	string	Yes

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /optimizer/yearly HTTP/1.1 
Host: dev-optimization.power.dev 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	month: 0,
	group: 
	{
		keyId: 0,
		year: 0,
		nodeId: 0,
		provider: Undefined,
		zoneId: 0,
		plantType: Undefined,
		solarId: 0,
		windId: 0,
		isServerless: False
	},
	key: 
	{
		projectId: 00000000000000000000000000000000,
		keyId: 0,
		keyType: Undefined,
		recordKey: String,
		jobStatus: 0,
		status: 0,
		year: 0,
		yoyStatus: 0,
		usableCapacity: 0,
		usableCapacityFactor: 0,
		solarUsableCapacity: 0,
		solarUsableCapacityFactor: 0,
		baseMarket: Undefined,
		baseCapacityRate: 0,
		capacityRate: 0,
		solarCapacityRate: 0,
		windCapacityRate: 0,
		chargeEfficinecy: 0,
		dischargeEfficinecy: 0,
		nodeId: 0,
		provider: Undefined,
		zoneId: 0,
		lmpFileId: 0,
		productionFileId: 0,
		loadFileId: 0,
		capacityFileId: 0,
		plantType: Undefined,
		solarId: 0,
		windId: 0,
		ancillaryIncrementFactor: 0,
		energyIncrementFactor: 0,
		capacityIncrementFactor: 0
	},
	projectGroup: Undefined,
	projectId: 00000000000000000000000000000000,
	nodeAltId: 0,
	iso: Undefined,
	useEnergy: Undefined,
	useAncillary: Undefined,
	useCapacityTod: False,
	baseMarket: Undefined,
	useRegup: 0,
	useRegdown: 0,
	useSpinning: 0,
	useNonSpinning: 0,
	paraciticLossesOperation: 0,
	paraciticLossesResting: 0,
	hvacLosses: 0,
	acCablingLosses: 0,
	transformatorLosses: 0,
	otherLosses: 0,
	representativeYear: 0,
	incrementReferanceYear: 0,
	useFutureData: 0,
	maxDailyCycle: 0,
	minDailyProfitPerMw: 0,
	ancillaryFileId: 0,
	lmpFileId: 0,
	maxChargingPriceCap: 0,
	maxDischargingPriceCap: 0,
	maxAncillaryPriceCap: 0,
	revenueStackingMode: SolveWithoutAncillary,
	optimizationQuality: 0,
	ensureExlusive: 0,
	nodeRefId: 0,
	useInternalSolver: False
}

HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	failedCount: 0,
	message: String
}