外部のシステムとOdooをつなぐ。この話をするとき、多くの記事はつなぎ方を説明します。
この記事は、その前に確認すべきことから始めます。
Odooの外部接続の仕組みは、いま世代交代の途中にあります。
長く使われてきた従来の方式は、Odoo公式ドキュメントで非推奨とされ、段階的に削除される予定が示されています。
つまり、いま従来の方式で連携を作ると、数年後に作り直しが必要になります。
そして厄介なことに、ネット上にある「Odoo API」の解説記事の多くは、従来の方式を前提に書かれています。
この記事では、Odoo（オドゥー：オープンソース由来の統合業務アプリ群）のAPI連携について、世代交代の現在地を中心に整理します。
⚠️ この記事にコードは載せません
技術的な書き方は変化が速く、記事に載せると誤った情報源になります。本記事は、判断に必要な構造と時期の整理に絞っています。 実装の詳細は、対象バージョンの公式ドキュメントをご確認ください。
専門用語の整理：API（エーピーアイ）とは、外部のシステムがOdooのデータを読み書きするための窓口のことです。人が画面を操作する代わりに、システム同士が直接やり取りします。
世代交代の現在地
まず、公式の記載を整理します。
Odoo公式ドキュメントの記載
Odooの開発者向けドキュメントには、次の趣旨の記載があります（2026年8月確認）。
- 従来のXML-RPCおよびJSON-RPCの窓口は、非推奨である
- これらが提供していた機能のうち、データベースに関する機能は、すでに削除されている
- 残る機能も、Odoo 22（2028年秋）での削除が予定されている
- クラウド版（Odoo Online）では、それより早い時期が示されている
- 代替として、新しいJSON-2の窓口が用意されている
認証の方式も変わりました
従来の方式は、利用者名とパスワードを使う前提でした。
新しい方式では、APIキーによる認証に変わっています。
これは単なる書き方の違いではありません。 鍵の管理という運用が必要になります。後述します。
時期は「予定」です
上記の時期は、公式が示している予定です。 変更される可能性があります。
実際の計画を立てる際は、必ず対象バージョンの公式ドキュメントで最新の記載を確認してください。
なぜこれが重要なのか
技術者向けの話に見えるかもしれません。しかし、これは経営判断に関わります。
3つの実害
① いま作る連携が、作り直しになります
従来の方式で連携を作ると、削除の時期までに書き換えが必要になります。その費用は、後から発生します。
② 既存の連携が、いつか止まります
すでに動いている連携も対象です。「動いているから大丈夫」ではありません。
③ 外部のサービスやツールも影響を受けます
自社で作ったものだけではありません。購入した連携部品や、業務自動化のツールも、従来の方式を使っている場合があります。
確認すべきこと
いま、次の3つを棚卸ししてください。
- 自社で作った連携（スクリプト、バッチ処理）
- 購入または導入した連携の部品
- 業務自動化ツールからの接続
3つ目を忘れがちです。 「つないだ覚えがない」場合でも、自動化ツールの設定に残っていることがあります。
これから作る場合の判断
新しく連携を作る方に向けて整理します。
まず「つながずに済まないか」を考えてください
連携は、作った時点で保守の対象になります。
- Odooのバージョンが上がるたびに、動作確認が必要
- つないだ相手のサービスが変われば、こちらも直す
- 作った人が辞めれば、中身が分からなくなる
この負担は、作るときの費用より大きくなることがあります。
ファイルの受け渡しで足りる場合があります
常時つなぐ必要が、本当にあるでしょうか。
1日1回、決まった時刻にデータを受け渡すだけで足りる業務は多くあります。その場合、複雑な連携を作る必要はありません。
「リアルタイムでつながっている」ことに価値があるのは、その情報を見て即座に判断する必要がある場合だけです。
作るなら、新しい方式で
これから作る連携は、新しい方式を前提にしてください。
従来の方式の解説記事は数多くありますが、それを土台にすると、後で作り直しになります。
外部からの接続には、プランの条件があります
見落とされやすい点です。
外部からAPIで接続できるかどうかは、契約しているプランによって異なると案内されています。
最下位のプランでは、外部からの接続が対象外とされています。
確認の手順
- 連携を前提とした計画を立てる前に、対象となるプランを確認する
- 公式の料金ページで、外部接続が含まれるプランを確かめる
- 必要ならプランの変更を、費用の計画に含める
この記事では、具体的なプラン名や金額を示しません。 料金体系は変わり得るためです。
必ず公式の料金ページで確認してください。
プラン構造の考え方は Odooの料金体系を解説 にまとめています。
APIキーの管理という新しい運用
新しい方式では、APIキーという鍵を使います。
これは技術の話ではなく、セキュリティの運用の話です。
決めておくこと
| 項目 | 内容 |
|---|---|
| 誰が発行するか | 鍵を作る権限を持つ人を限定する |
| どこに保管するか | ソースコードに直接書かない。設定ファイルや専用の仕組みに置く |
| 有効期限をどうするか | 期限を設定し、定期的に入れ替える |
| 退職時にどうするか | 発行した人が辞めたときの手順 |
4つ目を忘れないでください。
鍵が有効なまま残っていると、退職後もデータにアクセスできる状態が続きます。 これは実際に起きる事故です。
権限を絞ってください
連携用の鍵に、すべての権限を与えないでください。
「在庫データを読むだけ」の連携なら、読み取りの権限だけで足ります。必要最小限にすることで、万一のときの被害が限定されます。
権限とデータの守り方は Odooのセキュリティとバックアップの考え方 にまとめています。
既存の連携をどう移行するか
すでに従来の方式で動いている場合の進め方です。
手順
① 棚卸しする
何が、どこから、どの方式でつないでいるか。一覧を作ってください。 ここが最も時間がかかります。
② 期限を確認する
利用形態（自社サーバか、クラウドか）によって、削除の時期が異なると案内されています。自社がどちらに該当するかを確認してください。
③ 影響の大きい順に並べる
止まったときの影響が大きいものから移行します。受注や請求に関わる連携が最優先です。
④ 検証環境で試す
本番でいきなり切り替えないでください。 検証環境で動作を確認してから切り替えます。
⑤ 外部の提供元に確認する
購入した連携部品や自動化ツールについては、提供元に対応の予定を確認してください。 自社では直せません。
慌てる必要はありません
時期には猶予が示されています。
ただし、「まだ先だから」と何もしないと、期限の直前に慌てることになります。
まず棚卸しだけ、いま行ってください。 何があるか分かっていれば、判断は後からできます。
連携以外の選択肢
外部システムとつなぐ以外にも、道はあります。
| 手段 | 内容 |
|---|---|
| Odooの中で完結させる | その業務のアプリをOdooで使う。連携が不要になる |
| モジュールを追加する | 既存の部品で済むなら、自作しない |
| 画面のカスタマイズで対応する | 外部に出さず、Odooの中で表示や入力を変える |
1行目がいちばん効果的です。
「別のシステムとつなぐ」より、「そちらの業務もOdooで行う」ほうが、結果的に安く済むことがあります。連携の保守費が、まるごとなくなるためです。
モジュールの探し方は Odoo App Storeの使い方と注意点 と OCAとは？Odooコミュニティモジュールの活用 にまとめています。
画面のカスタマイズは Odoo Studioでできること をご覧ください。
Community版とEnterprise版の違い
Odooには、無料の Community版 と有償の Enterprise版 があります。
Community版はオープンソースとして無料で使えます。ただし、サーバの用意・アップデート・障害対応は自社の責任になり、公式サポートの対象外です。
外部接続の仕組みそのものは、Odooの基盤の一部です。
ただし、クラウド版を利用する場合は、前述のとおりプランによって外部接続の可否が変わると案内されています。
つまり、判断の軸は版の違いより「どの形で使うか」になります。
| 利用形態 | 外部接続の考え方 |
|---|---|
| 自社サーバ | 自社の管理下。削除の時期は自社サーバ向けの予定に従う |
| クラウド版 | プランの条件を確認。削除の時期はより早い予定が示されている |
どの機能がどちらの版で使えるかはバージョンによって変わります。 検討時には必ず対象バージョンで確認してください。詳しくは Odoo Community版とEnterprise版の違い をご覧ください。
よくある質問
Q1. いまの連携は、いつまで動きますか？
Odoo公式は、削除の予定時期を示しています。 ただし、利用形態によって時期が異なります。
この記事に書いた時期は、2026年8月時点で確認したものです。 変更され得るため、必ず対象バージョンの公式ドキュメントで最新の記載を確認してください。
Q2. ネットの解説記事をそのまま使ってよいですか？
注意が必要です。 2025年より前に書かれた記事の多くは、従来の方式を前提としています。
記事の公開日と、対象バージョンを必ず確認してください。
Q3. 購入した連携部品はどうなりますか？
提供元に確認してください。 自社では直せません。
対応の予定が示されない場合、代替を探す時間が必要です。 早めに確認することをおすすめします。
Q4. 自社にエンジニアがいなくても連携できますか？
外部の支援を受ける形になります。
ただし、作った後の保守も続きます。 誰が面倒を見るのかを、作る前に決めてください。作りっぱなしの連携は、いつか止まります。
Q5. どのくらいの費用がかかりますか？
この記事では金額を示しません。 つなぐ相手、データの量、頻度によって大きく変わるためです。
ただし、作る費用より保守の費用のほうが、長期では大きくなるという点は共通しています。
まとめ
OdooのAPI連携を検討するとき、最初に確認すべきは「つなぎ方」ではありません。
Odooの外部接続の仕組みが、いま世代交代の途中にあるという事実です。
Odoo公式ドキュメントによれば、従来のXML-RPCおよびJSON-RPCの窓口は非推奨とされ、一部の機能はすでに削除されています。残る機能も、Odoo 22（2028年秋）での削除が予定されています。 クラウド版では、それより早い時期が示されています。
代替として、新しいJSON-2の窓口が用意されました。認証も、利用者名とパスワードからAPIキーによる方式に変わっています。
つまり、いま従来の方式で連携を作ると、数年後に作り直しが必要になります。
そして、ネット上の「Odoo API」の解説記事の多くは、従来の方式を前提としています。記事の公開日と対象バージョンを必ず確認してください。
いま行うべきことは1つです。棚卸しです。
自社で作った連携、購入した部品、業務自動化ツールからの接続。3つ目を忘れがちです。 何があるか分かっていれば、判断は後からできます。
これから作る場合は、順序があります。まず標準機能で足りないかを確認し、次にファイルの受け渡しで済まないかを検討し、それでも必要なら新しい方式で作る。
連携は、作った時点で保守の対象になります。バージョンが上がるたびに動作確認が必要になり、作った人が辞めれば中身が分からなくなります。
作る判断より、作らない判断のほうが安く済むことがあります。
なお、外部からの接続はプランの条件があると案内されています。最下位のプランでは対象外とされているため、公式の料金ページで必ず確認してください。
もう少し詳しく知りたい方へ
ベンチャーネットは、ERP導入支援を手がける会社です。SAP・NetSuite・Odoo・AIスクラッチ開発という4つの選択肢を扱っているため、特定の製品に偏らない立場でご提案できます。
「いまある連携の棚卸し」からご相談を承っています。つながずに済む道を先に探す方針です。
あわせて読みたい記事
