Cerca aziende per codice fiscale

syrto_lookup_companies_by_tax_id risolve una lista di codici fiscali o partite IVA italiane in valori company_id. Ogni codice fiscale viene verificato sia contro il numero di partita IVA UE sia contro il codice fiscale registrato.

Per cercare una singola azienda per nome o codice fiscale, usa syrto_find_company. Questo strumento è pensato per la risoluzione in batch quando si hanno già più codici fiscali.

Quando usare questo strumento

Risolvere più codici fiscali in company ID con una sola chiamata (fino a 20)
Verificare quali codici fiscali corrispondono a un’azienda nota e quali no
Ottenere il company_id richiesto dalla maggior parte degli altri strumenti Syrto partendo da identificativi fiscali

Strumenti correlati: Per la ricerca di una singola azienda per nome o codice fiscale, usa Cerca azienda.

Argomenti

string[]

obbligatorio

Lista di codici fiscali da risolvere (min 1, max 20). Ogni voce può contenere fino a 200 caratteri. Ogni codice fiscale viene confrontato sia con il numero di partita IVA UE sia con il codice fiscale registrato.Esempio: ["01654010345", "00159560366"]

string

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

Risposta

Una lista JSON nello stesso ordine delle queries in input. Ogni elemento contiene:

string

Il codice fiscale originale dalla richiesta.

string

"resolved" se è stata trovata un’azienda corrispondente, "not_found" altrimenti.

object | null

Presente quando status è "resolved". Contiene:

id - il company_id da passare a tutti gli altri strumenti Syrto
legal_name - ragione sociale ufficiale dell’azienda
eu_vat_number - numero di partita IVA UE (null se non disponibile)
taxpayer_identification_number - codice fiscale italiano (null se non disponibile)

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.

Esempio

Risolvere due codici fiscali:

{
  "queries": ["01654010345", "00000000000"]
}

Risposta:

{
  "result": [
    {
      "query": "01654010345",
      "status": "resolved",
      "company": {
        "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
        "legal_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
        "eu_vat_number": "01654010345",
        "taxpayer_identification_number": "01654010345"
      }
    },
    {
      "query": "00000000000",
      "status": "not_found",
      "company": null
    }
  ],
  "note": "Syrto data summary. More metrics, benchmarks, and insights are available at https://www.syrto.ai",
  "source_url": "https://app.syrto.ai"
}

​Quando usare questo strumento

​Argomenti

​Risposta

​Esempio

Quando usare questo strumento

Argomenti

Risposta

Esempio