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. Slug non validi non restituiscono dati senza segnalare errori.

​
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.
​
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. Vengono cercati solo i cinque esercizi depositati più recenti, quindi un anno più vecchio risulta vuoto anche se l’azienda lo ha 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.
​
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
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.
​
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.

​
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