排除報價單 PDF 產生錯誤的疑難排解
上次更新時間: 2026年6月29日
當您發佈 報價或舊版報價時,系統會自動產生 PDF 版本。若 PDF 產生失敗,報價單會記錄該錯誤,以便您在將報價單發送給買方之前檢視問題。您可在報價編輯器或報價預覽面板中查看 PDF 產生狀態及錯誤詳細資訊。瞭解報價與舊版報價之間的差異。
開始之前
舊版報價單已不再提供給新使用者使用。 HubSpot 的 AI 驅動型 CPQ 提供增強的報價功能,並可搭配 Revenue HubProfessional或Enterprise帳戶。若您使用的是 Revenue HubProfessional或Enterprise帳戶,請瞭解如何 建立報價單。
非Revenue Hub 2025 年 9 月 3日之前建立的非「Revenue Hub」專業版或企業版帳戶,可能仍可存取舊版報價單:
- 免費帳戶的使用者:若在2025 年 9 月 3 日前六個月內曾建立一份或多份報價單,即可存取舊版報價單。
- Sales Hub帳戶的使用者: 在 2025 年 9 月 3 日之後仍可存取舊版報價單。
檢視 PDF 生成錯誤
請從報價單索引頁面檢視 PDF 生成錯誤。
-
在你的 HubSpot 帳戶中,點擊「更多」,然後前往收入 > 「報價」。如果你的帳戶中沒有顯示「更多」,請直接前往收入 > 「報價」。
- 將游標懸停在報價單上,然後點擊「預覽」。
- PDF 產生錯誤會顯示在右側面板中。
PDF 生成錯誤及解決方案
下表詳列您可能遇到的 PDF 生成錯誤,並提供建議的解決步驟。
請注意:若在發佈新報價單時,該報價單恢復為草稿狀態,這是由於 PDF 生成過程中發生錯誤而採取的防護措施。在此情況下,請先檢視 PDF 生成錯誤,然後參照下表中針對該錯誤的建議解決方案。
| 錯誤 | 錯誤的含義 | 解決此錯誤的步驟 |
| MISSING_SLUG | 該報價單缺少 URL 簡稱(slug),而此項資訊是建立報價單公開網址所必需的。 | 請開啟該報價,然後重新調用並重新發佈。發佈過程中系統會自動指派 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 查詢。
-
報價單上顯示的錯誤訊息。
-
您已經嘗試過的任何步驟。