Capitolato tecnico: cos'è e come scriverlo bene

Hai un'idea chiara per il tuo progetto software. Sai cosa vuoi costruire, conosci il tuo target, hai anche un budget in mente. Ma quando vai da una software house e chiedi un preventivo, ti rendi conto che ognuno ti risponde in modo diverso — prezzi lontanissimi tra loro, tempi che variano del doppio, funzionalità che qualcuno include e altri no. Questo accade quasi sempre per lo stesso motivo: manca un capitolato tecnico.

Il capitolato tecnico è il documento che mette nero su bianco cosa deve fare il software, come deve comportarsi, chi lo userà e in quale contesto. È la base di partenza per qualsiasi preventivo serio. Senza di esso, ogni fornitore interpreta il progetto a modo suo.

Cos'è un capitolato tecnico

Il capitolato tecnico è un documento scritto che descrive in modo dettagliato i requisiti funzionali e non funzionali di un progetto software. In pratica, spiega cosa deve fare il sistema, come deve farlo e quali vincoli deve rispettare (tecnologici, di budget, di tempo).

Non va confuso con il brief creativo o con uno schema di massima. Il capitolato è strutturato, completo e condiviso con tutti i fornitori che partecipano alla selezione. Serve sia a te — per chiarire le idee — sia alla software house, per fare un preventivo accurato e costruire qualcosa che corrisponda davvero alle tue aspettative.

In ambito pubblico è obbligatorio per legge negli appalti. In ambito privato non è obbligatorio, ma le aziende che lo usano risparmiano tempo, denaro e litigi.

Perché il capitolato tecnico è importante

Sviluppare software senza un capitolato tecnico è come costruire una casa senza planimetria. Il muratore fa del suo meglio, ma se non sa dove vuoi la cucina, probabilmente te la mette nel posto sbagliato.

Ecco cosa succede in concreto quando manca:

• I preventivi sono incomparabili. Ogni fornitore quota funzionalità diverse, quindi confrontare i prezzi diventa impossibile.
• I requisiti cambiano in corsa. Senza un documento condiviso, le "idee nuove" si accumulano e i costi esplodono.
• I tempi slittano. Lo sviluppatore ha bisogno di continue chiarificazioni. Ogni rallentamento costa.
• Le aspettative divergono. Tu immaginavi una cosa, loro ne hanno costruita un'altra. Entrambi avete ragione — ma il contratto non tutela nessuno.

Con un capitolato tecnico ben scritto, invece, parti con una base condivisa. I preventivi diventano comparabili, i tempi più prevedibili, e gli eventuali scostamenti sono documentati e giustificabili.

Come scrivere un capitolato tecnico: struttura completa

Non esiste un formato universale, ma ci sono sezioni che non dovrebbero mai mancare. Ecco come strutturarlo in modo pratico.

1. Presentazione del progetto

Inizia con una panoramica chiara: chi siete come azienda, qual è il contesto del progetto, qual è l'obiettivo principale. Non serve un romanzo — bastano 10-15 righe che diano al fornitore la visione d'insieme.

Esempio: "Siamo una società di logistica con 50 dipendenti. Vogliamo sviluppare un gestionale interno per tracciare le spedizioni in tempo reale e ridurre gli errori manuali nella fase di smistamento."

2. Utenti e contesto d'uso

Chi userà il software? Con quale frequenza? Da quale dispositivo? In quale ambiente (ufficio, magazzino, campo)?

Definire gli utenti — sia quelli principali sia quelli amministrativi — aiuta lo sviluppatore a capire le priorità di usabilità e le esigenze tecniche (es. funzionamento offline, compatibilità mobile, accessibilità).

3. Requisiti funzionali

Questa è la sezione centrale del capitolato tecnico. Elenca tutto ciò che il sistema deve saper fare: le funzionalità, i flussi utente, le regole di business. Organizzale per moduli o aree logiche.

Usa un linguaggio semplice e concreto. Invece di "gestione utenti avanzata", scrivi: "L'amministratore può creare, modificare e disattivare account utente. Ogni utente ha un ruolo (admin, operatore, supervisore) che determina cosa può vedere e fare."

Se stai valutando come strutturare il capitolato tecnico del tuo progetto, possiamo aiutarti: contattaci dalla sidebar per una consulenza gratuita.

4. Requisiti non funzionali

Sono i requisiti "di qualità": performance, sicurezza, scalabilità, disponibilità. Spesso vengono ignorati in fase iniziale — ma poi diventano la causa di problemi enormi in produzione.

Esempi da includere:

• Il sistema deve reggere X utenti simultanei
• I dati devono essere cifrati e conformi al GDPR
• L'app deve caricarsi in meno di 2 secondi su connessione 4G
• Deve essere disponibile il 99,5% del tempo (uptime)

5. Integrazioni e vincoli tecnologici

Il software si deve integrare con sistemi esistenti? CRM, ERP, piattaforme di pagamento, servizi di terze parti? Se hai già una preferenza tecnologica (es. vuoi usare un certo cloud provider, un framework specifico, o stai su un'infrastruttura già esistente), indicalo qui.

Se non hai vincoli tecnologici, dillo esplicitamente: lascia che sia il fornitore a proporre la soluzione più adatta.

6. Requisiti di design e UX

Hai già un brand guideline? Un'identità visiva da rispettare? Vuoi un'interfaccia minimale o ricca di funzionalità? Ci sono esempi di prodotti simili che ti piacciono?

Non devi essere un designer per rispondere a queste domande. Basta indicare il tono generale e fornire riferimenti — anche solo link a prodotti che ti ispirano.

7. Milestone, tempi e budget

Indica la data di consegna desiderata (o il periodo target) e, se puoi, una fascia di budget. Non temere di condividere il budget: un fornitore serio non gonfia il preventivo sapendo la cifra disponibile — anzi, calibra la proposta in modo più realistico.

Se il progetto è grande, puoi suddividerlo in fasi (es. MVP entro giugno, versione completa entro settembre) e chiedere preventivi separati per ciascuna.

8. Criteri di accettazione

Come saprete che il progetto è "finito"? Definisci i criteri di test e accettazione: chi approva il rilascio, su quali device verrà testato, quali funzionalità devono essere verificate prima di andare live.

Errori comuni da evitare

Anche chi scrive un capitolato per la prima volta commette gli stessi errori. Ecco i più frequenti:

• Essere troppo vaghi. "Un sistema moderno e intuitivo" non dice nulla. Sii specifico: cosa deve fare, chi lo usa, in quale contesto.
• Dimenticare i requisiti non funzionali. Performance, sicurezza e scalabilità non sono dettagli — sono fondamentali.
• Non indicare le integrazioni. Scoprire a metà progetto che bisogna interfacciarsi con un sistema legacy può raddoppiare i costi.
• Aspettarsi che il fornitore faccia tutto. Il capitolato lo scrivi tu (o con il supporto di un consulente). Non puoi delegarlo interamente a chi poi farà il preventivo.
• Confondere funzionalità con soluzioni tecniche. Il tuo compito è descrivere il problema da risolvere, non la soluzione tecnologica. Lascia la scelta tecnica al professionista.

Checklist: il tuo capitolato tecnico è completo?

Prima di inviarlo ai fornitori, controlla che contenga:

1. ✅ Presentazione dell'azienda e obiettivo del progetto
2. ✅ Descrizione degli utenti finali e del loro contesto d'uso
3. ✅ Lista completa delle funzionalità richieste (requisiti funzionali)
4. ✅ Requisiti di performance, sicurezza e scalabilità
5. ✅ Integrazioni con sistemi esistenti o di terze parti
6. ✅ Indicazioni su design, brand o UX desiderata
7. ✅ Tempistiche desiderate e fascia di budget
8. ✅ Criteri di accettazione e testing

Se hai spuntato tutti e otto i punti, sei pronto per inviarlo. Se ne mancano alcuni, prenditi il tempo per completarli — ogni sezione mancante è un potenziale malinteso futuro.

Chi ti può aiutare a scrivere il capitolato

Se non hai esperienza nel settore, scrivere un capitolato tecnico da zero può sembrare complicato. La buona notizia è che non devi farlo da solo.

Una software house seria ti supporta in questa fase ancora prima di farti un preventivo. Non per interesse commerciale — ma perché sa che un progetto ben documentato ha molte più probabilità di andare a buon fine. Se lavori con professionisti che ti chiedono le domande giuste, riuscirai a strutturare un documento solido anche senza esperienza tecnica.

Hai bisogno di supporto per scrivere il capitolato tecnico del tuo progetto? Scrivici: trovi il form di contatto qui a destra. Ti aiutiamo a trasformare l'idea in un documento chiaro, pronto per ricevere preventivi comparabili e precisi.