> 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 base (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 elemento sia correttamente prezzato utilizzando le unità appropriate
* Le regole finanziarie come sconti, margini e IVA siano applicate in modo coerente
* La proposta e i calcoli sul ritorno dell'investimento riflettano la reale struttura dei costi del progetto

{% hint style="info" %}
I materiali sono organizzati in sezioni di sistema separate, come Sistema FV, Batteria e Pompa di Calore. Ogni sezione mostra i propri materiali e il relativo subtotale, mentre il riepilogo finanziario calcola il prezzo complessivo del progetto.
{% endhint %}

Tutte le modifiche apportate qui vengono salvate automaticamente e sono immediatamente riflesse nei totali, nelle proposte e nei risultati finanziari.

## 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 progetto
* Aggiungere manualmente materiali aggiuntivi alle singole sezioni di sistema e voci di costo oppure 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 ciascun materiale tramite le Impostazioni Dettagliate nella proposta
* Configurare sconto, margine e impostazioni IVA per l'intera Distinta Base
* Cambiare valuta istantaneamente
* Definire il costo di manutenzione annuale
* Scaricare la Distinta Base

## Come Funziona <a href="#how-it-works" id="how-it-works"></a>

I materiali del progetto sono organizzati in sezioni separate in base al sistema di appartenenza. Le sezioni disponibili dipendono dai materiali inclusi nel progetto.

Il riepilogo in alto mostra il numero totale di materiali e i valori di sistema rilevanti, inclusi la potenza DC del progetto, la potenza AC del progetto e la capacità della batteria.

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

## Sezioni di Sistema e Subtotali <a href="#system-sections-and-subtotals" id="system-sections-and-subtotals"></a>

I materiali sono raggruppati in sezioni di sistema, come:

* Sistema FV
* Batteria
* Pompa di Calore

Ogni sezione mostra il numero di materiali che contiene e calcola il proprio subtotale.

Utilizza il pulsante Aggiungi Nuovo Materiale all'interno di una sezione per aggiungere un elemento direttamente a quel gruppo di sistema.

Il subtotale del progetto combina i valori di tutte le sezioni attive.

{% hint style="info" %}
È possibile includere o escludere il costo della batteria dal ROI del sistema FV. Disabilitalo quando la batteria deve rimanere nel prezzo del progetto, ma non deve influenzare il calcolo del ROI.
{% endhint %}

## 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 progetto viene modificato.

{% hint style="info" %}
Solo il *Prezzo Unitario* può essere modificato per questi elementi; tutti gli altri valori derivano dal 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 alle relative sezioni di sistema.

Casi d'uso tipici dei preset includono:

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

{% hint style="info" %}
Le voci di costo incluse nel preset selezionato vengono aggiunte automaticamente sotto le rispettive sezioni di sistema. Gli elementi relativi alla batteria vengono aggiunti solo se una batteria è inclusa nel progetto.
{% endhint %}

{% 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 singoli elementi nella sezione di sistema richiesta alla Distinta Base.

Le categorie di materiali più comuni includono:

* Costo Progetto
* Costo Manodopera
* Costo Spedizione
* Costo Imprevisti
* Struttura di Supporto
* SCADA
* Stazione di Ricarica EV
* Contatore Duplex
* Quadro Elettrico
* Elementi personalizzati
* I Miei Elementi

{% hint style="info" %}
I materiali in ‘I Miei Elementi’ sono voci precedentemente create e salvate. Quando si aggiunge un materiale da ‘I Miei Elementi’, vengono visualizzate solo le voci che corrispondono alla sezione di sistema selezionata. I materiali assegnati ad altre categorie o sezioni di sistema non vengono mostrati.

Per aggiungere, aggiornare o eliminare una voce, apporta le modifiche nella [pagina I Miei Elementi](/documentation/it/configuration/materials-page/my-items.md).
{% endhint %}

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

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

I materiali aggiunti manualmente possono essere rimossi utilizzando il pulsante elimina visualizzato sulla riga del materiale.

### 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 totale 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 totale 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 modificata, **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.
{% 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 schermata 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 influisce 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 a livello di elemento includono:

* **Sconto Personalizzato**

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

  Imposta un margine specifico per questo elemento invece del margine globale.
* **Aliquota IVA Personalizzata**

  Definisce un'aliquota IVA unica per materiali specifici o materiali incentivati, utile nei mercati in cui diversi elementi sono tassati 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 generali del progetto per quello specifico materiale.

L'**Importo Totale** mostrato in fondo al modulo 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 generale 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 fotovoltaico 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 sia i costi operativi continuativi.

***

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

* [Pagina Richiedi 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)
* [Pagina I Miei Elementi](/documentation/it/configuration/materials-page/my-items.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, and the optional `goal` query parameter:

```
GET https://docs.solarvis.co/documentation/it/project-design/create-a-project/bill-of-materials-bom.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.
