Grid codes

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

FieldDefaultRangeStepUnitDescription
country_code (string)-----
fuse_limit (integer)-0 to 1000---
dso_max_export_limit (integer)-0 to 1000---

Editable grid code settings


Normal operating range

FieldDefaultRangeStepUnitDescription
v_min_normal (decimal)0.850 to 20.01pu (Unom)Minimum voltage level for continuous operation
v_max_normal (decimal)1.10 to 20.01pu (Unom)Maximum voltage level for continuous operation
f_min_normal (decimal)49.040 to 600.1HzMinimum frequency for continuous operation

Ride-through

FieldDefaultRangeStepUnitDescription
min_rt_u_for_0a (decimal)0.50 to 20.01puZero current mode for converter connected generating technology during under-voltage ride through
max_rt_u_for_0a (decimal)1.20 to 20.01puZero current mode for converter connected generating technology during over-voltage ride through
restore_time_after_fault_rt (integer)600 to 6001sMaximum time to reach pre-fault current per phase after ride through
under_frequency2_time (decimal)0.10.1 to 5.00.1sMinimum operation period when the frequency is between 47 to 47.5 Hz
under_frequency1_time (integer)300 to 1201minMinimum operation period when the frequency is between 47.5 to 49 Hz
rocof_normal (decimal)20 to 50.1Hz/sRoCoF withstand capability in Hz/s
rocof_trip_time (decimal)0.20 to 50.1sThe time to disconnect the unit for values higher than RoCoF withstand
rocof_measurement_time (decimal)0.50 to 50.1sSliding window for RoCoF calculation

Protection

FieldDefaultRangeStepUnitDescription
threshold_over_voltage1_fault (decimal)1.10 to 20.01pu (Vnom)Over voltage stage 1 threshold
threshold_over_voltage2_fault (decimal)1.150 to 20.01pu (Vnom)Over voltage stage 2 threshold
threshold_under_voltage_fault (decimal)0.850 to 20.01pu (Vnom)Under voltage threshold
time_over_voltage1_fault (decimal)0.20 to 50.1sOver voltage stage 1 disconnection time
observation_time_over_voltage1_fault (integer)6000 to 10001sOver voltage stage 1 observation time (10 min mean value)
time_over_voltage2_fault (decimal)0.20 to 50.1sOver voltage threshold stage 2 disconnection time
time_under_voltage_fault (decimal)0.20 to 50.1sUnder voltage threshold disconnection time
threshold_over_frequency_fault (decimal)51.540 to 600.1HzOver frequency threshold
threshold_under_frequency1_fault (decimal)47.540 to 600.1HzUnder frequency stage 1 threshold
time_over_frequency_fault (decimal)0.20 to 50.1sOver frequency disconnection time
time_under_frequency1_fault (decimal)0.20 to 50.1sUnder frequency stage 1 disconnection time
rocof_anti_islanding (decimal)2.50 to 50.1Hz/sRoCoF anti-islanding threshold in Hz/s
measurement_time_rocof_anti_islanding (decimal)0.50 to 50.1sRoCoF sliding measurement window

Automatic reconnection

FieldDefaultRangeStepUnitDescription
lower_frequency_reconnect (decimal)49.540 to 600.1HzMinimum frequency for automatic reconnection
upper_frequency_reconnect (decimal)50.240 to 600.1HzMaximum frequency for automatic reconnection
lower_voltage_reconnect (decimal)0.850 to 20.01pu (Vnom)Minimum voltage for automatic reconnection
upper_voltage_reconnect (decimal)1.10 to 20.01pu (Vnom)Maximum voltage for automatic reconnection
obs_time (integer)600 to 10001sObservation time before allowing reconnection after the parameters fall within the allowed range for reconnection
active_power_gradient_reconnect (integer)100 to 1001%Pmax/minMaximum increase of the active power output after automatic reconnection

Active power response to over-frequency (LFSM-O)

FieldDefaultRangeStepUnitDescription
threshold_over_frequency (decimal)50.240 to 600.1HzAt this frequency the active power response to over frequency is activated
droop_over_frequency (integer)50 to 1001%Programmable droop is the frequency-dependent active power feed-in

Active power response to under-frequency (LFSM-U)

FieldDefaultRangeStepUnitDescription
threshold_under_frequency (decimal)49.840 to 600.1HzActive power response to under frequency is activated at this frequency
min_under_frequency (decimal)46.040 to 600.1HzMinimum value of the under frequency threshold
max_under_frequency (decimal)49.840 to 600.1HzMaximum value of the under frequency threshold
droop_under_frequency (integer)50 to 1001%Programmable droop is the frequency-dependent active power feed-in

Active power response to overvoltage

FieldDefaultRangeStepUnitDescription
enable_p_red_ov (boolean)----Enable automatic active power reduction during over voltage

Reactive power control

FieldDefaultRangeStepUnitDescription
control_mode (integer)11 to 41-(1=Q setpoint, 2= Cos setpoint, 3= Q(U), 4= Cos(P))
q_set (decimal)0.4840 to 100.001+/-P kVArReactive power control - Q setpoint
pf_set (decimal)0.90 to 10.1+/-PFReactive power control - Power factor (cos phi) setpoint
qu1 (decimal)-0 to 20.01puReactive power control - Q as a function of U characteristics curve value 1
q_at_qu1 (decimal)--10 to 100.1kVArReactive power control - Q as a function of U characteristics curve value 1
qu2 (decimal)-0 to 20.01puReactive power control - Q as a function of U characteristics curve value 2
q_at_qu2 (decimal)--10 to 100.1kVArReactive power control - Q as a function of U characteristics curve value 2
qu3 (decimal)-0 to 20.01puReactive power control - Q as a function of U characteristics curve value 3
q_at_qu3 (decimal)--10 to 100.01kVArReactive power control - Q as a function of U characteristics curve value 3
qu4 (decimal)-0 to 20.01puReactive power control - Q as a function of U characteristics curve value 4
q_at_qu4 (decimal)--10 to 100.1kVArReactive power control - Q as a function of U characteristics curve value 4
qu_lockin (integer)100 to 1001%PnQU mode Lockin (active Q support threshold)
qu_lockout (integer)90 to 1001%PnQU mode Lockout (Pause Q support threshold)
q_time_constant (decimal)-0 to 1001sQu mode Q ramp rate
pfp1 (integer)-0 to 1001%PnReactive power control - cos phi (P) characteristics curve value 1
pf_at_p1 (decimal)--1 to 10.1PFReactive power control - cos phi (P) characteristics curve value 1
pfp2 (integer)-0 to 1001%PnReactive power control - cos phi (P) characteristics curve value 2
pf_at_p2 (decimal)--1 to 10.1PFReactive power control - cos phi (P) characteristics curve value 2
pfp3 (integer)-0 to 1001%PnReactive power control - cos phi (P) characteristics curve value 3
pf_at_p3 (decimal)--1 to 10.1PFReactive power control - cos phi (P) characteristics curve value 3
pfp_lockin (decimal)-0 to 20.01puPFP mode Lockin (active Q support threshold)
pfp_lockout (decimal)-0 to 20.01puPFP mode Lockout (Pause Q support threshold)
put/grid-code

Request

  • Base URL
    http://integrations.api.prod.zaptec.com
  • URL
    http://integrations.api.prod.zaptec.com/grid-code
  • Auth
    HTTP bearer

Query parameters

evseIdstring

The EVSE ID identifying the charger. Format: NOZAPE<serial>, e.g. NOZAPEZPR000090.

Request body

country_codestring nullable

Country Code.

Response

OK

country_codestring
evse_service_unavailableboolean
enable_specific_startup_modeboolean
enable_startup_function_for_all_servicesboolean

Changes

No recorded changes to this operation across all 1 revision of this API.