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

# Lista de materiales (BoM)

## Propósito de Esta Página <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

Esta página sirve como la **etapa final de definición de costos y materiales** del proyecto. Garantiza que:

* Se incluyan todos los componentes técnicos requeridos
* Cada elemento esté correctamente valorado utilizando las unidades apropiadas
* Se apliquen de manera consistente las reglas financieras como descuentos, márgenes e IVA
* La propuesta y los cálculos de retorno de inversión reflejen la verdadera estructura de costos del proyecto

{% hint style="info" %}
Los materiales están organizados en secciones separadas del sistema, como Sistema FV, Batería y Bomba de Calor. Cada sección muestra sus propios materiales y subtotal, mientras que el resumen financiero calcula el precio completo del proyecto.
{% endhint %}

Todos los cambios realizados aquí se guardan automáticamente y se reflejan de inmediato en los totales, propuestas y resultados financieros.

## Qué Puede Hacer Aquí <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

En esta página, puede:

* Revisar el equipo principal agregado automáticamente desde el diseño
* Agregar materiales adicionales a secciones individuales del sistema y elementos de costo manualmente o aplicar preajustes definidos
* Seleccionar tipos de precios como Cantidad, Por Vatio, Conjunto u otras opciones basadas en unidades para cada material
* Personalizar la visibilidad y el comportamiento financiero de cada material mediante Configuración Detallada en la propuesta
* Configurar ajustes de descuento, margen e IVA para toda la Lista de Materiales
* Cambiar la moneda al instante
* Definir el costo anual de mantenimiento
* Descargar la Lista de Materiales

## Cómo Funciona <a href="#how-it-works" id="how-it-works"></a>

Los materiales del proyecto se organizan en secciones separadas según el sistema al que pertenecen. Las secciones disponibles dependen de los materiales incluidos en el proyecto.

El resumen superior muestra el número total de materiales y los valores relevantes del sistema, incluyendo la potencia DC del proyecto, la potencia AC del proyecto y la capacidad de la batería.

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

## Secciones del Sistema y Subtotales <a href="#system-sections-and-subtotals" id="system-sections-and-subtotals"></a>

Los materiales se agrupan en secciones del sistema, tales como:

* Sistema FV
* Batería
* Bomba de Calor

Cada sección muestra el número de materiales que contiene y calcula su propio subtotal.

Utilice el botón Agregar Nuevo Material dentro de una sección para añadir un elemento directamente a ese grupo del sistema.

El subtotal del proyecto combina los valores de todas las secciones activas.

{% hint style="info" %}
Puede incluir o excluir el costo de la batería del ROI del sistema FV. Desactívelo cuando la batería deba permanecer en el precio del proyecto, pero no debe afectar el cálculo del ROI.
{% endhint %}

## Materiales Agregados Automáticamente <a href="#automatically-loaded-materials" id="automatically-loaded-materials"></a>

Cuando abre esta página, solarVis agrega automáticamente el equipo principal según el diseño y la configuración del proyecto:

* Paneles solares
* Inversores
* Baterías (si corresponde)
* Bombas de calor (si corresponde)

Estos materiales están vinculados a los pasos previos del diseño. Sus cantidades y valores relacionados con el sistema se calculan automáticamente y se actualizan cuando el diseño cambia.

{% hint style="info" %}
Solo se puede cambiar el *Precio Unitario* de estos elementos; todos los demás valores provienen del diseño del proyecto.
{% endhint %}

## Ampliando la Lista de Materiales <a href="#expanding-the-material-list" id="expanding-the-material-list"></a>

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

Los preajustes son una lista predefinida de materiales para un proyecto, creada por los usuarios para agilizar la configuración del proyecto. Al seleccionar un preajuste, se agregan automáticamente todos los materiales incluidos en ese preajuste a las secciones relevantes del sistema.

Los casos típicos de uso de preajustes incluyen:

* Proyectos residenciales de energía solar
* Sistemas comerciales por rango de capacidad
* Paquetes estándar de instalación

{% hint style="info" %}
Los elementos de costo incluidos en el preajuste seleccionado se agregan automáticamente bajo sus secciones de sistema asignadas. Los elementos relacionados con la batería se agregan solo cuando una batería está incluida en el proyecto.
{% endhint %}

{% hint style="info" %}
Un enlace directo debajo del selector de preajustes le permite gestionar y actualizar los preajustes.

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

### Adición Manual de Materiales <a href="#manual-material-addition" id="manual-material-addition"></a>

Al hacer clic en **Agregar Nuevo Material**, puede añadir manualmente elementos individuales en la sección del sistema requerida a la Lista de Materiales.

Las categorías comunes de materiales incluyen:

* Costo del Proyecto
* Costo de Mano de Obra
* Costo de Envío
* Costo Inesperado
* Montaje
* SCADA
* Estación de Carga EV
* Medidor Dúplex
* Cuadro Eléctrico
* Elementos personalizados
* Mis Elementos

{% hint style="info" %}
Los materiales en ‘Mis Elementos’ son entradas previamente creadas y guardadas. Al agregar un material desde ‘Mis Elementos’, solo se muestran las entradas que coinciden con la sección del sistema seleccionada. Los materiales asignados a otras categorías o secciones del sistema no se muestran.

Para agregar, actualizar o eliminar una entrada, realice los cambios en la [página Mis Elementos](/documentation/es/configuration/materials-page/my-items.md).
{% endhint %}

Cada material agregado puede personalizarse completamente en términos de precio, visibilidad y comportamiento financiero.

{% hint style="info" %}
Las filas con campos obligatorios faltantes se resaltan hasta que se completen, y los cambios no se guardan si falta algún dato.
{% endhint %}

Los materiales agregados manualmente pueden eliminarse utilizando el botón de eliminar que se muestra en la fila del material.

### Tipos de Precios <a href="#pricing-types" id="pricing-types"></a>

Cada material puede valorarse utilizando un **Tipo de Precio** específico, que define cómo se calcula su costo total.

Los tipos de precios disponibles incluyen:

* **Cantidad -** precio fijo multiplicado por el número de elementos
* **Por Vatio -** calculado usando la potencia DC del proyecto
* **Por Panel**
* **Por Metro -** comúnmente usado para cableado
* **Por Kilogramo -** comúnmente usado para montaje
* **Conjunto -** monto fijo único
* **Porcentaje -** calculado como un porcentaje del costo subtotal del proyecto
* **Por Vatio-hora (Batería)** - basado en la capacidad de la batería

El tipo de precio seleccionado determina cómo el sistema calcula el subtotal.

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

* Por Vatio multiplica el precio unitario por la potencia DC total
* Por Panel multiplica el precio unitario por el número de paneles
* Conjunto aplica un precio fijo una vez
* Porcentaje aplica un porcentaje al costo subtotal del proyecto

Todos los subtotales se actualizan automáticamente cuando cambian los valores del proyecto.
{% endhint %}

## Selección de Moneda <a href="#currency-selection" id="currency-selection"></a>

El selector de moneda en la esquina superior derecha permite cambiar instantáneamente entre EUR, USD y otras monedas.

Cuando se cambia la moneda, **todos los precios unitarios, subtotales y totales se recalculan automáticamente** sin perder datos.

{% hint style="info" %}
Puede cambiar la moneda predeterminada de su cuenta en la **sección Empresa** de la **página de Configuración.** Al actualizarla, la nueva moneda predeterminada se aplicará en la configuración de moneda de su cuenta en adelante.
{% endhint %}

## Explorar Materiales <a href="#browse-materials" id="browse-materials"></a>

* **Explorar Materiales** abre la base de datos completa de materiales de solarVis, permitiéndole buscar y seleccionar productos predefinidos.

{% hint style="info" %}
Si no encuentra los materiales que necesita, puede utilizar el botón *Solicitar Material* en la página Todos los Materiales.
{% endhint %}

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

* **Descargar Lista de Materiales** exporta la Lista de Materiales completa en formato **Excel** para uso externo o para compartir.

## Configuración Detallada (Menú de Tres Puntos) <a href="#detailed-settings-three-dot-menu" id="detailed-settings-three-dot-menu"></a>

Cada material tiene un panel de configuración dedicado al que se accede mediante el **menú de tres puntos** en el lado derecho de la fila.

{% hint style="info" %}
Todas estas configuraciones se aplican solo al material seleccionado.
{% endhint %}

Esta pantalla emergente se divide en dos secciones principales:

### Configuración de Propuesta <a href="#proposal-settings" id="proposal-settings"></a>

Controla cómo aparece el material en la propuesta al cliente.

Puede:

* Agregar o editar la descripción que se muestra para este material en la propuesta
* Alternar para mostrar u ocultar el material
* Alternar para mostrar u ocultar el precio unitario
* Alternar para mostrar u ocultar la marca y el número de modelo
* Alternar para mostrar u ocultar el descuento a nivel de material

> Estas configuraciones solo afectan la salida de la propuesta, no los cálculos.

{% hint style="info" %}
Las configuraciones de propuesta están vinculadas entre sí. Por ejemplo, para mostrar el descuento personalizado de un material en la propuesta, debe seleccionar tanto **“Mostrar este material en la propuesta”**, **“Mostrar el precio unitario de este material en la propuesta”** y “Mostrar el descuento de este material en la propuesta.”
{% endhint %}

### Configuración Financiera <a href="#financial-settings" id="financial-settings"></a>

La configuración financiera define cómo el material impacta en los cálculos de costos y resultados de viabilidad.

* **Incluir en el Retorno de Inversión**

  Determina si este material afecta los cálculos de retorno de inversión y periodo de recuperación.

  Si está desactivado, el material permanece en la página de Lista de Materiales y en la propuesta, pero se excluye de los indicadores financieros, como el retorno de inversión y el progreso de recuperación.

Las opciones avanzadas de anulación a nivel de elemento incluyen:

* **Descuento Personalizado**

  Aplica un descuento solo a este material, anulando el descuento general del proyecto.
* **Margen de Ganancia Personalizado**

  Establece un margen específico para este elemento en lugar del margen global.
* **Tasa de IVA Personalizada**

  Define una tasa de IVA única para materiales específicos o materiales incentivados, útil en mercados donde diferentes elementos tienen impuestos distintos.

{% hint style="info" %}
El IVA personalizado aplicado a este material se incluirá en el cálculo total del IVA.
{% endhint %}

Estos valores anulan la configuración general del proyecto para ese material específico.

El **Monto Total** mostrado en la parte inferior del modal refleja todas las reglas aplicadas para ese material.

## Configuración Financiera a Nivel de Proyecto y Totales Calculados <a href="#project-level-financial-settings-and-calculated-totals" id="project-level-financial-settings-and-calculated-totals"></a>

En la parte inferior de la página de Lista de Materiales, puede configurar los ajustes financieros que se aplican a todo el proyecto.

Puede ajustar:

* **Descuento:** Descuento general aplicado a todos los materiales
* **Margen de Ganancia:** Margen añadido sobre los costos de los materiales
* **Tasa de IVA:** Impuesto aplicado al monto final

> También puede elegir si el IVA y los descuentos son visibles en la propuesta.

A medida que se editan estos valores, solarVis recalcula automáticamente todos los totales en tiempo real:

* Subtotal
* Monto de descuento
* Monto de margen de ganancia
* Total sin IVA
* IVA
* Total final

Estos ajustes financieros a nivel de proyecto afectan directamente la salida de la propuesta y todos los cálculos de viabilidad.

## Costo Anual de Mantenimiento <a href="#annual-maintenance-cost" id="annual-maintenance-cost"></a>

El campo de Costo Anual de Mantenimiento le permite definir los costos operativos recurrentes anuales para el proyecto.

Este valor representa gastos tales como:

* Inspecciones rutinarias del sistema
* Limpieza y mantenimiento menor
* Soporte operativo continuo

{% hint style="info" %}
Cuando se ingresa un costo anual de mantenimiento, el valor se incluye en dos partes diferentes de la propuesta:

* Se recalcula el Periodo de Recuperación del sistema solar
* Se actualizan los cálculos de Flujo de Caja Acumulado
  {% endhint %}

Esto asegura que los resultados financieros a largo plazo reflejen tanto la inversión inicial como los costos operativos continuos.

***

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

* [Página Solicitar Materiales](/documentation/es/configuration/materials-page/request-material.md)
* [Página Todos los Materiales](/documentation/es/configuration/materials-page/all-materials.md)
* [Página Empresa](/documentation/es/configuration/settings-page/company-settings.md)
* [Página Mis Elementos](/documentation/es/configuration/materials-page/my-items.md)

Para más ayuda, no dude en [ponerse en contacto.](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/es/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.
