> 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) ## Objetivo Desta Página 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 * Os cálculos da proposta e do retorno sobre o investimento reflitam a verdadeira estrutura de custos do projeto {% hint style="info" %} Os materiais são organizados em seções separadas do sistema, como Sistema FV, Bateria e Bomba de Calor. Cada seção exibe seus próprios materiais e subtotal, enquanto o resumo financeiro calcula o preço total do projeto. {% endhint %} Todas as alterações feitas aqui são salvas automaticamente e refletidas imediatamente nos totais, propostas e resultados financeiros. ## O Que Você Pode Fazer Aqui Nesta página, você pode: * Revisar automaticamente os equipamentos principais adicionados a partir do projeto * Adicionar materiais adicionais a seções individuais do sistema 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 as definições de desconto, margem e IVA para toda a Lista de Materiais * Alterar a moeda instantaneamente * Definir o custo anual de manutenção * Baixar a Lista de Materiais ## Como Funciona Os materiais do projeto são organizados em seções separadas com base no sistema ao qual pertencem. As seções disponíveis dependem dos materiais incluídos no projeto. O resumo no topo exibe o número total de materiais e valores relevantes do sistema, incluindo potência DC do projeto, potência AC do projeto e capacidade da bateria. {% embed url="" %} ## Seções do Sistema e Subtotais Os materiais são agrupados em seções do sistema, como: * Sistema FV * Bateria * Bomba de Calor Cada seção mostra o número de materiais que contém e calcula seu próprio subtotal. Use o botão Adicionar Novo Material dentro de uma seção para adicionar um item diretamente a esse grupo do sistema. O subtotal do projeto combina os valores de todas as seções ativas. {% hint style="info" %} Pode incluir ou excluir o custo da bateria do ROI do sistema FV. Desative quando a bateria deve permanecer no preço do projeto, mas não deve afetar o cálculo do ROI. {% endhint %} ## Materiais Adicionados Automaticamente Ao abrir esta página, o solarVis adiciona automaticamente os equipamentos principais com base no projeto e configuração: * Módulos solares * Inversores * Baterias (se aplicável) * Bombas de calor (se aplicável) Esses materiais estão vinculados às etapas anteriores do projeto. Suas quantidades e valores relacionados ao sistema são calculados automaticamente e atualizados quando o projeto é alterado. {% hint style="info" %} Apenas o *Preço Unitário* pode ser alterado para esses itens; todos os outros valores vêm do projeto. {% endhint %} ## Expandindo a Lista de Materiais ### Predefinições Predefinições são listas de materiais pré-definidas para um projeto, criadas por usuários para agilizar a configuração do projeto. Selecionar uma predefinição adiciona automaticamente todos os materiais incluídos nela às seções relevantes do sistema. 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" %} Itens de custo incluídos na predefinição selecionada são automaticamente adicionados sob suas seções de sistema atribuídas. Itens de predefinição relacionados à bateria são adicionados apenas quando uma bateria está incluída no projeto. {% endhint %} {% hint style="info" %} Um atalho abaixo do seletor de predefinições permite gerenciar e atualizar as predefinições. {% endhint %} ### Adição Manual de Materiais Clicando em **Adicionar Novo Material**, você pode adicionar manualmente itens individuais na seção do sistema desejada à 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 * Meus Itens {% hint style="info" %} Os materiais em ‘Meus Itens’ são entradas previamente criadas e salvas. Ao adicionar um material de ‘Meus Itens’, apenas as entradas que correspondem à seção do sistema selecionada são exibidas. Materiais atribuídos a outras categorias ou seções do sistema não são mostrados. Para adicionar, atualizar ou excluir uma entrada, faça as alterações na [página Meus Itens](/documentation/pt/configuration/materials-page/my-items.md). {% endhint %} 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 completadas, e alterações não são salvas se houver dados faltando. {% endhint %} Materiais adicionados manualmente podem ser removidos usando o botão de exclusão exibido na linha do material. ### Tipos de Precificação 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 usando 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 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 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 * **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) * **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) 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 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 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 desativado, 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. Substituições avançadas 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 %} Esses 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 Na parte inferior da página da Lista de Materiais, você pode 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 os custos 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 moldam diretamente a saída da proposta e todos os cálculos de viabilidade. ## Custo Anual de Manutenção O campo de Custo Anual de Manutenção permite definir custos operacionais recorrentes anuais para o projeto. Esse valor representa despesas como: * Inspeções rotineiras do sistema * Limpeza e pequenas manutenções * 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 * [Página Solicitar Materiais](/documentation/pt/configuration/materials-page/request-material.md) * [Página Todos os Materiais](/documentation/pt/configuration/materials-page/all-materials.md) * [Página da Empresa](/documentation/pt/configuration/settings-page/company-settings.md) * [Página Meus Itens](/documentation/pt/configuration/materials-page/my-items.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, and the optional `goal` query parameter: ``` GET https://docs.solarvis.co/documentation/pt/project-design/create-a-project/bill-of-materials-bom.md?ask=&goal= ``` `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.