Índice del Contenido

  1. Introducción

  2. Entendiendo cómo Dolibarr gestiona la generación de PDF

  3. La naturaleza temporal de los archivos PDF en Dolibarr

  4. ¿Dónde se almacenan los archivos PDF (y durante cuánto tiempo)?

  5. Conceptos erróneos comunes sobre el guardado de documentos

  6. Generación y almacenamiento de archivos en Dolibarr

  7. Comportamiento del módulo: Facturas, Pedidos, Propuestas, etc.

  8. Ajustes de configuración que afectan el manejo de PDF

  9. Consideraciones sobre permisos y entorno del servidor

  10. ¿Qué sucede cuando se regenera un PDF?

  11. Cómo guardar y archivar archivos PDF automáticamente

  12. Seguimiento de los PDF generados por motivos legales o de auditoría

  13. Uso de repositorios de archivos externos (Dropbox, Nextcloud, FTP)

  14. Solución alternativa: copiar archivos PDF automáticamente

  15. Mejores prácticas para la conservación de documentos en Dolibarr

  16. Cómo evitar la pérdida de datos de archivos temporales

  17. Cómo los módulos personalizados gestionan el guardado de PDF

  18. Diferencias de comportamiento entre Dolibarr alojado y autoalojado

  19. Cuándo pedir ayuda a un desarrollador

  20. Conclusión: Cómo gestionar archivos PDF en Dolibarr con confianza

1. Introducción

Dolibarr es una robusta solución ERP y CRM diseñada para pequeñas y medianas empresas. Entre sus numerosas funciones se encuentra la de generar documentos PDF como facturas, presupuestos, albaranes y más. Sin embargo, una pregunta frecuente de los nuevos usuarios es: "¿Por qué Dolibarr no guarda los documentos PDF que genera por defecto?".

Este artículo profundiza en la arquitectura, la lógica y las mejores prácticas para la gestión de documentos PDF en Dolibarr. Comprender esto le ayudará a gestionar mejor sus archivos, evitar la pérdida de datos y adaptar su sistema a las necesidades de su negocio.

2. Entender cómo Dolibarr gestiona la generación de PDF

Dolibarr no utiliza archivos PDF preguardados por defecto. En su lugar, genera documentos a demanda. Cuando un usuario hace clic para ver o descargar un PDF, Dolibarr crea el archivo dinámicamente con datos de su base de datos y una plantilla predefinida.

Este enfoque garantiza que:

  • El PDF refleja los datos más recientes

  • No se desperdicia espacio en disco en archivos obsoletos o no utilizados

  • Las plantillas y diseños se pueden actualizar sin necesidad de regenerar todos los archivos existentes

3. La naturaleza temporal de los archivos PDF en Dolibarr

De forma predeterminada, Dolibarr solo guarda archivos PDF temporalmente. El sistema los almacena en... /documents/ directorio, a menudo bajo una estructura como /documents/facture/, /documents/propal/ o /documents/commande/.

Sin embargo, si el archivo ya existe, Dolibarr podría sobrescribirlo a menos que se configure de otra manera. Si regenera un documento, Dolibarr lo recrea con los datos más recientes.

4. ¿Dónde se almacenan los archivos PDF (y durante cuánto tiempo)?

Dolibarr organiza los archivos por módulo:

  • Facturas: /documents/facture/REF/

  • Pedidos: /documents/commande/REF/

  • Propuestas: /documents/propal/REF/

Estas carpetas contienen archivos PDF si se descargaron o generaron explícitamente. Sin embargo, si nunca hizo clic para generar un PDF, es posible que no exista en el disco.

Los archivos PDF se guardan a menos que se eliminen manualmente o se eliminen mediante una limpieza del sistema. No tienen caducidad automática, pero la regeneración los sobrescribirá a menos que se utilice el control de versiones de archivos.

5. Conceptos erróneos comunes sobre el guardado de documentos

Los usuarios a menudo asumen:

  • Los archivos PDF se guardan automáticamente después de la validación; no se guardan.

  • Todas las acciones crean archivos en el disco; solo la generación de documentos lo hace.

  • Los archivos PDF se almacenan de forma permanente, solo si se guardan manualmente.

Comprender que la generación de PDF está separada del almacenamiento es clave para administrar documentos en Dolibarr.

6. Generación y almacenamiento de archivos en Dolibarr

Así es como normalmente funciona Dolibarr:

  • Se crea y valida un documento (por ejemplo, una factura)

  • No se ha guardado ningún archivo en este momento

  • El usuario hace clic en “Generar PDF”

  • Dolibarr crea el archivo usando la plantilla y lo guarda en el directorio correspondiente

  • El archivo permanece hasta que se elimine o sobrescriba.

Esta separación proporciona flexibilidad pero requiere conciencia para evitar que se pierdan archivos más adelante.

7. Comportamiento del módulo: Facturas, Pedidos, Propuestas, etc.

Cada módulo maneja los documentos de forma ligeramente diferente:

  • FacturasLos archivos PDF se crean solo al hacer clic; se pueden regenerar en cualquier momento.

  • Mis pedidos:Se aplica la misma lógica

  • Propuestas:Puede incluir marca de agua y estado opcionales

Se recomienda generar y guardar archivos PDF después de la validación para mantener un registro del documento en el momento en que se finalizó.

8. Ajustes de configuración que afectan el manejo de PDF

Puedes configurar algunos comportamientos:

  • Vaya a Configuración > Módulos > Plantillas PDF

  • Establecer plantillas predeterminadas y habilitar la generación automática (en módulos limitados)

  • Utilice la configuración de la ruta del directorio del documento en Configuración > Otra configuración si se personaliza la estructura del archivo

Estas configuraciones influyen en dónde y cómo se generan y almacenan los archivos PDF.

9. Consideraciones sobre permisos y entorno del servidor

Dolibarr debe tener permisos de escritura en el /documents/ Carpeta. Si los permisos están mal configurados:

  • Es posible que no se guarden los archivos PDF

  • La generación de archivos puede fallar silenciosamente

Asegúrese de que su usuario Apache/Nginx tenga acceso correcto y que su entorno de servidor (especialmente en alojamiento compartido) admita la escritura de archivos.

10. ¿Qué sucede cuando se regenera un PDF?

Al regenerar un documento:

  • El archivo antiguo se sobrescribe (si el nombre del archivo es el mismo)

  • El contenido se actualiza para reflejar los datos actuales.

Esto es útil para corregir datos, pero problemático si necesita conservar la versión original para fines legales o de auditoría.

11. Cómo guardar y archivar archivos PDF automáticamente

Opciones para guardar automáticamente:

  • Utilice un trabajo cron para activar la generación de PDF después de la validación

  • Agregue un módulo o gancho para generar y bloquear archivos PDF automáticamente

  • Mueva archivos PDF a un directorio de archivo mediante un script

Esto garantiza que cada documento validado también se conserve en su estado original.

12. Seguimiento de los PDF generados por motivos legales o de auditoría

Para garantizar la preparación para la auditoría:

  • Generar PDFs en el momento de la validación del documento

  • Mover o copiar los archivos a un archivo de solo lectura

  • Utilice versiones (por ejemplo, factura-2025-01-V1.pdf) para evitar sobrescrituras

Esto es especialmente crítico en países con requisitos estrictos de facturación electrónica o de archivo de IVA.

13. Uso de repositorios de archivos externos (Dropbox, Nextcloud, FTP)

Dolibarr puede integrarse con almacenamiento externo:

  • Utilice módulos para sincronizar /documents/ a los servicios en la nube

  • Automatizar la copia de seguridad de archivos PDF en FTP o SFTP

  • Implementar WebDAV o carpetas compartidas para el acceso del equipo

Esto mejora la seguridad y disponibilidad de los documentos.

14. Solución alternativa: Copiar archivos PDF automáticamente

Utilice un script (bash, Python, etc.) para monitorizar el /documents/ directorio y:

  • Detectar nuevos archivos

  • Copiarlos a otra ubicación

  • Cambiarles el nombre para archivarlos

Configure este script como un trabajo cron para que se ejecute cada hora o cada día.

15. Mejores prácticas para la conservación de documentos en Dolibarr

  • Generar siempre archivos PDF tras la validación del documento

  • Utilice convenciones de nomenclatura para el seguimiento de versiones

  • Mantenga una copia de seguridad separada fuera del servidor Dolibarr

  • Capacite a los usuarios sobre cuándo y cómo generar archivos PDF

16. Cómo evitar la pérdida de datos de archivos temporales

Si nunca se generó o guardó un PDF:

  • No se puede recuperar del historial.

  • Necesitará regenerarlo, lo cual podría dejar de reflejar los datos originales.

Protéjase contra esto aplicando políticas de generación en el momento de la aprobación del documento.

17. Cómo los módulos personalizados gestionan el guardado de PDF

Algunas extensiones de Dolibarr añaden funciones de guardado automático o registro de PDF. Estos módulos pueden:

  • Generar archivos PDF automáticamente al activarse eventos

  • Registrar cuándo se creó un PDF y quién lo creó

  • Guardar copias de seguridad en sistemas externos

Elija módulos confiables de Dolistore o trabaje con un desarrollador para agregar esta capacidad.

18. Diferencias de comportamiento entre Dolibarr alojado y autoalojado

Versiones de Dolibarr alojadas (por ejemplo, proveedores de SaaS):

  • Puede limitar el acceso al sistema de archivos

  • Puede limpiar automáticamente archivos antiguos

  • A menudo se requiere un ticket de soporte para descargas masivas

Las instalaciones autohospedadas ofrecen más control sobre el almacenamiento de documentos, la creación de scripts y las copias de seguridad.

19. Cuándo pedir ayuda a un desarrollador

Comuníquese con un integrador de Dolibarr si:

  • Necesita archivado automático

  • Quiere integrar el almacenamiento en la nube

  • Tiene requisitos de versiones de PDF específicos de auditoría

Los scripts o módulos personalizados pueden superar estas brechas de manera efectiva.

20. Conclusión: Cómo gestionar archivos PDF en Dolibarr con confianza

El enfoque de Dolibarr para la generación de PDF prioriza la flexibilidad y la eficiencia, pero atribuye la responsabilidad de guardar y archivar los documentos al usuario. Una vez que comprenda cómo se generan los PDF, dónde se almacenan y cómo controlar el proceso, podrá garantizar el cumplimiento normativo, minimizar la pérdida de datos y optimizar los flujos de trabajo de su empresa.

Ya sea a través de herramientas integradas, scripts inteligentes o almacenamiento externo, Dolibarr ofrece todo lo que necesita para administrar documentos, si sabe cómo configurarlo correctamente.