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 authorization 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 0 to 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	True if authentication is not required on the installation or if authentication is disabled on the charger; false otherwise	❌	❌
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.

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