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

# Distinta dei Materiali (BoM)

## Scopo di Questa Pagina <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

Questa pagina rappresenta la **fase finale di definizione dei costi e dei materiali** del progetto. Garantisce che:

* Tutti i componenti tecnici necessari siano inclusi
* Ogni voce sia correttamente prezzata utilizzando le unità appropriate
* Le regole finanziarie come sconti, margini e IVA siano applicate in modo coerente
* La proposta e i calcoli del ritorno sull'investimento riflettano la reale struttura dei costi del progetto

{% hint style="info" %}
Tutte le modifiche apportate qui vengono salvate automaticamente e sono immediatamente riflesse nei totali, nelle proposte e nei risultati finanziari.
{% endhint %}

## Cosa Puoi Fare Qui <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

In questa pagina puoi:

* Revisionare l’attrezzatura principale aggiunta automaticamente dal design
* Aggiungere manualmente materiali e voci di costo aggiuntive o applicare preset predefiniti
* Selezionare tipologie di prezzo come Quantità, Per Watt, Set o altre opzioni basate su unità per ciascun materiale
* Personalizzare la visibilità e il comportamento finanziario di ogni materiale tramite le Impostazioni Dettagliate nella proposta
* Configurare impostazioni di sconto, margine e IVA per l’intera Distinta Base
* Cambiare la valuta istantaneamente
* Scaricare la Distinta Base

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

## Materiali Aggiunti Automaticamente <a href="#automatically-loaded-materials" id="automatically-loaded-materials"></a>

Quando apri questa pagina, solarVis aggiunge automaticamente l’attrezzatura principale in base al design e alla configurazione del progetto:

* Moduli fotovoltaici
* Inverter
* Batterie (se applicabile)
* Pompe di calore (se applicabile)

Questi materiali sono collegati alle fasi di progettazione precedenti. Le loro quantità e i valori relativi al sistema sono calcolati automaticamente e aggiornati quando il design cambia.

{% hint style="info" %}
Solo il *Prezzo Unitario* può essere modificato per questi elementi; tutti gli altri valori derivano dal design del progetto.
{% endhint %}

## Espansione dell’Elenco Materiali <a href="#expanding-the-material-list" id="expanding-the-material-list"></a>

### Preset <a href="#presets" id="presets"></a>

I preset sono un elenco predefinito di materiali per un progetto, creati dagli utenti per velocizzare la configurazione del progetto. Selezionando un preset, tutti i materiali inclusi vengono aggiunti automaticamente.

Casi d’uso tipici dei preset includono:

* Progetti residenziali di energia solare
* Sistemi commerciali per fasce di potenza
* Pacchetti di installazione standard

{% hint style="info" %}
Un collegamento rapido sotto il selettore dei preset consente di gestire e aggiornare i preset.

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

### Aggiunta Manuale di Materiali <a href="#manual-material-addition" id="manual-material-addition"></a>

Cliccando su **Aggiungi Nuovo Materiale**, puoi aggiungere manualmente singole voci alla Distinta Base.

Le categorie di materiali più comuni includono:

* Costo Progetto
* Costo Manodopera
* Costo Spedizione
* Costo Imprevisti
* Strutture di Supporto
* SCADA
* Stazione di Ricarica EV
* Contatore Duplex
* Quadro Elettrico
* Voci personalizzate

Ogni materiale aggiunto può essere completamente personalizzato in termini di prezzo, visibilità e comportamento finanziario.

{% hint style="info" %}
Le righe con campi obbligatori mancanti vengono evidenziate fino al completamento e le modifiche non vengono salvate se ci sono dati mancanti.
{% endhint %}

### Tipologie di Prezzo <a href="#pricing-types" id="pricing-types"></a>

Ogni materiale può essere prezzato utilizzando una specifica **Tipologia di Prezzo**, che definisce come viene calcolato il costo totale.

Le tipologie di prezzo disponibili includono:

* **Quantità -** prezzo fisso moltiplicato per il numero di elementi
* **Per Watt -** calcolato utilizzando la potenza DC del progetto
* **Per Modulo**
* **Per Metro -** comunemente usato per i cavi
* **Per Chilogrammo -** comunemente usato per le strutture di supporto
* **Set -** importo fisso una tantum
* **Percentuale -** calcolato come percentuale del costo parziale del progetto
* **Per Wattora (Batteria)** - basato sulla capacità della batteria

La tipologia di prezzo selezionata determina come il sistema calcola il subtotale.

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

* Per Watt moltiplica il prezzo unitario per la potenza DC totale
* Per Modulo moltiplica il prezzo unitario per il numero di moduli
* Set applica un prezzo fisso una sola volta
* Percentuale applica una percentuale al costo parziale del progetto

Tutti i subtotali si aggiornano automaticamente quando i valori del progetto cambiano.
{% endhint %}

## Selezione della Valuta <a href="#currency-selection" id="currency-selection"></a>

Il selettore di valuta nell’angolo in alto a destra consente di passare istantaneamente tra EUR, USD e altre valute.

Quando la valuta viene cambiata, **tutti i prezzi unitari, i subtotali e i totali vengono ricalcolati automaticamente** senza perdita di dati.

{% hint style="info" %}
Puoi modificare la valuta predefinita del tuo account nella **sezione Azienda** della **pagina Impostazioni.** Una volta aggiornata, la nuova valuta predefinita verrà applicata a tutte le impostazioni di valuta del tuo account in futuro.
{% endhint %}

## Sfoglia Materiali <a href="#browse-materials" id="browse-materials"></a>

* **Sfoglia Materiali** apre l’intero database materiali di solarVis, consentendo di cercare e selezionare prodotti predefiniti.

{% hint style="info" %}
Se non trovi i materiali di cui hai bisogno, puoi utilizzare il pulsante *Richiedi Materiale* nella pagina Tutti i Materiali.
{% endhint %}

## Scarica Distinta Base (BoM) <a href="#download-bom" id="download-bom"></a>

* **Scarica Distinta Base** esporta la Distinta Base completa in formato **Excel** per uso esterno o condivisione.

## Impostazioni Dettagliate (Menu Tre Punti) <a href="#detailed-settings-three-dot-menu" id="detailed-settings-three-dot-menu"></a>

Ogni materiale dispone di un pannello di impostazioni dedicato, accessibile tramite il **menu a tre punti** sul lato destro della riga.

{% hint style="info" %}
Tutte queste impostazioni si applicano solo al materiale selezionato.
{% endhint %}

Questa finestra popup è suddivisa in due sezioni principali:

### Impostazioni Proposta <a href="#proposal-settings" id="proposal-settings"></a>

Controlla come il materiale appare nella proposta al cliente.

Puoi:

* Aggiungere o modificare la descrizione visualizzata per questo materiale nella proposta
* Attivare o disattivare la visualizzazione del materiale
* Attivare o disattivare la visualizzazione del prezzo unitario
* Attivare o disattivare la visualizzazione di marca e modello
* Attivare o disattivare la visualizzazione dello sconto a livello di materiale

> Queste impostazioni influenzano solo l’output della proposta, non i calcoli.

{% hint style="info" %}
Le impostazioni della proposta sono collegate tra loro. Ad esempio, per visualizzare lo sconto personalizzato di un materiale nella proposta, è necessario selezionare sia **“Mostra questo materiale nella proposta”,** **“Mostra il prezzo unitario di questo materiale nella proposta”** e **“Mostra lo sconto di questo materiale nella proposta.”**
{% endhint %}

### Impostazioni Finanziarie <a href="#financial-settings" id="financial-settings"></a>

Le impostazioni finanziarie definiscono come il materiale incide sui calcoli dei costi e sui risultati di fattibilità.

* **Includi nel Ritorno sull’Investimento**

  Determina se questo materiale influisce sui calcoli di ritorno sull’investimento e payback.

  Se disabilitato, il materiale rimane nella pagina Distinta Base e nella proposta, ma viene escluso dalle metriche finanziarie, come il ritorno sull’investimento e l’avanzamento del payback.

Opzioni avanzate di personalizzazione a livello di voce includono:

* **Sconto Personalizzato**

  Applica uno sconto solo a questo materiale, sovrascrivendo lo sconto globale del progetto.
* **Margine di Profitto Personalizzato**

  Imposta un margine specifico per questa voce invece del margine globale.
* **Aliquota IVA Personalizzata**

  Definisce un’aliquota IVA unica per materiali specifici o materiali incentivati, utile in mercati dove voci diverse sono tassate in modo differente.

{% hint style="info" %}
L’IVA personalizzata applicata a questo materiale sarà inclusa nel calcolo totale dell’IVA.
{% endhint %}

Questi valori sovrascrivono le impostazioni globali del progetto per quel materiale specifico.

L’**Importo Totale** visualizzato in fondo alla finestra riflette tutte le regole applicate a quel materiale.

## Impostazioni Finanziarie di Progetto e Totali Calcolati <a href="#project-level-financial-settings-and-calculated-totals" id="project-level-financial-settings-and-calculated-totals"></a>

In fondo alla pagina della Distinta Base, puoi configurare le impostazioni finanziarie che si applicano all’intero progetto.

Puoi regolare:

* **Sconto:** Sconto globale applicato a tutti i materiali
* **Margine di Profitto:** Margine aggiunto ai costi dei materiali
* **Aliquota IVA:** Tassa applicata all’importo finale

> Puoi anche scegliere se mostrare IVA e sconti nella proposta.

Quando questi valori vengono modificati, solarVis ricalcola automaticamente tutti i totali in tempo reale:

* Subtotale
* Importo sconto
* Importo margine di profitto
* Totale esclusa IVA
* IVA
* Totale finale

Queste impostazioni finanziarie a livello di progetto influenzano direttamente l’output della proposta e tutti i calcoli di fattibilità.

## Costo di Manutenzione Annuale <a href="#annual-maintenance-cost" id="annual-maintenance-cost"></a>

Il campo Costo di Manutenzione Annuale consente di definire i costi operativi ricorrenti annuali per il progetto.

Questo valore rappresenta spese come:

* Ispezioni di routine del sistema
* Pulizia e manutenzione minore
* Supporto operativo continuativo

{% hint style="info" %}
Quando viene inserito un costo di manutenzione annuale, il valore è incluso in due diverse parti della proposta:

* Il Periodo di Payback del sistema solare viene ricalcolato
* I calcoli del Flusso di Cassa Cumulativo vengono aggiornati
  {% endhint %}

Ciò garantisce che i risultati finanziari a lungo termine riflettano sia l’investimento iniziale che i costi operativi ricorrenti.

***

## Pagine Correlate <a href="#related-articles" id="related-articles"></a>

* [Pagina Richiesta Materiali](/documentation/it/configuration/materials-page/request-material.md)
* [Pagina Tutti i Materiali](/documentation/it/configuration/materials-page/all-materials.md)
* [Pagina Azienda](/documentation/it/configuration/settings-page/company-settings.md)

Per ulteriore assistenza, non esitare a [contattarci.](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/it/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.
