콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

견적서 PDF 생성 오류 문제 해결

마지막 업데이트 날짜: 2026년 4월 17일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

  • 특정 기능에 대해 시트 필요

견적서나 레거시 견적서를 발행하면 PDF 버전이 자동으로 생성됩니다. PDF 생성에 실패할 경우, 견적서에 오류 내용이 기록되므로 구매자에게 견적서를 보내기 전에 문제를 확인할 수 있습니다. PDF 생성 상태와 오류 세부 정보는 견적서 편집기 또는 견적서 미리 보기 패널에서 확인할 수 있습니다. 견적서와 레거시 견적서의 차이점에 대해 알아보세요.

PDF 생성 오류 확인

견적서 인덱스 페이지에서 PDF 생성 오류를 확인하세요.

  1. HubSpot 계정에서 커머스 > 견적으로 이동합니다.

  2. 견적서 위에 마우스를 올려놓고'미리 보기'를 클릭하십시오.
  3. 오른쪽 패널에 PDF 생성 오류가 표시됩니다.

PDF 생성 오류 및 해결 방법

아래 표에는 발생할 수 있는 PDF 생성 오류와 제안된 해결 단계가 자세히 설명되어 있습니다.

참고: 새 견적을 게시할 때 견적이 초안 상태로 되돌아가는 경우, 이는 PDF 생성 중 발생한 오류로 인한 안전 조치입니다. 이러한 경우 PDF 생성 오류를 확인한 후, 아래 표에서 제안된 해결 방법을 검토하십시오.

오류 오류 의미 오류 해결 방법
MISSING_SLUG 견적서에 URL 슬러그가 없습니다. URL 슬러그는 견적서의 공개 URL을 생성하는 데 필요합니다. 인용문을 열고, 다시불러온 후 다시 게시하십시오. 슬러그는 게시 과정에서 자동으로 할당됩니다. 다시 게시한 후에도 슬러그가 여전히 누락된 경우 HubSpot 지원팀에 문의하십시오.
MISSING_DOMAIN 견적서에 할당된 호스팅 도메인이 없습니다. PDF로 변환되는 견적서 페이지를 호스팅하려면 도메인이 필요합니다. 견적서에도메인이 연결되어 있는지 확인하십시오. 도메인이 이미 연결되어 있다면, 견적서를 다시 불러와 게시하십시오. 도메인이 연결되어 있지 않다면, 도메인을 연결한 후 견적서를 다시 불러와 게시하십시오.
QUOTE_RENDER_FAILED 견적서를 렌더링할 수 없습니다. PDF로 변환할 수 있는 게시된 페이지가 없습니다. 견적 링크를 복사하여 브라우저에서 열어보세요. 페이지에 404 오류나 기타 오류가 표시되면 견적을 다시 불러와게시하세요.

다시 게시해도 오류가 해결되지 않는 경우:
  1. 기존 견적서의 경우, 견적서를 다시 불러와 편집하십시오. 템플릿을 변경한 후 견적서를 다시 게시하십시오. 다른 템플릿을 사용하면 문제가 해결된다면, 해당 템플릿에 구성 문제가 있을 수 있습니다.
  2. 견적의 경우, 해당 견적을 취소하고 다른 템플릿을 사용하여 새 견적을 생성하십시오.
INVALID_HOST 견적서의 도메인에 연결할 수 없습니다. HubSpot에서 도메인 이름을 확인하여 견적서 페이지를 불러올 수 없었습니다.
  1. HubSpot 계정의 상단 탐색 모음에서 설정 아이콘을 클릭합니다.
  2. 왼쪽 사이드바 메뉴에서 다음으로 이동하십시오. 콘텐츠 > 도메인 및 URL로 이동합니다.
  3. 견적에 사용된 도메인을 복사한 후 브라우저에서 열어보세요.
  4. 도메인이 로드되지 않는 경우, DNS가 잘못 설정되었을 수 있습니다. 최근에 도메인을 연결하거나 변경한 경우, DNS 변경 사항이 적용될 때까지 최대 48시간을 기다리십시오. 그런 다음 견적을 다시 불러와 게시하십시오.
  5. 도메인이 삭제된 경우, 견적용 새 도메인을 설정한 후 견적을취소하고 다시 게시하십시오.
MISSING_SIGNATURE_AREA 견적서의 수락 방법으로 전자 서명이 설정되어 있지만, 견적서 페이지에서 서명 모듈을 찾을 수 없습니다. HubSpot은 PDF 생성 시 템플릿을 렌더링하고 서명 모듈이 있는지 확인합니다. 서명 모듈이 없으면 PDF가 생성되지 않습니다.
  1. 견적서에 전자 서명이 필요하지 않은 경우, 견적서를 다시 불러와 전자 서명 설정을 해제한 후 다시 게시하십시오. 
  2. 견적서에 전자 서명이 필요한 경우, 견적서 링크를 복사하여 브라우저에서 열고 페이지에 서명 모듈이 표시되는지 확인하십시오. 서명 모듈이 보이지 않는다면 견적서 템플릿을 편집하여 전자 서명 모듈이 포함되어 있는지 확인하십시오. 브라우저에 서명 모듈이 정상적으로 표시된다면 견적서를 취소하고 다시 게시하여 다시 시도하십시오.
MISSING_SIGNATURE_ASSETS 견적서의 수락 방법으로 전자 서명이 설정되어 있지만, 사용된 사용자 지정 견적서 템플릿에 필수 전자 서명 콘텐츠 모듈이나 자산이 포함되어 있지 않습니다. HubSpot은 PDF 생성 중에 템플릿을 렌더링하고 서명 모듈을 확인합니다. 서명 모듈이 없으면 PDF가 생성되지 않습니다. 견적서에 사용된견적서 템플릿을 편집하십시오. 템플릿에서 전자 서명 모듈과 필수 구성 요소가 추가되었는지 확인하십시오. 전자 서명 모듈이 포함된 정상 작동하는 템플릿을 복제하여 두 개를 비교해 볼 수도 있습니다. 템플릿을 업데이트한 후, 견적서를 다시 불러와 다시 게시하십시오.
PDF_TOO_SMALL 생성된 PDF가 비어 있거나 거의 비어 있습니다. 이는 일반적으로 PDF가 캡처되기 전에 견적 페이지가 완전히 로드되지 않았음을 의미합니다. 견적서 링크를 복사하여 브라우저에서 열어보세요. 견적서가 로드된다면 일시적인 문제일 가능성이 높습니다. 견적서를 다시불러와다시 게시하세요.
브라우저에서 견적서가 느리게 로드된다면, 해당 견적서에 사용된 템플릿을 수정하십시오. 큰 이미지 크기를 줄이고, 외부 스크립트를 제거하며, 레이아웃을 단순화하십시오. 
PDF_NOT_FOUND 생성 후 PDF 파일을 찾을 수 없습니다. 이는 대개 파일 저장소의 일시적인 문제로, 보통 자동으로 해결됩니다. 몇 분 정도 기다린 후 견적을 다시 확인하십시오. 오류가 지속되면 견적을 다시 불러와 게시하여 새로운 PDF를 생성하십시오.
INTERNAL_ERROR PDF 생성 중에 예기치 않은 오류가 발생했습니다. 이는 견적 페이지 로딩 속도가 느리거나 일시적인 서비스 중단과 같은 일시적인 문제로 인해 발생할 수 있습니다.  몇 분 정도 기다린 후 견적서를 확인해 주십시오. 오류가 계속되면견적서 링크를 복사하여 브라우저에서 열어보십시오:
  • 페이지가 로드되지 않거나 오류가 표시되면 템플릿의 게시를 취소하십시오. 템플릿에서 잠재적인 문제를 찾아 수정하고 다시 게시하십시오.
  • 페이지 로딩에 30초 이상 걸리는 경우, 견적서에 사용된 템플릿을 수정하십시오. 큰 이미지 크기를 줄이고, 외부 스크립트를 제거하며, 레이아웃을 간소화하십시오. 
  • 페이지가 로드되면 견적을 다시 불러와게시하세요.
오류가 여러 견적서에 영향을 미치는 경우, HubSpot 지원팀에 문의하십시오.
INTERNAL_CLIENT_ERROR 요청 오류로 인해 PDF가 생성되지 않았습니다. 이는 일반적으로 PDF 서비스에서 견적 페이지에 액세스할 수 없음을 의미합니다. 견적서 링크를 복사하여 브라우저에서 열어보세요. 페이지가 로드되면,
견적서를 다시 불러와 게시하여 새로운 PDF를 생성하십시오. 문제가 지속되면 견적서 ID와 HubSpot 계정 정보를 포함하여 HubSpot 지원팀에 문의하십시오.
CONTENT_NOT_PUBLISHED 견적 페이지가 아직 게시되지 않았습니다. PDF로 캡처할 페이지가 없습니다. 견적서가 무효화된 경우 이 오류가 발생합니다. 무효화된 견적서는 PDF로 생성되지 않습니다. 견적서가 무효화되지 않았다면, 견적서를 다시 불러와게시하십시오.

CONTENT_UNAVAILABLE 견적서 페이지 콘텐츠를 일시적으로 이용할 수 없습니다. 이 오류는 대개 자동으로 해결됩니다.  몇 분 정도 기다린 후 PDF 상태를 다시 확인해 주십시오. 견적서 링크가 브라우저에서 정상적으로 로드되는지 확인해 주십시오. 문제가 지속되면 견적서를 다시 불러와게시하십시오.

도움 받기

문제 해결 후에도 오류가지속되면 HubSpot 지원팀에 문의하기 전에 다음 정보를 수집해 주십시오:

  • 오른쪽 상단의 프로필 사진을 클릭하면 확인할 수 있는 HubSpot 계정 ID.

  • 견적서 ID(견적서 URL에서 확인하거나 API를 통해 조회 가능).

  • 견적서에 표시된 오류입니다.

  • 이미 시도해 본 모든 단계.

이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.