> For the complete documentation index, see [llms.txt](https://docs.solarvis.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solarvis.co/documentation/pt/solarvis-modules/ai-sales-assistant/cost-configuration.md).

# Configuração de Custos

A página de Configuração de Custos define os preços dos materiais e as regras financeiras utilizadas pelo Assistente de Vendas com IA ao calcular os custos estimados do sistema e preparar propostas pa

## Finalidade Desta Página <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

Esta página permite configurar como o Assistente de Vendas com IA calcula os custos do sistema. Você pode reutilizar a configuração de custos ativa do Gerador de Leads Solar ou criar uma configuração dedicada, definindo custos de materiais, métodos de precificação, parâmetros financeiros e configurações de proposta. Assim, você garante que as propostas geradas e os cálculos de ROI reflitam a estratégia de precificação da sua empresa.

## O Que Você Pode Fazer Aqui <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

Nesta página, você pode realizar os seguintes pontos:

* Reutilizar a configuração de custos ativa do Gerador de Leads Solar ou manter uma configuração separada para o Assistente de Vendas com IA.
* Configurar diferentes estruturas de preços para múltiplas faixas de capacidade do sistema.
* Incluir ou não os custos de bateria nos cálculos de ROI fotovoltaico.
* Aplicar descontos personalizados, margens de lucro e taxas de IVA quando necessário.
* Ajustar descontos, margens de lucro, exibição de IVA, custos de manutenção e configurações de cotação.

Esta estrutura oferece controle total sobre como seu modelo de precificação opera dentro do Assistente de Vendas com IA.

## Como Funciona <a href="#how-it-works" id="how-it-works"></a>

O Assistente de Vendas com IA calcula os custos preliminares do sistema utilizando a configuração definida nesta página.

Quando um cliente conclui uma conversa, o assistente determina o tamanho estimado do sistema, seleciona a faixa de capacidade correspondente, aplica os materiais e configurações financeiras configurados e gera o custo estimado do projeto dentro da proposta.

### Fonte da Configuração <a href="#configuration-source" id="configuration-source"></a>

No topo da página, a opção **Usar configuração de custos do gerador de leads** determina se o Assistente de Vendas com IA utiliza a configuração de preços existente do Gerador de Leads Solar.

Quando ativado:

* A configuração de custos ativa do Gerador de Leads Solar é utilizada automaticamente.
* Os valores importados tornam-se somente leitura.
* A precificação só pode ser modificada a partir do módulo Gerador de Leads Solar.

Quando desativado:

* O Assistente de Vendas com IA mantém sua própria configuração de preços independente.
* Todos os valores nesta página tornam-se editáveis.

{% hint style="info" %}
Esta seção é visível apenas para clientes que adquiriram tanto o Gerador de Leads Solar quanto o Assistente de Vendas com IA.
{% endhint %}

### Custo da Bateria no ROI Fotovoltaico <a href="#battery-cost-in-pv-roi" id="battery-cost-in-pv-roi"></a>

Ative **Incluir custo da bateria no ROI do Sistema Fotovoltaico** se o investimento em bateria deve ser incluído ao calcular o ROI fotovoltaico.

Desative esta opção se os cálculos de ROI devem considerar apenas o investimento no sistema fotovoltaico.

### **Abas de Tamanho do Sistema** <a href="#system-size-tabs" id="system-size-tabs"></a>

As configurações de custos são mantidas separadamente para quatro tamanhos de sistemas fotovoltaicos:

* **0–25 kWp**
* **25–100 kWp**
* **100–500 kWp**
* **500+ kWp**

Selecione uma faixa de capacidade antes de editar seus materiais ou configurações financeiras.

Durante o cálculo de custos, o Assistente de Vendas com IA utiliza automaticamente a configuração que corresponde à capacidade calculada do sistema fotovoltaico.

{% hint style="info" %}
O tamanho do sistema calculado representa a capacidade ideal determinada levando em consideração o consumo de kWh do usuário, a localização do projeto e as informações de inclinação do telhado, a fim de atender à demanda energética especificada da forma mais eficiente possível.
{% endhint %}

### Seleção de Moeda <a href="#currency-selection" id="currency-selection"></a>

Utilize o seletor **Moeda** para definir a moeda utilizada em toda a configuração selecionada.

{% hint style="info" %}
A moeda afeta tanto os cálculos internos quanto os resultados apresentados ao usuário final.
{% endhint %}

### Tabela de Itens <a href="#items-table" id="items-table"></a>

A lista de materiais é dividida em duas seções:

* **Sistema Fotovoltaico**
* **Bateria**

Cada material inclui os seguintes campos:

<table><thead><tr><th width="203.357666015625">Campo</th><th width="496.7344970703125">Descrição</th></tr></thead><tbody><tr><td>Categoria</td><td>Categoria do material (Painel, Inversor, Bateria, Estrutura de Fixação, Cabos, Scada, Frete ou Mão de Obra, Personalizado, Meus Itens)</td></tr><tr><td>Item</td><td>Material selecionado do banco de dados.</td></tr><tr><td>Unidade</td><td>Unidade de precificação (como Quantidade, Por Watt ou Conjunto).</td></tr><tr><td>Preço Unitário</td><td>Preço unitário manual.</td></tr><tr><td>Usar Preço do Banco de Dados</td><td>Utiliza o preço atual armazenado no banco de dados de materiais do solarVis em vez do valor inserido manualmente.</td></tr></tbody></table>

Os itens existentes podem ser editados ou removidos utilizando os controles em cada linha, e pode-se usar o botão chamado **Adicionar novo item** para incluir materiais adicionais.

O **ícone de exclusão (botão X)** pode ser utilizado para remover o item da configuração. Remover um item significa que ele não será incluído nos cálculos de custos para aquela faixa de tamanho de sistema.

{% hint style="info" %}
Tanto inversores on-grid quanto híbridos devem ser incluídos na configuração de custos.

**Importante:** Se o usuário final selecionar uma bateria para o projeto, o solarVis oferece automaticamente inversores híbridos.

Quando múltiplos inversores estão disponíveis, o sistema seleciona a combinação de inversores com capacidade AC total mais próxima da capacidade AC do sistema calculada.

A capacidade AC do sistema calculada é baseada na potência DC do projeto e na razão DC/AC ideal.

Isso garante que a configuração de inversores selecionada esteja o mais alinhada possível com o tamanho do sistema projetado e os requisitos de desempenho.
{% endhint %}

#### Menu de Configurações Detalhadas (três pontos) <a href="#detailed-settings-three-dot-menu" id="detailed-settings-three-dot-menu"></a>

Cada material inclui um painel dedicado de **Configurações Detalhadas**, acessível pelo ícone **Configurações** ao final da linha do item.

Este painel permite personalizar como o material selecionado se comporta em propostas e cálculos financeiros.

O painel é composto por duas seções:

**Configurações de Proposta**

As Configurações de Proposta controlam como o material selecionado é apresentado nas propostas para o cliente.

<table><thead><tr><th width="288.2578125">Configuração</th><th>Descrição</th></tr></thead><tbody><tr><td>Descrição</td><td>Adiciona uma descrição personalizada para o material na proposta.</td></tr><tr><td>Exibir este material na proposta</td><td>Inclui ou oculta o material na proposta.</td></tr><tr><td>Exibir preço unitário deste material na proposta</td><td>Exibe o preço unitário individual em vez de apenas o custo total do sistema.</td></tr><tr><td>Exibir marca e modelo na proposta</td><td>Exibe a marca do fabricante e as informações do modelo.</td></tr><tr><td>Exibir desconto deste material na proposta</td><td>Exibe o desconto do material na proposta.</td></tr></tbody></table>

{% hint style="info" %}
**Nota:** Algumas configurações de proposta dependem umas das outras. Por exemplo, para exibir o desconto de um material na proposta, **Exibir este material na proposta**, **Exibir preço unitário deste material na proposta** e **Exibir desconto deste material na proposta** devem estar todos ativados.
{% endhint %}

**Configurações Financeiras**

As Configurações Financeiras determinam como o material contribui para os cálculos de custos do projeto e ROI.

<table><thead><tr><th width="200.45404052734375">Configuração</th><th width="564.134521484375">Descrição</th></tr></thead><tbody><tr><td>Incluir no ROI</td><td>Inclui ou exclui o material dos cálculos de ROI.</td></tr><tr><td>Desconto Personalizado</td><td>Aplica um desconto específico para o material em vez da configuração padrão.</td></tr><tr><td>Margem de Lucro Personalizada</td><td>Aplica uma margem de lucro personalizada ao material selecionado.</td></tr><tr><td>Taxa de IVA Personalizada</td><td>Aplica uma taxa de IVA específica para o material em vez do padrão do projeto.</td></tr></tbody></table>

{% hint style="info" %}
**Nota:** As Configurações de Proposta e as Configurações Financeiras operam de forma independente. Por exemplo, ocultar o desconto de um material na proposta não desativa ou afeta o **Desconto Personalizado** utilizado durante os cálculos financeiros.
{% endhint %}

### **Seção de Configuração Financeira** <a href="#financial-configuration-section" id="financial-configuration-section"></a>

As configurações financeiras na parte inferior da página aplicam-se à faixa de capacidade atualmente selecionada.

#### Desconto <a href="#discount" id="discount"></a>

Configure uma das opções:

* Valor Fixo
* Percentual

Ative **Exibir desconto na cotação** se o desconto deve ser visível nas propostas para o cliente.

#### Margem de Lucro <a href="#profit-margin" id="profit-margin"></a>

Selecione o tipo de cálculo e defina a margem de lucro aplicada durante os cálculos de custos.

#### IVA <a href="#vat" id="vat"></a>

O IVA é calculado utilizando a taxa padrão do projeto.

Ative **Exibir IVA na cotação** para mostrar o valor do IVA nas propostas apresentadas ao cliente.

#### Custo Anual de Manutenção <a href="#annual-maintenance-cost" id="annual-maintenance-cost"></a>

Informe o custo anual recorrente de manutenção associado à operação do sistema.

Este valor é incluído nos cálculos financeiros quando aplicável.

### Salvando a Configuração <a href="#saving-the-configuration" id="saving-the-configuration"></a>

Após concluir a configuração, selecione o botão **Salvar**.

Como cada faixa de capacidade armazena sua própria configuração de preços, revise e salve cada faixa que necessite de preços de materiais ou configurações financeiras diferentes antes de utilizar o Assistente de Vendas com IA.

***

## Páginas Relacionadas <a href="#related-pages" id="related-pages"></a>

* [Assistente de Vendas com IA](/documentation/pt/solarvis-modules/ai-sales-assistant.md)
* [Configurações Gerais](/documentation/pt/solarvis-modules/ai-sales-assistant/general-settings.md)
* [Regulamentos](/documentation/pt/solarvis-modules/ai-sales-assistant/regulations.md)
* [Teste de Configuração de Custos](/documentation/pt/solarvis-modules/ai-sales-assistant/cost-configuration-test.md)
* [Treinamento](/documentation/pt/solarvis-modules/ai-sales-assistant/training.md)
* [Saudação](/documentation/pt/solarvis-modules/ai-sales-assistant/greeting.md)
* [Tema](/documentation/pt/solarvis-modules/ai-sales-assistant/theme.md)
* [Jornada do Usuário Final do Assistente de Vendas com IA](/documentation/pt/solarvis-modules/ai-sales-assistant/ai-sales-assistant-end-user-journey.md)

Se você encontrar algum problema, [sinta-se à vontade para nos contatar.](https://solarvis.co/en/company/contact)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solarvis.co/documentation/pt/solarvis-modules/ai-sales-assistant/cost-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.