Índice

  1. Introducción

  2. Síntomas comunes de problemas de visualización de PDF

  3. Cómo Dolibarr genera documentos PDF

  4. Módulos clave involucrados en la creación de PDF

  5. Confirmación de su versión de Dolibarr y compatibilidad con PHP

  6. Requisitos del servidor y dependencias de PDF

  7. Causas comunes de fallos en la representación de PDF

  8. Comprobación de problemas con la biblioteca PHP (TCPDF/FPDF)

  9. Diagnóstico de problemas de permisos de archivos

  10. Archivos de plantilla PDF dañados o faltantes

  11. Registros de errores: cómo localizarlos e interpretarlos

  12. Solución a problemas de pantalla blanca o salida PDF vacía

  13. Problemas con plantillas PDF personalizadas o de terceros

  14. Solución de problemas después de una actualización o migración de Dolibarr

  15. Configuración PHP recomendada para la generación de PDF

  16. Actualización manual de TCPDF (si es necesario)

  17. Uso del modo de depuración de Dolibarr para identificar errores

  18. Reinstalación o reparación del módulo PDF Core

  19. Uso de utilidades del sistema para probar la salida PDF fuera de Dolibarr

  20. Conclusión y mejores prácticas a largo plazo


1. Introducción

Si sus archivos PDF ya no se muestran correctamente en Dolibarr, ya sea en facturas, propuestas, albaranes o presupuestos, no está solo. Los problemas con la generación de PDF son una de las solicitudes de soporte más comunes en los foros de Dolibarr, especialmente después de actualizaciones o migraciones del sistema.

Esta guía lo guiará a través de la identificación y solución de las causas fundamentales de los problemas de representación de PDF en Dolibarr ERP, con un enfoque específico en los cambios observados en 2025.

2. Síntomas comunes de problemas de visualización de PDF

  • Al hacer clic en "Generar PDF" no ocurre nada.

  • Pantalla blanca al generar PDF

  • El archivo se descarga pero está dañado o en blanco

  • Mensaje de error como "Error TCPDF" o "No se puede abrir el archivo"

  • Solo se muestra contenido parcial en los PDF generados

3. Cómo Dolibarr genera documentos PDF

Dolibarr utiliza bibliotecas basadas en PHP (principalmente TCPDF) para generar contenido PDF dinámico para módulos como:

  • Facturas

  • Mis pedidos

  • Propuestas

  • Contratos

  • Entregas

Estos documentos se construyen a partir de plantillas ubicadas en /core/modules/.../doc/.

4. Módulos clave involucrados en la creación de PDF

  • Biblioteca TCPDF (incluida con Dolibarr)

  • Archivos de modelo PDF (por ejemplo, pdf_crabe.modules.php)

  • Scripts de generación de documentos (builddoc.php)

  • Carpetas de carga y temporales (/documents/)

5. Confirmación de su versión de Dolibarr y compatibilidad con PHP

En 2025, Dolibarr es compatible con PHP 8.1 y versiones posteriores. La incompatibilidad entre su versión de Dolibarr y la versión activa de PHP podría afectar las funciones de PDF. Verifique siempre:

  • Versión de Dolibarr en Inicio > Acerca de

  • Versión PHP a través de un phpinfo() script o panel de alojamiento

6. Requisitos del servidor y dependencias de PDF

Asegúrese de que su servidor cumpla con los requisitos de generación de PDF de Dolibarr:

  • biblioteca GD

  • zlib

  • mbstring

  • fileinfo

  • Modo seguro desactivado (para configuraciones PHP más antiguas)

7. Causas comunes de fallos en la representación de PDF

  • Biblioteca TCPDF faltante o desactualizada

  • Archivo de plantilla dañado en /doc/

  • Los límites de memoria de PHP son demasiado bajos

  • Módulos de terceros en conflicto

  • Los permisos del servidor web impiden la escritura de archivos

8. Comprobación de problemas con la biblioteca PHP (TCPDF/FPDF)

Los problemas con TCPDF suelen aparecer después de las actualizaciones. Verificar:

  • /includes/tcpdf/tcpdf.php está presente y sin modificaciones

  • No hay errores fatales en dolibarr.log

  • No hay avisos de PHP sobre métodos TCPDF obsoletos

9. Diagnóstico de problemas de permisos de archivos

Asegúrese de que Dolibarr documents directorio y sus subcarpetas:

  • Existe

  • Son escribibles por el usuario del servidor web (por ejemplo, www-data)

Uso:

chmod -R 755 htdocs/documents
chown -R www-data:www-data htdocs/documents

10. Archivos de plantilla PDF dañados o faltantes

  • Vaya a Configuración > Módulos > Facturas > Configurar

  • Cambiar a otra plantilla (por ejemplo, de Azur a Crabe)

  • Comprueba si el problema persiste

Faltante o modificado pdf_* Los archivos pueden romper la generación.

11. Registros de errores: cómo localizarlos e interpretarlos

Habilitar el modo de depuración:

  • Editar conf.php

  • Establecer $dolibarr_main_prod = 0;

  • Revisar /dolibarr/documents/dolibarr.log o registros del servidor web

Busque errores fatales de PHP o mensajes de funciones faltantes.

12. Solución a problemas de pantalla blanca o salida PDF vacía

  • Aumentar el límite de memoria en php.ini

  • Compruebe que todos los campos obligatorios estén rellenados (por ejemplo, nombre de la empresa, dirección)

  • Cambiar plantillas para descartar errores personalizados

13. Problemas con plantillas PDF personalizadas o de terceros

Las plantillas personalizadas suelen fallar tras actualizar la versión de Dolibarr. Solución:

  • Comparar con plantillas oficiales

  • Reemplazar los métodos TCPDF obsoletos

  • Reinstale las plantillas base si no está seguro

14. Solución de problemas después de una actualización o migración de Dolibarr

  • Volver a copiar archivos faltantes o sobrescritos

  • Limpiar la caché del navegador y de Dolibarr

  • Comprobar la compatibilidad de la versión PHP

15. Configuración recomendada de PHP para la generación de PDF

Asegurar:

  • memory_limit = 256M

  • max_execution_time = 60

  • file_uploads = On

  • upload_max_filesize = 20M

16. Actualización manual de TCPDF (si es necesario)

  1. Descargue la última versión de TCPDF desde GitHub

  2. Reemplazar el contenido en /includes/tcpdf

  3. Pruebe nuevamente la salida PDF

Precaución: Es posible que sea necesario adaptar las plantillas personalizadas para que coincidan con las versiones actualizadas de TCPDF.

17. Uso del modo de depuración de Dolibarr para identificar errores

  • Vaya a Administración > Módulos > Herramientas de depuración

  • Habilitar el registro de errores en la pantalla

  • Vuelva a intentar la generación del PDF y capture los detalles del error

18. Reinstalación o reparación del módulo PDF Core

Para restablecer los módulos PDF predeterminados:

  • Desactivar módulo (p. ej. Facturas)

  • Volver a subir el original /doc/ plantillas de carpeta

  • Reactivar el módulo

19. Uso de utilidades del sistema para probar la salida PDF fuera de Dolibarr

Para descartar causas externas:

  • Cree un archivo PHP TCPDF independiente para generar un PDF

  • Pruebe la representación de PDF independientemente de Dolibarr

  • Usar herramientas como wkhtmltopdf como respaldo si es necesario

20. Conclusión y mejores prácticas a largo plazo

Para evitar problemas recurrentes con PDF en Dolibarr:

  • Mantén tu versión actualizada

  • Realice una copia de seguridad de sus plantillas personalizadas

  • Monitorear la compatibilidad después de cada actualización

  • Utilice plantillas estándar al solucionar problemas

Si sigue esta guía de solución de problemas centrada en 2025, podrá diagnosticar y resolver con confianza problemas de PDF en Dolibarr y mantener una generación fluida de documentos para los flujos de trabajo de su negocio.