베타계약을 HubSpot으로 이전하기
마지막 업데이트 날짜: 2026년 7월 23일
기존 계약을 레거시 시스템에서 HubSpot으로 이전하여 청구, 송장 발행 및 매출 보고를 관리하세요. 이 이전 과정에서는 결제 수단, 계약 내역 및 향후 청구 일정이 그대로 유지됩니다. 이전이 완료되면 HubSpot을 확정 매출에 대한 중앙 집중식 신뢰할 수 있는 정보원으로 활용할 수 있습니다. HubSpot에서 계약 기능을 사용하는 방법에 대해 자세히 알아보세요.
시작하기 전에
이 기능을 사용하기 전에, 사전에 수행해야 할 단계와 기능의 제한 사항, 그리고 사용 시 발생할 수 있는 결과를 충분히 숙지하시기 바랍니다.
요구 사항 파악
-
참고 사항: 귀하가 슈퍼 관리자인 경우, 계정을 'Revenue Hub 계약으로의 청구 마이그레이션' 베타 프로그램에 참여할 수 있습니다.
-
HubSpot 계정에서 Stripe를 결제 처리 옵션으로사용해야 합니다 . HubSpot 결제를 사용 중이며 외부 Stripe 계정의 결제 수단을 HubSpot 결제로 이전하려는 경우 , 이 양식을 작성해 주세요 .
-
선택한 결제 수금 프로세스 및 수익 연속성 옵션에 따라 CSV의 형식을 지정하십시오. 비즈니스에 가장 적합한 마이그레이션 형식 선택에 대해 자세히 알아보세요.
제한 사항 및 고려 사항 파악
- 수익 연속성 기능을 사용하는 경우, 샌드박스 환경에서 가져오기 테스트를 수행하십시오. 계정에 잘못된 데이터가 가져오면 MRR 폭포형 보고서에서 과거 데이터를 수정할 수 없습니다.
- 계약이 활성화되면 HubSpot이 청구에 대한 공식 기록 시스템이 됩니다. 마이그레이션은 되돌릴 수 없습니다.
- 계약 업데이트는 반드시 HubSpot에서 수행해야 합니다. 계약 확인 및 관리에 대해 자세히 알아보세요.
- 활성화 후에는 계약에 미결제 청구서나 결제 내역이 없는 경우에만 ‘청구 시작일 재정의 ’ 및 ‘결제 수단 ID’를 업데이트할 수 있습니다.
마이그레이션 형식 선택
마이그레이션 전에, 마이그레이션 후 HubSpot이 계약을 관리할 방식에 따라 마이그레이션 형식을 선택하십시오. 마이그레이션 형식은 수집 프로세스와 과거 계약 변경 내역(예: 업그레이드 또는 확장)을 포함할지 여부에 따라 달라집니다.
결제 수금 프로세스
- 수동 결제: 마이그레이션 후, 구매자가 수동으로 결제할 수 있도록 청구서가 생성됩니다.
- 자동 결제: 마이그레이션 후, 등록된 결제 수단을 사용하여 청구서가 자동으로 청구됩니다.
매출 연속성
- 매출 연속성 없음: 계약은 매출 변경 이벤트 없이 가져옵니다.
- 매출 연속성: 램프 키를 사용하여 항목들을 단계별로 그룹화하고 HubSpot의 MRR 폭포형 차트에 변경 이벤트(예: 업그레이드, 확장, 다운그레이드)를 표시합니다. 매출 연속성을 사용하는 경우, 샌드박스 환경에서 가져오기를 테스트하십시오. 계정에 잘못된 데이터가 가져오면 MRR 폭포형 차트 보고서에서 과거 데이터를 수정할 수 없습니다.
램프
램프 키
램프 키는 여러 항목 행을 단계별로 그룹화합니다. 동일한 램프 키를 가진 행들은 하나의 연속적인 램프로 처리됩니다.
HubSpot에서는 각 램프 단계가 시작될 때마다 MRR 이벤트(예: 신규 계약, 업그레이드, 확장)가 생성됩니다. 램프 키는 임의의 텍스트 문자열(예: ramp-a)일 수 있습니다. 해당 램프의 모든 행에서 동일한 문자열을 사용해야 합니다.
램프 구조화
램프를 성공적으로 마이그레이션하려면 다음과 같이 구성하십시오.
- 중복되지 않는 기간: 각 행의 계약기간은 다른 행의 계약 기간과 중복되어서는 안 됩니다. 램프 단계가 연속적이어야 하는 경우, 각 단계는 이전 단계가 종료될 때 시작되어야 합니다.
- 단계별 계약 기간: 각 행의 계약 기간은 계약 전체 기간이 아닌 해당 단계의 계약 기간만을 포함해야 합니다.
- 각 행의 총 수량: 해당 단계 동안의 품목별 총 수량을 입력하십시오.
- 램프 키 가져오기 ID: 라인 항목을 동일한 램프 아래로 그룹화합니다. 사용자 지정 램프 속성 생성에 대해 자세히 알아보세요.
참고:
- 계약에는 램프(ramp)가 적용된 항목과 적용되지 않은 항목이 포함될 수 있습니다. 램프가 적용되지 않은 항목의 경우,
ramp_key_import_id를 비워 두고 관련 계약 행과 동일한import_unique_id를 사용하십시오. - 계약서에는 각각 독립적으로 램프가 적용되는 여러 제품이 포함될 수 있습니다. 각 제품에는 고유한
ramp_key_import_id있어야 합니다. 각 램프는 고유한 MRR 이벤트를 생성합니다.
예를 들어, 3개월 후 가격 변동이 있는 12개월 계약의 경우:
| 세부 항목 | 단가 | 수량 | 기간 | 시작 날짜 | ramp_key_import_id |
|---|---|---|---|---|---|
| 월간 서비스 | $100 | 1 | 3개월 | 2026년 1월 1일 | ramp-a |
| 월간 서비스 | 100달러 | 2 | 9개월 | 2026년 4월 1일 | ramp-a |
가능한 마이그레이션 형식
| 마이그레이션 형식 | 수집 절차 | 수익 연속성 |
|---|---|---|
| 수익 연속성이 없는 수동 결제 | 수동 결제 | 포함되지 않음 |
| 수익 연속성이 보장되는 수동 결제 | 수동 결제 | 포함됨 |
| 수익 연속성이 없는 자동 결제 | 자동 결제 | 포함되지 않음 |
| 수익 연속성이 있는 자동 결제 | 자동 결제 | 포함됨 |
마이그레이션 준비
마이그레이션을 시작하기 전에 계정을 설정하고, 선택한 마이그레이션 형식에 따라 CSV 파일을 준비하십시오.
사용자 정의 속성 생성
CSV를 가져오기 전에 필요한 사용자 정의 속성을 생성하십시오. 생성해야 할 속성은 선택한 마이그레이션 형식에 따라 다릅니다. 사용자 정의 속성 생성에 대해 자세히 알아보세요.
| 마이그레이션 형식 | 객체 | 사용자 정의 속성 이름 | 사용자 정의 속성 유형 | 유효성 검사 규칙 | 사용 목적 |
|---|---|---|---|---|---|
| 모든 옵션 | 계약 | import_unique_id |
단일 줄 텍스트 | 고유 값 필수 | 동일한 계약에 속하는 모든 행을 그룹화합니다. |
| 수익 연속성이 있는 수동 결제 또는 수익 연속성이 있는 자동 결제 | 명세 항목 | ramp_key_import_id |
단일 줄 텍스트 | 없음 | 여러 항목 행을 단계별로 그룹화합니다. |
CSV 파일 구성
계약을 HubSpot으로 마이그레이션하기 위해 가져오기 도구에서 사용할 CSV 파일을 구성하십시오.
CSV 샘플 파일
사용 중인 마이그레이션 형식에 따라 아래의 CSV 예제 파일을 활용하세요.
| 마이그레이션 형식 | CSV 링크 |
|---|---|
| 수동 결제, 수익 연속성 없음 | 다운로드 |
| 수익 연속성이 있는 수동 결제 | 다운로드 |
| 자동 결제, 매출 연속성 없음 | 다운로드 |
| 수익 지속성을 바탕으로 한 자동 결제 | 다운로드 |
| 혼합형: 단계적 요금제가 적용되는 상품 1개와 정액 요금제 상품 1개(단계적 요금제 키 없음) | 다운로드 |
여러 개의 독립적인 단계별 요금제: 제품 A(ramp-a)와 제품 B(ramp-b)는 별도로 단계별 요금이 적용됩니다 |
다운로드 |
CSV 형식
CSV 파일에는 다음 열과 HubSpot 속성이 포함되어야 합니다.
| 열 이름 | 개체 | 속성 | 세부 정보 |
|---|---|---|---|
| 계약 발효일 | 계약 | hs_contract_effective_date |
계약이 법적으로 효력을 발생하는 날짜입니다. |
| 통화 코드 | 계약 | hs_currency_code |
USD와 같은 통화 코드. |
| 이름 | 계약 | hs_name |
계약 이름. |
| HubSpot 청구 활성화 | 계약 | hs_hubspot_billing_enabled |
마이그레이션되는 모든 계약에 대해 TRUE 여야 합니다. |
| 수금 절차 | 계약 | hs_collection_process |
수동 또는 자동. 마이그레이션 형식과 일치해야 합니다. |
| 청구 시작일 재설정 | 계약 | hs_billing_start_date_override |
HubSpot에서 청구를 시작하는 날짜입니다. 마이그레이션 시 이 날짜는 미래의 날짜여야 합니다. 모든 마이그레이션 형식에서 필수 항목입니다. |
| 결제 수단 ID | 계약 | hs_external_payment_method_reference_id |
수동 결제의 경우 비워 두십시오. 자동 결제의 경우 필수 항목입니다. |
| 이메일 | 연락처 | email |
청구 담당자의 이메일 주소입니다. |
| 이름 | 이름 | firstname |
청구 담당자의 이름. |
| 성 | 담당자 | lastname |
청구 담당자의 성. |
| 제품 | 세부 항목 | hs_product_id |
제품의 레코드 ID. 마이그레이션은 기존 제품 레코드를 참조하며 새로운 제품을 생성하지 않습니다. |
| 세부 항목 이름 | 세부 항목 | name |
세부 항목 이름. |
| 단가 | 품목 | price |
계약 통화로 표시된 단가. |
| 수량 | 세부 항목 | quantity |
단계별 명세 항목 수량. |
| import_unique_id | 세부 항목 | 사용자 정의 속성 | 동일한 계약 내 모든 행에 대해 공유되는 ID입니다. |
| 용어 | 세부 항목 | hs_recurring_billing_period |
명세 항목의 기간입니다. 램프를 사용하는 경우, 각 세그먼트에 대한 기간을 입력하십시오. |
| 정기 청구 주기 | 세부 항목 | recurringbillingfrequency |
청구 주기(예: 월간). |
| 명세 항목 시작 날짜 | 세부 항목 | hs_recurring_billing_start_date |
세부 항목의 청구 시작 날짜. |
| ramp_key_import_id | 세부 항목 | 사용자 정의 속성 | 개별 항목 단계를 하나의 램프로 그룹화합니다. 매출 연속성을 위해 필수입니다. 매출 연속성이 없는 마이그레이션 형식의 경우 이 필드를 비워 두십시오. |
마이그레이션 시작
CSV를 구성한 후 HubSpot으로 계약서를 마이그레이션할 수 있습니다.
- HubSpot 계정에서 더 보기를 클릭한 다음 매출 > 계약으로 이동합니다. 더 보기가 계정에 표시되지 않으면 바로 매출 > 계약으로 이동합니다.
- 오른쪽 상단에서 ‘가져오기’를 클릭하십시오.
- '파일 가져오기 ' 섹션에서 '데이터 가져오기'를 클릭합니다.
- '고급 가져오기(모든 객체)'를 클릭합니다.
- '객체' 아래에서 '계약'을 클릭하십시오. '명세 항목' 객체가 자동으로 선택됩니다.
- 오른쪽 하단에서 '다음'을 클릭합니다.
- 데이터 가져오기 방법을 구성합니다.
- 파일 업로드: 드래그 앤 드롭하거나 ‘파일 선택’을 클릭한 후 가져올 파일을 선택합니다.
- 복사 및 붙여넣기: ‘스프레드시트에서 직접 붙여넣기’를 클릭한 후 데이터를 붙여넣으세요. 데이터는 스프레드시트 파일(예: Numbers, Google 스프레드시트)에서 복사해야 합니다.
- 언어: 기본 언어와 다른 언어로 된 데이터를 가져오는 경우, ‘파일의 열 머리글 언어 선택’ 드롭다운 메뉴를 클릭하고 언어를 선택하세요. 올바른 언어를 선택하면 HubSpot이 열 머리글을 기존 기본 속성과 더 정확하게 매칭할 수 있습니다. 선택한 언어에 일치하는 항목이 없는 경우, HubSpot은 일치하는 영어 속성을 검색합니다.
- 오른쪽 하단의 ‘다음’을 클릭하세요.
- 가져오기 파일의 열을 HubSpot 속성에 매핑하세요. CSV 속성 매핑에 대해 자세히 알아보세요.
- 오른쪽 하단에서 '다음'을 클릭합니다.
- '가져오기 이름' 필드에 가져오기 작업의 이름을 입력합니다.
- '연락처 데이터 처리에 대한 법적 근거 선택' 드롭다운 메뉴를 클릭하고 법적 근거를 선택하세요. HubSpot에서 처리의 법적 근거를 추적하는 방법에 대해 자세히 알아보세요.
- '날짜 형식' 드롭다운 메뉴를 클릭하고 날짜 형식을 선택합니다.
- '시간대' 드롭다운 메뉴를 클릭하고 시간대를 선택합니다.
- '숫자 형식' 드롭다운 메뉴를 클릭하고 숫자 형식을 선택합니다.
- HubSpot의 마케팅 도구를 사용하여 가져온 연락처와 상호작용하려면 ‘이 연락처들을 마케팅 연락처로 설정’ 확인란을 선택하십시오. 마케팅 연락처에 대해 자세히 알아보세요.
- 가져오기 중에 레코드를 보강하려면 ‘레코드 보강’ 확인란을 선택하세요. 연락처 및 회사 정보 보강에 대해 자세히 알아보세요.
- 오른쪽 하단에서 '가져오기 완료'를 클릭하십시오.
문제 해결
흔히 발생하는 가져오기 오류와 해결 방법을 확인하세요. 다른 오류가 발생하면 CSV 형식 및 속성 매핑을 검토한 후 가져오기를 다시 시도하세요.
청구 시작 날짜가 과거로 설정된 경우
'청구 시작 날짜가 과거로 설정됨 ' 오류는 CSV 내 항목의 청구 시작 날짜가 과거인 경우 발생합니다.
이 오류를 해결하려면:
- 청구 날짜가 있는 경우 모두 미래 날짜로 업데이트하십시오.
- CSV 파일을 저장하고 가져오기를 다시 시작하십시오.
Stripe 결제 수단 ID가 유효하지 않거나 누락됨
이 오류는 수금 방식으로 ‘자동 결제’ 옵션이 선택되었으나 CSV 파일에 Stripe 결제 수단 ID가 추가되지 않은 경우 발생합니다.
이 오류를 해결하려면 다음 중 하나를 수행하십시오:
- 자동 결제 항목을 수동 결제로 변경하십시오.
- CSV 파일의 자동 결제 항목에 Stripe 결제 수단 ID를 추가하십시오.
이전 시도에서 import_unique_id가 중복된 경우
가져오기가 실패하더라도 HubSpot은 실패한 가져오기에서 사용된import_unique_id 값을 여전히 등록할 수 있습니다.
이 오류를 해결하려면:
- 새로운 ID로 CSV 파일을 업데이트하십시오.
- 업데이트된 CSV 파일을 가져오십시오.
용어집
계약을 HubSpot으로 마이그레이션하기 전에 다음 용어를 확인하십시오.
| 기간 | 설명 |
|---|---|
| 자동 결제 | 저장된 결제 수단을 사용하여 청구서가 자동으로 청구되는 수금 프로세스입니다. |
| 청구 시작일 재설정 | HubSpot이 이전된 계약에 대한 청구를 시작해야 하는 날짜입니다. |
| 수금 절차 | 마이그레이션 후 결제가 어떻게 처리되는지 나타냅니다. 결제는 구매자가 수동으로 처리하거나 등록된 결제 수단을 사용하여 자동으로 처리할 수 있습니다. |
| import_unique_id | 마이그레이션 과정에서 동일한 계약에 속하는 행을 그룹화하는 데 사용되는 사용자 정의 속성입니다. |
| 수동 결제 | HubSpot에서 청구서가 생성되고 구매자가 수동으로 결제하는 수금 절차입니다. |
| 마이그레이션 형식 | 가져오기에 사용되는 CSV 구조입니다. 마이그레이션 형식은 결제 수금 방식과 매출 지속성 포함 여부에 따라 달라집니다. |
| MRR | 월간 반복 수익. HubSpot에서 MRR은 계약에 따른 반복 수익을 보고하는 데 사용됩니다. |
| MRR 워터폴 | 신규 계약, 업그레이드, 확장, 다운그레이드, 이탈과 같은 이벤트로 인해 반복 수익이 시간 경과에 따라 어떻게 변화하는지 보여주는 수익 보고서입니다. |
| 결제 수단 ID | 자동 결제가 적용된 계약에 사용되는 외부 결제 수단 참조 번호입니다. |
| 램프 | 계약 기간 동안 발생하는 가격 또는 수량 변경. |
| 램프 키 | 관련된 항목 행들을 하나의 램프로 묶는 데 사용되는 값입니다. |
| 램프 단계 | 램프 내의 한 기간. 각 단계는 고유한 계약 기간, 가격, 수량 및 시작 날짜를 갖습니다. |
| ramp_key_import_id | 마이그레이션 과정에서 라인 항목 행을 램프 단계별로 그룹화하는 데 사용되는 사용자 정의 라인 항목 속성입니다. |
| 매출 연속성 | 업그레이드, 확장 또는 다운그레이드와 같은 과거 계약 변경 사항을 포함하여 매출 보고에 반영할 수 있도록 하는 옵션입니다. |
| 기록 시스템 | 마이그레이션 후 계약 및 청구 정보를 관리하고 유지하는 데 사용되는 주 시스템입니다. |
