CDRs

O módulo CDRs: quem gera e envia os registos de carregamento, os métodos por papel e o objeto CDR.

Nesta página

Considerações técnicas

O CDR deve ser considerado um evento concluído.

Os CDR são gerados e enviados pelo CPO para o HUB e depois reencaminhados pelo HUB para o EMSP. O MOBI.Hub pode também gerar CDR quando uma entidade usa os módulos opcionais Disputes e Partnerships disponíveis na plataforma MOBI.Hub.

Ao receber CDR de um CPO, a Mobi.e atua como CDR Receiver. Ao gerar CDR no âmbito dos serviços opcionais aplicáveis, a Mobi.e atua como CDR Sender.

Métodos a implementar

MOBI.Hub

Métodos de `CDRs` para o MOBI.Hub
Método	Direção	Descrição da utilização
`GET`	Pedido	Obter os CDR do CPO para um dado período.
`POST`	Pedido	Enviar um CDR a um EMSP quando gerado pelo MOBI.Hub no âmbito dos serviços opcionais aplicáveis.
`POST`	Resposta	Receber um novo CDR de um CPO.

CPO

Métodos de `CDRs` para o CPO
Método	Direção	Descrição da utilização
`GET`	Pedido	Obter os CDR do MOBI.Hub para um dado período.
`POST`	Pedido	Enviar um novo CDR ao MOBI.Hub.
`POST`	Resposta	Receber um CDR gerado pelo MOBI.Hub, quando o CPO tiver disponibilizado o endpoint CDR Receiver correspondente.

EMSP

Métodos de `CDRs` para o EMSP
Método	Direção	Descrição da utilização
`GET`	Pedido	Obter os CDR do MOBI.Hub para um dado período.
`POST`	Resposta	Receber um novo CDR do MOBI.Hub.

Descrição dos objetos

CDR

Tabela 5 – Propriedades do objeto `CDR`
Propriedade	Obrigatório	Valor	Comentários
`country_code`	TRUE	`PT`
`party_id`	TRUE
`id`	TRUE		Sempre fornecido pelo MOBI.Hub
`start_date_time`	TRUE
`end_date_time`	TRUE
`session_id`	TRUE
`cdr_token`	TRUE
`auth_method`	TRUE	`WHITELIST`	Os EMSP têm de implementar o
`cdr_location`	TRUE		Ver as observações abaixo sobre os postos de carregamento privados.
`currency`	TRUE	`EUR`
`tariffs`	TRUE
`charging_periods`	FALSE
`total_cost`	TRUE
`total_fixed_cost`	TRUE
`total_energy`	TRUE
`total_energy_cost`	TRUE
`total_time`	TRUE
`total_time_cost`	TRUE
`total_parking_time`	TRUE
`total_parking_cost`	TRUE
`remark`	FALSE
`credit`	FALSE
`credit_reference_id`	FALSE
`Last_updated`	TRUE

Podem ser recebidos os seguintes valores de CdrDimensionType:

ENERGY
ENERGY_EXPORT
ENERGY_IMPORT
MAX_POWER
MIN_POWER
PARKING_TIME
POWER
TIME

CdrLocation

Para a classe CdrLocation, uma vez que há considerações específicas a ter em conta quanto ao tipo de acesso dos postos de carregamento, aplica-se a seguinte regra:

Tabela 6 – Obrigatoriedade das propriedades de `CdrLocation` por tipo de acesso
Propriedade	Obrigatório por tipo de acesso		Comentários
Propriedade	Privado	Público	Comentários
`id`	TRUE	TRUE
`name`	TRUE	FALSE
`address`	FALSE	TRUE
`city`	TRUE	TRUE
`postal_code`	FALSE	FALSE
`country`	TRUE	TRUE
`coordinates`	FALSE	TRUE
`evse_uid`	TRUE	TRUE
`evse_id`	TRUE	TRUE
`connector_id`	TRUE	TRUE
`connector_standard`	TRUE	TRUE
`connector_format`	TRUE	TRUE
`connector_power_type`	TRUE	TRUE