Imperio — Italian Tax & Compliance Tools

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Italian tax + anti-fraud: CF, P.IVA, IBAN, ATECO, IMU, F24, FatturaPA, NIS2. 23 free + 5 with key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Imperio — Italian Tax & Compliance Tools": {
      "url": "https://imperioutils.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (28)

• validate_codice_fiscale read-only

  Valida un Codice Fiscale italiano (formato + carattere di controllo, con gestione omocodia). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • codice_fiscale (required) — string — Il Codice Fiscale da validare (es. RSSMRA85T10A562S).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• generate_codice_fiscale read-only

  Genera un Codice Fiscale italiano da dati anagrafici (cognome, nome, data di nascita, sesso, e comune/stato estero di nascita — oppure direttamente il codice Belfiore). Restituisce il CF "base" (la variante omocodica in caso di collisione è assegnata dall'Agenzia). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • cognome (required) — string — Cognome.
  • nome (required) — string — Nome.
  • data_nascita (required) — string — Data di nascita in formato GG/MM/AAAA (es. 10/12/1985).
  • sesso (required) — string — Sesso: M o F.
  • comune — string — Comune (o stato estero) di nascita. In alternativa usa codice_belfiore.
  • provincia — string — Sigla provincia (es. PI) per disambiguare comuni omonimi.
  • codice_belfiore — string — Codice catastale/Belfiore del luogo di nascita (alternativa precisa al comune).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• validate_partita_iva read-only

  Valida una Partita IVA italiana (11 cifre + checksum Luhn). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • partita_iva (required) — string — La Partita IVA da validare (11 cifre, es. 12345678903).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• validate_iban read-only

  Valida un IBAN (checksum MOD-97) e, per gli IBAN italiani, identifica la banca dal codice ABI. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • iban (required) — string — L'IBAN da validare (es. IT60X0542811101000000123456).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lookup_cap read-only

  Restituisce la provincia del PREFISSO di 2 cifre di un CAP italiano. NON restituisce il comune (il campo `comune` è sempre null: non abbiamo un elenco CAP→comune) e per 14 province — elencate nella risposta in `province_non_rappresentate`, fra cui Lecco, Monza-Brianza, Rimini e Biella — la provincia resa è SBAGLIATA con certezza. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • cap (required) — string — Il CAP a 5 cifre (es. 20121).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• validate_pec read-only

  Valida un indirizzo PEC italiano: formato + dominio confrontato con l'elenco dei provider certificati AGID (Aruba, InfoCert, Namirial, Poste, ecc.). `is_pec_domain` ha TRE valori: true (nell'elenco AGID), false (non risulta PEC), null (il dominio contiene 'pec' ma NON è stato verificato — non è la stessa cosa di false). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • email (required) — string — L'indirizzo PEC da validare (es. [email protected]).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• lookup_ateco read-only

  Cerca e valida un codice ATECO 2007 ISTAT e restituisce la descrizione dell'attività. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • code (required) — string — Il codice ATECO (solo cifre e punti, es. 62.01).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_ateco read-only

  Ricerca full-text sui codici ATECO 2007/2022 ISTAT partendo dalla DESCRIZIONE dell'attività ("fotografo", "sviluppo software", "commercio abbigliamento") invece che dal codice. Case/accent-insensitive, con stemming e alias colloquiali per-mestiere; accetta anche un prefisso di codice. Usa questo quando il codice NON è noto — `lookup_ateco` serve al caso opposto (codice noto → descrizione). Risultati ordinati per pertinenza. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • q (required) — string — Attività da cercare, in italiano (es. 'fotografo', 'idraulico', 'consulenza informatica').
  • limit — integer — Numero massimo di risultati (default 20).
  • section — string — Filtra per sezione ATECO (lettera A–U, es. J = servizi di informazione e comunicazione, M = attività professionali). Opzionale.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• calc_forfettario read-only

  Calcola imposta sostitutiva e contributi INPS del regime forfettario italiano dal fatturato e (opzionale) codice ATECO. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • ricavi (required) — number — Ricavi/compensi annui in euro.
  • ateco — string — Codice ATECO da cui derivare il coefficiente di redditività. ALTERNATIVO a `coefficiente`: uno dei due è obbligatorio (senza, il calcolo non ha coefficiente e il tool risponde «Fornire 'ateco' oppure 'coefficiente'»).
  • startup — boolean — Aliquota agevolata 5% per le nuove attività: vale per l'anno di inizio e per i quattro successivi (default false → 15%). Non cambia gli acconti: nel primo anno di attività non sono dovuti, e le note della risposta lo dicono.
  • coefficiente — integer — Coefficiente di redditività in % (override manuale). ALTERNATIVO ad `ateco`: uno dei due è obbligatorio.
  • riduzione_35 — boolean — Riduzione contributiva INPS del 35% (artigiani/commercianti).
  • gestione_inps — string — Gestione previdenziale INPS/cassa (opzionale).
  • contributi_cassa_privata — integer — Contributi cassa privata già versati, in euro (opzionale).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parse_fatturapa read-only

  Estrae dati strutturati (cedente, cessionario, righe, imposte) da un XML FatturaPA/SDI. Solo parsing deterministico — nessuna verifica VIES. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • xml_content (required) — string — Il contenuto XML della fattura elettronica (FatturaPA/SDI).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• parse_verify_fatturapa read-only

  Estrae i dati strutturati da un XML FatturaPA/SDI E, nella stessa chiamata, verifica anti-frode la parte indicata (default: il CEDENTE, cioè il fornitore che incassa il bonifico). I dati verificati NON sono inferiti da un LLM: P.IVA, Codice Fiscale, ragione sociale e IBAN di pagamento sono estratti deterministicamente dall'XML, poi passati ai controlli: IBAN (checksum MOD-97 + banca dal codice ABI), P.IVA e CF (checksum) e — quando il servizio UE è raggiungibile — la ragione sociale reale via VIES live, confrontata con quella dichiarata in fattura. Restituisce il parse completo più `supplier_verification` con verdetto (ok / non_verificabile / attenzione / alto_rischio) e red flag puntuali; se la fattura riporta più IBAN distinti lo segnala e abbassa il verdetto. È la difesa contro la truffa del cambio-IBAN sulle fatture passive. Come `verify_payee` fa I/O esterno (una sola interrogazione VIES per chiamata, non una per riga): se VIES è giù o il budget condiviso è esaurito il verdetto degrada ONESTAMENTE ad "attenzione", mai a un falso "ok". Gratis (€0), nessun login. NON sostituisce la verifica out-of-band (telefonata al fornitore su un numero già noto).

  Parameters:

  • xml_content (required) — string — Il contenuto XML della fattura elettronica (FatturaPA/SDI). Il .p7m va scompattato prima: qui si accetta XML testuale.
  • party — string — Parte da verificare: 'cedente' = fornitore/chi riceve il pagamento (default, il caso anti-frode); 'cessionario' = cliente. L'IBAN viene raccolto solo per il cedente, perché è lui che incassa.
  • expected_country — string — Paese atteso del fornitore in ISO2. Se omesso vale il paese dichiarato dalla fattura stessa (sede del cedente), e solo in sua mancanza 'IT'. Un IBAN estero su un fornitore atteso italiano è il campanello #1 della frode.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• calc_iva read-only

  Calcola l'IVA italiana su un imponibile (aliquote 22/10/5/4/0/esente/fuori campo), con ritenuta d'acconto opzionale (autonomi 20%, agenti 11,5%), e decide la TERRITORIALITÀ delle operazioni con l'estero: beni o servizi, impresa o privato, UE o extra-UE → imponibile in Italia, non imponibile, non soggetta o IVA del paese di destinazione (aliquota ordinaria ufficiale TEDB dei 27 Stati), con Natura FatturaPA, annotazione in fattura e norma. Soglia UE di 10.000 € non dichiarata → due scenari calcolati, mai un numero scelto al posto tuo. Le norme citate seguono la data dell'operazione: DPR 633/72 fino al 31/12/2026, Testo unico IVA dal 1/1/2027. Gestisce le DUE basi imponibili della fattura di un professionista (contributo integrativo cassa solo nella base IVA, rivalsa INPS in entrambe). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • imponibile (required) — number — Compenso/corrispettivo in EUR (es. 1000), AL NETTO del contributo integrativo cassa e della rivalsa INPS: quelli si aggiungono con i due campi dedicati.
  • oggetto — string — Per intraUE/extraUE. Cambia il regime: cessione di beni intraUE B2B = non imponibile (N3.2, «operazione non imponibile»); servizi B2B = non soggetti (N2.1, «inversione contabile»). Obbligatorio verso un privato UE.
  • aliquota_iva — string — Aliquota IVA (default 22).
  • con_ritenuta — boolean — Applica la ritenuta d'acconto (default false).
  • tipo_ritenuta — string — Tipo ritenuta se con_ritenuta=true (autonomo 20% | agente 11,5%).
  • tipo_servizio — string — Per oggetto='servizi'. generico = regola generale (default assunto, e dichiarato); elettronico = telecomunicazione, teleradiodiffusione, servizi elettronici; speciale = immobili, trasporti, ristorazione, eventi, noleggio mezzi, intermediazione, lavorazioni su beni mobili — il tool NON calcola il luogo e lo dice, con le norme.
  • data_operazione — string — AAAA-MM-GG, default oggi. Decide la norma citata: DPR 633/72 e DL 331/93 fino al 31/12/2026, Testo unico IVA (D.Lgs. 10/2026) dal 1/1/2027.
  • tipo_operazione — string — Tipo operazione (default b2b). intraUE ESIGE `cessionario_soggetto_iva`; verso un privato UE esige anche `oggetto`. extraUE senza `oggetto` è trattata come esportazione di beni (lo dichiara nei `presupposti`); per i servizi dichiara `oggetto` e `cessionario_soggetto_iva`: verso un privato extra-UE l'IVA di regola è italiana.
  • rivalsa_inps_pct — number — Aliquota % della rivalsa INPS gestione separata addebitata in fattura (default 0). Per legge 4 (art. 1 c. 212 L. 662/1996). Entra in ENTRAMBE le basi.
  • paese_destinazione — string — ISO2 del paese del cliente ('EL' Grecia; 'XI' Irlanda del Nord = UE per i soli beni). Serve all'aliquota di destinazione sopra soglia.
  • servizio_7_septies — boolean — Servizi a privato extra-UE: true se il servizio è fra quelli dell'art. 7-septies (consulenza, pubblicità, dati, finanziari, personale, noleggio beni mobili…): non soggetto.
  • soglia_ue_superata — boolean — Beni a distanza e servizi elettronici a privati UE: true se vendite a distanza + servizi TTE a privati UE hanno superato 10.000 € (anno precedente o in corso) OPPURE se hai optato per l'IVA di destinazione. Se non la dichiari ricevi DUE scenari calcolati e `iva_importo: null`.
  • vendita_a_distanza — boolean — Beni a privato UE: true se il trasporto è a cura del cedente o per suo conto (default assunto true, e dichiarato). false = il cliente trasporta da sé → IVA italiana.
  • cessionario_soggetto_iva — boolean — OBBLIGATORIO per tipo_operazione='intraUE' (e per extraUE con oggetto='servizi'). true = soggetto passivo con P.IVA valida al VIES: beni non imponibili (N3.2), servizi non soggetti (N2.1). false = consumatore privato: l'IVA è italiana o del paese di destinazione a seconda di `oggetto`, `vendita_a_distanza`, `soglia_ue_superata` e `tipo_servizio`.
  • aliquota_destinazione_pct — number — Aliquota del paese di destinazione, se il bene vi ha un'aliquota RIDOTTA. Senza, si usa l'ordinaria ufficiale (TEDB) e la risposta lo dichiara.
  • contributo_integrativo_pct — number — Aliquota % del contributo integrativo della cassa professionale (default 0 = nessuna cassa). Tipicamente 4; 5 per i geometri; 2 per ENPAP/ENPAV — leggila dal regolamento della cassa: il tool non la deduce da ATECO. Entra nella base IVA ma NON in quella della ritenuta.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• calc_reverse_charge read-only

  Calcola l'IVA che il CESSIONARIO deve autoliquidare in regime di inversione contabile e restituisce gli obblighi delle due parti con la norma applicabile. Distingue i tre casi che si confondono più spesso: reverse charge INTRACOMUNITARIO (cedente UE non-IT — art. 46 DL 331/93 per i beni, art. 17 c. 2 DPR 633/72 per i servizi), reverse charge INTERNO (cedente italiano — art. 17 c. 6, che NON è generalizzato: vale solo in settori tassativi come subappalti edili, rottami, pulizia edifici, elettronica) e paese non-UE (errore esplicito, non un ramo implicito). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • imponibile (required) — number — Imponibile della fattura in EUR.
  • paese_cedente (required) — string — Codice ISO2 del paese del CEDENTE: uno Stato membro UE (es. DE, FR, ES; 'EL' o 'GR' per la Grecia; 'XI' per l'Irlanda del Nord) per il reverse charge intracomunitario, oppure 'IT' per quello interno.
  • aliquota_iva — string — Aliquota IVA da autoliquidare (default 22).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• calc_split_payment read-only

  Calcola la scissione dei pagamenti per le forniture alla Pubblica Amministrazione (art. 17-ter DPR 633/72): il fornitore fattura imponibile + IVA ma incassa dalla PA il SOLO imponibile, mentre l'IVA la versa la PA direttamente all'Erario. Restituisce i due importi separati, l'impatto di liquidità per il fornitore e le istruzioni FatturaPA (EsigibilitaIVA=S; NON si usano i codici Natura N6, che sono solo del reverse charge). Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • imponibile (required) — number — Imponibile della fornitura alla PA in EUR.
  • aliquota_iva — string — Aliquota IVA esposta in fattura (default 22).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• calc_imu read-only

  Calcola l'IMU italiana (L.160/2019) per fabbricati (da rendita catastale + categoria), terreni agricoli (da reddito dominicale) e aree edificabili (da valore venale), con acconto/saldo. L'aliquota (‰) è quella deliberata dal Comune: indicala (`aliquota_permille`) OPPURE indica il `comune` (codice catastale o nome) e il server usa l'aliquota del suo prospetto pubblicato dal MEF, con lo stato di legge (prospetto dell'anno · anno precedente, L.160/2019 c.767 · aliquote di base) e la fonte in `aliquota_comune`. Se il prospetto non è ancora stato letto, o il comune non ha l'IMU (Trento, Bolzano, Friuli Venezia Giulia), risponde `calcolato: false` con la spiegazione, senza importo. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • anno — integer — Anno d'imposta del verdetto per comune (default l'anno in corso). Solo con `comune`.
  • comune — string — Codice catastale (es. B519) o nome del comune. L'aliquota diventa quella del suo prospetto IMU pubblicato dal MEF per l'anno (o, per legge, quella dell'anno precedente o di base).
  • ex_comune — string — Solo comuni fusi con aliquote differenziate: l'ex comune dove sta l'immobile. Se serve e manca, la risposta elenca quelli possibili.
  • provincia — string — Sigla della provincia, per i comuni omonimi (es. TO). Solo con `comune`.
  • detrazione — number — Detrazione in euro (solo fabbricati; es. 200 per abitazione principale di lusso).
  • mesi_possesso — integer — Mesi di possesso nell'anno (default 12).
  • tipo_immobile — string — Tipo immobile → seleziona la formula (default abitazione_non_principale).
  • valore_venale — number — Aree edificabili: valore venale in comune commercio al 1° gennaio (€). OBBLIGATORIO con `tipo_immobile: area_edificabile`.
  • aliquota_permille — number — Aliquota deliberata dal Comune, in per mille (es. 8.6 per 8,6‰). OBBLIGATORIA se non indichi `comune`; con tutti e due vince questa, e la risposta dice se differisce dal prospetto.
  • rendita_catastale — number — Fabbricati: rendita catastale annua in euro (da visura). OBBLIGATORIA per tutti i tipi diversi da `terreno_agricolo` e `area_edificabile` — cioè anche per il tipo di default `abitazione_non_principale`.
  • quota_possesso_pct — number — Quota di possesso in % (default 100).
  • reddito_dominicale — number — Terreni agricoli: reddito dominicale da visura (base = ×1,25×135). OBBLIGATORIO con `tipo_immobile: terreno_agricolo`, tranne quando il terreno è esente (vedi i due flag).
  • categoria_catastale — string — Categoria catastale per i fabbricati (default A). Determina il moltiplicatore.
  • esente_montano_isola — boolean — Terreni: in comune montano/collinare o isola minore → esente.
  • coltivatore_diretto_iap — boolean — Terreni: coltivatore diretto/IAP iscritto alla previdenza agricola → esente.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• compose_f24 read-only

  Compone le RIGHE del modello F24 (sezione Erario, INPS, IMU) con i codici tributo e le causali ufficiali, a partire dagli importi già calcolati: imposta sostitutiva e contributi del regime forfettario (codici tributo 1790 = acconto prima rata, 1791 = acconto seconda rata o unica soluzione, 1792 = saldo; causali INPS PXX = Gestione Separata senza altra copertura, AF = artigiani sul minimale, AP = artigiani sull'eccedenza, CF = commercianti sul minimale, CP = commercianti sull'eccedenza) oppure IMU (3912 = abitazione principale e pertinenze (A/1, A/8, A/9), 3918 = altri fabbricati, 3914 = terreni, 3916 = aree fabbricabili; per il gruppo D 3925 = quota Stato (7,6‰) e 3930 = incremento Comune; con il codice ente catastale del Comune) oppure l'IMPOSTA DI BOLLO sulle fatture elettroniche di un trimestre (2521 = primo trimestre, 2522 = secondo trimestre, 2523 = terzo trimestre, 2524 = quarto trimestre; scadenze 31/05 · 30/09 · 30/11 · 28/02, con la regola di differimento sotto 5.000 €). Per il forfettario la risposta porta anche `regola_acconti`: le due rate al 50% valgono per chi ha un'attività con ISA approvati (anche in forfettario), altrimenti 40% e 60% — con la norma e la base di calcolo. Restituisce righe strutturate (sezione, codice, anno, importo, scadenza indicativa) + una resa testuale. COMPONIBILE: l'input tipico sono gli output di `calc_forfettario` (imposta_sostitutiva.importo, contributi_inps), `calc_imu` (imu_dovuta, acconto_giugno, saldo_dicembre) e `parse_fatturapa` (quante fatture hanno `bollo_analisi.dovuto = true`). NON genera il modello ministeriale F24 — né PDF né facsimile ufficiale: è una compilazione INDICATIVA che non sostituisce il commercialista né la verifica su Agenzia delle Entrate. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • kind (required) — string — Dominio da comporre: 'forfettario' (Erario + INPS), 'imu' (sezione IMU e altri tributi locali) oppure 'bollo' (imposta di bollo sulle fatture elettroniche di un trimestre).
  • imu — object — Richiesto quando kind='imu'. Campi dall'output di calc_imu.
  • bollo — object — Richiesto quando kind='bollo'. Chiude la catena parse → bollo → F24: conta quante fatture del trimestre risultano soggette a bollo secondo `parse_fatturapa` (campo `bollo_analisi.dovuto` di ciascuna fattura) e componi la riga di versamento.
  • forfettario — object — Richiesto quando kind='forfettario'. Campi dall'output di calc_forfettario.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• intrastat_periodicity read-only

  Determina se un soggetto deve presentare l'elenco riepilogativo INTRASTAT e con quale periodicità (mensile / trimestrale / nessun obbligo), a partire dagli ammontari dei quattro trimestri precedenti, e calcola la SCADENZA del periodo (giorno 25 del mese successivo, con slittamento se cade di sabato, domenica o festività nazionale italiana). Ogni flusso ha soglia e criterio propri, e li restituisce insieme alla FONTE normativa: cessioni di beni e servizi resi € 50.000 con criterio di SUPERAMENTO (>) → mensile se superata, altrimenti trimestrale; acquisti di servizi € 100.000 e acquisti di beni € 2.000.000 (soglia innalzata da € 350.000 dal periodo di riferimento 01/2026, Det. ADM 84415 del 03/02/2026) con criterio UGUALE O SUPERIORE (>=) → mensile se raggiunta, altrimenti NESSUN obbligo (per gli acquisti la periodicità trimestrale è stata abrogata). L'asimmetria > / >= è voluta e rispecchia le fonti. Indicativo: non sostituisce il commercialista o il doganalista. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • flusso (required) — string — 'cessioni' = operazioni attive, modelli INTRA-1 (beni ceduti / servizi resi); 'acquisti' = operazioni passive, modelli INTRA-2 (beni acquistati / servizi ricevuti).
  • categoria (required) — string — Categoria delle operazioni. Soglia e sezione del modello dipendono da questa.
  • anno (required) — integer — Anno del periodo di RIFERIMENTO (non dell'invio). I modelli vigenti decorrono dal 2022. Determina quale soglia INTRA-2bis si applica (2.000.000 dal 2026).
  • mese (required) — integer — Mese del periodo di riferimento (1–12). Se la periodicità risulta trimestrale, il trimestre viene dedotto da questo mese.
  • ammontari_trimestri_precedenti (required) — array — Ammontari in EURO dei quattro trimestri PRECEDENTI per quel flusso+categoria, ordinati dal più recente al più remoto (es. [62000, 41000, 38000, 35000]). Ammessi da 1 a 4 valori: chi ha iniziato da poco ne ha meno, e la risposta lo segnala nelle note. La soglia si valuta sul MASSIMO, non sulla somma.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• intrastat_compose read-only

  Compone le SEZIONI dell'elenco riepilogativo INTRASTAT a partire dalle righe di operazione, assegnando ciascuna riga alla sezione corretta (INTRA-1bis cessioni di beni, 1ter rettifiche, 1quater servizi resi, 1quinquies rettifiche, 1sexies call-off stock; INTRA-2bis acquisti di beni, 2ter, 2quater servizi ricevuti, 2quinquies) e VALIDANDOLE: Stato membro ammesso (l'Irlanda del Nord XI vale solo per i BENI; San Marino e Regno Unito sono fuori ambito), partita IVA della controparte (formato per Stato membro + checksum per quelle italiane), nomenclatura combinata a 8 cifre (o il codice semplificato 99500000), formato della natura della transazione e campi obbligatori per sezione. Restituisce le sezioni popolate, i totali, la scadenza e un prospetto testuale di controllo. ⚠️ NON genera il file TELEMATICO per il Servizio Telematico Doganale (Intr@Web / ADM): il tracciato record ufficiale non è riproducibile da fonte pubblica verificabile, quindi non è stato inventato. Quello che ottieni è struttura-dati + prospetto, da riportare sul canale ufficiale. Nessun default silenzioso: un dato obbligatorio mancante produce un errore esplicito, mai un riempimento arbitrario. Le partite IVA sono validate OFFLINE (formato e checksum): per la verifica VIES live della controparte usa `verify_payee`. Determina prima la periodicità con `intrastat_periodicity`. Indicativo, non sostituisce il commercialista o il doganalista. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • anno (required) — integer — Anno del periodo di riferimento (i modelli vigenti decorrono dal 2022).
  • mese (required) — integer — Mese del periodo di riferimento (1–12). Con periodicità trimestrale individua il trimestre.
  • righe (required) — array — Righe di operazione da riepilogare. Massimo 25 sulla superficie anonima (l'API autenticata non ha questo limite). Righe di flussi/categorie diversi possono coesistere: ognuna finisce nella sua sezione.
  • periodicita — string — Periodicità dell'elenco — determinala con `intrastat_periodicity`. Con 'nessun_obbligo' la chiamata viene RIFIUTATA con una spiegazione: sotto soglia l'elenco non va presentato.
  • partita_iva_dichiarante — string — Partita IVA italiana del soggetto obbligato (11 cifre, opzionale). Se fornita viene validata col checksum.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• intrastat_reference read-only

  Restituisce, senza alcun input, le tabelle di riferimento INTRASTAT: gli Stati membri ammessi con i loro codici, il caso dell'Irlanda del Nord (XI, solo beni) e i paesi fuori ambito (San Marino dal 01/10/2021, Regno Unito dal 01/01/2021), tutte le sezioni dei modelli con la loro descrizione, e OGNI soglia vigente con importo, criterio di confronto (> oppure >=), effetto e FONTE normativa puntuale — inclusa la soglia acquisti di beni innalzata a € 2.000.000 dal periodo 01/2026 (Det. ADM 84415 del 03/02/2026). Include anche il termine di presentazione e l'elenco ESPLICITO di ciò che questi strumenti NON producono (il file telematico ADM, le descrizioni dei codici natura della transazione, la verifica VIES live). Usalo per validare gli input prima di `intrastat_compose`, per popolare un form, o per citare la fonte di una soglia invece di ricordarla a memoria. Gratis (€0), deterministico, nessun login richiesto.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• nis2_tipologie read-only

  Elenco ufficiale delle tipologie di soggetto degli allegati I–IV del D.Lgs. 4 settembre 2024 n. 138 (recepimento NIS2), verbatim dal testo di Gazzetta Ufficiale, con ricerca testuale. Serve a trovare il `tipologia_id` da passare a `nis2_ambito`. ⚠️ NON esiste alcuna mappa codice ATECO → tipologia, e questo strumento non ne usa una: la dichiarazione sulla piattaforma ACN (art. 11 c. 2 della determinazione ACN 127437/2026) tiene i codici ATECO e le tipologie di soggetto SEPARATI, e l'ambito si determina sulla TIPOLOGIA, definita per rinvio a una norma UE. Dedurre l'ambito NIS2 da un codice ATECO significa applicare una regola che la fonte non contiene. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • q — string — Ricerca testuale su testo della tipologia, settore e sottosettore (accenti e maiuscole ignorati; tutti i termini devono comparire). Es. 'cloud', 'energia elettrica', 'rifiuti'. Vuoto = tutto il catalogo.
  • limit — integer — Numero massimo di risultati (default 200).
  • allegato — string — Filtra per allegato. I = settori ad alta criticità (51 tipologie); II = altri settori critici (15); III = pubbliche amministrazioni (15); IV = ulteriori tipologie, che rientrano solo se individuate dall'ACN (4).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• nis2_ambito read-only

  Dice se un soggetto rientra nel campo di applicazione del D.Lgs. 138/2024 (NIS2) e se è soggetto ESSENZIALE o IMPORTANTE, citando ARTICOLO E COMMA per ogni passo del ragionamento. Quando manca un dato che cambierebbe la risposta restituisce `esito: "indeterminato"` e la DOMANDA da porre, invece di una risposta inventata. Le regole su cui si sbaglia più spesso, tutte applicate qui: (1) la soglia di INGRESSO è quella della PICCOLA impresa, non della media — si è dentro con occupati >= 50 OPPURE (fatturato > 10 M€ E bilancio > 10 M€) — quindi l'ambito è molto più largo di come viene raccontato; (2) per superare un massimale servono gli occupati sopra soglia OPPURE ENTRAMBI i valori finanziari sopra soglia: 30 dipendenti con 12 M€ di fatturato e 8 M€ di bilancio è ancora PICCOLA, quindi FUORI; (3) l'art. 3 §4 della raccomandazione 2003/361/CE è DISAPPLICATO (art. 3 c. 3): una partecipazione pubblica pari o superiore al 25% non fa perdere lo stato di PMI; (4) un soggetto dell'allegato II non è MAI essenziale per dimensione — l'art. 6 c. 1 lett. a) cita solo l'allegato I — nemmeno con migliaia di dipendenti. Non registra nulla presso l'ACN: è il pre-volo della dichiarazione, la cui valutazione preliminare è svolta automaticamente dalla piattaforma ACN (art. 11 c. 6 della determinazione ACN 127437/2026); l’inserimento o meno nell'elenco dei soggetti NIS lo comunica poi l'ACN (art. 15 c. 3 della determinazione). Indicativo, non è un parere legale. Gratis (€0), deterministico, nessun login richiesto.

  Parameters:

  • tipologia_id (required) — string — Id della tipologia dall'elenco ufficiale — ottienilo con `nis2_tipologie`. Es. 'I.1.a.1' (impresa elettrica), 'III.a.2' (Ministeri). NON è un codice ATECO.
  • occupati — integer — Numero di occupati (unità lavorative-anno).
  • bilancio_eur — number — Totale di bilancio annuo in euro.
  • fatturato_eur — number — Fatturato annuo in euro.
  • dati_consolidati — boolean — true se i valori dimensionali forniti sono GIÀ consolidati di gruppo.
  • impresa_autonoma — boolean — false se il soggetto ha imprese collegate o associate: l'art. 3 c. 4 impone allora il consolidamento ex art. 6 §2 della raccomandazione. Omettilo se non lo sai — lo strumento chiede. Un superamento già visibile sui dati individuali resta valido (il consolidamento può solo aumentare i valori); un NON superamento no.
  • individuato_da_acn — boolean — true se l'Autorità nazionale competente NIS ha notificato l'individuazione (art. 3 c. 13). Per l'allegato IV è LA condizione dell'ambito: senza, non è auto-valutabile e lo strumento lo dichiara invece di indovinare.
  • soggetto_critico_cer — boolean — true se il soggetto è identificato come soggetto critico ai sensi del decreto che recepisce la direttiva (UE) 2022/2557 (CER): rientra ed è ESSENZIALE a prescindere dalla dimensione (art. 3 c. 5 lett. a; art. 6 c. 1 lett. b).
  • criteri_impresa_collegata — array — Lettere dell'art. 3 c. 10 soddisfatte quando il soggetto è impresa collegata a un soggetto essenziale o importante: a) influenza dominante sulle decisioni relative alle misure di gestione del rischio; b) detiene o gestisce i sistemi da cui dipende la fornitura del servizio; c) ne effettua le operazioni di sicurezza informatica; d) gli fornisce servizi TIC o di sicurezza. Anche una sola lettera lo fa rientrare a prescindere dalla dimensione.
  • prestatore_fiduciario_qualificato — boolean — Solo per i prestatori di servizi fiduciari: i QUALIFICATI sono essenziali a prescindere dalla dimensione (art. 6 c. 1 lett. d), i non qualificati no.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• nis2_reference read-only

  Restituisce, senza alcun input, le soglie dimensionali NIS2 con la formula esatta di superamento e la fonte (raccomandazione 2003/361/CE, allegato, art. 2 §1 e §2, riprodotto testualmente nelle note all'art. 6 in Gazzetta Ufficiale), la regola di ogni comma rilevante dell'art. 3 e dell'art. 6, i quattro criteri dell'impresa collegata, la finestra di registrazione sulla piattaforma ACN (dal 1° gennaio al 28 febbraio di OGNI anno: è ricorrente, non una scadenza singola) e l'elenco ESPLICITO di ciò che questo dominio NON copre. Include il caso dei settori 3 e 4 dell'allegato I (bancario e infrastrutture dei mercati finanziari), per i quali l'art. 3 c. 14 sostituisce l'art. 17 e i Capi IV e V con il regolamento (UE) 2022/2554 (DORA). Usalo per citare la fonte di una soglia invece di ricordarla a memoria. Gratis (€0), deterministico, nessun login richiesto.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• verify_payee read-only

  Verifica anti-frode di un beneficiario PRIMA di pagare una fattura (contro la truffa del cambio-IBAN / Business Email Compromise). Controlli: IBAN (checksum MOD-97 + banca dal codice ABI), Partita IVA e Codice Fiscale (checksum), e — quando il servizio UE è raggiungibile — la ragione sociale reale via VIES live con match sul nome atteso. Restituisce un verdetto (ok / non_verificabile / attenzione / alto_rischio) + i red flag puntuali. `non_verificabile` = nessun segnale di frode MA nessuna fonte autorevole ha confermato chi sia il fornitore (P.IVA italiana non iscritta al VIES, o nessuna P.IVA fornita): non è un allarme, è il rifiuto di dire «ok» su un soggetto non identificato. A differenza degli altri strumenti fa I/O esterno (VIES): se VIES è giù o il budget di verifica è temporaneamente esaurito, il verdetto degrada ONESTAMENTE ad "attenzione" (mai un falso "ok"). Gratis (€0), nessun login. NON sostituisce la verifica out-of-band (telefonata al fornitore su un numero già noto).

  Parameters:

  • iban — string — IBAN del beneficiario (es. IT60X0542811101000000123456).
  • ateco — string — Codice ATECO dichiarato del fornitore (solo cifre e punti, opzionale).
  • vat_number — string — Partita IVA con o senza prefisso paese (es. IT12345678901).
  • expected_name — string — Ragione sociale attesa del fornitore, confrontata con quella ufficiale VIES.
  • codice_fiscale — string — Codice Fiscale (persona fisica / ditta individuale).
  • expected_country — string — Paese atteso del fornitore in ISO2 (default IT). Un IBAN estero è il campanello #1 della frode.

  Hints: read-only yes · destructive no · idempotent yes · open-world yes

• guardian_list_suppliers read-only

  Elenca i fornitori che questo account sta sorvegliando, con lo stato della verifica VIES piu' recente e quanti IBAN risultano confermati o in attesa di conferma. Gli IBAN sono restituiti MASCHERATI. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.

  Parameters:

  • only_alerting — boolean — Se true, restituisce solo i fornitori che meritano attenzione: IBAN in attesa di conferma, oppure ultima verifica VIES non superata.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• guardian_supplier_ledger read-only

  Lo storico degli IBAN visti per un fornitore: quali sono confermati, quali sono in attesa di conferma umana, quali sono stati rifiutati, e da quando. E' la memoria contro cui si giudica un IBAN nuovo. Gli IBAN sono MASCHERATI (paese, banca, ultime 4 cifre). Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.

  Parameters:

  • partita_iva — string — Partita IVA del fornitore (con o senza prefisso IT).
  • codice_fiscale — string — Codice Fiscale del fornitore.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• guardian_supplier_status read-only

  Dice se un fornitore e' sorvegliato da questo account e come e' andata l'ultima verifica: esito VIES, se la risposta era autorevole, da quando non se ne ottiene una, e le eventuali anomalie rilevate. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.

  Parameters:

  • partita_iva — string — Partita IVA del fornitore (con o senza prefisso IT).
  • codice_fiscale — string — Codice Fiscale del fornitore.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• guardian_check_iban

  Il gesto anti-BEC: confronta l'IBAN letto su una fattura con lo storico di quel fornitore e dice se e' gia' confermato, gia' visto ma mai confermato, o MAI VISTO. ATTENZIONE, questo strumento MODIFICA lo stato: un IBAN mai visto viene registrato come "in attesa di conferma" e all'intestatario dell'account parte un'email di avviso. La conferma di un IBAN NON e' esposta agli agenti: e' un atto che richiede una persona, e si compie su https://imperioutils.com/tools/supplier-monitors. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.

  Parameters:

  • iban (required) — string — IBAN riportato sul documento da pagare.
  • partita_iva — string — Partita IVA del fornitore (con o senza prefisso IT).
  • codice_fiscale — string — Codice Fiscale del fornitore.

  Hints: read-only no · destructive no · idempotent no · open-world no

• guardian_watch_supplier

  Registra uno o piu' fornitori nel guardiano, perche' i loro cambi di IBAN e le variazioni VIES vengano intercettati dalle verifiche notturne. Gli IBAN indicati entrano nel libretto come "in attesa di conferma", MAI come confermati: un IBAN letto su un documento non e' una baseline. Cio' che resta fuori (piano pieno, gia' sorvegliato, identita' assente) viene restituito contato e motivato. Richiede una API key (account gratuito su https://imperioutils.com/signup). Non consuma crediti.

  Parameters:

  • suppliers (required) — array — I fornitori da sorvegliare. Per ciascuno serve la Partita IVA oppure il Codice Fiscale.

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.