Fattura24
Collega il tuo account Fattura24 a ChatGPT e interroga i tuoi dati gestionali e contabili in linguaggio naturale, senza aprire report, navigare tra sezioni o costruire analisi manuali. Se usi Fattura24, hai già tutti i dati che ti servono: fatturato, incassi, pagamenti, IVA, margini. Il problema è che usarli richiede tempo. Con il connettore MCP, quella parte sparisce: scrivi una domanda, ricevi l'analisi.
- Integration type
- Plugin
- Verification status
- Not applicable
- Platform
- ChatGPT
- Primary Subcategory
- Accounting & Bookkeeping
- Secondary Subcategories
- None listed
- Brand
- Fattura24
- Access
- Account required
- First tracked
- 2026-06-24
- Tool count
- 16
- Geography
- US
The Primary Subcategory used for this profile’s headline score.
Other Subcategories where the Integration is visible.
ChatGPT Plugin Discoverability Score
ChatGPT organic discovery is not live yet
Fattura24 is tracked in the ChatGPT Plugin registry. Public organic-discovery measurement is not live for ChatGPT yet, so there is no score to publish today.
Get notified when your score goes live
Enter your work email and we’ll notify you when ChatGPT Plugin organic discovery scoring launches.
No spam. Unsubscribe any time.
Competing in ChatGPT Accounting & Bookkeeping
View CategoryHow the Discoverability Score works
Organic discovery scoring for Fattura24 on ChatGPT is not live yet. The score will use measured agent conversations when it launches.
Organic discovery scoring is pending. Your Plugin score will appear on this scale when measurement goes live.
FoundDiagnostic
Whether Claude found your Plugin in connector search. It must be Found before it can reach the picker, but the score counts picker appearances—not search results.
PickedMain score
How often your Plugin appeared in the picker, or Claude invoked it directly, across contested conversations. This percentage is the Discoverability Score; the headline number is rounded.
PositionedDiagnostic
What position your Plugin appeared in when it was shown in the picker. This shows prominence, but it does not affect the score.
16 tools agents can invoke
# 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. ## 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 relative agli "incassi" e ai "pagamenti" monetari "effettivi" 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; - bustePagaUscite: costituisce la somma dei pagamenti effettuati dall'utente a favore dei suoi dipendenti; - tributiUscite: 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. ### Altre voci La response di questo tool ritorna infine 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. ## 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. ## 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. ## 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 cbhiede di mostrare i suoi ricavi, costi e margini in base alle voci di Piano dei Conti (centri di ricavo e di costo): in questo caso usa invece il tool `report_bilancino` ## Parametri - **anno**: Anno di riferimento del report (es. 2026) ## Esempio di utilizzo ```json { "anno": "2026" } Esempio di output [ { "numero": 1, "vendite_imponibile": 5506.82, "vendite_nonImponibile": 0.0, "vendite_imponibile_fe": 0.0, "vendite_nonImponibile_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_nonImponibile": 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 } }
Restituisce il report comparativo dei pagamenti mensili per gli anni richiesti. Usa questo tool quando l’utente vuole confrontare i pagamenti tra più anni o analizzare l’andamento mensile degli incassi o dei pagamenti. Parametri: - anni Lista degli anni separati da virgola, ad esempio: `2026, 2025, 2024` - tipo_documento `"vendita"` = incassi / pagamenti in entrata da fatture di vendita `"acquisto"` = pagamenti in uscita per fatture di acquisto - mostra_saldo_progressivo `si` = saldo cumulato mese per mese `no` = valori mensili del singolo mese Esempi di richieste utente: - Mostrami il report dei pagamenti degli ultimi anni - Confronta i pagamenti 2026, 2025 e 2024 - Dammi il saldo progressivo degli incassi degli ultimi tre anni - Confronta i pagamenti 2025 vs 2024 mese per mese
# Report Pareto ## Descrizione Questo tool consente di sapere quanti clienti sono stati necessari per generare l’80% del fatturato, mese per mese, nel corso dell’anno. Si tratta di un’analisi di tipo Pareto, nota anche come regola dell’80/20, basata sulla constatazione che, in molti contesti aziendali, l’80% del fatturato deriva generalmente da una minoranza dei clienti (costituita, ad esempio, da una percentuale intorno al 20%). Conoscere e comprendere questa informazione ti permette di valutare il livello di dipendenza economica da alcuni clienti chiave e, di conseguenza, di capire quanto il tuo business sia robusto oppure fragile. Maggiore è il numero di clienti che concorre all’80% del fatturato, maggiore è la stabilità economica della tua attività e quindi il suo grado di robustezza. ### Esempio Se hai 10 clienti e 2 di questi hanno generato l’80% del tuo fatturato, il tuo business potrebbe essere considerato fragile, perché la perdita anche di un solo cliente chiave comporterebbe un calo di circa il 40% del fatturato. --- ## Quando usarlo Usa questo tool quando l'utente chiede della **concentrazione del fatturato sui clienti** o della regola 80/20, ad esempio: - quanti clienti generano l'80% del fatturato - quanto il business dipende da pochi clienti chiave - se il portafoglio clienti è concentrato o ben distribuito ## Esempi di richieste utente - "Quanti clienti fanno l'80% del mio fatturato?" - "Il mio fatturato dipende da pochi clienti?" - "Analisi di Pareto dei clienti per il 2026" - "Quanto è concentrato il mio fatturato sui clienti?" --- # Come funziona il tool Selezionato l’anno di interesse, il sistema calcolerà automaticamente, per ciascun mese dell’anno: * il fatturato totale del mese * il numero minimo di clienti necessario per generare almeno l’80% del fatturato * la percentuale di clienti (sul totale dei clienti del mese) necessaria a raggiungere l’80% del fatturato, ovvero il vero e proprio indice di Pareto --- # Input MCP ## Parametri richiesti | Campo | Tipo | Descrizione | | ----- | ------- | -------------------------------------------- | | anno | integer | Anno di riferimento per l’analisi del report | --- # Output del report Per ogni mese dell’anno selezionato, il report mostrerà: * mese di riferimento * fatturato totale * numero clienti necessari per raggiungere l’80% del fatturato * numero totale clienti del mese * percentuale Pareto clienti/fatturato --- # Obiettivo del report Il report aiuta a: * identificare la concentrazione del fatturato * individuare eventuali clienti strategici * misurare il livello di rischio commerciale * comprendere la robustezza economica del business * monitorare nel tempo la distribuzione del fatturato
## Report Prodotti/Servizi Restituisce l’elenco dei prodotti e servizi venduti dall’utente in un determinato anno, con quantità e importo totale aggregati. ## Quando usarlo Usa questo tool quando l'utente chiede informazioni sui **prodotti o servizi venduti** in un anno, ad esempio: - quali prodotti o servizi hanno generato più fatturato - quali prodotti o servizi sono stati più venduti per quantità - il dettaglio di vendite per un prodotto o una categoria ## Esempi di richieste utente - "Quali prodotti o servizi ho venduto di più nel 2026?" - "Prodotti che generano più fatturato quest'anno" - "Mostrami il dettaglio dei servizi venduti nel 2026" ## Quando non usarlo - per la concentrazione del fatturato sui clienti (80/20): usa `report_pareto` - per elencare le singole fatture: usa `ricerca_documenti` ## Parametri - `anno` (String): Anno di riferimento (es. "2026"). - `categoria` (String, opzionale): Categoria del prodotto/servizio. - `nome_prodotto` (String, opzionale): Nome del prodotto/servizio. ## Output Restituisce un oggetto JSON con: - `servizi`: array di oggetti, ciascuno con: - `id`: ID del prodotto/servizio. - `nome`: Nome del prodotto/servizio. - `quantita`: Quantità totale venduta. - `tot_imp`: Importo totale. - `total`: numero totale di record trovati.
Ricerca documenti in Fattura24 e restituisce un elenco di risultati. Usa questo tool quando l'utente vuole trovare documenti specifici di un dato anno, ad esempio fatture, note di credito, preventivi, DDT, ordini o autofatture, sia di acquisto (`acquisto`) sia di vendita (`vendita`). **Campi obbligatori** - `anno`: anno della ricerca nel formato `yyyy` - `classe_documentale`: Tipo classe del documento da cercare - `tipo_documento`: direzione del documento, `acquisto` per i documenti di acquisto oppure `vendita` per i documenti di vendita. - `pagina`: quale pagina selezionare - `righe_per_pagina`: quante righe visualizzare **Campi opzionali** - `numero_fattura`: numero del documento, se l'utente cerca una fattura o un documento specifico - `stato_documento`: stato del pagamento o dello stato SDI, da usare solo se richiesto esplicitamente - `stato_invio_a_sistema_ts`: stato di invio del documento al Sistema Tessera Sanitaria **Valori ammessi per `stato_documento`** - `qualsiasi_stato` - `documento non pagato` - `documento pagato` - `fattura non inviata a SDI` - `fattura inviata a SDI` - `fattura con esito di mancata consegna` - `fattura con esito di avvenuta consegna` - `fatture scartate` **Valori ammessi per `stato_invio_a_sistema_ts`** - `qualsiasi_stato` - `Da inviare al Sistema TS` - `Accolti dal Sistema TS` - `Accolti con segnalazioni Sistema TS` - `Scartati o rigettati dal Sistema TS` **Esempi di richieste utente** - Trova le fatture elettroniche emesse nel 2026 - Cerca le note di credito ricevute nel 2025 - Mostrami i preventivi emessi nel 2026 - Trova il documento numero 4136-2026-FE - Cerca le fatture non pagate del 2026 - Mostrami le fatture inviate a SDI nel 2026 - Ci sono fatture scartate dallo SDI? Se si', quali sono? - Cerca le fatture con esito di mancata consegna - Trova i documenti scartati dallo SDI - Mostrami i documenti da inviare al Sistema TS - Cerca i documenti accolti dal Sistema TS - Trova i documenti accolti con segnalazioni dal Sistema TS **Non usare questo tool per** - confronti di fatturato tra anni diversi - analisi mese per mese - trend delle vendite o degli acquisti - report aggregati IVA, clienti, fornitori o prodotti - creazione, modifica o cancellazione documenti Il risultato, quando disponibile, puo' contenere alcuni campi riepilogativi. **Legenda dei campi piu' utili** - `totale_documenti`: il numero totale dei documenti restituiti dalla ricerca - `totale_al_saldo_vendite`: importo totale che manca per saldare i documenti di vendita restituiti dalla ricerca - `totale_al_saldo_acquisti`: importo totale che manca per saldare i documenti di acquisto restituiti dalla ricerca **Sezione `documenti`** contiene l'elenco dei documenti trovati dalla ricerca. Ogni elemento dell'array rappresenta un documento. - `documenti[].id`: identificativo univoco del documento in Fattura24 - `documenti[].id_tipo_documento`: codice numerico del tipo documento - `documenti[].fe_tipo_documento`: codice del tipo documento elettronico, ad esempio `TD01` - `documenti[].id_stato`: stato interno del documento - `documenti[].last_Esito_Sdi`: ultimo esito noto del processo SDI, se disponibile - `documenti[].numero`: numero del documento - `documenti[].data_documento`: data del documento nel formato `yyyy-MM-dd` - `documenti[].oggetto`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].sts_id_stato`: stato del documento verso il Sistema TS, se disponibile - `documenti[].sts_attivo`: indica se la gestione Sistema TS e' attiva per il documento - `documenti[].esigibilita_iva`: codice di esigibilita' IVA del documento - `documenti[].valuta_des`: codice valuta del documento, ad esempio `EUR` - `documenti[].valuta_cambio`: tasso di cambio applicato - `documenti[].totale`: importo totale del documento - `documenti[].pagato_u`: totale importo già pagato se si tratta di un documento di acquisto - `documenti[].pagato_e`: totale importo già incassato se si tratta di un documento di vendita **Sezione `documenti[].mittente`** contiene i dati del mittente del documento. - `documenti[].mittente.descrizione`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].mittente.id_rubrica`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].mittente.partita_iva`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].mittente.codice_fiscale`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].mittente.paese`: paese del mittente **Sezione `documenti[].destinatario`** contiene i dati del destinatario del documento. - `documenti[].destinatario.descrizione`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].destinatario.id_rubrica`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].destinatario.partita_iva`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].destinatario.codice_fiscale`: per motivi di privacy questo dato è offuscato così che non sia disponibile all'AI - `documenti[].destinatario.paese`: paese del destinatario **Sezione `sdi`** contiene i conteggi aggregati relativi allo stato di invio e ricezione dei documenti elettronici verso il Sistema di Interscambio. - `sdi.totale_da_inviare`: totale dei documenti che devono ancora essere inviati allo SDI - `sdi.totale_in_elaborazione`: totale dei documenti inviati allo SDI e ancora in elaborazione - `sdi.totale_ok`: totale dei documenti con esito positivo - `sdi.totale_ko`: totale dei documenti con esito negativo o scartati - `sdi.totale_altro`: totale dei documenti con stati SDI diversi dai precedenti **Sezione `sts`** contiene i conteggi aggregati relativi allo stato di trasmissione dei documenti verso il Sistema TS. - `sts.totale_da_inviare`: totale dei documenti che devono ancora essere inviati al Sistema TS - `sts.totale_in_errore`: totale dei documenti con errore di invio o elaborazione nel Sistema TS - `sts.totale_ok`: totale dei documenti accolti correttamente dal Sistema TS - `sts.totale_ok_warning`: totale dei documenti accolti dal Sistema TS con segnalazioni o avvisi - `sts.totale_disattivo`: totale dei documenti per cui la gestione o trasmissione al Sistema TS non è attiva **Indicazioni per interpretazione** - per documenti di `vendita`, la controparte principale e' normalmente il destinatario - per documenti di `acquisto`, la controparte principale e' normalmente il mittente
# Cronologia esiti SdI Questa tool permette di: - verificare lo stato dell'invio di una fattura elettronica al Sistema di Interscambio (SdI); - visualizzare l'output dei vari eventi che si sono verificati nel tempo (invii, consegne, scarti, ecc.); - verificare, nel caso di uno scarto, i codici e i motivi di errore comunicati dall'Agenzia delle Entrate. --- ### Guida alle ricevute SDI Di seguito sono spiegati i significati dei vari tipi di ricevute/notifiche che possono arrivare dall'Agenzia delle Entrate a seguito dell'invio di una fattura elettronica. ## Ricevute / Esiti SdI visualizzabili ### NS — Ricevuta di scarto È necessario: 1. esaminare l'errore segnalato; 2. modificare il documento; 3. reinviare la fattura al Sistema di Interscambio. --- ### RC — Ricevuta di consegna Il documento è stato correttamente consegnato dall'Agenzia delle Entrate: - nel Cassetto Fiscale; - sul canale di ricezione del cliente. --- ### MC — Mancato recapito Questa ricevuta comporta comunque la positiva emissione della fattura elettronica. Viene trasmessa generalmente quando il cliente è un consumatore finale privo di un canale telematico di ricezione. In questo caso il contribuente ha l'obbligo di trasmettere al cliente una copia della fattura tramite canali ordinari, ad esempio: - email; - posta; - copia PDF; - copia cartacea. --- ### NE — Notifica esito Questo esito viene trasmesso quando il documento è stato inviato ad una Pubblica Amministrazione (PA) e la stessa ha espresso: - accettazione (`NE-EC01`); - rifiuto (`NE-EC02`). --- ### DT — Decorrenza termini Questo esito viene trasmesso quando una Pubblica Amministrazione non ha comunicato accettazione o rifiuto entro il termine perentorio di 15 giorni. --- ### AT — Attestazione di avvenuta trasmissione con impossibilità di recapito Questa ricevuta viene trasmessa quando l'Agenzia delle Entrate non è riuscita a consegnare la fattura elettronica ad una Pubblica Amministrazione, nonostante il codice univoco utilizzato fosse corretto.
# Segnala Limite Connettore Invia una segnalazione strutturata al team tecnico di Fattura24 per informarlo che il connettore MCP non e' riuscito a soddisfare pienamente una richiesta dell'utente. ## Scopo Del Tool Questo tool serve a raccogliere in modo standardizzato i casi in cui: - l'utente chiede un'azione che il connettore MCP non puo' completare - i tool disponibili non coprono il workflow richiesto - manca un dato, un'operazione o un'integrazione necessaria - sarebbe utile introdurre un nuovo tool o ampliare un tool esistente L'obiettivo non e' gestire feedback generici, ma produrre ticket tecnici leggibili e prioritizzabili dal team di sviluppo. ## Quando Usarlo Usa questo tool solo se tutte le condizioni seguenti sono vere: - hai compreso l'obiettivo dell'utente - hai verificato che i tool MCP disponibili non permettono di completare bene la richiesta - il limite dipende dal connettore MCP e non solo da dati mancanti o da una richiesta ambigua ## Quando Non Usarlo Non usare questo tool: - se puoi completare il task con i tool gia' disponibili - se devi prima chiedere chiarimenti all'utente - se il problema dipende solo da input mancanti, autorizzazioni mancanti o dati inesistenti - per feedback generici non collegati a un limite del connettore ## Campi Da Valorizzare Compila tutti i campi richiesti in modo esplicito e concreto: | Campo | Obbligatorio | Cosa deve inserire l'LLM | |------|-------------|---------------------------| | `categoria` | si | Una delle categorie previste: `nuovo_tool`, `estensione_tool`, `bug_connettore`, `limite_workflow` | | `titolo` | si | Titolo breve del ticket, chiaro e leggibile da un operatore umano | | `richiesta_utente_originale` | si | Riassunto fedele della richiesta fatta dall'utente | | `obiettivo_utente` | si | Risultato pratico che l'utente voleva ottenere | | `tool_considerati` | si | Elenco dei tool MCP pertinenti che sono stati considerati | | `limite_riscontrato` | si | Spiegazione del motivo per cui il connettore non e' riuscito a completare il task | | `capacita_mancante` | si | Dato, azione o workflow che manca nel connettore | | `proposta_miglioramento` | si | Suggerimento concreto: nuovo tool oppure estensione di uno esistente | | `impatto_per_utente` | no | Conseguenza pratica del limite per l'utente | | `note_aggiuntive` | no | Eventuali dettagli extra utili al team tecnico | | `consenso_utente_confermato` | si | Deve essere `true`. Conferma che l'utente ha esplicitamente autorizzato l'invio. Non passare `true` senza aver ricevuto conferma esplicita. | ## Regole Di Compilazione - non inventare capability inesistenti - non dichiarare che manca un tool se il task e' gia' coperto da tool disponibili - non copiare integralmente prompt molto lunghi se basta un riassunto fedele - descrivi la mancanza in termini tecnici e operativi, non generici - la proposta di miglioramento deve essere attuabile e comprensibile ## Consenso Obbligatorio Prima dell'Invocazione Questo tool invia dati al sistema di ticketing interno di Fattura24: - tutti i campi compilati nel ticket (categoria, titolo, descrizione del limite, proposta, ecc.) - la richiesta originale dell'utente (`richiesta_utente_originale`) - i dati identificativi dell'account autenticato: indirizzo email, ragione sociale, ID utente, ID profilo **Prima di invocare questo tool devi:** 1. Informare l'utente di quali dati verranno trasmessi (elencati sopra) 2. Chiedere conferma esplicita: *"Autorizzi l'invio di questi dati al team tecnico di Fattura24?"* 3. Procedere con l'invocazione solo se l'utente risponde affermativamente, passando `consenso_utente_confermato: true` Il server rifiuta la chiamata se `consenso_utente_confermato` non e' `true`. Non passare `true` senza aver ricevuto conferma esplicita dall'utente. Questi dati vengono usati esclusivamente per creare il ticket tecnico e identificare l'account mittente. Non vengono condivisi con terze parti al di fuori del sistema di supporto Fattura24. ## Output Atteso Il tool invia un ticket tecnico strutturato. In caso di successo restituisce `OK`, altrimenti un messaggio di errore.
How do I improve a ChatGPT Plugin's discoverability?
The levers are the listing surface agents actually read: names, descriptions, keywords, tool metadata, and registry health. Which lever matters depends on where discovery breaks, which is what continuous measurement shows.
What are Fattura24 alternatives on ChatGPT?
As of 2026-08-14, Fattura24 competes with AgentCollect, Akaunting, Cryptoworth, Digits, Double, ExpenseBot, Fiscal Pro, Granatum Financeiro, HelpDol, Inkle, Intuit QuickBooks, Jaz Accounting, Kick, MyCarTracks, Norman, NP Ledger, QBO Connector by Meridian, Voder in ChatGPT Accounting & Bookkeeping, ranked by public Discoverability Score.
Where is this profile measured?
This profile uses the geography attached to the latest public registry snapshot: US. Locale tags are intentionally omitted.