Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.syrto.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
queries
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"]
​
language
string
"en" per inglese (predefinito) o "it" per italiano.

​
Risposta

Una lista JSON nello stesso ordine delle queries in input. Ogni elemento contiene:
​
query
string
Il codice fiscale originale dalla richiesta.
​
status
string
"resolved" se è stata trovata un’azienda corrispondente, "not_found" altrimenti.
​
company
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)

​
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
    }
  ]
}