API & MCP

Cobertura

GET/api/v1/coverage

Mostra, por ligação (mono, bi e tri), quais faixas de potência têm kit seu e quais você marcou como "não atendo". Serve para saber de antemão o que sai com o seu equipamento, o que sai com o catálogo padrão ionluz e o que volta como pedido de contato (faixa-nao-atendida). Mesma autenticação da cotação; a chave de teste também lê.

curl https://app.ionluz.com.br/api/v1/coverage -H "Authorization: Bearer ilz_sua_chave"

Conta nova, ainda sem nenhuma faixa própria:

{
  "ok": true,
  "modo": "linha",
  "ativa": true,
  "cobertas": 0,
  "total": 18,
  "completa": false,
  "naoAtendo": 0,
  "resumo": "0 de 18 faixas com kit seu; o resto usa o catálogo padrão ionluz.",
  "tetoKw": 75,
  "unidadeFaixas": "kw-saida-inversor",
  "fases": [
    { "key": "mono", "label": "Monofásico" },
    { "key": "bi", "label": "Bifásico" },
    { "key": "tri", "label": "Trifásico" }
  ],
  "matriz": [],
  "requestId": "req_9f2c1a7b3d4e5f6a90"
}

Numa conta com faixas próprias (aqui, monofásico até 10 kW com um kit do catálogo e o trifásico inteiro marcado "não atendo"), a matriz traz uma linha por faixa criada:

{
  "matriz": [
    { "fase": "mono", "deKw": 0, "ateKw": 10, "atende": true, "naoAtendo": false },
    { "fase": "tri", "deKw": 0, "ateKw": 75, "atende": false, "naoAtendo": true }
  ],
  "...": "..."
}

• modo: o modo de preço ativo na conta, com o nome da tela Formação de preço: linha é Valor por obra + valor por kWp (o de quem nunca salvou), faixa é Preço por faixa (R$/kWp) e custo é Custo → venda.
• ativa: há chave viva ativa e o plano inclui a API. A cobertura não entra nessa conta.
• cobertas e total: as faixas com kit seu que a cotação aceita, e o total de faixas fora as "não atendo", contando as 6 sugeridas de cada fase ainda vazia (até 3, 6, 10, 20, 40 e 75 kW).
• completa: as três fases vão de 0 a 75 kW com kit ou "não atendo". É só informação.
• matriz: uma linha por faixa sua, de deKw a ateKw em kW de saída de inversor (CA), com atende (kit seu que a cotação aceita) e naoAtendo. Faixa com atende: false e naoAtendo: false cota com o catálogo padrão ionluz. Fase com combinação automática aparece como uma faixa única, de 0 a 75.
• Kit que "a cotação aceita": com potência conhecida e, no modo Custo → venda, com custo.

A cobertura é informação: ela não liga nem desliga a API. As faixas são suas e editáveis, em API e cobertura, bloco "Cobertura de faixas".