Imperio — Italian Tax & Compliance Tools

{'type': 'object', 'anyOf': [{'required': ['ateco']}, {'required': ['coefficiente']}], 'required': ['ricavi'], 'properties': {'ateco': {'type': 'string', 'pattern': '^[0-9.]{1,12}$', 'maxLength': 12, 'description': "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'»)."}, 'ricavi': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'Ricavi/compensi annui in euro.'}, 'startup': {'type': 'boolean', 'default': False, 'description': 'Aliquota startup 5% per i primi 5 anni (default false → 15%).'}, 'coefficiente': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Coefficiente di redditività in % (override manuale). ALTERNATIVO ad `ateco`: uno dei due è obbligatorio.'}, 'riduzione_35': {'type': 'boolean', 'default': False, 'description': 'Riduzione contributiva INPS del 35% (artigiani/commercianti).'}, 'gestione_inps': {'enum': ['gestione_separata', 'artigiani', 'commercianti', 'cassa_privata'], 'type': 'string', 'description': 'Gestione previdenziale INPS/cassa (opzionale).'}, 'contributi_cassa_privata': {'type': 'integer', 'maximum': 1000000, 'minimum': 0, 'description': 'Contributi cassa privata già versati, in euro (opzionale).'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['rendita_catastale']}, {'required': ['reddito_dominicale', 'tipo_immobile'], 'properties': {'tipo_immobile': {'const': 'terreno_agricolo'}}}, {'required': ['valore_venale', 'tipo_immobile'], 'properties': {'tipo_immobile': {'const': 'area_edificabile'}}}, {'required': ['coltivatore_diretto_iap', 'tipo_immobile'], 'properties': {'tipo_immobile': {'const': 'terreno_agricolo'}, 'coltivatore_diretto_iap': {'const': True}}}, {'required': ['esente_montano_isola', 'tipo_immobile'], 'properties': {'tipo_immobile': {'const': 'terreno_agricolo'}, 'esente_montano_isola': {'const': True}}}], 'required': ['aliquota_permille'], 'properties': {'detrazione': {'type': 'number', 'minimum': 0, 'description': 'Detrazione in euro (solo fabbricati; es. 200 per abitazione principale di lusso).'}, 'mesi_possesso': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': "Mesi di possesso nell'anno (default 12)."}, 'tipo_immobile': {'enum': ['abitazione_principale_A1_A8_A9', 'abitazione_non_principale', 'immobile_produttivo', 'immobile_locato_canone_concordato', 'comodato_uso_parenti', 'terreno_agricolo', 'area_edificabile'], 'type': 'string', 'description': 'Tipo immobile → seleziona la formula (default abitazione_non_principale).'}, 'valore_venale': {'type': 'number', 'minimum': 0.01, 'description': 'Aree edificabili: valore venale in comune commercio al 1° gennaio (€). OBBLIGATORIO con `tipo_immobile: area_edificabile`.'}, 'aliquota_permille': {'type': 'number', 'maximum': 15, 'minimum': 0, 'description': 'Aliquota deliberata dal Comune, in per mille (es. 8.6 per 8,6‰).'}, 'rendita_catastale': {'type': 'number', 'minimum': 0.01, 'description': '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': {'type': 'number', 'maximum': 100, 'minimum': 1, 'description': 'Quota di possesso in % (default 100).'}, 'reddito_dominicale': {'type': 'number', 'minimum': 0.01, 'description': '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': {'enum': ['A', 'A10', 'B', 'C1', 'C2_C6_C7', 'C3_C4_C5', 'D', 'D5', 'E', 'F'], 'type': 'string', 'description': 'Categoria catastale per i fabbricati (default A). Determina il moltiplicatore.'}, 'esente_montano_isola': {'type': 'boolean', 'description': 'Terreni: in comune montano/collinare o isola minore → esente.'}, 'coltivatore_diretto_iap': {'type': 'boolean', 'description': 'Terreni: coltivatore diretto/IAP iscritto alla previdenza agricola → esente.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'properties': {'tipo_operazione': {'enum': ['b2b', 'b2c', 'PA']}}}, {'required': ['tipo_operazione'], 'properties': {'oggetto': {'const': 'beni'}, 'tipo_operazione': {'const': 'extraUE'}}}, {'required': ['tipo_operazione', 'oggetto', 'cessionario_soggetto_iva'], 'properties': {'oggetto': {'const': 'servizi'}, 'tipo_operazione': {'const': 'extraUE'}, 'cessionario_soggetto_iva': {'type': 'boolean'}}}, {'required': ['tipo_operazione', 'cessionario_soggetto_iva'], 'properties': {'tipo_operazione': {'const': 'intraUE'}, 'cessionario_soggetto_iva': {'const': True}}}, {'required': ['tipo_operazione', 'cessionario_soggetto_iva', 'oggetto'], 'properties': {'oggetto': {'enum': ['beni', 'servizi']}, 'tipo_operazione': {'const': 'intraUE'}, 'cessionario_soggetto_iva': {'const': False}}}], 'required': ['imponibile'], 'properties': {'oggetto': {'enum': ['beni', 'servizi'], 'type': 'string', 'description': '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.'}, 'imponibile': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0.01, 'description': 'Compenso/corrispettivo in EUR (es. 1000), AL NETTO del contributo integrativo cassa e della rivalsa INPS: quelli si aggiungono con i due campi dedicati.'}, 'aliquota_iva': {'enum': ['22', '10', '5', '4', '0', 'esente', 'fuori_campo'], 'type': 'string', 'description': 'Aliquota IVA (default 22).'}, 'con_ritenuta': {'type': 'boolean', 'description': "Applica la ritenuta d'acconto (default false)."}, 'tipo_ritenuta': {'enum': ['autonomo', 'agente'], 'type': 'string', 'description': 'Tipo ritenuta se con_ritenuta=true (autonomo 20% | agente 11,5%).'}, 'tipo_servizio': {'enum': ['generico', 'elettronico', 'speciale'], 'type': 'string', 'description': "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': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': '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': {'enum': ['b2b', 'b2c', 'intraUE', 'extraUE', 'PA'], 'type': 'string', 'description': "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': {'type': 'number', 'maximum': 5, 'minimum': 0, 'description': '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': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': "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': {'type': 'boolean', 'description': "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': {'type': 'boolean', 'description': "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': {'type': 'boolean', 'description': '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': {'type': 'boolean', 'description': "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': {'type': 'number', 'maximum': 30, 'minimum': 0, 'description': "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': {'type': 'number', 'maximum': 5, 'minimum': 0, 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['imponibile', 'paese_cedente'], 'properties': {'imponibile': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0.01, 'description': 'Imponibile della fattura in EUR.'}, 'aliquota_iva': {'enum': ['22', '10', '5', '4', '0', 'esente', 'fuori_campo'], 'type': 'string', 'description': 'Aliquota IVA da autoliquidare (default 22).'}, 'paese_cedente': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'maxLength': 2, 'description': "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."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['imponibile'], 'properties': {'imponibile': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0.01, 'description': 'Imponibile della fornitura alla PA in EUR.'}, 'aliquota_iva': {'enum': ['22', '10', '5', '4', '0', 'esente', 'fuori_campo'], 'type': 'string', 'description': 'Aliquota IVA esposta in fattura (default 22).'}}, 'additionalProperties': False}

{'type': 'object', 'allOf': [{'if': {'required': ['kind'], 'properties': {'kind': {'const': 'forfettario'}}}, 'then': {'required': ['forfettario']}}, {'if': {'required': ['kind'], 'properties': {'kind': {'const': 'imu'}}}, 'then': {'required': ['imu']}}, {'if': {'required': ['kind'], 'properties': {'kind': {'const': 'bollo'}}}, 'then': {'required': ['bollo']}}], 'required': ['kind'], 'properties': {'imu': {'type': 'object', 'required': ['imu_dovuta', 'acconto', 'saldo', 'tipo_immobile', 'codice_comune', 'anno'], 'properties': {'anno': {'type': 'integer', 'maximum': 2100, 'minimum': 2012, 'description': "Anno d'imposta di riferimento (es. 2026)."}, 'saldo': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'Saldo di dicembre in euro — calc_imu → saldo_dicembre.'}, 'acconto': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'Acconto di giugno in euro — calc_imu → acconto_giugno.'}, 'imu_dovuta': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'IMU annua dovuta in euro — calc_imu → imu_dovuta.'}, 'codice_comune': {'type': 'string', 'pattern': '^[A-Za-z][0-9]{3}$', 'maxLength': 4, 'description': 'Codice catastale/Belfiore del Comune = codice ente F24 (1 lettera + 3 cifre, es. H501 per Roma).'}, 'tipo_immobile': {'enum': ['abitazione_principale_A1_A8_A9', 'abitazione_non_principale', 'immobile_produttivo', 'immobile_locato_canone_concordato', 'comodato_uso_parenti', 'terreno_agricolo', 'area_edificabile'], 'type': 'string', 'description': 'Tipo immobile — calc_imu → parametri.tipo_immobile. Determina il codice tributo IMU.'}, 'base_imponibile': {'type': 'number', 'minimum': 0, 'description': 'Base imponibile in euro — calc_imu → base_imponibile. Serve allo split del gruppo D.'}, 'aliquota_permille': {'type': 'number', 'maximum': 20, 'minimum': 0, 'description': 'Aliquota deliberata dal Comune in per mille — calc_imu → parametri.aliquota_permille. Serve allo split gruppo D (7,6‰ Stato + eccedenza Comune).'}, 'categoria_catastale': {'enum': ['A', 'A10', 'B', 'C1', 'C2_C6_C7', 'C3_C4_C5', 'D', 'D5', 'E', 'F'], 'type': 'string', 'description': 'Categoria catastale (default A) — calc_imu → parametri.categoria_catastale.'}}, 'description': "Richiesto quando kind='imu'. Campi dall'output di calc_imu.", 'additionalProperties': False}, 'kind': {'enum': ['forfettario', 'imu', 'bollo'], 'type': 'string', 'description': "Dominio da comporre: 'forfettario' (Erario + INPS), 'imu' (sezione IMU e altri tributi locali) oppure 'bollo' (imposta di bollo sulle fatture elettroniche di un trimestre)."}, 'bollo': {'type': 'object', 'anyOf': [{'required': ['numero_fatture']}, {'required': ['importo']}], 'required': ['trimestre', 'anno'], 'properties': {'anno': {'type': 'integer', 'maximum': 2100, 'minimum': 2019, 'description': "Anno delle fatture (es. 2026). NB: il IV trimestre si versa entro il 28 febbraio dell'anno SUCCESSIVO."}, 'importo': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'Importo del bollo già calcolato in euro. Alternativo a `numero_fatture`. Se passi entrambi e non tornano, vince questo e la discrepanza viene segnalata in nota.'}, 'trimestre': {'type': 'integer', 'maximum': 4, 'minimum': 1, 'description': 'Trimestre solare di riferimento. Determina il codice tributo: 1→2521, 2→2522, 3→2523, 4→2524.'}, 'numero_fatture': {'type': 'integer', 'maximum': 1000000, 'minimum': 0, 'description': 'Quante fatture del trimestre sono soggette a bollo (2,00 € ciascuna). Alternativo a `importo`: fornire almeno uno dei due.'}, 'importo_trimestri_precedenti': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'Bollo già dovuto per i trimestri precedenti dello stesso anno (default 0). Serve alla regola di differimento, che guarda il CUMULATO: sotto 5.000 € il versamento del I trimestre può slittare al 30/09 e quello di I+II al 30/11 (art. 3 DL 73/2022). III e IV trimestre non sono mai differibili.'}}, 'description': "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.", 'additionalProperties': False}, 'forfettario': {'type': 'object', 'required': ['imposta', 'anno'], 'properties': {'anno': {'type': 'integer', 'maximum': 2100, 'minimum': 2015, 'description': "Anno d'imposta di riferimento (es. 2026)."}, 'imposta': {'type': 'number', 'maximum': 10000000, 'minimum': 0, 'description': 'Imposta sostitutiva dovuta in euro — calc_forfettario → imposta_sostitutiva.importo.'}, 'startup': {'type': 'boolean', 'default': False, 'description': 'Aliquota startup 5% (nuova attività): nel 1° anno solo saldo, niente acconti.'}, 'inps_fisso': {'type': 'number', 'maximum': 1000000, 'minimum': 0, 'description': 'Contributi INPS sul minimale/fisso in euro — calc_forfettario → contributi_inps.fisso.'}, 'inps_totale': {'type': 'number', 'maximum': 1000000, 'minimum': 0, 'description': 'Totale contributi INPS in euro — calc_forfettario → contributi_inps.importo. Usato solo se fisso/variabile non sono forniti.'}, 'gestione_inps': {'enum': ['gestione_separata', 'artigiani', 'commercianti', 'cassa_privata'], 'type': 'string', 'description': 'Gestione previdenziale (default gestione_separata) — determina la causale INPS (PXX | AF/AP | CF/CP).'}, 'inps_variabile': {'type': 'number', 'maximum': 1000000, 'minimum': 0, 'description': "Contributi INPS sull'eccedenza in euro — calc_forfettario → contributi_inps.variabile."}}, 'description': "Richiesto quando kind='forfettario'. Campi dall'output di calc_forfettario.", 'additionalProperties': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['cognome', 'nome', 'data_nascita', 'sesso'], 'properties': {'nome': {'type': 'string', 'maxLength': 64, 'description': 'Nome.'}, 'sesso': {'enum': ['M', 'F'], 'type': 'string', 'description': 'Sesso: M o F.'}, 'comune': {'type': 'string', 'maxLength': 64, 'description': 'Comune (o stato estero) di nascita. In alternativa usa codice_belfiore.'}, 'cognome': {'type': 'string', 'maxLength': 64, 'description': 'Cognome.'}, 'provincia': {'type': 'string', 'maxLength': 4, 'description': 'Sigla provincia (es. PI) per disambiguare comuni omonimi.'}, 'data_nascita': {'type': 'string', 'maxLength': 10, 'description': 'Data di nascita in formato GG/MM/AAAA (es. 10/12/1985).'}, 'codice_belfiore': {'type': 'string', 'maxLength': 4, 'description': 'Codice catastale/Belfiore del luogo di nascita (alternativa precisa al comune).'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['partita_iva']}, {'required': ['codice_fiscale']}], 'required': ['iban'], 'properties': {'iban': {'type': 'string', 'maxLength': 40, 'description': 'IBAN riportato sul documento da pagare.'}, 'partita_iva': {'type': 'string', 'maxLength': 20, 'description': 'Partita IVA del fornitore (con o senza prefisso IT).'}, 'codice_fiscale': {'type': 'string', 'maxLength': 20, 'description': 'Codice Fiscale del fornitore.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'only_alerting': {'type': 'boolean', 'description': 'Se true, restituisce solo i fornitori che meritano attenzione: IBAN in attesa di conferma, oppure ultima verifica VIES non superata.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['partita_iva']}, {'required': ['codice_fiscale']}], 'properties': {'partita_iva': {'type': 'string', 'maxLength': 20, 'description': 'Partita IVA del fornitore (con o senza prefisso IT).'}, 'codice_fiscale': {'type': 'string', 'maxLength': 20, 'description': 'Codice Fiscale del fornitore.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['partita_iva']}, {'required': ['codice_fiscale']}], 'properties': {'partita_iva': {'type': 'string', 'maxLength': 20, 'description': 'Partita IVA del fornitore (con o senza prefisso IT).'}, 'codice_fiscale': {'type': 'string', 'maxLength': 20, 'description': 'Codice Fiscale del fornitore.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['suppliers'], 'properties': {'suppliers': {'type': 'array', 'items': {'type': 'object', 'anyOf': [{'required': ['partita_iva']}, {'required': ['codice_fiscale']}], 'properties': {'iban': {'type': 'string', 'maxLength': 40, 'description': 'IBAN letto sul documento. Entra nel libretto come "in attesa di conferma".'}, 'label': {'type': 'string', 'maxLength': 160, 'description': 'Etichetta libera.'}, 'partita_iva': {'type': 'string', 'maxLength': 20, 'description': 'Partita IVA del fornitore (con o senza prefisso IT).'}, 'expected_name': {'type': 'string', 'maxLength': 160, 'description': 'Ragione sociale attesa.'}, 'codice_fiscale': {'type': 'string', 'maxLength': 20, 'description': 'Codice Fiscale del fornitore.'}, 'expected_country': {'type': 'string', 'maxLength': 2, 'description': "Paese ATTESO del fornitore (ISO-2). Se omesso vale IT. E' il paese contro cui si giudica un IBAN estero: dichiararlo evita avvisi fabbricati su fornitori legittimamente stranieri."}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1, 'description': 'I fornitori da sorvegliare. Per ciascuno serve la Partita IVA oppure il Codice Fiscale.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['anno', 'mese', 'righe'], 'properties': {'anno': {'type': 'integer', 'maximum': 2100, 'minimum': 2022, 'description': 'Anno del periodo di riferimento (i modelli vigenti decorrono dal 2022).'}, 'mese': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Mese del periodo di riferimento (1–12). Con periodicità trimestrale individua il trimestre.'}, 'righe': {'type': 'array', 'items': {'type': 'object', 'allOf': [{'if': {'required': ['categoria'], 'properties': {'categoria': {'const': 'beni'}}}, 'then': {'required': ['nomenclatura_combinata']}}, {'if': {'required': ['categoria'], 'properties': {'categoria': {'const': 'servizi'}}}, 'then': {'required': ['codice_servizio', 'modalita_erogazione', 'modalita_incasso']}}, {'if': {'required': ['rettifica'], 'properties': {'rettifica': {'const': True}}}, 'then': {'required': ['anno_riferimento_rettifica']}}], 'required': ['flusso', 'categoria', 'paese_controparte', 'partita_iva_controparte', 'ammontare'], 'properties': {'flusso': {'enum': ['cessioni', 'acquisti'], 'type': 'string', 'description': 'cessioni = INTRA-1 (attive) · acquisti = INTRA-2 (passive).'}, 'ammontare': {'type': 'number', 'description': 'Ammontare delle operazioni in EURO. Negativo ammesso solo se rettifica=true.'}, 'categoria': {'enum': ['beni', 'servizi'], 'type': 'string', 'description': 'Determina quali campi sono obbligatori: i campi BENI e i campi SERVIZI si escludono.'}, 'rettifica': {'type': 'boolean', 'default': False, 'description': 'True se la riga rettifica un periodo PRECEDENTE → sezioni ter/quinquies. Richiede `anno_riferimento_rettifica`. Solo sulle rettifiche è ammesso un ammontare negativo.'}, 'riferimento': {'type': 'string', 'maxLength': 64, 'description': "Riferimento libero (es. numero fattura). Serve solo alla tua tracciabilità: non fa parte dell'elenco."}, 'paese_origine': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Solo BENI: paese di origine della merce (ISO2).'}, 'call_off_stock': {'type': 'boolean', 'default': False, 'description': 'Solo cessioni di BENI: regime call-off stock (art. 17-bis Dir. 2006/112/CE) → sezione INTRA-1sexies.'}, 'massa_netta_kg': {'type': 'number', 'minimum': 0, 'description': 'Solo BENI: massa netta in kg.'}, 'codice_servizio': {'type': 'string', 'pattern': '^\\d{6}$', 'maxLength': 6, 'description': "Solo SERVIZI: codice CPA a 6 cifre. Validato nel formato, non l'esistenza in tabella CPA."}, 'modalita_incasso': {'enum': ['B', 'A', 'X'], 'type': 'string', 'description': "Solo SERVIZI: 'B' bonifico · 'A' accredito · 'X' altro."}, 'paese_controparte': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': "Codice ISO2 dello Stato membro della controparte (es. DE, FR, ES; EL per la Grecia, non GR). 'XI' (Irlanda del Nord) è ammesso SOLO per i beni. SM (San Marino) e GB sono fuori ambito e vengono rifiutati."}, 'natura_transazione': {'type': 'string', 'maxLength': 2, 'description': "Solo BENI: codice natura della transazione — 1 cifra (colonna A) oppure 2 cifre (colonne A+B, obbligatorie oltre € 20.000.000 di scambi nell'anno precedente). Si valida SOLO il formato: le descrizioni dei codici sono l'Allegato XI alla Det. ADM 493869/RU/2021, non riproducibile da fonte testuale verificabile, e non vengono inventate."}, 'paese_destinazione': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'Solo BENI: paese di destinazione/provenienza della merce (ISO2).'}, 'modalita_erogazione': {'enum': ['I', 'R'], 'type': 'string', 'description': "Solo SERVIZI: 'I' istantanea · 'R' a più riprese."}, 'nomenclatura_combinata': {'type': 'string', 'pattern': '^\\d{8}$', 'maxLength': 8, 'description': "Solo BENI: codice NC a 8 cifre. Per spedizioni di valore inferiore a € 1.000 è ammesso il codice unico 99500000. Se ne valida il FORMATO, non l'esistenza nella NC dell'anno (la tabella NC è annuale e non è in repository)."}, 'partita_iva_controparte': {'type': 'string', 'maxLength': 24, 'description': 'Partita IVA della controparte, con o senza prefisso paese (es. DE123456789 o 123456789). Validata sul formato dello Stato membro; per le italiane anche col checksum. Nessuna interrogazione VIES.'}, 'anno_riferimento_rettifica': {'type': 'integer', 'maximum': 2100, 'minimum': 2022, 'description': 'Obbligatorio se rettifica=true: anno del periodo rettificato.'}}, 'additionalProperties': False}, 'maxItems': 25, 'minItems': 1, 'description': "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': {'enum': ['mensile', 'trimestrale', 'nessun_obbligo'], 'type': 'string', 'default': 'mensile', 'description': "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': {'type': 'string', 'maxLength': 16, 'description': 'Partita IVA italiana del soggetto obbligato (11 cifre, opzionale). Se fornita viene validata col checksum.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['flusso', 'categoria', 'anno', 'mese', 'ammontari_trimestri_precedenti'], 'properties': {'anno': {'type': 'integer', 'maximum': 2100, 'minimum': 2022, 'description': "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': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Mese del periodo di riferimento (1–12). Se la periodicità risulta trimestrale, il trimestre viene dedotto da questo mese.'}, 'flusso': {'enum': ['cessioni', 'acquisti'], 'type': 'string', 'description': "'cessioni' = operazioni attive, modelli INTRA-1 (beni ceduti / servizi resi); 'acquisti' = operazioni passive, modelli INTRA-2 (beni acquistati / servizi ricevuti)."}, 'categoria': {'enum': ['beni', 'servizi'], 'type': 'string', 'description': 'Categoria delle operazioni. Soglia e sezione del modello dipendono da questa.'}, 'ammontari_trimestri_precedenti': {'type': 'array', 'items': {'type': 'number', 'minimum': 0}, 'maxItems': 4, 'minItems': 1, 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'pattern': '^[0-9.]{1,12}$', 'maxLength': 12, 'description': 'Il codice ATECO (solo cifre e punti, es. 62.01).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['cap'], 'properties': {'cap': {'type': 'string', 'maxLength': 8, 'description': 'Il CAP a 5 cifre (es. 20121).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['tipologia_id'], 'properties': {'occupati': {'type': 'integer', 'minimum': 0, 'description': 'Numero di occupati (unità lavorative-anno).'}, 'bilancio_eur': {'type': 'number', 'minimum': 0, 'description': 'Totale di bilancio annuo in euro.'}, 'tipologia_id': {'type': 'string', 'maxLength': 32, 'description': "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."}, 'fatturato_eur': {'type': 'number', 'minimum': 0, 'description': 'Fatturato annuo in euro.'}, 'dati_consolidati': {'type': 'boolean', 'description': 'true se i valori dimensionali forniti sono GIÀ consolidati di gruppo.'}, 'impresa_autonoma': {'type': 'boolean', 'description': "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': {'type': 'boolean', 'description': "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': {'type': 'boolean', 'description': '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': {'type': 'array', 'items': {'enum': ['a', 'b', 'c', 'd'], 'type': 'string'}, 'maxItems': 4, 'description': "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': {'type': 'boolean', 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'q': {'type': 'string', 'maxLength': 120, 'description': "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': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Numero massimo di risultati (default 200).'}, 'allegato': {'enum': ['I', 'II', 'III', 'IV'], 'type': 'string', 'description': "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)."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['xml_content'], 'properties': {'xml_content': {'type': 'string', 'maxLength': 64000, 'description': 'Il contenuto XML della fattura elettronica (FatturaPA/SDI).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['xml_content'], 'properties': {'party': {'enum': ['cedente', 'cessionario'], 'type': 'string', 'default': 'cedente', 'description': "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."}, 'xml_content': {'type': 'string', 'maxLength': 64000, 'description': 'Il contenuto XML della fattura elettronica (FatturaPA/SDI). Il .p7m va scompattato prima: qui si accetta XML testuale.'}, 'expected_country': {'type': 'string', 'maxLength': 2, 'description': "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."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 80, 'minLength': 2, 'description': "Attività da cercare, in italiano (es. 'fotografo', 'idraulico', 'consulenza informatica')."}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Numero massimo di risultati (default 20).'}, 'section': {'type': 'string', 'pattern': '^[A-Ua-u]$', 'description': 'Filtra per sezione ATECO (lettera A–U, es. J = servizi di informazione e comunicazione, M = attività professionali). Opzionale.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['codice_fiscale'], 'properties': {'codice_fiscale': {'type': 'string', 'maxLength': 32, 'description': 'Il Codice Fiscale da validare (es. RSSMRA85T10A562S).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['iban'], 'properties': {'iban': {'type': 'string', 'maxLength': 64, 'description': "L'IBAN da validare (es. IT60X0542811101000000123456)."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['partita_iva'], 'properties': {'partita_iva': {'type': 'string', 'maxLength': 32, 'description': 'La Partita IVA da validare (11 cifre, es. 12345678903).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['email'], 'properties': {'email': {'type': 'string', 'maxLength': 254, 'description': "L'indirizzo PEC da validare (es. mario.rossi@pec.it)."}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'required': ['iban']}, {'required': ['vat_number']}, {'required': ['codice_fiscale']}], 'required': [], 'properties': {'iban': {'type': 'string', 'maxLength': 64, 'description': 'IBAN del beneficiario (es. IT60X0542811101000000123456).'}, 'ateco': {'type': 'string', 'pattern': '^[0-9.]{1,12}$', 'maxLength': 12, 'description': 'Codice ATECO dichiarato del fornitore (solo cifre e punti, opzionale).'}, 'vat_number': {'type': 'string', 'maxLength': 32, 'description': 'Partita IVA con o senza prefisso paese (es. IT12345678901).'}, 'expected_name': {'type': 'string', 'maxLength': 140, 'description': 'Ragione sociale attesa del fornitore, confrontata con quella ufficiale VIES.'}, 'codice_fiscale': {'type': 'string', 'maxLength': 32, 'description': 'Codice Fiscale (persona fisica / ditta individuale).'}, 'expected_country': {'type': 'string', 'maxLength': 2, 'description': 'Paese atteso del fornitore in ISO2 (default IT). Un IBAN estero è il campanello #1 della frode.'}}, 'additionalProperties': False}