Cerca azienda

syrto_find_company risolve un nome aziendale o un codice fiscale italiano in un ID azienda. La maggior parte degli strumenti Syrto riceve gli ID azienda nella lista company_ids, quindi questo è tipicamente il primo passo per analizzare una specifica azienda.

Quando usare questo strumento

Cercare qualsiasi azienda italiana per nome o codice fiscale
Ottenere l’ID azienda richiesto dalla maggior parte degli altri strumenti Syrto

Argomenti

string

obbligatorio

Nome dell’azienda o codice fiscale italiano (massimo 200 caratteri). Per i nomi, passa solo la parte distintiva - rimuovi qualsiasi suffisso di forma giuridica (S.p.A., S.r.l., S.r.l.s., S.a.s., S.n.c.). Le corrispondenze parziali funzionano.Esempi:

"Barilla" (non “Barilla G. e R. Fratelli S.p.A.”)
"Ferrari"
"00159560366" (codice fiscale)

string

Codice NUTS3 per restringere per località una ricerca per nome - un codice di cinque caratteri come "ITH35". Si applica solo alle ricerche per nome; non combinarlo con una query per codice fiscale.

string

Quale bilancio risolvere. Uno tra:

Valore	Significato
`individual_only`	Il bilancio che l’azienda ha depositato per sé stessa. Predefinito.
`consolidated_only`	Il bilancio del suo gruppo - usalo quando i valori devono corrispondere al bilancio annuale pubblicato di una holding, i cui conti individuali possono essere quasi vuoti o addirittura a zero.
`both`	Un record per ogni bilancio depositato dall’azienda, ciascuno identificato dal campo `consolidated`. Usalo quando non sai quale dei due esista.

string

"en" per l’inglese (predefinito) o "it" per l’italiano.

Risposta

Una lista JSON di aziende corrispondenti. Ogni elemento contiene:

string

L’ID azienda da passare agli altri strumenti Syrto - nella lista company_ids che la maggior parte di essi riceve, oppure come focus_company_id negli strumenti radar.

string

La ragione sociale ufficiale dell’azienda.

string | null

Codice fiscale italiano. null se non disponibile.

boolean

Quale bilancio rappresenta questo record. false = i valori individuali dell’azienda (predefinito); true = i valori consolidati del suo gruppo. I conti individuali di una holding possono essere quasi vuoti: se un valore di ricavi appare implausibilmente basso rispetto a un bilancio annuale pubblicato, riprova con statement_basis: "consolidated_only".

string | null

Comune della sede registrata, es. "MILANO".

string | null

Divisione NACE principale - il livello settoriale a 2 cifre, es. "46" (commercio all’ingrosso) contro "28" (macchinari). Passala in una lista a filters.anagraphic.nace in Cerca aziende per trovare le aziende dello stesso settore.È un codice senza un nome associato, quindi identifica un settore ma non lo descrive.

string | null

Fascia dimensionale XS, S, M o L, dal deposito più recente dell’azienda.

integer | null

L’anno fiscale di quel deposito, e l’anno a cui si riferisce la fascia dimensionale. null significa che l’azienda non ha depositato nulla - gli strumenti su metriche, analisi e bilanci non avranno valori per essa.

Quando nulla corrisponde, result è una lista vuota e warning suggerisce come riprovare - non è un errore. Accanto alla lista, la risposta contiene i campi restituiti da ogni strumento. Qui display_title è la ragione sociale dell’azienda trovata, oppure un conteggio quando ne corrispondono diverse, e subtitle ripete la ricerca.

Se più aziende corrispondono, la risposta le contiene tutte - scegli quella corretta prima di passare il suo id ad altri strumenti. city, nace_division, size_classification e latest_filed_year servono a distinguere candidati quasi identici senza una chiamata per ciascuno: “quella di Milano, commercio all’ingrosso, grande” di solito ne individua una tra cinque aziende dal nome simile.

size_classification e latest_filed_year descrivono il record di bilancio, non l’azienda. Con statement_basis: "both" le due righe della stessa azienda riportano ciascuna i propri valori, e di norma differiscono: una holding è tipicamente XS sui conti propri e L su quelli del gruppo, e i due depositi possono distare anni. Non presentare mai un’azienda come se avesse due dimensioni - indica su quale base è ciascun valore, oppure leggi la riga individuale.Una sola riga con statement_basis: "both" non prova che l’azienda abbia depositato solo quel bilancio. Questa è una pagina di risultati per rilevanza, con un numero limitato di righe, quindi prova solo che su quella pagina non è comparsa una seconda riga. Dove la distinzione conta, risolvi il codice fiscale con syrto_lookup_companies_by_tax_id, che è esatto.

Esempio

Cercare un’azienda per nome:

{
  "query": "Barilla"
}

Risposta:

{
  "result": [
    {
      "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
      "legal_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
      "tax_id": "01654010345",
      "consolidated": false,
      "city": "PARMA",
      "nace_division": "10",
      "size_classification": "L",
      "latest_filed_year": 2024
    }
  ],
  "reference_url": "https://app.syrto.ai",
  "display_title": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
  "subtitle": "Search: Barilla",
  "allowance": "▕████████████████░░░░▏"
}

Per iniziare

Strumenti

Cerca azienda

Quando usare questo strumento

Argomenti

Risposta

Esempio

​Quando usare questo strumento

​Argomenti

​Risposta

​Esempio

Quando usare questo strumento

Argomenti

Risposta

Esempio