Controllable Unit
A controllable unit (CU) is a unit in the power system that can be actively controlled.
In FIS, each CU is linked to exactly one accounting point, ensuring a unique connection to the balance responsible party (BRP) and determining its location in the grid.
For more information about the CU concept and its role in the flexibility structure, see Conceptual Model and Terminology.
Business Identifiers
Controllable units are identified by a UUID. UUID are simple and easy to generate and requires no coordination with external bodies (like GS1 or ENTSO-E). It is a un-complicated way to ensure uniqueness.
The UUIDs are generated by the system when a CU is created.
Status transitions for controllable unit
The following diagram shows the status and its transitions for controllable unit. The Service Provider is responsible for creating a new controllable unit. Initially, the status is set to "new." Once the CU registration is complete, the Service Provider updates the status to "active." After termination, the status can only be edited by a FIS operator.
Full Size | Plantuml description | How to read the diagram
Relevant links
Fields
| Name | Description | Format | Reference |
|---|---|---|---|
| id | Unique surrogate key. | bigint Read only |
|
| business_id | Unique business identifier for the controllable unit. | text Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Read only |
|
| name | Free text name of the controllable unit. | text Required Max length: 512 |
|
| start_date | The usage date when the controllable unit is first active. | date | |
| status | The status of the controllable unit. | text One of: new, active, inactive, terminatedDefault: newAlways new when created. Can then be updated to the other values. Once terminated, only editable by a FIS operator. |
|
| regulation_direction | The regulation direction of the controllable unit. up means it can be used to increase production or decrease consumption, while down means to decrease production or increase consumption. |
text One of: up, down, bothRequired up |
|
| maximum_active_power | Maximum continuous active power that the controllable unit can produce or consume, i.e. deliver for balancing and congestion services, in kilowatts. | decimal Required Min: 0Max: 999999.999Multiple of: 0.001 |
|
| is_small | Whether the controllable unit is small or not, following NCDR. | boolean Read only |
|
| accounting_point_id | Reference to the accounting point that the controllable unit is connected to. | bigint Required Non-updatable |
accounting_point.id |
| additional_information | Free text field for extra information about the controllable unit if needed. | text | |
| recorded_at | When the resource was recorded (created or updated) in the system. | date-time Read only |
|
| recorded_by | The identity that recorded the resource. | bigint Read only |
Validation Rules
| Validation rule key | Validation rule | Status |
|---|---|---|
| CU-VAL004 | The controllable unit must have at least one technical resource for its status to be set to active. |
DONE |
Notifications
| Action | Recipient | Comment |
|---|---|---|
| create | Connecting SO | |
| create | End user of the accounting point | |
| update | Active SP | |
| update | Connecting SO | When status is not new |
Authorization
Resource Level Authorization
Below is the RLA for the resource. The default policy is deny.
Anonymous
No policies.
Common
No policies.
Balance Responsible Party
| Policy key | Policy | Status |
|---|---|---|
| CU-BRP001 | Read CU data that are connected to AP where they are BRP. Only for the contract period. | DONE |
| CU-BRP002 | Read CU history that are connected to AP where they are BRP. Only for the contract period. | DONE |
End User
| Policy key | Policy | Status |
|---|---|---|
| CU-EU001 | Read CU data that are connected to AP where they are EU. Only for when they are EU on the AP. | DONE |
| CU-EU002 | Read CU history that are connected to AP where they are EU. Only for when they are EU on the AP. | DONE |
Energy Supplier
| Policy key | Policy | Status |
|---|---|---|
| CU-ES001 | Read CU data that are connected to AP where they are ES. Only for the contract period. | DONE |
| CU-ES002 | Read CU history that are connected to AP where they are ES. Only for the contract period. | DONE |
Flexibility Information System Operator
| Policy key | Policy | Status |
|---|---|---|
| CU-FISO001 | Read, create and update all CU. | DONE |
| CU-FISO002 | Read all CU history. | DONE |
Organisation
No policies.
System Operator
| Policy key | Policy | Status |
|---|---|---|
| CU-SO001 | Read and update CU that are connected to AP belonging to SO. | DONE |
| CU-SO002 | Read CU belonging to SPG that the SO can see. | DONE |
| CU-SO003 | Read history on CU that they can read. | DONE |
Service Provider
| Policy key | Policy | Status |
|---|---|---|
| CU-SP001 | Read CU data for the period they are SP. | DONE |
| CU-SP002 | Create new CU. | DONE |
| CU-SP003 | Update CU where they are current SP. | DONE |
| CU-SP004 | Read CU history for the period they are SP. | DONE |
| CU-SP005 | Read CU they created. | DONE |
Third Party
No policies.
Field Level Authorization
For party type abbreviations, check the authentication docs.
| FIELD | ANON | BRP | ES | EU | FISO | SO | SP | TP | ORG |
|---|---|---|---|---|---|---|---|---|---|
| id | R | R | R | R | R | R | R | ||
| business_id | R | R | R | R | R | R | R | ||
| name | R | R | R | RCU | R | RCU | R | ||
| regulation_direction | R | R | R | RCU | R | RCU | R | ||
| maximum_active_power | R | R | R | RCU | R | RCU | R | ||
| is_small | R | R | R | R | R | R | R | ||
| start_date | R | R | R | RCU | R | RCU | R | ||
| status | R | R | R | RCU | R | RCU | R | ||
| accounting_point_id | R | R | R | RC | R | RC | R | ||
| additional_information | R | R | R | RCU | R | RCU | R | ||
| recorded_at | R | R | R | R | R | R | R | ||
| recorded_by | R | R | R | R | R | R | R |