ベータ契約をHubSpotに移行する
更新日時 2026年7月23日
サブスクリプションが必要 契約を移行するには、「Revenue Hub」の「」サブスクリプションが必要です。
シートが必要 契約を移行するには、「Revenue Hub」の「」ライセンスが必要です。
アクセス権限が必要 移行を実行するには、の「スーパー管理者」権限が必要です。
レガシーシステムからHubSpotへ既存の契約を移行し、請求、請求書発行、および収益報告を管理します。移行後も、お支払い方法、契約履歴、および今後の請求スケジュールは引き継がれます。移行後は、HubSpotを確定売上高に関する一元的な情報源として活用できます。HubSpotでの契約を活用したの詳細については、をご覧ください。
始める前に
この機能を使い始める前に、あらかじめ必要となる手順と、この機能の使用に伴う制限事項と潜在的な結果について十分に理解しておいてください。
要件を理解する
-
についてご注意ください: のスーパー管理者 である場合、アカウントを Billing Migrations onto Revenue Hub Contracts ベータ版に参加させることができます。
-
HubSpotアカウントでは、決済処理オプションとしてのStripeを利用する必要があります。のHubSpot Payments()をご利用中で、外部のStripeアカウントからHubSpot Paymentsへ決済方法を移行したい場合は、のこのフォーム()にご記入ください。
-
選択した支払回収プロセスおよび収益継続オプションに基づいて、CSVのフォーマットを設定してください。の詳細や、貴社のビジネスに最適な移行形式の選び方については、をご覧ください。
制限事項と考慮事項を理解する
- の収益継続機能()を使用する場合は、のサンドボックス環境()でインポートのテストを行ってください。アカウントに誤ったデータがインポートされた場合、MRRウォーターフォールレポートの過去データを修正することはできません。
- 契約が有効になると、HubSpotが請求に関する正式な記録システムとなります。この移行は元に戻すことができません。
- 契約内容の変更は、すべてHubSpotで行う必要があります。での契約の閲覧および管理に関する詳細はこちらをご覧ください:。
- 有効化後、の「請求開始日の上書き」()およびの「支払い方法ID」()を更新できるのは、契約に未払いの請求書や支払いがない場合に限られます。
移行形式を選択してください
移行を行う前に、移行後の契約をHubSpotでどのように管理したいかに基づいて、移行形式を選択してください。移行形式は、収集プロセスや、過去の契約変更イベント(アップグレードや拡張など)を含めるかどうかによって異なります。
支払い回収プロセス
- 手動による支払い:移行後、購入者が手動で支払いを行えるよう請求書が発行されます。
- 自動支払い:移行後、登録済みの支払い方法に基づき、請求書が自動的に請求されます。
収益の継続性
- 収益の継続性がない:の契約は、収益変更イベントなしでインポートされます。
- 収益の継続性:では、のランプキー()を使用して、明細行をフェーズごとにグループ化し、HubSpotのMRRウォーターフォールにアップグレード、拡張、ダウングレードなどの変更イベントを表示しています。収益継続機能を使用する場合は、のサンドボックス環境()でインポートのテストを行ってください。アカウントに誤ったデータがインポートされた場合、MRRウォーターフォールレポートの過去データを修正することはできません。
ランプ
ランプキー
ランプキーは、複数の明細行をフェーズごとにグループ化します。同じランプキーを持つ行は、1つの連続したランプとして扱われます。
HubSpotでは、各ランプフェーズが始まるたびに、MRRイベント(新規契約、アップグレード、拡張など)が発生します。ランプキーには、任意のテキスト文字列を指定できます(例:ramp-a、)。そのスロープのすべての列で、同じ文字列を共有する必要があります。
スロープの構造
ランプの移行を成功させるには、次のように構成してください:
- 日付範囲の重複禁止:各行の期間と他の行の期間が重複してはなりません。ランプフェーズを連続させる必要がある場合は、各フェーズは前のフェーズが終了した時点で開始する必要があります。
- 各フェーズごとの期間:。各行の期間は、契約の全期間ではなく、そのフェーズのみを対象としています。
- 各行の合計数量:そのフェーズにおける当該明細行の合計数量を入力してください
- ランプキーのインポートID:は、同一のランプの下に明細行をグループ化します。でのカスタムランププロパティの作成方法の詳細については、をご覧ください。
ご注意:
- 契約には、段階的価格設定の品目とそうでない品目が含まれる場合があります。段階的ではない明細項目については、「
ramp_key_import_id」()を空白のままにし、「import_unique_id」()には、関連する契約行と同じ値を使用してください。 - 1つの契約には、それぞれ独立して段階的に拡大する複数の製品が含まれることがあります。各製品には、それぞれ独自の
ramp_key_import_id()が必要です。各ランプは、それぞれ独自のMRRイベントを生成します。
たとえば、12か月の契約で、3か月後に価格変更がある場合:
| 商品項目 | 単価 | 数量 | 期間 | 開始日 | ramp_key_import_id |
|---|---|---|---|---|---|
| 月額サービス | 15,000円 | 1 | 3か月以内である | 2026年1月1日 | ramp-a |
| 月額サービス | 15,000円 | 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 |
手動で支払いを行う場合は、空欄のままにしてください。自動支払いに必要です。 |
| Eメール | コンタクト | email |
請求先担当者のメールアドレス。 |
| 名 | コンタクト | firstname |
請求先担当者の名。 |
| 姓 | コンタクト | lastname |
請求先担当者の姓。 |
| Product(製品) | 商品項目 | 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 | 商品項目 | カスタムプロパティー | グループは、各項目フェーズを1つのランプにまとめます。収益の継続のために必要です。収益の継続性がない移行形式の場合は、この欄を空白のままにしてください。 |
移行を開始する
CSVの設定が完了したら、HubSpotへの契約データの移行を開始できます。
- HubSpotアカウントで、[その他]をクリックし、収益>[契約]の順に進みます。アカウントに「その他」が表示されない場合は、収益>[契約]の順に進みます。
- 右上の[インポート]をクリックします。
- [ ファイルをインポート] セクションで、[ データをインポート]をクリックします。
- [詳細インポート(全てのオブジェクト)]をクリックします。
- 「」の「オブジェクト」内で、「」の「契約」をクリックします。「明細項目」オブジェクトが自動的に選択されます。
- 右下の[次へ]をクリックします。
- データのインポート方法を設定します。
- ファイルのアップロード:にファイルをドラッグ&ドロップするか、をクリックしてファイルを選択し、からインポートするファイルを選択してください。
- コピーして貼り付け:をクリックし、にアクセスして、スプレッドシートから直接データをコピーして貼り付けてください。スプレッドシートファイル(Numbers、Googleスプレッドシートなど)からデータをコピーする必要があります。
- 言語:デフォルトの言語とは異なる言語のデータをインポートする場合は、「」をクリックし、ドロップダウンメニューからファイル内の列見出しの言語を選択してください。ドロップダウンメニューから言語を選択してください。正しい言語を選択すると、HubSpotが列ヘッダーを既存の既定のプロパティーと正しく一致させることができます。選択した言語に一致するものがない場合、HubSpotは一致させる英語のプロパティーを探します。
- 右下の[次へ]をクリックします。
- インポートファイルの列をHubSpotのプロパティにマッピングします。のCSVプロパティマッピングの詳細については、をご覧ください。
- 右下の[次へ]をクリックします。
- 「」の「インポート名()」フィールドに、インポートの名前を入力します。
- 「」をクリックし、「」のドロップダウンメニューから、連絡先のデータを処理するための法的根拠を選択してください。HubSpotにおけるのトラッキングに関する処理の法的根拠の詳細については、をご覧ください。
- 「」の日付形式「」のドロップダウンメニューをクリックし、日付形式を選択してください。
- 「」のタイムゾーン「」のドロップダウンメニューをクリックし、タイムゾーンを選択してください。
- 「」の「数値形式」ドロップダウンメニューをクリックし、数値形式を選択してください。
- HubSpotのマーケティングツールを使用してインポートした連絡先を活用したい場合は、「」の「これらの連絡先をマーケティング連絡先として設定する()」チェックボックスを選択してください。のマーケティング担当者に関する詳細はこちらをご覧ください:。
- インポート時にレコードに情報を追加するには、「」の「Enrich records」チェックボックスを選択してください。の連絡先や企業情報の詳細については、をご覧ください。
- 右下の「」をクリックし、「」のインポートを完了します。
トラブルシューティング
よくあるインポート時のエラーと、その解決手順を確認しましょう。その他のエラーが発生した場合は、CSVの書式設定とプロパティのマッピングを確認してから、インポートを再試行してください。
過去の日付での請求開始日の上書き
の「請求開始日の上書き(過去の日付)」設定において、「」というエラーが発生するのは、CSV内の明細項目の請求開始日が過去の日付になっている場合です。
このエラーを解決するには、次の手順に従います。
- 請求日をすべて将来の日付に変更してください。
- CSVファイルを保存して、インポートを再度実行してください。
Stripeの支払い方法IDが無効か、指定されていません
このエラーは、引き落とし方法として「自動支払い」オプションが選択されているにもかかわらず、CSVファイルにStripeの支払い方法IDが追加されていない場合に発生します。
このエラーを解決するには、次のいずれかの方法を行ってください:
- 自動支払いの登録を手動支払いに変更してください。
- CSVに自動支払いの仕訳を作成するために、Stripeの支払い方法IDを追加してください。
以前の試行から「import_unique_id」が重複しています
インポートが失敗した場合でも、HubSpot は、その失敗したインポートからの「import_unique_id」および「」の値を登録する場合があります。
このエラーを解決するには、次の手順に従います。
- CSVファイルに新しいIDを反映させてください。
- 更新されたCSVファイルをインポートしてください。
用語集
契約をHubSpotに移行する前に、以下の条件をご確認ください。
| 期間 | 説明 |
|---|---|
| 自動引き落とし | 登録済みの支払い方法を用いて、請求書が自動的に引き落とされる回収プロセス。 |
| 請求開始日の上書き | HubSpotが移行された契約の請求を開始すべき日付。 |
| 回収手続き | 移行後の支払いの回収方法。支払いは、購入者が手動で行うか、登録済みの支払い方法を利用して自動的に行うことができます。 |
| import_unique_id | 移行時に、同じ契約に属する行をグループ化するために使用されるカスタムプロパティです。 |
| 手動での支払い | HubSpotで請求書が発行され、購入者が手動で支払いを行う回収プロセス。 |
| 移行形式 | インポートに使用されるCSVの構造。移行の形式は、支払いの回収方法や、収益の継続性を組み込むかどうかによって異なります。 |
| MRR | 月次継続収益。HubSpotでは、MRRは契約に基づく継続収益を報告するために使用されます。 |
| MRRウォーターフォール | 新規契約、アップグレード、拡張、ダウングレード、解約などの事象により、継続収益が時間の経過とともにどのように変化するかを示す収益レポート。 |
| 支払い方法ID | 自動支払いが設定された契約で使用される、外部の支払方法参照情報。 |
| ランプ | 契約期間中に生じる価格または数量の変更。 |
| ランプキー | 関連する明細行を1つのランプにまとめるために使用される値。 |
| ランプフェーズ | ランプ内の1つの区間。各フェーズには、それぞれ固有の期間、価格、数量、および開始日が設定されています。 |
| ramp_key_import_id | 移行時に、明細行をランプフェーズごとにグループ化するために使用される、カスタム明細行プロパティです。 |
| 収益の継続性 | アップグレード、拡張、ダウングレードなどの過去の契約変更を反映し、売上報告に反映できるようにするオプション。 |
| 基幹システム | 移行後の契約および請求情報の管理・維持に主に使用されるシステム。 |