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.
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
Argomenti
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"]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.Risposta
Una lista JSON nello stesso ordine deitax_ids in input - tranne con statement_basis: "both", dove un codice fiscale che deposita entrambi i bilanci ottiene due voci. Ogni elemento contiene:
La voce della tua lista
tax_ids a cui risponde questo elemento, esattamente come l’hai inviata.Presente quando
status è "resolved", omesso altrimenti. Contiene:id- l’ID azienda da passare agli altri strumenti Syrto nella loro listacompany_idslegal_name- ragione sociale ufficiale dell’aziendaeu_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
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.