Glossary

CDR

It stands for Charge Detail Record it's an object sent from Enel to us once a charge is over.

Informations stored

• The timestamp of the start of the charge (when the POC starts delivering energy)
• The timestamp of the end of the charge (when the POC stops delivering energy, when the user stops the charge or when the car is charged for example)
• The timestamp of the start of the session (when user asks for a charge to start)
• The timestamp of the end of the session (when user detached the cable)
• The charge consumption in kWh
• The penalty duration
• The reason why the charge ended (remote stop, unplug the cable,...)
• The session id of the charge
• Authentication data to trace the user who charged

Key concepts

• It can arrive only after that the user detached the cable
• Usually it takes some seconds to some minutes for it to arrive. Sometimes, when Enel has errors, it can take hours or days or it can happen that the CDR doesn't arrive at all. This is totally out of our control
• It's the only way we have to tell users how much they have to pay. During the charge we see of course some consumption data and costs, but the only reliable way to know how much a user has to pay is the CDR

Little recap of the flow:

User detaches the cable ->

after an unpredictable time our api receives the CDR from Enel ->

from now on we can notify the user that he has to pay, the amount, the consumption, the penalty (if present), ecc...

Remote start

It's an operation performed by the user mobile app to start a charge

Remote stop

It's an operation performed by the user mobile app to stop a charge

Charge statuses

• PENDING
• BOOKED
• LOCALLY_BOOKED
• FAILED
• EXPIRED
• ACTIVE
• STAND_BY
• STAND_BY_WITH_PENALTY
• STOPPED
• STOPPED_WITH_PENALTY
• DELETED
• COMPLETED

Charge card

Charge cards are issued by Enel and assigned univocally to single users.

Every card has an 8-digit external code printed on it.

Every card has a 14-digit hexadecimal uid stored in the ROM of the MIFARE chip.

Cards can assume different statuses (ACTIVE, IDLE, BLOCKED, DISABLED (permanently))