Skip to main content
Glama

Verika - Verifica P.IVA, Codice Fiscale e IBAN

Scheda soggetto da partita IVA

scheda_soggetto
Read-onlyIdempotent

Quadro completo di un soggetto italiano a partire dalla partita IVA: controllo formale, stato su VIES con denominazione e indirizzo normalizzato (via, CAP, comune ISTAT, provincia, regione), screening sanzioni UE sulla denominazione, se il soggetto è una Pubblica Amministrazione i dati IPA (codice IPA, PEC, sito), e per le imprese con LEI i dati GLEIF: forma giuridica, stato del LEI, controllante diretta, capogruppo e numero di controllate. Ogni blocco indica la fonte e se il servizio era raggiungibile. Per un'azienda privata la scheda non include soci, cariche o bilanci (dati a pagamento del Registro Imprese).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
sanzioniNoEsegui lo screening sanzioni sulla denominazione VIES (default true)
partita_ivaYesPartita IVA italiana, 11 cifre

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
ipaYes
viesYes
gleifYesDati LEI (GLEIF); null se la P.IVA è formalmente errata
formaleYes
sanzioniYesnull se la P.IVA è formalmente errata, se VIES non dà una denominazione o se disattivato
riepilogoYesUna frase di sintesi per l'utente

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / gleif
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": {},
      +      "properties": {
      +        "capogruppo": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "denominazione": {
      +                  "type": "string"
      +                },
      +                "lei": {
      +                  "type": "string"
      +                },
      +                "paese": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "lei"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "controllante_diretta": {
      +          "anyOf": [
      +            {
      +              "additionalProperties": {},
      +              "properties": {
      +                "denominazione": {
      +                  "type": "string"
      +                },
      +                "lei": {
      +                  "type": "string"
      +                },
      +                "paese": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "lei"
      +              ],
      +              "type": "object"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "denominazione": {
      +          "type": "string"
      +        },
      +        "errore": {
      +          "type": "string"
      +        },
      +        "fonte": {
      +          "const": "GLEIF",
      +          "type": "string"
      +        },
      +        "forma_giuridica": {
      +          "type": "string"
      +        },
      +        "lei": {
      +          "type": "string"
      +        },
      +        "lei_aggiornato_al": {
      +          "type": "string"
      +        },
      +        "numero_controllate_dirette": {
      +          "type": "number"
      +        },
      +        "prossimo_rinnovo_lei": {
      +          "type": "string"
      +        },
      +        "sede_legale": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "cap": {
      +              "type": "string"
      +            },
      +            "comune": {
      +              "type": "string"
      +            },
      +            "indirizzo": {
      +              "type": "string"
      +            },
      +            "paese": {
      +              "type": "string"
      +            }
      +          },
      +          "type": "object"
      +        },
      +        "servizio_disponibile": {
      +          "type": "boolean"
      +        },
      +        "stato_entita": {
      +          "type": "string"
      +        },
      +        "stato_registrazione_lei": {
      +          "description": "ISSUED = valido; LAPSED = non rinnovato",
      +          "type": "string"
      +        },
      +        "trovato": {
      +          "description": "false se il soggetto non ha un LEI (normale per le piccole imprese)",
      +          "type": "boolean"
      +        }
      +      },
      +      "required": [
      +        "fonte",
      +        "trovato",
      +        "servizio_disponibile"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "description": "Dati LEI (GLEIF); null se la P.IVA è formalmente errata"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "formale",
      -  "vies",
      -  "ipa",
      -  "sanzioni",
      -  "riepilogo"
      -]New value: +[
      +  "formale",
      +  "vies",
      +  "ipa",
      +  "gleif",
      +  "sanzioni",
      +  "riepilogo"
      +]
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.