Skip to main content
syrto_compare_companies recupera le stesse metriche per più aziende in un’unica chiamata, restituendo i risultati affiancati. È significativamente più veloce rispetto a chiamare syrto_get_company_metrics una volta per azienda.
Gli slug delle metriche devono provenire da syrto_list_available_metrics o syrto_search_metric_definitions. Uno slug che non restituisce dati per nessuna azienda è indicato in warning, che specifica se non è una metrica nota oppure è una metrica nota senza valore per quell’anno.

​
Quando usare questo strumento

  • Confrontare specifici KPI finanziari tra 2 o più aziende affiancate
  • Verificare quale azienda ha le migliori prestazioni su una data metrica (es. ROE, EBITDA)
  • Ottenere trend di metriche anno su anno per più aziende contemporaneamente
Strumenti correlati: Per metriche di una singola azienda, usa Metriche aziendali. Per statistiche a livello di settore, usa Aggrega aziende. Per trovare gli ID aziendali, usa Cerca azienda o Cerca aziende per codice fiscale per la risoluzione in batch.

​
Argomenti

​
string[]
obbligatorio
Lista di ID aziendali da syrto_find_company o syrto_lookup_companies_by_tax_id. Minimo 2, massimo 20.
​
string[]
obbligatorio
Slug delle metriche da confrontare (min 1, max 10). Esempi: ["ebitda", "roe", "net_financial_position"]. Usa syrto_search_metric_definitions o syrto_list_available_metrics per trovare slug validi.Sono supportati anche gli slug di posizionamento radar radar_efficiency e radar_size, che tornano sulla stessa scala 0-100 di ogni altro strumento radar.
​
integer
obbligatorio
Anno fiscale per il confronto (es. 2023).
​
string
"en" per inglese (predefinito) o "it" per italiano.

​
Risposta

Un oggetto JSON con risultati per azienda e una lista di eventuali ID aziendali non riconosciuti.
​
object[]
Un elemento per ogni azienda richiesta (nello stesso ordine di company_ids), ciascuno con company_id, legal_name, consolidated e un array years.consolidated è false per i conti individuali dell’azienda e true per quelli consolidati del suo gruppo. Un confronto può mescolare i due: verificalo prima di considerare reale uno scarto tra aziende.
​
object[]
Un elemento per anno fiscale. Ciascuno contiene:
  • year - anno fiscale
  • financial_statement_date - data ISO 8601 del bilancio da cui provengono i valori (la data del bilancio stesso, normalmente la chiusura dell’esercizio, non la data di deposito). Omesso quando non risulta.
  • size - classificazione PMI UE
  • employee_count - organico (null se non disponibile)
  • metrics - lista di oggetti metrica
Un array years vuoto significa che l’azienda ha restituito un overview ma non ha dati per l’anno richiesto. warning indica gli anni che quell’azienda ha effettivamente depositato.
​
object[]
Un elemento per ogni slug di metrica richiesto, ciascuno con:
  • name - nome della metrica leggibile
  • slug - identificativo interno
  • value - valore numerico (o null se non disponibile)
  • better_when - oggetto con when_type: "HIGHER", "LOWER", "NEAR_TARGET", o null
  • score - intero 1-5 (o null) che valuta il valore rispetto al mercato di riferimento di quella azienda, già normalizzato per direzione: 5 è sempre il migliore. È il campo da confrontare tra aziende di settori diversi - i valori grezzi non sono comparabili in quel modo. Assente per le metriche senza strategia di punteggio.
Una metrica assente dalla lista di un anno significa che quella azienda non ha un valore per essa.
Il mercato di riferimento di ciascuna azienda è il suo: le aziende della stessa classe NACE (4 cifre) e della stessa fascia dimensionale (XS/S/M/L) nello stesso anno, all’interno della macro-regione NUTS 1 di quella stessa azienda - su base nazionale per la fascia L.Quindi due aziende dello stesso settore ma di macro-regioni diverse, o di fasce dimensionali diverse, sono valutate rispetto a gruppi di peer differenti. Segnalalo quando la differenza di punteggio è il risultato rilevante. Nessun campo della risposta indica quale sia l’uno o l’altro mercato.
​
string[]
ID aziendali per i quali l’API non ha restituito alcun overview finanziario. È tutto ciò che questo stabilisce - l’azienda potrebbe comunque esistere. Gli ID non validi o malformati generano invece un errore.
​
string | null
Presente ogni volta che il confronto è risultato incompleto. Conta gli ID senza overview e nomina le aziende interessate dalle altre due lacune.
Un confronto può essere incompleto in tre modi diversi, e missing_company_ids copre solo il primo:Quindi un missing_company_ids vuoto non significa che ogni cella sia popolata. warning è l’unico campo che segnala tutti e tre - leggilo prima di presentare la tabella.
Accanto a result, la risposta contiene i campi restituiti da ogni strumento. Qui display_title conta le aziende confrontate - oppure indica la ragione sociale quando ne è tornata una sola - e subtitle indica quanti ID non hanno restituito un overview.

​
Esempio

Confrontare EBITDA e ROE per due aziende:
Risultato:
  • Restituisce ogni azienda con le metriche richieste per l’anno specificato
  • Controlla missing_company_ids per verificare che tutte le aziende richieste siano state trovate