跳到內容
請注意::這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立,可能沒有經過校對。因此,這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

將合約遷移到HubSpot

上次更新時間: 2026年9月21日

可搭配下列任何訂閱使用,除非另有註明:

需要訂閱 除非您已註冊直接建立、編輯和續 訂閱 HubSpot合約測試版, 否則 匯入 入合約需要透過 Revenue Hub 訂閱。

需要權限 匯入 和遷移合約需要合約的 匯入 權限和編輯權限。

摘要

將現有合約從舊有系統遷移到HubSpot ,以管理帳單、發票和收入報告。遷移會保留付款方式、合約紀錄和未來的帳單時間表。遷移後,您可以使用HubSpot作為承諾收入的集中事實來源。深入瞭解如何 在HubSpot中使用合約。

開始之前

在開始使用此功能之前,請務必提前充分了解應採取的步驟,以及該功能的局限性和使用該功能的潛在後果。

了解要求

了解限制和注意事項

  • 如果使用 營收連續性,請在 Sandbox 環境中測試 匯入。如果 帳戶 中匯入的資料有誤,您將無法更正 MRR 瀑布報告中的歷史資料。
  • 合約啟用後, HubSpot將成為 記錄 帳單的系統。遷移無法撤消。任何合約更新都必須在HubSpot中進行。深入瞭解如何 檢視和管理合約。
  • 遷移不會停止在舊版系統中收費。

選擇遷移格式

在遷移之前,請根據您希望HubSpot在遷移後管理合約的方式選擇遷移格式。遷移格式取決於收集過程,以及您是否要包含歷史合約變更事件(例如擴展和收縮)。

收款流程

  • 手動付款: 遷移後,會產生發票,供買家手動付款。
  • 自動付款: 遷移後,系統會使用登記的付款方式自動收取發票費用。

營收連續性

  • 沒有收入連續性: 合約在沒有收入變更事件的情況下導入。
  • 營收連續性: 使用 斜坡鍵 將行項目分組為階段,並在HubSpot的 MRR 瀑布中顯示變更事件(例如,擴展和收縮)。
    • 收入連續性保留經常性收入變化事件以供報告。它不會重新建立歷史發票或付款。
    • 如果使用營收連續性,請在 Sandbox 環境中測試 匯入。
    • 如果不正確的數據被匯入您的 帳戶,您只能透過刪除與不正確數據相關聯的合約並重新匯入來更正 MRR 瀑布報告中的歷史數據。

坡道

斜坡鍵

斜坡鍵將多個 明細項目 列分組為階段。具有相同斜坡鍵的行代表一個隨著時間而變化的連續循環 串流/流。

在HubSpot中,每個RAMP階段都會在每個階段開始時產生 MRR 事件(例如,新業務、擴張、收縮)。斜坡鍵可以是任何文字字串(例如 ramp-a)。對同一坡道的每個階段使用相同的字串。

建造坡道

要成功遷移斜坡,請按以下方式進行結構:

  • 對每個循環 串流/流 使用一個斜坡鍵:為 單個 產品 或服務的所有階段分配相同的斜坡鍵。
  • 對連續階段使用相同的鍵: 如果同一 產品 或服務的一個階段接著另一個階段,則對兩個階段使用相同的斜坡鍵。
  • 對同時產品使用不同的按鍵: 如果在同一時期內多個產品或服務分別增加,請為每個產品或服務分配不同的按鍵 ramp_key_import_id。
  • 將平面產品的密鑰留空: 如果 產品 或服務在合約期間沒有變更,請將該 ramp_key_import_id 欄位留空。
  • 使用不重疊的日期範圍: 具有相同斜坡鍵的行的日期範圍不能重疊。對於連續階段,請在前一階段結束時開始每個階段。
  • 輸入每個階段的總狀態: 每個階段行必須包括該階段的總數量或值,而不是從上一階段的變化。例如,如果數量從1增加到2 ,請在第二階 2 段輸入,而不是 1。
  • 使用斜坡鍵 匯入 ID來分組階段: ramp_key_import_id 為同一斜坡中的所有行項目輸入相同的值。進一步了解如何 建立自訂坡道 屬性。

請注意:

  • 合約可以包括斜坡和非斜坡行項目。對於非斜坡行項目,請保留 ramp_key_import_id 空白,並使用與相關合約行 import_unique_id 相同的內容。
  • 每個斜坡都會產生自己的 MRR 事件。

例如,對於3個月後價格變化的12個月合約:

明細項目 單價 數量 期限 開始日期 ramp_key_import_id
每月服務 $ 100 1 3個月 2026年1月1日 ramp-a
每月服務 $ 100 2 9個月 2026年4月1日 ramp-a

可能的遷移格式

遷移格式 收款流程 營收連續性
沒有收入連續性的手動付款 手動付款 不包含
具有收入連續性的手動付款 手動付款 包含
自動付款,沒有收入連續性 自動付款 不包含
具有收入連續性的自動付款 自動付款 包含

每月和每季帳單 匯入 範例

根據合約生效日期、明細項目 開始日期、期限和帳單開始日期覆蓋,瞭解 匯入 後每月和每季合約的計費方式。

屬性 定義

屬性 類型 描述
合同生效日期 法律 雙方簽署的合同原始法律和商業開始日期。用於稽核、收入確認和報告。無法在HubSpot中計費。
明細項目 開始日期 帳單基礎 訂定 明細項目 程的日期。對於週期性行項目,所有未來的計費間隔均從此日期開始計算。例如,從1月1日開始的每季 明細項目 將始終在1月1日、4月1日、7月1日和10月1日結算,無論何時進行遷移。
期限 持續時間 明細項目 或斜坡階段的總長度,表示為 ISO-8601 持續時間,例如 P3M 或 P1Y。定義當前承諾期何時結束。從1月1日開始的12個月任期於同年12月31日結束。
帳單開始日期覆寫 覆蓋 HubSpot可能為已遷移合約啟動未來帳單的最早日期。防止HubSpot針對已在舊版系統中計費的期間產生發票。此欄位不會重設或移動週期性節奏。它決定了即將到來的節奏日期HubSpot將首先採取行動。

每月和每季示例

當帳單開始日期覆蓋介於兩個節奏日期之間時, HubSpot會跳到覆蓋之後的下一個排定節奏日期。節奏錨點(明細項目 開始日期)永遠不會移動。

情境 合同生效日期 明細項目 開始日期 期限 帳單開始日期覆寫 首個HubSpot賬單日期
每月,中期合約遷移 2024-01-01 2024-01-01 12個月 2024.06.01 2024.06.01
每月,覆蓋介於節奏日期之間 2024-03-15 2024-03-15 12個月 2024-07-20 2024-08-15
每季度,覆寫與節奏對齊 2024-02-01 2024-02-01 12個月 2024-08-01 2024-08-01
季度,替代下降季度中旬 2024-01-01 2024-01-01 12個月 2024-04-15 2024年7月1日

遷移的生 生命週期

請在下方檢閱合約遷移的完整 生命週期 期:

設定CSV檔案,並使用 匯入 工具將其 匯入 HubSpot。了解更多 設定匯 匯入 CSV檔案。

 

準備遷移

開始移轉前,請先設定 帳戶,並根據 所選的移轉格式準備CSV檔案。

建立自訂屬性

匯入CSV檔案前,請先建立必要的自訂屬性。您需要建立的屬性取決於所選的 遷移格式。深入瞭解如何 建立自訂屬性。

遷移格式 物件 自訂 屬性 名稱 自訂 屬性 類型 驗證規則 用於
所有選項 合約 import_unique_id 單行文字 需要唯一值 將屬於同一合約的所有行分組。
具有收入連續性的手動付款或具有收入連續性的自動付款 明細項目 ramp_key_import_id 單行文字 無 將多個 明細項目 列分組為階段。

配置CSV文件

將CSV檔案設定為與 匯入 工具一起使用,以將合約遷移到HubSpot。在下方查看特定CSV欄位的 匯入 行為、下載範例CSV檔案,並參考合約 匯入 CSV的格式。

明細項目 類型

匯入合約時, CSV中的每一行都會視為兩種 明細項目 類型之一,具體取決於是否填入「 產品 」欄位。

  • 產品 支援: 產品欄位包含現有HubSpot 產品 記錄 ID。如果CSV檔案中有任何支援的欄位(例如價格模式、 會員等級、價格、條款、帳單頻率或稅務類別)留空,則該列會從連結的 產品 中繼承這些值。

  • 獨立: 產品 欄位留空。該行僅使用CSV中提供的值,行項目未連結到目錄中的任何 產品。

請注意: 如果產品支持的行引用週期性 產品,但將週期性字段留空,則即使收費是單次收費,也可能繼承 產品 週期性收費頻率配置。

Evergreen合同

常綠 週期性 明細項目 具有週期性帳單頻率,且沒有項目。它會自動續訂,直到取消為止,並且沒有週期性的帳單結束日期。合約生效期間,系統會根據計費頻率繼續收費,直到合約 取消 或 終止為止。合約結束日期、TCV和ACV可能保持空白,而 當前 MRR 和 當前 年度經常性收入 仍在計算中。

定價模型

匯入合約時,可能會套用現有的定價模式和等級,具體取決於 單價 欄位是否已填入。

  • 如果「產 產品 」欄位包含有效的HubSpot 產品 記錄 ID ,且單價 為空白,則匯入的 產品 將使用現有的定價模式和等級。
  • 如果「產 產品 」欄位包含有效的HubSpot 產品 記錄 ID ,並填入「 單價 」欄位,則該列會保留其 產品 關聯,並使用輸入的 金額 作為固定費率價格。產品 現有定價模式和等級不會修改。

付款條款

匯入合約時,如果您未將hs_net_payment_terms 發票 屬性 新增至CSV ,則無論 帳戶 的發 發票 預設設定為何,淨付款期限預設為 0 (收據時到期)。若要使用不同的付款條款,請在CSV檔案中附上所需的值(例如,值為0 的情況下,發票將在收到時到期。值為30 會將發票設置為具有淨30個付款條款)。

自動徵收銷售稅

必須擁 需要訂閱 有Revenue Hub 專  業版或企業版 帳戶,才能為帳 帳戶 提供自動徵收的銷售稅。

需要席位 自動徵收銷售稅需要在你的 帳戶 中至少分配一個 Revenue Hub 席位。一旦有合資格的 席位 次,所有支援的收入工具(包括發票、付款連結、報價單、舊版報價單和訂閱)都可以自動徵收銷售稅。用戶不需要指定 Revenue Hub 席位,即可使用啟用自動銷售稅的收入工具。

如果你位於美國或加拿大,並希望自動計算銷售稅,請先在 帳戶 設定中 設定自動銷售稅 ,然後再匯入合約。

請注意:如果您 匯入 與公司相關的公司或 連絡人 人,公司的帳單地址不會用於自動徵收銷售稅。如果您想使用自動銷售稅檢閱 自動銷售稅CSV範例檔案 ,或將自動銷售稅 屬性 性新增至CSV檔案,並在CSV檔案中使用以下帳單地址屬性:

  • hs_billing_address_line_1
  • hs_billing_address_line_2
  • hs_billing_address_state
  • hs_billing_address_zip
  • hs_billing_address_country
  • hs_billing_address_country_code

CSV示例文件

請使用以下CSV檔案範例來引導您的遷移。

請注意: CSV檔案僅供說明之用。替換CSV中的樣本日期、識別碼、產品 ID、聯絡人、金額、貨幣和任何 import_unique_id 條目。在繼續遷移之前,請驗證對應的屬性和 草稿。

遷移方案 CSV連結
手動付款,無 收入連續性 下載
具有 收入連續性的手動付款 下載
自動付款,無 收入連續性 下載
具有 收入連續性的自動付款 下載
混合:一個 斜 坡 產品 一個固定費用 產品(沒有斜坡鑰匙) 下載
多個獨立 坡道:產品 A (ramp-a )和 產品 B (ramp-b )分開坡道 下載
Evergreen經常性合約。進一步了解 常青合約 下載
包含一次性和週期性行項目的合約 下載
合約有兩個項目,一個有折扣 金額,一個有折扣百分比 下載
含 自動徵收銷售稅的合約 下載
與多個帳單聯絡人簽訂合約 下載

CSV格式

您的CSV應包含以下欄和HubSpot屬性。

欄名稱 物件 屬性 詳情
合同生效日期 合同 hs_contract_effective_date 合同在法律上生效的日期。
貨幣代碼 合同 hs_currency_code 貨幣代碼,例如美元。
姓名 合同 hs_name 合同名稱。
HubSpot帳單已啟用 合同 hs_hubspot_billing_enabled 必須 TRUE 適用於正在遷移的所有合約。
收款流程 合同 hs_collection_process manual_payments 或 automatic_payments。必須與遷移格式對齊。
帳單開始日期覆寫 合同 hs_billing_start_date_override HubSpot開始收費的日期。遷移時,這必須是未來的日期。所有遷移格式都必需。
外部付款方式參考ID 合同 hs_external_payment_method_reference_id 手動付款請留空。為自動付款所必需。
import_unique_id 合同 自訂 屬性 獨特的合約 屬性,具有相同合約中所有行的共享ID。即使先前的 匯入 時也必須使用新的ID。 
電子郵件 連絡人 email 帳單聯 連絡人 人的電子郵件地址。
名字 連絡人 firstname 帳單聯 連絡人 人的名字。
姓氏 連絡人 lastname 帳單 連絡人 人的姓氏。
產品 明細項目 hs_product_id 可選 屬性。產品 記錄 ID。深入瞭解產品 支援和獨立 明細項目 類型。
明細項目 名稱 明細項目 name 明細項目 名稱。
單價 明細項目 price 以合約貨幣計算的單位價格。 
數量 明細項目 quantity 一個階段內 明細項目 數量。
期限 明細項目 hs_recurring_billing_period 明細項目 術語。使用斜坡時,請輸入每個 分群 術語。 
週期性收費頻率 明細項目 recurringbillingfrequency 收費頻率(例如每月)。
明細項目 開始日期 明細項目 hs_recurring_billing_start_date 明細項目 帳單開始日期。
ramp_key_import_id 明細項目 自訂 屬性 將 明細項目 階段分組到一個坡道中。為了維持營收連續性。對於沒有收入連續性的遷移格式,請保留此空白。

遷移合約

開始遷移合約,包括在開始最終遷移之前測試本地化。

移轉前進行本地化測試

如果你為不同語言和地區的顧客提供服務,建議按語言、地區和貨幣進行試點遷移。確認成功遷移後,您可以 作廢發票 並 終止 合約 。

  1. 將合約新增至CSV檔案。深入瞭解如何 為匯入設定 匯入。
  2. 開始 並 完成 遷移。
  3. 等待為合約產生發票。
  4. 請檢查 發票 的準確性。進一步了解如何 管理收據:
    • 在新的瀏覽器分頁中查看 發票。
    • 下載收 發票 的PDF檔案。
    • 將發 發票 傳送至內部電子郵件地址。
  5. 驗證翻譯過的標籤、日期、數字、貨幣符號、字元渲染、寄件人、收件人和連結。 

請注意: 這是端對端試驗,並非預先啟用預覽功能。

開始遷移

設定CSV後,即可開始將合約遷移至HubSpot。 

  1. 在你的 HubSpot 帳戶中,點擊「更多」,然後前往收入>「合約」。如果你的帳戶中沒有顯示「更多」,請直接前往收入>「合約」。
  2. 按一下右上角的「匯入」。
  3. 在 匯入 檔案 部分,按一下 匯入 資料。
  4. 按一下 進階匯入(所有物件)。
  5. 在「 物件」下方,按一下「 合約」。系統會自動選取聯絡人和行項目物件。您也可以同時 匯入 其他物件(例如公司和交易)。深入瞭解如何 匯入多個物件。
  6. 按一下右下角的「 下一步」。
  7. 按一下「 選擇如何 匯入 聯絡人」下拉式選單,然後選擇一個選項:
    • 僅建立新聯絡人: 為匯入的 連絡人 人記錄。
    • 建立和更新現有聯絡人:在 CRM 中不存在 連絡人 人時建立新的聯絡人記錄。如果 連絡人 人已存在,請更新該聯絡人。如果您選擇此選項,每個 記錄 都必須有一個唯一的識別碼。
  8. 單擊選擇如何 匯入 行項目 下拉菜單,然後選擇 僅創建新行項目。 

請注意:  為沒有唯一標識符的行項目選擇創建和更新 可能會導致來自不同合同的相同行項目合併,從而使一些合同沒有其關聯的產品。建議選擇「建立新行項目 」,以避免合併。

  1. 設定您要 匯入 資料的方式:
    • 上傳檔案: 拖放,或按 一下選擇檔案,然後選擇 匯入 檔案。
    • 複製並貼上: 直接從試算表中按一下「貼 上」,然後貼上資料。資料必須從試算表檔案(例如Numbers、Google試算表)複製。
    • 語言: 如果要以預設語言以外的語言匯入資料,請在 檔案下拉式選單中按一下選擇欄標題的語 言,然後選擇語言。選擇正確的語言可讓HubSpot更好地將欄標題與現有的預設屬性相匹配。如果您選擇的語言沒有匹配項目, HubSpot會搜尋要匹配的英文房源。
  2. 按一下右下角的「 下一步」。
  3. 將 匯入 檔案中的欄對應到HubSpot屬性。進一步了解 CSV 屬性 對應。
  4. 按一下右下角的「 下一步」。
  5. 在 匯入 名稱 欄位中,輸 匯入 名稱。
  6. 按一下「 選擇處理 連絡人 案件資料的法律依據 」下拉式選單,然後選擇法律依據。深入瞭解如何 在HubSpot中 追蹤 處理的法律依據。
  7. 按一下 日期格式下拉式 選單,然後選擇日期格式。
  8. 按一下「 時區 」下拉式選單,然後選取時區。
  9. 按一下 數字格式下拉式 選單,然後選擇數字格式。
  10. 如果您想使用HubSpot的行 銷工具與匯入的聯絡人 參與,請 核取方塊 將這些聯絡人設為行銷聯絡人核取方塊。進一步了解 市場推廣聯絡人。
  11. 選取 豐富記錄 核取方塊  匯入 期間豐富記錄。深入瞭解 連絡人 和公司豐富度。
  12. 在右下角,按一下 完成 匯入。
  13. 繼續 完成遷移。

查看格式設定問題

按一下「 完成 匯入入的合約會以合約草稿的形式建立。在完成遷移之前,連絡人 案件格式設定問題和行錯誤:

請注意: 由於其 發票 號碼是預計的條目,因此排定的帳單行包含 -- 。生成的發票會收到一個數字,並與其他 發票 記錄編製索引。

  1. 若要清除格式問題,請在「 清除匯入的資料 」下方,按一下 [物件]格式問題下的 值 (例如 1 )。

  2. 在 格式問題下方,按一下檢視問題。

  3. 請在表格中查看問題和修繕建議:
    • 若要編輯建議的修繕項目,請在「 建議的修繕 項目」欄中,按一下編輯圖示,然後輸入新值。
    • 如要接受所有修繕建議,請點擊「全部接受」。
    • 如要拒絕所有修繕建議,請點擊「全部拒絕」。
    • 若要接受或拒絕個別行的建議修正,請在操作 欄中按一下接受 或拒絕。
    • 要從 匯入 中刪除 記錄,請在操作 列中單擊更多,然後選擇刪除此 記錄。
  4. 返回 匯入 頁面:

完成遷移

請注意: 具有「 檢視」、「建立」、「編輯」或「刪除」權限的 使用者可以檢視已匯入但尚未移轉的合約。對合約具有「建立」、「編輯」或「刪除」權限的 使用者可以驗證、編輯、移轉和刪除從 匯入 中建立的草稿合約。

  1. 按一下「 完成遷移」。

  2. 查看需要注意的合同。若要將錯誤檔案下載為CSV檔案,請在右上角按一下「將 錯誤檔案下載為CSV檔案」。
  3. 若要更正錯誤,請在「錯 誤 」欄中按一下「更新[屬性]」。 

  4. 在對話方塊中,更新所需的 屬性,然後按一下重新驗證合約。
  5. 重新驗證的合約將移至「準備遷移 」分頁。
  6. 檢閱任何需要注意的合約後,按一下「準備遷移 」標籤。
  7. 建議在最終完成遷移之前檢閱合約的以下屬性:
    • 收款流程
    • 付款方式
    • 日期
    • 產品 關聯
    • 明細項目
    • 排程
    • 稅務設定
  8. 若要變更帳單開始日期或外部付款方式參考編號,請按一下 「編輯」圖示。

請注意: 只有在合約沒有已付發票或付款時,您才能更新 帳單開始日期覆蓋 和 hs_external_payment_method_reference_id。

  1. 在對話框中:
    • 在「 帳單開始日期覆寫」欄位下,按一下日期選擇器 ,然後選取日期。
    • 在「付款方式ID 」欄位中輸入付款方式ID。
    • 按一下「重新驗證合約」。
  2. 合約重新驗證後,會移至「準備遷移 」分頁。

  3. 作為移轉前的最後步驟,請檢閱以下內容:
    1. 舊版合約中的最後一張 發票。
    2. 第一張HubSpot 發票。
    3. 任何未清應收款項。
    4. 舊版 訂閱 取消(如適用)。
    5. 笨手笨腳。
    6. 發票 電子郵件。
    7. 會計整合驗證。深入瞭解如何將 Quickbooks Online 和 Xero 連結至HubSpot。 
  4. 在右上角,按一下「遷移[x]合約」。

  5. 在對話方塊中,檢閱移轉條款,選取「我理解並同意 」核取方塊,然後按一下「確認移轉」。
  6. 將根據 所選的遷移格式匯入合約並開始計費。深入瞭解如何 檢視和管理合約。

故障排除

查看常見的 匯入 錯誤和解決步驟。如果遇到其他錯誤,請檢查CSV格式和 屬性 對應,然後重試 匯入。

Stripe付款方式ID無效或缺失

如果選擇自動付款選項作為收款過程,但未將Stripe付款方式ID添加到CSV文件中,則會發生此錯誤。

若要解決此錯誤,請按照以下步驟操作:

  • 將自動付款條目更改為手動付款。
  • 為CSV中的自動付款條目新增Stripe付款方式ID。

重複之前嘗試的import_unique_id

如果 匯入 失敗, HubSpot仍可從失敗的 匯入 中註冊import_unique_id 值。

若要解決此錯誤,請按照以下步驟

  1. 使用新身分證件更新CSV檔案。
  2. 匯入 更新的CSV檔案。

詞彙表

在將合約遷移到HubSpot之前,請查看以下條款。

期限 描述
自動付款 收款流程,系統會使用已儲存的付款方式自動收取發票費用。
帳單開始日期覆寫 HubSpot應開始計費已遷移合約的日期。
收款流程 遷移後如何收取付款。買家可以手動收取款項,也可以使用登記的付款方式自動收取款項。
import_unique_id 用於在移轉期間對屬於同一合約的行進行分組的自訂屬 屬性。
手動付款 收款流程,在HubSpot中生成發票,買家手動付款。
遷移格式 用於匯 匯入 CSV結構。遷移格式取決於如何收取款項,以及您是否希望包括收入連續性。
MRR 每月經常收入。在HubSpot中, MRR 用於 報告 合約的經常性收入。
MRR 瀑布 收入 報告,顯示經常性收入如何因新業務、升級、擴充、降級和 客戶流失 等事件而隨時間變化。
付款方式ID 用於自動付款合約的外部付款方式參考。
斜坡 在合約過程中發生的定價或數量變更。
斜坡鍵 用於將相關 明細項目 列分組到一個斜坡中的值。
斜坡階段 斜坡內的一段時間。每個階段都有自己的期限、價格、數量和開始日期。
ramp_key_import_id 自訂 明細項目 屬性,用於在移轉期間將 明細項目 列分組為斜坡階段。
營收連續性 包括過往合約變更的選項,例如升級、擴充或降級,以便在收入報告中顯示。
記錄 系統 移轉後用於管理和維護合約和帳單資訊的主要系統。
這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。