請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。
解決報價 PDF 產生錯誤的問題
上次更新時間: 2026年4月17日
當您發佈報價 單或舊版報價單時,系統會自動產生 PDF 版本。若 PDF 產生失敗,報價單會記錄該錯誤,以便您在將報價單發送給買家前檢視問題。您可在報價單編輯器或報價單預覽面板中查看 PDF 產生狀態及錯誤詳細資訊。瞭解報價單與舊版報價單之間的差異。
檢視 PDF 生成錯誤
從報價單索引頁面檢視 PDF 生成錯誤。
-
在你的 HubSpot 帳戶中,瀏覽「商務」>「報價」。
- 將滑鼠懸停於報價單上,然後點擊「預覽」。
- PDF 生成錯誤會顯示在右側面板中。
PDF 生成錯誤與解決方案
下表詳列您可能遇到的 PDF 生成錯誤,並提供建議的解決步驟。
請注意:若在發佈新報價單時,報價單狀態恢復為草稿,這是因 PDF 生成過程發生錯誤而採取的保護措施。在此情況下,請檢視 PDF 生成錯誤,並參照下表中的建議解決方案。
| 錯誤 | 錯誤的含義 | 解決錯誤的步驟 |
| MISSING_SLUG | 該報價缺少 URL 短網址,而此資訊是建立報價公開網址所必需的。 | 請開啟該引言,然後重新呼叫並重新發佈。發佈時系統會自動指派 slug。若重新發佈後仍未出現 slug,請聯絡HubSpot 支援團隊。 |
| MISSING_DOMAIN | 報價單未指派主機網域。需有網域才能託管將報價單轉換為 PDF 的頁面。 | 請確認報價單已連結網域。若已連結網域,請重新載入並重新發佈報價單。若未連結網域,請先連結網域, 然後重新載入並重新發佈報價單。 |
| QUOTE_RENDER_FAILED | 無法渲染報價單頁面。目前沒有已發佈的頁面可供轉換為 PDF。 | 請複製報價單連結並在瀏覽器中開啟。若頁面顯示 404 或其他錯誤,請重新調用並重新發佈報價單。 若重新發佈仍無法解決此錯誤: |
| INVALID_HOST | 無法連接到報價單的網域。HubSpot 無法解析網域名稱以載入報價單頁面。 | |
| MISSING_SIGNATURE_AREA | 該報價單設定了電子簽名作為接受方式,但在報價單頁面上找不到簽名模組。HubSpot 會在生成 PDF 時渲染範本並檢查簽名模組。若無簽名模組,PDF 將無法生成。 | |
| MISSING_SIGNATURE_ASSETS | 報價單已設定電子簽名作為接受方式,但所使用的自訂報價單範本未包含所需的電子簽名內容模組或資產。HubSpot 會在 PDF 生成過程中渲染範本並檢查簽名模組。若無簽名模組,將無法生成 PDF。 | 請編輯該報價單所使用的報價單範本。在範本中,請確認已新增電子簽名模組及其所需元件。您亦可複製一個已包含電子簽名模組且運作正常的範本,並將兩者進行比對。更新範本後,請重新調用並重新發佈該報價單。 |
| PDF_TOO_SMALL | 生成的 PDF 為空白或幾乎為空。這通常表示報價單頁面在擷取 PDF 之前尚未完全載入。 | 複製報價單連結並在瀏覽器中開啟。若報價單能正常載入,則可能是暫時性問題。請重新調用並重新發佈該報價單。 若報價單在瀏覽器中載入緩慢,請編輯該報價單所使用的範本。縮小大尺寸圖片、移除外部腳本,並簡化版面配置。 |
| PDF_NOT_FOUND | 生成後無法找到 PDF 檔案。這通常是檔案儲存的暫時性問題,且通常會自動解決。 | 請等待幾分鐘,然後再次檢查報價單。若錯誤持續存在,請重新調用並重新發布報價單以生成新的 PDF 檔案。 |
| INTERNAL_ERROR | 在生成 PDF 時發生了意外錯誤。這可能是由於暫時性問題所致,例如報價頁面載入緩慢或服務短暫中斷。 | 請稍等幾分鐘後再次查看報價。若錯誤仍未解決,請複製報價連結並在瀏覽器中開啟:
|
| INTERNAL_CLIENT_ERROR | 發生請求錯誤,導致無法產生 PDF。這通常表示 PDF 服務無法存取報價單頁面。 | 請複製報價單連結並在瀏覽器中開啟。若頁面能正常載入, 請收回並重新發佈報價單以產生新的 PDF。若問題持續存在,請聯絡HubSpot 支援團隊,並提供您的報價單 ID 及 HubSpot 帳戶詳細資訊。 |
| CONTENT_NOT_PUBLISHED | 報價頁面尚未發布。目前沒有可擷取為 PDF 的頁面。 | 若報價單已作廢,此錯誤屬預期情況。已作廢的報價單不會產生 PDF。若報價單尚未作廢,請撤回並重新發佈該報價單。 |
| CONTENT_UNAVAILABLE | 報價單頁面的內容暫時無法取得。此錯誤通常會自動解決。 | 請等待幾分鐘後再次檢查 PDF 狀態。確認報價單連結能否在瀏覽器中正常載入。若問題持續存在,請重新調出並重新發佈該報價單。 |
尋求協助
若排除故障後錯誤仍持續發生,請在聯絡HubSpot 支援團隊前收集以下詳細資訊:
-
您的 HubSpot 帳戶 ID,請點擊右上角的個人檔案圖片即可查看。
-
報價單 ID,可從報價單網址中取得,或透過API 查詢。
-
報價單上顯示的錯誤。
-
您已嘗試過的任何步驟。
quotes
CPQ
你的意見回饋對我們相當重要,謝謝。
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。