メールで書類を取り込む

クラウド帳簿には 1 冊ずつ専用の受信アドレスがあります。領収書や請求書をこの アドレスに送る（または自分のメールボックスから転送ルールを設定する）だけで、 メッセージは自動的にデコードされ、帳簿にファイリングされます。スキャナーや CLI に触れずに、仕入先の請求書・オンライン購入のレシート・銀行通知を raw/ に取り込む最速の方法です。

帳簿の受信アドレス

アドレスは帳簿の作成時に生成され、変わることはありません。次のコマンドで 確認できます。

iris api inbox show <book-id>

k7f3x9q2m4p8w1r5@in.irisbooks.jp のような形式です — 推測してスパムを送る ことができないよう、意図的にランダムにしています。半分秘密の情報として扱い、 帳簿に取り込みたいメールの送信元（取引先やサービス）にだけ共有してください。

受け付けられる条件

メッセージは、次のすべてを満たしたときにだけ取り込まれます。

1. 送信者が帳簿の許可リストに載っている（後述）。
2. 送信サーバーの検証に合格している — SPF・DKIM・DMARC がすべて PASS で あること。偽装した「From:」で帳簿にファイルを注入することはできません。
3. ウイルススキャンがクリーンである — すべてのメッセージは帳簿に触れる 前にスキャン（GuardDuty マルウェア保護）されます。

それ以外はすべて隔離リストに入ります — 何も黙って破棄されません。

帳簿に入るもの

受け付けられたメッセージは、月とメッセージ ID で命名された raw/email/ 配下の 1 フォルダになります。

raw/email/2026-07/a1b2c3d4e5f6g7h8/
├── email.md          # 差出人・宛先・日付・件名 + 本文テキスト
├── receipt.pdf       # デコード済みの添付ファイル（そのまま参照可能）
└── invoice-0042.pdf

email.md はエンベロープ（送信者・日付・件名・添付一覧）をフロントマターに 持つため、LLM が文脈を読み、添付ファイルを指す source_ref 付きで仕訳を 起こせます（基本コンセプト を参照）。ファイルは他のサーバー側の 変更と同じく、次回の iris sync でローカルに届きます。

10MB を超える添付はスキップされます（email.md に記録されます）。元の メッセージは監査用コピーとしてサーバー側に保管されます。

送信者許可リストの管理

許可リストの初期値はあなたのログインメールアドレスなので、自分のメール ボックスからの転送は最初から機能します。送信者は完全一致またはドメイン全体で 追加できます。

iris api inbox allow billing@stripe.com <book-id>   # 完全一致
iris api inbox allow '*@amazon.co.jp' <book-id>     # ドメイン全体
iris api inbox disallow '*@amazon.co.jp' <book-id>  # 削除

追加・削除には帳簿への書き込み権限（OWNER または BOOKKEEPER）が必要です。 フラグの一覧は CLI コマンドリファレンス にあります。 クラウド連携済みの帳簿では Web アプリ の 帳簿の設定 → メール取り込み からも アドレスの確認と許可リストの管理ができます。

隔離されたメールの確認

拒否されたメッセージは理由付きで一覧できます。Web アプリの 帳簿の設定 → メール取り込み（隔離された送信者をワンクリックで許可できます） または CLI から確認します。

iris api inbox quarantine <book-id>

注意点がひとつ: 企業メールボックスの自動転送ルール（元の送信者のまま 再送するもの）は SPF を壊すことが多く、送信者が許可リストにあっても auth_fail で隔離されます。自分のメールクライアントから手動で転送すれば、 メールはあなたからのものとして認証されるため問題ありません。