> 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/sl/configuration/settings-page/project-settings/package-settings.md).

# Package Settings

## Purpose of This Page <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

The Package Settings page enables you to create standardized, ready-to-use system offerings that can be reused across different workflows.

Its main purpose is to:

* Power the **Solar Lead Generation (LG)** with predefined package options and pricing logic
* Accelerate project creation for **Basic-type projects**

By defining system logic, materials, and commercial rules in advance, you reduce manual work, eliminate pricing inconsistencies, and streamline lead handling.

## What You Can Do Here <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

On this page, you can do the following points:

* Create and manage **Main Packages** (complete system configurations)
* Create and manage **Add-on Packages** (optional components such as batteries, heat pumps, or EV chargers)
* Define system materials (panels, inverters, mounting, other components)
* Configure pricing logic, discounts, margins, and VAT behavior
* Upload package images and descriptions (used in Lead Generator flows)
* Control which add-ons are available for each main package
* Maintain standardized commercial structures for Basic-type projects

## Main Page Overview <a href="#main-page-overview" id="main-page-overview"></a>

Package Settings allow you to define **ready-to-use system offerings** that are primarily used by **Solar Lead Generation (LG).**

These packages are **not directly tied to the proposal workflow by default**. Instead, they are used to automatically generate system offers and pricing for customers who submit their information through your website via Solar Lead Generation.

Additionally, Package Settings can also be reused inside projects under specific conditions.

## Where Package Settings Are Used <a href="#where-package-settings-are-used" id="where-package-settings-are-used"></a>

Package Settings are used in two main areas:

1. **Solar Lead Generation (LG)**
2. **Bill of Materials (BOM)** - when the project uses a *Basic* configuration type

### Package Settings in Solar Lead Generation <a href="#package-settings-in-solar-lead-generator" id="package-settings-in-solar-lead-generator"></a>

#### Purpose <a href="#purpose" id="purpose"></a>

When Solar Lead Generation is enabled, Package Settings define **what system options are offered to website visitors** and **how pricing is calculated**.

Customers fill in their project details on your website, and SolarVis uses the predefined packages to:

* Select appropriate system configurations
* Generate and send offers based on predefined rules

This ensures:

* Fully standardized offers
* Consistent pricing and margins
* Minimal manual intervention while collecting lead submissions

#### How It Works <a href="#how-it-works" id="how-it-works"></a>

* All system logic, materials, and pricing are configured **in advance** in Package Settings
* While a lead is submitted:
  * SolarVis selects a matching package from predefined packages
  * Calculates system size and total price
  * Prepares the pre-offer that is sent to the customer

{% hint style="info" %}
Package Settings must be **fully defined and validated** before using Solar Lead Generation.
{% endhint %}

### Package Settings in Bill of Materials Page (Basic Project Type) <a href="#package-settings-in-bill-of-materials-page-basic-project-type" id="package-settings-in-bill-of-materials-page-basic-project-type"></a>

#### Purpose <a href="#purpose" id="purpose"></a>

Package Settings can also be used during project creation **if the project is configured as a Basic type** in the Project Details.

In this scenario:

* The user can select a predefined package instead of manually building the system
* All materials from the selected package can be added to the Bill of Materials (BoM) page when users choose to do so.
* Pricing and material structure follow the package definition after adding it

This provides a faster workflow for standardized or small-scale projects.

{% hint style="info" %}
Project-level costs can still be modified, enabling project-specific adjustments without changing the package setting values.
{% endhint %}

## Package Types <a href="#package-types" id="package-types"></a>

Package Settings are divided into two types:

* **Main Packages**
* **Add-on Packages**

These package types behave consistently across both:

* Solar Lead Generation
* Bill of Materials (BoM) usage (Basic projects)

### Main Packages <a href="#main-packages" id="main-packages"></a>

#### Overview <a href="#overview" id="overview"></a>

Main Packages define the **solar system configuration** offered through Solar Lead Generation or applied to Basic-type projects.

Each main package:

* Is linked to a specific grid connection type
* Represents the primary system option

For each main package, the list displays:

* Package name
* Grid connection type
* Whether add-ons are available
* Panel count
* Calculated DC power
* Calculated AC power
* Total package price
* Creation date

This overview allows you to quickly compare system sizes and prices without opening each package individually.

#### Configuration Rules <a href="#configuration-rules" id="configuration-rules"></a>

For each main package, you can:

* Define:
  * Package name
  * Package image
  * Description
* Select the grid connection type
* Add required materials:
  * Exactly **one panel item**
  * At least **one inverter item**
* Add additional materials:
  * Mounting systems
  * Balance-of-system components
  * My Items

{% hint style="info" %}
The available My Items are filtered according to the relevant package section and material category. Items that do not match the selected section are not displayed.
{% endhint %}

* Define commercial rules:
  * Pricing logic
  * Discounts
  * Profit margins
  * VAT behavior

{% hint style="info" %}
You should select add-on items for the package in the main packages if you want to include and display optional products or services that complement the main package configuration.
{% endhint %}

### Add-on Packages <a href="#add-on-packages" id="add-on-packages"></a>

#### Overview <a href="#overview" id="overview"></a>

Add-on Packages define **optional system components** that can be offered together with a main package.

They are used for:

* Battery systems
* Heat Pumps
* EV charging stations

{% hint style="info" %}
The selected category determines the product section displayed under Package Items.
{% endhint %}

For each add-on package, the list displays:

* Add-on name
* Category
* Number of items included
* Total price
* Creation date and last updated date

This overview helps you manage optional offerings such as batteries or EV chargers and ensures pricing consistency across proposals.

From this page, you can create new add-on packages or maintain existing ones.

#### Configuration Options <a href="#configuration-options" id="configuration-options"></a>

For add-on packages, you can:

* Select a package category (e.g., battery, heat pumps, EV chargers)
* Upload a package image (used in LG flows)
* Add one or more items from the materials database
* Choose pricing behavior:
  * Use database pricing
  * Use manual pricing
* Configure:
  * Discounts
  * Profit margins
  * VAT behavior

***

## Related Pages <a href="#related-pages" id="related-pages"></a>

* [Bill of Materials Page](/documentation/sl/project-design/create-a-project/bill-of-materials-bom.md)
* [Solar Lead Generation](/documentation/sl/solarvis-modules/solar-lead-generation.md)
* [My Items Page](/documentation/sl/configuration/materials-page/my-items.md)

For more assistance, don’t hesitate to [get in touch.](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/sl/configuration/settings-page/project-settings/package-settings.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.