Ho collegato un assistente AI al mio gestionale di fatturazione: cosa cambia davvero

Il preventivo che non parte è il costo nascosto di ogni attività piccola. Non perché sia difficile scriverlo: perché arriva sempre nel momento sbagliato. Sei in mezzo a un lavoro, il cliente ti chiede una cifra, e per rispondere devi fermare tutto, aprire il gestionale, cercare l’anagrafica, mettere le righe, l’IVA, la scadenza. Costa dieci minuti e una interruzione. Così slitta a stasera, e stasera slitta a domani.

Da qualche mese quel preventivo lo detto. Racconto come funziona, perché è un esempio concreto di una cosa che diciamo spesso ai clienti e che a parole sembra fumo: automatizzare non vuol dire comprare l’AI, vuol dire mettere in ordine il lavoro prima.

Cos’è Biglins

Biglins è il gestionale di fatturazione che uso per la mia attività. L’ho scritto per me, poi l’ho rilasciato open source su GitHub con licenza MIT, perché il problema che risolve ce l’hanno tutti i liberi professionisti e le ditte individuali.

Fa le cose che deve fare un gestionale, senza pretendere di essere un ERP: anagrafica clienti, fatture con righe e IVA, note di credito per storno, numerazione progressiva automatica, PDF, duplicazione di una fattura già emessa, riepilogo del fatturato dell’anno. E due cose che mi servivano davvero e che i gestionali generalisti trattano male:

• Lo scadenzario dei rinnovi. Domini, hosting, manutenzioni: servizi ricorrenti che ogni anno vanno rinnovati o disdetti. Sono in dashboard, con l’azione di rinnovo o disdetta a portata di clic. Prima li tenevo a mente, che è un modo elegante per dire che li dimenticavo.
• I preventivi come documento vero. Corpo della proposta in markdown, allegati, export in PDF o ZIP, e conversione in fattura con un clic quando il cliente accetta. Il preventivo accettato non va ribattuto: diventa la fattura.

Sotto c’è Laravel 13 e Vue 3. Gira in Docker su un server, oppure come applicazione desktop su Windows, Mac e Linux, con il database in locale e nessun server da gestire.

La parte che cambia il lavoro

A Biglins ho aggiunto un server MCP. Tradotto: un assistente AI può parlare con il gestionale, invece che con me. Otto operazioni, non una in più: elencare e creare clienti, elencare e creare preventivi, elencare e creare fatture, mandare per email un preventivo o una fattura.

In pratica, seduto al computer, scrivo o detto qualcosa del tipo: fai un preventivo a Mario Rossi per venti ore di sviluppo a sessanta euro, IVA ordinaria, valido trenta giorni. L’assistente cerca il cliente nell’anagrafica, trova quello giusto, crea il preventivo con la sua riga e la sua scadenza, e me lo lascia lì da controllare. Se serve, glielo faccio spedire.

I dieci minuti diventano trenta secondi, ma non è quello il punto. Il punto è che il preventivo lo faccio nel momento in cui ci penso, senza cambiare contesto. Le cose che si fanno subito si fanno; quelle che richiedono di aprire un’altra finestra, no.

Perché funziona: le regole stanno nel gestionale, non nell’AI

Qui c’è la lezione che vale anche per chi non scriverà mai una riga di codice.

Un assistente AI è bravo a capire cosa vuoi. È pessimo come custode di regole. Se lasci a lui decidere il numero della fattura, l’aliquota o a quale azienda appartiene un cliente, prima o poi sbaglia — e in contabilità un errore plausibile è peggio di un errore evidente.

Quindi non gli ho lasciato niente di tutto questo. Il gestionale non si fida dell’assistente e ogni operazione passa dagli stessi controlli dell’interfaccia:

• l’azienda che emette va sempre dichiarata, non c’è un valore predefinito da indovinare;
• il cliente deve esistere già e appartenere a quell’azienda, altrimenti l’operazione viene rifiutata;
• la scadenza di un preventivo non può precedere la data del preventivo;
• quantità, prezzo e IVA sono obbligatori su ogni riga;
• la numerazione progressiva la fa il gestionale, come sempre.

L’assistente compila un modulo, non prende decisioni contabili. È esattamente il ruolo giusto per lui.

Vale la pena aggiungere una cosa che di solito non si dice: l’assistente crea, non pubblica. Un preventivo creato è un preventivo che sta lì. Uscire verso il cliente è un’operazione separata, che chiedo io. È una scelta di progetto, non un limite tecnico, e la rifarei.

Chi può fare cosa

Dare a un’AI accesso ai tuoi documenti fiscali è una decisione seria, e l’ho trattata come tale. La versione desktop gira solo sul tuo computer, sul tuo database: lì l’accesso è già chi ha in mano la macchina, e non serve altro. La versione su server, che può essere raggiungibile da internet, richiede un token personale da creare a mano nelle impostazioni, revocabile in qualsiasi momento con effetto immediato.

E una limitazione onesta, scritta anche nella documentazione: Biglins non separa gli utenti tra loro. Chi ha accesso, ha accesso a tutte le aziende presenti sull’installazione. È pensato per il professionista che se lo installa per sé, o per lo studio che lo condivide fidandosi al proprio interno. Se ti serve un gestionale multi-utente con permessi differenziati, questo non è quello — e preferisco dirtelo qui che scoprirlo insieme dopo.

Cosa portarsi a casa

Se hai un’attività e stai guardando l’AI chiedendoti da dove si comincia, la risposta non è “da un chatbot”.

Si comincia dal fatto che il tuo lavoro abbia una forma. Un’anagrafica clienti che sia una sola. Documenti che seguano regole scritte da qualche parte e non nella testa di qualcuno. Un posto solo dove stanno le cose. L’AI non mette ordine in un’azienda disordinata: amplifica quello che trova. Su un processo chiaro diventa una scorciatoia notevole; su un processo confuso produce confusione più in fretta di prima.

Biglins mi ha fatto risparmiare tempo il giorno in cui ho smesso di tenere i rinnovi a mente, molto prima che ci attaccassi un assistente. L’assistente è arrivato dopo, ed è stato facile aggiungerlo proprio perché sotto c’era già qualcosa di ordinato.

Il codice è su GitHub, puoi installarlo e usarlo. E se il tuo lavoro ha un pezzo ripetitivo che ti mangia le giornate — preventivi, ordini, rapportini, scadenze — scrivici e raccontacelo: la prima cosa che guardiamo non è quale tecnologia usare, ma se quel processo ha una forma abbastanza chiara da poter essere automatizzato.