内部資料 / 社外配布禁止 / 画面共有・スクショ・印刷時注意
AI 業務マニュアル › 3. 何ができるか › うーぱん

うーぱん — 社内経理パイプライン

version 1.0 — 2026-06-18 / 担当: うーぱん（社内経理） / 監修: CEO（飯塚）

1. 概要・North Star

うーぱんは 株式会社コネクトエイトの社内経理のみを担当する AI エージェントです。クライアントの経理（ガッチャン領域）には一切触りません。

North Star（最終目標）
Freee の全取引（連携クレカ・銀行・立替・現金）と証憑（レシート/領収書/請求書 PDF）が 1:1 で紐付いている状態を維持する。
税務調査・期末処理で「この取引の証憑は？」と聞かれた瞬間に出せる状態。
項目内容
法人名株式会社コネクトエイト
会計年度7 月始まり〜6 月締め（決算月: 6 月）
スタート基準日2026-06-01（それ以前の ❌/◇ は対象外）
立替者CEO（飯塚）のみ
Freee 書込下書きのみ。確定は人間（スタッフ/CEO）が Freee UI で実施

2. 4 つのデータソースと役割

経理パイプラインは 4 つのデータソースを統合して機能します。

① 証憑アップロード 3 ルート

CEO・スタッフが Drive へ証憑を投入するルート。

  • Drive 直接ドロップ: 会社支払フォルダ / 代表立替フォルダ
  • Telegram /upload: ファイル or 画像を送信
  • Discord /upload: 同上（別チャンネル）

→ Codex（MacBook）がリネーム → _仕分け待ち/ へ移動

② Freee 支出データ（連携自動取込）

Freee に連携されたクレカ・銀行取引が自動取込されたもの。

  • Freee 情報支出データ管理簿（スプレッドシート）に MCP で取得・格納
  • 取引種別: 登録済み / 未処理(wallet_txn) / 未処理(deal)
  • Freee 本体への書込はしない（GET のみ）
③ クレカ明細（AMEX / 楽天）

外貨取引の JPY 確定値の正本。Freee 連携との二重確認に使用。

  • AMEX明細タブ / 楽天明細タブ に格納
  • 外貨建て行の JPY は AMEX 確定値 + PDF 実物確認が必須
  • ファイル名・OCR の外貨額は参考値（誤読多い）
④ 銀行明細（住信 SBI 法人口座）

社会保険料・税金など口座振替系の正本。

  • Freee に連携されている（wallet_txn として自動取込）
  • 証憑（振込明細 or 領収通知書）を Drive に投入することで突合が完了する
データフロー全体像 
Drive 証憑（3ルート投入）
  ↓ Codex リネーム → _仕分け待ち/
  ↓ うーぱん週次バッチ
証憑管理簿（スプシ）← S1：証憑台帳
  ↕ 突合エンジン（reconcile_8class.py）
Freee 情報支出データ管理簿（スプシ）← S2：Freee 取引台帳
  ↕ クレカ明細・銀行明細で JPY 確定
reconciliation_result（補助シート）← 突合結果

3. 証憑投入導線（2026-06-09 統一）

スタッフはフォルダにドロップするだけで OK。カテゴリ判定はうーぱんが自動処理します。

用途投入先フォルダ名Drive フォルダ ID
会社支払の証憑_codex_workspace/会社支払/1O0006u1I_bEP2lsc89V7rSWL2wnkwuA9
代表立替の証憑_codex_workspace/代表立替/1lfN6loGa8sWd0PiJuaGbPIJpZ9bcTb17
中継（自動）_仕分け待ち/1DTuLGtn7oo4mEmhjmKHfGKOzs9J_JbAC
  • Telegram / Discord の /upload コマンドも同フォルダに自動投入
  • 旧 _INBOX_会社支払 / _INBOX_代表立替 は廃止済み（2026-06-09）
  • Codex（MacBook）がリネームして _仕分け待ち/ へ移動（Codex 実行時）
  • うーぱん週次バッチ（日曜 23:30）が証憑フォルダへ振分 + 証憑管理簿に追記

自動振分ルール

判定条件振分先フォルダ
投入フォルダ = 会社支払 + 電子証憑 + 通信費キーワード（ZOOM / Anthropic 等）電子証憑_会社支払 / 通信費（月次）
投入フォルダ = 会社支払 + 公租公課キーワード（年金 / 税金 / 自動車税 等）電子証憑_会社支払 / 公租公課
投入フォルダ = 代表立替 + 電子証憑電子証憑_代表立替 / その他
投入フォルダ = 会社支払 + 紙証憑（JPG/PNG）紙証憑_会社支払 / その他
投入フォルダ = 代表立替 + 紙証憑紙証憑_代表立替 / その他

4. 突合 8 分類（reconcile_8class.py）

証憑管理簿（S1）× Freee 取引（S2）を突合し、各行に以下の 8 種の記号を付与します。

記号条件対応優先度
◎Drive 証憑あり + Freee 仕訳済 + Freee 証憑添付あり完了・対応不要—
⚫Drive 証憑あり + Freee 未仕訳 または Freee 証憑添付なしFreee への仕訳・添付が必要高
◯Freee 仕訳済 + Drive 証憑なし + 少額(1,000 円以下)または自動引落証憑不要の正常取引低
△証憑形式欄が「クレカ明細」クレカ明細を正式証憑として代替低
▲勘定科目が役員報酬・給与・賞与証憑対象外の科目—
❌Drive 証憑なし + Freee 証憑添付なし証憑の早急提出が必要最高
？Freee 候補が 2 件以上ヒット（同日同額）人間が正しい Freee 行を選択高
◇Freee 証憑添付あり + Drive にファイルなしDrive へのバックアップが必要中

判定フローチャート

取引を確認
  ↓
勘定科目が「役員報酬 / 給与 / 賞与」？ → YES → ▲（対象外）
  ↓
証憑形式が「クレカ明細」？ → YES → △（クレカ明細で代替）
  ↓
Freee 候補が 2 件以上ヒット？ → YES → ？（人間確認）
  ↓
Drive 証憑あり？  Freee 仕訳あり？  Freee 証憑添付あり？
  ↓
 ○○○ → ◎（完了）
 ○○✗ → ⚫（添付のみ必要）
 ○✗○ → ⚫（仕訳+添付必要）  ← Drive 証憑あるが Freee 未仕訳
 ✗○○ → ◇（Drive バックアップ必要）
 ✗○✗ → ◯（少額/自動引落の場合）
 ✗✗✗ → ❌（証憑提出が必要）
スタート基準日（2026-06-01）
2026-06-01 以前の ❌/◇ は「プロジェクト開始前のため証憑未アップロードが正常」として対象外です。
7/1 正式運用での自動チェック対象は 2026-06-01 以降の取引のみ。

5. マッチング条件とスコアリング

マッチング 3 条件

条件詳細
日付±2 暦日（営業日の近似値。土日をまたぐ場合も対応）
金額完全一致（1 円単位。端数切捨て等は行わない）
店舗名正規化後の部分一致（全角→半角、法人格除去、記号除去のうえ、互いに含まれていれば一致）

スコアリング（複数候補がある場合）

条件スコア
日付が完全一致（差 0 日）1.00
日付差 1 日0.80
日付差 2 日0.60
店舗名も一致（+ボーナス）+0.10（最大 1.00）

スコアが最高の候補を採用。同等スコアが 2 件以上 → ？ に格上げ（人間確認が必要）。

正規化の例

元の表記正規化後
株式会社サクセスガーデン佐野さくせすがーでんさの
(株)サクセスガーデン佐野さくせすがーでんさの
ZOOM Video Communicationszoom video communications

6. 外貨建て行のルール（2026-06-18 確定）

重要: OCR の外貨額は信用しない
過去に ZOOM の請求額が $62.69 なのに OCR が $110.99 と読んでファイル名に記録されたケースが発生。外貨額は PDF 実物と AMEX 明細を正本とする。
原則内容
JPY の正本AMEX / 楽天明細の確定 JPY。OCR やファイル名の外貨額は参考のみ
PDF 実物確認外貨行は必ず PDF を DL して pdftotext で請求総額を確認してから記録
按分禁止AMEX 合算行（複数請求が 1 行）は JPY 按分しない。空が正則
1 円厳守四捨五入・切捨て禁止。AMEX 明細の 1 円単位の値をそのまま使う
推測禁止明細と一致しない場合は JPY を空にして「要確認」を記録

Grab / Moca（ベトナム VND）の特則

パターン処理方法
AMEX が正本Grab の VND 取引は AMEX 明細の JPY 確定値を使う（Freee の換算値は参考）
Moca 分割Moca 支払いで 1 乗車分が AMEX 2 行に分割される場合がある（例: 57,200 VND = 9,360 + 47,840）。証憑管理簿にも 2 行で計上し、各行に分割計上であることを備考に記載
乗車日 vs AMEX 計上日深夜乗車は乗車日（+1 日）と AMEX 計上日がズレることがある。証憑の日付は乗車日を採用

Anthropic の特則

Anthropic の Claude 利用料は CEO 個人とコネクトエイト会社名義の 2 種が混在。AMEX が 1 行に合算請求される場合、按分は税理士判断が必要なため JPY は空にして通信費月次として計上。個人立替分は別途精算フロー。

7. 7/1 正式運用のゴール

2026-07-01（次期会計年度スタート）に正式運用に移行します。以下の 6 条件すべてが 0 の状態が達成目標です。

確認項目チェック先現状（2026-06-18）
Drive 未処理 = 0会社支払/ + 代表立替/ の未処理ファイル数0
要確認 = 0_要確認/ フォルダのファイル数要確認
処理エラー = 0processing_log シートの今週 error 行要確認
❌ = 0（06-01 以降）reconciliation_result の ❌ 件数0 達成
？ = 0reconciliation_result の ？ 件数2 件（CEO 確認待ち）
◇ = 0（06-01 以降）reconciliation_result の ◇ 件数要確認
現在の状況（2026-06-18 時点）
証憑管理簿: 684 行 / I 列分布: ◎16 件 / ⚫44 件 / ？2 件
❌ 0 件（06-01 以降）を達成。⚫44 件は Freee 仕訳・証憑添付待ち（スタッフ作業）。

全件完了通知条件

上記 6 条件がすべて 0 になった場合のみ #finance-report に「アップ漏れなし ✅」を通知。1 つでも 1 以上 → 「未解消あり」通知（件数・内訳付き）を送信。

現在の消化リスト（週次自動更新）
⚫・？・◇ の対応待ち行を一覧化したリスト。月曜 reconcile 完了後に自動生成されます。
→ keiri_worklist.html（社内限定・認証必須）

8. 運用カレンダー

タイミング処理内容担当
Codex 実行時（任意タイミング）投入フォルダのリネーム → _仕分け待ち/ へ移動Codex（MacBook）
1 時間毎SUICA 明細を SUICA 管理簿へ自動取込うーぱん（LaunchAgent）
日曜 23:30（週次バッチ）_仕分け待ち/ の全証憑を処理 → 証憑フォルダへ振分 + 管理簿追記 + 突合実行うーぱん
月次（月初）試算表・BS/PL 取得 → 月次サマリ生成 → #finance-report 配信うーぱん（Phase 1 未着手）

9. 厳守ルール

ルール内容
Freee 書込は下書きのみ確定は人間（スタッフ or CEO）が Freee UI で実施。Freee 本体は GET のみ
証憑添付も下書き保留人間承認後に確定
1 円厳守金額の丸め・四捨五入禁止。AMEX 明細の 1 円単位の値をそのまま使う
推測禁止不確かな OCR 結果は推測で埋めない。信頼スコアを明示し _要確認/ へ退避
個人情報マスク口座番号・カード番号・氏名はログ・出力に書かない
スコープ厳守クライアント経理データには絶対に触らない（A09 / A08 配下）
税務判断しない簡易課税の処理を含め、税理士領域には踏み込まない
_credentials/ 禁止_credentials/ 配下は絶対に読まない・表示しない
メアドはマスク実メアドは書かない。プレースホルダ（{{connect8_email}} 等）で統一
_safe_append_row 必須証憑管理簿への追記は必ず _safe_append_row 経由（生 append_row は列オフセットバグがあるため禁止）

連携先

役割連携先
上位・最終決定CEO（飯塚）直轄
税務的判断白石さん監修 → CEO 経由
技術相談（MCP / LaunchAgent / スプシ）トラジ（A07）
スタッフ向け手順書ガッチャン（マニュアル整備）
OCR 前処理・リネーム（MacBook 側）Codex
うーぱん経理パイプライン v1.0 — 2026-06-18 / 素材: 突合チェックルール解説_20260607.md / SPEC_a10_pipeline_v4.md / A10 CLAUDE.md
URL: https://ai-manual.connect8.cc/03_capabilities/upan/keiri_pipeline.html