<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>EV Charge Web Docs | Tridens Technology – Integrations</title><link>/ev-charge-web-docs/integrations/</link><description>Recent content in Integrations on EV Charge Web Docs | Tridens Technology</description><generator>Hugo -- gohugo.io</generator><atom:link href="/ev-charge-web-docs/integrations/index.xml" rel="self" type="application/rss+xml"/><item><title>Docs: Charging Session Integration</title><link>/ev-charge-web-docs/integrations/charging-session-integration/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/charging-session-integration/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#session-start-timeout">Session Start Timeout&lt;/a>&lt;/li>
&lt;li>&lt;a href="#driver-authorization">Driver Authorization&lt;/a>&lt;/li>
&lt;li>&lt;a href="#offline-sessions">Offline Sessions&lt;/a>&lt;/li>
&lt;li>&lt;a href="#meter-values-reporting">Meter Values Reporting&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#session-related-meter-values">Session Related Meter Values&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#session-meter-values-interval">Session Meter Values Interval&lt;/a>&lt;/li>
&lt;li>&lt;a href="#session-meter-values-measurands">Session Meter Values Measurands&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#general-meter-values">General Meter Values&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#general-meter-values-interval">General Meter Values Interval&lt;/a>&lt;/li>
&lt;li>&lt;a href="#general-meter-values-measurands">General Meter Values Measurands&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#energy-reading-type-detection">Energy Reading Type Detection&lt;/a>&lt;/li>
&lt;li>&lt;a href="#energy-report-validation">Energy Report Validation&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#session-event-retry">Session Event Retry&lt;/a>&lt;/li>
&lt;/ul>
&lt;h2 id="session-start-timeout">Session Start Timeout&lt;/h2>
&lt;p>Please ensure to configure the session start timeout period on charger side. It covers the time available to start the session, since the acceptance of remote start request or driver authorization.&lt;/p>
&lt;p>Remote session start and authorization timeout on charger side represents the time since OCPP &lt;code>RemoteStartTransaction/Authorization&lt;/code> acceptance, after which session must be started. If this time is breached, the charger should prevent any session start without the next OCPP RemoteStartTransaction or Authorization operation acceptance.&lt;/p>
&lt;p>To avoid fraudulent usage, we suggest using preventive measures by configuring the charger’s timeout period in which the session is expected to start. OCPP 1.6 has a &lt;code>ConnectionTimeOut&lt;/code> setting, which can be used, as described below.&lt;/p>
&lt;p>Charger may also have other settings which are not part of OCPP 1.6 to handle other preventive scenarios - to tackle those, please check the charger’s specific manual or consult with the manufacturer.&lt;/p>
&lt;p>OCPP 1.6 requires support for &lt;code>ConnectionTimeOut&lt;/code> setting: &lt;em>Interval in seconds from beginning of status: &amp;lsquo;Preparing&amp;rsquo; until incipient Transaction is automatically canceled, due to failure of EV driver to (correctly) insert the charging cable connector(s) into the appropriate socket(s). The Charge Point SHALL go back to the original state, probably: &amp;lsquo;Available&amp;rsquo;.&lt;/em>&lt;/p>
&lt;p>Session timeout section is related to &lt;em>ready-session-expiration&lt;/em> settings of the central system, as it closes inactive sessions based on the expiration settings and idle job configuration. Make sure to use the consistent ready-session-expiration time on the central system, so it works aligned with the charger.&lt;/p>
&lt;div class="alert alert-dark" role="alert">
&lt;h4 class="alert-heading">Example:&lt;/h4>
&lt;em>The EV driver plugs the connector with the vehicle. Then the driver presses the session start request button on the mobile application, and at this point, session is ready. Ready session expiration time of 30 seconds starts ticking. If it reaches 30 seconds and session did not start yet, then the session gets closed on the central system side and is not being tracked anymore.&lt;/em>
&lt;/div>
&lt;div class="alert alert-primary" role="alert">
&lt;h4 class="alert-heading">Note:&lt;/h4>
If you experience the session without a customer reference, you need to make sure to configure the suitable timeout settings in dependence with ready-session-expiration settings.
&lt;/div>
&lt;h2 id="driver-authorization">Driver Authorization&lt;/h2>
&lt;p>As the drivers/customers who intend to charge the vehicle may use the payment types of prepaid, postpaid or pay-now, each session charging needs to be first authorized by the Tridens EV Charge’s central system to verify the driver&amp;rsquo;s fund sufficiency for beginning the charging session. Thus, charger&amp;rsquo;s local and offline authorizations lists and caches need to be disabled, to propagate all the authorizations to the central system.&lt;/p>
&lt;p>Below is the list of OCPP 1.6 and OCPP 2.0.1 standardized authorization settings. Note that the chargers may have their own customized list of configuration settings, out of standardized scope. As a CPO, please review the charger specific implementation for any additional settings that need to be managed.&lt;/p>
&lt;style scoped>
table {
font-size: 14px;
}
&lt;/style>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>&lt;div style="width:90px">Configuration Attribute Name&lt;/div>&lt;/th>
&lt;th>&lt;div style="width:120px">Description&lt;/div>&lt;/th>
&lt;th>&lt;div style="width:120px">Restriction&lt;/div>&lt;/th>
&lt;th>&lt;div style="width:120px">OCPP 1.6 Variable Name&lt;/div>&lt;/th>
&lt;th>&lt;div style="width:120px">OCPP 2.0.1 Variable Name&lt;/div>&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Authorize Remote Session Requests&lt;/td>
&lt;td>Indicates whether remote start requests need to be authorized by the charger before proceeding to charge.&lt;/td>
&lt;td>Set to true, to ensure that the session is still authorized to start.&lt;/td>
&lt;td>&lt;code>AuthorizeRemoteTxRequests&lt;/code>&lt;/td>
&lt;td>&lt;code>AuthorizeRemoteStart&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Authorization Cache Enabled&lt;/td>
&lt;td>Indicates whether the charger supports the authorization cache for the driver&amp;rsquo;s identifiers.&lt;/td>
&lt;td>Set to false, to prevent using charger&amp;rsquo;s local authorization caches.&lt;/td>
&lt;td>&lt;code>AuthorizationCacheEnabled&lt;/code>&lt;/td>
&lt;td>&lt;code>AuthCacheEnabled&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Local Offline Authorization&lt;/td>
&lt;td>Indicates whether the charger, when offline, will start a transaction for locally authorized identifiers.&lt;/td>
&lt;td>Set to false, to prevent using charger&amp;rsquo;s local authorization caches.&lt;/td>
&lt;td>&lt;code>LocalAuthorizeOffline&lt;/code>&lt;/td>
&lt;td>&lt;code>LocalAuthorizeOffline&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Allow Offline Session of Unknown Driver&lt;/td>
&lt;td>Indicates whether the charger allows authorizing any unknown identifiers that cannot be authorized by local authorization list or authorization cache.&lt;/td>
&lt;td>Set to false, to prevent any unverified sessions.&lt;/td>
&lt;td>&lt;code>AllowOfflineTxForUnknownId&lt;/code>&lt;/td>
&lt;td>&lt;code>OfflineTxForUnknownIdEnabled&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Central Contract Validation&lt;/td>
&lt;td>Indicates whether the Charge Point can provide a contract certificate that it cannot validate to the Central System for validation as part of the authorization. &lt;p>&lt;/p> Used in the scope of ISO 15118&amp;rsquo;s Plug &amp;amp; Charge.&lt;/td>
&lt;td>Set to true, so the central system&amp;rsquo;s verification is used.&lt;/td>
&lt;td>&lt;code>CentralContractValidationAllowed&lt;/code>&lt;/td>
&lt;td>&lt;code>CentralContractValidationAllowed&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Offline Contract Validation&lt;/td>
&lt;td>Indicates whether the charge point will try to validate a contract certificate when it is offline (not connected to the central system). &lt;p>&lt;/p> Used in the scope of ISO 15118&amp;rsquo;s Plug &amp;amp; Charge.&lt;/td>
&lt;td>Set to false, so the central system&amp;rsquo;s verification is used.&lt;/td>
&lt;td>&lt;code>ContractValidationOffline&lt;/code>&lt;/td>
&lt;td>&lt;code>ContractValidationOffline&lt;/code>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;em>&lt;strong>Table 1:&lt;/strong>&lt;/em> &lt;em>List of authorization settings to manage in OCPP 1.6 and 2.0.1.&lt;/em>&lt;/p>
&lt;h2 id="offline-sessions">Offline Sessions&lt;/h2>
&lt;p>Disable the charger to start the charging sessions without allowance of the central system, as it would result in non-customer public sessions.&lt;/p>
&lt;p>Make sure to disable &lt;code>LocalAuthorizeOffline&lt;/code> and &lt;code>AllowOfflineTxForUnknownId&lt;/code> settings of OCPP 1.6 on the charger side.&lt;/p>
&lt;p>CPO needs to review the charger specific implementation and configuration, as other settings out of standardized scope may apply.&lt;/p>
&lt;h2 id="meter-values-reporting">Meter Values Reporting&lt;/h2>
&lt;p>Configure session meter values report interval on the charger, so the session&amp;rsquo;s progress will show up. We advise using a 15 seconds interval. You can usually configure this on the charger&amp;rsquo;s own dashboard, or use EV Charge dashboard, which can do it by OCPP.&lt;/p>
&lt;p>To access this section in &lt;strong>EV Charge&lt;/strong>, from the &lt;i class="fa fa-bars" aria-hidden="true">&lt;/i> &lt;strong>Menu&lt;/strong>, click &lt;i class="fa fa-car" aria-hidden="true">&lt;/i> &lt;strong>Stations&lt;/strong>. A paginated list of all stations is shown in a tabular format. Click &lt;i class="fa fa-info-circle" aria-hidden="true">&lt;/i> &lt;strong>Actions&lt;/strong> for the specific station. On the station&amp;rsquo;s page, click &lt;i class="fa fa-cog" aria-hidden="true">&lt;/i> &lt;strong>Configuration&lt;/strong> on the top right corner to access &lt;strong>Configuration&lt;/strong> page, then select &lt;strong>Meter&lt;/strong> tab to regulate the sampling interval. Alternatively, the &lt;strong>Custom&lt;/strong> tab can also be used for this.&lt;/p>
&lt;p>&lt;img src="../meter-setting-interval.png" alt="Example of Meter Setting Interval">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Example of setting the interval in the Station’s Configuration form on Tridens EV Charge dashboard.&lt;/em>&lt;/p>
&lt;div class="alert alert-primary" role="alert">
&lt;h4 class="alert-heading">Note:&lt;/h4>
The settings can be set by the central system to the charger only when charger is connected to the central system and communicating by OCPP protocol.
&lt;/div>
&lt;p>To show active power measurement in mobile app, CPO needs to configure the charger to send the certain measurements in scope of the charging session (usually at least kW for power and kWh for energy). Once again, this is usually doable by the charger&amp;rsquo;s dashboard or EV Charge dashboard, where OCPP&amp;rsquo;s &lt;code>MeterValuesSampledData&lt;/code> setting can be used.&lt;/p>
&lt;p>To navigate to this area in &lt;strong>EV Charge&lt;/strong>, go to the &lt;i class="fa fa-bars" aria-hidden="true">&lt;/i> &lt;strong>Menu&lt;/strong> and select &lt;i class="fa fa-car" aria-hidden="true">&lt;/i> &lt;strong>Stations&lt;/strong>. You&amp;rsquo;ll see a paginated list of all stations in a tabular format. Click on &lt;i class="fa fa-info-circle" aria-hidden="true">&lt;/i> &lt;strong>Actions&lt;/strong> for the specific station. Once on the station&amp;rsquo;s page, on the the top right corner access the Configuration page, then select &lt;strong>Meter&lt;/strong> tab to regulate the sampling measurands. &lt;i class="fa fa-cog" aria-hidden="true">&lt;/i> Alternatively, the &lt;strong>Custom&lt;/strong> tab at the top right corner can also be used.&lt;/p>
&lt;p>&lt;img src="../measurands-setting.png" alt="Example of Setting Measurands">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Example of setting measurands in the Station’s Configuration form on Tridens EV Charge dashboard.&lt;/em>&lt;/p>
&lt;div class="alert alert-primary" role="alert">
&lt;h4 class="alert-heading">Note:&lt;/h4>
The settings can only be configured by the central system to the charger when the charger is connected to the central system and actively communicating via the OCPP protocol.
&lt;/div>
&lt;p>Important measurands to cope with:&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Name&lt;/th>
&lt;th>Description&lt;/th>
&lt;th>OCPP 1.6 Name&lt;/th>
&lt;th>OCPP 2.0.1 Name&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Energy Import&lt;/td>
&lt;td>Instantaneous imported energy (Wh or kWh) to the vehicle.&lt;/td>
&lt;td>&lt;code>Energy.Active.Import.Interval&lt;/code>&lt;/td>
&lt;td>&lt;code>Energy.Active.Import.Interval&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Power Import&lt;/td>
&lt;td>Instantaneous power (W or kW) import to the EV.&lt;/td>
&lt;td>&lt;code>Power.Active.Import&lt;/code>&lt;/td>
&lt;td>&lt;code>Power.Active.Import&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Current Import&lt;/td>
&lt;td>Instantaneous current (A) import to the EV.&lt;/td>
&lt;td>&lt;code>Current.Import&lt;/code>&lt;/td>
&lt;td>&lt;code>Current.Import&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Voltage&lt;/td>
&lt;td>Instantaneous voltage (V) supply between grid and EV.&lt;/td>
&lt;td>&lt;code>Voltage&lt;/code>&lt;/td>
&lt;td>&lt;code>Voltage&lt;/code>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Battery State of Charge&lt;/td>
&lt;td>Percentage representing the vehicle’s battery state of charge.&lt;/td>
&lt;td>&lt;code>SoC&lt;/code>&lt;/td>
&lt;td>&lt;code>SoC&lt;/code>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;em>&lt;strong>Table 2:&lt;/strong>&lt;/em> &lt;em>List of measurands settings in OCPP 1.6 and 2.0.1.&lt;/em>&lt;/p>
&lt;h3 id="session-related-meter-values">Session Related Meter Values&lt;/h3>
&lt;p>Meter values which are related to the specific charging session and representing measurands related to it.&lt;/p>
&lt;h4 id="session-meter-values-interval">Session Meter Values Interval&lt;/h4>
&lt;p>Interval in seconds, by which the charger will send the meter value reports to the central system during the charging session. Suggested interval is 10-15 seconds.&lt;/p>
&lt;p>Refers to &lt;code>MeterValueSampleInterval&lt;/code> of OCPP 1.6 and &lt;code>SampledDataTxUpdatedInterval&lt;/code> of OCPP 2.0.1.&lt;/p>
&lt;h4 id="session-meter-values-measurands">Session Meter Values Measurands&lt;/h4>
&lt;p>Measurands which the charger will send on &lt;em>‘Session meter values interval’&lt;/em>. Suggested: &lt;em>power, energy, state of charge, voltage, current.&lt;/em>&lt;/p>
&lt;p>Refers to &lt;code>MeterValuesSampledData&lt;/code> of OCPP 1.6 and &lt;code>SampledDataTxUpdatedMeasurands&lt;/code> of OCPP 2.0.1.&lt;/p>
&lt;h3 id="general-meter-values">General Meter Values&lt;/h3>
&lt;p>General meter values are reported independent of the session and may be required in the scenarios of the sessions which are being terminated by the final parking.&lt;/p>
&lt;h4 id="general-meter-values-interval">General Meter Values Interval&lt;/h4>
&lt;p>Interval in seconds, by which the charger will send regular meter value reports to the central system during the charging session.&lt;/p>
&lt;p>Refers to &lt;code>ClockAlignedDataInterval&lt;/code> of OCPP 1.6 and &lt;code>AlignedDataInterval&lt;/code> of OCPP 2.0.1.&lt;/p>
&lt;h4 id="general-meter-values-measurands">General Meter Values Measurands&lt;/h4>
&lt;p>Measurands which the charger will send on &lt;em>&amp;lsquo;General meter values interval&amp;rsquo;&lt;/em>. Suggested: &lt;em>power offered.&lt;/em>&lt;/p>
&lt;p>Refers to &lt;code>MeterValuesAlignedData&lt;/code> of OCPP 1.6 and &lt;code>AlignedDataMeasurands&lt;/code> of OCPP 2.0.1.&lt;/p>
&lt;h3 id="energy-reading-type-detection">Energy Reading Type Detection&lt;/h3>
&lt;p>&lt;em>Absolute&lt;/em>: Energy meter reading which is accumulating consumption of all sessions on one connector.&lt;/p>
&lt;p>&lt;em>Relative&lt;/em>: Energy meter reading starting from 0 for each session.&lt;/p>
&lt;p>The central system of Tridens EV Charge is utilizing the following energy consumption detection for a session, as there are different varieties of reporting types by chargers:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>Chargers reporting an absolute energy meter values at session start, intermediate, stop. Energy of all the sessions on the charger so far.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Chargers reporting the session relative energy meter values at session start, intermediate, stop. Energy of the specific session.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Chargers reporting an absolute energy meter value at the start and stop of session, but in the intermediate time, they are sending relative session energy reports (zero based).&lt;/p>
&lt;/li>
&lt;/ul>
&lt;h3 id="energy-report-validation">Energy Report Validation&lt;/h3>
&lt;p>The central system of Tridens EV Charge utilizes charging session’s energy consumption validation for the persisted charging session, when receiving the reports from the charger.
Connector’s power capability is being verified along with the energy meter reading time. This mechanism serves to overcome an issue when the chargers report the deprecated or excessive energy meter consumption.&lt;/p>
&lt;p>Validation is made in two steps, where both need to pass:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>Timestamp of reported energy meter reading for the persisted session is verified against the persisted session’s latest valid meter reading. It is considered as valid if the energy meter reading’s timestamp is not older than the previous meter reading’s timestamp.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Reported energy (Wh/kWh) is verified against the capability of the connector. It is considered as valid if the energy consumed over time is possible for the connector’s power capacity in the time difference from the previous valid energy meter report timestamp of the persisted session.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;div class="alert alert-primary" role="alert">
&lt;h4 class="alert-heading">Note:&lt;/h4>
Make sure to properly set the wattage limit on the connector configuration on &lt;a href="../../stations/#create-connector">Stations - Connectors&lt;/a>.
&lt;/div>
&lt;p>If the connector has lower power capability configured, the energy difference reported will be too large for the configured capability and thus energy meter reports are going to be discarded and energy consumption will not be persisted on the Tridens EV Charge’s sessions.&lt;/p>
&lt;p>The scenarios below are based on the charging connector which is capable of 30kW energy flow.&lt;/p>
&lt;p>&lt;strong>Screnario 1&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate&lt;/td>
&lt;td>2025 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2050 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 2&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>0 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Session relative meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate&lt;/td>
&lt;td>25 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Session relative meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>50 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Session relative meter reading.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 3&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate 1&lt;/td>
&lt;td>25 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Session relative meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate 2&lt;/td>
&lt;td>50 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Session relative meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2075 Wh&lt;/td>
&lt;td>08:01:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 4&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate 1&lt;/td>
&lt;td>2025 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate 2&lt;/td>
&lt;td>2020 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Absolute meter reading. &lt;br>Valid time, invalid deprecated energy report.&lt;br> &lt;strong>Invalid and not impacting the session&lt;/strong>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2075 Wh&lt;/td>
&lt;td>08:01:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 5&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate&lt;/td>
&lt;td>2025 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2020 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Absolute meter reading. &lt;br> Valid time, invalid deprecated energy report. &lt;br> &lt;strong>Invalid and not impacting the session&lt;/strong>.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 6&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate 1&lt;/td>
&lt;td>2025 Wh&lt;/td>
&lt;td>07:59:59&lt;/td>
&lt;td>Absolute meter reading. &lt;br> Invalid deprecated time. &lt;br> &lt;strong>Invalid and not impacting the session&lt;/strong>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate 2&lt;/td>
&lt;td>2050 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2075 Wh&lt;/td>
&lt;td>08:01:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 7&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate&lt;/td>
&lt;td>2025 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2050 Wh&lt;/td>
&lt;td>08:00:29&lt;/td>
&lt;td>Absolute meter reading. &lt;br> Invalid deprecated time. &lt;br> &lt;strong>Invalid and not impacting the session&lt;/strong>.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 8&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate&lt;/td>
&lt;td>2500 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Absolute meter reading. &lt;br> Valid time. Invalid excessive energy report over connector&amp;rsquo;s power capacity. &lt;br> &lt;strong>Invalid and not impacting the session&lt;/strong>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2050 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;strong>Scenario 9&lt;/strong>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Meter reading scope&lt;/th>
&lt;th>Meter reading value&lt;/th>
&lt;th>Meter reading time&lt;/th>
&lt;th>Notes&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session start&lt;/td>
&lt;td>2000 Wh&lt;/td>
&lt;td>08:00:00&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session intermediate&lt;/td>
&lt;td>2025 Wh&lt;/td>
&lt;td>08:00:30&lt;/td>
&lt;td>Absolute meter reading.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session stop&lt;/td>
&lt;td>2500 Wh&lt;/td>
&lt;td>08:01:00&lt;/td>
&lt;td>Absolute meter reading. &lt;br> Valid time. Invalid excessive energy report over connector&amp;rsquo;s power capacity. &lt;br> &lt;strong>Invalid and not impacting the session&lt;/strong>.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="session-event-retry">Session Event Retry&lt;/h2>
&lt;p>Retry to send the event in case of failure. Suggested value is 3.&lt;/p>
&lt;p>Refers to &lt;code>TransactionMessageRetryInterval&lt;/code> of OCPP 1.6.&lt;/p></description></item><item><title>Docs: Charging Session Malfunctions</title><link>/ev-charge-web-docs/integrations/charging-session-malfunctions/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/charging-session-malfunctions/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#introduction">Introduction&lt;/a>&lt;/li>
&lt;li>&lt;a href="#session-charging-but-energy-not-progressing-on-tridens">1. Session charging, but energy not progressing on Tridens&lt;/a>&lt;/li>
&lt;li>&lt;a href="#session-charging-but-session-shows-0-kw-or-0-a-on-tridens">2. Session charging, but session shows 0 kW or 0 A on Tridens&lt;/a>&lt;/li>
&lt;li>&lt;a href="#no-customer-assigned-on-session">3. No customer assigned on session&lt;/a>&lt;/li>
&lt;li>&lt;a href="#false-time-tracking">4. False time tracking&lt;/a>&lt;/li>
&lt;li>&lt;a href="#faulted-connector">5. Faulted connector&lt;/a>&lt;/li>
&lt;li>&lt;a href="#suspended-evevse">6. Suspended EV/EVSE&lt;/a>&lt;/li>
&lt;li>&lt;a href="#rating-failed">7. Rating failed&lt;/a>&lt;/li>
&lt;li>&lt;a href="#billing-failed">8. Billing failed&lt;/a>&lt;/li>
&lt;li>&lt;a href="#session-did-not-start">9. Session did not start&lt;/a>&lt;/li>
&lt;li>&lt;a href="#obsolete-session-charger-stops-responding">10. Obsolete session, charger stops responding&lt;/a>&lt;/li>
&lt;li>&lt;a href="#inadequate-session">11. Inadequate session&lt;/a>&lt;/li>
&lt;/ul>
&lt;h2 id="introduction">Introduction&lt;/h2>
&lt;p>This document describes scenarios of frequent EV charging session malfunctions with solution instructions and preventive measures.&lt;/p>
&lt;h2 id="1-session-charging-but-energy-not-progressing-on-tridens">1. Session charging, but energy not progressing on Tridens&lt;/h2>
&lt;p>Session charging at physical charger. Actual energy transferred &amp;gt;0 kWh, but on Tridens EV Charge web/mobile it shows 0 kWh or is stuck at some point above 0 kWh. This is usually the consequence of connector’s power limit being set too low on Tridens EV Charge dashboard, which causes the session energy validation rejections, as described in &lt;a href="../charging-session-integration/#energy-report-validation">Energy Report Validation&lt;/a>. Alternative issue might be that charging station is not reporting any energy consumption.&lt;/p>
&lt;p>&lt;img src="../sessions-energy-consumption-not-progressing.png" alt="Session&amp;amp;rsquo;s energy consumption not progressing on Tridens dashboard web/mobile.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Session&amp;rsquo;s energy consumption not progressing on Tridens dashboard web/mobile.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 1:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 1.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Connector&amp;rsquo;s power capacity configuration on Tridens&lt;/td>
&lt;td>Adjust the connector&amp;rsquo;s &lt;strong>power (W)&lt;/strong> capacity on Tridens EV Charge dashboard to reflect an actual power capacity of the connector. Provide the power value in unit of watts (W). This shall adjust the active session&amp;rsquo;s energy, once the next session meter values are reported. Future sessions shall contain the proper energy consumption. &lt;br>&lt;br> &lt;a href="../charging-session-integration/#energy-report-validation">Session Integrations - Energy Report Validation&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Enable reporting of energy consumption on station&lt;/td>
&lt;td>Enable the reporting of energy (energy active import) on the physical station&amp;rsquo;s configuration. Adjust physical station&amp;rsquo;s configuration by using Tridens EV Charge dashboard &lt;strong>Station - Actions - Configuration - Meterings&lt;/strong>. Enable &lt;strong>Energy.Active.Import.Register&lt;/strong> in &lt;strong>Measurands&lt;/strong>. Future sessions shall then contain energy consumption reports.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Enable meter values reporting interval on station&lt;/td>
&lt;td>Enable the reporting interval for session-related meter values on the physical charging station. Adjust physical station&amp;rsquo;s configuration by using Tridens EV Charge dashboard &lt;strong>Station - Actions - Configuration - Meterings&lt;/strong> and adjusting &lt;strong>Meter Value Sample Interval&lt;/strong>. &lt;br>&lt;br> Interval is expected to be between 10-60 seconds. &lt;br>&lt;br> &lt;a href="../charging-session-integration/#meter-values-reporting">Session Integrations - Meter Values Reporting&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="2-session-charging-but-session-shows-0-kw-or-0-a-on-tridens">2. Session charging, but session shows 0 kW or 0 A on Tridens&lt;/h2>
&lt;p>EV session charging at physical charger and actual energy is being transferred. Energy is &amp;gt;0 kWh, but power shows 0 kW or current 0 A on Tridens EV Charge web/mobile. This is usually the consequence of insufficient charger configuration in the scope of meter values reporting.&lt;/p>
&lt;p>&lt;img src="../sessions-latest-power.png" alt="Session&amp;amp;rsquo;s latest power and amperage missing on Tridens dashboard web/mobile.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Session&amp;rsquo;s latest power and amperage missing on Tridens dashboard web/mobile.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 2:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 2.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Enable reporting of energy consumption on station&lt;/td>
&lt;td>Enable the reporting of power and current on the physical charging station&amp;rsquo;s configuration. Adjust physical station&amp;rsquo;s configuration by using Tridens EV Charge dashboard &lt;strong>Station - Actions - Configuration - Meterings&lt;/strong>. Enable &lt;strong>Power.Active.Import&lt;/strong> and &lt;strong>Current.Import&lt;/strong> in &lt;strong>Measurands&lt;/strong>. Future sessions shall then contain power and current reports, as long as the charger supports reporting these. &lt;br>&lt;br> &lt;a href="../charging-session-integration/#meter-values-reporting">Session Integrations - Meter Values Reporting&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Enable meter values reporting interval on station&lt;/td>
&lt;td>Enable the reporting interval for session-related meter values on the physical charging station. Adjust physical station&amp;rsquo;s configuration by using Tridens EV Charge dashboard &lt;strong>Station - Actions - Configuration - Meterings&lt;/strong> and adjusting &lt;strong>Meter Value Sample Interval&lt;/strong>. Interval is expected to be between 10-60 seconds. &lt;br>&lt;br> &lt;a href="../charging-session-integration/#meter-values-reporting">Session Integrations - Meter Values Reporting&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="3-no-customer-assigned-on-session">3. No customer assigned on session&lt;/h2>
&lt;p>Session has no customer assigned, but charger is not publicly open.&lt;/p>
&lt;p>&lt;img src="../no-customer-assigned.png" alt="No customer assigned on Tridens session.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 3:&lt;/strong>&lt;/em> &lt;em>No customer assigned on Tridens session.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 3:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 3.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Session timeout&lt;/td>
&lt;td>Such session state can be a consequence of non-proper configuration of &lt;strong>connection timeout&lt;/strong> &amp;amp; &lt;strong>session expiration settings&lt;/strong>. &lt;br> Adjust based on &lt;a href="../charging-session-integration/#session-start-timeout">Session Start Timeout&lt;/a> and &lt;a href="../../sessions/#idle-session-settings">Idle Session Settings&lt;/a>. &lt;br>&lt;br> To avoid fraudulent usage, we suggest using preventive measures by configuring the charger’s timeout period in which the session is expected to start. It covers the time available to start the session, since the acceptance of remote start request or driver authorization at the spot. &lt;br>&lt;br> Remote session start and authorization timeout on charger side represents the pending period to start the session upon the acceptance, after which session start confirmation is expected from the charger. If this time is breached, the charger should prevent any session from starting without the next session authorization acceptance, whether by mobile remote request or authorization at the charger. &lt;br>&lt;br> Example: &lt;br> The EV driver plugs the charger’s connector to the vehicle. Then the driver presses the session start request button on the mobile application, and at this point, session is ready. Ready session expiration time of 30 seconds starts ticking. If it reaches 30 seconds and the session has not started yet, then the session gets closed on the central system side and is not being tracked anymore. Charger needs to discard this session as well by using the compatible timeout period, which is advised to be shorter than the one of the central systems due to the time elapsed for the commands exchange. &lt;br>&lt;br> Session timeout section is related to &lt;em>ready-session-expiration&lt;/em> settings of the central system, as it closes inactive sessions based on the expiration settings and idle job configuration. Make sure to use the consistent ready-session-expiration time on the central system, so it works aligned with the charger.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Authorization caches&lt;/td>
&lt;td>Disable charging station&amp;rsquo;s local &lt;strong>authorization caches&lt;/strong>. &lt;br> Adjust physical station&amp;rsquo;s configuration in &lt;strong>Stations - Actions - Configuration - Authorization&lt;/strong> and invalidate/disable authorization caches. &lt;br>&lt;br> &lt;a href="../charging-session-integration/#driver-authorization">Session Integrations - Driver Authorization&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Authorization lists&lt;/td>
&lt;td>Disable charging station&amp;rsquo;s local &lt;strong>authorization lists&lt;/strong>. &lt;br> Adjust physical station&amp;rsquo;s configuration in &lt;strong>Stations - Actions - Configuration - Authorization&lt;/strong> and disable, erase or update authorization lists. &lt;br>&lt;br> &lt;a href="../charging-session-integration/#driver-authorization">Session Integrations - Driver Authorization&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="4-false-time-tracking">4. False time tracking&lt;/h2>
&lt;p>Session charging most of the time (has high energy consumption), but parking/fault time is tracked instead. This indicates false connector status reporting.&lt;/p>
&lt;p>&lt;img src="../tridens-session-has-inconsistent-times.png" alt="Tridens session has inconsistent times.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 4:&lt;/strong>&lt;/em> &lt;em>Tridens session has inconsistent times.&lt;/em>&lt;/p>
&lt;p>&lt;img src="../connector-has-non-proper-status-on-tridens-web-dashboard.png" alt="Connector has non-proper status on Tridens web dashboard.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 5:&lt;/strong>&lt;/em> &lt;em>Connector has non-proper status on Tridens web dashboard.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 4:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 4.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Investigate OCPP logs&lt;/td>
&lt;td>Investigate OCPP communication of the charging station in Tridens EV Charge dashboard under &lt;strong>Stations - View Logs - OCPP&lt;/strong>. Focus on latest reported connector statuses from the charger in &lt;em>StatusNotification&lt;/em>. The condition may be a result of false connector status reporting or invalid timestamp included in the report. &lt;br>&lt;br> OCPP communication view: &lt;br> &lt;a href="../../sessions/#view-logs">Stations - Logs - Logged OCPP Communication&lt;/a> &lt;br>&lt;br> Session duration scopes (reservation, charging, parking, fault): &lt;br> &lt;a href="../../sessions/#duration-scopes">Sessions - Duration Scopes&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Use charging station&amp;rsquo;s latest firmware&lt;/td>
&lt;td>Ensure using the charging station manufacturer&amp;rsquo;s latest stable firmware, which may already provide a correction. Otherwise, please contact the manufacturer about the connector status reporting issue and provide them the OCPP logs excerpt. &lt;br>&lt;br> &lt;a href="../../operations/stations/#firmware-update">Tridens EV Charge Operations - Stations - Firmware&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="5-faulted-connector">5. Faulted connector&lt;/h2>
&lt;p>Session starts charging &amp;amp; charges load, then connector switches to faulted (hardware malfunction) and shows OCPP logs for investigation.&lt;/p>
&lt;p>&lt;img src="../connector-has-faulted-status.png" alt="Connector has faulted status on Tridens web dashboard.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 6:&lt;/strong>&lt;/em> &lt;em>Connector has faulted status on Tridens web dashboard.&lt;/em>&lt;/p>
&lt;p>&lt;img src="../contains-fault-time.png" alt="Tridens session contains fault time.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 7:&lt;/strong>&lt;/em> &lt;em>Tridens session contains fault time.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 5:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 5.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Investigate OCPP logs&lt;/td>
&lt;td>Investigate OCPP communication of the charging station in Tridens EV Charge dashboard under &lt;strong>Stations - View Logs - OCPP&lt;/strong>. Focus on the latest &lt;em>StatusNotification&lt;/em> reports from the charger and find error logs. Vendor error codes may indicate a specific error that requires a technician&amp;rsquo;s action. &lt;br>&lt;br> OCPP communication view: &lt;br> &lt;a href="../../sessions/#view-logs">Stations - Logs - Logged OCPP Communication&lt;/a> &lt;br>&lt;br> Session duration scopes (reservation, charging, parking, fault): &lt;br> &lt;a href="../../sessions/#duration-scopes">Sessions - Duration Scopes&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Use charging station&amp;rsquo;s latest firmware&lt;/td>
&lt;td>Ensure using the charging station manufacturer&amp;rsquo;s latest stable firmware, which may already provide a correction. Otherwise, please contact the manufacturer about the connector status reporting issue and provide them the OCPP logs excerpt. &lt;br>&lt;br> &lt;a href="../../operations/stations/#firmware-update">Tridens EV Charge Operations - Stations - Firmware&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Notification on faulted connector&lt;/td>
&lt;td>Use &lt;strong>notifications&lt;/strong> to notify the charging infrastructure operator about the malfunction. &lt;br>&lt;br> Notification actions of interest: &lt;br> • Faulted connectors &lt;br> • Session with faulted time &lt;br>&lt;br> To configure notifications of different publishing types, follow instructions: &lt;br> &lt;a href="../../system-configuration/notifications">System Configuration - Notifications&lt;/a> &lt;br>&lt;br> More notification guidelines for operators are defined in: &lt;br> &lt;a href="../notifications-guidelines">Integrations - Notifications Guidelines&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="6-suspended-evevse">6. Suspended EV/EVSE&lt;/h2>
&lt;p>Session started charging &amp;amp; charged some load, then connector was switched to suspended EV (charger offering energy, but EV not taking it) or suspended EVSE (charger not offering energy to EV). Please note that suspension may happen temporarily due to energy network load balancing or vehicle&amp;rsquo;s battery management system, to prevent failures.&lt;/p>
&lt;p>&lt;img src="../connector-has-suspended-status.png" alt="Connector has suspended status on Tridens web dashboard.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 8:&lt;/strong>&lt;/em> &lt;em>Connector has suspended status on Tridens web dashboard.&lt;/em>&lt;/p>
&lt;p>&lt;img src="../session-contains-parking-time-due-to-suspension.png" alt="Tridens session contains parking time, due to suspension.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 9:&lt;/strong>&lt;/em> &lt;em>Tridens session contains parking time, due to suspension.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 6:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 6.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Investigate OCPP logs&lt;/td>
&lt;td>Investigate OCPP communication of the charging station in Tridens EV Charge dashboard under &lt;strong>Stations - View Logs - OCPP&lt;/strong>. Focus on the latest &lt;em>StatusNotification&lt;/em> reports from the charger. Exact status reason can be found in additional info attributes. &lt;br>&lt;br> &lt;strong>Suspended EV&lt;/strong> means that charger is offering energy, but vehicle is not taking it. &lt;br>&lt;br> &lt;strong>Suspended EVSE&lt;/strong> means that charger is not offering energy. &lt;br>&lt;br> OCPP communication view: &lt;br> &lt;a href="../../sessions/#view-logs">Stations - Logs - Logged OCPP Communication&lt;/a> &lt;br>&lt;br> Session duration scopes (parking, charging, &amp;hellip;): &lt;br> &lt;a href="../../sessions/#duration-scopes">Sessions - Duration Scopes&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="7-rating-failed">7. Rating failed&lt;/h2>
&lt;p>Customer&amp;rsquo;s session was charging successfully, but it ended up in &lt;em>rating-failed&lt;/em> status.
Failed rating of session can be a consequence of false plan-product catalogue configuration in Tridens Monetization, false customer&amp;rsquo;s subscription plan configuration in Tridens Monetization or internal error due to maintenance. Rating can be retried manually or by an automated job.&lt;/p>
&lt;p>&lt;img src="../session-with-rating-failed-status.png" alt="Tridens session with rating-failed status.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 10:&lt;/strong>&lt;/em> &lt;em>Tridens session with rating-failed status.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 7:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 7.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Manual retry rating&lt;/td>
&lt;td>Attempt manual retry rating operation on session by using Tridens EV Charge web dashboard in &lt;strong>Sessions - Actions&lt;/strong> and hit &lt;strong>Retry rating&lt;/strong>. &lt;br>&lt;br> &lt;a href="../../sessions/#session-retry-rating">Sessions - Retry Rating&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Automated retry rating&lt;/td>
&lt;td>Automated retry rating operation is done by automated &lt;strong>retry session rating job&lt;/strong>. &lt;br>&lt;br> &lt;a href="../../sessions/#session-retry-rating">Sessions - Retry Rating&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Monetization catalogue configuration&lt;/td>
&lt;td>Verify whether rate plan configuration is proper in Tridens Monetization.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Customer subscription plan configuration&lt;/td>
&lt;td>Verify whether customer&amp;rsquo;s subscription plan configuration is proper in Tridens Monetization.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="8-billing-failed">8. Billing failed&lt;/h2>
&lt;p>Customer&amp;rsquo;s session was charging successfully, but it ended up in &lt;em>billing-failed&lt;/em> status.
Failed billing of session can be a consequence of false plan-product catalogue configuration in Tridens Monetization, false customer&amp;rsquo;s subscription plan configuration in Tridens Monetization or internal error due to maintenance. Rating can be retried manually or by an automated job.&lt;/p>
&lt;p>&lt;img src="../session-with-billing-failed-status.png" alt="Tridens session with billing-failed status.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 11:&lt;/strong>&lt;/em> &lt;em>Tridens session with billing-failed status.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 8:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 8.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Manual retry billing&lt;/td>
&lt;td>Attempt manual retry billing operation on session by using Tridens EV Charge web dashboard in &lt;strong>Sessions - Actions&lt;/strong> and hit &lt;strong>Retry billing&lt;/strong>. &lt;br>&lt;br> &lt;a href="../../sessions/#session-retry-billing">Sessions - Retry Billing&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Automated retry billing&lt;/td>
&lt;td>Automated retry billing operation is done by automated &lt;strong>retry session billing job&lt;/strong>. &lt;br>&lt;br> &lt;a href="../../sessions/#session-retry-billing">Sessions - Retry Billing&lt;/a>&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Monetization catalogue configuration&lt;/td>
&lt;td>Verify whether rate plan configuration is proper in Tridens Monetization.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Customer subscription plan configuration&lt;/td>
&lt;td>Verify whether customer&amp;rsquo;s subscription plan configuration is proper in Tridens Monetization.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="9-session-did-not-start">9. Session did not start&lt;/h2>
&lt;p>Charging session has been requested to start and was prepared with &lt;em>ready&lt;/em> status. Session then never proceeded to start and did not obtain the &lt;em>in-progress&lt;/em> status. Eventually, the session becomes &lt;em>closed&lt;/em>.&lt;/p>
&lt;p>Such session state can be a consequence of non-proper configuration of &lt;strong>connection timeout&lt;/strong> &amp;amp; &lt;strong>session expiration settings&lt;/strong> or missing session event from the charging station.&lt;/p>
&lt;p>&lt;img src="../prepared-session-in-ready-status.png" alt="Prepared session in ready status.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 12:&lt;/strong>&lt;/em> &lt;em>Prepared session in ready status.&lt;/em>&lt;/p>
&lt;p>&lt;img src="../non-started-session-has-been-closed.png" alt="Non-started session has been closed.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 13:&lt;/strong>&lt;/em> &lt;em>Non-started session has been closed.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 9:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 9.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Ready session expiration on Tridens&lt;/td>
&lt;td>Session on the Tridens EV Charge server is considered as idle when not receiving event reports from the charging infrastructure after a certain configured time. &lt;br> &lt;strong>Ready session expiration&lt;/strong> represents allowed inactivity period for a prepared &lt;em>ready&lt;/em> charging session. When background job detects a &lt;em>ready&lt;/em> session’s inactivity exceeding this time, it finalizes it (rating and closing). &lt;br>&lt;br> Adjust ready session expiration settings on Tridens by following instructions in &lt;a href="../../sessions/#idle-session-settings">Tridens EV Charge – Idle Session Settings&lt;/a>. &lt;br>&lt;br> Align the expiration period with the &lt;em>Session connection timeout&lt;/em> period.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session connection timeout of station&lt;/td>
&lt;td>Ensure to configure the &lt;strong>session start connection timeout&lt;/strong> period on the charging station side. It covers the time available to start the session, since the acceptance of remote session start request or driver authorization. &lt;br> Adjust physical station&amp;rsquo;s configuration in &lt;strong>Stations - Actions - Configuration - Core/General&lt;/strong> and adjust the &lt;strong>Connection timeout&lt;/strong>, as instructed in &lt;a href="../charging-session-integration/#session-start-timeout">Tridens EV Charge – Charging Session Integration – Session Start Timeout&lt;/a> &lt;br>&lt;br> Align the timeout with &lt;em>Ready session expiration&lt;/em> on Tridens web dashboard.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Station did not report session start event&lt;/td>
&lt;td>Verify whether the charging station has reported start session event (OCPP&amp;rsquo;s &lt;strong>StartTransaction&lt;/strong> or &lt;strong>TransactionEventRequest&lt;/strong>). &lt;br>&lt;br> See OCPP communication logs: &lt;br> &lt;a href="../../sessions/#view-logs">Stations - Logs - Logged OCPP Communication&lt;/a> &lt;br>&lt;br> If event is missing, ensure using the latest firmware on the charging station, otherwise report an issue to the manufacturer.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="10-obsolete-session-charger-stops-responding">10. Obsolete session, charger stops responding&lt;/h2>
&lt;p>Charging session was charging and progressing, but at some point, the progress was not visible anymore on Tridens web dashboard and mobile application. Eventually, such session was detected as idle and switched from &lt;em>in-progress&lt;/em> status to &lt;em>closed&lt;/em>. Persisted energy may not reflect the value on the physical charger/vehicle.&lt;/p>
&lt;p>&lt;img src="../session-stopped-being-tracked-and-eventually-close.png" alt="Session stopped being tracked and eventually closed.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 14:&lt;/strong>&lt;/em> &lt;em>Session stopped being tracked and eventually closed.&lt;/em>&lt;/p>
&lt;p>&lt;em>&lt;strong>Table 10:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 10.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Meter values reporting&lt;/td>
&lt;td>Ensure having session meter values reporting enabled. &lt;br> Enable session meter values reporting interval on &lt;strong>Stations - Actions - Configuration - Meterings - Interval&lt;/strong> of 10-60 seconds. &lt;br> Enable session meter values measurands reporting in &lt;strong>Stations - Actions - Configuration - Meterings - Measurands&lt;/strong>. Advised to use &lt;em>Energy.Active.Import.Register&lt;/em>, &lt;em>Power.Active.Import&lt;/em> and &lt;em>Current.Import&lt;/em>. &lt;br>&lt;br> For more guidelines and instructions on configuring the meter values, refer to &lt;a href="../charging-session-integration/#meter-values-reporting">Tridens EV Charge – Charging Session Integration – Meter Values Reporting&lt;/a>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Ongoing session expiration on Tridens&lt;/td>
&lt;td>Session on the Tridens EV Charge server is considered as idle when not receiving event reports from the charging infrastructure after a certain configured time. &lt;br> &lt;strong>Ongoing session expiration&lt;/strong> represents allowed inactivity period for an &lt;em>ongoing in-progress&lt;/em> charging session. When background job detects an &lt;em>in-progress&lt;/em> session’s inactivity exceeding this time period, it finalizes the session (rating and closing). &lt;br>&lt;br> Adjust ongoing session expiration settings on Tridens by following instructions in &lt;a href="../../sessions/#idle-session-settings">Tridens EV Charge – Idle Session Settings&lt;/a>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Charging station&amp;rsquo;s network issues&lt;/td>
&lt;td>Consider that charging station&amp;rsquo;s &lt;strong>web network issues&lt;/strong> may impact this. In large network inactivity times, session may be detected as idle and closed by &lt;em>ongoing-session-expiration&lt;/em> rules on Tridens.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Charging station&amp;rsquo;s firmware issue&lt;/td>
&lt;td>Charging station may stopped operating properly due to firmware issue, full messaging queue, memory overflow or any similar issue. &lt;br> Ensure using the latest &lt;strong>stable firmware&lt;/strong> on the charging station.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Charging station&amp;rsquo;s hardware issue&lt;/td>
&lt;td>Charging station may stopped operating properly due to hardware issue: EV communication error, high temperature, over voltage, power meter failure, reader failure, ground failure or other. &lt;br> Check out OCPP communication logs to find any fault indicators (&lt;em>StatusNotification&lt;/em>): &lt;br> &lt;a href="../../sessions/#view-logs">Stations - Logs - Logged OCPP Communication&lt;/a>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h2 id="11-inadequate-session">11. Inadequate session&lt;/h2>
&lt;p>Recognize one of the following:&lt;/p>
&lt;ul>
&lt;li>Sessions shorter than 5 minutes.&lt;/li>
&lt;li>Sessions consumed less than 5 kWh of energy.&lt;/li>
&lt;li>Non-properly tracked session times: Charging times, parking times, fault times.&lt;/li>
&lt;li>No customer assigned on session.&lt;/li>
&lt;li>No monetary amount assigned on session.&lt;/li>
&lt;/ul>
&lt;p>&lt;em>&lt;strong>Table 11:&lt;/strong>&lt;/em> &lt;em>Solution &amp;amp; preventive measures of scenario 11.&lt;/em>&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Topic&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Short session&lt;/td>
&lt;td>See &lt;a href="#session-did-not-start">Session did not start&lt;/a> and &lt;a href="#obsolete-session-charger-stops-responding">Obsolete session, charger stops responding&lt;/a>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Low energy consumption&lt;/td>
&lt;td>See &lt;a href="#session-charging-but-energy-not-progressing-on-tridens">Session charging, but energy not progressing on Tridens&lt;/a> and &lt;a href="#faulted-connector">Faulted connector&lt;/a>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session has non-proper times&lt;/td>
&lt;td>See &lt;a href="#false-time-tracking">False time tracking&lt;/a>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session has no customer assigned&lt;/td>
&lt;td>See &lt;a href="#no-customer-assigned-on-session">No customer assigned on session&lt;/a>.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Session has no monetary amount&lt;/td>
&lt;td>Verify whether rate plan configuration is proper in Tridens Monetization &amp;amp; whether customer&amp;rsquo;s subscription plan configuration is proper in Tridens Monetization.&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table></description></item><item><title>Docs: Payment Terminal Integrations</title><link>/ev-charge-web-docs/integrations/pos-terminal/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/pos-terminal/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#introduction">Introduction&lt;/a>&lt;/li>
&lt;li>&lt;a href="#configuration">Configuration&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#configure-payment-terminal-provider">Configure Payment Terminal Provider&lt;/a>&lt;/li>
&lt;li>&lt;a href="#charging-infrastructure-setup">Charging Infrastructure Setup&lt;/a>&lt;/li>
&lt;li>&lt;a href="#roaming-tariffs">Roaming Tariffs&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#charging-session-control">Charging Session Control&lt;/a>&lt;/li>
&lt;/ul>
&lt;h2 id="introduction">Introduction&lt;/h2>
&lt;p>This document describes the setup requirements for the payment terminal (POS) integration by &lt;strong>OCPI or OICP communication protocols&lt;/strong> on Tridens EV Charge.&lt;/p>
&lt;p>Integration involves &lt;strong>Payment Terminal Providers (PTP)&lt;/strong> communicating with the charging infrastructure of charge point operators (CPO).&lt;br>
In this document, the term &lt;em>payment terminal provider&lt;/em> is used as a technical term and is considered a synonym for the less technical term &lt;em>POS provider&lt;/em>.
The Payment Terminal Provider acts as a gateway to the charging infrastructure via OCPI or OICP protocols for charging session control and related data transfer.
OCPI protocol offers official payment terminals support. For OICP, a hybrid concept can be utilized.&lt;/p>
&lt;div class="alert alert-primary" role="alert">
&lt;h4 class="alert-heading">Notes:&lt;/h4>
&lt;ul>
&lt;li>
&lt;p>Payment terminal providers can be added to Tridens EV Charge environment.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Payment terminal provider’s charging sessions are stored in Tridens EV Charge as part of an &lt;strong>away charging infrastructure network&lt;/strong>, without a known customer/driver reference.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>When the &lt;strong>payment terminal provider charging session&lt;/strong> is utilized on a related CPO’s charging infrastructure that is part of Tridens EV Charge, such sessions appear as part of the &lt;strong>home charging infrastructure network&lt;/strong> for that CPO.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Sessions are part of reporting in Tridens EV Charge for CPOs.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;/div>
&lt;p>&lt;img src="../payment-terminal-integration-by-ocpi.png" alt="OCPI communication topology for payment terminal providers.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>OCPI communication topology for payment terminal providers.&lt;/em>&lt;/p>
&lt;h2 id="configuration">Configuration&lt;/h2>
&lt;p>Payment terminal providers can be configured in Tridens EV Charge tenant environments for CPOs. The following instructions focus on the OCPI protocol, as it officially defines payment terminal setup and communication (standardized since OCPI 2.2.1).&lt;/p>
&lt;h3 id="configure-payment-terminal-provider">Configure Payment Terminal Provider&lt;/h3>
&lt;p>To configure the environment for a roaming Payment Terminal Provider (PTP):&lt;/p>
&lt;ol>
&lt;li>
&lt;p>&lt;strong>Navigate to Roaming&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Go to the &lt;strong>Roaming&lt;/strong> section on the left-side menu of the Tridens EV Charge dashboard.&lt;/li>
&lt;li>Roaming Profile in this case represents environment as the operator of the charging infrastructure (chargers) in the roaming network.&lt;/li>
&lt;li>Roaming Platform here represents the third-party payment terminal provider.&lt;/li>
&lt;li>Submit configuration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Create Roaming Profile (CPO)&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>On the &lt;strong>Roaming Profiles&lt;/strong> tab, create a new profile or use an existing one.&lt;/li>
&lt;li>&lt;strong>Name &amp;amp; Code&lt;/strong>: Assign a name and code to identify the roaming profile.&lt;/li>
&lt;li>&lt;strong>Type&lt;/strong>: Select &lt;strong>CPO&lt;/strong> (charge point operator).&lt;/li>
&lt;li>&lt;strong>Protocol&lt;/strong>: Select &lt;strong>OCPI&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>Roaming ID&lt;/strong>: Three-uppercase-letter identifier that will represent CPO in roaming.&lt;/li>
&lt;li>Submit configuration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Create Roaming Platform (PTP)&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Create a new &lt;strong>Roaming Platform&lt;/strong>:&lt;/li>
&lt;li>&lt;strong>Name &amp;amp; Code&lt;/strong>: Assign values to identify the platform.&lt;/li>
&lt;li>&lt;strong>Type&lt;/strong>: Select &lt;strong>Payment Terminal Provider (PTP)&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>URL&lt;/strong>: Enter the payment terminal provider&amp;rsquo;s back-office server URL (e.g., &lt;code>https://your-pos-provider.com/api/ocpi&lt;/code>).&lt;/li>
&lt;li>&lt;strong>Country&lt;/strong>: Select the origin country of the payment terminal provider.&lt;/li>
&lt;li>&lt;strong>Connection Initiation&lt;/strong>: Select which side will initiate the OCPI connection using the registration token.&lt;/li>
&lt;li>&lt;strong>Credentials Exchange (Token)&lt;/strong>:
&lt;ul>
&lt;li>If &lt;strong>PTP provides the token&lt;/strong>: Select &amp;ldquo;I will use token provided by my roaming partner&amp;rdquo; and enter the token in the field.&lt;/li>
&lt;li>If &lt;strong>CPO provides the token&lt;/strong>: Select &amp;ldquo;I will provide token to my roaming partner&amp;rdquo; and click &lt;strong>Generate&lt;/strong>. Share the generated token and your connection URL with the payment terminal provider.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Registration&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Communication must be initiated via registration.&lt;/li>
&lt;li>&lt;strong>Register credentials&lt;/strong>
&lt;ul>
&lt;li>If you used the partner&amp;rsquo;s token, click &amp;ldquo;Register credentials&amp;rdquo; on the selected Roaming Platform.&lt;/li>
&lt;li>If you provided the token, the payment terminal provider must initiate the registration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;strong>Update Credentials&lt;/strong>: Use &amp;ldquo;Update credentials&amp;rdquo; to renegotiate credentials if needed.&lt;/li>
&lt;li>&lt;strong>Invalidate Credentials&lt;/strong>: Use &amp;ldquo;Invalidate credentials&amp;rdquo; to stop communication/integration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ol>
&lt;p>&lt;img src="../sequence-ocpi.png" alt="OCPI sequence of operations.">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>OCPI communication sequence.&lt;/em>&lt;/p>
&lt;h3 id="charging-infrastructure-setup">Charging Infrastructure Setup&lt;/h3>
&lt;p>Once the CPO and PTP are communicating, the payment terminal provider can fetch the CPO&amp;rsquo;s charging infrastructure (Locations, EVSEs, Connectors). The CPO must populate specific roaming attributes to expose the infrastructure:&lt;/p>
&lt;ul>
&lt;li>&lt;strong>Area&lt;/strong>: Populate the &lt;code>roaming id&lt;/code> with a unique identifier and the &lt;code>phone number&lt;/code>.&lt;/li>
&lt;li>&lt;strong>Charger&lt;/strong>: Populate the &lt;code>roaming id&lt;/code> with a unique identifier and mark the &lt;code>roaming&lt;/code> attribute as &lt;strong>enabled&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>Connector&lt;/strong>: Populate the &lt;code>roaming id&lt;/code> with a unique identifier.&lt;/li>
&lt;/ul>
&lt;p>Locations and charging infrastructure are reported to the payment terminal provider (push mode) and can also be fetched (pull mode).&lt;/p>
&lt;h2 id="roaming-tariffs">Roaming Tariffs&lt;/h2>
&lt;p>As the charge point operator, you might want to assign roaming tariffs to represent prices for sessions initiated by payment terminal providers (PTP).
Set up the &lt;a href="../../roaming/roaming_tariffs.md">Roaming Tariff&lt;/a> for ad-hoc payments with the desired prices for energy and time, including taxes.
Tariff also contains the max. amount for payment authorization of the charging session.&lt;/p>
&lt;p>&lt;strong>Important Notes:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>Roaming tariffs calculate the expenses the payment terminal provider must pay to the charge point operator.&lt;/li>
&lt;li>These prices are not necessarily what the end customer (EV driver) pays.&lt;/li>
&lt;/ul>
&lt;p>&lt;strong>Configuration Guidelines:&lt;/strong>&lt;/p>
&lt;ol>
&lt;li>
&lt;p>&lt;strong>Create Roaming Tariff&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Navigate to &lt;strong>Roaming&lt;/strong> -&amp;gt; &lt;strong>Roaming Tariffs&lt;/strong>.&lt;/li>
&lt;li>Add a new tariff with a &lt;strong>Name&lt;/strong> and &lt;strong>Code&lt;/strong>.&lt;/li>
&lt;li>Set &lt;strong>Status&lt;/strong> to &lt;em>Active&lt;/em> and define the validity time range.&lt;/li>
&lt;li>Submit to create the tariff definition.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Add Tariff Details&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Inside the tariff, add &lt;strong>Tariff Details&lt;/strong>.&lt;/li>
&lt;li>&lt;strong>Recurrency&lt;/strong>: Select &lt;em>One-time&lt;/em> or &lt;em>Daily&lt;/em> recurring.&lt;/li>
&lt;li>&lt;strong>Priority&lt;/strong>: Higher priority details override lower ones if time frames overlap.&lt;/li>
&lt;li>&lt;strong>Time Frame&lt;/strong>: Determine the &lt;strong>inclusive start date-time&lt;/strong> and &lt;strong>exclusive stop date-time&lt;/strong>. Select on which days the Tariff Detail applies.&lt;/li>
&lt;li>&lt;strong>Pricing&lt;/strong>: Set the price and VAT percentage for rating metrics (energy, charge time, park time, flat, reservation time, etc.). Empty fields are treated as zero.&lt;/li>
&lt;li>Submit the configuration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Assign Tariff to Roaming Platform (PTP)&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Navigate back to &lt;strong>Roaming&lt;/strong> -&amp;gt; &lt;a href="../../roaming/roaming_platform.md">&lt;strong>Roaming Platforms&lt;/strong>&lt;/a>.&lt;/li>
&lt;li>Edit the specific Roaming Platform for the payment terminal provider configured earlier.&lt;/li>
&lt;li>In the setup wizard (usually Step 1), assign the &lt;strong>&lt;a href="../../roaming/roaming_tariffs.md">Roaming Tariff&lt;/a>&lt;/strong>.&lt;/li>
&lt;li>Submit the configuration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Assign Tariff to Charging Infrastructure&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>Navigate to any charging infrastructure level having the &lt;a href="../../sessions/#session-rating-settings">Session Settings&lt;/a> (also referred to as &lt;strong>Session Rating Profile&lt;/strong>), which is assigned to the charging infrastructure on different levels.&lt;/li>
&lt;li>Assign the &lt;strong>Roaming Tariff&lt;/strong> for the desired scope level:
&lt;ul>
&lt;li>&lt;strong>Site&lt;/strong>&lt;/li>
&lt;li>&lt;strong>Operator&lt;/strong>&lt;/li>
&lt;li>&lt;strong>Charger&lt;/strong>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Submit the configuration.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ol>
&lt;p>Once configured, &lt;strong>new charging sessions&lt;/strong> related to this payment terminal provider will have costs calculated based on these settings. Tariffs are reported to the payment terminal provider (push mode) and can also be fetched (pull mode).&lt;/p>
&lt;h2 id="charging-session-control">Charging Session Control&lt;/h2>
&lt;p>Operations by which the payment terminal provider can request the charge point operator of Tridens EV Charge to manage the charging session:&lt;/p>
&lt;ul>
&lt;li>Remote session start&lt;/li>
&lt;li>Remote session stop&lt;/li>
&lt;/ul>
&lt;p>Resulting and intermediate charging session actions are forwarded back to the payment terminal provider by API:&lt;/p>
&lt;ul>
&lt;li>Session start&lt;/li>
&lt;li>Session update&lt;/li>
&lt;li>Session end&lt;/li>
&lt;li>Charging infrastructure status changes&lt;/li>
&lt;li>Final consumption report&lt;/li>
&lt;/ul>
&lt;p>Session progress is reported to the payment terminal provider (push mode) and can also be fetched (pull mode).&lt;/p></description></item><item><title>Docs: Charging Identification Device Setup</title><link>/ev-charge-web-docs/integrations/charging-identification-device-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/charging-identification-device-setup/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#device-type-setup">Device Type Setup&lt;/a>&lt;/li>
&lt;li>&lt;a href="#device-setup">Device Setup&lt;/a>&lt;/li>
&lt;li>&lt;a href="#assign-device-to-the-customer">Assign Device to the Customer&lt;/a>&lt;/li>
&lt;li>&lt;a href="#resign-customers-device">Resign Customer’s Device&lt;/a>&lt;/li>
&lt;/ul>
&lt;p>These are instructions to set up charging identification devices, e.g., RFID, NFC or certificate and assign them to the customers (drivers).&lt;/p>
&lt;p>When the driver presents an identification device to the charger, for example by an RFID swipe, the charger requests the central system to identify and verify whether the driver is eligible to start the charging session.&lt;/p>
&lt;p>Consists of multiple steps:&lt;/p>
&lt;ul>
&lt;li>Device Type Setup&lt;/li>
&lt;li>Device Setup&lt;/li>
&lt;li>Assign Device to the Customer&lt;/li>
&lt;li>Resign Customer’s Device&lt;/li>
&lt;/ul>
&lt;h2 id="device-type-setup">Device Type Setup&lt;/h2>
&lt;p>Set up the device types, which are intended to be supported. E.g., RFID, NFC, VIN, MAC.&lt;/p>
&lt;p>Set up the device type first. To access this section in &lt;strong>Monetization&lt;/strong>, from the &lt;i class="fa fa-bars" aria-hidden="true">&lt;/i> &lt;strong>Menu&lt;/strong>, click &lt;i class="fa fa-mobile" aria-hidden="true">&lt;/i> &lt;strong>Devices&lt;/strong>. Open &lt;strong>Device Type&lt;/strong> section tab on top. Use the green &lt;strong>Create new&lt;/strong> button on the top right corner, so the creation form shows up.&lt;/p>
&lt;p>Determine device type name as you desire and assign the code by one of the predefined code tags, which depend on the identification technology to be used, e.g., “RFID”. See the table of predefined device type code tags. You may also use the description box, to append additional helpful information and submit the creation form.&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Code Tag&lt;/th>
&lt;th>Description&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>RFID&lt;/td>
&lt;td>Radio-frequency identification. Represents a badge or card of the driver.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>NFC&lt;/td>
&lt;td>Near field communication. Represents mobile or badge device of the driver.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>VIN&lt;/td>
&lt;td>Vehicle identification number. Represents a vehicle.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>MAC&lt;/td>
&lt;td>Media access control address, as unique device identifier in the network. &lt;br> May represents a vehicle or other device&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>ISO15118&lt;/td>
&lt;td>Plug &amp;amp; charge of ISO 15118 for vehicle/driver identification. &lt;br> Represents a charging service contract of the vehicle and driver.&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>&amp;hellip;&lt;/td>
&lt;td>&lt;em>You can define your custom type as well.&lt;/em>&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>&lt;em>&lt;strong>Table 1:&lt;/strong>&lt;/em> &lt;em>Device type’s predefined code tags, representing an identification technology.&lt;/em>&lt;/p>
&lt;h2 id="device-setup">Device Setup&lt;/h2>
&lt;p>Set up an instance of device. On the left side navigation, open the &lt;i class="fa fa-mobile" aria-hidden="true">&lt;/i> &lt;strong>Devices&lt;/strong> section. Move the the &lt;strong>Device&lt;/strong> section tab on top. Use the green &lt;strong>Create new&lt;/strong> button on the top right corner, so the creation form shows up.&lt;/p>
&lt;p>Assign name and code, as best suits you, select the belonging device type, for example an RFID.&lt;/p>
&lt;p>Populate the &lt;strong>Identifier&lt;/strong> field by the unique identification value, which is transferred from the charger to the central system, to be verified later when for example swiping an RFID. Submit the form.&lt;/p>
&lt;h2 id="assign-device-to-the-customer">Assign Device to the Customer&lt;/h2>
&lt;p>Once an identification device instance is set up, it is ready to be assigned to an existing customer (driver) with subscription plan.&lt;/p>
&lt;p>To access this section in &lt;strong>Monetization&lt;/strong>, from the &lt;i class="fa fa-bars" aria-hidden="true">&lt;/i> &lt;strong>Menu&lt;/strong>, click &lt;i class="fa fa-users" aria-hidden="true">&lt;/i> &lt;strong>Customers&lt;/strong> and find the customer for which you would like to assign a device. Open up the customer details by &lt;i class="fa fa-info-circle" aria-hidden="true">&lt;/i> &lt;strong>Info&lt;/strong> button on the right side, under actions column. Then move to the &lt;strong>Subscriptions&lt;/strong> section and expand the subscription which is desired to have an identification device assigned.&lt;/p>
&lt;p>Move down to the &lt;strong>Services&lt;/strong> section and find the one which is named &lt;code>CHARGING_SERVICE&lt;/code> (also &lt;code>QUANTITY_CHARGING_SERVICE&lt;/code> or similar - depends on the catalogue configuration) entry and hit &lt;strong>Edit&lt;/strong> action. Edit the service’s &lt;strong>Device&lt;/strong> column and search for the previously set up identification device, assign it and hit &lt;strong>Submit&lt;/strong> action to update the service.&lt;/p>
&lt;p>&lt;img src="../find-a-customer.png" alt="Find a customer">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Find a customer&lt;/em>&lt;/p>
&lt;p>&lt;img src="../customer-subscriptions.png" alt="Customer Subscription">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Expand customer’s subscription and find the suitable service&lt;/em>&lt;/p>
&lt;p>&lt;img src="../device-service.png" alt="Device Service">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 3:&lt;/strong>&lt;/em> &lt;em>Assign device to service&lt;/em>&lt;/p>
&lt;p>Once identification device is assigned to the customer, swiping it (e.g., an RFID card) on the charger will result in charger requesting the central system to verify the device. This is called authorization, by which central system identifies the customer driver and verifies her/his monetary eligibility to start charging.&lt;/p>
&lt;p>Once authorization is accepted, the charger is expected to allow the charging process to start.&lt;/p>
&lt;div class="alert alert-primary" role="alert">
&lt;h4 class="alert-heading">Note:&lt;/h4>
&lt;p>Make sure that the customer to which an identification device is assigned has a valid subscription plan with a service, so the customer can be verified if eligible to charge.&lt;/p>
&lt;p>If customer is pay-now, make sure credit card is assigned as well.&lt;/p>
&lt;p>One device can be assigned to one customer at a time.&lt;/p>
&lt;/div>
&lt;h2 id="resign-customers-device">Resign Customer’s Device&lt;/h2>
&lt;p>When there is intention to remove an identification device from the customer, it can be done by navigating to the customer’s details view, as stated in section &lt;a href="#assign-device-to-the-customer">Assign Device to the Customer&lt;/a>. Edit an existing service on hitting the cross button on the device, which is desired to be removed. Hit &lt;strong>Submit&lt;/strong> action to update the service.&lt;/p>
&lt;p>&lt;img src="../resign-customer-device.png" alt="Resign Customer Device">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 4:&lt;/strong>&lt;/em> &lt;em>Resign customer&amp;rsquo;s service&lt;/em>&lt;/p></description></item><item><title>Docs: FTP Server Setup</title><link>/ev-charge-web-docs/integrations/ftp-server-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/ftp-server-setup/</guid><description>
&lt;p>Download and install an SFTP/FTP software, for example, FileZilla .
Run it as a server on your platform/computer, and provide the URL to EV Charge dialog to request the charger to use the FTP to upload/download files.&lt;/p>
&lt;p>Here is the step-by-step tutorial for the FileZilla software.&lt;/p>
&lt;p>&lt;strong>1. Download the FileZilla&lt;/strong>&lt;/p>
&lt;p>Download the FileZilla server installer uitable for your MacOS/Windows/Linux platform from FileZilla - The free FTP solution.&lt;/p>
&lt;p>&lt;strong>2. FileZilla Setup&lt;/strong>&lt;/p>
&lt;p>a. Run the installer.&lt;/p>
&lt;p>b. Check the licence agreement.&lt;/p>
&lt;p>c. Among the components, select at least &lt;em>Server&lt;/em> and &lt;em>Administration Interface&lt;/em>.&lt;/p>
&lt;p>&lt;img src="../admin-interface.png" alt="Administration Interface">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Administration Interface&lt;/em>&lt;/p>
&lt;p>d. Choose the installation directory. Default value can be used.&lt;/p>
&lt;p>e. Choose how FileZilla&amp;rsquo;s server is started. Manually (advised for usage on demand) or automatically at system start.&lt;/p>
&lt;p>f. Assign adminstration interface&amp;rsquo;s listenting communication port. Default value can be used.&lt;/p>
&lt;p>g. Protect your administration interface with the password and choose how administration interface is initiated (manually advised).&lt;/p>
&lt;p>&lt;strong>3. FTP setup&lt;/strong>&lt;/p>
&lt;p>a. Once you open up the FileZilla Server, you can connect into it by using administration interface. Use host (&lt;code>localhost&lt;/code> or &lt;code>127.0.0.1&lt;/code>), port (as configured in FileZilla setup step) and password (as configured in FileZilla setup step)&lt;/p>
&lt;p>b. Assign a directory on your platform&amp;rsquo;s file system which will be shared. Use an existing directory or create a new directory on your desired path, e.g., &lt;code>C:\shared-directory&lt;/code>.&lt;/p>
&lt;p>c. FTP Users Setup&lt;/p>
&lt;p>i. Open up the FileZilla configuration of user rights management (navigate by &lt;em>Server -&amp;gt; Configure -&amp;gt; Rights Management -&amp;gt; Users&lt;/em>).&lt;/p>
&lt;p>&lt;img src="../users.png" alt="Users setup">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Users setup&lt;/em>&lt;/p>
&lt;p>ii. Hit &lt;em>Add User&lt;/em> and perform the following:&lt;/p>
&lt;ol>
&lt;li>Assign the user&amp;rsquo;s name (e.g., &amp;lsquo;mikejones&amp;rsquo;).&lt;/li>
&lt;/ol>
&lt;p>&lt;img src="../users-2.png" alt="Users setup-2">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 3:&lt;/strong>&lt;/em> &lt;em>Assigning the user&amp;rsquo;s name&lt;/em>&lt;/p>
&lt;ol start="2">
&lt;li>Determine the password if selecting &lt;em>Require the password to log in&lt;/em>.&lt;/li>
&lt;/ol>
&lt;p>&lt;img src="../password-login.png" alt="Password Login">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 4:&lt;/strong>&lt;/em> &lt;em>Password Login&lt;/em>&lt;/p>
&lt;ol start="3">
&lt;li>Add a mount point. Assign the native path &lt;code>C:\shared-directory&lt;/code>, meanwhile virtual path represents what FTP users can see.&lt;/li>
&lt;/ol>
&lt;p>&lt;img src="../settings-server.png" alt="Settings server">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 5:&lt;/strong>&lt;/em> &lt;em>Mount point settings&lt;/em>&lt;/p>
&lt;ol start="4">
&lt;li>Assign access rights on the right side, whether users are allowed to read or read/write.&lt;/li>
&lt;/ol>
&lt;p>d. FTP Port Setup&lt;/p>
&lt;p>To set up the FTP port, follow the steps below:&lt;/p>
&lt;p>i. Open up the network configuration wizard (navigate by &lt;em>Server → Network Configuration Wizard&lt;/em>).&lt;/p>
&lt;p>&lt;img src="../network-wizard.png" alt="Configuration Wizard">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 6:&lt;/strong>&lt;/em> &lt;em>Network Configuration Wizard&lt;/em>&lt;/p>
&lt;p>ii. Assign the port range, e.g. 30050-30055.&lt;/p>
&lt;p>iii. Assign public IP address or hostname. This is the address by which your FTP will be accessed. Assing your device&amp;rsquo;s public IP by which your device will be accessible. Alternativelly you can use the domain, if available.&lt;/p>
&lt;p>iv. Make sure your platform&amp;rsquo;s firewall has inbound/outbound TCP ports open for the communication on 30050-30055.&lt;/p>
&lt;p>&lt;img src="../protocols-ports.png" alt="Ports and Protocols">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 7:&lt;/strong>&lt;/em> &lt;em>Ports and Protocols&lt;/em>&lt;/p>
&lt;p>The contents of configured directory &lt;code>C:\shared-directory&lt;/code> are now accessble to the FTP user, which can connect to FTP server by using the platform/computer’s IP, for example &lt;code>ftp://miikejones:testpassword@192.168.5.1:30050&lt;/code>.&lt;/p></description></item><item><title>Docs: Log Notifications Setup</title><link>/ev-charge-web-docs/integrations/log-notifications-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/log-notifications-setup/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#configuration">Configuration&lt;/a>
&lt;ul>
&lt;li>&lt;a href="#basic-example">Basic Example&lt;/a>&lt;/li>
&lt;li>&lt;a href="#advanced-example">Advanced Example&lt;/a>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>&lt;a href="#reading-the-logs">Reading the Logs&lt;/a>&lt;/li>
&lt;/ul>
&lt;p>Tridens EV Charge platform can be utilized to log and review the occurred events by the charging infrastructure or those related to the charging sessions control. Feature is called &lt;em>log notifications&lt;/em> and is based on the instructions of &lt;a href="../../system-configuration/notifications">System Configuration - Notifications&lt;/a>, where logging notifications configuration can be made by the &lt;strong>Log&lt;/strong> publishers.&lt;/p>
&lt;h2 id="configuration">Configuration&lt;/h2>
&lt;p>Operators can configure to be notified on the wide range of events, related to the charging infrastructure availability and charging session control.&lt;/p>
&lt;p>A few events to consider enabling for log notifications, so the operators can track the charging infrastructure’s behavior:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>Station connected&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Station disconnected&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Connector status changed&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Reservation created&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Reservation canceled&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session started&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session refused&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session’s charging ended&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session ended&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session’s state-of-charge (EV battery) limit breached&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session’s charge time limit breached&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session’s park time limit breached&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session’s fault time limit breached&lt;/p>
&lt;/li>
&lt;/ul>
&lt;p>For the complete list of actions in different scopes, see &lt;a href="../../system-configuration/notifications">Notifications&lt;/a>.&lt;/p>
&lt;h3 id="basic-example">Basic Example&lt;/h3>
&lt;p>Basic example is represented in &lt;em>Figure 1&lt;/em> about adding a new logging notification configuration for the event when the charging station successfully connects to the central system of Tridens EV Charge. Log publisher is used with the default template format, as template attribute remained unselected.&lt;/p>
&lt;p>&lt;img src="../basic-example-configuration.png" alt="Log Notification config charging station&amp;amp;rsquo;s connection">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Log notification configuration for charging station’s connection establishment with the central system.&lt;/em>&lt;/p>
&lt;br/>
&lt;h3 id="advanced-example">Advanced Example&lt;/h3>
&lt;p>Advanced example is represented by Figures 2 and 3, where Figure 2 shows the logging notification configuration for the event when monetary limit of 50€ has been breached for the customer’s charging session. Filter &lt;strong>Monetary limit&lt;/strong> is mandatory for the event and is set to 50€ threshold in this case. Instead of a default logging notification template, the custom configured notification template named as ‘Monetary Limit Breach 50€&amp;rsquo; can be used. Figure 2 shows such notification template configuration on the different section of the UI.&lt;/p>
&lt;p>&lt;img src="../advanced-example-configuration.png" alt="Log Notification config for charging session">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Log notification configuration for the charging session’s monetary limit breach of 50€.&lt;/em>&lt;/p>
&lt;br/>
&lt;p>&lt;img src="../advanced-example-configuration-2.png" alt="Notification template configuration">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 3:&lt;/strong>&lt;/em> &lt;em>Notification template configuration for monetary limit breach of 50€ for the charging session.&lt;/em>&lt;/p>
&lt;br/>
&lt;h2 id="reading-the-logs">Reading the Logs&lt;/h2>
&lt;p>Navigate to &lt;i class="fa fa-car" aria-hidden="true">&lt;/i> &lt;strong>Stations&lt;/strong> and select the specific station for which you would like to review its logs and click &lt;i class="fa fa-info-circle" aria-hidden="true">&lt;/i> under &lt;strong>Actions&lt;/strong> to view station details. On the top right icons on the specific station&amp;rsquo;s page, click &lt;strong>View logs&lt;/strong> icon (&lt;em>Figure 4&lt;/em>).&lt;/p>
&lt;br/>
&lt;p>&lt;img src="../charging-station-notification-logs.png" alt="Charging station’s notification logs">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 4:&lt;/strong>&lt;/em> &lt;em>Navigating to view the charging station’s notification logs.&lt;/em>&lt;/p>
&lt;br/>
&lt;p>The paginated logs view shows up, as in Figure 5.
Time filters can be used to restrict the results range. Use &lt;strong>Preferences&lt;/strong> to manage pagination and appearance.&lt;/p>
&lt;p>&lt;img src="../filtering-logs.png" alt="Filtering logs">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 5:&lt;/strong>&lt;/em> &lt;em>Filtering the logs.&lt;/em>&lt;/p></description></item><item><title>Docs: Notifications Guidelines</title><link>/ev-charge-web-docs/integrations/notifications-guidelines/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/notifications-guidelines/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#notifications-setup-guidelines-in-general">Notifications Setup Guidelines in General&lt;/a>&lt;/li>
&lt;li>&lt;a href="#notifying-ev-drivers">Notifying EV Drivers&lt;/a>&lt;/li>
&lt;li>&lt;a href="#notifying-the-operators">Notifying the Operators&lt;/a>&lt;/li>
&lt;/ul>
&lt;h2 id="notifications-setup-guidelines-in-general">Notifications Setup Guidelines in General&lt;/h2>
&lt;p>Charging providers usually want to enable the notifying features, so they can inform the EV drivers about the status of their charging session or to inform themselves about the status of the charging infrastructure.&lt;/p>
&lt;p>This section can serve as a guide on the options which can be utilized for the notifying.
Base general steps for configuring the notifications can be found in &lt;a href="../../system-configuration/notifications/">Notifications&lt;/a> section.&lt;/p>
&lt;p>See the following references to find notifications setup technologies:&lt;/p>
&lt;ul>
&lt;li>&lt;a href="../log-notifications-setup/">Log Notifications Setup&lt;/a>&lt;/li>
&lt;li>&lt;a href="../push-notifications/">Push Notifications Setup&lt;/a>&lt;/li>
&lt;li>&lt;a href="../email-notifications-setup/">Email Notifications Setup&lt;/a>&lt;/li>
&lt;li>&lt;a href="../sms-notifications/">SMS Notifications Setup&lt;/a>&lt;/li>
&lt;/ul>
&lt;h2 id="notifying-ev-drivers">Notifying EV Drivers&lt;/h2>
&lt;p>EV drivers (also end users, end customers), usually want to be notified about the status of the charging sessions.
Setup of these kind of notifications differs based on the session handling configuration, as described in &lt;a href="../../sessions/#session-rating-settings">Sessions - Session Rating Settings&lt;/a>.
Full list of available notification actions is described in &lt;a href="../../system-configuration/notifications/#notification-scopes-and-actions">Notifications Scopes and Actions&lt;/a>.&lt;/p>
&lt;p>The most used actions for notifying the EV drivers during the session by using the push notifications or SMS for mobile devices are the following:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>Charging end - Indicating that session’s charging has ended, but parking fees may apply after. You can notify the driver that the charging process is done and prompt them to remove the vehicle.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Battery percentage limit - Indicating that certain amount of battery percentage (configurable) has been breached for the session, if reported by the charger. E.g., EV battery achieved 85%.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Energy limit - Indicating that certain amount of energy in kWh (configurable) has been spent for the session so far. E.g., EV session’s energy consumption achieved 40 kWh.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Charge time limit - Indicating that certain time for charging (configurable) has been spent for the session so far. E.g., EV session charging duration achieved 30 minutes.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Park time limit - Indicating that the certain parking time (configurable) has been spent for the session so far. E.g., EV session in parking mode duration achieved 15 minutes. Prompt driver to remove the vehicle and release the spot.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Park time threshold breach - Indicating that the parking time spent for the session has achieved the configured rating threshold of the EV charging session. From this point, parking time fees may apply. Based on configuration of &lt;a href="../../sessions/#session-rating-settings">Sessions - Session Rating Settings&lt;/a>.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Monetary limit - Indicating that certain amount of money (configurable) has been spent for the session so far. E.g., EV session charging cost achieved 25€.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;p>For the cases of notifying EV drivers by an email, the following actions may be useful:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>Session end - Indicating that the charging session has ended and summary can be published.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Session refused - Indicating that the charging session didn’t succeed, as initial authorization of customer’s resources didn’t succeed.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;p>Notifications are headed to the session’s driver/customer, when an action is related to the specific customer and notification rule’s receiver of type ‘Customer’ is selected. See Fig. 1 below.
Applies for the session related actions, as these are customer related. Customer’s primary contact info is used for it, so push notification reference, email or phone number for SMS is taken from there.&lt;/p>
&lt;p>See &lt;a href="../../system-configuration/notifications/#create-notification">Notifications - Create Notification Rule&lt;/a> section.&lt;/p>
&lt;p>&lt;img src="../rule-notification-ev-charging-session.png" alt="Exampple Rule Notifications for EV Charge Session">&lt;/p>
&lt;p>&lt;strong>Fig. 1:&lt;/strong> &lt;em>Example of notification rule configuration headed to the customer when the EV charging session ends.&lt;/em>&lt;/p>
&lt;p>Content formatting definition example:&lt;/p>
&lt;pre tabindex="0">&lt;code>Charging session ${object.contents.session.id?c!&amp;#39;/&amp;#39;} ended.
Consumed ${object.contents.session.totalEnergy?c!&amp;#39;/&amp;#39;}kWh for the cost of ${object.contents.session.usedAmount?c!&amp;#39;/&amp;#39;}€.
&lt;/code>&lt;/pre>&lt;p>Results in:&lt;/p>
&lt;p>&lt;em>Charging session 9718 ended. Consumed 29.33kWh for the cost of 8.28€.&lt;/em>&lt;/p>
&lt;h2 id="notifying-the-operators">Notifying the Operators&lt;/h2>
&lt;p>Operators may be interested in being notified when significant changes appear on the charging infrastructure. Informing can be done by an email, SMS, logging or API call.
Full list of available notification actions is described in &lt;a href="../../system-configuration/notifications/#notification-scopes-and-actions">Notifications Scopes and Actions&lt;/a>.&lt;/p>
&lt;p>Actions which can be especially helpful to operators:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>Station connected - Indicating that the charging station has established a connection with the central system of Tridens EV Charge. If re-connections are happening, the station may need an urgent review.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Station disconnected - Indicating that the charging station has been disconnected from the central system of Tridens EV Charge. May need an urgent review, as connected station is necessary for availability of operations.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Station booted - Indicating that charging station has sent the boot notification. If the boot was not intentionally triggered, it may need a review.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Status changed - Indicating that the charger’s or connector’s status has changed. Advised to use notification for the transition to the ‘faulted’ status, as it usually needs to be troubleshooted.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>Fault time limit - Indicating that certain fault time (configurable) has been spent for the charging session so far. E.g., EV session in fault mode duration breached 5 mintues. Needs operator’s review.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;p>Operator related notifications are usually headed to the specific address (i.e. email), hence notification rule’s receiver of type ‘Base’ is usually selected with the contact populated. See Fig. 2 below.&lt;/p>
&lt;p>Alternativelly, email sender (&lt;em>from&lt;/em>) can be determined on email template as well.&lt;/p>
&lt;p>See &lt;a href="../../system-configuration/notifications/#create-notification">Notifications - Create Notification Rule&lt;/a> section.&lt;/p>
&lt;p>&lt;img src="../rule-notification-specific-operator.png" alt="Example Rule Notification Config for Specific Operator">&lt;/p>
&lt;p>&lt;strong>Fig. 2:&lt;/strong> &lt;em>Example of notification rule configuration headed to the specific operator’s email address when the charging station device disconnects from the central system and the occasion needs to be reviewed.&lt;/em>&lt;/p>
&lt;p>Content formatting definition example:&lt;/p>
&lt;pre tabindex="0">&lt;code>Charging station ${object.contents.charging_station.name!&amp;#39;/&amp;#39;} has disconnected from the central system. Id:${object.contents.charging_station.id?c!&amp;#39;/&amp;#39;} Code:${object.contents.charging_station.code!&amp;#39;/&amp;#39;} Address: ${object.contents.charging_station.address!&amp;#39;/&amp;#39;} ZIP: ${object.contents.charging_station.zip!&amp;#39;/&amp;#39;} City: ${object.contents.charging_station.city!&amp;#39;/&amp;#39;} Country: ${object.contents.charging_station.country!&amp;#39;/&amp;#39;} Latitude: ${object.contents.charging_station.latitude?c!&amp;#39;/&amp;#39;} Longitude: ${object.contents.charging_station.longitude?c!&amp;#39;/&amp;#39;}
&lt;/code>&lt;/pre>&lt;p>Results in:&lt;/p>
&lt;p>&lt;em>Charging station Tridens Building has disconnected from the central system. Id:5274 Code:f1db01db-3f7c-4804-9d9a-e54cb1037040 Address: Titova 2a ZIP: 2000 City: Maribor Country: SI Latitude: 46.56007700000001 Longitude: 15.6510651.&lt;/em>&lt;/p></description></item><item><title>Docs: Push Notifications Setup</title><link>/ev-charge-web-docs/integrations/push-notifications-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/push-notifications-setup/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#push-notifications-provider-configuration">Push Notifications Provider Configuration&lt;/a>&lt;/li>
&lt;li>&lt;a href="#notification-template">Notification Template&lt;/a>&lt;/li>
&lt;li>&lt;a href="#notification-rules-configuration">Notification Rules Configuration&lt;/a>&lt;/li>
&lt;/ul>
&lt;p>Set up push notifications for Tridens EV Charge using a third-party solution.
Once configuration is established and the configured notification action happens, push notification is expected on the targeting driver/customer device.&lt;/p>
&lt;h2 id="push-notifications-provider-configuration">Push Notifications Provider Configuration&lt;/h2>
&lt;p>First of all, configuring the push notifications provider is required. Currently, Firebase is available. See &lt;a href="../../system-configuration/notifications/#firebase-configuration">System Configuration - Firebase Configuration&lt;/a>.&lt;/p>
&lt;h2 id="notification-template">Notification Template&lt;/h2>
&lt;p>In the next step, we need to determine the push notification template(s).
To achieve this, go to &lt;i class="fa fa-cogs" aria-hidden="true">&lt;/i> &lt;strong>Business Configuration&lt;/strong> → &lt;strong>Templates&lt;/strong> → &lt;strong>Push Notification Templates&lt;/strong>. There you can manage the message templates. &lt;em>Name&lt;/em> the template, assign &lt;em>code&lt;/em> as alphanumeric identifier, apply &lt;em>description&lt;/em> if necessary and most importantly, enter the formatted content.&lt;/p>
&lt;p>See &lt;a href="../../business-configuration/templates/#push-notification-templates">Business Configuration - Templates - Push Notification Templates&lt;/a> for more details.&lt;/p>
&lt;h2 id="notification-rules-configuration">Notification Rules Configuration&lt;/h2>
&lt;p>Then proceed to the notification rules configuration.
Go to &lt;i class="fa fa-cog" aria-hidden="true">&lt;/i> &lt;strong>System Configuration&lt;/strong> → &lt;strong>Notifications&lt;/strong> → &lt;strong>Notifications&lt;/strong> and edit your existing configurations. In the &lt;strong>Publishers&lt;/strong> section, add and select new &lt;strong>Push&lt;/strong> action.
No need to specify any specific ‘Receivers’, as such notifications are headed to the action’s belonging customer device directly. See Fig. 1 below.&lt;/p>
&lt;p>&lt;img src="../notification-rule-configuration-push-publisher.png" alt="Notification rule configuration with push publisher">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Notification rule configuration with push publisher.&lt;/em>&lt;/p></description></item><item><title>Docs: SMS Notifications Setup</title><link>/ev-charge-web-docs/integrations/sms-notifications-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/sms-notifications-setup/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#sms-provider-configuration">SMS Provider Configuration&lt;/a>&lt;/li>
&lt;li>&lt;a href="#sms-template">SMS Template&lt;/a>&lt;/li>
&lt;li>&lt;a href="#notification-rules-configuration">Notification Rules Configuration&lt;/a>&lt;/li>
&lt;/ul>
&lt;p>Set up SMS notifications for the actions on Tridens EV Charge.
Once configuration is established and the configured notification action happens, SMS notification is expected on the targeting receiver.&lt;/p>
&lt;h2 id="sms-provider-configuration">SMS Provider Configuration&lt;/h2>
&lt;p>First of all, configuring the SMS notifications provider is required. Currently, Twilio provider is available.&lt;/p>
&lt;p>Once you register on &lt;a href="https://www.twilio.com/en-us">Twilio&lt;/a>, you can manage your provider configuration in Tridens EV Charge’s dashboard by navigating to &lt;i class="fa fa-cog" aria-hidden="true">&lt;/i> &lt;strong>System Configuration&lt;/strong> → &lt;strong>Platforms&lt;/strong> and select &lt;strong>Twilio&lt;/strong>.&lt;/p>
&lt;p>Once the form shows up, insert the phone number (E.164 format), client id and client secret, which was provided to you by Twilio following the registration.&lt;/p>
&lt;h2 id="sms-template">SMS Template&lt;/h2>
&lt;p>In the next step, we need to determine the SMS template(s).
To achieve this, go to &lt;i class="fa fa-cogs" aria-hidden="true">&lt;/i> &lt;strong>Business Configuration&lt;/strong> → &lt;strong>Templates&lt;/strong> → &lt;strong>SMS Templates&lt;/strong>.&lt;/p>
&lt;p>There you can manage the message templates. &lt;em>Name&lt;/em> the template, assign &lt;em>code&lt;/em> as alphanumeric identifier and apply &lt;em>description&lt;/em>, if helpful. Then define the dynamically formattable content, which represents an actual content of the SMS notification message.&lt;/p>
&lt;p>See &lt;a href="../../business-configuration/templates/#sms-templates">Business Configuration - Templates - SMS Templates&lt;/a> for more details.&lt;/p>
&lt;p>&lt;img src="../sms-template.png" alt="sms-template">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>SMS template creation&lt;/em>&lt;/p>
&lt;h2 id="notification-rules-configuration">Notification Rules Configuration&lt;/h2>
&lt;p>Then proceed to the notification rules configuration.
Go to &lt;i class="fa fa-cog" aria-hidden="true">&lt;/i> &lt;strong>System Configuration&lt;/strong> → &lt;strong>Notifications&lt;/strong> → &lt;strong>Notifications&lt;/strong> and edit your existing configurations. In the &lt;strong>Publishers&lt;/strong> section, add and select new &lt;strong>SMS&lt;/strong> action.&lt;/p>
&lt;p>In the &lt;strong>Receivers&lt;/strong> sub-section of a &lt;strong>Publisher&lt;/strong>, add the necessary receivers, as desired:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>&lt;em>Base&lt;/em>: Enter the specific phone number to which the SMS notification should be sent for the action.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>&lt;em>Customer&lt;/em>: SMS notification targets to the destination of customer’s primary contact info phone number, if action is related to the specific customer. Applies for the session related actions, as these are related to the customer. Additionally, as a value, Customer Type group can be selected, meaning that SMS notification will apply only if the customer belongs to the specific customer group.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;p>&lt;img src="../notification-rule-configuration-sms-publisher.png" alt="Notification rule configuration with the SMS publisher">&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Notification rule configuration with the SMS publisher&lt;/em>&lt;/p></description></item><item><title>Docs: Email Notifications Setup</title><link>/ev-charge-web-docs/integrations/email-notifications-setup/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>/ev-charge-web-docs/integrations/email-notifications-setup/</guid><description>
&lt;p>&lt;strong>Topics in this document:&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>&lt;a href="#email-server-smtp-configuration">Email Server (SMTP) Configuration&lt;/a>&lt;/li>
&lt;li>&lt;a href="#email-template">Email Template&lt;/a>&lt;/li>
&lt;li>&lt;a href="#notification-rules-configuration">Notification Rules Configuration&lt;/a>&lt;/li>
&lt;/ul>
&lt;p>Set up email notifications for the actions on Tridens EV Charge. Once configuration is established and the configured notification action happens, email notification is expected on the targeting receiver.&lt;/p>
&lt;h2 id="email-server-smtp-configuration">Email Server (SMTP) Configuration&lt;/h2>
&lt;p>First step to enable email notifications is to equip yourself with an email server, usually by utilizing the email server hosting provider.&lt;/p>
&lt;p>Once Simple Mail Transfer Protocol (SMTP) email server is established, enter the SMTP settings into environment of Tridens EV Charge - these settings are manageable in the &lt;a href="../../site/#site-settings">Site settings&lt;/a> section.
At the point when SMTP host server is configured on environment with &lt;code>username&lt;/code>, &lt;code>password&lt;/code>, &lt;code>host&lt;/code> and &lt;code>port&lt;/code>, proceed to configuring the notification template.&lt;/p>
&lt;h2 id="email-template">Email Template&lt;/h2>
&lt;p>In the next step, we need to determine the email template(s).
To achieve this, go to &lt;i class="fa fa-cogs" aria-hidden="true">&lt;/i> &lt;strong>Business Configuration&lt;/strong> → &lt;strong>Templates&lt;/strong> → &lt;strong>Email Templates&lt;/strong>.&lt;/p>
&lt;p>There you can manage the message templates. &lt;em>Name&lt;/em> the template, assign &lt;em>code&lt;/em> as alphanumeric identifier and apply &lt;em>description&lt;/em>, if helpful. Determine the &lt;em>subject&lt;/em> which will appear on the emails. &lt;em>From, to, carbon-copy, blind-carbon-copy&lt;/em> and &lt;em>reply-to&lt;/em> are optional - note that &lt;em>from&lt;/em> (source) can be auto-assigned based on your email server and &lt;em>to&lt;/em> (destination) also gets populated by the notification rule’s receivers, as defined in &lt;a href="../../system-configuration/notifications">System Configuration - Notifications&lt;/a>.&lt;/p>
&lt;p>The most important part comes at the bottom, where dynamically formattable content can be defined by using the content builder.&lt;/p>
&lt;p>See &lt;a href="../../business-configuration/templates/#mail-templates">Business Configuration - Templates - Email Templates&lt;/a> for more details.&lt;/p>
&lt;p>&lt;em>&lt;strong>Figure 1:&lt;/strong>&lt;/em> &lt;em>Email template creation.&lt;/em>&lt;/p>
&lt;p>&lt;img src="../email-template-creation.png" alt="Email template creation">&lt;/p>
&lt;h2 id="notification-rules-configuration">Notification Rules Configuration&lt;/h2>
&lt;p>Then proceed to the notification rules configuration.
Go to &lt;i class="fa fa-cog" aria-hidden="true">&lt;/i> &lt;strong>System Configuration&lt;/strong> → &lt;strong>Notifications&lt;/strong> → &lt;strong>Notifications&lt;/strong> and edit your existing configurations.
In the &lt;strong>Publishers&lt;/strong> section, add and select new &lt;strong>Email&lt;/strong> action.&lt;/p>
&lt;p>In the &lt;strong>Receivers&lt;/strong> sub-section of a &lt;strong>Publisher&lt;/strong>, add the necessary receivers, as desired:&lt;/p>
&lt;ul>
&lt;li>
&lt;p>&lt;em>Base&lt;/em>: Enter the specific email address to which the notification should be sent.&lt;/p>
&lt;/li>
&lt;li>
&lt;p>&lt;em>Customer&lt;/em>: Notification targets to the destination of customer’s primary contact info email, if action is related to the specific customer. Applies for the session related actions, as these are related to the customer. Additionally, as a value, &lt;em>Customer Type&lt;/em> group can be selected, meaning that notification will apply only if the customer belongs to the specific customer group.&lt;/p>
&lt;/li>
&lt;/ul>
&lt;p>&lt;em>&lt;strong>Figure 2:&lt;/strong>&lt;/em> &lt;em>Notification rule configuration with the email publisher.&lt;/em>&lt;/p>
&lt;p>&lt;img src="../notification-rule-email-publisher.png" alt="Notification rule configuration">&lt;/p></description></item></channel></rss>