O serviço de preços de energia obtém os preços spot da eletricidade do mercado diário para a sua zona de mercado a partir da ENTSO-E, a plataforma de transparência dos operadores de transporte europeus. O HyperVisu classifica cada hora como barata, média ou cara, mostra os preços na app e permite que as automações e o motor Logic reajam a eles.
O que precisa: uma chave de API gratuita da ENTSO-E.
Ativar e configurar a fonte
- Abra Services na barra lateral.
- Em Application services, encontre Energy Price Service e clique em Configure.
- O Energy Price Provider é a ENTSO-E. A sugestão liga à plataforma onde obtém uma chave de API gratuita (registe-se e gere uma chave de API a partir da sua conta).
- Cole a sua API Key.
- Escolha a sua Bidding Zone: a zona de mercado elétrico do seu país ou região (por exemplo, Bélgica, Alemanha-Luxemburgo, França). Os preços do mercado diário variam consoante a zona, por isso escolha aquela a que pertence o seu contrato de eletricidade.
- Defina o Update interval em minutos. É a frequência com que o servidor recalcula as estatísticas (hora atual, percentil, escalões), não a frequência com que chama a API. Os preços são publicados uma vez por dia e obtidos apenas 1–2 vezes por dia.
- Clique em Save Configuration.
- Ative o serviço com o interruptor no cabeçalho da página, se estiver desativado. O indicador de estado muda para Service Enabled.
- Clique em Test Configuration para forçar uma atualização. Um teste bem-sucedido mostra Last test passed com a hora.
📘 Nota: Respeite esta ordem. Ao ativar o serviço, os preços são obtidos de imediato com a configuração guardada; se essa obtenção falhar (sem chave de API, zona de licitação errada, sem internet), o interruptor volta a desativar-se. Test Configuration também usa a configuração guardada, não o que está escrito no formulário: primeiro guarde e depois teste.

Modificadores de preço: do preço de mercado ao seu preço real
O preço da ENTSO-E é o preço grossista sem acréscimos. Para ver quanto lhe custa realmente um quilowatt-hora, marque Enable price modifiers em Price Modifiers (Optional) e preencha os componentes adicionais da sua fatura de eletricidade:
| Campo | Unidade | O que é |
|---|---|---|
| Transmission fee | €/kWh | Custo fixo de transporte da rede por kWh |
| Distribution | % | Custo de distribuição como percentagem do preço |
| Supplier margin | €/kWh | Margem fixa do seu fornecedor por kWh |
| VAT | % | Imposto sobre o valor acrescentado |
Os modificadores são aplicados numa ordem fixa:
- A taxa de transporte é somada ao preço de mercado.
- A percentagem de distribuição é aplicada a essa soma.
- A margem do fornecedor é somada.
- O IVA é aplicado ao total.
Clique em Save Configuration para aplicar os modificadores.
Com os modificadores ativados, todos os preços que o HyperVisu mostra e todos os limiares das automações usam o preço de consumo resultante em vez do preço de mercado bruto.
📘 Nota: Uma taxa de distribuição cobrada como montante fixo por kWh não tem um campo próprio: some-a à taxa de transporte ou à margem do fornecedor. Os encargos fixos e outros custos que não são por kWh não estão incluídos.
O painel de preço em direto
O lado direito da página demonstra que o serviço está a funcionar:
- Current Price: o preço da hora atual em €/kWh, com uma etiqueta colorida: Cheap, Average ou Expensive, além do percentil da hora dentro do dia. As três horas mais baratas do dia são Cheap, as três mais caras são Expensive e todas as outras são Average; o percentil é mostrado apenas como valor. A app usa a mesma regra.
- A janela Current Hour e o Price (€/kWh) exato.
- Um destaque quando a hora atual é uma das mais baratas ou uma das mais caras de hoje.
- Market Information: fornecedor (ENTSO-E), a sua zona de licitação e a Currency (EUR).
- A marca temporal Last updated e uma nota How it works que explica o modelo de obtenção uma vez por dia.
As horas são as da hora local da instalação: um dia vai da meia-noite local à meia-noite local.

Onde aparecem os preços
- A página Energy prices da app: preço e escalão atuais, barras do mercado diário de hoje e amanhã, a janela mais barata e a janela de pico (consulte “Energy Overview”).
- Acionadores e condições de Automation sobre limiares de preço e escalões (consulte “Automations”).
- Entradas do Logic engine: o preço como fonte de serviço na tela de funções (consulte “Logic Engine — Concepts & Canvas”).