BASEの注文と商品をSalesforceに取り込む

どういうときに使うのか

BASEでネットショップを開き、問い合わせや法人の取引をSalesforceで管理している会社では、ネットショップで買った人と、Salesforceの顧客が別々に管理されることになります。誰が何をいつ買ったかがSalesforceから見えないと、サポートや次の提案に生かせません。

BASEは、BASE株式会社が提供するネットショップ作成サービスです（公式サイトは thebase.com）。開発者向けにBASE APIが公開されていて、ショップの情報をほかのサービスとつなげます。

BASE APIで取れるもの

2026年9月時点のBASE Developers Docsでは、BASE APIはβ版とされています。認証はOAuth 2.0で、client_id と client_secret を得るには、BASE Developersへの利用登録と利用許可が要ります。

Salesforceへの取り込み方

当時の記事では、顧客・注文・商品の3つをSalesforceに取り込めると書いていました。APIの仕様に合わせると、次の順に取り込むのが素直です。

1. 商品を取り込む

   GET /1/items で商品の一覧を取り、Salesforceの商品に登録します。BASEの商品IDを項目に残しておきます。

2. 注文の一覧を取る

   GET /1/orders に注文日時の範囲（start_ordered と end_ordered）を付けて、前回からの注文を取ります。一度に取れるのは最大100件なので、offset で続きを取ります。

3. 注文の詳細から顧客を作る

   注文ごとに GET /1/orders/detail/:unique_key で詳細を取り、購入者のメールアドレスなどで既存の顧客を探します。見つからなければ新しく作ります。

4. 注文を顧客にひもづける

   注文と、その中の商品を、顧客のレコードにひもづけて登録します。注文のユニークキーを項目に残し、同じ注文を二重に取り込まないようにします。

取り込みを作る前に決めておくこと

当時の記事から変わったこと

• 当時の記事にあった料金の表は、改定されている可能性があるため外しました
• 当時の記事の「公式ページ」のリンクが別の会社のサイトを指していたため、BASEの公式サイトに直しました
• 当時の記事では、BASEの注文管理の画面を1枚載せていました。この画像は、いまは残っていません。画像の代わりに、APIで取れる注文の情報を表と手順で書き起こしています
• BASE全体の商品を検索するAPIは、2022年2月21日で新規受付を終えたとドキュメントに書かれています。ショップの自分の商品を取る取り込みには関係しません

確認した環境

• 2026年9月時点のBASE Developers Docs（BASE API v1 ドキュメントのはじめに、orders、orders/detail）とBASEの公式サイトで確認しています
• BASE APIはβ版のため、仕様が変わることがあります。作る前に最新のドキュメントを確かめてください

まとめ

• BASE APIでは、ショップの商品と注文の情報を取れます。認証はOAuth 2.0です
• 顧客だけを取るAPIはなく、購入者の情報は注文の詳細に入っています
• 取り込みは、商品、注文の一覧、注文の詳細から顧客、の順に作ると素直です
• 注文のユニークキーと商品IDを残し、二重の取り込みを防ぎます
• APIの利用上限と個人情報の見える範囲を、先に決めておきます