Bulk Operations

Document information	Value
Version	2.0
Prepared for	HIEV CPMS administrators and operations teams
Interface verified	September 2026
Product area	Bulk Operations
Scope	Location Management, Station Management, OCPP Action Center, and template-based bulk additions

1. Purpose

The Bulk Operations module allows an authorized user to apply the same change or command to multiple locations, stations, or OCPP charge points in one operation. It also supports adding multiple locations or stations through an XLSX template.

Use this module when a change must be made consistently across many records. For a one-off correction, use the applicable Location or Station details screen instead.

Important: A bulk operation can affect every selected target. Verify the business tenant, target count, parameter values, active charging sessions, and operational impact before selecting Update or Perform Action.

2. Main workflows

The module provides operation categories via the left sidebar and top-level action tabs:

1. Location Management — Provides Update (bulk parameter updates) and Add (bulk template upload) modes.
2. Station Management — Provides Update (bulk parameter updates) and Add (bulk template upload) modes.
3. OCPP Action Center — Directly sends remote OCPP commands to selected charge points (does not use Add/Update tabs).

Workflow Summary:

• Location & Station Update — Modify parameters across existing locations or stations.
• Location & Station Add — Bulk-create locations or stations using an XLSX template.
• OCPP Action Center — Directly dispatch remote commands (Change Availability, Reset Station, Get Configuration, Change Configuration, Trigger Messages) to selected Charge Point IDs.

The verified Update types are:

1. Location Management
2. Station Management

The verified Add types are:

1. Location Management
2. Station Management

3. Roles and prerequisites

Before performing a bulk operation, confirm that:

• You are signed in to the correct HIEV business tenant.
• Your role includes the required Bulk Operations, Location, Station, or OCPP permissions.
• The intended locations, stations, or charge point IDs already exist when using Update.
• The proposed value has been approved by the responsible operations, finance, or compliance owner.
• No target is in an incompatible state, such as an active charging session before a disruptive reset or availability change.
• You understand whether the operation replaces an existing value, clears it, or appends data.

4. Screen overview

4.1 Update tab

The general Update flow is:

1. Select the operational category from the left menu (Location Management, Station Management, or OCPP Action Center).
2. Select Update (for Location or Station management).
3. Select one or more targets using the hierarchical target selector.
4. Select the parameters or station action.
5. Enter or configure the value for every selected parameter.
6. Review the target count and proposed values.
7. Select Update or Perform Action.
8. Verify the result on representative targets and review any failed records.

4.2 Add tab

The Add workflow uses a downloaded template:

1. Select Add.
2. Choose Location Management or Station Management.
3. Select Download Template.
4. Populate the template without renaming, deleting, or reordering required columns.
5. Save the file in .xlsx format.
6. Confirm the file is smaller than 2 MB.
7. Confirm the file contains no more than 50 entries.
8. Select Upload file (or Upload File) and choose the completed workbook.
9. Review validation results and correct rejected rows.
10. Verify that all successful records were created with the intended values.

Template limits verified in the live interface: XLSX format, file size below 2 MB, and a maximum of 50 entries per upload.

5. Target selection

5.1 Selecting locations

The location selector is hierarchical. Expand the country and province or region, then select one or more locations.

1. Choose Location Management.
2. Select Select Location(s)*.
3. Expand the location hierarchy (e.g., Canada (32) $\rightarrow$ Ontario (14)).
4. Select the required parent node or individual locations.
5. Review the Locations Selected count (e.g., "14 Locations Selected").
6. Select Done.

The parameter controls remain unavailable until at least one location is selected.

5.2 Selecting stations

The station selector provides a hierarchy and a Search Stations field.

1. Choose Station Management.
2. Select Select Station(s)*.
3. Search for a known station or expand the province, city, location, and station hierarchy.
4. Select the required stations.
5. Review the selected count (e.g., "17 Stations").
6. Select Done.

5.3 Selecting OCPP charge points

The OCPP selector provides a hierarchy and a Search Charge Point ID(s) field.

1. Choose OCPP Action Center.
2. Select Select Charge Point ID(s)*.
3. Search for known identifiers or expand the location hierarchy.
4. Select the required charge point IDs.
5. Review the selected count (e.g., "2 Charge Point IDs" or "8 Charge Point IDs").
6. Select Done.

6. Location Management

Use Location Management to apply common location settings to all selected locations.

6.1 Perform a location update

1. Select Update.
2. Choose Location Management.
3. Select the target locations via Select Location(s)*.
4. Open Location Update Parameters dropdown.
5. Select one or more parameters, or use Select all only when every displayed field must be changed.
6. Enter a valid value for every selected parameter.
7. Review the values and selected-location count.
8. Select Update (or Reset All Parameters to clear form values).
9. Open representative Location records and verify the result.

6.2 Location update parameters

Parameter	Description and guidance	Interface status
Payment Type*	Sets the location payment model. The verified choices are Prepaid and Postpaid. Confirm the change with finance before applying it. Validation error when empty: "Payment Type cannot be empty".	Verified
Contact Email*	Replaces the location contact email. Use a monitored and correctly formatted address. Validation error when empty: "Contact Email cannot be empty".	Verified
Facilities	Selects the facilities available at the locations. Features a Set Empty link to deliberately clear the field across all selected locations. Validation error: "Facilities must have at least one value selected or set to empty".	Verified
Timings	Updates operating hours or timing information from the dropdown. Validation error when empty: "Timings cannot be empty".	Verified
Contact Number*	Replaces the location contact number, including the country code prefix (e.g., +1). Validation error when empty: "Contact Number cannot be empty".	Verified
Notes	Updates location notes textarea. Features a Set Empty link to deliberately clear notes across all selected locations. Validation error: "Notes has to be a valid string or set to empty".	Verified
Private	Switch toggle controlling private-location behavior.	Verified
Public View	Switch toggle controlling whether the location is shown in the public-facing mobile app and web portal.	Verified
Reservable	Switch toggle controlling whether charging reservations are permitted at the location.	Verified
DSM	Switch toggle controlling Demand Side Management (DSM) / Demand Response participation.	Verified

Caution: Set Empty deliberately removes the existing value from every selected location. Do not use it as a substitute for leaving a parameter unchanged.

6.3 Location use cases

• Change several locations from prepaid to postpaid after finance approval.
• Correct a shared contact email or phone number.
• Assign the same manager to a portfolio of locations.
• Enable or disable reservations across a region.
• Enable Demand Side Management (DSM) participation across selected operational sites.
• Update operating timings after a seasonal schedule change.
• Change private or public visibility for a controlled rollout.
• Apply a corrected GST IN to locations under the same legal entity.

7. Station Management

Use Station Management to apply configuration or operational settings to selected stations.

7.1 Perform a station update

1. Select Update.
2. Choose Station Management.
3. Select the target stations via Select Station(s)*.
4. Open Station Update Parameters dropdown.
5. Select one or more parameters.
6. Enter or select a value for every chosen parameter.
7. Review compatibility and operational impact.
8. Select Update (or Reset All Parameters to clear form inputs).
9. Refresh the affected Station records and verify the result.

7.2 Station update parameters

Parameter	Description and guidance	Interface status
Minimum Balance*	Sets the parent/customer balance threshold used by station charging controls. Enter the approved numeric amount. Validation error when empty: "Minimum Balance cannot be empty".	Verified
Security Profile*	Applies the approved station security profile from the dropdown. Validation error when empty: "Security Profile cannot be empty".	Verified
Make*	Selects the station manufacturer from the dropdown. Validation error when empty: "Make cannot be empty".	Verified
Model*	Selects the station model from the dropdown, dynamically filtered by chosen Make. Validation error when empty: "Model cannot be empty".	Verified
Station State*	Sets the operational lifecycle state of the selected stations from the dropdown. Validation error when empty: "Station State cannot be empty".	Verified
Ration Duration	Checkbox toggle that enables rationing duration with a required time input field (hh:mm). Validation error: "Ration Duration should not be empty/invalid".	Verified
Auto Stop Charging	Checkbox toggle that stops charging automatically when the relevant user/parent wallet falls below the configured minimum balance.	Verified

7.3 Station update precautions

• Do not change Make or Model merely to correct a display label; the values drive hardware compatibility logic.
• Do not change Station State while a conflicting operation or active session is in progress.
• Apply Minimum Balance and Auto Stop Charging as one approved policy.
• Confirm whether a maintenance period should make the station unavailable during the window.
• Test security-profile changes on a small compatible group before a large rollout.
• Check a representative sample after the operation rather than relying only on the submission response.

7.4 Station use cases

• Apply a minimum wallet balance to a group of stations.
• Enable low-balance auto-stop behavior across a charging network.
• Place affected stations into a maintenance state for scheduled work.
• Correct Make and Model for stations from the same shipment.
• Apply an approved security profile.

8. OCPP Action Center

Use OCPP Action Center to send the same remote OCPP command to selected charge point IDs.

Warning: OCPP commands can interrupt service or alter charger behavior. Check station connectivity, OCPP compatibility, active sessions, and the selected target count before selecting Perform Action.

The verified actions in the Station Actions dropdown are:

1. Change Availability
2. Reset Station
3. Get Configuration
4. Change Configuration
5. Trigger Messages

8.1 Change Availability

Use this action to change whether the selected charge points are available for charging.

1. Select the charge point IDs via Select Charge Point ID(s)*.
2. Choose Change Availability from Station Actions.
3. Set Availability to:
   • Operative — allows the charge point to be available, subject to its current state.
   • Inoperative — makes the charge point unavailable.
4. Confirm that no active session would be disrupted.
5. Select Perform Action.
6. Verify the returned status and the resulting charge-point availability.

8.2 Reset Station

Use reset only for a known operational need.

1. Select the charge point IDs via Select Charge Point ID(s)*.
2. Choose Reset Station from Station Actions.
3. Select Reset Type:
   • Soft — requests a controlled software reset.
   • Hard — requests a full reboot/power cycle and can cause greater disruption.
4. Confirm that no active session would be interrupted.
5. Select Perform Action.
6. Monitor reconnection, BootNotification, status, and alarms.

Use Soft reset by default unless a Hard reset is required by the support procedure.

8.3 Get Configuration

Use this action to remotely retrieve active configuration parameters and keys from selected charge points.

1. Select the charge point IDs via Select Charge Point ID(s)*.
2. Choose Get Configuration from Station Actions.
3. Under Parameters, select one or both Key Type checkboxes:
   • Predefined: Select known configuration keys from the Configuration Key dropdown. Selected keys appear in the predefined queue list.
   • Custom: Type proprietary or vendor-specific configuration parameters into the Enter Parameters input field. Entered custom keys appear in the custom queue list.
4. Select Perform Action.
5. Inspect returned configuration key-value pairs in station diagnostics.

8.4 Change Configuration

This action sends the same configuration key and value to every selected charge point.

1. Select the charge point IDs via Select Charge Point ID(s)*.
2. Choose Change Configuration from Station Actions.
3. Select Key Type:
   • Predefined — choose a standard OCPP key from the dropdown (e.g., Allow Offline Tx For Unknown Id, Authorization Cache Enabled, Authorize Remote Tx Requests, Blink Repeat, Clock Aligned Data Interval, Connection TimeOut, Connector Phase Rotation, Connector Phase Rotation Max Length, Get Configuration Max Keys, Heartbeat Interval, etc.).
   • Custom — enter a custom configuration key name when it is supported by the target charger hardware and approved for use.
4. Select or enter the Configuration Key.
5. Enter the target Value.
6. Confirm that the key and value are supported by every selected target.
7. Select Perform Action (button activates once required inputs are filled).
8. Review accepted, rejected, unsupported, and failed results individually.

8.5 Trigger Messages

Use this action to request a standard message from selected charge points.

Verified Trigger Message choices are:

• Boot Notification
• Diagnostics Status Notification
• Firmware Status Notification
• Heartbeat
• Meter Values
• Status Notification

Procedure:

1. Select the charge point IDs via Select Charge Point ID(s)*.
2. Choose Trigger Messages from Station Actions.
3. Select Trigger Message from the dropdown list.
4. Select Perform Action.
5. Verify that each target sends the requested message within the expected interval.

8.6 OCPP use cases

• Mark a set of connectors Inoperative before electrical work.
• Restore charge points to Operative after verification.
• Soft reset offline or unresponsive stations after checking for sessions.
• Apply custom or predefined configuration keys to compatible chargers.
• Retrieve active configurations via Get Configuration for diagnostic audits.
• Trigger Heartbeat or Status Notification during connectivity diagnosis.
• Trigger Meter Values for an operational data check.

9. Validation and execution behavior

The interface progressively enables fields as selections are made.

Condition	Expected behavior	Resolution
No location selected	Message requests locations before a bulk operation can continue.	Select at least one location and choose Done.
No station selected	Message requests stations before parameters are displayed.	Select one or more stations and choose Done.
No charge point selected	Message requests charge point IDs before OCPP actions are displayed.	Select compatible charge point IDs and choose Done.
No update parameter selected	The screen prompts "Please select a parameter to update".	Open the parameter selector and choose the intended fields.
Required parameter is empty	A field-level validation tooltip appears ("Field cannot be empty").	Supply a valid value for every selected parameter.
Change Configuration value is empty	Perform Action remains disabled.	Enter an approved value.
Unsupported or offline OCPP target	The target can reject or fail the command.	Review per-target results and retry only after correcting the cause.
Upload is not XLSX, exceeds 2 MB, or exceeds 50 entries	The import is rejected during file selection/upload.	Correct the format, split the file into batches of $\le 50$, or reduce file size.

10. Safe execution checklist

Complete this checklist immediately before execution:

• Correct HIEV business tenant selected.
• Correct Update or Add tab selected.
• Correct operation type selected.
• Target count reviewed.
• Search and hierarchy selection reviewed for unintended parent-level selection.
• Every selected parameter is intended to change.
• Values reviewed for format, units, currency, and time zone.
• Active sessions checked before disruptive station or OCPP actions.
• Charger compatibility checked for Make, Model, Security Profile, and OCPP keys.
• Required operational or finance approval obtained.
• A rollback or corrective plan is available.

After execution:

• Submission result reviewed.
• Failed or rejected targets recorded.
• Representative target records refreshed and verified.
• OCPP reconnection or requested messages confirmed when applicable.
• Change reference, operator, time, scope, and evidence retained.

11. Troubleshooting

11.1 Update or Perform Action is disabled

• Confirm that at least one target is selected.
• Confirm that at least one parameter or station action is selected.
• Complete every required field.
• For Change Configuration, enter a Value.
• Correct any field-level validation message.

11.2 A required parameter is not displayed

Some parameters can be role-, tenant-, protocol-, or feature-controlled. If GST IN, Reservation Type, Location Manager, Maintenance Period, or another required field is absent:

1. Confirm that the correct operation type is selected.
2. Confirm that your role has permission to edit the field.
3. Confirm that the feature is enabled for the tenant.
4. Confirm that the selected targets support the parameter.
5. Use the approved individual-management workflow or contact the system administrator; do not substitute an unrelated field.

11.3 Only some targets were updated

• Review per-target validation or command results.
• Check whether some stations are offline or use an incompatible OCPP version.
• Check whether a selected configuration key is supported by every charger model.
• Refresh affected records before retrying.
• Retry only the failed targets after correcting the cause.

11.4 An uploaded file is rejected

• Use the latest downloaded template.
• Keep the .xlsx format.
• Keep the file below 2 MB.
• Limit the file to 50 entries.
• Do not modify required headers.
• Remove duplicate or invalid records.
• Correct date, number, email, and identifier formats.

11.5 OCPP action was accepted but no result is visible

• Confirm charger connectivity.
• Allow the normal protocol response interval.
• Refresh station status and relevant logs.
• For Trigger Messages, check the expected inbound message type.
• For Reset, confirm reconnection and BootNotification.
• Escalate with the charge point IDs, command, timestamp, and response details.

12. Requirement coverage

Requirement	Manual coverage
Application allows users to perform bulk operations	Sections 1–4
Location: Payment Type	Section 6.2
Location: GST IN	Section 6.2 and missing-field troubleshooting
Location: Reservation Type	Section 6.2; verified Reservable mapping noted
Location: Location Manager	Section 6.2 and missing-field troubleshooting
Location: Contact Email	Section 6.2
Location: Contact Phone Number	Section 6.2
Location: DSM (Demand Side Management)	Section 6.2
Station: Minimum Wallet Balance	Section 7.2; verified Minimum Balance mapping noted
Station: Maintenance Period	Section 7.2 and missing-field troubleshooting
Station: Station State	Section 7.2
Station: Make and Model	Section 7.2
Station: Auto cut off on low wallet balance	Section 7.2; verified Auto Stop Charging mapping noted
Station: Ration Duration	Section 7.2
OCPP: Change Configuration (Predefined & Custom Keys)	Section 8.4 (Changelog Item #10)
OCPP: Get Configuration (Predefined & Custom Keys)	Section 8.3
OCPP: Trigger Messages	Section 8.5
OCPP: Change Availability	Section 8.1
OCPP: Reset Station	Section 8.2

13. Glossary

Term	Definition
Bulk operation	One update, addition, or command applied to multiple selected targets.
Location	A charging site that contains one or more stations.
Station	A managed charging-station record within a location.
Charge Point ID	The OCPP identity used to communicate with a charger.
Prepaid	Payment model funded before charging.
Postpaid	Payment model billed after charging under approved terms.
Operative	Availability state that permits use, subject to the charger's actual status.
Inoperative	Availability state that prevents use.
Soft reset	Controlled software reset with lower expected disruption.
Hard reset	Full reset that can cause greater interruption.
Predefined key	Standard configuration key supplied by HIEV's supported-key list.
Custom key	Charger-specific configuration key entered by an authorized user.
DSM	Demand Side Management / Demand Response participation flag.

---

Verification note: This manual combines the supplied Bulk Operations requirements with live verification of the HIEV CPMS Web Portal. No bulk update, upload, station reset, configuration change, availability change, or trigger command was executed during verification.