Catálogo de CVUs

O Portal mantém um histórico auditável de CVUs estruturais e conjunturais. A primeira versão é uma ferramenta administrativa independente: ela não escolhe usinas e ainda não altera os decks produzidos pela Myria.

Última atualização desta página: 2026-08-06.

O que entra no catálogo

• decks NEWAVE e DECOMP publicados nos repositórios operacionais autorizados;
• relatórios CCEE estrutural, conjuntural, conjuntural revisado e merchant;
• valores manuais, usados quando a informação vem de ato ANEEL, declaração de agente ou outra fonte que não esteja em deck ou dado aberto CCEE.

Estrutural e conjuntural são históricos separados. Dentro da mesma natureza e coordenada, vale a observação elegível mais recente. A fonte, sozinha, não tem prioridade. Omissão posterior não cria zero e zero publicado é preservado como valor.

Interface administrativa

Administradores do site acessam /cvus/ para:

• pesquisar usinas e consultar todo o histórico;
• acompanhar imports, avisos, quarentenas e falhas;
• enviar manualmente relatórios CCEE;
• cadastrar e aprovar valores manuais;
• escolher leilão/produto quando um código tem variantes divergentes;
• registrar roteamento ou rejeição de uma identidade ambígua.

Cadastros manuais exigem evidência e aprovação por outro administrador. Uma observação aprovada não é editada: correções entram como novos eventos.

Endpoint interno CCEE

Outra aplicação pode entregar CSVs sem usar a interface:

POST /api/internal/cvus/ccee/
X-Myria-CVU-Token: <segredo dedicado>
Idempotency-Key: <identificador único da publicação>
X-CVU-Report-Type: ccee_structural
X-CVU-First-Seen-At: 2026-07-17T12:00:00-03:00
X-CVU-Published-At: 2026-07-17T12:00:00-03:00
Content-Type: text/csv

<conteúdo do CSV>

Tipos aceitos:

Valor	Relatório
ccee_structural	CUSTO_VARIAVEL_UNITARIO_ESTRUTURAL
ccee_conjunctural	CUSTO_VARIAVEL_UNITARIO_CONJUNTURAL
ccee_revised	CUSTO_VARIAVEL_UNITARIO_CONJUNTURAL_REVISADO
ccee_merchant	CUSTO_VARIAVEL_UNITARIO_MERCHANT

No relatório Merchant, quando CVU_CF é numérico, ele vale somente na interseção de MES_REFERENCIA com DATA_INICIO e DATA_FIM. Se CVU_CF não existir, o catálogo usa CVU_SCF durante o mês completo. Uma linha CF cuja vigência não intersecta a competência fica em quarentena para inspeção.

X-CVU-First-Seen-At é obrigatório e informa quando o payload ficou disponível para a Myria. Envie X-CVU-Published-At quando a data oficial de publicação for conhecida. O limite padrão é 25 MiB.

O endpoint também aceita multipart/form-data, com o arquivo no campo file e os campos report_type, idempotency_key, first_seen_at e, opcionalmente, published_at.

Respostas

Uma entrega nova retorna 202:

{
  "batch_id": 42,
  "created": true,
  "status": "pending",
  "payload_sha256": "..."
}

Status	Significado
200	A chave já existia e o batch não está pendente.
202	Batch novo ou pendente, aceito para processamento.
400	Metadados, tipo ou arquivo inválido.
401	Token ausente ou incorreto.
409	A mesma chave foi usada com conteúdo diferente.
503	Serviço não configurado ou falha ao enfileirar.

Repetir a mesma Idempotency-Key com o mesmo conteúdo é seguro e retorna o mesmo batch. Não reutilize uma chave para uma publicação diferente.

Não existe download automático dos dados CCEE. O produtor controla quando cada arquivo é entregue ao Portal.