> 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/solarvis-lead-generator/cost-configuration.md).

# Configuração de Custos

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

A página de **Configuração de Custos** define como os custos do projeto são calculados dentro do Lead Generator do solarVis. Ela permite controlar quais componentes são incluídos no cálculo, como são precificados e como as margens e custos adicionais são aplicados.

Esta configuração afeta diretamente os resultados de pré-viabilidade apresentados aos usuários finais e os resultados financeiros gerados pelo Lead Generator.

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

A partir da página de **Configuração de Custos**, você pode configurar as seguintes funcionalidades:

* Definir estruturas de custos separadas para diferentes faixas de tamanho de sistema
* Selecionar quais módulos, inversores, sistemas de fixação, cabos e outros componentes são incluídos
* Especificar como cada item é calculado (quantidade, por watt, conjunto)
* Utilizar preços do banco de dados de materiais ou substituí-los por preços manuais
* Adicionar itens de custo personalizados e ajustes logísticos
* Aplicar regras de desconto e definir a margem de lucro
* Controlar a visibilidade e o comportamento de cálculo do IVA
* Definir premissas de custo anual de manutenção

Esta estrutura oferece controle total sobre como seu modelo de precificação se comporta dentro do Lead Generator do solarVis.

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

A página explica como os itens de custo, faixas de tamanho de sistema e configurações financeiras trabalham juntos para calcular os resultados finais de investimento exibidos no Lead Generator.

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

No topo da página, você pode alternar entre faixas de tamanho de sistema predefinidas:

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

Cada aba contém uma configuração de custos separada e independente.

Isso significa:

* Você pode definir diferentes combinações de módulos ou inversores para sistemas pequenos e grandes
* Pode aplicar diferentes margens dependendo da escala do sistema
* Pode ajustar custos de fixação, logística ou personalizados com base no tamanho do projeto

O Lead Generator seleciona automaticamente a configuração correta com base no tamanho do sistema calculado durante a análise de viabilidade.

{% hint style="info" %}
O tamanho do sistema calculado é a capacidade ótima determinada com base no consumo de kWh do usuário, localização do projeto e informações de inclinação do telhado para atender da forma mais eficiente possível à demanda energética especificada.
{% endhint %}

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

Você pode selecionar a moeda no menu suspenso (por exemplo, USD, EUR, etc.).

Todos os preços dos itens, totais e resultados financeiros serão calculados e exibidos na moeda selecionada.

Importante:

* A moeda afeta tanto os cálculos internos quanto os resultados para o usuário final
* Certifique-se de que corresponde ao seu mercado-alvo e estratégia de precificação

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

A seção **Itens** define quais componentes de custo são incluídos no cálculo total do projeto.

Cada linha representa um componente de custo.

**Cada linha contém:**

* Categoria
* Item
* Unidade
* Preço Unitário
* Opção de Usar Preço do Banco de Dados
* Excluir Item
* Menu de Configurações Detalhadas (três pontos)

#### Categoria <a href="#category" id="category"></a>

Selecione o tipo de componente de custo. As categorias disponíveis normalmente incluem:

* Módulo
* Inversor

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

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

Quando múltiplos inversores são adicionados, o sistema seleciona a combinação de inversores mais próxima de:

* A **capacidade AC do sistema calculada** é determinada pela potência DC e pela razão DC/AC ótima para o projeto.

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 %}

* Bateria
* Fixação
* Cabos
* Scada
* Frete ou Custo de Mão de Obra
* Personalizado

A categoria selecionada determina quais produtos podem ser escolhidos e como o item é tratado no cálculo.

#### Item <a href="#item" id="item"></a>

Escolha um material ativado do seu banco de dados de materiais.

Dependendo da categoria:

* Para Módulo / Bateria → selecione um modelo
* Para Inversor → selecione um modelo on-grid ou híbrido
* Para Fixação → selecione sistemas de fixação
* Para Personalizado → defina um item de custo personalizado

Isso garante consistência entre seu banco de dados de materiais e a precificação do Lead Generator.

#### Unidade <a href="#unit" id="unit"></a>

A Unidade define como o custo será multiplicado durante o cálculo.

Tipos de unidade disponíveis:

**Quantidade -** O sistema multiplica o preço unitário pelo número calculado de componentes.

**Por Watt -** O sistema multiplica o preço unitário pela capacidade total instalada do sistema (em watts).

**Conjunto -** O preço é aplicado uma vez por projeto, independentemente do tamanho do sistema.

#### Preço Unitário <a href="#unit-price" id="unit-price"></a>

Insira o preço manual caso não esteja utilizando a opção de preço do banco de dados.

A precificação manual permite:

* Substituir preços do banco de dados de materiais
* Aplicar precificação estratégica para campanhas de marketing

#### Usar Preço do Banco de Dados <a href="#use-database-price" id="use-database-price"></a>

Quando ativado:

* O sistema puxa automaticamente o preço do banco de dados de materiais

{% hint style="info" %}
O preço do banco de dados pode ser atualizado na página de **Materiais Ativos**.
{% endhint %}

* O campo Preço Unitário fica bloqueado
* Quaisquer atualizações futuras de preço no banco de dados serão refletidas automaticamente aqui

Quando desativado:

* Você pode inserir e controlar o preço manualmente

Isso oferece flexibilidade entre precificação centralizada e ajustes específicos de campanha.

#### Excluir Item <a href="#delete-item" id="delete-item"></a>

Use o ícone de exclusão para remover o item da configuração.

Remover um item significa que ele não será incluído nos cálculos de custo para aquela faixa de tamanho de sistema.

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

Cada componente possui um painel de configurações dedicado, acessado pelo **menu de três pontos** no lado direito da linha.

{% hint style="info" %}
As alterações feitas aqui afetam diretamente como este material se comporta no cálculo de pré-viabilidade do Lead Generator.
{% endhint %}

Esta janela de configuração é estruturada em duas seções principais:

**Configurações de Proposta**

Esta seção determina como o material selecionado é apresentado nas propostas para o cliente.

Você pode controlar as opções abaixo:

* Decidir se o material aparecerá ou não na proposta.
* Controlar se o cliente pode ver o preço individual do material ou apenas o custo total do sistema.
* Escolher se os descontos aplicados são visíveis para o cliente na proposta.
* Decidir se as informações exatas do fabricante e modelo são exibidas.

{% hint style="info" %}
As configurações de proposta são interligadas. Por exemplo, para exibir o desconto personalizado de um material na proposta, é necessário selecionar tanto **“Exibir este material na proposta”**, **“Exibir preço unitário deste material na proposta”** e **“Exibir desconto deste material na proposta.”**
{% endhint %}

**Configurações Financeiras**

Esta seção controla como o material contribui para os resultados financeiros totais

As opções disponíveis incluem:

* Incluir ou excluir o material do custo total de retorno do investimento
* Aplicar um desconto específico para o material que substitui a lógica padrão de precificação
* Definir uma margem de lucro personalizada para o material
* Aplicar uma alíquota de IVA específica

{% hint style="info" %}
As configurações de proposta e financeiras funcionam de forma independente. Por exemplo, não selecionar “**Exibir desconto deste material na proposta**” nas configurações de proposta não afeta se “**Desconto Personalizado**” está selecionado nas configurações financeiras.
{% endhint %}

#### Adicionar Novo Item <a href="#add-new-item" id="add-new-item"></a>

Clique em **Adicionar novo item** para incluir componentes de custo adicionais conforme as necessidades do projeto.

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

Abaixo da tabela de itens, você pode definir premissas financeiras aplicadas ao custo total calculado.

Essas configurações afetam o custo final do projeto apresentado na proposta ao cliente.

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

* Ative **Exibir Desconto na Proposta** se o desconto deve ser visível para o cliente
* Selecione percentual ou valor
* Defina a taxa de desconto

O desconto é aplicado ao subtotal do projeto calculado.

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

* Selecione percentual ou valor
* Defina sua taxa padrão de margem

O sistema aplica a margem de lucro após somar os custos de materiais e adicionais.

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

* Ative **Exibir IVA na Proposta** se o IVA deve ser exibido na proposta
* O sistema utiliza a alíquota de IVA configurada para o país ou região do projeto. Isso garante conformidade com as regras fiscais locais.

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

Defina uma premissa fixa de custo anual de manutenção. Este valor é utilizado em análises financeiras de longo prazo e cálculos de payback.

{% hint style="info" %}
Após realizar qualquer alteração na página *Configuração de Custos*, não se esqueça de clicar no botão *Salvar* para aplicar as mudanças.
{% endhint %}

{% hint style="info" %}
Todos os resultados financeiros dependem desta configuração; uma configuração precisa é essencial para garantir resultados de pré-viabilidade realistas e estrategicamente alinhados.
{% endhint %}

***

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

* [Todos os Materiais](/documentation/pt/configuration/materials-page/all-materials.md)
* [Materiais Ativos](/documentation/pt/configuration/materials-page/active-materials.md)

Se você encontrar algum problema, [sinta-se à vontade para nos contatar.](https://www.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:

```
GET https://docs.solarvis.co/documentation/pt/solarvis-modules/solarvis-lead-generator/cost-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
