測試版將合約遷移至 HubSpot
上次更新時間: 2026年8月11日
將現有合約從舊系統遷移至 HubSpot,以便管理計費、開立發票及營收報表。此遷移過程將保留付款方式、合約歷史紀錄及未來的計費時程。遷移完成後,您可以將 HubSpot 作為已確認營收的集中式權威資料來源。進一步了解如何在 HubSpot 中使用合約。
開始之前
在開始使用此功能之前,請務必充分了解應事先採取的步驟,以及該功能的限制與使用時可能產生的後果。
了解需求
-
如果您是 超級管理員,您可以將您的帳戶加入 「將計費資料遷移至 Revenue Hub 合約」 測試版。
-
您的 HubSpot 帳戶必須將 Stripe 設為付款處理選項。若您正在使用 HubSpot 付款 服務,並希望將付款方式從外部 Stripe 帳戶遷移至 HubSpot 付款服務,請填 寫此表單 。
-
請根據您選擇的收款流程及營收連續性選項,設定 CSV 檔案格式。進一步了解如何選擇最適合您企業的遷移格式。
了解限制與注意事項
- 若使用營收連續性功能,請在沙盒環境中測試匯入作業。若將錯誤資料匯入您的帳戶,您將無法修正 MRR 瀑布圖報告中的歷史資料。
- 合約一經啟用,HubSpot 即成為計費的正式記錄系統。此遷移操作無法撤銷。
- 任何合約更新都必須在 HubSpot 中進行。進一步了解如何檢視與管理合約。
- 啟用後,僅當合約中尚無已付款的發票或付款紀錄時,您才能更新「帳單起始日期覆寫」及「付款方式 ID」。
選擇遷移格式
在進行遷移前,請根據您希望 HubSpot 在遷移後如何管理合約,選擇合適的遷移格式。遷移格式取決於資料匯集流程,以及您是否希望納入歷史合約變更事件(例如:升級或擴展)。
付款收取流程
- 手動付款:遷移完成後,系統會產生發票供買方手動付款。
- 自動付款:遷移後,系統將使用檔案中的付款方式自動扣款。
營收連續性
- 無營收連續性:合約匯入時不會包含營收變更事件。
- 營收連續性:使用「漸進鍵」將明細項目分組為不同階段,並在 HubSpot 的 MRR 瀑布圖中顯示變更事件(例如:升級、擴展、降級)。若使用營收連續性功能,請先在沙盒環境中測試匯入作業。若將錯誤資料匯入您的帳戶,您將無法在 MRR 瀑布圖報表中修正歷史資料。
Ramps
遞增鍵
遞增鍵會將多個明細項目行分組為不同階段。具有相同遞增鍵的行將被視為一個連續的遞增階段。
在 HubSpot 中,每個漸進階段於開始時都會產生 MRR 事件(例如:新業務、升級、擴展)。漸進鍵可以是任何文字字串(例如:ramp-a)。該漸進階段的所有列都必須使用相同的字串。
逐步增長的結構設定
為成功遷移漸進式合約,請依照以下方式進行結構化:
- 日期範圍不得重疊:每行條款的起訖日期不得與其他行的條款重疊。若「階段」必須連續,則每個階段應在前一階段結束時開始。
- 各階段的合約期限:每行所對應的合約期限僅涵蓋該合約階段,而非整個合約期限。
- 每行總數量:請輸入該階段內該明細項的總數量
- 遞增階段關鍵字匯入 ID:將明細項目歸類至同一遞增階段。進一步了解如何建立自訂遞增階段屬性。
請注意:
- 一份合約可能包含漸進式與非漸進式的明細項目。對於非漸進式的明細項目,請將
ramp_key_import_id欄位留空,並使用與相關合約列相同的import_unique_id。 - 一份合約可能包含多個獨立遞增的產品。每個產品都必須擁有專屬的
ramp_key_import_id。每個遞增項目都會產生其專屬的 MRR 事件。
例如,針對一份為期 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 檔案
請設定將與匯入工具搭配使用的 CSV 檔案,以便將合約遷移至 HubSpot。
CSV 範例檔案
請根據您使用的遷移格式,使用以下的 CSV 範例檔案。
| 遷移格式 | CSV 連結 |
|---|---|
| 手動付款,無營收連續性 | 下載 |
| 手動付款且具營收連續性 | 下載 |
| 自動付款,無營收連續性 | 下載 |
| 自動付款與營收持續性 | 下載 |
| 混合型:一款採用階梯定價的產品與一款固定費用產品(無階梯定價關鍵值) | 下載 |
多個獨立階梯方案:產品 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 | 指在合約期間內發生的定價或數量變動。 |
| Ramp 金鑰 | 用於將相關明細項目行歸類為單一漸變的值。 |
| Ramp 階段 | 漸進曲線中的單一期間。每個階段皆有其專屬的合約期限、價格、數量及起始日期。 |
| ramp_key_import_id | 用於在遷移過程中將明細項目列分組至漸進階段的自訂明細項目屬性。 |
| 營收連續性 | 一項選項,用於納入歷史合約變更(例如升級、擴展或降級),以便在營收報表中反映這些變更。 |
| 記錄系統 | 用於在遷移後管理及維護合約與計費資訊的主要系統。 |