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).

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 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 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).