Controllable Unit Service Provider

The relation that links a controllable unit to a service provider. It represents a contract in the real world. A controllable unit shall be assigned to a maximum of one service provider per activation period.

Relevant links

Fields

Name	Description	Format	Reference
id	Unique surrogate key.	bigint Read only
controllable_unit_id	Reference to the controllable unit this relation links to a service provider.	bigint Required Non-updatable	controllable_unit.id
service_provider_id	Reference to the `party` (service provider) this relation links to a controllable unit.	bigint Required Non-updatable	party.id
end_user_id	Technical ID of the end user behind the accounting point.	bigint Required Non-updatable	party.id
contract_reference	The service providers internal reference to the contract with the end user. Typically an internal identifier to a stored document or consent record.	text Required Max length: `128` The content of this field will not be checked by the system, but is intended to make sure that the service has a digitally stored proof of their contract with the end user on the controllable unit.
valid_from	The date from which the relation between the controllable unit and the service provider is valid. Midnight aligned on Norwegian timezone.	date-time
valid_to	The date until which the relation between the controllable unit and the service provider is valid. Midnight aligned on Norwegian timezone.	date-time
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
CUSP-VAL001	Valid time is frozen after 2 weeks for SP.	DONE
CUSP-VAL002	New contracts added by SP must be created 2-4 weeks ahead of their start unless the CU has no current contract.	DONE
CUSP-VAL003	For the sake of data quality, new contracts added by SP and directly taking place after another contract cannot have the same end user.	DONE
CUSP-VAL004	The end user of a new CUSP must match the end user owning the accounting point the CU is connected to.	DONE

Notifications

Action	Recipient	Comment
create, update, delete	SP
create, update, delete	Connecting SO
create, update, delete	End user(s) in charge of the AP during the CU-SP contract

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

No policies.

End User

Policy key	Policy	Status
CUSP-EU001	Read CUSP that overlap with the period where they own the AP.	DONE
CUSP-EU002	Read CUSP history records that overlap with the period where they owned the AP.	DONE

Energy Supplier

No policies.

Flexibility Information System Operator

Policy key	Policy	Status
CUSP-FISO001	Read, create, update and delete all CUSP.	DONE
CUSP-FISO002	Read history on CUSP that they can read.	DONE

Organisation

No policies.

System Operator

Policy key	Policy	Status
CUSP-SO001	Read CUSP on CU they can read.	DONE
CUSP-SO002	Read history on CUSP that they can read.	DONE

Service Provider

Policy key	Policy	Status
CUSP-SP001	Create, read, update and delete CUSP where they are SP.	DONE
CUSP-SP002	Read history on CUSP that they can read.	DONE

Third Party

No policies.

Field Level Authorization

For party type abbreviations, check the authentication docs.

FIELD	BRP	ES	EU	FISO	SO	SP	TP
id	R	R	R	R	R	R	R
controllable_unit_id	R	R	R	RC	R	RC	R
service_provider_id	R	R	R	RC	R	RC	R
end_user_id	R	R	R	RC	R	RC	R
contract_reference	R	R	R	RCU	R	RCU	R
valid_from	R	R	R	RCU	R	RCU	R
valid_to	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