> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ridergy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Prioriteitsmodel

> Hoe limietprofielen, prioriteiten en effectieve limieten werken

Locatie- en laadpuntlimieten worden aangestuurd via **prioriteits-tijdvensterprofielen**, gedeeld tussen de locatie-, laadpunt- en clusterendpoints.

## Prioriteitsniveaus

* Prioriteiten lopen van **0 (laagste) tot 10 (hoogste)**, volgens dezelfde
  conventie als OCPP-laadprofiel-stackniveaus.
* Elk doel (een locatie, of een laadpuntconnector) kan **tot 11 profielen**
  hebben, één per prioriteitsniveau, elk met een eigen
  `[startTime, endTime)`-tijdvenster.
* Het indienen van een nieuw profiel op een prioriteit die al bestaat voor
  dat doel **vervangt** het bestaande profiel.

## Effectief limiet

Op elk moment is het **effectieve limiet** de `limitKw` van het
**profiel met de hoogste prioriteit waarvan het tijdvenster momenteel actief
is** (`startTime <= now < endTime`).

Als er geen profiel op dit moment actief is:

* **Locaties** vallen terug op `permanentLimitKw` (ingesteld via
  `PUT /locations/{locationId}/limit`).
* **Laadpunten** hebben geen terugvaloptie: buiten een actief tijdvenster is
  de connector niet prioriteitsvergrendeld en wordt deze beheerd door normaal
  laadmanagement.

## Automatisch toepassen/terugdraaien

Profielen worden automatisch toegepast en teruggedraaid op hun
`startTime`/`endTime`. Er zijn **geen verdere API-aanroepen nodig** zodra een
profiel is aangemaakt.

Profielrecords worden **nooit verwijderd** wanneer ze verlopen, dus de
volledige geschiedenis van profielen blijft opvraagbaar via
`GET /locations/{locationId}/limits` en `GET /organizations/limits`.

## Statuswaarden

Elk profiel rapporteert een berekende `status`:

| Status | Betekenis |
| - | - |
| `SCHEDULED` | `now < startTime`, nog niet actief |
| `ACTIVE` | `startTime <= now < endTime` |
| `EXPIRED` | `now >= endTime` |

## Vergrendelingen op laadpuntniveau

`POST /chargers/{controllerUuid}/connectors/{connectorId}/schedules` maakt
een profiel voor één connector aan. Terwijl **ACTIVE**, is de connector
prioriteitsvergrendeld: deze is uitgesloten van normaal laadmanagement en
draait onbeperkt tot `limitKw`. Alleen als laatste redmiddel wordt deze
gethrottled (nooit onder zijn minimum van 6A) als de locatie als geheel
boven de netlimiet zit.

## Clusters

Een [cluster](/nl/api-reference/energy-management/apply-cluster-schedule)
groepeert meerdere locaties onder één optioneel kW-plafond. Wanneer het
gecombineerde verbruik van het cluster `limitKw` zou overschrijden, wordt het
effectieve limiet van elke lidlocatie proportioneel verlaagd:

```
scale = min(1, clusterLimitKw / sum(memberLocationLimits))
locationEffectiveLimit = locationSetLimitKw * scale
```

`POST /clusters/{clusterId}/schedules` past één `LimitProfileRequest` toe op
alle locaties in het cluster tegelijk.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.