Preguntas frecuentes

No se genera el PDF

Compruebe los siguientes puntos:

1. El módulo DoliPDF está activado en la lista de módulos
2. Usa una plantilla de documento en formato ODT (DoliPDF no funciona con las plantillas PDF nativas de Dolibarr)
3. En modo remoto: la dirección del servidor, el correo y la clave de API están bien indicados
4. En modo local: el comando de LibreOffice es correcto y LibreOffice está instalado en el servidor
5. Si la opción Ejecutar DoliPDF solo en documentos validados está activada, compruebe que el documento tiene el estado "Validado"

Aparece el error "Error al transferir el archivo PDF"

Este error indica que el archivo PDF se recibió del servidor DoliPDF, pero la comprobación de integridad MD5 falló. El archivo pudo alterarse durante la transferencia. Vuelva a generar el documento. Si el error persiste, compruebe la conexión de red entre su servidor Dolibarr y el servidor DoliPDF.

Aparece el error "Error de DoliPDF"

Este error genérico indica que el servidor DoliPDF no pudo realizar la conversión. Las causas posibles son:

• Clave de API no válida o caducada
• Servidor DoliPDF temporalmente no disponible
• Archivo ODT dañado o en un formato no admitido
• Dirección del servidor DoliPDF incorrecta

Consulte los registros de Dolibarr (archivo dolibarr.log) para obtener más detalles sobre el error.

Para identificar la causa, utilice el botón Probar la conexión de la pestaña Configuración: comprueba la dirección del servidor y la clave de API sin convertir ningún documento, y muestra un mensaje que indica el problema.

Cómo obtener mi clave de API

Si todavía no tiene cuenta, ábrala desde la pestaña Abrir una cuenta de la configuración del módulo: la clave se guarda automáticamente en cuanto se paga su pedido (consulte la configuración).

Si ya tiene una cuenta:

1. Vaya al servidor DoliPDF (por defecto https://pdf.cap-rel.fr)
2. Inicie sesión con su cuenta
3. Abra el menú Tokens de API
4. Haga clic en Nuevo
5. Copie la clave generada en la configuración del módulo

Se rechaza la conversión: "ningún plan activo"

El servidor DoliPDF solo convierte documentos para una cuenta cuyo plan está pagado, y dentro del número de documentos de ese plan. El mensaje de error contiene un enlace Contratar un plan que abre la página de pedido.

Puedo usar mi propio servidor DoliPDF

Sí. Indique la dirección de su servidor en el campo Dirección del servidor DoliPDF de la configuración. Su servidor debe ofrecer una API compatible con el protocolo DoliPDF. Desde la versión 1.0.18, el módulo llama a las direcciones /api/v1/pdf (conversión) y /api/v1/ping (prueba de conexión): compruebe que su servidor las expone antes de actualizar.

El modo local no funciona

Compruebe que:

• La opción Usar LibreOffice instalado localmente está activada
• El comando indicado en Comando local es correcto y lo puede ejecutar el usuario del servidor web (por ejemplo www-data)
• LibreOffice está instalado en el servidor y es accesible desde la línea de comandos
• El usuario del servidor web tiene permisos de escritura en el directorio de destino de los archivos PDF

El PDF se regenera en cada modificación de línea

Por defecto, Dolibarr regenera el documento cada vez que se añade o modifica una línea de producto, lo que inicia una conversión DoliPDF. Para evitarlo, active la opción Desactivar la creación del PDF cada vez que se añade o modifica una línea de producto en la configuración del módulo.

DoliPDF y los documentos PDF nativos de Dolibarr

DoliPDF solo convierte archivos ODT a PDF. Si usa las plantillas PDF nativas de Dolibarr (como crabe, sponge, etc.), Dolibarr genera directamente el PDF sin pasar por DoliPDF.

Versiones de Dolibarr compatibles

DoliPDF es compatible con Dolibarr 14 y superior (comprobado hasta Dolibarr 24), con PHP 7.4 como mínimo. El módulo incluye una capa de compatibilidad para las versiones anteriores a Dolibarr 16.0 (clase FormSetup).