Cerca aziende per codice fiscale

syrto_lookup_companies_by_tax_id risolve una lista di codici fiscali o partite IVA italiane in ID azienda. 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 gli ID azienda richiesti 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

A quale bilancio risolve ogni codice fiscale. individual_only (predefinito) è il bilancio depositato dall’azienda per sé stessa, consolidated_only quello del suo gruppo, e both restituisce una voce per ogni bilancio depositato. Con both, un codice fiscale che deposita entrambi i bilanci ottiene due voci, distinte da company.consolidated.

string

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

Risposta

Una lista JSON nello stesso ordine dei tax_ids in input - tranne con statement_basis: "both", dove un codice fiscale che deposita entrambi i bilanci ottiene due voci. Ogni elemento contiene:

string

La voce della tua lista tax_ids a cui risponde questo elemento, esattamente come l’hai inviata.

string

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

object

Presente quando status è "resolved", omesso altrimenti. Contiene:

id - l’ID azienda da passare agli altri strumenti Syrto nella loro lista company_ids
legal_name - ragione sociale ufficiale dell’azienda
eu_vat_number - numero di partita IVA UE (omesso se non disponibile)
taxpayer_identification_number - codice fiscale italiano (omesso se non disponibile)
consolidated - false = i valori individuali dell’azienda, true = i valori consolidati del suo gruppo

Con statement_basis: "consolidated_only", warning è presente quando alcuni codici fiscali non sono stati risolti: la maggior parte delle aziende italiane deposita solo il bilancio individuale, quindi vale la pena riprovarli con la base predefinita. Accanto alla lista, la risposta contiene i campi restituiti da ogni strumento. Qui display_title è la ragione sociale dell’azienda risolta, oppure un conteggio quando ne sono state risolte diverse, e subtitle indica quanti codici fiscali non sono stati trovati.

Esempio

Risolvere due codici fiscali:

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

Risposta:

{
  "result": [
    {
      "tax_id": "01654010345",
      "status": "resolved",
      "company": {
        "id": "Zm86SVRfMDE2NTQwMTAzNDVfVTox",
        "legal_name": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
        "eu_vat_number": "01654010345",
        "taxpayer_identification_number": "01654010345",
        "consolidated": false
      }
    },
    {
      "tax_id": "00000000000",
      "status": "not_found"
    }
  ],
  "reference_url": "https://app.syrto.ai",
  "display_title": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
  "subtitle": "1 id not found",
  "allowance": "▕████████████████░░░░▏"
}

​Quando usare questo strumento

​Argomenti

​Risposta

​Esempio

Quando usare questo strumento

Argomenti

Risposta

Esempio