Skip to main content
syrto_get_company_metrics recupera valori di metriche individuali per slug per un’azienda. Usalo quando hai bisogno di metriche specifiche non già coperte da syrto_get_company_analysis - ad esempio, singole voci di bilancio, set di metriche personalizzati o confronti precisi tra aziende.
Per un’analisi finanziaria generale, usa syrto_get_company_analysis - restituisce tutte e quattro le categorie Syrto più i punteggi radar in un’unica chiamata, senza bisogno di cercare gli slug.Per trovare gli slug delle metriche, usa syrto_list_available_metrics o syrto_search_metric_definitions.

​
Quando usare questo strumento

  • Recuperare metriche specifiche non coperte dalle quattro categorie Syrto (es. voci grezze di bilancio, indici di nicchia)
  • Confrontare aziende su un set di metriche personalizzato
  • Ottenere valori di metriche per anni fiscali specifici, o per una serie di anni recenti

​
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à.
​
string[]
Lista di slug delle metriche da recuperare (es. ["total_assets", "net_financial_position"]). Se omesso, restituisce tutte le metriche disponibili. Usa syrto_list_available_metrics per scoprire gli slug.
​
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. 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, viene restituito l’anno depositato più recente.
metric_slugs è obbligatorio a meno che tu non indichi anche gli anni, con years oppure recent_years - omettendo tutti e tre si otterrebbero tutte le metriche su tutti gli anni depositati, superando i limiti di risposta.

​
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.
​
float | null
Organico per quell’anno.
​
object[]
Lista di oggetti metrica, ciascuno con:
  • name - nome della metrica leggibile
  • slug - identificativo interno (usa name per la visualizzazione)
  • 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.
​
float | null
Punteggio efficienza (0–100): quanto bene l’azienda converte le risorse in risultati.
​
float | null
Punteggio dimensione (0–100): quanto è grande e stabile l’azienda rispetto al suo settore.
​
float
Movimento anno su anno nello spazio radar.
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 indica ogni slug richiesto che non ha restituito dati, e il motivo: uno slug che non corrisponde a una metrica nota (cerca quello giusto) è segnalato separatamente da una metrica nota che non ha valori in nessun anno depositato, per la quale cercare non serve. Segnala anche quando un anno richiesto non è stato depositato, o quando gli anni restituiti presentano un buco.

​
Esempio

Ottenere metriche specifiche di bilancio per Barilla:
Risultato:
  • Restituisce solo le metriche richieste per l’anno depositato più recente per impostazione predefinita
  • Usa recent_years per i trend, o years per periodi specifici
  • Usa syrto_list_available_metrics per scoprire gli slug disponibili