> ## 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.

# Analisi aziendale

> Ottieni un'analisi finanziaria completa per categoria — redditività, liquidità, solvibilità e struttura — con punteggi radar in un'unica chiamata.

`syrto_get_company_analysis` è lo strumento principale per l'analisi finanziaria. Restituisce tutte le metriche che compongono i punteggi radar di Syrto, pre-raggruppate in quattro categorie, più il posizionamento radar e le spiegazioni — in un'unica chiamata.

<Tip>
  Questo è il miglior punto di partenza per qualsiasi valutazione finanziaria. Ricorri a [`syrto_get_company_metrics`](/it/mcp/tools/company-metrics) solo quando hai bisogno di metriche specifiche non coperte dalle quattro categorie seguenti.
</Tip>

## Quando usare questo strumento

* Ottenere una valutazione finanziaria completa su redditività, liquidità, solvibilità e struttura
* Vedere i punteggi radar (efficienza e dimensione) insieme alle metriche che li determinano
* Confrontare le performance anno su anno

**Strumenti correlati:** Per metriche specifiche fuori dalle quattro categorie, usa [Metriche aziendali](/it/mcp/tools/company-metrics). Per approfondimenti tematici, usa [Grafici spider](/it/mcp/tools/spider-graphs). Per il profilo qualitativo, usa [Panoramica aziendale](/it/mcp/tools/company-overview).

## Argomenti

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

<ParamField query="year" type="integer">
  Anno fiscale da recuperare (es. `2022`). Se omesso, restituisce l'anno più recente più l'anno precedente (controllato da `include_prior_year`).
</ParamField>

<ParamField query="include_prior_year" type="boolean">
  Se `true` (predefinito), restituisce l'anno più recente più l'anno precedente per contesto di trend. Se `false`, restituisce solo l'anno più recente. Ignorato quando `year` è fornito.
</ParamField>

<ParamField query="include_market_data" type="boolean">
  Se `true`, ogni metrica include un campo `market_value` con il benchmark di settore per il confronto. Predefinito: `false`.
</ParamField>

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

## Risposta

Un oggetto JSON con `company_name`, `available_years` e dati per anno. Ogni anno contiene:

<ResponseField name="available_years" type="integer[]">
  Tutti gli anni fiscali con dati disponibili per questa azienda.
</ResponseField>

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

<ResponseField name="size" type="string">
  Classificazione PMI UE per quell'anno (es. "Large", "Medium").
</ResponseField>

<ResponseField name="employee_count" type="float | null">
  Organico per quell'anno. `null` se non disponibile.
</ResponseField>

<ResponseField name="radar.efficiency" type="float | null">
  Punteggio efficienza (0–100): quanto bene l'azienda converte le risorse in risultati. Più alto è meglio.
</ResponseField>

<ResponseField name="radar.size" type="float | null">
  Punteggio dimensione (0–100): quanto è grande e stabile l'azienda rispetto al suo settore. Più alto è meglio.
</ResponseField>

<ResponseField name="radar.trajectory_distance / trajectory_angle" type="float">
  Movimento anno su anno nello spazio radar — grandezza e direzione del cambiamento.
</ResponseField>

<ResponseField name="radar.explanation" type="object | null">
  Spiegazione strutturata di cosa determina il posizionamento in efficienza e dimensione. Contiene due chiavi di primo livello:

  * `efficiency` — oggetto con `movement` e `position`, ciascuno contenente:
    * `value` — punteggio numerico
    * `contributions` — lista di elementi, ciascuno con `contribution` (float) e `category_slug` che identifica il fattore trainante
  * `size` — stessa struttura di `efficiency`, ma le contributions usano `metric_slug` invece di `category_slug`
</ResponseField>

<ResponseField name="categories" type="object[]">
  Le quattro categorie finanziarie Syrto, ciascuna con:

  * `name` — nome della categoria leggibile
  * `slug` — identificativo interno della categoria (es. `"profitability"`, `"liquidity"`)
  * `metrics` — lista di oggetti metrica, ciascuno con:
    * `name` — nome della metrica leggibile
    * `slug` — identificativo interno della metrica
    * `value` — valore numerico (o `null` se non disponibile)
    * `better_when` — oggetto `{"when_type": "HIGHER"}`, `{"when_type": "LOWER"}`, `{"when_type": "NEAR_TARGET"}`, o `null`
    * `market_value` — benchmark di settore (solo quando `include_market_data` è `true`)
</ResponseField>

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

### Le quattro categorie

| Categoria       | Cosa copre                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------ |
| **Redditività** | Margini (EBITDA, EBIT), rendimenti (ROE, ROA), crescita dei ricavi                         |
| **Liquidità**   | Capitale circolante, ciclo di conversione del contante, buffer a breve termine             |
| **Solvibilità** | Livello di indebitamento, indici di copertura, leva finanziaria, sostenibilità finanziaria |
| **Struttura**   | Composizione dell'attivo, struttura del capitale, intensità degli investimenti             |

<Note>
  I valori metrica `null` significano che i dati non sono disponibili. I campi `slug` sono identificativi interni — usa i campi `name` per la visualizzazione.
</Note>

## Esempio

**Analisi finanziaria completa di Barilla:**

```json theme={null}
{
  "company_id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox"
}
```

**Risultato:**

* Restituisce l'anno più recente più l'anno precedente per impostazione predefinita (imposta `include_prior_year` a `false` per solo l'ultimo anno)
* Include tutte e quattro le categorie con le relative metriche, punteggi radar (efficienza e dimensione) e una spiegazione di cosa determina il posizionamento