- Knowledge base
- Commercio
- Preventivi
- Risoluzione degli errori di generazione dei PDF dei preventivi
Risoluzione degli errori di generazione dei PDF dei preventivi
Ultimo aggiornamento: 17 aprile 2026
Disponibile con uno qualsiasi dei seguenti abbonamenti, tranne dove indicato:
-
Postazioni richieste per determinate funzionalità
Quando pubblichi un preventivo o un preventivo legacy, viene generata automaticamente una versione PDF. Se la generazione del PDF non va a buon fine, il preventivo registra l'errore in modo che tu possa verificare il problema prima di inviare il preventivo al tuo acquirente. Visualizza lo stato della generazione del PDF e i dettagli dell'errore nell'editor dei preventivi o nel pannello di anteprima del preventivo. Scopri le differenze tra preventivi e preventivi legacy.
Visualizza gli errori di generazione del PDF
Esamina gli errori di generazione del PDF dalla pagina indice dei preventivi.
-
Nel tuo account HubSpot, passa a Commerce > Preventivi.
- Passa il mouse sul preventivo e cliccasu Anteprima.
- Gli errori di generazione del PDF vengono visualizzati nel pannello di destra.
Errori di generazione del PDF e soluzioni
La tabella seguente illustra in dettaglio gli errori di generazione del PDF che potresti riscontrare, insieme alle procedure di risoluzione proposte.
Nota: se un preventivo torna allo stato di bozza durante la pubblicazione di un nuovo preventivo, si tratta di una misura di protezione dovuta a un errore durante la generazione del PDF. In questi casi, esamina l'errore di generazione del PDF, quindi verifica la risoluzione proposta per l'errore nella tabella sottostante.
| Errore | Cosa significa l'errore | Passaggi per risolvere l'errore |
| MISSING_SLUG | Il preventivo non ha uno slug URL, necessario per creare l'URL pubblico del preventivo. | Apri la citazione, quindirichiamala e ripubblicala. Lo slug viene assegnato automaticamente durante la pubblicazione. Se lo slug continua a mancare dopo la ripubblicazione, contatta l'assistenza HubSpot. |
| MISSING_DOMAIN | Al preventivo non è stato assegnato un dominio di hosting. È necessario un dominio per ospitare la pagina del preventivo che viene convertita in PDF. | Assicurati chesia collegato undominio per i preventivi. Se un dominio è già collegato, richiama e ripubblica il preventivo. Se non è collegato alcun dominio, collega un dominio, quindi richiama e ripubblica il preventivo. |
| QUOTE_RENDER_FAILED | Impossibile visualizzare la pagina del preventivo. Non è disponibile alcuna pagina pubblicata da convertire in PDF. | Copia il link del preventivo e aprilo in un browser. Se la pagina mostra un errore 404 o di altro tipo, richiamae ripubblica il preventivo. Se la ripubblicazione non risolve l'errore:
|
| INVALID_HOST | Impossibile raggiungere il dominio del preventivo. HubSpot non è riuscito a risolvere il nome di dominio per caricare la pagina del preventivo. |
|
| MISSING_SIGNATURE_AREA | Il preventivo ha le firme elettroniche impostate come metodo di accettazione, ma il modulo della firma non è stato trovato nella pagina del preventivo. HubSpot rende il modello durante la generazione del PDF e verifica la presenza del modulo della firma. Il PDF non verrà generato senza il modulo della firma. |
|
| RISORSE_FIRMA_MANCANTI | Il preventivo ha le firme elettroniche impostate come metodo di accettazione, ma il modello di preventivo personalizzato utilizzato non contiene il modulo di contenuto o le risorse di firma elettronica richiesti. HubSpot rende il modello durante la generazione del PDF e verifica la presenza del modulo di firma. Il PDF non verrà generato senza il modulo di firma. | Modifica il modello di preventivo utilizzato dal preventivo. Nel modello, assicurati che il modulo della firma elettronica e i suoi componenti richiesti siano stati aggiunti. Puoi anche clonare un modello funzionante che abbia il modulo della firma elettronica e confrontare i due. Dopo aver aggiornato il modello, richiama e ripubblica il preventivo. |
| PDF_TOO_SMALL | Il PDF generato era vuoto o quasi vuoto. Questo di solito significa che la pagina del preventivo non è stata caricata completamente prima che il PDF fosse acquisito. | Copia il link del preventivo e aprilo in un browser. Se il preventivo si carica, è probabile che si tratti di un problema temporaneo.Richiamae ripubblica il preventivo. Se il preventivo si carica lentamente nel browser, modifica il modello utilizzato per il preventivo. Riduci le immagini di grandi dimensioni, rimuovi gli script esterni e semplifica i layout. |
| PDF_NOT_FOUND | Il file PDF non è stato trovato dopo la generazione. Si tratta spesso di un problema temporaneo relativo all'archiviazione dei file e solitamente si risolve automaticamente. | Attendi qualche minuto, quindi controlla nuovamente il preventivo. Se l'errore persiste, richiama e ripubblica il preventivo per generare un nuovo PDF. |
| ERRORE INTERNO | Si è verificato un errore imprevisto durante la generazione del PDF. Ciò può essere causato da problemi temporanei, come un caricamento lento della pagina del preventivo o una breve interruzione del servizio. | Attendi qualche minuto e ricontrolla il preventivo. Se l'errore persiste,copia il link del preventivo e aprilo in un browser:
|
| INTERNAL_CLIENT_ERROR | Un errore di richiesta ha impedito la generazione del PDF. Questo significa in genere che il servizio PDF non è riuscito ad accedere alla pagina del preventivo. | Copia il link del preventivo e aprilo in un browser. Se la pagina si carica, richiama e ripubblica il preventivo per generare un nuovo PDF. Se il problema persiste, contatta l'assistenza HubSpot fornendo l'ID del preventivo e i dettagli del tuo account HubSpot. |
| CONTENT_NOT_PUBLISHED | La pagina del preventivo non è stata ancora pubblicata. Non c'è nessuna pagina da acquisire come PDF. | Se il preventivo è stato annullato, questo errore è normale. I preventivi che sono stati annullati non generano PDF. Se il preventivo non è stato annullato, richiamaloe ripubblicalo. |
| CONTENT_UNAVAILABLE | Il contenuto della pagina del preventivo è temporaneamente non disponibile. Questo errore spesso si risolve automaticamente. | Attendere qualche minuto e ricontrollare lo stato del PDF. Verificare che il link del preventivo si carichi nel browser. Se il problema persiste, richiamaree ripubblicare il preventivo. |
Ottenere assistenza
Sel'errore persiste dopo la risoluzione dei problemi, raccogliere i seguenti dettagli prima di contattare l'assistenza HubSpot:
-
Il tuo ID account HubSpot, che trovi cliccando sulla tua foto profilo in alto a destra.
-
L'ID del preventivo, che trovi nell'URL del preventivo o tramite l'API.
-
L'errore visualizzato sul preventivo.
-
Eventuali passaggi già provati.