Imperio — Italian Tax & Compliance Tools

{
  "type": "object",
  "allOf": [
    {
      "if": {
        "not": {
          "required": [
            "comune"
          ]
        }
      },
      "then": {
        "required": [
          "aliquota_permille"
        ]
      }
    }
  ],
  "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": [],
  "properties": {
    "anno": {
      "type": "integer",
      "maximum": 2100,
      "minimum": 2025,
      "description": "Anno d'imposta del verdetto per comune (default l'anno in corso). Solo con `comune`."
    },
    "comune": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "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": {
      "type": "string",
      "maxLength": 120,
      "minLength": 2,
      "description": "Solo comuni fusi con aliquote differenziate: l'ex comune dove sta l'immobile. Se serve e manca, la risposta elenca quelli possibili."
    },
    "provincia": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Sigla della provincia, per i comuni omonimi (es. TO). Solo con `comune`."
    },
    "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‰). OBBLIGATORIA se non indichi `comune`; con tutti e due vince questa, e la risposta dice se differisce dal prospetto."
    },
    "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",
  "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 (1-4). Determina il codice tributo: 2521 = primo trimestre, 2522 = secondo trimestre, 2523 = terzo trimestre, 2524 = quarto trimestre."
        },
        "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": "Primo anno di attività: nessun acconto, si versa solo il saldo. Non è l'aliquota del 5% (che vale cinque anni): qui l'imposta arriva già calcolata."
        },
        "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 le causali INPS (PXX = Gestione Separata senza altra copertura; AF = artigiani sul minimale, AP = artigiani sull'eccedenza; CF = commercianti sul minimale, CP = commercianti sull'eccedenza). Con cassa_privata nessuna riga INPS: i contributi non si versano in F24."
        },
        "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": [
    "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": [
    "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": [
    "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",
  "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
}