API & MCP de orçamentos solares

Comece em 10 minutos

Três passos, e você não precisa assinar nada para dar o primeiro. A chave de teste vale em qualquer plano, inclusive no Grátis, e roda tudo em modo simulação: o cálculo é o real, com a sua formação de preço, e nada é gravado.

Funciona desde a primeira chamada. Numa conta nova, a cotação sai com o catálogo padrão ionluz (a resposta traz "kitCatalogoPadrao": true em assumptions) e, enquanto você não salvar a sua formação de preço, com a referência de mercado (pesquisa Greener, set/2026): R$ 3.200 por obra + R$ 1.940 por kWp. Em API e cobertura, a cobertura de faixas escolhe o equipamento: com kit seu na faixa, a cotação sai com o seu kit. O preço sai da sua formação de preço em qualquer faixa; só no modo Custo → venda o custo do kit entra na conta. Vale para a chave de teste, para a chave viva e para a página de captação.

# 1. gere a chave de teste em https://app.ionluz.com.br/api-integracao (qualquer plano, inclusive o Grátis)
# 2. cote com ela: o cálculo é o real, nada é gravado
curl -X POST https://app.ionluz.com.br/api/v1/quote \
  -H "Authorization: Bearer ilz_test_sua_chave_de_teste" \
  -H "Content-Type: application/json" \
  -d '{ "consumoKwhMes": 600, "uf": "SP", "fases": "bi" }'

A resposta identifica o modo, no corpo e no cabeçalho X-Ionluz-Sandbox: 1:

{
  "ok": true,
  "orcamento": {
    "potenciaKwp": 5.72,
    "valorFinal": 14296.8,
    "paybackAnos": 2.208259927284166,
    "economiaMes1": 527,
    "economia25Anos": 363646,
    "sePaga": true,
    "cobrePct": 121
  },
  "assumptions": {
    "uf": "SP",
    "fase": "bi",
    "hspHoraDia": 4.9,
    "hspFonte": "uf-media",
    "tarifaBrlKwh": 0.99,
    "tarifaAssumida": true,
    "kwpAlvo": 4.73,
    "kwpAlvoAssumido": true,
    "kitCatalogoPadrao": true
  },
  "preview": true,
  "sandbox": true,
  "aviso": "Chave de teste: executado em modo preview, nada foi gravado. Com a chave viva, preview:false grava a proposta e devolve os links.",
  "requestId": "req_9f2c1a7b3d4e5f6a90"
}

Conta que ainda não salvou a formação de preço (vale a referência de mercado) e sem kit próprio na faixa (vale o catálogo padrão). Com a sua tabela e os seus kits, os números mudam. paybackAnos vem com todas as casas decimais: arredonde para mostrar.

Quando a integração estiver rodando, assine o Total + API, confirme as condições comerciais (a tela pede, porque a API emite proposta em nome da sua empresa) e gere a chave viva em API e cobertura. Troque o Bearer: o mesmo corpo, agora com consent: true, grava a proposta e devolve os links do PDF e da página interativa.

Início rápido

Base URL: https://app.ionluz.com.br/api/v1. Autentique com a sua chave e faça uma cotação de simulação (não grava nada):

curl -X POST https://app.ionluz.com.br/api/v1/quote \
  -H "Authorization: Bearer ilz_sua_chave" \
  -H "Content-Type: application/json" \
  -d '{ "consumoKwhMes": 650, "uf": "SP", "fases": "bi", "preview": true }'

O passo seguinte é a autenticação: como a chave viaja, onde guardar e o que fazer se ela vazar. A especificação completa, para gerar um cliente, está em OpenAPI.