freee会計 APIを利用した開発者のためのガイドラインです。

1. 1
ファイルボックス+取引ガイドライン
2022.09

2. 2
目次と構成
1. このガイドラインについて
2. ファイルボックスとは
3. APIから出来ること
4. ファイルボックスの利用パターン
5. A. 領収書などをデータで保管するストレージとして利用する
6. B. 取引と紐付けて利用する
7. C.支払い依頼と紐付ける

3. 3
1. このガイドラインについて
目的 ファイルボックスと取引の関係を明らかにし、スムーズなファイルボックス連携の実現。このドキュメントでも軽く
触れますが、ファイルボックスそのものの詳細はヘルプをご確認ください。
https://support.freee.co.jp/hc/ja/sections/200621964
対象者 紙媒体の領収書をデジタル管理したい事業者
請求書・見積書のデジタル管理サービス提供事業者
連携対象ソフトウェア
例
請求書や領収書の取込におすすめのアプリ
https://app.secure.freee.co.jp/applications/search?app_collection_id=10
注意事項 本情報は 2022-09 時点の情報です。サービス・仕様変更に追従できていない可能性があります。
万が一誤りを発見した際、ご連絡頂けると幸いです。
このガイドラインで示す勘定科目・税区分等の具体例はあくまで、過去事例からの参考情報です。
各連携プロダクトにおける会計処理の妥当性についてご不明・ご不安な点がある場合は、
適切な会計士・税理士等へのご確認をお願いいたします。

4. 4
2. ファイルボックスとは
● 経理業務に紐づく電子データをアップロードし一元的に保管・管理出来る機能です。
● 取り込めるファイルタイプは次の通りです。
○ 各種画像 / PDF / Excel / CSV / Word
● アップロード後、取引や申請と紐付けることで、取引・申請情報で検索が可能になります(Web)。検
索で利用できる項目は次の通りです。
○ 取引先(発行元) / 取引日(発行日) / 金額
● 注意
○ プランにより次の制限があります。
■ 個人スタータープラン: 5枚/月まで
■ それ以外: 10G/月まで

5. 5
3. APIから出来ること
● ファイルボックス
○ 登録
■ 電子帳簿保存法に乗っ取る場合、Web or API経由で取引等と紐付ける必要あり。
○ 検索
■ 電子帳簿保存法の検索要件は未対応
○ 削除
○ 変更
■ メモ・取引日のみ
● 取引との紐付け
● 申請との紐付け

6. 6
4. ファイルボックスの利用パターン
● A. 領収書等をデータで保管するストレージとして利用する。
○ freeeのファイルボックスをストレージとして利用します。
○ プランにより保存できる容量が異なります。ご注意ください。
● B. 取引と紐付けて利用する。
○ 取引等と紐付けることで、内容の確認・帳票の検索が容易になります。
○ 取引等と紐付けることで、電子帳簿保存法に準じた管理が可能になります。
■ 現状、検索に関しては Web からのみ対応
● C.支払い依頼と紐付ける
○ 支払いに稟議が必要なケースで、支払い依頼と紐付けて管理できます。
○ Bパターン同様、依頼に基づく情報が紐付けられます。

7. 7
5. A. 領収書等をデータで保管するストレージとして利用する

8. 8
5. A. 領収書等をデータで保管するストレージとして利用する
● シンプルに領収書等のデータを保管するストレージとして利用します。
● 保存したいデータを POST /api/1/receipts を利用しアップロードしてください。
● GET /api/1/receipts を利用することで、アップロード日、アップロードユーザーなどで検索可能で
す。
● 電子帳簿保存法に準拠させる場合、連携サービス側で準拠に必要な情報を管理する必要がありま
す。もし、電子帳簿保存法対応をご検討の場合、次のB・Cパターンでの連携をご検討ください。

9. 9
6. B. 取引と紐付けて利用する。

10. 10
6. B. 取引と紐付けて利用する。
● 取引と紐付ける場合、取引の登録に必要な情報(勘定科目・金額・発行日など)を OCR などを利用
して推測する必要があります。
● 取引の登録には POST /api/1/deals をご利用ください。
● 推測したデータとfreee上でのid突合のため、マスタ情報も連携してください。マスタ情報に関して
は、会計マスタガイドラインをご確認ください。
○ https://developer.freee.co.jp/guideline/master-guideline

11. 11
7. C.支払い依頼と紐付ける

12. 12
7. C.支払い依頼と紐付ける
● 前ページ、『6. B. 取引と紐付けて利用する』と同様です。
● 支払依頼の登録には POST /api/1/payment_requests をご利用ください。

13. 13
スモールビジネスを、世界の主役に。