不動産管理会社の送金明細から仕訳を組み立てる:帳票を共通の形に読み替える計画と試作
不動産管理会社の送金明細から仕訳を組み立てる:帳票を共通の形に読み替える計画と試作
不動産の管理会社からオーナーに届く送金明細は、家賃などの入金から修繕などの控除を引いて送金額を出した明細だ。 ここから会計ソフトCに取り込む仕訳を作る仕組みを、自作の Excel-Books(以前の記録)に載せようとしている。
共有してもらった資料には、帳票と一緒に、経理が実際に入れた仕訳の CSV も入っていた。 正解は、もう手元にある。 問題は、管理会社ごとに形の違う帳票から、その正解を組み立て直せるかどうかだった。
帳票と正解の仕訳 CSV の突き合わせ
資料一式を Claude Code に渡し、まず帳票と正解の CSV を突き合わせさせた。 サブエージェントは Opus で5体。 管理会社ごとに担当を分け、1体には会計ソフトCの CSV の列の形式と、物件をまたいだ横断集計を任せた。 法令と蔵書から根拠を探す調査役も、別に1体走らせた。 報告を待つあいだ、メインのセッションには Excel-Books の既存の作り方と、ブック設計の作法(やってはいけないことや、前提シートの形)を読ませていた。
報告は管理会社ごとに届いた。 どの社のぶんも、正解の CSV の行の出どころが帳票の中に見つかった。 貸借と送金額まで一致したという報告もあった。
手を焼いたのは、帳票の形のほうだ。 ある管理会社の帳票では、費目の列の並びと合計行の位置が、物件ごとに違っていた。 数値の列には、先頭に記号の付いた文字列が混ざっていた。 別の管理会社は縦持ちの明細で、駐車料と消費税が別の行に分かれていた。 PDF で届く管理会社も複数ある。 同じ送金明細でも、読み方は管理会社の数だけ要ることになる。
帳票だけでは決まらない税区分
金額の次に引っかかったのは税区分だった。 帳票の税区分が間違っているのではないか、と聞くと、「帳票だけでは間違っているとは言えない」と返ってきた。 課税か非課税かを決めるのは、借主が法人か個人かではなく、居住用か、事務所や店舗用かという用途のほうだ、という理解が根拠である。 法人が借りて従業員の社宅にしている部屋なら、住宅の貸付けとして非課税になるはずだ。 ただ、この理解はその時点では未確認で、根拠は調査役に調べさせている最中だった。
個別対応方式の確認
ここで3つ質問した。 そのうちの1つが「課税区分が合っていればよいか」だった。 答えを読んで、課税のみ、非課税のみ、共通に分けるあれか、個別対応方式のことか、と聞き返した。 消費税の仕入税額控除の個別対応方式は、仕入れにかかった税額を、課税売上だけに対応するもの、非課税売上だけに対応するもの、両方に共通するものに分けて計算する。
個別対応方式がどういうときに要るのかも、うろ覚えだった。 聞いてみると、強制される方式ではなく、全額控除が使えないときに一括比例配分方式とどちらかを選ぶものだ、という答えだった。 条文の裏づけは、根拠調査に含めさせた。
計画書と、判断の6件
法令と蔵書の根拠調査も届き、材料がそろった。 抜き取りで原本とも照らさせ、どの社のぶんも報告どおりだと確かめてから、計画書を書かせた。 管理会社ごとの帳票をいったん共通の形(中間テーブル)に読み替え、そこから仕訳を組み立てる骨組みである。 計画書には図も入れた。
判断が要る項目は、HTML の判断ボタンで答える形にした。 ボタンを開く前に Codex のレビューにかけさせると、1回目は要修正が4件、反映した2回目で承認が出た。 6件の判断に答え、回答を計画書に書き込ませた。 この時点では、まだ実装に入っていない。
続けて、「これ引き継ぎのセッション立ち上げて計画実装をしてください。コミットもしてください。プッシュも。」と頼んだ。 計画書のコミットは、事前のレビューに何度も止められ、通ったのは5回目だった。 最後に止められた2件は、どちらも計画書の中の食い違いだった。 図に描いた税区分の例と、テスト条件の書き方である。 push のあと、会話を引き継がない新規のセッションが、試作から実装に入る名前で立ち上がった。
引き継ぎ先での組み立て順
引き継ぎ先のセッションには、設計を固めてから次の順で組み立てさせた。
項目マスタ → 共通の組み立て → ある管理会社の帳票の読み替え → 架空データ → テスト
共通の部分を先に作り、管理会社ごとの読み替えは、そのあとに1社ぶんだけ足す順番だ。 最初のブックとテストには、架空のデータを使わせた。
架空データとテーマの入口になるファイルを書く段では、シェルからの書き込みが通らず、Write ツールで入れ直していた。 関係するテストを回すと、143件中2件が落ちた。 別のセッションが作り直しているブックの影響ではないかを、まず切り分けさせた。
描画の確認では、Chrome DevTools MCP の接続がタイムアウトした。 同じ日に起票されていた既知の issue を読んで対処しても、また繋がらない。 issue にあった回避策どおり、リポジトリの Playwright に切り替えて描画を確かめさせた。
Codex のコミットレビューで出た指摘
型チェックを通してコミットに進むと、Codex のコミットレビューで指摘が返ってきた。 1回目は2件。 同じ名前の控除が出たら止めること。 実物の帳票の JSON を読むファイルには、本番から届かないことをテストで固定すること。
2回目は、同じ部屋で同じ名前の修繕が1行に足し込まれてしまう問題だった。 直して、テストを足させた。 3回目にも、別の2件が出た。 入金と控除が同じ名前のときと、入金欄に無い部屋があるときである。
並べると、5件のうち4件が、名前の重なりか、片方の欄にしか無い部屋にかかわっていた。 2行が1行に足し込まれても、合計の金額は変わらない。 合計だけを照らす検査では、この崩れは見つからない。
共有のステージに混ざる別セッションの差分
コミットの段取りそのものにも手間取った。 同じリポジトリでは、別のセッションも並行して作業している。 テーマを登録するファイルには別セッションの差分も入っていたので、引き継ぎ先の作業の分だけをハンク単位でステージさせた。
それでも、別セッションがコミット中で index.lock を持っている場面があり、終わるのを待った。 共有のステージに別セッションの分が混ざったときは、引き継ぎ先の作業の分だけを入れた一時のインデックスからコミットさせた。 その判断が2度あった。 さらに、レビューの最中に別セッションがコミットして HEAD が動き、レビューの結果ごと捨てられた。 HEAD を取り直し、最大3回の再試行に入らせた。
実物の版と、完了前の確認
計画の Step 0 に残っていた取り込みの道具も作らせた。 経理の仕訳を項目に分ける道具と、ある管理会社の帳票から実物の版を作る道具である。 実物の版は check が 0 で通り、目録(ブックの一覧)に2冊並んだ。 画面でも、項目ごとの金額と税額が経理の仕訳と一致した。
数値のセルには、取り込んでよい位置(表の中)と桁の上限も付けさせた。 今回の帳票では該当が無いと確かめたうえで、道具として塞いでおいた。
push のあと、完了と言う前に advisor(作業を見直す確認役)にも確認させた。 返ってきた指摘は、無限キャンバスでの描画を確かめていないことや、実物の版に自己点検が当たっていないことだった。 経理の仕訳との突き合わせを機械で照合させると、38件が通った。 キャンバスの描画も撮り直させた。
全テーマのテストでは1件落ちた。 テーマの並びで、グループの見出しが2回出るというものだ。 今回のテーマを足した位置が原因ではないかを調べさせた。
最後の報告は「試作(Step 0・1)まで完了し、main に push 済みです。計画どおりここで止めます。形を見てください。」だった。
振り返り
- 管理会社ごとに形の違う帳票は、いったん共通の形に読み替えてから仕訳にする順にした。読み替えを管理会社ごとに分けたので、試作は1社ぶんだけで形を確かめられた
- Codex の指摘は、名前の重なりと、片方の欄にしか無い部屋に集まった。合計が合っていても、行の対応は崩れうる
- 並行セッションのいるリポジトリでは、部分ステージや一時のインデックスといったコミットの段取りも作業のうちに入る
試作は、計画どおり Step 0 と 1 で止まっている。 次は、自分がその形を見る番だ。