Skip to main content
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

​
string
obbligatorio
L’ID aziendale da syrto_find_company.
​
integer
Anno fiscale da recuperare (es. 2022). Se omesso, restituisce l’anno più recente più l’anno precedente (controllato da 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.
​
boolean
Se true, ogni metrica include un campo market_value con il benchmark di settore per il confronto. Predefinito: false.
​
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:
​
integer[]
Tutti gli anni fiscali con dati disponibili per questa azienda.
​
integer
Anno fiscale.
​
string
Classificazione PMI UE per quell’anno (es. “Large”, “Medium”).
​
float | null
Organico per quell’anno. null se non disponibile.
​
float | null
Punteggio efficienza (0–100): quanto bene l’azienda converte le risorse in risultati. Più alto è meglio.
​
float | null
Punteggio dimensione (0–100): quanto è grande e stabile l’azienda rispetto al suo settore. Più alto è meglio.
​
float
Movimento anno su anno nello spazio radar - grandezza e direzione del cambiamento.
​
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
​
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)
​
string
Nota di contesto sulla disponibilità dei dati e dove trovare maggiori informazioni su syrto.ai.
​
string
Link all’app web di Syrto, dove puoi esplorare più dati e approfondimenti.

​
Le quattro categorie

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:
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