Vai al contenuto principale

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.

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.
Questo è il miglior punto di partenza per qualsiasi valutazione finanziaria. Ricorri a syrto_get_company_metrics solo quando hai bisogno di metriche specifiche non coperte dalle quattro categorie seguenti.

​
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. Per approfondimenti tematici, usa Grafici spider. Per il profilo qualitativo, usa Panoramica aziendale.

​
Argomenti

​
company_id
string
obbligatorio
L’ID aziendale da syrto_find_company.
​
year
integer
Anno fiscale da recuperare (es. 2022). Se omesso, restituisce l’anno più recente più l’anno precedente (controllato da include_prior_year).
​
include_prior_year
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.
​
include_market_data
boolean
Se true, ogni metrica include un campo market_value con il benchmark di settore per il confronto. Predefinito: false.
​
language
string
"en" per inglese (predefinito) o "it" per italiano.

​
Risposta

Un oggetto JSON con company_name, available_years e dati per anno. Ogni anno contiene:
​
available_years
integer[]
Tutti gli anni fiscali con dati disponibili per questa azienda.
​
year
integer
Anno fiscale.
​
size
string
Classificazione PMI UE per quell’anno (es. “Large”, “Medium”).
​
employee_count
float | null
Organico per quell’anno. null se non disponibile.
​
radar.efficiency
float | null
Punteggio efficienza (0–100): quanto bene l’azienda converte le risorse in risultati. Più alto è meglio.
​
radar.size
float | null
Punteggio dimensione (0–100): quanto è grande e stabile l’azienda rispetto al suo settore. Più alto è meglio.
​
radar.trajectory_distance / trajectory_angle
float
Movimento anno su anno nello spazio radar — grandezza e direzione del cambiamento.
​
radar.explanation
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
​
categories
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)
​
note
string
Nota di contesto sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.

​
Le quattro categorie

CategoriaCosa 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
StrutturaComposizione dell’attivo, struttura del capitale, intensità degli investimenti
I valori metrica null significano che i dati non sono disponibili. I campi slug sono identificativi interni — usa i campi name per la visualizzazione.

​
Esempio

Analisi finanziaria completa di Barilla: 
{
  "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