--- title: "F24 Precompilato (righe Erario / INPS / IMU)" method: POST path: "/python/italian/f24/compose" tags: ["Tool"] --- # F24 Precompilato (righe Erario / INPS / IMU) `POST /python/italian/f24/compose` ## Request - Base URL: `https://imperioutils.com/api` - URL: `https://imperioutils.com/api/python/italian/f24/compose` - Auth: API key in header `X-API-Key` 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. Costo: **0 crediti**. Autenticazione: header `X-API-Key` (una chiave gratuita si ottiene da https://imperioutils.com/signup e si rigenera da https://imperioutils.com/settings/profile). La stessa operazione è provabile **senza account** su `POST /registry/demo/f24-precompilato` con `action: "compose"`. ## Request body - object - `kind` 'forfettario' | 'imu' | 'bollo', required: 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` union: 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. - object - `trimestre` integer, required: Trimestre solare di riferimento (1-4). Determina il codice tributo: 2521 = primo trimestre, 2522 = secondo trimestre, 2523 = terzo trimestre, 2524 = quarto trimestre. - `anno` integer, required: Anno delle fatture (es. 2026). NB: il IV trimestre si versa entro il 28 febbraio dell'anno SUCCESSIVO. - `numero_fatture` integer, required: Quante fatture del trimestre sono soggette a bollo (2,00 € ciascuna). Alternativo a `importo`: fornire almeno uno dei due. - `importo` number: 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. - `importo_trimestri_precedenti` number: 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. - object - `trimestre` integer, required: Trimestre solare di riferimento (1-4). Determina il codice tributo: 2521 = primo trimestre, 2522 = secondo trimestre, 2523 = terzo trimestre, 2524 = quarto trimestre. - `anno` integer, required: Anno delle fatture (es. 2026). NB: il IV trimestre si versa entro il 28 febbraio dell'anno SUCCESSIVO. - `numero_fatture` integer: Quante fatture del trimestre sono soggette a bollo (2,00 € ciascuna). Alternativo a `importo`: fornire almeno uno dei due. - `importo` number, required: 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. - `importo_trimestri_precedenti` number: 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. - `forfettario` object: Richiesto quando kind='forfettario'. Campi dall'output di calc_forfettario. - `imposta` number, required: Imposta sostitutiva dovuta in euro — calc_forfettario → imposta_sostitutiva.importo. - `gestione_inps` 'gestione_separata' | 'artigiani' | 'commercianti' | 'cassa_privata': 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_fisso` number: Contributi INPS sul minimale/fisso in euro — calc_forfettario → contributi_inps.fisso. - `inps_variabile` number: Contributi INPS sull'eccedenza in euro — calc_forfettario → contributi_inps.variabile. - `inps_totale` number: Totale contributi INPS in euro — calc_forfettario → contributi_inps.importo. Usato solo se fisso/variabile non sono forniti. - `startup` boolean: Aliquota startup 5% (nuova attività): nel 1° anno solo saldo, niente acconti. - `anno` integer, required: Anno d'imposta di riferimento (es. 2026). - `imu` object: Richiesto quando kind='imu'. Campi dall'output di calc_imu. - `imu_dovuta` number, required: IMU annua dovuta in euro — calc_imu → imu_dovuta. - `acconto` number, required: Acconto di giugno in euro — calc_imu → acconto_giugno. - `saldo` number, required: Saldo di dicembre in euro — calc_imu → saldo_dicembre. - `base_imponibile` number: Base imponibile in euro — calc_imu → base_imponibile. Serve allo split del gruppo D. - `aliquota_permille` number: Aliquota deliberata dal Comune in per mille — calc_imu → parametri.aliquota_permille. Serve allo split gruppo D (7,6‰ Stato + eccedenza Comune). - `tipo_immobile` 'abitazione_principale_A1_A8_A9' | 'abitazione_non_principale' | 'immobile_produttivo' | 'immobile_locato_canone_concordato' | 'comodato_uso_parenti' | 'terreno_agricolo' | 'area_edificabile', required: Tipo immobile — calc_imu → parametri.tipo_immobile. Determina il codice tributo IMU. - `categoria_catastale` 'A' | 'A10' | 'B' | 'C1' | 'C2_C6_C7' | 'C3_C4_C5' | 'D' | 'D5' | 'E' | 'F': Categoria catastale (default A) — calc_imu → parametri.categoria_catastale. - `codice_comune` string, required: Codice catastale/Belfiore del Comune = codice ente F24 (1 lettera + 3 cifre, es. H501 per Roma). - `anno` integer, required: Anno d'imposta di riferimento (es. 2026). ## Response `200` Il JSON dello strumento, restituito così com'è. ## Other responses - `401`: Nessuna credenziale o chiave rifiutata. Il corpo porta `details.header`, `details.docs` e `details.get_key`. - `402`: Crediti esauriti. - `429`: Tetto di richieste al minuto del piano superato. --- [API](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane.md) · [All operations](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane/llms.txt) · [OpenAPI document](https://skmtc.dev/imperioutils/apis/imperio-utilities-api-fiscali-italiane/revisions/4b7a05d52f6c?raw)