Para desenvolvedores e integradores

Preço solar por API e MCP: o seu sistema cota sozinho

O seu site, CRM ou agente de IA pedem uma cotação e recebem potência, valor, payback e proposta prontos, com a sua formação de preço (conta nova já cota pela referência de mercado). Documentação aberta em /docs/api e chave de teste grátis em qualquer plano: dá pra chamar a API antes de assinar.

Criar conta grátisVer a documentação

sem cartão · a conta sai em 30 segundos · a chave de teste sai na hora

Os endpoints, em uma tela

Quatro rotas REST, um servidor MCP com 5 ferramentas e webhooks de saída. Autenticação por chave ilz_ no cabeçalho, resposta em JSON, erros com código estável.

Endpoints, uso e limite
EndpointPara quêLimite por minuto
POST /api/v1/quoteOrçamento a partir do consumo em kWh. Em preview, calcula sem gravar; com preview: false e consent: true, grava a proposta e devolve os links do PDF e da proposta (pdfUrl e propostaUrl). Aceita Idempotency-Key: repetir a mesma chamada dentro de 15 minutos devolve a resposta guardada em vez de criar outra proposta.60
GET /api/v1/coverageQuais faixas de potência têm kit seu e quais você marcou como “não atendo”. Faixa sem kit seu cota com o catálogo padrão; só a “não atendo” recusa o pedido.120
GET /api/v1/proposalsLista as propostas da conta, com filtro por origem e paginação por cursor. É por aqui que o CRM puxa o histórico.120
GET /api/v1/proposals/{id}Uma proposta da conta: potência, valor, payback, dados do cliente e os links do PDF e da página do cliente.120
/api/mcpServidor MCP com quote_solar, check_coverage, list_kits, get_proposal, coverage_status, para agente de IA.120
Webhooks de saídaO ionluz avisa o seu sistema em lead.criado, proposta.aberta e proposta.aceita, assinados, com teste e status da última entrega no painel.sem limite

Vale prever dois erros na sua integração: faixa-nao-atendida (422), quando a faixa está marcada “não atendo”, e fora-da-area (422), quando o cliente está acima do seu raio de atendimento, com a distância e o raio na resposta. Toda cotação traz também cobrePct (quanto do consumo o sistema cobre) e, quando você cobra deslocamento, o valor em linha própria. O contrato completo está em OpenAPI: app.ionluz.com.br/api/v1/openapi.json.

As respostas das chamadas autenticadas trazem o limite restante nos cabeçalhos. A referência completa, com todos os campos, códigos de erro e exemplos em curl, JavaScript e Python, está na documentação.

Dá para chamar a API antes de assinar

Criou a conta, você já gera uma chave de teste em qualquer plano, com 50 chamadas por dia, para cotar em preview pela API REST e pelo MCP. Ler e gravar propostas é da chave viva, a do plano Total + API, sem cota diária.

A página de captação e a API funcionam desde o primeiro dia com o catálogo padrão ionluz, sempre com a mesma linha de equipamento em cada tipo de ligação. Para cotar com os seus kits, cubra as faixas de potência em API e cobertura; o preço vem da sua formação de preço, ou da referência de mercado enquanto você não salvar a sua.

Três caminhos de integração

Calculadora no seu site

Cole a sua página de captação no site com um trecho de código, em qualquer plano, ou monte a sua própria calculadora pela API em modo preview. O visitante vê a estimativa com o seu preço sem sair do seu domínio.

Ver como funciona

Agente de IA pelo MCP

O assistente ganha as 5 ferramentas do servidor (cotar, consultar a cobertura, listar os kits, recuperar uma proposta e diagnosticar a conta) e responde dentro da conversa, com a sua tabela.

Ver como funciona

Cotação por WhatsApp

O consumo chega no chat, a API devolve o número e o link da proposta sai na mesma conversa.

Ver como funciona

O que a integração entrega

API REST pública v1

POST com o consumo em kWh → kWp, valor, payback, economia, quanto do consumo o sistema cobre e os links do PDF e da proposta. Com idempotência, erros estruturados, rate-limit e proteção por IP.

Modo preview (cota sem gravar)

Uma calculadora no seu site ou um agente de IA cotam à vontade, sem criar registro. Capture o lead só quando ele quiser falar.

Servidor MCP nativo

Pluga o seu agente de IA no /api/mcp e ele ganha 5 ferramentas: quote_solar, check_coverage, list_kits, get_proposal, coverage_status. Em clientes que aceitam servidor remoto com cabeçalho de autorização, a integração é colar um bloco de configuração com a sua chave, sem escrever código.

Documentação aberta

Manual público com exemplos em curl, JavaScript e Python, catálogo de erros, idempotência, limites e o contrato OpenAPI.

Uma chamada, a proposta pronta

Autentique com a sua chave ilz_. Em preview, calcula sem gravar. Com preview false e consent true, grava a proposta e devolve o link do PDF e da página interativa.

Ver a documentação

Exemplo de uma conta que ainda cota pela referência de mercado. Com a sua tabela, o valor muda.

# Cotação (preview: sem gravar)
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 }'

# Resposta (assumptions resumido)
{ "ok": true,
  "orcamento": {
    "potenciaKwp": 5.72,
    "valorFinal": 14296.8,
    "paybackAnos": 2.057067267830044,
    "economiaMes1": 569,
    "economia25Anos": 373181,
    "sePaga": true,
    "cobrePct": 111 },
  "assumptions": { "uf": "SP", "fase": "bi", "tarifaBrlKwh": 0.99, "kwpAlvo": 5.16, "kitCatalogoPadrao": true },
  "preview": true, "aviso": "Estimativa sujeita a visita técnica.",
  "requestId": "req_..." }

Experimente a API ao vivo

Esta é a mesma POST /api/v1/quote em modo preview, chamada de verdade no seu navegador, com a tabela de uma conta de demonstração. Nada é gravado.

Requisição

Resposta

// clique em "Chamar a API" para ver a resposta real

MCP: o seu agente de IA cota solar

Configure o cliente MCP com a sua chave e o agente ganha 5 ferramentas: quote_solar, check_coverage, list_kits, get_proposal, coverage_status. Como conectar.

{
  "mcpServers": {
    "ionluz": {
      "url": "https://app.ionluz.com.br/api/mcp",
      "headers": { "Authorization": "Bearer ilz_sua_chave" }
    }
  }
}

Comece a cotar por API hoje

Teste ao vivo aqui na página, sem conta. Depois crie a conta grátis e gere a chave de teste, 50 chamadas por dia em qualquer plano, que já cota em preview pela API e pelo MCP; a primeira cotação sai em 10 minutos. Para o volume de produção, a chave viva faz parte do plano Total + API, R$ 97 por mês. Ver os planos.

Criar conta grátis