Validates and updates the editable grid code fields provided in the request body. Fields omitted from the request are left unchanged.
Updates editable grid code parameters and settings for the charger identified by evseId.
This is a partial update: included fields are changed, omitted or null fields stay unchanged.
Rules:
-
evseId must use format NOZAPE<serial>, for example NOZAPEZPR000090.
-
At least one editable field must be provided.
-
GET metadata contains all known fields; fields with editable: false are read-only for PUT.
-
Unknown, read-only, out-of-range, and invalid-step fields return 400.
-
Do not PUT a full GET response back unchanged; remove read-only fields first.
Example request
{
"fuse_limit": 32,
"dso_max_export_limit": 16,
"grid_code_settings": {
"v_min_normal": 0.85,
"f_min_normal": 49.0,
"threshold_over_frequency": 50.2
}
}
Validation examples
Valid examples:
-
f_min_normal: 49.0
-
max_under_frequency: 49.8
-
under_frequency2_time: 0.1
-
restore_time_after_fault_rt: 60
Invalid examples:
-
max_under_frequency: 49.85 - because the step is 0.1
-
under_frequency2_time: 0.05 - because the minimum is 0.1
-
under_frequency2_time: 5.1 - because the maximum is 5.0
-
restore_time_after_fault_rt: 60.5 - because it is an integer field
-
f_max_normal - because it is returned by GET but is read-only for PUT
Error response example
{
"type": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
"title": "One or more validation errors occurred.",
"status": 400,
"errors": {
"grid_code_settings.max_under_frequency": [
"Field must use a step of 0.1."
]
}
}
Editable top-level parameters
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| country_code (string) | - | - | - | - | - |
| fuse_limit (integer) | - | 0 to 1000 | - | - | - |
| dso_max_export_limit (integer) | - | 0 to 1000 | - | - | - |
Editable grid code settings
Normal operating range
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| v_min_normal (decimal) | 0.85 | 0 to 2 | 0.01 | pu (Unom) | Minimum voltage level for continuous operation |
| v_max_normal (decimal) | 1.1 | 0 to 2 | 0.01 | pu (Unom) | Maximum voltage level for continuous operation |
| f_min_normal (decimal) | 49.0 | 40 to 60 | 0.1 | Hz | Minimum frequency for continuous operation |
Ride-through
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| min_rt_u_for_0a (decimal) | 0.5 | 0 to 2 | 0.01 | pu | Zero current mode for converter connected generating technology during under-voltage ride through |
| max_rt_u_for_0a (decimal) | 1.2 | 0 to 2 | 0.01 | pu | Zero current mode for converter connected generating technology during over-voltage ride through |
| restore_time_after_fault_rt (integer) | 60 | 0 to 600 | 1 | s | Maximum time to reach pre-fault current per phase after ride through |
| under_frequency2_time (decimal) | 0.1 | 0.1 to 5.0 | 0.1 | s | Minimum operation period when the frequency is between 47 to 47.5 Hz |
| under_frequency1_time (integer) | 30 | 0 to 120 | 1 | min | Minimum operation period when the frequency is between 47.5 to 49 Hz |
| rocof_normal (decimal) | 2 | 0 to 5 | 0.1 | Hz/s | RoCoF withstand capability in Hz/s |
| rocof_trip_time (decimal) | 0.2 | 0 to 5 | 0.1 | s | The time to disconnect the unit for values higher than RoCoF withstand |
| rocof_measurement_time (decimal) | 0.5 | 0 to 5 | 0.1 | s | Sliding window for RoCoF calculation |
Protection
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| threshold_over_voltage1_fault (decimal) | 1.1 | 0 to 2 | 0.01 | pu (Vnom) | Over voltage stage 1 threshold |
| threshold_over_voltage2_fault (decimal) | 1.15 | 0 to 2 | 0.01 | pu (Vnom) | Over voltage stage 2 threshold |
| threshold_under_voltage_fault (decimal) | 0.85 | 0 to 2 | 0.01 | pu (Vnom) | Under voltage threshold |
| time_over_voltage1_fault (decimal) | 0.2 | 0 to 5 | 0.1 | s | Over voltage stage 1 disconnection time |
| observation_time_over_voltage1_fault (integer) | 600 | 0 to 1000 | 1 | s | Over voltage stage 1 observation time (10 min mean value) |
| time_over_voltage2_fault (decimal) | 0.2 | 0 to 5 | 0.1 | s | Over voltage threshold stage 2 disconnection time |
| time_under_voltage_fault (decimal) | 0.2 | 0 to 5 | 0.1 | s | Under voltage threshold disconnection time |
| threshold_over_frequency_fault (decimal) | 51.5 | 40 to 60 | 0.1 | Hz | Over frequency threshold |
| threshold_under_frequency1_fault (decimal) | 47.5 | 40 to 60 | 0.1 | Hz | Under frequency stage 1 threshold |
| time_over_frequency_fault (decimal) | 0.2 | 0 to 5 | 0.1 | s | Over frequency disconnection time |
| time_under_frequency1_fault (decimal) | 0.2 | 0 to 5 | 0.1 | s | Under frequency stage 1 disconnection time |
| rocof_anti_islanding (decimal) | 2.5 | 0 to 5 | 0.1 | Hz/s | RoCoF anti-islanding threshold in Hz/s |
| measurement_time_rocof_anti_islanding (decimal) | 0.5 | 0 to 5 | 0.1 | s | RoCoF sliding measurement window |
Automatic reconnection
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| lower_frequency_reconnect (decimal) | 49.5 | 40 to 60 | 0.1 | Hz | Minimum frequency for automatic reconnection |
| upper_frequency_reconnect (decimal) | 50.2 | 40 to 60 | 0.1 | Hz | Maximum frequency for automatic reconnection |
| lower_voltage_reconnect (decimal) | 0.85 | 0 to 2 | 0.01 | pu (Vnom) | Minimum voltage for automatic reconnection |
| upper_voltage_reconnect (decimal) | 1.1 | 0 to 2 | 0.01 | pu (Vnom) | Maximum voltage for automatic reconnection |
| obs_time (integer) | 60 | 0 to 1000 | 1 | s | Observation time before allowing reconnection after the parameters fall within the allowed range for reconnection |
| active_power_gradient_reconnect (integer) | 10 | 0 to 100 | 1 | %Pmax/min | Maximum increase of the active power output after automatic reconnection |
Active power response to over-frequency (LFSM-O)
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| threshold_over_frequency (decimal) | 50.2 | 40 to 60 | 0.1 | Hz | At this frequency the active power response to over frequency is activated |
| droop_over_frequency (integer) | 5 | 0 to 100 | 1 | % | Programmable droop is the frequency-dependent active power feed-in |
Active power response to under-frequency (LFSM-U)
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| threshold_under_frequency (decimal) | 49.8 | 40 to 60 | 0.1 | Hz | Active power response to under frequency is activated at this frequency |
| min_under_frequency (decimal) | 46.0 | 40 to 60 | 0.1 | Hz | Minimum value of the under frequency threshold |
| max_under_frequency (decimal) | 49.8 | 40 to 60 | 0.1 | Hz | Maximum value of the under frequency threshold |
| droop_under_frequency (integer) | 5 | 0 to 100 | 1 | % | Programmable droop is the frequency-dependent active power feed-in |
Active power response to overvoltage
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| enable_p_red_ov (boolean) | - | - | - | - | Enable automatic active power reduction during over voltage |
Reactive power control
| Field | Default | Range | Step | Unit | Description |
|---|---|---|---|---|---|
| control_mode (integer) | 1 | 1 to 4 | 1 | - | (1=Q setpoint, 2= Cos setpoint, 3= Q(U), 4= Cos(P)) |
| q_set (decimal) | 0.484 | 0 to 10 | 0.001 | +/-P kVAr | Reactive power control - Q setpoint |
| pf_set (decimal) | 0.9 | 0 to 1 | 0.1 | +/-PF | Reactive power control - Power factor (cos phi) setpoint |
| qu1 (decimal) | - | 0 to 2 | 0.01 | pu | Reactive power control - Q as a function of U characteristics curve value 1 |
| q_at_qu1 (decimal) | - | -10 to 10 | 0.1 | kVAr | Reactive power control - Q as a function of U characteristics curve value 1 |
| qu2 (decimal) | - | 0 to 2 | 0.01 | pu | Reactive power control - Q as a function of U characteristics curve value 2 |
| q_at_qu2 (decimal) | - | -10 to 10 | 0.1 | kVAr | Reactive power control - Q as a function of U characteristics curve value 2 |
| qu3 (decimal) | - | 0 to 2 | 0.01 | pu | Reactive power control - Q as a function of U characteristics curve value 3 |
| q_at_qu3 (decimal) | - | -10 to 10 | 0.01 | kVAr | Reactive power control - Q as a function of U characteristics curve value 3 |
| qu4 (decimal) | - | 0 to 2 | 0.01 | pu | Reactive power control - Q as a function of U characteristics curve value 4 |
| q_at_qu4 (decimal) | - | -10 to 10 | 0.1 | kVAr | Reactive power control - Q as a function of U characteristics curve value 4 |
| qu_lockin (integer) | 10 | 0 to 100 | 1 | %Pn | QU mode Lockin (active Q support threshold) |
| qu_lockout (integer) | 9 | 0 to 100 | 1 | %Pn | QU mode Lockout (Pause Q support threshold) |
| q_time_constant (decimal) | - | 0 to 100 | 1 | s | Qu mode Q ramp rate |
| pfp1 (integer) | - | 0 to 100 | 1 | %Pn | Reactive power control - cos phi (P) characteristics curve value 1 |
| pf_at_p1 (decimal) | - | -1 to 1 | 0.1 | PF | Reactive power control - cos phi (P) characteristics curve value 1 |
| pfp2 (integer) | - | 0 to 100 | 1 | %Pn | Reactive power control - cos phi (P) characteristics curve value 2 |
| pf_at_p2 (decimal) | - | -1 to 1 | 0.1 | PF | Reactive power control - cos phi (P) characteristics curve value 2 |
| pfp3 (integer) | - | 0 to 100 | 1 | %Pn | Reactive power control - cos phi (P) characteristics curve value 3 |
| pf_at_p3 (decimal) | - | -1 to 1 | 0.1 | PF | Reactive power control - cos phi (P) characteristics curve value 3 |
| pfp_lockin (decimal) | - | 0 to 2 | 0.01 | pu | PFP mode Lockin (active Q support threshold) |
| pfp_lockout (decimal) | - | 0 to 2 | 0.01 | pu | PFP mode Lockout (Pause Q support threshold) |
Request
- Base URLhttp://integrations.api.prod.zaptec.com
- URLhttp://integrations.api.prod.zaptec.com/grid-code
- AuthHTTP bearer
Query parameters
The EVSE ID identifying the charger. Format: NOZAPE<serial>, e.g. NOZAPEZPR000090.
Request body
Response
OK
Changes
No recorded changes to this operation across all 1 revision of this API.