API & MCP

Mudanças da API

O contrato só cresce: nenhum campo muda de nome nem de tipo. O que muda são números (o cálculo melhora) e campos novos. Do mais novo para o mais antigo.

Mais recente

• Economia pela regra da REN 1.059/2023. A parte de consumo da conta depois da energia solar passa a ser o maior entre a taxa mínima da distribuidora e a energia da rede somada ao Fio B da energia compensada (antes, os dois eram somados). Para o mesmo pedido, economiaMes1 e economia25Anos ficam iguais ou maiores, e paybackAnos igual ou menor. Os exemplos deste manual já estão na regra nova.
• Conectar o MCP não gasta a cota da chave de teste. Só a chamada de ferramenta conta: 50 por dia na conta, somando as requisições REST e as chamadas de ferramenta do MCP; conectar e listar as ferramentas não gasta. A cota volta à meia-noite de Brasília.
• OpenAPI: a resposta de gravação descreve os campos reais (proposalId, pdfUrl, propostaUrl, aviso e idempotent).

Motor novo, conta a conta

Nas contas com o motor novo, a cotação ganha sistema, equipamento, validade, avisos, preco.publicado, opcoes e opcao, e /v1/proposals ganha aprovacao e publicacao. Detecte pela resposta; os detalhes estão em Cotação.

24/09/2026

• orcamento.cobrePct em toda cotação (antes, só quando o sistema cobria pouco).
• Faixa marcada "não atendo" recusa com faixa-nao-atendida e motivo: "nao-atendo"; faixa sem kit do integrador cota com o catálogo padrão.
• Deslocamento só com valor por km maior que zero, sempre como linha visível (orcamento.deslocamento).
• Raio de atendimento e o erro fora-da-area.
• Conta que nunca salvou a formação de preço cota pela referência de mercado (pesquisa Greener, set/2026): R$ 3.200 por obra + R$ 1.940 por kWp.
• ativa da cobertura passa a ser chave viva mais o plano com API; a cobertura virou informação.
• A proposta gravada ganha validade (15 dias por padrão, ou os do perfil).
• O campo opcao e o erro opcao-invalida, só nas contas com o motor novo.

13/09/2026

• A tarifa padrão passa a ser a residencial B1 da UF (antes, 0,95 para o país inteiro).
• Horas de sol do município para as 100 cidades do Atlas Brasileiro de Energia Solar (hspFonte e hspCidade).
• Faixa sem kit do integrador cota com o catálogo padrão ionluz (kitCatalogoPadrao).
• O evento de webhook proposta.aceita.

12/09/2026

• GET /v1/proposals e as cinco ferramentas do servidor MCP.
• A chave de teste, a especificação OpenAPI 3.1 e os webhooks de saída assinados, com os eventos lead.criado e proposta.aberta, mais o ping de teste.