Fattura24

# Account Consumi MCP Restituisce le informazioni sui limiti di utilizzo e lo stato delle chiamate MCP per l'account corrente. ## Parametri Nessuno. ## Output Restituisce un JSON con: - `ambiente` - Ambiente corrente (produzione / sandbox) - `piano_abilitato` - Se il piano di abbonamento corrente consente l'uso del connettore MCP - `limite_giorni_mese` - Numero massimo di giorni di utilizzo del connettore nel mese corrente previsti dal piano (null se illimitato) - `giorni_utilizzati_mese` - Numero di giorni distinti, nel mese corrente, in cui il connettore è stato usato - `giorni_residui_mese` - Numero di giorni di utilizzo ancora disponibili questo mese (-1 se illimitato) - `messaggio` - Messaggio esplicativo se il piano non è abilitato o il limite mensile è stato raggiunto (null altrimenti) - `intervallo` - Periodo di riferimento del conteggio - `dal` - Primo giorno del mese corrente (formato YYYY-MM-DD) - `al` - Timestamp dell'ultima chiamata registrata nel mese corrente (null se nessuna chiamata)

# Account Dettagli Recupera i dati dell'account e del profilo dell'utente autenticato. ## Parametri Nessuno. ## Output Restituisce un JSON con: - `nome` - Nome - `cognome` - Cognome - `id_profilo_utente` - ID utente - `tipo_utente` - Tipo utente (amministratore / collaboratore) - `tipo_abbonamento` - Tipo abbonamento (standard / Professional / Business / Complete) - `email` - Email - `ragione_sociale` - Ragione sociale - `codice_fiscale` - Codice fiscale - `denominazione` - Partita IVA - `ufficio` - Oggetto con indirizzo, citta, cap, provincia, paese - `data_creaz` - Data creazione (dd/MM/yyyy) - `scad_account` - Data scadenza account (dd/MM/yyyy) - solo se valorizzata - `scaduto_in_data` - Data scaduto (dd/MM/yyyy) - solo se valorizzata

# Dettaglio singolo esito SdI Recupera il contenuto di **un singolo** esito/notifica SdI di un documento elettronico, identificato dal suo nome file. È un tool di dettaglio, complementare a `ricerca_esito_sdi`: prima usa `ricerca_esito_sdi` per ottenere la cronologia degli esiti di un documento (con i relativi nomi file), poi usa questo tool per leggere il dettaglio di uno specifico esito. ## Quando usarlo - l'utente vuole approfondire un singolo esito già individuato (ad esempio una ricevuta di scarto `NS`) per leggerne codici e motivi di errore; - serve il dettaglio di una specifica notifica dell'Agenzia delle Entrate per un documento elettronico. ## Quando non usarlo - per ottenere l'elenco/cronologia degli esiti di un documento: usa `ricerca_esito_sdi`; - per cercare documenti per anno, stato o tipo: usa `ricerca_documenti`. ## Parametri - **id_documento** (obbligatorio): ID del documento in Fattura24 (es. `1234567`) - **file_name_esito** (obbligatorio): nome del file dell'esito da recuperare (es. `IT123456789_1B8h8_NS_001.xml`), tipicamente ottenuto da `ricerca_esito_sdi` ## Esempio di utilizzo ```json { "id_documento": "1234567", "file_name_esito": "IT123456789_1B8h8_NS_001.xml" } ``` ## Output Restituisce il contenuto dell'esito richiesto in formato JSON. Per il significato dei diversi tipi di ricevuta (NS, RC, MC, NE, DT, AT) vedi la descrizione del tool `ricerca_esito_sdi`.

# Report Analisi IVA Restituisce, mese per mese, l’IVA sulle vendite (IVA a debito) e sugli acquisti (IVA a credito) per l’anno indicato, in formato JSON. ## Quando usarlo Usa questo tool quando l'utente chiede: - l'analisi o il riepilogo dell'IVA dell'anno - l'andamento mensile dell'IVA su entrate e uscite - il confronto tra IVA a debito e IVA a credito ## Esempi di richieste utente - "Mostrami l'analisi IVA del 2026" - "Quanta IVA ho a debito e a credito quest'anno?" - "Andamento mensile dell'IVA su vendite e acquisti 2026" - "Ci sono mesi con differenze rilevanti tra IVA a debito e a credito?" ## Quando non usarlo - per la liquidazione IVA o gli adempimenti: il tool è solo di consultazione - per ricavi, costi e margini: usa `report_bilancino` ## Parametri - **anno**: Anno di riferimento (es. "2026") - **esigibilita**: Tipo di esigibilità IVA da considerare. Valori ammessi: - `qualsiasi`: considera qualsiasi tipo di esigibilità - `solo_split_payment`: considera solo le operazioni in split payment (scissione dei pagamenti) ## Esempio di risposta ```json [ { "tipo": "entrate", "mese": 1, "importo": 1234.56 }, { "tipo": "uscite", "mese": 1, "importo": 789.01 } ]

Restituisce l'analisi geografica delle vendite per anno, aggregata per città, provincia, regione o paese. Usa questo tool quando l'utente vuole visualizzare la distribuzione geografica dei clienti o analizzare le vendite per territorio. ## Parametri - **anno** Anno di riferimento (es: 2026) - **raggruppa_per** Livello di aggregazione geografica: - `"Città"` = dettaglio massimo, con coordinate GPS - `"Provincia"` = aggregazione per provincia italiana - `"Regione"` = aggregazione per regione/area geografica - `"Paese"` = solo nazione, senza coordinate ## Esempi di richieste utente:** - Mostrami la mappa delle vendite 2026 per città - Quali sono le province con più clienti nel 2025? - Analisi geografica delle vendite 2026 per regione - Distribuzione geografica clienti 2025 (tutti i risultati senza paginazione) ## Non usare per: - report temporali comparativi (ultimi anni) - analisi per prodotto o servizio - dettaglio singola fattura

# Report Bilancino Restituisce il report analitico del bilancino di conto economico per l'anno richiesto. Questo strumento consente di analizzare, sulla base del Piano dei Conti, l'andamento di: - ricavi - costi variabili - costi fissi - costi totali - margine di contribuzione (MDC) - EBITDA I valori sono calcolati sui documenti fiscali collegati alle voci del Piano dei Conti e sulle buste paga. Sono considerati gli imponibili; i tributi sono esclusi. Per le buste paga viene considerato il valore lordo. ## Quando usarlo Usa questo tool quando l'utente chiede: - il bilancino dell'anno - l'andamento mensile di ricavi e costi - il totale progressivo di ricavi, costi, MDC o EBITDA - un'analisi del conto economico basata sul Piano dei Conti - il dettaglio per voce di ricavo o di costo ## Quando non usarlo Non usarlo per: - elencare singole fatture o documenti - analisi per cliente, prodotto o fornitore - confronto tra budget e actual - modifica o salvataggio dei budget ## Parametri input - **anno**: anno di competenza nel formato YYYY ## Struttura risposta La risposta deve essere JSON con questa struttura logica: - `meta` - `dettagli` - `totali` - `indicatori` ## Meta Contiene informazioni di contesto: - `report`: `bilancino_analitico` - `anno` - `valuta` ## Dettagli Array di righe analitiche. Ogni riga rappresenta una voce del Piano dei Conti. Campi consigliati per ogni riga: - `id_pdc` - `codice_pdc` - `descrizione_pdc` - `tipo_voce` - `totale_consuntivo_annuale` - `consuntivo_mensile` Valori ammessi per `tipo_voce`: - `ricavo` - `costo_fisso` - `costo_variabile` Struttura di `consuntivo_mensile`: - `gennaio` - `febbraio` - `marzo` - `aprile` - `maggio` - `giugno` - `luglio` - `agosto` - `settembre` - `ottobre` - `novembre` - `dicembre` ## Totali Oggetto con i totali progressivi annuali e mensili delle macro-voci: - `totale_ricavi` - `totale_costi_variabili` - `totale_costi_fissi` - `totale_costi` - `mdc` - `ebitda` Ogni macro-voce dovrebbe avere questa forma: - `totale_annuale` - `mensile` ## Indicatori Oggetto opzionale con indicatori sintetici già pronti per l'LLM: - `rapporto_costi_variabili_su_ricavi` - `rapporto_mdc_su_ricavi` - `rapporto_ebitda_su_ricavi` ## Note di modellazione - Usa chiavi JSON in snake_case, senza spazi. - Preferisci nomi semantici stabili e leggibili da un agente MCP. - Per i valori mensili usa sempre i nomi completi dei mesi in italiano. - I valori mensili di ogni voce sono calcolati a sé stanti: non rappresentano un cumulato progressivo. ## Esempio di struttura ```json { "meta": { "report": "bilancino_analitico", "anno": 2026, "filtro_pdc_descrizione": null, "costi_fissi_in_dodicesimi": true, "valuta": "EUR" }, "dettagli": [ { "id_pdc": 211235, "codice_pdc": "000", "descrizione_pdc": "TEST FEDE2", "tipo_voce": "ricavo", "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": { "gennaio": 0.0, "febbraio": 0.0, "marzo": 0.0, "aprile": 0.0, "maggio": 0.0, "giugno": 0.0, "luglio": 0.0, "agosto": 0.0, "settembre": 0.0, "ottobre": 0.0, "novembre": 0.0, "dicembre": 0.0 } } ], "totali": { "totale_ricavi": { "totale_annuale": 0.0, "mensile": {} }, "totale_costi_variabili": { "totale_annuale": 0.0, "mensile": {} }, "totale_costi_fissi": { "totale_annuale": 0.0, "mensile": {} }, "totale_costi": { "totale_annuale": 0.0, "mensile": {} }, "mdc": { "totale_annuale": 0.0, "mensile": {} }, "ebitda": { "totale_annuale": 0.0, "mensile": {} } }, "indicatori": { "rapporto_costi_variabili_su_ricavi": 0.0, "rapporto_mdc_su_ricavi": 0.0, "rapporto_ebitda_su_ricavi": 0.0 } }

# Churn rate - Tasso di abbandono clienti Il **Churn rate** rientra nella categoria dei KPI (*Key Performance Indicator*), indicatori utilizzati per monitorare l’andamento dei processi aziendali e valutare lo stato di salute del business. Il churn rate misura la percentuale di clienti che interrompono il rapporto con l’azienda in un determinato periodo temporale. L’analisi di questo indicatore consente di identificare eventuali livelli critici di perdita clienti e supporta decisioni gestionali finalizzate alla riduzione del tasso di abbandono. ## Quando usarlo Usa questo tool quando l'utente chiede del **tasso di abbandono dei clienti** in un periodo, ad esempio: - quanti clienti ha perso - qual è il suo churn rate - come è cambiata la base clienti tra inizio e fine periodo ## Esempi di richieste utente - "Qual è il mio tasso di abbandono clienti nel 2026?" - "Quanti clienti ho perso quest'anno?" - "Calcola il churn rate degli ultimi 12 mesi" ## Parametri Questo tool non richiede parametri di input: il periodo di analisi è determinato automaticamente dal connettore e non è selezionabile. L'intervallo effettivamente considerato viene restituito nei campi `data_da` e `data_a` della risposta. ## Dati restituiti Il tool restituisce un oggetto JSON contenente: * Intervallo temporale analizzato (`data_da`, `data_a`) * Numero di clienti presenti all’inizio del periodo * Numero di clienti presenti alla fine del periodo * Numero di clienti persi nel periodo * Percentuale di churn rate sul periodo ## Logica di calcolo I valori vengono determinati considerando: * Clienti attivi all’inizio del periodo * Clienti attivi alla fine del periodo * Differenza tra i due valori, corrispondente ai clienti persi La percentuale di churn viene calcolata come: `(clienti_persi / clienti_iniziali) * 100` ## Finalità Il JSON restituito può essere utilizzato per: * Dashboard KPI * Analisi di controllo di gestione * Monitoraggio della retention clienti * Integrazioni applicative e workflow automatizzati

# Report Fatturato Questo tool è di tipo aggregato e restituisce un report che mostra diversi valori relativi a quello che è stato l'andamento dell'attività dell'utente nel corso dell'anno specificato, su base mensile. I dati più importanti mostrati sono quelli relativi al fatturato, ovverosia agli importi oggetto delle fatture di vendita e di acquisto emesse e ricevute dall'utente; vengono però mostrati anche altri diversi e importanti valori (te lo spiego meglio poco più avanti). L'output è un array JSON di 12 elementi, uno per ciascun mese dell'anno; ogni elemento ha diverse voci, ognuna con un suo significato. Se in un particolare anno non vi sono dati nell'account dell'utente, la response di questo tool restituirà comunque un array di 12 elementi, con tutte le props con valori pari a zero. ## Premesse fondamentali sul contenuto e sul significato delle voci restituite dal report La response di questo tool contiene, per ogni item della lista di risposta, le voci che ti indico di seguito; per farti capire meglio il loro significato, te le suddivido per gruppi. Devi sempre far presente all'utente il significato delle diverse voci, soprattutto se è l'utente stesso a chiederti delucidazioni sul significato di alcune voci o di importi oggetto di questo tool. ### Voci relative ai dati di "fatturato" Queste voci sono le stesse che l'utente può vedere nel Report chiamato "Fatturato" presente nel suo account in Fattura24. Le voci sono: - vendite_imponibile: costituisce la somma degli importi (al netto di IVA) delle righe-documento (contenute nei documenti di vendita) classificate dallo stesso utente in Fattura24 come "imponibili reddito" (ai fini irpef/ires), ivi incluse quelle con Iva allo 0%; - vendite_non_imponibile: costituisce invece la somma degli importi (al netto di IVA) delle righe-documento (contenute nei documenti di vendita) classificate dallo stesso utente in Fattura24 come "NON imponibili reddito" (ai fini irpef/ires); - vendite_inps: costituisce la somma dei contributi integrativi Inps (al netto di IVA) caricati dall'utente nei documenti di vendita a titolo di rivalsa Inps; - vendite_cassa: costituisce la somma dei contributi integrativi per Cassa privata (al netto di IVA) caricati dall'utente nei documenti di vendita (ad esempio, per la Cassa forense); - acquisti_imponibile: costituisce la somma degli importi (al netto di IVA) delle buste paga e delle righe-documento (contenute nei documenti di acquisto) classificate come "imponibili reddito" (ai fini irpef/ires), ivi incluse quelle con Iva allo 0%; - acquisti_non_imponibile: costituisce invece la somma degli importi (al netto di IVA) delle righe-documento (contenute nei documenti di acquisto) classificate come "NON imponibili reddito" (ai fini irpef/ires); - acquisti_inps: costituisce la somma dei contributi integrativi Inps (al netto di IVA) caricati dai fornitori nei documenti di acquisto a titolo di rivalsa Inps; - acquisti_cassa: costituisce la somma dei contributi integrativi per Cassa privata (al netto di IVA) caricati dai fornitori nei documenti di acquisto (ad esempio, per la Cassa forense). Queste voci appena descritte possono essere sommate per individuare il totale onnicomprensivo del "fatturato", sia lato vendite, sia lato acquisti (sempre al netto di IVA, si intende). Gli importi mostrati: - sono al netto delle note di credito emesse nel periodo; - sono considerati per il solo fatto di essere presenti in documenti di vendita o di acquisto (o buste paga), a prescindere quindi se sono stati effettivamente pagati o meno. Gli importi considerati da Fattura24 per comporre queste voci sono quelli contenuti nei documenti di vendita e di acquisto/costo seguenti: - fatture e parcelle; - ricevute; - note di credito; - corrispettivi; - buste paga. Per comporre queste voci, non sono considerati invece gli importi relativi alle regitrazioni che l'utente ha fatto nella sezione Tributi di Fattura24. ### Voci accessorie relative agli "incassi", ai "pagamenti" monetari "effettivi" e all'iva Nella response del tool trovi anche delle voci che non riguardano per nulla il concetto di "fatturato", ma che sono molto importanti per l'utente per capire quale è la situazione della sua attività sotto il profilo della "cassa". Queste voci sono: - vendite_entrate: costituisce la somma degli incassi realmente conseguiti dall'utente, costituiti dai pagamenti che hanno effettuato i suoi clienti; - acquisti_uscite: costituisce la somma dei pagamenti effettuati dall'utente a favore dei suoi fornitori; - buste_paga_uscite: costituisce la somma dei pagamenti effettuati dall'utente a favore dei suoi dipendenti; - tributi_uscite: costituisce la somma dei pagamenti effettuati dall'utente in relazione alle registrazioni che lo stesso utente ha effettuato nella sezione Tributi di Fattura24. Queste voci sono dunque relative a importi che, proprio perché relativi a movimenti reali di cassa, devono essere intesi comprensivi di IVA. Mostra questi valori solo se l'utente te lo chiede espressamente. ### Altre voci accessorie La response di questo tool ritorna poi, ancora, altre voci accessorie, che non riguardano per nulla il concetto di "fatturato", ma che possono comunque essere utili all'utente per visualizzare dati importanti relativi alla sua attività. Le voci sono: - vendite_ra: la somma delle ritenute di acconto caricate dall'utente nei suoi documenti di vendita; - vendite_rp: la somma delle ritenute previdenziali caricate dall'utente nei suoi documenti di vendita; - acquisti_ra: la somma delle ritenute di acconto lato-acquisti, caricate dai fornitori dell'utente nelle loro fatture; - acquisti_rp: la somma delle ritenute previdenziali lato-acquisti, caricate dai fornitori dell'utente nelle loro fatture. - tributi: la somma degli importi delle registrazioni che l'utente ha effettuato nella sezione Tributi di Fattura24, a prescindere se gli stessi sono stati segnati come pagati o no. Mostra questi valori solo se l'utente te lo chiede espressamente. ### Altre voci accessorie non utilizzabili e che non devi mai considerare La response di questo tool ritorna infine altre voci accessorie, che non solo non riguardano per nulla il concetto di "fatturato", ma che non devi mai riferire o riportare all'utente e che non devi mai prendere in. considerazione per rispondere a domande dell'utente: in sostanza, devi considerare come se non facessero parte per nulla di questo tool (i motivi sono sia tecnici, sia legati al fatto che esistono altri tool speciali). Queste voci sono: - vendite_imponibile_fe; - vendite_non_imponibile_fe; - vendite_iva; - acquisti_iva. Se l'utente chiede specificamente informazioni o dati di riepilogo relativi alle sole fatture elettroniche (escludendo quindi altri tipi di documenti, come le ricevute, le fatture analogiche o i corrispettivi), devi riferire che questo tool non restituisce questo tipo di dati e che semmai l'utente può utilizzare il diverso tool `ricerca_documenti`. Se l'utente chiede invece, specificamente, i dati dell'IVA relativa alle vendite e agli acquisti registrati su Fattura24, devi, come detto, far presente che non fanno parte di questo tool e consigliare l'utente di usare il tool `report_analisi_iva`. ## Criterio temporale Sotto il profilo del criterio temporale utilizzato, i documenti considerati da Fattura24 per estrarre i dati sono quelli che, al loro interno (nel campo Competenza), hanno lo stesso anno specificato dall'utente nella richiesta che ti formula. ## Come mostrare gli importi La response di questo tool restituisce gli importi sempre in euro, con il punto come separatore decimale; tu presentali all'utente in Euro, ma con la formattazione italiana, usando quindi la virgola come separatore decimale. ## Quando usare questo tool Usa questo tool quando l'utente ti chiede i dati di fatturato di **un singolo anno**, e/o quando ti formula domande del tipo: - l'andamento mensile del fatturato di un anno; - vendite, acquisti e relativo saldo di un anno; - il totale fatturato di un anno con il dettaglio dei 12 mesi. Se l'utente non specifica l'anno, usa l'anno corrente. ## Esempi di richieste che può fare l'utente - "Mostrami il fatturato del 2026"; - "Mostrami il fatturato mese per mese del 2026"; - "Com'è andato il fatturato quest'anno mese per mese?" - "Quanto ho fatturato nel 2026?" - "Qual è stato il mese migliore e quello peggiore del 2026?" ## Quando non usare questo tool Non usare questo tool: - per confrontare più anni o per mostrare il saldo progressivo: in questo caso usa invece il tool `report_fatturato_confronto`; - per elencare singole fatture o documenti: in questo caso usa invece il tool `ricerca_documenti`; - quando l'utente ti chiede di mostrare i suoi ricavi, costi e margini in base alle specifiche voci di Piano dei Conti (centri di ricavo e centri di costo): in questo caso usa invece il tool `report_bilancino`. ## Parametri - **anno**: Anno di riferimento del report (ad esempio, 2026). Come detto, se l'utente non specifica l'anno, usa l'anno corrente. ## Esempio di utilizzo ```json { "anno": "2026" } ## Esempio di output Di seguito trovi l'esempio; è mostrato solo il primo elemento. Il campo "mese" che troverai nei singoli item dell'array sta ad indicare il mese (ad esempio,troverai scritto "GENNAIO". [ { "mese": "GENNAIO", "vendite_imponibile": 5506.82, "vendite_non_imponibile": 0.0, "vendite_imponibile_fe": 0.0, "vendite_non_imponibile_fe": 0.0, "vendite_iva": 1211.5, "vendite_inps": 0.0, "vendite_cassa": 0.0, "vendite_ra": 0.0, "vendite_rp": 0.0, "vendite_entrate": 3000.0, "acquisti_imponibile": 420.0, "acquisti_non_imponibile": 0.0, "acquisti_iva": 92.4, "acquisti_inps": 0.0, "acquisti_cassa": 0.0, "acquisti_ra": 0.0, "acquisti_rp": 0.0, "acquisti_uscite": 250.0, "tributi": 0.0, "buste_paga_uscite": 0.0, "tributi_uscite": 0.0 } ]

# Report Fatturato Confronto Restituisce il report mensile del fatturato per gli anni specificati, con la possibilità di confrontare i dati tra più anni. L'output è un array JSON di 12 elementi, uno per ciascun mese dell'anno, con valori aggregati di fatturato, acquisti, vendite e tributi per ciascun anno richiesto. ## Parametri - **anni**: Lista degli anni separati da virgola, ad esempio 2026,2025,2024 - **tipo_documento**: Filtro opzionale. Valori ammessi: - `vendita`: restituisce solo i campi relativi alle vendite - `acquisto`: restituisce solo i campi relativi agli acquisti - **mostra_saldo_progressivo**: Parametro opzionale. Valori ammessi: - `si`: calcola il saldo progressivo mese per mese - `no`: restituisce i valori mensili aggregati (default) ## Esempio di utilizzo ```json { "anni": "2026, 2025, 2024", "tipo_documento": "vendita", "mostra_saldo_progressivo": "si" } Esempio con solo il 2026: { "anni": "2026" } Esempio con saldo progressivo: { "anni": "2026, 2025", "mostra_saldo_progressivo": "si" } Esempio di output { "mese": [ { "numero": 1, "nome": "Gennaio", "valori": [5506.82, 4200.15, 3800.00] }, { "numero": 2, "nome": "Febbraio", "valori": [4800.50, 3900.25, 4100.75] } ], "legenda": ["2026", "2025", "2024"] }

# Report Forecast Restituisce il report previsionale del bilancino, confrontando valori consuntivi e budget per ciascuna voce del Piano dei Conti. Questo strumento permette di confrontare, per ogni voce del Piano dei Conti: - valori reali (actual) - valori previsionali (budget) - scostamenti tra consuntivo e budget Il report è utile per monitorare nel tempo: - ricavi - costi variabili - costi fissi - costi totali - margine di contribuzione (MDC) - EBITDA L'uso combinato del Piano dei Conti e di questo report consente di confrontare l'andamento reale dell'attività rispetto alle previsioni impostate. ## Fonti dei dati reali Gli importi della parte consuntiva si valorizzano automaticamente sulla base delle voci di Centro di Ricavo e di Centro di Costo create nel Piano dei Conti e applicate ai documenti dell'anno. Sono considerati: - fatture - parcelle - ricevute - corrispettivi - note di credito - buste paga Sono esclusi i tributi. Per le buste paga viene considerato il valore lordo. ## Quando usarlo Usa questo tool quando l'utente chiede: - il report previsionale del bilancino - il confronto tra actual e budget - gli scostamenti tra valori reali e previsionali - il confronto mensile tra consuntivo e budget - il dettaglio per voce PDC con budget associato ## Quando non usarlo Non usarlo per: - elencare singole fatture o documenti - analisi per cliente, prodotto o fornitore - modificare i valori di budget - salvare, cancellare o rigenerare i budget ## Parametri input - **anno**: anno di competenza nel formato YYYY ## Struttura risposta La risposta deve essere JSON con questa struttura logica: - `meta` - `dettagli` - `totali` - `indicatori` ## Meta Contiene informazioni di contesto: - `anno` - `valuta` - `includi_totali` ## Dettagli Array di righe analitiche. Ogni riga rappresenta una voce del Piano dei Conti. Campi consigliati per ogni riga: - `id_pdc` - `codice_pdc` - `descrizione_pdc` - `tipo_voce` - `totale_consuntivo_annuale` - `consuntivo_mensile` - `totale_budget_annuale` - `budget_mensile` - `scostamento_annuale` - `scostamento_mensile` Valori ammessi per `tipo_voce`: - `ricavo` - `costo_fisso` - `costo_variabile` Struttura di `consuntivo_mensile`, `budget_mensile` e `scostamento_mensile`: - `gennaio` - `febbraio` - `marzo` - `aprile` - `maggio` - `giugno` - `luglio` - `agosto` - `settembre` - `ottobre` - `novembre` - `dicembre` ## Totali Oggetto con i totali aggregati delle macro-voci: - `totale_ricavi` - `totale_costi_variabili` - `totale_costi_fissi` - `totale_costi` - `mdc` - `ebitda` Ogni macro-voce dovrebbe avere questa forma: - `totale_consuntivo_annuale` - `consuntivo_mensile` - `totale_budget_annuale` - `budget_mensile` - `scostamento_annuale` - `scostamento_mensile` ## Indicatori Oggetto opzionale con indicatori sintetici già pronti per l'LLM: - `scostamento_ricavi_su_budget` - `scostamento_costi_su_budget` - `scostamento_ebitda_su_budget` ## Note di modellazione - Usa chiavi JSON in snake_case, senza spazi. - Preferisci nomi semantici stabili e leggibili da un agente MCP. - Per i valori mensili usa sempre i nomi completi dei mesi in italiano. - Tra `budget_mensile` e `totale_budget_mensile` è preferibile `budget_mensile`, perché rappresenta il dettaglio dei 12 mesi e non un singolo totale. - I valori mensili di ogni voce sono calcolati a sé stanti: non rappresentano un cumulato progressivo. ## Esempio di struttura ```json { "meta": { "report": "bilancino_previsionale", "anno": 2026, "filtro_pdc_descrizione": null, "costi_fissi_in_dodicesimi": true, "valuta": "EUR" }, "dettagli": [ { "id_pdc": 211235, "codice_pdc": "000", "descrizione_pdc": "TEST FEDE2", "tipo_voce": "ricavo", "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": { "gennaio": 0.0, "febbraio": 0.0, "marzo": 0.0, "aprile": 0.0, "maggio": 0.0, "giugno": 0.0, "luglio": 0.0, "agosto": 0.0, "settembre": 0.0, "ottobre": 0.0, "novembre": 0.0, "dicembre": 0.0 }, "totale_budget_annuale": 0.0, "budget_mensile": { "gennaio": 0.0, "febbraio": 0.0, "marzo": 0.0, "aprile": 0.0, "maggio": 0.0, "giugno": 0.0, "luglio": 0.0, "agosto": 0.0, "settembre": 0.0, "ottobre": 0.0, "novembre": 0.0, "dicembre": 0.0 }, "scostamento_annuale": 0.0, "scostamento_mensile": { "gennaio": 0.0, "febbraio": 0.0, "marzo": 0.0, "aprile": 0.0, "maggio": 0.0, "giugno": 0.0, "luglio": 0.0, "agosto": 0.0, "settembre": 0.0, "ottobre": 0.0, "novembre": 0.0, "dicembre": 0.0 } } ], "totali": { "totale_ricavi": { "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": {}, "totale_budget_annuale": 0.0, "budget_mensile": {}, "scostamento_annuale": 0.0, "scostamento_mensile": {} }, "totale_costi_variabili": { "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": {}, "totale_budget_annuale": 0.0, "budget_mensile": {}, "scostamento_annuale": 0.0, "scostamento_mensile": {} }, "totale_costi_fissi": { "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": {}, "totale_budget_annuale": 0.0, "budget_mensile": {}, "scostamento_annuale": 0.0, "scostamento_mensile": {} }, "totale_costi": { "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": {}, "totale_budget_annuale": 0.0, "budget_mensile": {}, "scostamento_annuale": 0.0, "scostamento_mensile": {} }, "mdc": { "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": {}, "totale_budget_annuale": 0.0, "budget_mensile": {}, "scostamento_annuale": 0.0, "scostamento_mensile": {} }, "ebitda": { "totale_consuntivo_annuale": 0.0, "consuntivo_mensile": {}, "totale_budget_annuale": 0.0, "budget_mensile": {}, "scostamento_annuale": 0.0, "scostamento_mensile": {} } }, "indicatori": { "scostamento_ricavi_su_budget": 0.0, "scostamento_costi_su_budget": 0.0, "scostamento_ebitda_su_budget": 0.0 } }