Difference between revisions of "Glossary"

From Wiquipedia
Jump to navigation Jump to search
Line 14: Line 14:
  
 
* It can arrive only after that the user detached the cable
 
* It can arrive only after that the user detached the cable
* Usually it takes 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
+
* 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
 
* 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
  

Revision as of 13:32, 25 June 2021

CDR

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

It contains various infos about the charge like:
  • The timestamp of the start of the charge
  • The timestamp of the end of the charge
  • 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
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))