Supported OCPP1.6J cloud commands
Zaptec chargers support a range of OCPP 1.6J commands, designed for reliability and clarity. In some cases, we have streamlined certain processes these adjustments are noted where relevant.
Unless otherwise stated, references to the OCPP 1.6J specification relate to the ‘Open Charge Point Protocol 1.6J edition 2 Final’ documentation.
Operations initiated by the charge point
| Command | OCPP 1.6 Reference | Notes |
|---|---|---|
| Authorize | 4.1 | Standard authorisation process. |
| Boot notification | 4.2 | Notifies central system when the charger boots. |
| Heartbeat | 4.6 | Regular signal to confirm charger is online. |
| Meter values | 4.7 | By default, sent every two minutes during an active transaction. Interval adjustable via config key. |
| Start transaction | 4.8 | Initiates a charging session. |
| Stop transaction | 4.10 | Ends a charging session. |
| Status notification | 4.9 | Reports charger status changes. |
Supported meter value measurements:
| Measurand | Phase | Unit |
|---|---|---|
| Power.Active.Import | - | W |
| Energy.Active.Import.Register | - | kWh |
| Power.Offered | - | W |
| Current.Import | L1-N | A |
| Current.Import | L2-N | A |
| Current.Import | L3-N | A |
- MeterValueSampleInterval: Set to
0to disable meter values.
Operations initiated by the central system
| Command | OCPP 1.6 J Reference | Notes |
|---|---|---|
| Change availability | 5.2 | Sets charger as available or unavailable. |
| Change configuration | 5.3 | Updates charger configuration parameters. |
| Clear cache | 5.4 | Clears local authorisation cache. |
| Get configuration | 5.8 | Retrieves current configuration from the charger. |
| Remote start transaction | 5.11 | Starts a transaction remotely. IdTag times out after 120 seconds. |
| Remote stop transaction | 5.12 | Stops a transaction remotely. |
| Reset | 5.14 | Resets the charger. |
| Unlock connector | 5.18 | Provided but non-functional; returns UnlockStatus.NotSupported. |
| Get diagnostics | 5.9 | Uploads predefined observation values to specified FTP or HTTP POST location. |
| Update firmware | 5.19 | Firmware always downloaded from ZapCloud. Location, RetrieveDate, and Retries are ignored. |
| Send local list | 5.15 | Sends a list of local authorisation entries. |
| Get local list version | 5.10 | Retrieves the version of the local list. |
| Reserve now | 5.13 | Reserves a connector. More details |
| Trigger message | 5.17 | Requests the charger to send a specific message. |
Custom configuration keys
Zaptec chargers support the following custom OCPP configuration keys:
| Config key | Description |
|---|---|
| FreeCharging | When enabled, skips the Authorize call before starting a transaction and proceeds directly to StartTransaction. The StartTransaction’s idTag is set to an empty string or the configured default idTag. |
| FreeChargingIdTag | The idTag to use in free charging mode. Set via Zaptec Portal or this key. |
| LockCablePermanently | When enabled, the connected cable remains locked to the charging station until disabled or unlocked in the Zaptec Portal or app. |
Configuration keys returned by GetConfiguration
Zaptec chargers return a set of configuration keys through the GetConfiguration command. Some keys are required, some are read-only, and others are optional or configurable.
Supported config keys
| Config key | Value | Read only | Mandatory |
|---|---|---|---|
| NumberOfConnectors | 1 | ✅ | ✅ |
| SupportedFeatureProfiles | Core | ✅ | ✅ |
| WebSocketPingInterval | 0 | ❌ | ❌ |
| AuthorizeRemoteTxRequests | true | ❌ | ❌ |
| StopTransactionOnEVSideDisconnect | true | ✅ | ❌ |
| StopTransactionOnInvalidId | true | ✅ | ❌ |
| MeterValueSampleInterval | 180 | ❌ | ❌ |
| MeterValuesSampledData | Energy.Active.Import.Register, Current.Import, Energy. | ✅ | ❌ |
| HeartbeatInterval | 240 | ❌ | ✅ |
| ChargeProfileMaxStackLevel | 1 | ✅ | ❌ |
| ChargingScheduleAllowedChargingRateUnit | Current | ✅ | ❌ |
| ChargingScheduleMaxPeriods | 1 | ✅ | ❌ |
| MaxChargingProfilesInstalled | 1 | ✅ | ❌ |
| LocalPreAuthorize | false | ✅ | ❌ |
| LocalAuthorizeOffline | true | ✅ | ❌ |
| SendLocalListMaxLength | 1750 | ✅ | ❌ |
| FreeCharging | false | ❌ | ❌ |
| FreeChargingIdTag | FFFFFFFF | ❌ | ❌ |
| LockCablePermanently | false (sometimes true, depending on config) | ❌ | ❌ |
| ConnectionTimeOut | 10 | ✅ | ❌ |
| AuthorisationTimeout | Configurable | ❌ | ❌ |
Unsupported config keys
The following configuration keys are not supported in OCPP1.6J cloud offering but are available in OCPP1.6J (Box-level offering)
| Config key | Note |
|---|---|
| Autocharge | Not supported |
| AutochargeEnabled | Not supported |
| AllowedAuthenticationMethods | Not supported |
| ISO15118PnCEnabled | Not supported |
| StopTxnAlignedData | Not supported |
| StopTxnSampledData | Not supported |
| MinimumStatusDuration | Not supported |
| MeterValuesAlignedData | Not supported |
| GetConfigurationMaxKeys | Not supported |
| ClockAlignedDataInterval | Not supported |
| AuthorizationCacheEnabled | Not supported |
| AllowOfflineTxForUnknownId | Not supported |
| UnlockConnectorOnEVSideDisconnect | Not supported |
Updated about 6 hours ago