Odooと会計ソフトfreeeを連携するアドオン開発について

[takahii03]

@yostashiro
先日、X（旧Twitter）で田代さんとやり取りさせていただいた件ですが、まずはこちらで相談させてください！

現在、Odooと会計ソフトfreeeを連携するアドオンの開発を検討しております。
OCAモジュールとして開発するにあたり、ご相談したい点があります。

＜相談事項＞
・l10n-japanリポジトリに外部連携機能を持つアドオンを追加するのが適切か
・それとも新規にリポジトリを立ち上げるのが適切か

＜背景＞
開発・保守のしやすさを考え、以下を想定しています。
(1) OCAのconnectorモジュールに依存させること
(2) 機能別にモジュールを分割すること

イメージ：
connector_freee/
    ├─ connector_freee_base            … 認証・APIクライアント・共通処理
    ├─ connector_freee_items           … 品目マスタ同期
    ├─ connector_freee_deals           … 請求・取引データ連携
    └─ connector_freee_manual_journals … 振替伝票連携

このような構成にした場合、l10n-japanに配置するのが適切か、それとも独立したリポジトリとすべきか判断に迷っております。
ご意見をいただければ幸いです。

＜補足＞
freee連携モジュールの解決したい顧客課題：
・Odoo上で発生する仕訳をfreeeへ連携し、二重入力や転記作業の負荷を軽減すること
・Odoo CEの会計機能の制約を補うため、Odooとfreeeを組み合わせて低コストでERP運用を実現すること

[yostashiro]

まず、ご相談事項につきまして、新規リポジトリは作成せず、l10n-japan内にモジュールを追加するのが現時点では妥当と考えます。というのは、新たなリポジトリを設けるのはOCAのコアメンテナーの承認プロセスを通す必要があり、freee連携のように日本以外では関心がもたれないであろうトピックでこれがすんなりと通るとは思えないためです。

以下、私がfreeeについては現状よく知らない中での話ですので、見解が適切でない可能性をお含みおきください。

モジュール構成については、まず当面のスコープをどうするのかについての共通認識を持ったうえで進めるのがよいかと思います。

freee連携モジュールの解決したい顧客課題：
・Odoo上で発生する仕訳をfreeeへ連携し、二重入力や転記作業の負荷を軽減すること
・Odoo CEの会計機能の制約を補うため、Odooとfreeeを組み合わせて低コストでERP運用を実現すること

こちらを認識した上で、私自身は、当面連携スコープについては最小限にとどめるべきとの立場で、「Odooの請求実績をfreeeに渡す」あたりが妥当ではないかと考えていますが、これだと問題ありそうでしょうか？

Odooとfreeeの親和性にもよりますが、仕訳データそのもの連携は、ニーズが比較的低く、実装工数とリスクが比較的高いのではないかと想像します。ですので、一旦ここでは仕訳データ連携はスコープ外としてよいのではないかと思っています。（もし、仕訳連携について既に実績があり、私の見解が妥当でなさそうであればご指摘ください。）

スコープを「Odooの請求実績をfreeeに渡す」とする場合、前提として想定する役割分担は次のとおりです。

• freee: 財務会計全般
• Odoo: 商取引の詳細管理

この場合、自動連携の仕組みがなくとも、Odoo側の実績を集計して月次締処理で手でfreee側で勘定残高を調整する仕訳を入れる運用も、できなくはないと思います。ただ、取引先別の残高をfreeeで持つことを考えると、それなりにデータ作成に手間がかかりうるので、そこへの対処として請求データの自動連携の仕組みを設けるということです。

在庫評価と売上原価に関しては、適切にプロセスを組みさえすれば、それほど手間をかけずに集計してfreee側に入力できると思われますので、ここについては連携スコープ外としてよいと思います。

とすると、当面Odoo側で作成するモジュールとしては、次のようなものになるかと思われます。（モジュール名はfreeeのAPI名に合わせる必要はないと考えています。）

• connector_freee_base: 接続および前提マスタ連携
• connector_freee_invoice: 請求データ連携（Odoo→freee）

いかがでしょうか？私が見当違いなコメントをしている可能性もありますので、その場合はぜひご指摘を！

[takahii03]

@yostashiro
返信ありがとうございます。今内容確認していますので、返信まで少々お待ちを！

[takahii03]

@yostashiro
l10n-japan 内にモジュールを追加するのが現時点では妥当とのご意見、ありがとうございます。
私自身、まだ OCA について十分に理解できていない部分もあるため、まずは l10n-japan 内で作成する方向で検討させていただければと存じます。

当面の連携スコープは最小限にとどめ、具体的には「Odoo の請求実績を freee に渡す」程度が妥当ではないかと思いますが、これで問題はないでしょうか。

現時点では提案予定のお客様がいるわけではありませんので、特に問題はございません。

• 連携スコープを最小限にする → 同意
• Odoo の請求実績を freee に渡す → こちらもご指摘の通り、この仕様が良いかもしれません。freee 側で取引を基に、仕訳が自動生成されるため。

具体的には、Odoo 側の Invoice と freee 側のエンドポイント /api/1/deals を対応付け、 Odoo → freee の片方向連携を行うイメージを想定しています。
https://developer.freee.co.jp/reference/accounting/reference#/Deals

また、どこの業務が効率化出来るかのコメントもありがとうございます。
こんな提案をしておいてなんですが、freee には収入・支出・振替伝票のインポート機能があるため、Odoo からデータをエクスポートしてインポートが比較的スムーズにできる場合には、必ずしも自動連携モジュールを開発する必要はないかもしれません。
この点については検証を行い、もし手動でのインポート作業やデータ作成が手間であると判明した場合には、改めてモジュール開発に着手しようかと思います。

[yostashiro]

@takahii03 コメントありがとうございます！

具体的には、Odoo 側の Invoice と freee 側のエンドポイント /api/1/deals を対応付け、 Odoo → freee の片方向連携を行うイメージを想定しています。
https://developer.freee.co.jp/reference/accounting/reference#/Deals

使うのはこちら https://developer.freee.co.jp/reference/iv/reference なのかなと思っていましたが、Dealsが妥当なのでしょうか？（切り分けがよくわかっていません。）

検索してみるに、freeeでの「請求書」は顧客請求書のことであるらしいので、そうすると請求書APIを使用すると仕入側（こちらがDeals？）のおさまりがよくないのでしょうか？

[takahii03]

@yostashiro
お返事遅くなりました！

Dealsが妥当なのでしょうか？

Odooから連携された請求書がfreee上にも作成されることになり、
データの二重管理が発生するのが良くないのでは？と考えました。

そのため、請求書としてではなく、直接「取引」としてデータを作成する方が適切ではないかと考えています。

また現在検証中ですが、請求書APIでデータを作成した場合、
最終的にはfreeeの画面上で、Odooから連携された請求書を取引に変換する
オペレーションが必要になる可能性があります。

P.S.
※ 取引という概念がfreee独自のもののようですので、念の為、共有です。

会計では、法人や事業に関わるお金の動きを「取引」と呼び、簿記という基本ルールに従って日々の取引を記録していきます。この作業を「記帳」「帳簿付け」などといいます。

freeeで帳簿付けを行うときの基本の入力形式も「取引」といいます。ただし、複式簿記の「借方／貸方」という仕訳の形で入力する必要はありません。
…

2.1 「取引」とは