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.
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
Argomenti
Lista di ID aziendali da
syrto_find_company o syrto_lookup_companies_by_tax_id. Minimo 2, massimo 20.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.Risposta
Un oggetto JSON con risultati per azienda e una lista di eventuali ID aziendali non riconosciuti.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.Un elemento per anno fiscale. Ciascuno contiene:
year- anno fiscalefinancial_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 UEemployee_count- organico (nullse non disponibile)metrics- lista di oggetti metrica
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.Un elemento per ogni slug di metrica richiesto, ciascuno con:
name- nome della metrica leggibileslug- identificativo internovalue- valore numerico (onullse non disponibile)better_when- oggetto conwhen_type:"HIGHER","LOWER","NEAR_TARGET", onullscore- intero 1-5 (onull) 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.
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.
Presente ogni volta che il confronto è risultato incompleto. Conta gli ID senza overview e nomina le aziende interessate dalle altre due lacune.
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:- Restituisce ogni azienda con le metriche richieste per l’anno specificato
- Controlla
missing_company_idsper verificare che tutte le aziende richieste siano state trovate