주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..
견적서 PDF 생성 오류 문제 해결
마지막 업데이트 날짜: 2026년 4월 17일
견적서나 레거시 견적서를 발행하면 PDF 버전이 자동으로 생성됩니다. PDF 생성에 실패할 경우, 견적서에 오류 내용이 기록되므로 구매자에게 견적서를 보내기 전에 문제를 확인할 수 있습니다. PDF 생성 상태와 오류 세부 정보는 견적서 편집기 또는 견적서 미리 보기 패널에서 확인할 수 있습니다. 견적서와 레거시 견적서의 차이점에 대해 알아보세요.
PDF 생성 오류 확인
견적서 인덱스 페이지에서 PDF 생성 오류를 확인하세요.
-
HubSpot 계정에서 커머스 > 견적으로 이동합니다.
- 견적서 위에 마우스를 올려놓고'미리 보기'를 클릭하십시오.
- 오른쪽 패널에 PDF 생성 오류가 표시됩니다.
PDF 생성 오류 및 해결 방법
아래 표에는 발생할 수 있는 PDF 생성 오류와 제안된 해결 단계가 자세히 설명되어 있습니다.
참고: 새 견적을 게시할 때 견적이 초안 상태로 되돌아가는 경우, 이는 PDF 생성 중 발생한 오류로 인한 안전 조치입니다. 이러한 경우 PDF 생성 오류를 확인한 후, 아래 표에서 제안된 해결 방법을 검토하십시오.
| 오류 | 오류 의미 | 오류 해결 방법 |
| MISSING_SLUG | 견적서에 URL 슬러그가 없습니다. URL 슬러그는 견적서의 공개 URL을 생성하는 데 필요합니다. | 인용문을 열고, 다시불러온 후 다시 게시하십시오. 슬러그는 게시 과정에서 자동으로 할당됩니다. 다시 게시한 후에도 슬러그가 여전히 누락된 경우 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를 생성하십시오. 문제가 지속되면 견적서 ID와 HubSpot 계정 정보를 포함하여 HubSpot 지원팀에 문의하십시오. |
| CONTENT_NOT_PUBLISHED | 견적 페이지가 아직 게시되지 않았습니다. PDF로 캡처할 페이지가 없습니다. | 견적서가 무효화된 경우 이 오류가 발생합니다. 무효화된 견적서는 PDF로 생성되지 않습니다. 견적서가 무효화되지 않았다면, 견적서를 다시 불러와게시하십시오. |
| CONTENT_UNAVAILABLE | 견적서 페이지 콘텐츠를 일시적으로 이용할 수 없습니다. 이 오류는 대개 자동으로 해결됩니다. | 몇 분 정도 기다린 후 PDF 상태를 다시 확인해 주십시오. 견적서 링크가 브라우저에서 정상적으로 로드되는지 확인해 주십시오. 문제가 지속되면 견적서를 다시 불러와게시하십시오. |
도움 받기
문제 해결 후에도 오류가지속되면 HubSpot 지원팀에 문의하기 전에 다음 정보를 수집해 주십시오:
-
오른쪽 상단의 프로필 사진을 클릭하면 확인할 수 있는 HubSpot 계정 ID.
-
견적서 ID(견적서 URL에서 확인하거나 API를 통해 조회 가능).
-
견적서에 표시된 오류입니다.
-
이미 시도해 본 모든 단계.
quotes
CPQ
피드백을 보내 주셔서 감사합니다. 당사에 큰 도움이 될 것입니다.
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.