---
title: "FAQ"
weight: 50
description: "Domande frequenti sul modulo DoliPDF: risoluzione dei problemi, errori comuni e consigli."
source_hash: "80ea28ec"
---

# FAQ

## Il PDF non viene generato, cosa fare?

Verifichi i seguenti punti:

1. Il modulo DoliPDF è attivato nell'elenco dei moduli
2. Usa un modello di documento in formato ODT (DoliPDF non funziona con i modelli PDF nativi di Dolibarr)
3. In modalità remota: l'indirizzo del server, l'email e la chiave API sono indicati correttamente
4. In modalità locale: il comando LibreOffice è corretto e LibreOffice è installato sul server
5. Se l'opzione **Esegui DoliPDF solo sui documenti convalidati** è attiva, verifichi che il documento abbia lo stato "Convalidato"

## Ottengo l'errore "Errore durante il trasferimento del file PDF"

Questo errore indica che il file PDF è stato ricevuto dal server DoliPDF ma che il controllo di integrità MD5 è fallito. Il file potrebbe essere stato alterato durante il trasferimento. Provi a rigenerare il documento. Se l'errore persiste, verifichi la connessione di rete tra il suo server Dolibarr e il server DoliPDF.

## Ottengo l'errore "Errore DoliPDF"

Questo errore generico indica che il server DoliPDF non è riuscito a eseguire la conversione. Le cause possibili sono:

- Chiave API non valida o scaduta
- Server DoliPDF temporaneamente non disponibile
- File ODT danneggiato o in un formato non supportato
- Indirizzo del server DoliPDF errato

Consulti i log di Dolibarr (file `dolibarr.log`) per ottenere maggiori dettagli sull'errore.

Per individuare la causa, utilizzi il pulsante **Verifica la connessione** della scheda **Configurazione**: controlla l'indirizzo del server e la chiave API senza convertire alcun documento, e mostra un messaggio che indica il problema.

## Come ottengo la mia chiave API?

Se non ha ancora un account, lo apra dalla scheda **Apri un account** della configurazione del modulo: la chiave viene salvata automaticamente non appena l'ordine è pagato (vedere la [configurazione](/dolipdf/configuration)).

Se ha già un account:

1. Vada sul server DoliPDF (per impostazione predefinita `https://pdf.cap-rel.fr`)
2. Acceda con il suo account
3. Apra il menu **Token API**
4. Clicchi su **Nuovo**
5. Copi la chiave generata nella [configurazione](/dolipdf/configuration) del modulo

## La conversione viene rifiutata: "nessun piano attivo"

Il server DoliPDF converte i documenti solo per un account il cui piano è pagato, ed entro il numero di documenti di quel piano. Il messaggio di errore contiene un link **Ordina un piano** che apre la pagina d'ordine.

## Posso usare il mio server DoliPDF?

Sì. Indichi l'indirizzo del suo server nel campo **Indirizzo del server DoliPDF** della configurazione. Il suo server deve esporre un'API compatibile con il protocollo DoliPDF. Dalla versione 1.0.18, il modulo chiama gli indirizzi `/api/v1/pdf` (conversione) e `/api/v1/ping` (verifica della connessione): controlli che il suo server li esponga prima di aggiornare.

## La modalità locale non funziona

Verifichi che:

- L'opzione **Usa LibreOffice installato localmente** sia attiva
- Il comando indicato in **Comando locale** sia corretto ed eseguibile dall'utente del server web (per esempio `www-data`)
- LibreOffice sia installato sul server e accessibile dalla riga di comando
- L'utente del server web abbia i permessi di scrittura nella cartella di destinazione dei file PDF

## Il PDF viene rigenerato a ogni modifica di riga

Per impostazione predefinita Dolibarr rigenera il documento a ogni aggiunta o modifica di una riga articolo, il che avvia una conversione DoliPDF. Per evitarlo, attivi l'opzione **Disattiva la creazione del PDF a ogni aggiunta o modifica di una riga articolo** nella [configurazione](/dolipdf/configuration) del modulo.

## DoliPDF funziona con i documenti PDF nativi di Dolibarr?

No. DoliPDF converte solo i file ODT in PDF. Se usa i modelli PDF nativi di Dolibarr (come `crabe`, `sponge`, ecc.), Dolibarr genera direttamente il PDF senza passare da DoliPDF.

## Quali versioni di Dolibarr sono supportate?

DoliPDF è compatibile con Dolibarr 14 e superiori (verificato fino a Dolibarr 24), con PHP 7.4 come minimo. Il modulo include un livello di compatibilità per le versioni precedenti a Dolibarr 16.0 (classe `FormSetup`).