Salta al contenuto
Nota bene: la traduzione in italiano di questo articolo è fornita solo per comodità. La traduzione viene creata automaticamente tramite un software di traduzione e potrebbe non essere stata revisionata. Pertanto, la versione inglese di questo articolo deve essere considerata come la versione di governo contenente le informazioni più recenti. È possibile accedervi qui.

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.

  1. Nel tuo account HubSpot, passa a Commerce > Preventivi.

  2. Passa il mouse sul preventivo e cliccasu Anteprima.
  3. 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:
  1. Per i preventivi legacy, richiamare e modificare il preventivo. Modificare il modello e ripubblicare il preventivo. Se l'utilizzo di un modello diverso risolve il problema, il modello potrebbe presentare un problema di configurazione.
  2. Per i preventivi, richiamare il preventivo e crearne uno nuovo con un modello diverso.
INVALID_HOST Impossibile raggiungere il dominio del preventivo. HubSpot non è riuscito a risolvere il nome di dominio per caricare la pagina del preventivo.
  1. Nel tuo account HubSpot, fai clic sulle icona delle impostazioni nella barra di navigazione principale.
  2. Nel menu della barra laterale sinistra, vai su Contenuto > Domini e URL.
  3. Copia il dominio utilizzato per i preventivi e aprilo in un browser.
  4. Se il dominio non si carica, è possibile che il DNS sia configurato in modo errato. Se hai recentemente collegato o modificato il dominio, attendi fino a 48 ore affinché le modifiche al DNS abbiano effetto. Quindi, richiama e ripubblica il preventivo.
  5. Se il dominio è stato rimosso, configura un nuovo dominio per i preventivi, quindirichiamalo e ripubblicalo.
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.
  1. Se il preventivo non richiede firme elettroniche, richiamalo, disattiva l'impostazione della firma elettronica e ripubblicalo. 
  2. Se il preventivo richiede firme elettroniche, copia il link del preventivo, aprilo in un browser e verifica che il modulo di firma sia visibile sulla pagina. Se il modulo di firma non è visibile, modifica il modello del preventivo e assicurati che il modulo di firma elettronica sia incluso. Se il modulo di firma appare correttamente nel browser, richiama e ripubblica il preventivo per riprovare.
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:
  • Se la pagina non si carica o mostra degli errori, rimuovi la pubblicazione del modello. Individua e risolvi eventuali problemi nel modello, quindi ripubblicalo.
  • Se la pagina impiega più di 30 secondi a caricarsi, modifica il modello utilizzato per il preventivo. Riduci le immagini di grandi dimensioni, rimuovi gli script esterni e semplifica i layout. 
  • Se la pagina si carica, richiamae ripubblica il preventivo.
Se l'errore interessa più preventivi, contatta l'assistenza HubSpot.
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.

L'articolo è stato utile?
Questo modulo viene utilizzato solo per il feedback della documentazione. Scopri come ottenere assistenza con HubSpot.