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, come ROI, ROIC o flusso di cassa operativo.

​
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’azienda, come lista che contiene esattamente un ID - sempre una lista, come in ogni strumento aziendale. Gli ID provengono da syrto_find_company o syrto_lookup_companies_by_tax_id.Questo strumento risponde per una sola azienda. Per interrogarne diverse in una chiamata, usa Confronta aziende per le metriche, Panoramica aziendale per i profili o Struttura aziendale per la proprietà.
​
integer[]
Anni fiscali da recuperare, come lista anche per un solo anno - [2023] oppure [2023, 2022]. Fino a 10 anni, ciascuno indicato una sola volta. I risultati arrivano sempre dal più recente al più vecchio, qualunque sia l’ordine in cui li elenchi. Indicare un anno restituisce quell’anno soltanto. Qualsiasi anno depositato dall’azienda è raggiungibile, per quanto vecchio; un anno mai depositato è semplicemente assente dalla risposta, e available_years elenca tutti gli anni effettivamente depositati.Mutuamente esclusivo con recent_years - passane uno o nessuno, mai entrambi.
​
integer
Quanti degli anni depositati più recenti restituire, da 1 a 10 - per esempio 3 per un trend triennale. Usalo al posto di years per una richiesta relativa, perché non richiede di sapere quali anni l’azienda ha depositato.Mutuamente esclusivo con years.
​
boolean
Se true, ogni metrica include un campo market_value con il benchmark del mercato di riferimento per il confronto. Predefinito: false.
​
string
"en" per inglese (predefinito) o "it" per italiano.
Quando sia years sia recent_years sono omessi, questo strumento restituisce i due anni depositati più recenti, così i dati più aggiornati arrivano con un anno di contesto di trend accanto.

​
Risposta

Un oggetto JSON con company_name, consolidated, available_years e dati per anno. Ogni anno contiene:
​
boolean
A quale bilancio si riferiscono questi valori. false = i conti individuali dell’azienda, true = i conti consolidati del suo gruppo. I due possono differire di ordini di grandezza: indica sempre su quale base è un valore quando qualcuno potrebbe confrontarlo con un bilancio pubblicato.
​
integer[]
Tutti gli anni fiscali con dati disponibili per questa azienda.
​
integer
Anno fiscale.
​
string
Data ISO 8601 del bilancio da cui derivano i valori. È la data del bilancio stesso - normalmente la chiusura dell’esercizio - non la data di deposito o pubblicazione. Omesso quando non risulta alcuna data.
​
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, e il suo movimento rispetto all’anno precedente. Contiene due chiavi di primo livello, efficiency e size, ciascuna un oggetto con movement e position, e ciascuno di questi contenente:
  • value - punteggio numerico
  • contributions - lista di elementi, ciascuno con contribution (un peso con segno, non un valore né una percentuale) e il fattore trainante che indica
Un contributo indica una metrica (metric_slug più metric_name) oppure una categoria (category_slug più category_name) - entrambi i tipi compaiono su entrambi gli assi. Il nome leggibile viaggia insieme allo slug, quindi ciò che ha mosso un punteggio può essere descritto a partire da questa sola risposta, senza una seconda ricerca.
​
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
    • score - intero 1-5 che valuta il valore rispetto al mercato di riferimento dell’azienda. È già normalizzato per direzione, quindi 5 è il migliore per ogni metrica, anche per quelle dove un valore grezzo più basso è preferibile - non riordinarlo mai in base a better_when. Omesso quando la metrica non ha una strategia di punteggio.
    • market_value - il benchmark del mercato di riferimento (solo quando include_market_data è true)
Il mercato di riferimento alla base sia di score sia di market_value è costituito dalle aziende della stessa classe NACE (4 cifre) e della stessa fascia dimensionale (XS/S/M/L) nello stesso anno, all’interno della stessa macro-regione NUTS 1 - su base nazionale per la fascia L. Non è una media settoriale nazionale. Nessun campo della risposta indica quale mercato sia stato usato, quindi il confronto non può essere attribuito a una regione o a un gruppo di peer specifici.
Accanto a result, la risposta contiene i campi restituiti da ogni strumento. Qui display_title è la ragione sociale dell’azienda e subtitle la sua base di bilancio e l’ultimo anno fiscale restituito, per esempio Individual statement · FY2024. warning segnala quando un anno richiesto non è stato depositato, o quando gli anni restituiti presentano un buco.

​
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 i due anni depositati più recenti per impostazione predefinita (passa recent_years: 1 per il solo anno più recente, o years per anni specifici)
  • Include tutte e quattro le categorie con le relative metriche, punteggi radar (efficienza e dimensione) e una spiegazione di cosa determina il posizionamento