Sessions

O módulo Sessions: autorização das sessões, frequência das atualizações e o objeto Session.

Nesta página

Considerações técnicas

A implementação deve ter em consideração o seguinte:

Não devem ser consideradas reservas.
As sessões com origem no CPO, por exemplo através de um cartão RFID, podem ser autorizadas através do MOBI.Hub quando este opera em modo de Autenticação Centralizada. Consoante o modelo de autorização escolhido, a autorização pode ser feita em tempo real ou através de mecanismos de lista branca (whitelist).
Quando opera em modo de Hub Clássico, a autorização pode ser feita diretamente pelo CPO e/ou pelo EMSP de acordo com a relação de interoperabilidade aplicável. O MOBI.Hub deve encaminhar a informação da sessão resultante de acordo com as relações configuradas.
Se uma sessão ou atualização de sessão não puder ser associada a um token válido ou a uma relação de interoperabilidade autorizada, o pedido pode ser rejeitado pelo MOBI.Hub. A informação correspondente pode, ainda assim, ser integrada quando aplicável, mas nenhum CDR deve ser gerado pelo MOBI.Hub em resultado desse pedido.
Recomenda-se que os CPO enviem atualizações de sessão a intervalos regulares, com um intervalo máximo aconselhado de 5 minutos.
Embora os charging_periods não sejam obrigatórios, os CPO são fortemente incentivados a fornecer esta informação nas atualizações de Session. Se os charging_periods não forem fornecidos, o MOBI.Hub deve estimar os períodos de carregamento aplicáveis quando a Session terminar.

Métodos a implementar

EMSP (e MOBI.Hub)

Métodos de `Sessions` para o EMSP (e MOBI.Hub)
Método	Direção	Descrição da utilização
`GET`	Pedido	Obter `Sessions`, paginadas, filtradas e ordenadas por `last_updated`.
`PUT`	Resposta	Enviar um objeto `Session` novo ou atualizado ao EMSP.
`PATCH`	Resposta	Atualizar um objeto `Session` existente.

CPO (e MOBI.Hub)

Métodos de `Sessions` para o CPO (e MOBI.Hub)
Método	Direção	Descrição da utilização
`GET`	Resposta	Obter uma `Session` pelo seu identificador.
`PUT`	Pedido	Enviar um objeto `Session` novo ou atualizado ao MOBI.Hub.
`PATCH`	Pedido	Atualizar um objeto `Session` existente no MOBI.Hub.

O MOBI.Hub não suporta atualmente Charging Preferences. Os EMSP não podem, por isso, usar esta funcionalidade para indicar preferências de carregamento durante uma Session ativa.

Descrição dos objetos

Sessions

Tabela 4 – Propriedades do objeto `Session`
Propriedade	Obrigatório	Valor	Comentários
`country_code`	TRUE	`PT`
`party_id`	TRUE
`id`	TRUE		Fornecido pelo HUB nas ligações OCPP ou gerado pelo CPO nas ligações OCPI.
`start_date_time`	TRUE
`end_date_time`	FALSE		Opcional devido ao objeto de início
`kwh`	TRUE
`cdr_token`	TRUE
`auth_method`	TRUE	`AUTH_REQUEST` `COMMAND` `WHITELIST`
`location_id`	TRUE
`evse_uid`	TRUE
`connector_id`	TRUE
`currency`	TRUE	`EUR`
`charging_periods`	FALSE		Opcional devido ao objeto de início
`status`	TRUE	`ACTIVE` `COMPLETED` `INVALID` `PENDING`
`last_updated`	TRUE