Sommario

  1. Introduzione

  2. Capire come Dolibarr gestisce la generazione di PDF

  3. La natura temporanea dei file PDF in Dolibarr

  4. Dove vengono archiviati i PDF (e per quanto tempo)?

  5. Idee sbagliate comuni sul salvataggio dei documenti

  6. Generazione di file vs. Archiviazione di file in Dolibarr

  7. Comportamento del modulo: fatture, ordini, proposte, ecc.

  8. Impostazioni di configurazione che influiscono sulla gestione dei PDF

  9. Considerazioni su autorizzazioni e ambiente server

  10. Cosa succede quando si rigenera un PDF?

  11. Come salvare e archiviare automaticamente i PDF

  12. Tenere traccia dei PDF generati per motivi legali o di controllo

  13. Utilizzo di repository di file esterni (Dropbox, Nextcloud, FTP)

  14. Soluzione alternativa: copia automatica dei file PDF

  15. Best Practices per la conservazione dei documenti in Dolibarr

  16. Come evitare la perdita di dati dai file temporanei

  17. Come i moduli personalizzati gestiscono il salvataggio PDF

  18. Differenze di comportamento tra Dolibarr ospitato e auto-ospitato

  19. Quando chiedere aiuto allo sviluppatore

  20. Conclusione: gestire i file PDF in Dolibarr con sicurezza

1. introduzione

Dolibarr è una soluzione ERP e CRM affidabile, progettata per le piccole e medie imprese. Tra le sue numerose funzionalità, la possibilità di generare documenti PDF come fatture, preventivi, bolle di consegna e altro ancora. Tuttavia, una domanda frequente tra i nuovi utenti è: "Perché Dolibarr non salva i documenti PDF che genera per impostazione predefinita?"

Questo articolo approfondisce l'architettura, la logica e le best practice per la gestione dei documenti PDF in Dolibarr. Comprendere questi aspetti ti aiuterà a gestire meglio i file, evitare la perdita di dati e personalizzare il sistema in base alle tue esigenze aziendali.

2. Comprendere come Dolibarr gestisce la generazione di PDF

Dolibarr non utilizza PDF pre-salvati come impostazione predefinita. Genera invece documenti su richiesta. Quando un utente clicca per visualizzare o scaricare un PDF, Dolibarr crea il file dinamicamente utilizzando i dati del suo database e un modello predefinito.

Questo approccio garantisce che:

  • Il PDF riflette i dati più recenti

  • Nessuno spazio su disco viene sprecato su file obsoleti o inutilizzati

  • I modelli e i layout possono essere aggiornati senza dover rigenerare tutti i file esistenti

3. La natura temporanea dei file PDF in Dolibarr

Per impostazione predefinita, Dolibarr salva i file PDF solo temporaneamente. Il sistema li memorizza nella cartella /documents/ directory, spesso sotto una struttura come /documents/facture/, /documents/propal/, o /documents/commande/.

Tuttavia, se il file esiste già, Dolibarr potrebbe sovrascriverlo, a meno che non venga configurato diversamente. Se si rigenera un documento, Dolibarr lo ricrea con i dati più recenti.

4. Dove vengono archiviati i PDF (e per quanto tempo)?

Dolibarr organizza i file per modulo:

  • Fatture: /documents/facture/REF/

  • Ordini: /documents/commande/REF/

  • proposte: /documents/propal/REF/

Queste cartelle contengono i PDF se sono stati scaricati o generati esplicitamente. Tuttavia, se non hai mai cliccato per generare un PDF, potrebbe non essere presente sul disco.

I PDF rimangono salvati a meno che non vengano eliminati manualmente o rimossi tramite una pulizia del sistema. Non esiste una scadenza automatica, ma la rigenerazione sovrascriverà i file, a meno che non venga utilizzato il controllo delle versioni.

5. Errori comuni sul salvataggio dei documenti

Gli utenti spesso presumono:

  • I PDF vengono salvati automaticamente dopo la convalida: non sono

  • Tutte le azioni creano file sul disco, solo la generazione di documenti lo fa

  • I PDF vengono archiviati in modo permanente, solo se conservati manualmente

Per gestire i documenti in Dolibarr è fondamentale comprendere che la generazione dei PDF è un processo separato dall'archiviazione.

6. Generazione di file vs. Archiviazione di file in Dolibarr

Ecco come funziona in genere Dolibarr:

  • Un documento (ad esempio una fattura) viene creato e convalidato

  • Nessun file è stato salvato in questo momento

  • L'utente fa clic su "Genera PDF"

  • Dolibarr crea il file utilizzando il modello e lo salva nella directory pertinente

  • Il file rimane finché non viene eliminato o sovrascritto

Questa separazione garantisce flessibilità, ma richiede attenzione per evitare di perdere file in seguito.

7. Comportamento del modulo: fatture, ordini, proposte, ecc.

Ogni modulo gestisce i documenti in modo leggermente diverso:

  • Fatture: I PDF vengono creati solo quando si fa clic; possono essere rigenerati in qualsiasi momento

  • Ordini: Si applica la stessa logica

  • proposte: Può includere filigrana e stato facoltativi

È buona norma generare e salvare i PDF dopo la convalida, per conservare una traccia del documento al momento della sua finalizzazione.

8. Impostazioni di configurazione che influiscono sulla gestione dei PDF

È possibile configurare alcuni comportamenti:

  • Vai su Impostazioni > Moduli > Modelli PDF

  • Imposta modelli predefiniti e abilita la generazione automatica (in moduli limitati)

  • Utilizzare le impostazioni del percorso della directory dei documenti in Configurazione > Altra configurazione se si personalizza la struttura del file

Queste impostazioni determinano dove e come i PDF vengono generati e archiviati.

9. Autorizzazioni e considerazioni sull'ambiente del server

Dolibarr deve avere i permessi di scrittura per /documents/ cartella. Se le autorizzazioni non sono configurate correttamente:

  • I PDF potrebbero non essere salvati

  • La generazione del file potrebbe fallire silenziosamente

Assicurati che il tuo utente Apache/Nginx abbia accesso corretto e che l'ambiente del tuo server (in particolare nell'hosting condiviso) supporti la scrittura di file.

10. Cosa succede quando si rigenera un PDF?

Quando si rigenera un documento:

  • Il vecchio file viene sovrascritto (se il nome del file è lo stesso)

  • Il contenuto viene aggiornato per riflettere i dati attuali

Questa funzionalità è utile per correggere i dati, ma può rivelarsi problematica se si desidera conservare la versione originale per scopi legali o di revisione contabile.

11. Come salvare e archiviare automaticamente i PDF

Opzioni per il salvataggio automatico:

  • Utilizzare un cron job per attivare la generazione del PDF dopo la convalida

  • Aggiungi un modulo o un hook per generare e bloccare automaticamente i PDF

  • Spostare i file PDF in una directory di archivio tramite script

In questo modo si garantisce che ogni documento convalidato venga conservato nel suo stato originale.

12. Tenere traccia dei PDF generati per motivi legali o di controllo

Per garantire la preparazione all'audit:

  • Genera PDF al momento della convalida del documento

  • Sposta o copia i file in un archivio di sola lettura

  • Utilizzare il controllo delle versioni (ad esempio, fattura-2025-01-V1.pdf) per evitare sovrascritture

Ciò è particolarmente importante nei Paesi in cui vigono rigidi requisiti in materia di fatturazione elettronica o di archiviazione IVA.

13. Utilizzo di repository di file esterni (Dropbox, Nextcloud, FTP)

Dolibarr può essere integrato con storage esterno:

  • Utilizzare i moduli per la sincronizzazione /documents/ ai servizi cloud

  • Backup automatico dei file PDF su FTP o SFTP

  • Implementare WebDAV o cartelle condivise per l'accesso del team

Ciò aumenta la sicurezza e la disponibilità dei documenti.

14. Soluzione alternativa: copia automatica dei file PDF

Utilizzare uno script (bash, Python, ecc.) per monitorare il /documents/ directory e:

  • Rileva nuovi file

  • Copiali in un'altra posizione

  • Rinominali per l'archiviazione

Imposta questo script come cron job da eseguire ogni ora o ogni giorno.

15. Best Practice per la conservazione dei documenti in Dolibarr

  • Genera sempre i PDF dopo la convalida del documento

  • Utilizzare convenzioni di denominazione per il monitoraggio delle versioni

  • Mantenere un backup separato all'esterno del server Dolibarr

  • Formare gli utenti su quando e come generare i PDF

16. Evitare la perdita di dati dai file temporanei

Se un PDF non è mai stato generato o salvato:

  • Non può essere recuperato dalla cronologia

  • Sarà necessario rigenerarlo, il che potrebbe non riflettere più i dati originali

Per proteggersi da questo problema, è possibile applicare policy di generazione al momento dell'approvazione del documento.

17. Come i moduli personalizzati gestiscono il salvataggio PDF

Alcune estensioni di Dolibarr aggiungono funzionalità di salvataggio automatico o di registrazione in formato PDF. Questi moduli possono:

  • Genera automaticamente PDF in caso di trigger di eventi

  • Registra quando è stato creato un PDF e da chi

  • Salva i backup su sistemi esterni

Scegli moduli affidabili da Dolistore o collabora con uno sviluppatore per aggiungere questa funzionalità.

18. Differenze di comportamento tra Dolibarr ospitato e auto-ospitato

Versioni di Dolibarr ospitate (ad esempio, provider SaaS):

  • Può limitare l'accesso al file system

  • Può pulire automaticamente i vecchi file

  • Spesso è necessario un ticket di supporto per i download in blocco

Le installazioni self-hosted offrono un maggiore controllo sull'archiviazione dei documenti, sugli script e sui backup.

19. Quando chiedere aiuto allo sviluppatore

Contattare un integratore Dolibarr se:

  • Hai bisogno dell'archiviazione automatica

  • Vuoi integrare l'archiviazione cloud

  • Hai requisiti di controllo delle versioni PDF specifici per l'audit

Gli script o i moduli personalizzati possono colmare efficacemente queste lacune.

20. Conclusione: gestire i file PDF in Dolibarr con sicurezza

L'approccio di Dolibarr alla generazione di PDF privilegia flessibilità ed efficienza, ma affida all'utente la responsabilità del salvataggio e dell'archiviazione dei documenti. Una volta compreso come vengono generati i PDF, dove vengono archiviati e come controllare il processo, è possibile garantire la conformità, ridurre al minimo la perdita di dati e semplificare i flussi di lavoro aziendali.

Che si tratti di strumenti integrati, scripting intelligente o archiviazione esterna, Dolibarr offre tutto ciò che serve per gestire i documenti, se sai come configurarlo correttamente.