syrto_get_spider_data restituisce punteggi di performance su N assi tematici per template - un asse è una categoria finanziaria, un template un gruppo di categorie affini. Ogni asse ha un valore normalizzato da 0 a 5.
Come leggere il valore di un asse
Il valore di ogni asse è relativo, non assoluto. È la media dei giudizi da 1 a 5 delle metriche sottostanti rispetto al mercato di riferimento dell’azienda: le 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, e nessun campo della risposta indica quale mercato sia stato usato. Quindi 3 corrisponde per costruzione all’incirca alla mediana dei peer locali. Sotto 3 significa performare peggio di quei peer, sopra 3 meglio - il valore di un asse non è un giudizio di qualità a sé stante. I nomi dei template e degli assi sono contenuti di piattaforma e cambiano senza che il server cambi. Un’azienda ha tipicamente più template, che coprono nel loro insieme redditività, generazione di cassa, impiego degli asset e stile di gestione, ma come si chiami ciascuno di essi è conoscibile solo daldisplay_name nella risposta.
Radar vs. spider
I grafici spider sono distinti dal grafico radar:Quando usare questo strumento
- Ottenere una scomposizione finanziaria tematica su assi come redditività operativa, autonomia o flusso di cassa
- Confrontare le performance su temi finanziari
- Approfondire aree specifiche dopo un’Analisi aziendale generale
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; 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 asse dell’anno più recente restituito riporta anche la sua description e le sue composing_metrics - le metriche di cui l’asse fa la media dei punteggi 1-5. Usalo per spiegare perché un asse ha un punteggio alto o basso. Il dettaglio è identico ogni anno, quindi viene dato una sola volta, su quell’anno. 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 punteggi più aggiornati arrivano con un anno di contesto di trend accanto.Risposta
Un oggetto JSON concompany_name, consolidated, available_years e dati spider per anno. Ogni anno contiene una lista di template spider:
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 con dati spider per questa azienda.
string
Nome del template leggibile (usa questo per la visualizzazione, non
template_slug).string
Identificativo interno del template.
object[]
Lista di assi, ciascuno con:
display_name- nome dell’asse leggibiletemplate_slug- identificativo interno dell’assecurrent_value.value- punteggio da 0 a 5, relativo al mercato di riferimento dell’azienda (vedi sopra)
include_axis_details, ogni asse dell’anno più recente restituito contiene anche:description- che cosa misura l’asse (nullquando non ne è registrata una)composing_metrics- le metriche di cui l’asse fa la media dei punteggi 1-5, ciascuna con unnameleggibile e unoslugda passare a Metriche aziendali. È la composizione dell’asse, non una ponderazione né una causa - recupera quelle metriche per spiegare un punteggio.
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. warning segnala quando un anno richiesto non è stato depositato, o è stato depositato senza punteggi spider.
Esempio
Scomposizione spider per Barilla:"include_axis_details": true.
Risposta (abbreviata):