> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Bilanci

> Elenca, visualizza in anteprima e genera bilanci compilati per un'azienda.

Tre strumenti lavorano insieme per produrre bilanci:

| Strumento                                  | Scopo                                                            |
| ------------------------------------------ | ---------------------------------------------------------------- |
| `syrto_list_financial_statement_templates` | Scopri quali formati di bilancio sono disponibili                |
| `syrto_get_financial_statement_template`   | Visualizza l'anteprima della struttura vuota di un template      |
| `syrto_generate_financial_statement`       | Genera un bilancio compilato con i valori effettivi dell'azienda |

***

## Elenca template

`syrto_list_financial_statement_templates` restituisce tutti i formati di bilancio disponibili.

### Argomenti

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

### Risposta

Una lista JSON di template, ciascuno con:

<ResponseField name="template_slug" type="string">
  Identificativo del template — passalo a `syrto_get_financial_statement_template` o `syrto_generate_financial_statement`.
</ResponseField>

<ResponseField name="display_name" type="string">
  Nome del template leggibile.
</ResponseField>

<ResponseField name="countries" type="string">
  Applicabilità per paese/regione (es. `"IT"`, `"*"`).
</ResponseField>

***

## Struttura del template

`syrto_get_financial_statement_template` restituisce la struttura a voci di un template, senza valori aziendali compilati.

### Argomenti

<ParamField query="slug" type="string" required>
  Slug del template da `syrto_list_financial_statement_templates`.
</ParamField>

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

### Risposta

<ResponseField name="result" type="string">
  Template in markdown con segnaposto `(syrto_code)` dove verranno inseriti i valori.
</ResponseField>

***

## Genera un bilancio

`syrto_generate_financial_statement` recupera i valori delle metriche dell'azienda e li inserisce nel/i template scelto/i, producendo un bilancio compilato in markdown.

### Argomenti

<ParamField query="company_id" type="string" required>
  L'ID aziendale da [`syrto_find_company`](/it/mcp/tools/find-company).
</ParamField>

<ParamField query="template_slugs" type="string[]" required>
  Uno o più slug di template (es. `["italian_income_statement"]`). Usa `syrto_list_financial_statement_templates` per scoprire gli slug disponibili. Puoi richiedere più template in una singola chiamata.
</ParamField>

<ParamField query="year" type="integer">
  Anno fiscale per cui generare il bilancio (es. `2022`). Predefinito: l'anno più recente disponibile.
</ParamField>

<ParamField query="language" type="string">
  `"en"` per inglese (predefinito) o `"it"` per italiano.
</ParamField>

### Risposta

Una lista JSON di bilanci generati, ciascuno con:

<ResponseField name="company_name" type="string">
  Ragione sociale.
</ResponseField>

<ResponseField name="year" type="integer">
  Anno fiscale del bilancio generato.
</ResponseField>

<ResponseField name="template_name" type="string">
  Titolo del template leggibile.
</ResponseField>

<ResponseField name="template_slug" type="string">
  Identificativo interno del template.
</ResponseField>

<ResponseField name="metrics_matched" type="integer">
  Numero di voci compilate con successo.
</ResponseField>

<ResponseField name="total_slots" type="integer">
  Numero totale di voci nel template.
</ResponseField>

<ResponseField name="content" type="string">
  Markdown con valori inseriti in linea come **numeri in grassetto**.
</ResponseField>

<ResponseField name="note" type="string">
  Nota contestuale sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.
</ResponseField>

### Esempio

**Genera il conto economico di Barilla per il 2022:**

```json theme={null}
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
  "template_slugs": ["italian_income_statement"],
  "year": 2022,
  "language": "en"
}
```

**Risultato:**

* Restituisce un conto economico compilato in markdown con i valori delle metriche inseriti in linea come **numeri in grassetto**
* `metrics_matched` mostra quante voci sono state compilate con successo su `total_slots`