Tariffs

O módulo Tariffs: como os CPO publicam tarifários, as estruturas tarifárias suportadas e o objeto Tariff.

Nesta página

Considerações técnicas

Os tarifários podem ser criados e atualizados pelos CPO através do MOBI.Hub. O HUB deve disponibilizar a informação tarifária relevante aos EMSP ligados de acordo com as relações de interoperabilidade configuradas.

Recomenda-se que os EMSP obtenham regularmente a informação tarifária e que façam um pedido em (quase) tempo real sempre que um dos seus utilizadores estiver prestes a carregar, sempre que seja necessária informação tarifária atualizada. Note-se que, no OCPI, os tarifários podem ser definidos ao nível do EVSE.

A utilização do módulo Tariffs é independente do modelo de autorização escolhido pelo EMSP. A informação tarifária pode, por isso, ser trocada quer a relação de interoperabilidade funcione segundo um modelo de Hub Clássico quer segundo um modelo de Autenticação Centralizada.

A Mobi.e não fará qualquer validação da correção comercial da estrutura tarifária para além da validação exigida pela especificação OCPI. É da responsabilidade do CPO garantir que os tarifários estão corretamente estruturados e representam com exatidão as condições de carregamento aplicáveis. Embora esteja em constante evolução, o HUB suporta atualmente as seguintes estruturas tarifárias:

Componentes de preço:
- EUR/min, EUR/kWh, EUR/transação
- Restrições de duração
- Restrições horárias
Tarifários mais comuns hoje, por carregamento:
- EUR/min
- EUR/kWh
- EUR fixo + EUR/min
- EUR fixo + EUR/min + EUR/kWh
- EUR fixo + EUR/kWh
- Com restrições de duração (exemplo, até n elementos):
  - EUR fixo + x EUR/min, t<=z min
  - EUR fixo + y EUR/min, t>z min
- Com restrições horárias (exemplo, até n elementos):
  - EUR fixo + x EUR/min, AAh-BBh
  - EUR fixo + y EUR/kWh, BBh-AAh

Métodos a implementar

CPO (e MOBI.Hub) – Sender

Métodos de `Tariffs` para o CPO (e MOBI.Hub) – Sender
Método	Direção	Descrição da utilização
`GET`	Resposta	Obter tarifários atuais e/ou históricos (por favor, verificar!)
`PUT`	Pedido	Enviar um tarifário novo ou atualizado
`DELETE`	Pedido	Eliminar um tarifário

EMSP (e MOBI.Hub) – Receiver

Devem ser implementados os seguintes métodos:

Métodos de `Tariffs` para o EMSP (e MOBI.Hub) – Receiver
Método	Direção	Descrição da utilização
`GET`	Pedido	Obter tarifários atuais e/ou históricos (por favor, verificar!)
`PUT`	Resposta	Receber um tarifário novo ou atualizado
`DELETE`	Resposta	Confirmar a eliminação de um tarifário

Descrição dos objetos

Tariffs

A tabela seguinte descreve o objeto Tariffs.

Tabela 7 – Propriedades do objeto `Tariff`
Propriedade	Obrigatório	Valor	Comentários
`country_code`	TRUE	`PT`
`party_id`	TRUE
`id`	TRUE		ID do tarifário (formato UUID)
`currency`	TRUE	`EUR`
`type`	TRUE	`REGULAR` `AD_HOC_PAYMENT`	Não há certeza de que `ad_hoc_payment` faça sentido
`tariff_alt_text`	FALSE		Este campo pode ser usado pelo CPO para comunicar quaisquer descontos relevantes.
`min_price`	TRUE		Este campo deveria ser definido como zero na maioria dos casos.
`elements`	TRUE
`start_date_time`	FALSE
`stop_date_time`	FALSE
`last_updated`	TRUE

São permitidos os seguintes valores de TariffDimensionType:

ENERGY,
FLAT,
TIME.
PARKING TIME

Podem ser usadas as seguintes propriedades de TariffRestrictions:

start_time
end_time
start_date
end_date
min_kwh
max_kwh
min_duration
max_duration
day_of_week