> 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/project-design/create-a-project/bill-of-materials-bom.md).

# Lista de Materiais (BoM)

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

Esta página serve como a **etapa final de definição de custos e materiais** do projeto. Ela garante que:

* Todos os componentes técnicos necessários estejam incluídos
* Cada item seja precificado corretamente utilizando as unidades apropriadas
* Regras financeiras como descontos, margens e IVA sejam aplicadas de forma consistente
* A proposta e os cálculos de retorno sobre o investimento reflitam a verdadeira estrutura de custos do projeto

{% hint style="info" %}
Todas as alterações feitas aqui são salvas automaticamente e refletidas imediatamente nos totais, propostas e resultados financeiros.
{% endhint %}

## 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:

* Revisar os equipamentos principais adicionados automaticamente a partir do design
* Adicionar materiais e itens de custo manualmente ou aplicar predefinições
* Selecionar tipos de precificação como Quantidade, Por Watt, Conjunto ou outras opções baseadas em unidade para cada material
* Personalizar a visibilidade e o comportamento financeiro de cada material através das Configurações Detalhadas na proposta
* Configurar descontos, margens e IVA para toda a Lista de Materiais
* Alterar a moeda instantaneamente
* Baixar a Lista de Materiais

{% embed url="<https://app.arcade.software/share/uxEpjv5L0zYMFkV03h1U?language=pt>" %}

## Materiais Adicionados Automaticamente <a href="#automatically-loaded-materials" id="automatically-loaded-materials"></a>

Ao abrir esta página, o solarVis adiciona automaticamente os principais equipamentos com base no design e configuração do projeto:

* Módulos fotovoltaicos
* Inversores
* Baterias (se aplicável)
* Bombas de calor (se aplicável)

Estes materiais estão vinculados às etapas anteriores do design. Suas quantidades e valores relacionados ao sistema são calculados automaticamente e atualizados quando o design é alterado.

{% hint style="info" %}
Apenas o *Preço Unitário* pode ser alterado para estes itens; todos os outros valores vêm do design do projeto.
{% endhint %}

## Expandindo a Lista de Materiais <a href="#expanding-the-material-list" id="expanding-the-material-list"></a>

### Predefinições <a href="#presets" id="presets"></a>

Predefinições são listas de materiais pré-definidas para um projeto, criadas por usuários para agilizar a configuração do projeto. Ao selecionar uma predefinição, todos os materiais incluídos nela são adicionados automaticamente.

Casos típicos de uso de predefinições incluem:

* Projetos residenciais de energia solar
* Sistemas comerciais por faixa de capacidade
* Pacotes padrão de instalação

{% hint style="info" %}
Um atalho abaixo do seletor de predefinições permite gerenciar e atualizar as predefinições.

<img src="/files/ifN1sEzzr5Wj8wOlkCIy" alt="" data-size="original">
{% endhint %}

### Adição Manual de Materiais <a href="#manual-material-addition" id="manual-material-addition"></a>

Clicando em **Adicionar Novo Material**, você pode adicionar manualmente itens individuais à Lista de Materiais.

Categorias comuns de materiais incluem:

* Custo do Projeto
* Custo de Mão de Obra
* Custo de Frete
* Custo Inesperado
* Estrutura de Fixação
* SCADA
* Estação de Recarga para Veículos Elétricos
* Medidor Duplex
* Quadro Elétrico
* Itens personalizados

Cada material adicionado pode ser totalmente personalizado em termos de precificação, visibilidade e comportamento financeiro.

{% hint style="info" %}
Linhas com campos obrigatórios ausentes são destacadas até serem preenchidas e as alterações não são salvas se houver dados faltantes.
{% endhint %}

### Tipos de Precificação <a href="#pricing-types" id="pricing-types"></a>

Cada material pode ser precificado utilizando um **Tipo de Precificação** específico, que define como seu custo total é calculado.

Os tipos de precificação disponíveis incluem:

* **Quantidade -** preço fixo multiplicado pela quantidade de itens
* **Por Watt -** calculado utilizando a potência DC do projeto
* **Por Módulo**
* **Por Metro -** comumente usado para cabeamento
* **Por Quilograma -** comumente usado para estrutura de fixação
* **Conjunto -** valor fixo único
* **Percentual -** calculado como uma porcentagem do custo subtotal do projeto
* **Por Watt-hora (Bateria)** - baseado na capacidade da bateria

O tipo de precificação selecionado determina como o sistema calcula o subtotal.

{% hint style="info" %}
Exemplos:

* Por Watt multiplica o preço unitário pela potência DC total
* Por Módulo multiplica o preço unitário pela quantidade de módulos
* Conjunto aplica um preço fixo uma única vez
* Percentual aplica uma porcentagem ao custo subtotal do projeto

Todos os subtotais são atualizados automaticamente quando os valores do projeto mudam.
{% endhint %}

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

O seletor de moeda no canto superior direito permite alternar instantaneamente entre EUR, USD e outras moedas.

Quando a moeda é alterada, **todos os preços unitários, subtotais e totais são recalculados automaticamente** sem perda de dados.

{% hint style="info" %}
Você pode alterar a moeda padrão da sua conta na **seção Empresa** da **página de Configurações.** Ao atualizar, a nova moeda padrão será aplicada em todas as configurações de moeda da sua conta daqui em diante.
{% endhint %}

## Navegar pelos Materiais <a href="#browse-materials" id="browse-materials"></a>

* **Navegar pelos Materiais** abre o banco de dados completo de materiais do solarVis, permitindo pesquisar e selecionar produtos pré-definidos.

{% hint style="info" %}
Se não encontrar os materiais necessários, utilize o botão *Solicitar Material* na página Todos os Materiais.
{% endhint %}

## Baixar Lista de Materiais (BoM) <a href="#download-bom" id="download-bom"></a>

* **Baixar Lista de Materiais** exporta a Lista de Materiais completa em formato **Excel** para uso externo ou compartilhamento.

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

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

{% hint style="info" %}
Todas essas configurações se aplicam apenas ao material selecionado.
{% endhint %}

Esta tela pop-up é dividida em duas seções principais:

### Configurações da Proposta <a href="#proposal-settings" id="proposal-settings"></a>

Controla como o material aparece na proposta para o cliente.

Você pode:

* Adicionar ou editar a descrição exibida para este material na proposta
* Alternar para mostrar ou ocultar o material
* Alternar para mostrar ou ocultar o preço unitário
* Alternar para mostrar ou ocultar marca e modelo
* Alternar para mostrar ou ocultar desconto no nível do material

> Essas configurações afetam apenas a saída da proposta, não os cálculos.

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

### Configurações Financeiras <a href="#financial-settings" id="financial-settings"></a>

As configurações financeiras definem como o material impacta os cálculos de custo e os resultados de viabilidade.

* **Incluir no Retorno sobre o Investimento**

  Determina se este material afeta os cálculos de retorno sobre o investimento e payback.

  Se desabilitado, o material permanece na página da Lista de Materiais e na proposta, mas é excluído dos indicadores financeiros, como retorno sobre o investimento e progresso do payback.

Ajustes avançados no nível do item incluem:

* **Desconto Personalizado**

  Aplica um desconto apenas a este material, substituindo o desconto global do projeto.
* **Margem de Lucro Personalizada**

  Define uma margem específica para este item em vez da margem global.
* **Alíquota de IVA Personalizada**

  Define uma alíquota de IVA única para materiais específicos ou materiais incentivados, útil em mercados onde diferentes itens possuem tributações distintas.

{% hint style="info" %}
O IVA personalizado aplicado a este material será incluído no cálculo total do IVA.
{% endhint %}

Estes valores substituem as configurações globais do projeto para aquele material específico.

O **Valor Total** exibido na parte inferior do modal reflete todas as regras aplicadas para aquele material.

## Configurações Financeiras do Projeto e Totais Calculados <a href="#project-level-financial-settings-and-calculated-totals" id="project-level-financial-settings-and-calculated-totals"></a>

Na parte inferior da página da Lista de Materiais, é possível configurar as definições financeiras que se aplicam a todo o projeto.

Você pode ajustar:

* **Desconto:** Desconto global aplicado a todos os materiais
* **Margem de Lucro:** Margem adicionada sobre o custo dos materiais
* **Alíquota de IVA:** Imposto aplicado ao valor final

> Você também pode escolher se o IVA e os descontos serão visíveis na proposta.

À medida que esses valores são editados, o solarVis recalcula automaticamente todos os totais em tempo real:

* Subtotal
* Valor do desconto
* Valor da margem de lucro
* Total sem IVA
* IVA
* Total final

Essas configurações financeiras em nível de projeto impactam diretamente a saída da proposta e todos os cálculos de viabilidade.

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

O campo de Custo Anual de Manutenção permite definir custos operacionais recorrentes anuais para o projeto.

Este valor representa despesas como:

* Inspeções rotineiras do sistema
* Limpeza e pequenos serviços
* Suporte operacional contínuo

{% hint style="info" %}
Quando um custo anual de manutenção é inserido, o valor é incluído em duas partes diferentes da proposta:

* O Período de Retorno do sistema solar é recalculado
* Os cálculos de Fluxo de Caixa Acumulado são atualizados
  {% endhint %}

Isso garante que os resultados financeiros de longo prazo reflitam tanto o investimento inicial quanto os custos operacionais contínuos.

***

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

* [Página de Solicitação de Materiais](/documentation/pt/configuration/materials-page/request-material.md)
* [Página de Todos os Materiais](/documentation/pt/configuration/materials-page/all-materials.md)
* [Página da Empresa](/documentation/pt/configuration/settings-page/company-settings.md)

Para mais assistência, não hesite em [entrar em contato.](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/project-design/create-a-project/bill-of-materials-bom.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.
