sistema de informação de mercados de energia...página 7 de 63 autor: ren - informação de...

REN – SpecWSInfoMercado v4.1 20191107.docx

Sistema de Informação de Mercados de Energia

Markets information Web Service Specification

2018-08-29

Version: 4.0

Privacy Notice

Copyright © REN. All Rights Reserved.

Version Control Version Date Change Summary

1.0 2014-04-08 First Release

2.0 2014-12-30 Disclosure of TSO-TSO balancing data

Additional restrictions for time intervals

3.0 2016-01-27 New data available:

Total Load Daily forecast

Total Load Weekly forecast

Total Load Monthly forecast

Generation Forecast

4.0 2018-08-29 New data available:

Actual Total Generation

Actual Total Load

Actual Market Total Load

Generation Units Planned Unavailabilities

Generation Units Actual Unavailabilities

Acronyms and definition The main acronyms and definitions used throughout this document are listed in the following table.

Acronym / Abbreviation Definition

WSDL Web Services Definition Language

XML Extensible Markup Language

SOAP Simple Object Access Protocol, based upon XML

HTTP Hypertext Transfer Protocol

UTC Universal Time Coordinated

CET Central European Time

CEST Central European Summer Time

TSO Transmission System Operator

de 63

Autor: REN - Informação de Mercado REN – SpecWSInfoMercado

Versão: 4.0 Data: 2018-08-29

Table of Contents

1 Introduction .................................................................................................................................................... 5

2 Authentication ................................................................................................................................................ 6

3 Interface .......................................................................................................................................................... 7

4 Web Services .................................................................................................................................................. 8

4.1 Web Method: Get data for given time frame by info type ..................................................................... 9

4.1.1 General definition ........................................................................................................................... 9

4.1.2 General error codes ........................................................................................................................ 9

4.1.3 Information types specific definitions .......................................................................................... 10

4.1.3.1 Market Structural Information .................................................................................................. 10

4.1.3.1.1 Type: GetMSIAgents ........................................................................................................... 10

4.1.3.1.2 Type: GetMSIProgrammingUnits ........................................................................................ 11

4.1.3.1.3 Type: GetMSIPhysicalUnits ................................................................................................. 12

4.1.3.1.4 Type: GetMSIGenerationUnits ........................................................................................... 13

4.1.3.1.5 Type: GetMSIBalanceAreas ................................................................................................ 15

4.1.3.1.6 Type: GetMSIGenerationUnitsConf .................................................................................... 16

4.1.3.1.7 Type: GetMSIPhysicalUnitsConf ......................................................................................... 17

4.1.3.2 MIBEL ...................................................................................................................................... 19

4.1.3.2.1 Type: GetMarketPrice ........................................................................................................ 19

4.1.3.3 Secondary Reserve .................................................................................................................... 20

4.1.3.3.1 Type: GetSecResRequested ................................................................................................ 20

4.1.3.3.2 Type: GetTotalSecResAllocated .......................................................................................... 21

4.1.3.3.3 Type: GetSecResAllocByPhysUnit ....................................................................................... 22

4.1.3.3.4 Type: GetSecResPrice ......................................................................................................... 23

4.1.3.3.5 Type: GetBidsOfSecResByPhysUnit .................................................................................... 25

4.1.3.3.6 Type: GetTotalSecResEnergy .............................................................................................. 26

4.1.3.3.7 Type: GetSecRegEnerByBalArea ......................................................................................... 27

4.1.3.3.8 Type: GetSecRegEnerPrice ................................................................................................. 28

4.1.3.4 Regulating Reserve ................................................................................................................... 29

4.1.3.4.1 Type: GetTotalRegResEnergy ............................................................................................. 29

4.1.3.4.2 Type: GetEnerRegReserByBalArea ..................................................................................... 30

4.1.3.4.3 Type: GetRegResEnerPrice ................................................................................................. 32

4.1.3.4.4 Type: GetBidsOfRegResByBalArea ..................................................................................... 33

4.1.3.5 TSO-TSO balacing exchange ................................................................................................... 34

4.1.3.5.1 Type: GetBalInterTSO ......................................................................................................... 34

4.1.3.6 Technical Constraints ............................................................................................................... 36

4.1.3.6.1 Type: GetBidsOfTechConstr ............................................................................................... 36

4.1.3.6.2 Type: GetDayAheadMTechConst ....................................................................................... 37

4.1.3.6.3 Type: GetRealTimePIMTechConst ...................................................................................... 38

4.1.3.6.4 Type: GetRealTimePIMTCOvercost .................................................................................... 40

4.1.3.6.5 Type: GetDayAheadMTCOvercost ...................................................................................... 41

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.7 Imbalances ................................................................................................................................ 42

4.1.3.7.1 Type: GetTotalImbalances .................................................................................................. 42

4.1.3.7.2 Type: GetImbalanceBySettleUnit ....................................................................................... 43

4.1.3.7.3 Type: GetImbalancesOvercost ........................................................................................... 44

4.1.3.8 Schedules .................................................................................................................................. 45

4.1.3.8.1 Type: GetPDBFByProgUnit ................................................................................................. 45

4.1.3.8.2 Type: GetPDVPByProgUnit ................................................................................................. 46

4.1.3.8.3 Type: GetPHFperBalancingArea ......................................................................................... 48

4.1.3.8.4 Type: GetPHFperProgUnit .................................................................................................. 49

4.1.3.8.5 Type: GetPHOFperBalancingArea ....................................................................................... 50

4.1.3.9 Total Load ................................................................................................................................. 51

4.1.3.9.1 Type: GetTotalLoadDailyForecast....................................................................................... 51

4.1.3.9.2 Type: GetTotalLoadWeeklyForecast .................................................................................. 52

4.1.3.9.3 Type: GetTotalLoadMonthlyForecast ................................................................................. 53

4.1.3.9.4 Type: GetTotalLoadActual .................................................................................................. 55

4.1.3.9.5 Type: GetTotalLoadActualMarket ...................................................................................... 56

4.1.3.10 Generation ............................................................................................................................. 57

4.1.3.10.1 Type: GetGenerationDailyForecast .................................................................................. 57

4.1.3.10.2 Type: GetGenerationActual .............................................................................................. 58

4.1.3.11 Unavailabilities ..................................................................................................................... 60

4.1.3.11.1 Type: GetUnavailabilitiesUPPlanned ................................................................................ 60

4.1.3.11.2 Type: GetUnavailabilitiesUPActual ................................................................................... 61

5 Additional comments / notes ........................................................................................................................ 63

de 63


Versão: 4.0 Data: 2018-08-29

1 Introduction

In accordance with European Parliament and Council Regulation (EC) No 714/2009 of 13 July 2009, transparency information on the electrical power market shall be made freely and easily available. All data shall be accessible through adequate and standardized means of information exchange, to be defined in close cooperation with market participants.

The main aim of this service is to facilitate access to public market information, ensuring compliance with regulatory requirements thus contributing for greater transparency of electrical power markets.

The service will enable information to be published, guaranteeing the following requirements:

Automatic service ensuring information exchange between systems.

Free, with no requirement to register or any other form of subscription;

On a non-discriminatory basis and easily accessible;

In a format which allows quantitative analyses to be conducted.

de 63


Versão: 4.0 Data: 2018-08-29

2 Authentication This service requires no authentication therefore there is no need to supply any credentials.

de 63


Versão: 4.0 Data: 2018-08-29

3 Interface The Web Service uses SOAP, Version 1.2, running over a standard HTTP protocol and therefore the interface is “firewall-friendly”.

Web Service URL: http://ws.mercado.ren.pt:9095/MarketInfoService.asmx

To access the WSDL with the Web service description, use the following URL: http://ws.mercado.ren.pt:9095/MarketInfoService.asmx?WSDL

http://ws.mercado.ren.pt:9095/MarketInfoService.asmx

http://ws.mercado.ren.pt:9095/MarketInfoService.asmx?WSDL

de 63


Versão: 4.0 Data: 2018-08-29

4 Web Services This section contains the technical specifications about the web method provided by the Web service. It is organized according to the following structure:

o Web Method: Subject

General definition

Method Name

Description

Request Data

Response Data

General error codes

Codes and descriptions

Response Example

Type specific definitions

Type value

o Description

o Response definition

o Error codes and descriptions

o Response Example

Success

The Web Methods below will generally receive a set of parameters of basic data types (string, int, double, etc) and will return a string containing an XML document with a specific format containing the request information.

In case of error, an XML will be returned containing an Error Code.

de 63


Versão: 4.0 Data: 2018-08-29

4.1 Web Method: Get data for given time frame by info type

4.1.1 General definition

Method GetInfoForTimeFrameByInfoType

Description Get Information for given time frame by information type

Parameter Type (size) Format Comments

Request Data

StartDay String (10) yyyy-mm-dd Higher or equal

EndDay InfoType

String (10) String (80)

yyyy-mm-dd

Lower or Equal More information in chapter Information types specific definitions

Response Data Return Value String XML Document More information in chapter Information types specific definitions

4.1.2 General error codes

Code Description

GEN01 General Error

GEN02 No Data Available

GEN03 An Error Has Occurred

INPUT01 Required field

INPUT02 Invalid Input format

INPUT03 Time interval is bigger than 31 days.

INPUT04 ‘EndDay’ before ‘StartDay’

INPUT05 Unknown type ‘<Received type>’

INPUT06 Specific error (applicable in some data items)

Error Response Example

<?xml version="1.0" encoding="utf-8" ?>

<Root>

<Error>

<Code>GEN01</Code>

<Message>(…)</Message>

</Error>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3 Information types specific definitions

4.1.3.1 Market Structural Information

4.1.3.1.1 Type: GetMSIAgents

Description

List of qualified Market Agents.

Response definition

Field Type (size) Format Comments

Response Definition

Code String (7)

Name String (70)

StartDay String (10) yyyy-mm-dd

EndDay String (10) yyyy-mm-dd

Type String (2) PN;CM; PN-Producer; CM-Retailer

Error codes and descriptions

Code Description

Response Example

Success


<Root>

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>

<StartDay>(...)</StartDay>

<EndDay>(...)</EndDay>

<Type>(...)</Type>

</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>

de 63


Versão: 4.0 Data: 2018-08-29



<Type>(...)</Type>

</Item>

</Items>

</Root>

4.1.3.1.2 Type: GetMSIProgrammingUnits

Description

List of Programming Units registered on the market.

Response definition


Response Definition

Code String (7) Programming Unit Code

Name String (70)

Agent String (7) Agent Code



Type String (2)

GC – Generic Programming Unit; CC- Consumption Unit - Retailer; CB – Consumption Unit – Hydro Pumping; PE – Production Unit – Special Regime; P – Production Unit.

MaxPower Double (6.1)


Code Description

Response Example

Success


<Root>

de 63


Versão: 4.0 Data: 2018-08-29

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>

<Agent>(...)</Agent>



<Type>(...)</Type>

<MaxPower>(...)</MaxPower>

</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>




<Type>(...)</Type>


</Item>

</Items>

</Root>

4.1.3.1.3 Type: GetMSIPhysicalUnits

Description

List of Physical Units registered on the market.

Response definition


Response Definition

Code String (7) Physical Unit Code

Name String (70)




Type String (1) H - Hydro T - Thermal B – Hydro Pumping


SecReserve Double (4.1) 0 to 999.9 or empty Secondary Reserve Capacity

de 63


Versão: 4.0 Data: 2018-08-29


Code Description

Response Example

Success


<Root>

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>




<Type>(...)</Type>


<SecReserve>(...)</SecReserve>

</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>




<Type>(...)</Type>



</Item>

</Items>

</Root>

4.1.3.1.4 Type: GetMSIGenerationUnits

Description

List of Generation Units registered on the market.

de 63


Versão: 4.0 Data: 2018-08-29

Response definition


Response Definition

Code String (7) Generation Unit Code

Name String (70)






SecReserve Double (4.1) 0 to 999.9 or empty Secondary Reserve Capacity


Code Description

Response Example

Success


<Root>

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>




<Type>(...)</Type>



</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>



de 63


Versão: 4.0 Data: 2018-08-29


<Type>(...)</Type>



</Item>

</Items>

</Root>

4.1.3.1.5 Type: GetMSIBalanceAreas

Description

List of Balancing Areas registered on the market.

Response definition


Response Definition

Code String (7) Balancing Area Code

Name String (70)






Code Description

Response Example

Success


<Root>

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>


de 63


Versão: 4.0 Data: 2018-08-29



<Type>(...)</Type>

</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>




<Type>(...)</Type>

</Item>

</Items>

</Root>

4.1.3.1.6 Type: GetMSIGenerationUnitsConf

Description

Generation Units configuration.

Response definition


Response Definition

GenUnit String (7) Generation Unit Code


PhysicalUnit String (7) Physical Unit Code

ProgUnit String (7) Programming Unit Code

BalanceArea String (7) Balance Area Code




Code Description

Response Example

Success

de 63


Versão: 4.0 Data: 2018-08-29


<Root>

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>


<PhysicalUnit>(...)</PhysicalUnit>

<ProgUnit>(...)</ProgUnit>

<BalanceArea>(...)</BalanceArea>



</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>







</Item>

</Items>

</Root>

4.1.3.1.7 Type: GetMSIPhysicalUnitsConf

Description

Physical Units configuration.

Response definition


Response Definition



ProgUnit String (7) Programming Unit Code

BalanceArea String (7) Balance Area Code




de 63


Versão: 4.0 Data: 2018-08-29

Code Description

Response Example

Success


<Root>

<Items>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>






</Item>

<Item>

<Code>(...)</Code>

<Name>(...)</Name>






</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.2 MIBEL

4.1.3.2.1 Type: GetMarketPrice

Description

Day-ahead and intraday markets prices.

Response definition


Response Definition

MarketDay String (10) yyyy-mm-dd Market Day (CET/CEST)

Period Int(2) Market Period

UTCDate String (17) yyyy-mm-dd’T’hh:mm’Z’ UTC Time (Market Period)

MarketSession Int(7) 0 (day-ahead) to 7 (last 4 hours of the current day of the 6th OMIE market session)

Price Double (7.2) €/MWh; Decimal separator ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>

<MarketDay>(...)</MarketDay>

<Period>(...)</Period>

<UTCDate>(...)</UTCDate>

<MarketSession>(...)</MarketSession>

<Price>(...)</Price>

</Item>

<Item>




de 63


Versão: 4.0 Data: 2018-08-29

<MarketSession>(...)</MarketSession>


</Item>

</Items>

</Root>

4.1.3.3 Secondary Reserve

4.1.3.3.1 Type: GetSecResRequested

Description

Secondary reserve requested by the System Manager (GGS)

Response definition


Response Definition




UpReserve Double (6.1) MW; Decimal separator ‘.’

DownReserve Double (6.1) MW; Decimal separator ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>




<UpReserve>(...)</UpReserve>

<DownReserve>(...)</DownReserve>

de 63


Versão: 4.0 Data: 2018-08-29

</Item>

<Item>






</Item>

</Items>

</Root>

4.1.3.3.2 Type: GetTotalSecResAllocated

Description

Aggregated secondary reserve allocation.

Response definition


Response Definition




ReserveType String (1) M or E Allocation: M-Market; E-Extraordinary.




Code Description

Response Example

Success


<Root>

<Items>

<Item>

de 63


Versão: 4.0 Data: 2018-08-29




<ReserveType>(...)</ReserveType>



</Item>

<Item>







</Item>

</Items>

</Root>

4.1.3.3.3 Type: GetSecResAllocByPhysUnit

Description

Secondary reserve by physical unit.

Response definition


Response Definition





ReserveType String (1) M or E Allocation: M-Market; E-Extraordinary.

Value Double (7.1) MW; Decimal separator ‘.’


Code Description

Response Example

de 63


Versão: 4.0 Data: 2018-08-29

Success


<Root>

<Items>

<Item>






<Value>(...)</Value>

</Item>

<Item>






<Value>(...)</Value>

</Item>

</Items>

</Root>

4.1.3.3.4 Type: GetSecResPrice

Description

Secondary reserve price (marginal).

Response definition


Response Definition




Price Double (7.2) €/MW; Decimal separator ‘.’

de 63


Versão: 4.0 Data: 2018-08-29


Code Description

Response Example

Success


<Root>

<Items>

<Item>





</Item>

<Item>





</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.3.5 Type: GetBidsOfSecResByPhysUnit

Description

Secondary reserve bids/offers by physical unit.

Response definition


Response Definition









Code Description

INPUT06 Time interval is bigger than 1 day.

Response Example

Success


<Root>

<Items>

<Item>








</Item>

<Item>



de 63


Versão: 4.0 Data: 2018-08-29






</Item>

</Items>

</Root>

4.1.3.3.6 Type: GetTotalSecResEnergy

Description

Aggregated secondary regulation energy.

Response definition


Response Definition




UpReserve Double (10.3) MWh; Decimal separator ‘.’

DownReserve Double (10.3) MWh; Decimal separator ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>





de 63


Versão: 4.0 Data: 2018-08-29


</Item>

<Item>






</Item>

</Items>

</Root>

4.1.3.3.7 Type: GetSecRegEnerByBalArea

Description

Secondary regulation energy by balancing area.

Response definition


Response Definition




BalancingArea String (7) Balancing Area Code

Quantity Double (8.1) + (Up); – (Down) MWh; Decimal separator ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>


de 63


Versão: 4.0 Data: 2018-08-29



< BalancingArea>(...)</BalancingArea>

<Quantity>(...)</Quantity>

</Item>

<Item>




<BalancingArea>(...)</BalancingArea>


</Item>

</Items>

</Root>

4.1.3.3.8 Type: GetSecRegEnerPrice

Description

Price (marginal) of Secondary regulation energy.

Response definition


Response Definition




UpPrice Double (7.2) 0…99999.99 or Empty €/MWh; Decimal sep. ‘.’

DownPrice Double (7.2) 0…99999.99 or Empty €/MWh; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

de 63


Versão: 4.0 Data: 2018-08-29

<Items>

<Item>




<UpPrice>(...)</UpPrice>

<DownPrice>(...)</DownPrice>

</Item>

<Item>






</Item>

</Items>

</Root>

4.1.3.4 Regulating Reserve

4.1.3.4.1 Type: GetTotalRegResEnergy

Description

Allocated regulation reserve energy (aggregated form).

Response definition


Response Definition




UpReserve Double (10.3) MWh; Decimal separator ‘.’

DownReserve Double (10.3) MWh; Decimal separator ‘.’


Code Description

de 63


Versão: 4.0 Data: 2018-08-29

Response Example

Success


<Root>

<Items>

<Item>






</Item>

<Item>






</Item>

</Items>

</Root>

4.1.3.4.2 Type: GetEnerRegReserByBalArea

Description

Energy regulation reserve by balancing area.

Response definition


Response Definition





Quantity Double (8.1) + (Up); – (Down) MWh; Decimal separator ‘.’

de 63


Versão: 4.0 Data: 2018-08-29


Code Description

Response Example

Success


<Root>

<Items>

<Item>






</Item>

<Item>






</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.4.3 Type: GetRegResEnerPrice

Description

Price (marginal) of Regulation reserve energy.

Response definition


Response Definition




UpPrice Double (7.2) 0…99999.99 or Empty €/MWh; Decimal sep. ‘.’

DownPrice Double (7.2) 0…99999.99 or Empty €/MWh; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>






</Item>

<Item>






</Item>

de 63


Versão: 4.0 Data: 2018-08-29

</Items>

</Root>

4.1.3.4.4 Type: GetBidsOfRegResByBalArea

Description

Bids/Offers of regulation reserve by balancing area

Response definition


Response Definition





Quantity Double (8.3) MW; Decimal separator ‘.’

TransactionType String (1) C or V C-Buy / V-Sell

Price Double (6.2) -9999.99 to 9999.99 or empty

€/MW; Decimal separator ‘.’

TypeRes String (1) M or D M-Market; D-Default.


Code Description


Response Example

Success


<Root>

<Items>

<Item>






<TransactionType>(...)</TransactionType>

de 63


Versão: 4.0 Data: 2018-08-29


<TypeRes>(...)</TypeRes>

</Item>

<Item>








<TypeRes>(...)</TypeRes>

</Item>

</Items>

</Root>

4.1.3.5 TSO-TSO balacing exchange

4.1.3.5.1 Type: GetBalInterTSO

Description

Bids/Offers for balancing Inter TSO (TSO-TSO Exchange of balancing energy)

Response definition


Response Definition




Quantity Double (4.1) MW; Decimal separator ‘.’ Price Double (7.2) €/MW; Decimal separator ‘.’ TransactionType String (1) C or V C-Buy / V-Sell

Status String (1) N or A N-not activated / A-Activated

TSO String (3) REN or REE Offering TSO ImportExport String(1) I or E I-Import / E - Export


Code Description


de 63


Versão: 4.0 Data: 2018-08-29

Response Example

Success


<Root>

<Items>

<Item>







<Status>(...)</Status>

<TSO>(...)</TSO>

<ImportExport>(...)</ ImportExport>

</Item>

<Item>







<Status>(...)</Status>

<TSO>(...)</TSO>

<ImportExport>(...)</ ImportExport>

</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.6 Technical Constraints

4.1.3.6.1 Type: GetBidsOfTechConstr

Description

Bids/Offers to resolve Technical Constraints per Programming Unit

Response definition


Response Definition




ProgrammingUnit String (7) Programming Unit Code

Quantity Double (8.3) MW; Decimal separator ‘.’ TransactionType String (1) C or V C-Buy / V-Sell


CpxBidFixedPrc Double (10.2) €; Decimal separator ‘.’

CpxBidVariablePrc Double (6.2) €/MWh; Decimal separator ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>




<ProgrammingUnit>(...)</ProgrammingUnit>




de 63


Versão: 4.0 Data: 2018-08-29

<CpxBidFixedPrc>(...)</CpxBidFixedPrc>

<CpxBidVariablePrc>(...)</CpxBidVariablePrc>

</Item>

<Item>








<CpxBidFixedPrc>(...)</CpxBidFixedPrc>

<CpxBidVariablePrc>(...)</CpxBidVariablePrc>

</Item>

</Items>

</Root>

4.1.3.6.2 Type: GetDayAheadMTechConst

Description

Day-Ahead Market Technical Constraints

Response definition


Response Definition





Restriction_ph1 Double (8.1) + ; – ; Empty MWh; Up(+); Down(-); Decimal sep. ‘.’

Rebalance_ph2 Double (8.1) + ; – ; Empty MWh; Up(+); Down(-); Decimal sep. ‘.’


Code Description

Response Example

de 63


Versão: 4.0 Data: 2018-08-29

Success


<Root>

<Items>

<Item>





<Restrictions>(...)</Restrictions>

<Rebalance>(...)</Rebalance>

</Item>

<Item>





<Restriction_ph1>(...)</Restriction_ph1>

<Rebalance_ph2>(...)</Rebalance_ph2>

</Item>

</Items>

</Root>

4.1.3.6.3 Type: GetRealTimePIMTechConst

Description

Post Intraday Market Technical Constraints (real time).

Response definition


Response Definition





Restrictions Double (8.1) + ; – MWh; Up(+); Down(-); Decimal sep. ‘.’

de 63


Versão: 4.0 Data: 2018-08-29


Code Description

Response Example

Success


<Root>

<Items>

<Item>






</Item>

<Item>






</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.6.4 Type: GetRealTimePIMTCOvercost

Description

Overcost of Post Intraday Market Technical Constraints.

Response definition


Response Definition




OverCost Double (10.2) +/- €; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>




<OverCost>(...)</OverCost>

</Item>

<Item>





</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.6.5 Type: GetDayAheadMTCOvercost

Description

Overcost of Day-ahead Market Technical Constraints.

Response definition


Response Definition






Code Description

Response Example

Success


<Root>

<Items>

<Item>





</Item>

<Item>





</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.7 Imbalances

4.1.3.7.1 Type: GetTotalImbalances

Description

Imbalance aggregated energy (sum of imbalance energy per settlement unit).

Response definition


Response Definition




UpImbalance Double (10.3)

MWh; Decimal separator ‘.’; Up means excessive production or deficit consumption, i.e. more energy in the system;

DownImbalance Double (10.3)

MWh; Decimal separator ‘.’ Down means excessive consumption or deficit production, i.e. less energy in the system;


Code Description

Response Example

Success


<Root>

<Items>

<Item>




<UpImbalance>(...)</ UpImbalance>

<DownImbalance>(...)</DownImbalance>

</Item>

de 63


Versão: 4.0 Data: 2018-08-29

<Item>




<UpImbalance>(...)</ UpImbalance>

<DownImbalance>(...)</DownImbalance>

</Item>

</Items>

</Root>

4.1.3.7.2 Type: GetImbalanceBySettleUnit

Description

Imbalance energy by settlement unit (Balance Areas and Programming Units).

Response definition


Response Definition




SettleUnit String (7) Settlement Unit Code

Imbalance Double (10.1) + ; –

MWh; Decimal separator ‘.’; Positive value means excessive production or deficit consumption, i.e. more energy in the system; Negative value means excessive consumption or deficit production, i.e. less energy in the system;

ImbalanceType String(1) I;J J: Justified; I: Unjustified;


Code Description

de 63


Versão: 4.0 Data: 2018-08-29

Response Example

Success


<Root>

<Items>

<Item>




<Imbalance>(...)</Imbalance>

</Item>

<Item>




<Imbalance>(...)</Imbalance>

</Item>

</Items>

</Root>

4.1.3.7.3 Type: GetImbalancesOvercost

Description

Imbalance overcost.

Response definition


Response Definition






Code Description

de 63


Versão: 4.0 Data: 2018-08-29

Response Example

Success


<Root>

<Items>

<Item>





</Item>

<Item>





</Item>

</Items>

</Root>

4.1.3.8 Schedules

4.1.3.8.1 Type: GetPDBFByProgUnit

Description

PDBF by programming Unit.

Response definition


Response Definition





PDBF Double (8.1) + ; – MWh; Decimal sep. ‘.’

de 63


Versão: 4.0 Data: 2018-08-29


Code Description

Response Example

Success


<Root>

<Items>

<Item>





<PDBF>(...)</PDBF>

</Item>

<Item>





<PDBF>(...)</PDBF>

</Item>

</Items>

</Root>

4.1.3.8.2 Type: GetPDVPByProgUnit

de 63


Versão: 4.0 Data: 2018-08-29

Description

PDVP by programming Unit.

Response definition


Response Definition





PDVP Double (8.1) + ; – MWh; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>





<PDVP>(...)</PDVP>

</Item>

<Item>





<PDVP>(...)</PDVP>

</Item>

</Items>

de 63


Versão: 4.0 Data: 2018-08-29

</Root>

4.1.3.8.3 Type: GetPHFperBalancingArea

Description

PHF per Balancing Area.

Response definition


Response Definition





PHF Double (8.1) +; – MWh; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>





<PHF>(...)</PHF>

</Item>

<Item>





de 63


Versão: 4.0 Data: 2018-08-29

<PHF>(...)</PHF>

</Item>

</Items>

</Root>

4.1.3.8.4 Type: GetPHFperProgUnit

Description

PHF per Programming Unit (retailers).

Response definition


Response Definition





PHF Double (8.1) +; – MWh; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>





<PHF>(...)</PHF>

</Item>

<Item>


de 63


Versão: 4.0 Data: 2018-08-29




<PHF>(...)</PHF>

</Item>

</Items>

</Root>

4.1.3.8.5 Type: GetPHOFperBalancingArea

Description

PHOF per balancing area.

Response definition


Response Definition





PHOF Double (8.1) +; – MWh; Decimal sep. ‘.’


Code Description

Response Example

Success


<Root>

<Items>

<Item>





<PHOF>(...)</PHOF>

de 63


Versão: 4.0 Data: 2018-08-29

</Item>

<Item>





<PHOF>(...)</PHOF>

</Item>

</Items>

</Root>

4.1.3.9 Total Load

4.1.3.9.1 Type: GetTotalLoadDailyForecast

Description

Total Load daily/weekly forecast (hourly values). The weekly forecast is updated daily.

Response definition


Response Definition




Load Integer (5) >0 MW


Code Description

Response Example

Success


<Root>

<Items>

<Item>


de 63


Versão: 4.0 Data: 2018-08-29



<Load>(...)</Load>

</Item>

<Item>




<Load>(...)</Load>

</Item>

</Items>

</Root>

4.1.3.9.2 Type: GetTotalLoadWeeklyForecast

Description

Total Load weekly/monthly forecast (weekly values disaggregated per on-peak, mid-peak and off-peak periods). The values of the first week of the forecast are updated daily.

Response definition


Response Definition

PeriodStartDay String (10) yyyy-mm-dd Market Day (CET/CEST)

PeriodEndDay String (10) yyyy-mm-dd Market Day (CET/CEST)

OnPeakLoad Integer (5) >0 MW

MidPeakLoad Integer (5) >0 MW

OffPeakLoad Integer (5) >0 MW


Code Description

Response Example

de 63


Versão: 4.0 Data: 2018-08-29

Success


<Root>

<Items>

<Item>

<PeriodStartDay>(...)</PeriodStartDay>

<PeriodEndDay >(...)</PeriodEndDay>

<OnPeakLoad>(...)</OnPeakLoad>

<MidPeakLoad>(...)</MidPeakLoad>

<OffPeakLoad>(...)</OffPeakLoad>

</Item>

<Item>



<OnPeakLoad>(...)</OnPeakLoad>

<MidPeakLoad>(...)</MidPeakLoad>

<OffPeakLoad>(...)</OffPeakLoad>

</Item>

</Items>

</Root>

4.1.3.9.3 Type: GetTotalLoadMonthlyForecast

Description

Total Load monthly/annually forecast (monthly values of max load, min load, total load and working-days average load). The values of the first month of the forecast are updated monthly.

Response definition


Response Definition

PeriodStartDay String (10) yyyy-mm-dd Market Day (CET/CEST)

PeriodEndDay String (10) yyyy-mm-dd Market Day (CET/CEST)

MaxLoad Integer (5) >0 MW

MinLoad Integer (5) >0 MW

WDAvgLoad Integer (5) >0 MW

TotalLoad Integer (5) >0 GWh


de 63


Versão: 4.0 Data: 2018-08-29

Code Description

Response Example

Success


<Root>

<Items>

<Item>



<MaxLoad>(...)</MaxLoad>

<MinLoad>(...)</MinLoad>

<WDAvgLoad>(...)</ WDAvgLoad >

<TotalLoad>(...)</TotalLoad>

</Item>

<Item>



<MaxLoad>(...)</MaxLoad>

<MinLoad>(...)</MinLoad>

<WDAvgLoad>(...)</ WDAvgLoad >

<TotalLoad>(...)</TotalLoad>

</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.9.4 Type: GetTotalLoadActual

Description

Actual total load (hourly values).

Response definition


Response Definition




Load Double (9,3) >0 MWh


Code Description


Response Example

Success


<Root>

<Items>

<Item>




<Load>(...)</Load>

</Item>

<Item>




<Load>(...)</Load>

</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.9.5 Type: GetTotalLoadActualMarket

Description

Actual market total load (hourly values). Includes power plants auxiliary load.

Response definition


Response Definition




MarketLoad Double (9,3) >0 MWh


Code Description


Response Example

Success


<Root>

<Items>

<Item>




<MarketLoad>(...)</MarketLoad>

</Item>

<Item>




<MarketLoad>(...)</MarketLoad>

</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.10 Generation

4.1.3.10.1 Type: GetGenerationDailyForecast

Description

Generation daily forecast (hourly values), disaggregated by type (wind, solar and others).

Response definition


Response Definition




Wind Integer (5) >0 MWh

Solar Integer (5) >0 MWh

Others Integer (5) >0 MWh


Code Description

Response Example

Success


<Root>

<Items>

<Item>




<Wind>(...)</Wind>

<Solar>(...)</Solar>

<Others>(...)</Others>

</Item>

<Item>




de 63


Versão: 4.0 Data: 2018-08-29

<Wind>(...)</Wind>



</Item>

</Items>

</Root>

4.1.3.10.2 Type: GetGenerationActual

Description

Actual daily generation (hourly values), disaggregated by type (hydro, pump, biomass, wind, solar, coal, natural gas and others).

Response definition


Response Definition




Hydro Double (9.3) >=0 MWh, Hydro generation, Decimal sep. ‘.’

Pump Double (9.3) >=0 MWh, Hydro pumping, Decimal sep. ‘.’

Wind Double (9.3) >=0 MWh, Decimal sep. ‘.’

Biomass Double (9.3) >=0 MWh, Decimal sep. ‘.’

Solar Double (9.3) >=0 MWh, Decimal sep. ‘.’

Coal Double (9.3) >=0 MWh, Decimal sep. ‘.’

NaturalGas Double (9.3) >=0 MWh, Decimal sep. ‘.’

Others Double (9.3) >=0 MWh, Decimal sep. ‘.’


Code Description


Response Example

Success


<Root>

de 63


Versão: 4.0 Data: 2018-08-29

<Items>

<Item>




<Hydro>(...)</Hydro>

<Pump>(...)</Pump>

<Wind>(...)</Wind>

<Biomass>(...)</Biomass>


<Coal>(...)</Coal>

<NaturalGas >(...)</NaturalGas>


</Item>

<Item>




<Hydro>(...)</Hydro>

<Pump>(...)</Pump>

<Wind>(...)</Wind>

<Biomass>(...)</Biomass>


<Coal>(...)</Coal>

<NaturalGas >(...)</NaturalGas>


</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

4.1.3.11 Unavailabilities

4.1.3.11.1 Type: GetUnavailabilitiesUPPlanned

Description

Planned generation units unavailabilities.

Response definition


Response Definition

GenerationUnit String (7)

AvailableCap Double(6.1) MW

StartDate String (16) yyyy-mm-dd hh:mm

UTCStartDate String (17) yyyy-mm-dd’T’hh:mm’Z’ UTC Time

EndDate String (16) yyyy-mm-dd hh:mm String (16)

UTCEndDate String (17) yyyy-mm-dd’T’hh:mm’Z’ UTC Time


Code Description

Response Example

Success


<Root>

<Items>

<Item>

<GenerationUnit>(...)</GenerationUnit>

<AvailableCap>(...)</AvailableCap>

<StartDate>(...)</StartDate>

<UTCStartDate>(...)</UTCStartDate>

<EndDate>(...)</EndDate>

<UTCEndDate>(...)</UTCEndDate>

</Item>

<Item>




de 63


Versão: 4.0 Data: 2018-08-29




</Item>

</Items>

</Root>

4.1.3.11.2 Type: GetUnavailabilitiesUPActual

Description

Actual generation units unavailabilities.

Response definition


Response Definition

GenerationUnit String (7)

AvailableCap Double(6.1) MW

Type String (2) PL- Planned; PG - Scheduled; FT - Outage

StartDate String (16) yyyy-mm-dd hh:mm

UTCStartDate String (17) yyyy-mm-dd’T’hh:mm’Z’ UTC Time

EndDate String (16) yyyy-mm-dd hh:mm String (16)

UTCEndDate String (17) yyyy-mm-dd’T’hh:mm’Z’ UTC Time


Code Description

Response Example

Success


<Root>

<Items>

<Item>



de 63


Versão: 4.0 Data: 2018-08-29

<Type>(...)</Type>





</Item>

<Item>



<Type>(...)</Type>





</Item>

</Items>

</Root>

de 63


Versão: 4.0 Data: 2018-08-29

5 Additional comments / notes

sistema de informação de mercados de energia...página 7 de 63 autor: ren - informação de...

Documents