account_consumi_mcp
ChatGPTAccount 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) - chiamateEffettuate - Numero di chiamate MCP effettuate nella giornata corrente - intervallo - Periodo delle chiamate conteggiate - dal - Inizio della giornata corrente (formato YYYY-MM-DD HH:mm:ss) - al - Timestamp dell'ultima chiamata registrata (null se nessuna chiamata) - chiamateResidue - Numero di chiamate residue disponibili (-1 se illimitato)
account_consumi_mcp
ChatGPTAccount 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) - chiamateEffettuate - Numero di chiamate MCP effettuate nella giornata corrente - intervallo - Periodo delle chiamate conteggiate - dal - Inizio della giornata corrente (formato YYYY-MM-DD HH:mm:ss) - al - Timestamp dell'ultima chiamata registrata (null se nessuna chiamata) - chiamateResidue - Numero di chiamate residue disponibili (-1 se illimitato)
account_dettagli
ChatGPTProfilo Utente Recupera i dati 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
account_dettagli
ChatGPTProfilo Utente Recupera i dati 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
download_esito_sdi
ChatGPTCronologia esiti SdI Questa tool permette di: - verificare lo stato dell'invio di un documento al Sistema di Interscambio (SdI) - verificare, nel caso di uno scarto, i codici e i motivi di errore comunicati dall'Agenzia delle Entrate. --- 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. ---
download_esito_sdi
ChatGPTCronologia esiti SdI Questa tool permette di: - verificare lo stato dell'invio di un documento al Sistema di Interscambio (SdI) - verificare, nel caso di uno scarto, i codici e i motivi di errore comunicati dall'Agenzia delle Entrate. --- 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. ---
report_analisi_iva
ChatGPTReport Analisi IVA (MCP) Endpoint getReportAnalisiIVA(Integer idUtente, String anno, String esigibilita) Descrizione Restituisce i dati IVA per l’utente specificato, in formato JSON, secondo il regime IVA (qualasiasi o solo split payment). Parametri - anno: Anno di riferimento (es. "2026") - esigibilita: Esigibilità IVA ("qualsiasi" per cassa, "solo split payment" per competenza) Esempio di risposta ```json [ { "tipo": "entrate", "mese": 1, "importo": 1234.56 }, { "tipo": "uscite", "mese": 1, "importo": 789.01 } ]
report_analisi_iva
ChatGPTReport Analisi IVA (MCP) Endpoint getReportAnalisiIVA(Integer idUtente, String anno, String esigibilita) Descrizione Restituisce i dati IVA per l’utente specificato, in formato JSON, secondo il regime IVA (qualasiasi o solo split payment). Parametri - anno: Anno di riferimento (es. "2026") - esigibilita: Esigibilità IVA ("qualsiasi" per cassa, "solo split payment" per competenza) Esempio di risposta ```json [ { "tipo": "entrate", "mese": 1, "importo": 1234.56 }, { "tipo": "uscite", "mese": 1, "importo": 789.01 } ]
report_area_geografica
ChatGPTRestituisce 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_area_geografica
ChatGPTRestituisce 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
ChatGPTReport 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_a nnuale - 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 camelCase, 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 } }
report_bilancino
ChatGPTReport 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_a nnuale - 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 camelCase, 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 } }
report_churn_rate
ChatGPTChurn 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. Dati restituiti L’LLM 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_churn_rate
ChatGPTChurn 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. Dati restituiti L’LLM 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
ChatGPTReport Fatturato Restituisce il report mensile del fatturato per l'anno specificato. L'output è un array JSON di 12 elementi, uno per ciascun mese dell'anno, con valori aggregati di fatturato, acquisti, vendite e tributi. 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
ChatGPTReport Fatturato Restituisce il report mensile del fatturato per l'anno specificato. L'output è un array JSON di 12 elementi, uno per ciascun mese dell'anno, con valori aggregati di fatturato, acquisti, vendite e tributi. 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
ChatGPTReport 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_fatturato_confronto
ChatGPTReport 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
ChatGPTReport 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 camelCase, 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, …
report_forecast
ChatGPTReport 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 camelCase, 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, …
report_pagamenti_confronto
ChatGPTRestituisce 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" = pagamenti in uscita / fatture di vendita "acquisto" = pagamenti in entrata / 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_pagamenti_confronto
ChatGPTRestituisce 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" = pagamenti in uscita / fatture di vendita "acquisto" = pagamenti in entrata / 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
ChatGPTReport 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. --- 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_pareto
ChatGPTReport 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. --- 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
ChatGPTReport Prodotti/Servizi Restituisce l’elenco dei prodotti e servizi venduti dall’utente in un determinato anno, con quantità e importo totale aggregati. 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.
report_prodotti_servizi
ChatGPTReport Prodotti/Servizi Restituisce l’elenco dei prodotti e servizi venduti dall’utente in un determinato anno, con quantità e importo totale aggregati. 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
ChatGPTRicerca 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 in entrata (in) sia in uscita (out). 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: oggetto o descrizione sintetica del documento - 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 quest…
ricerca_documenti
ChatGPTRicerca 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 in entrata (in) sia in uscita (out). 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: oggetto o descrizione sintetica del documento - 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 quest…
ricerca_esito_sdi
ChatGPTCronologia 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 Link che porta ad una pagina del sito web di Fattura24 che spiega 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.
ricerca_esito_sdi
ChatGPTCronologia 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 Link che porta ad una pagina del sito web di Fattura24 che spiega 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
ChatGPTInvia Feedback Nuovo Invia una segnalazione strutturata al team tecnico di Fattura24 e 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 d…
segnala_limite_connettore
ChatGPTInvia Feedback Nuovo Invia una segnalazione strutturata al team tecnico di Fattura24 e 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 d…
