# Budget

**Budget** è uno dei diversi moduli acquistabili da **OpenSTAManager.** Permette di visualizzare sotto forma di grafico e tabella l'**andamento economico** (costi/ricavi) e l'**andamento finanziario** (entrate/uscite). Oltre all'andamento reale, permette di integrare anche le **previsioni di costi e ricavi**, e delle **entrate** e **uscite**.

{% hint style="info" %}
[Clicca qui](https://shop.openstamanager.com/prodotto/budget/) per procedere all'acquisto.
{% endhint %}

A seguito dell'installazione del modulo, cliccando su **Budget** apparirà il seguente prospetto che evidenzia l'**Utile totale**, dato dalla differenza tra ricavi e costi totali.

<figure><img src="https://content.gitbook.com/content/8XtQwt32GTRJmMxkR0px/blobs/2MRbzeH7X5NWfW0YpKWn/immagine.png" alt=""><figcaption></figcaption></figure>

#### Componenti principali

* **Grafico**: Visualizzazione grafica dell'andamento economico e finanziario
* **Tabella**: Dati dettagliati per periodo
* **Utile totale**: Differenza tra ricavi e costi

### 💰 Andamento economico

L'andamento economico analizza i **costi** e i **ricavi** dell'azienda.

#### Ricavi

I ricavi sono composti da due elementi:

1. **Ricavi reali**: Somma delle fatture di vendita già contabilizzate
2. **Ricavi totali**: Somma dei ricavi reali + ricavi previsti da previsionali o sorgenti esterne

#### Costi

I costi seguono la stessa logica dei ricavi:

* **Costi reali**: Somma delle fatture di acquisto già contabilizzate
* **Costi totali**: Somma dei costi reali + costi previsti da previsionali o sorgenti esterne

<figure><img src="https://content.gitbook.com/content/8XtQwt32GTRJmMxkR0px/blobs/F8I1rLZfw3jJrjWw9RWl/immagine.png" alt=""><figcaption></figcaption></figure>

***

### 💵 Andamento finanziario

L'andamento finanziario analizza le **entrate** e le **uscite** effettive o previste.

#### Caratteristiche principali

A differenza dell'andamento economico, l'andamento finanziario:

* **Attinge dati anche dallo scadenzario**
* **Imputa tutte le scadenze previste** nel relativo periodo di competenza
* Considera l'importo **lordo** (IVA inclusa)

#### Distribuzione dei pagamenti

La previsione di entrata/uscita considera l'importo lordo e lo distribuisce in base al:

* **Tipo di pagamento specificato nel documento**
* **Pagamento legato all'anagrafica** (se mancante nel documento)

***

### 🔮 Previsionale

Le previsioni economiche sono configurabili dal sotto-menu **"Previsionale"**.

<figure><img src="https://content.gitbook.com/content/8XtQwt32GTRJmMxkR0px/blobs/EDYFfsTUQvq3YVN6xwz9/immagine.png" alt=""><figcaption></figcaption></figure>

<figure><img src="https://content.gitbook.com/content/8XtQwt32GTRJmMxkR0px/blobs/ROHMWeMRXL8uUnVnTWpA/immagine.png" alt=""><figcaption></figcaption></figure>

#### Funzionalità

Dal menu Previsionale è possibile:

* **Creare previsioni di costi e ricavi**
* **Selezionare la ricorrenza** delle previsioni
* **Gestire periodi temporali** specifici

#### Ricorrenze supportate

Le previsioni possono essere configurate con diverse ricorrenze:

* Mensile
* Trimestrale
* Semestrale
* Annuale
* Personalizzata

***

### 🔌 Sorgenti esterne

Le sorgenti esterne permettono di integrare nel previsionale dati provenienti da altre aree di OpenSTAManager.

#### Sorgenti predefinite

Tra le sorgenti esterne sono inserite di default delle query che è possibile abilitare o disabilitare:

1. **DDT**: Ricavi provenienti da DDT accettati ma non ancora evasi
2. **Ordini clienti**: Ricavi da ordini clienti accettati ma non ancora evasi

#### Query SQL personalizzate

Per utenti avanzati (o su richiesta ai tecnici OpenSTAManager) è possibile configurare delle query SQL personalizzate per inserire ulteriori previsioni.

**Esempio: Previsione di ricavo da preventivo**

```sql
SELECT 
    (totale) AS totale,
    (descrizione) AS descrizione,
    (data) AS data,
    (scaduto) AS scaduto,
    (anagrafica) AS anagrafica
FROM ...
```

#### Requisiti delle query

Le query devono restituire almeno questi 4 campi:

* **totale**: Rappresenta l'importo da calcolare nel previsionale
* **descrizione**: Descrizione visualizzata nel previsionale
* **data**: Data in cui far ricadere la previsione
* **scaduto**: 1 per marcare la scadenza come scaduta (raggruppata nella popup di dettaglio)
* **anagrafica**: Nome dell'anagrafica a cui imputare la previsione

#### Query di esempio

**Previsionale entrate da contratti**

```sql
SELECT 
    ( ( (`co_righe_contratti`.`subtotale`-`co_righe_contratti`.`sconto`)/`co_righe_contratti`.`qta`)*(`co_righe_contratti`.`qta`-`co_righe_contratti`.`qta_evasa`) ) AS totale,
    CONCAT('Contratto ', `co_contratti`.`numero`, ': ', `co_righe_contratti`.`descrizione`) AS descrizione, 
    IF( `co_righe_contratti`.`data_fatturazione` < CURDATE(), CURDATE(), `co_righe_contratti`.`data_fatturazione`) AS data,
    IF( `co_righe_contratti`.`data_fatturazione` < CURDATE(), 1, 0) AS scaduto,
    an_anagrafiche.ragione_sociale AS anagrafica
FROM 
    `co_righe_contratti` 
    INNER JOIN `co_contratti` ON `co_contratti`.`id`=`co_righe_contratti`.`idcontratto` 
    INNER JOIN `an_anagrafiche` ON an_anagrafiche.idanagrafica=co_contratti.idanagrafica
WHERE 
    LAST_DAY( IF( `co_righe_contratti`.`data_fatturazione` < CURDATE(), CURDATE(), `co_righe_contratti`.`data_fatturazione`) ) = LAST_DAY('|anno|-|mese|-01')
    AND NOT `co_righe_contratti`.`is_descrizione`=1
    AND NOT (`co_righe_contratti`.`qta`-`co_righe_contratti`.`qta_evasa`) = 0
```

**Previsionale incassi da contratti**

```sql
SELECT 
    (( (`co_righe_contratti`.`subtotale`-`co_righe_contratti`.`sconto`)/`co_righe_contratti`.`qta`)*(`co_righe_contratti`.`qta`-`co_righe_contratti`.`qta_evasa`)*IFNULL(pagamenti2.prc/100, 1)+( (`co_righe_contratti`.`subtotale`-`co_righe_contratti`.`sconto`)/`co_righe_contratti`.`qta`)*(`co_righe_contratti`.`qta`-`co_righe_contratti`.`qta_evasa`)*IFNULL(pagamenti2.prc/100, 1)/100*IFNULL(co_iva.percentuale, '|iva_predefinita|' )) AS totale,
    CONCAT('Contratto ', `co_contratti`.`numero`, ': ', `co_righe_contratti`.`descrizione`) AS descrizione, 
    IF( `co_righe_contratti`.`data_fatturazione` + INTERVAL IFNULL(pagamenti2.num_giorni, 0) DAY < CURDATE(), CURDATE(), `co_righe_contratti`.`data_fatturazione` + INTERVAL IFNULL(pagamenti2.num_giorni, 0) DAY) AS data,
    IF( `co_righe_contratti`.`data_fatturazione` + INTERVAL IFNULL(pagamenti2.num_giorni, 0) DAY < CURDATE(), 1, 0) AS scaduto,
    an_anagrafiche.ragione_sociale AS anagrafica
FROM 
    `co_righe_contratti` 
    INNER JOIN `co_contratti` ON `co_contratti`.`id`=`co_righe_contratti`.`idcontratto` 
    INNER JOIN `an_anagrafiche` ON an_anagrafiche.idanagrafica=co_contratti.idanagrafica
    LEFT JOIN co_iva ON co_iva.id=an_anagrafiche.idiva_vendite
    LEFT JOIN co_pagamenti ON an_anagrafiche.idpagamento_vendite=co_pagamenti.id
    LEFT JOIN co_pagamenti AS pagamenti2 ON co_pagamenti.descrizione=pagamenti2.descrizione
WHERE 
    LAST_DAY( IF( `co_righe_contratti`.`data_fatturazione` + INTERVAL IFNULL(pagamenti2.num_giorni, 0) DAY < CURDATE(), CURDATE(), `co_righe_contratti`.`data_fatturazione` + INTERVAL IFNULL(pagamenti2.num_giorni, 0) DAY) ) = LAST_DAY('|anno|-|mese|-01')
    AND NOT `co_righe_contratti`.`is_descrizione`=1
    AND NOT (`co_righe_contratti`.`qta`-`co_righe_contratti`.`qta_evasa`) = 0
```

***

### 📄 Dettagli dei documenti

Per analizzare nel dettaglio tutti i documenti che concorrono a costituire il valore di entrate e uscite:

1. **Cliccare sull'importo interessato** nella tabella
2. Si aprirà una schermata con i riferimenti alle diverse fatture

Questa funzionalità permette di:

* Visualizzare l'elenco completo dei documenti
* Accedere direttamente ai documenti originali
* Verificare la composizione degli importi

***

### 📚 Conti per ricavi e costi

Cliccando sul tasto **"+"** vicino a Ricavi e Costi, sarà possibile vedere la lista dei conti in cui:

* **Ricavi** saranno imputati
* **Costi** saranno imputati

Questa visualizzazione permette di:

* Verificare la corretta contabilizzazione
* Identificare i conti di contabilità generale utilizzati
* Effettuare verifiche contabili

***

### ⚖️ Differenze tra andamento economico e finanziario

#### Andamento economico

* **Calcola costi e ricavi** al netto di IVA
* **Previsione per intero** in base alla data del documento
* **Data di competenza**: data del documento
* **Fonte dati**: fatture contabilizzate + previsionali

#### Andamento finanziario

* **Calcola entrate e uscite** al lordo di IVA
* **Distribuisce l'importo** in base al tipo di pagamento
* **Data di competenza**: date delle scadenze di pagamento
* **Fonte dati**: scadenzario + fatture + previsionali

***

### 📝 Esempi pratici

#### Esempio 1: Fattura con Ri.Ba. a 30/60gg

Avendo una fattura di **100€** (+ IVA ordinaria 22%) dovendola pagare con Ri.Ba. a 30/60gg:

**Andamento economico:**

* Ricavo: 100€ (imputato alla data della fattura)

**Andamento finanziario:**

* Totale lordo: 122€ (100€ + 22€ IVA)
* Primo pagamento: 61€ a 30 giorni
* Secondo pagamento: 61€ a 60 giorni

#### Esempio 2: Confronto con widget

Per confrontare il widget del fatturato o degli acquisti con i ricavi o i costi:

* **Sottrarre dal budget** tutti i movimenti di prima nota che non sono stati generati automaticamente all'emissione della fattura
* **Verificare la corrispondenza** delle date tra fattura e competenza
* **Controllare** che non ci siano movimenti con data diversa dalla data di competenza della fattura

***

## Changelog

### 6.0 (2026-02-19)

#### Aggiunto (Added)

* Allineamento modulo a OSM 2.10
* Aggiunta generazione file per controllo integrità

#### Modificato (Changed)

* Ottimizzazione e refactoring del codice per migliorare la manutenibilità
* Miglioramenti generali all'interfaccia utente

### 5.0 (2025-07-24)

#### Modificato (Changed)

* Miglioramenti grafici generali dell'interfaccia
* Miglioramenti grafici dei grafici del budget
* Miglioramenti grafici delle tabelle del modulo Budget
* Miglioramenti grafici del modulo Sorgenti Esterne
* Miglioramenti grafici del modulo Previsionale
* Modifiche al sistema di gestione dei periodi previsionali

#### Corretto (Fixed)

* Correzione bug modulo Budget
* Correzione errore division by zero
* Correzione inizializzazione select
* Correzione gestione previsionale

### 3.1 (2024-06-13)

#### Aggiunto (Added)

* Diminuzione dei costi previsionali del budget per conto: man mano che nel mese in corso si vanno a registrare costi in un conto dove c'è una previsione, la previsione diminuirà, per evitare che il costo reale più il costo previsionale generino un costo doppio nel mese in corso

### 3.0 (2024-06-05)

#### Aggiunto (Added)

* Aggiunto php-cs-fix
* Aggiunto rector

#### Modificato (Changed)

* Ottimizzato per php8.3
* Allineato con OSM 2.5.2

### 2.0 (2024-04-16)

#### Modificato (Changed)

* Allineato per php8.1

### 1.1 (2024-01-16)

#### Aggiunto (Added)

* Aggiunto php-cs-fixer


---

# Agent Instructions: 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.openstamanager.com/2.10.4/moduli-premium/budget.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.