Zaptec Go OCPP Native configuration

Getting OCPP Native Permission

To use the OCPP Native feature, you must have the necessary permissions in the Zaptec Portal:

1. Log in to the Zaptec Portal.
2. Navigate to User Groups and select your company’s group.
3. Check if Allow OCPP Native is enabled. If it is, you have the required permissions. If not, contact your Zaptec sales representative to request access for your organization or User Group.

📘

Membership in this User Group determines who can enable OCPP Native. You may consider creating a separate group or requesting permission for your existing group.

---

Getting OCPP Native Firmware

To enable OCPP Native, ensure your charger has firmware version 2.4.0.2 or higher:

• Update the firmware via the Zaptec app or Zaptec Portal. If no updates are available, contact Zaptec Support.
• If your firmware version is below 2.4.0.2, submit a support ticket with your charger’s serial number(s) requesting OCPP Native-capable firmware.
• Once the support ticket is resolved, check for firmware updates and apply them.

After updating, OCPP Native is supported, and you can proceed with the setup.

---

Setting Up a New OCPP Native Installation (Recommended)

For new installations, follow these steps:

1. In the Zaptec Portal, go to Installations and click + Add installation.

2. Choose OCPP Native as the installation type.

3. Enter installation details, including the OCPP central system URL, following these rules:

• The URL must begin with ws:// or wss://.

• Maximum URL length: 2038 characters.

• The connection port is optional. If omitted, the default ports are 80 (ws://) and 443 (wss://).

• Do not include the charger serial number in the URL; it will be automatically appended in uppercase.

ℹ️

Example:

If the required OCPP URL is wss://myserver.com:80/ocpp/ZAP123456, where ZAP123456 is the charger’s serial number, enter wss://myserver.com:80/ocpp in the OCPP central system URL field.

✅

Recommended:

While OCPP Native supports both WS and WSS, Zaptec recommends using WSS for ensuring authenticity and confidentiality during communication between Charge Point and Central System, in accordance with SS:EN 18031-1:2024.

4. Save the installation (Note: Limited to 3 chargers, 32A max).
5. Under Circuits, click + Add circuit and enter the circuit details.
6. Click + Add charger, enter the charger details (serial number), and activate.
7. A green OCPP symbol confirms a successful connection.

---

Activating OCPP Native on an Existing Installation (Alternative)

Before enabling OCPP Native mode on an existing installation, OCPP Native permission must be granted in the Zaptec app or Zaptec Portal by the installation owner.

Granting Partner Access

1. Request a partner lookup key (four characters) from your OCPP provider.

2. The OCPP provider can find this key under their User Group with Allow OCPP Native permission.

3. Use the Zaptec Portal or App to grant access:

   In the Zaptec Portal:

   • Go to Installations > Permissions > Give Permission.
   • Select Partner, enter the lookup key, and confirm Service access.
   
   

   In the Zaptec App:

   • Open the app and go to Installations.
   • Tap Access > Add Access.
   • Select Partner, enter the lookup key, and confirm Service access.
   
   

Enabling OCPP Native Mode

1. In the Zaptec Portal, open the Installation.
2. Ensure chargers are online and no active charging sessions are running.
3. Navigate to Settings > Details > Type, and change the installation type from Home to OCPP Native.

4. Enter the OCPP central system URL (follow the same rules as in the new installation setup below).

• The URL must begin with ws:// or wss://
• The maximum URL length is 2038 characters
• The connection port can be optionally specified. If omitted, the connection port will be 80 (for ws://) and 443 (for wss://)
• Do not specify the serial number in the URL; the serial number of the charger will be automatically appended to the connection URL in uppercase

ℹ️

Example:

If the required OCPP URL is; wss://myserver.com:80/ocpp/ZAP123456 where ZAP123456 is the charger serial number, enter wss://myserver.com:80/ocpp (without a trailing /) in the OCPP central system URL field. The charger will then connect to the OCPP central system with the full URL(including the serial number in upper case).

5. Click Save.

📘

If you encounter an error, it means that OCPP Native permission has not been applied to the installation. The installation owner must grant this permission before enabling OCPP Native.

Once saved, OCPP Native is activated on the chargers in the installation. Note that this installation type is limited to 3 chargers, 32A maximum.

A successful connection is indicated by a green OCPP symbol on the charger icon and charging station pages.

---

Identifying OCPP Native Mode

You can verify if your charger is in OCPP Native mode by checking the OCPP boot notification message:

• OCPP Native mode: "chargePointModel": "Zaptec Go OCPP"
• OCPP Cloud mode: "chargePointModel": "Zaptec Go"

---

Troubleshooting Unsuccessful Connections

Red OCPP Symbol & Warning Message

If the connection fails:

• Check your OCPP URL for errors.
• Verify your network connection.
• Ensure your firmware version supports OCPP Native.

If the charger doesn’t support OCPP Native, you’ll see a red OCPP symbol and a warning message.

Disabling OCPP Native Mode

To disable OCPP Native mode:

1. In the Zaptec Portal, go to the Installation.
2. Ensure all chargers are online.
3. Navigate to Settings > Details > Type and change it back to Home.
4. Click Save.

After disabling OCPP Native mode, chargers will switch to Stand-alone mode. To re-enable Zaptec power management and authentication, go to Circuits > Charger > Settings and turn off Stand-alone mode.

---

This guide ensures a smooth setup and management of OCPP Native on your Zaptec Go chargers. For further assistance, contact Zaptec Support.