Índice
-
Introducción
-
Síntomas comunes de problemas de visualización de PDF
-
Cómo Dolibarr genera documentos PDF
-
Módulos clave involucrados en la creación de PDF
-
Confirmación de su versión de Dolibarr y compatibilidad con PHP
-
Requisitos del servidor y dependencias de PDF
-
Causas comunes de fallos en la representación de PDF
-
Comprobación de problemas con la biblioteca PHP (TCPDF/FPDF)
-
Diagnóstico de problemas de permisos de archivos
-
Archivos de plantilla PDF dañados o faltantes
-
Registros de errores: cómo localizarlos e interpretarlos
-
Solución a problemas de pantalla blanca o salida PDF vacía
-
Problemas con plantillas PDF personalizadas o de terceros
-
Solución de problemas después de una actualización o migración de Dolibarr
-
Configuración PHP recomendada para la generación de PDF
-
Actualización manual de TCPDF (si es necesario)
-
Uso del modo de depuración de Dolibarr para identificar errores
-
Reinstalación o reparación del módulo PDF Core
-
Uso de utilidades del sistema para probar la salida PDF fuera de Dolibarr
-
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.phpestá 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.logo 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)
-
Descargue la última versión de TCPDF desde GitHub
-
Reemplazar el contenido en
/includes/tcpdf -
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
wkhtmltopdfcomo 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.
