Generare PDF da template con Carbone.io: guida pratica per automatizzare contratti e preventivi

Ogni volta che un commerciale deve mandare un preventivo, apre Word, copia i dati dal CRM, incolla, aggiusta il layout, salva come PDF, allega all'email e invia. 15-20 minuti per documento, con il rischio concreto di copiare il prezzo sbagliato o mettere il nome del cliente precedente. Carbone.io elimina questo processo completamente.

Cos'è Carbone.io e come funziona

Carbone.io è un motore di generazione documenti open source che funziona con un principio elegante: prendi un file Word (.docx) normale, inserisci dei segnaposto nel formato {d.nomeVariabile}, e Carbone sostituisce automaticamente quei segnaposto con i dati reali che gli passi via API. Il risultato è un PDF perfetto, con il tuo branding, in meno di 3 secondi.

• Template in Word: usi Word come lo conosci. Testo, tabelle, immagini, intestazioni — tutto normale. Solo i dati variabili diventano segnaposto.
• Dati in JSON: passi a Carbone un oggetto JSON con tutti i dati (nome cliente, prodotti, prezzi, date). Carbone li inserisce nel template.
• PDF in output: Carbone genera il PDF finale in 1-3 secondi, pronto per essere inviato o archiviato.

Esempio pratico: preventivo automatico dal CRM

Ecco il workflow completo che implementiamo tipicamente per i preventivi commerciali:

• Il commerciale crea l'opportunità nel CRM (VTiger o Zoho) con i prodotti e i prezzi selezionati
• Clicca 'Genera Preventivo' — il CRM chiama il nostro workflow n8n
• n8n estrae i dati dell'opportunità dal CRM via API (cliente, prodotti, prezzi, condizioni)
• n8n chiama Carbone.io API con il template preventivo e i dati JSON
• Carbone genera il PDF in 2 secondi e lo restituisce
• n8n archivia il PDF su Google Drive nella cartella del cliente
• n8n invia il PDF via email al cliente e aggiorna lo stato nel CRM

Segnaposto avanzati: loop, condizioni e formattazione

Carbone.io supporta anche logiche più complesse oltre alla semplice sostituzione di variabili:

• Loop su array: {d.prodotti[i].nome} — genera automaticamente una riga per ogni prodotto nella lista, perfetto per i dettagli del preventivo.
• Condizioni: {d.sconto > 0 ? 'Sconto applicato: ' + d.sconto + '%' : ''} — mostra o nasconde sezioni in base ai dati.
• Formattazione: {d.totale:formatN(2,',')} — formatta i numeri con separatori italiani (1.234,56 invece di 1234.56).
• Immagini dinamiche: è possibile inserire immagini dinamiche nel PDF, come foto prodotto o firma digitalizzata.

Carbone self-hosted vs Carbone Cloud

Carbone è disponibile sia in versione self-hosted (open source, gratis, installi sul tuo server) che in versione cloud a consumo (pay-per-render, circa €0.01-0.02 per PDF). Per PMI con volumi fino a 1.000 PDF/mese, il cloud è la soluzione più semplice. Per volumi superiori o per esigenze di privacy dei dati (es. contratti riservati), il self-hosted su server italiano è la scelta migliore.

Vuoi automatizzare la generazione dei tuoi documenti aziendali? Prenota una consulenza gratuita — ti mostriamo un prototipo funzionante con i tuoi template in meno di una settimana. Scopri il nostro servizio di generazione PDF automatica.