40 仕訳データを検証する｜世界一やさしいPython 中級編

STEP 1

課題とデータを見る

最後の総合演習は、会計データの検証です。会計システムに取り込む前、あるいは月次の締めの前に、仕訳データの入力ミスを洗い出す作業を自動化します。

仕訳は、お金の動きを「借方（左）」と「貸方（右）」に分けた記録です。1つの取引は、伝票番号でひとまとまりになり、複数の行からできています。たとえば、売上なら、次のような形です。

J001  行1  借方  売掛金   1,100,000円
J001  行2  貸方  売上高   1,000,000円
J001  行3  貸方  仮受消費税 100,000円

決まりごとは、借方の合計と貸方の合計が、必ず同じになること（貸借一致）です。10月分の仕訳が、journal.csv（10伝票・21行）に入っています。

journal.csvサンプルファイル

伝票番号,行,日付,科目コード,借貸,金額,摘要
J001,1,2025-10-01,1310,借,1100000,アオイ電機 売上
J001,2,2025-10-01,4110,貸,1000000,アオイ電機 売上
J001,3,2025-10-01,2220,貸,100000,仮受消費税
J002,1,2025-10-02,6110,借,1240,交通費
J002,2,2025-10-02,1110,貸,1240,交通費
J003,1,2025-10-03,6140,借,8800,コピー用紙
J003,2,2025-10-03,2210,貸,8800,コピー用紙
J004,1,2025-10-05,1120,借,1320000,アオイ電機 入金
J004,2,2025-10-05,1310,貸,1320000,アオイ電機 入金
J005,1,2025-10-07,6120,借,98000,取引先 会食
J005,2,2025-10-07,1110,貸,89000,取引先 会食
J006,1,2025-10-08,6150,借,5500,携帯電話
J006,2,2025-10-08,1120,貸,5500,携帯電話
J007,1,2025-10-10,6130,借,3600,会議費
J007,2,2025-10-10,1110,貸,3600,会議費
J008,1,2026-10-12,6110,借,2100,セミナー交通費
J008,2,2026-10-12,1110,貸,2100,セミナー交通費
J009,1,2025-10-14,5110,借,0,仕入
J009,2,2025-10-14,2110,貸,0,仕入
J010,1,2025-10-15,1310,借,484000,ミドリ商事 売上
J010,2,2025-10-15,4110,貸,484000,ミドリ商事 売上

使ってよい勘定科目は、科目の一覧（マスタ）である accounts.csv に決まっています。

accounts.csvサンプルファイル

科目コード,科目名,区分
1110,現金,資産
1120,普通預金,資産
1310,売掛金,資産
2110,買掛金,負債
2210,未払金,負債
4110,売上高,収益
5110,仕入高,費用
6110,旅費交通費,費用
6120,接待交際費,費用
6130,会議費,費用
6140,消耗品費,費用
6150,通信費,費用

まず、人が手でやるのと同じように、伝票ごとの借方と貸方を合計してみましょう。

伝票ごとに、借方と貸方を合計するサンプルファイル付き・書き換えOK

Ctrl / ⌘ + Enter でも実行

この欄では、サンプルファイルが使えます。実行のたびに、ファイルは最初の状態に戻ります。

結果

▶ 実行を押すと、ここに結果が出ます

貸借が合っていない伝票が見つかりました。このような確認を、5種類のチェックすべてについて、自動で行えるようにします。

検証するのは、次の5つです。

検証	内容
① 貸借一致	伝票ごとに、借方の合計と貸方の合計が同じか
② マスタ照合	科目コードが、`accounts.csv` にあるか
③ 日付	2025年10月（10/1〜10/31）の範囲か。日付として読めるか
④ 金額	0円や、マイナスになっていないか
⑤ 摘要	空欄になっていないか

さらに、見つけた問題をエラーと警告に分けます。「このままでは使えない」ものがエラー、「使えるかもしれないが、人が見たほうがよい」ものが警告です。どちらにするかは、社内のルールで決まることなので、コードの上のほうに、設定として切り出しておきます。

STEP 2

設計：ルールは関数、結果はひとまとまりのデータ

Lesson 38 と同じく、検証を1つずつ関数にして、リストに並べます。違うのは、結果の持ち方です。問題を見つけるたびに、何が・どこで・どう直すとよいかを、1件分のデータにまとめます。これを dataclass（Lesson 16）で表します。

① 読み込む仕訳とマスタ
② 検証する5つのルールを当てる
③ 分類するエラーと警告に分け、並べ替える
④ レポートにする画面とExcel

見つけた問題は、1件ずつ Finding（発見）にまとめます。

1件の「発見」に入れる情報

voucherどの伝票か（伝票番号）

lineどの行か（0なら、伝票全体の問題）

levelエラーか、警告か

kind問題の種類（貸借不一致、未登録の科目、など）

detail何が起きているか（数字を入れて、具体的に）

fix修正案。提案するだけで、自動では直さない

実際に、1件の「発見」を作ってみましょう。

Finding（発見）を1件作るコードは書き換えられます

Ctrl / ⌘ + Enter でも実行

結果

▶ 実行を押すと、ここに結果が出ます

dataclass にしておくと、f.level のように名前で取り出せ、asdict で辞書にも直せます（あとで表にするときに便利です）。

最後の「修正案」が、大事なところです。データを勝手に書き換えないのが、会計データの鉄則です。金額がどちらの側で正しいのか、本当の日付はいつか、は、証憑を見た人にしか決められません。出力は、「修正のための手がかりを添えた一覧」にとどめます。

STEP 3

部品を1つずつ作る

貸借一致のルール。 伝票ごとに、借方と貸方を合計します。辞書で集計する（Lesson 06）、いつもの形です。

貸借一致のルールとテストコードは書き換えられます

from collections import defaultdict
from dataclasses import dataclass

ERROR, WARNING = "エラー", "警告"
SEVERITY = {"貸借不一致": ERROR, "金額が0": WARNING}

@dataclass
class Finding:
  voucher: str
  line: int
  level: str
  kind: str
  detail: str
  fix: str

def found(kind, voucher, line, detail, fix):
  return Finding(voucher, line, SEVERITY[kind], kind, detail, fix)

def check_balance(rows, accounts):
  totals = defaultdict(lambda: {"借": 0, "貸": 0})
  for r in rows:
      totals[r["伝票番号"]][r["借貸"]] += r["金額"]
  result = []
  for voucher, t in totals.items():
      diff = t["借"] - t["貸"]
      if diff != 0:
          hint = "数字の入れ替えの疑い（差額が9の倍数）。" if diff % 9 == 0 else ""
          result.append(found(
              "貸借不一致", voucher, 0,
              f"借方{t['借']:,}円・貸方{t['貸']:,}円（差額{diff:+,}円）",
              hint + "証憑を見て、どちらの金額が正しいか確かめる",
          ))
  return result

ok = [
  {"伝票番号": "T1", "借貸": "借", "金額": 100},
  {"伝票番号": "T1", "借貸": "貸", "金額": 60},
  {"伝票番号": "T1", "借貸": "貸", "金額": 40},
]
bad = [
  {"伝票番号": "T2", "借貸": "借", "金額": 98000},
  {"伝票番号": "T2", "借貸": "貸", "金額": 89000},
]
assert check_balance(ok, {}) == []                 # 貸方が2行に分かれていても、合計が合えばよい
assert [f.voucher for f in check_balance(ok + bad, {})] == ["T2"]   # 伝票ごとに別々に数える
print(check_balance(bad, {})[0])
print("テスト OK")

Ctrl / ⌘ + Enter でも実行

結果

▶ 実行を押すと、ここに結果が出ます

貸方が2行に分かれていても合計が合えばよいこと、複数の伝票を混ぜずに、伝票ごとに数えることを、テストで確かめました。差額の 9,000 は9の倍数です。桁の入れ替え（98,000 を 89,000 と打つ）をすると、差額が必ず9の倍数になるので、手がかりとして「疑い」の一文を添えています。

1行だけで決まるルール。 科目コード・日付・金額・摘要の4つは、行ごとに調べられます。サンプルの journal.csv には無い「マイナス」「摘要の空欄」「日付の書き方の間違い」も、小さなデータでテストしておきます。

科目・日付・金額・摘要のルールとテストコードは書き換えられます

from dataclasses import dataclass
from datetime import date

PERIOD_START = date(2025, 10, 1)
PERIOD_END = date(2025, 10, 31)
ERROR, WARNING = "エラー", "警告"
SEVERITY = {
  "未登録の科目": ERROR, "日付が期間外": ERROR, "日付の形式": ERROR,
  "金額がマイナス": ERROR, "金額が0": WARNING, "摘要が空欄": WARNING,
}

@dataclass
class Finding:
  voucher: str
  line: int
  level: str
  kind: str
  detail: str
  fix: str

def found(kind, voucher, line, detail, fix):
  return Finding(voucher, line, SEVERITY[kind], kind, detail, fix)

def check_account(rows, accounts):
  return [
      found("未登録の科目", r["伝票番号"], r["行"], f"科目コード {r['科目コード']} がマスタにありません", "正しいコードに直す")
      for r in rows if r["科目コード"] not in accounts
  ]

def check_date(rows, accounts):
  result = []
  for r in rows:
      try:
          d = date.fromisoformat(r["日付"])
      except ValueError:
          result.append(found("日付の形式", r["伝票番号"], r["行"], f"日付「{r['日付']}」を読み取れません", "YYYY-MM-DD で入れ直す"))
          continue
      if not PERIOD_START <= d <= PERIOD_END:
          result.append(found("日付が期間外", r["伝票番号"], r["行"], f"{r['日付']} は期間の外です", "証憑の日付を確かめる"))
  return result

def check_amount(rows, accounts):
  result = []
  for r in rows:
      if r["金額"] == 0:
          result.append(found("金額が0", r["伝票番号"], r["行"], "金額が0円です", "不要な行か確かめる"))
      elif r["金額"] < 0:
          result.append(found("金額がマイナス", r["伝票番号"], r["行"], "金額がマイナスです", "借貸を逆にして入れ直す"))
  return result

def check_memo(rows, accounts):
  return [
      found("摘要が空欄", r["伝票番号"], r["行"], "摘要が空です", "摘要を入れる")
      for r in rows if not r["摘要"].strip()
  ]

def make(day="2025-10-05", code="1110", amount=100, memo="x"):
  return {"伝票番号": "T1", "行": 1, "日付": day, "科目コード": code, "金額": amount, "摘要": memo}

def kinds(findings):
  return [f.kind for f in findings]

accounts = {"1110": "現金", "6110": "旅費交通費"}
assert kinds(check_account([make(code="9999")], accounts)) == ["未登録の科目"]
assert check_account([make(code="6110")], accounts) == []
assert check_date([make(day="2025-10-01")], accounts) == []
assert check_date([make(day="2025-10-31")], accounts) == []   # 期間の初日・最終日は範囲内
assert kinds(check_date([make(day="2025-11-01")], accounts)) == ["日付が期間外"]
assert kinds(check_date([make(day="2025/10/05")], accounts)) == ["日付の形式"]
assert kinds(check_amount([make(amount=0)], accounts)) == ["金額が0"]
assert kinds(check_amount([make(amount=-500)], accounts)) == ["金額がマイナス"]
assert kinds(check_memo([make(memo="  ")], accounts)) == ["摘要が空欄"]
print("テスト OK")

Ctrl / ⌘ + Enter でも実行

結果

▶ 実行を押すと、ここに結果が出ます

日付の書き方が間違っていても、プログラムが止まらないよう、try / except（Lesson 09）で受けて、「日付の形式」という問題として記録しています。期間の初日と最終日がどちらも範囲内であることも、境界のテストとして残しました。

STEP 4

組み合わせて完成させる

5つのルールをリストに並べ、エラー→警告の順に並べ替えて、画面とExcelに出します。修正案には、未登録の科目のために「近いコード」の候補も添えます。

完成：仕訳データの検証レポートpandas・サンプルファイル付き

import csv
from collections import Counter, defaultdict
from dataclasses import dataclass, asdict
from datetime import date
import pandas as pd

PERIOD_START = date(2025, 10, 1)
PERIOD_END = date(2025, 10, 31)
ERROR, WARNING = "エラー", "警告"
# 問題の種類ごとの重さ。社内のルールに合わせて、ここだけ書き換える
SEVERITY = {
  "貸借不一致": ERROR, "未登録の科目": ERROR, "日付が期間外": ERROR, "日付の形式": ERROR,
  "金額がマイナス": ERROR, "金額が0": WARNING, "摘要が空欄": WARNING,
}

@dataclass
class Finding:
  voucher: str   # 伝票番号
  line: int      # 行（0 は伝票全体）
  level: str     # エラー or 警告
  kind: str      # 問題の種類
  detail: str    # 何が起きているか
  fix: str       # 修正案（提案だけ。自動では直さない）

def found(kind, voucher, line, detail, fix):
  return Finding(voucher, line, SEVERITY[kind], kind, detail, fix)

def load_csv(path):
  with open(path, encoding="utf-8") as f:
      return list(csv.DictReader(f))

def load_journal(path):
  rows = load_csv(path)
  for r in rows:
      r["行"] = int(r["行"])
      r["金額"] = int(r["金額"])
  return rows

# ---- 検証ルール：仕訳の行のリストと、科目マスタ（コード → 科目名）を受け取り、Finding のリストを返す ----
def check_balance(rows, accounts):
  totals = defaultdict(lambda: {"借": 0, "貸": 0})
  for r in rows:
      totals[r["伝票番号"]][r["借貸"]] += r["金額"]
  result = []
  for voucher, t in totals.items():
      diff = t["借"] - t["貸"]
      if diff != 0:
          hint = "数字の入れ替えの疑い（差額が9の倍数）。" if diff % 9 == 0 else ""
          result.append(found(
              "貸借不一致", voucher, 0,
              f"借方{t['借']:,}円・貸方{t['貸']:,}円（差額{diff:+,}円）",
              hint + "証憑を見て、どちらの金額が正しいか確かめる",
          ))
  return result

def check_account(rows, accounts):
  result = []
  for r in rows:
      code = r["科目コード"]
      if code not in accounts:
          near = [f"{c} {n}" for c, n in accounts.items() if c[:2] == code[:2]]
          hint = "近いコード（参考）：" + "、".join(near) if near else ""
          result.append(found(
              "未登録の科目", r["伝票番号"], r["行"], f"科目コード {code} がマスタにありません",
              "正しいコードに直す。必要な科目なら、マスタへの追加を相談する。" + hint,
          ))
  return result

def check_date(rows, accounts):
  result = []
  for r in rows:
      try:
          d = date.fromisoformat(r["日付"])
      except ValueError:
          result.append(found("日付の形式", r["伝票番号"], r["行"], f"日付「{r['日付']}」を読み取れません", "YYYY-MM-DD の形で入れ直す"))
          continue
      if not PERIOD_START <= d <= PERIOD_END:
          result.append(found(
              "日付が期間外", r["伝票番号"], r["行"], f"{r['日付']} は {PERIOD_START} 〜 {PERIOD_END} の外です",
              "年や月の打ち間違いが多い。証憑の日付を確かめる",
          ))
  return result

def check_amount(rows, accounts):
  result = []
  for r in rows:
      if r["金額"] == 0:
          result.append(found("金額が0", r["伝票番号"], r["行"], "金額が0円です", "不要な行なら削除、入力途中なら金額を入れる"))
      elif r["金額"] < 0:
          result.append(found("金額がマイナス", r["伝票番号"], r["行"], f"金額が{r['金額']:,}円です", "借方と貸方を逆にして、プラスの金額で入れ直す"))
  return result

def check_memo(rows, accounts):
  return [
      found("摘要が空欄", r["伝票番号"], r["行"], "摘要が書かれていません", "あとで内容が追えるよう、摘要を入れる")
      for r in rows if not r["摘要"].strip()
  ]

CHECKS = [check_balance, check_account, check_date, check_amount, check_memo]

def validate(rows, accounts):
  result = [f for check in CHECKS for f in check(rows, accounts)]
  order = {ERROR: 0, WARNING: 1}
  return sorted(result, key=lambda f: (order[f.level], f.voucher, f.line))

def voucher_table(rows, result):
  levels = defaultdict(set)
  for f in result:
      levels[f.voucher].add(f.level)
  table = []
  for v in sorted({r["伝票番号"] for r in rows}):
      lv = levels[v]
      status = ERROR if ERROR in lv else WARNING if WARNING in lv else "問題なし"
      table.append({"伝票番号": v, "状態": status})
  return table

rows = load_journal("journal.csv")
accounts = {a["科目コード"]: a["科目名"] for a in load_csv("accounts.csv")}
result = validate(rows, accounts)
table = voucher_table(rows, result)

n = Counter(t["状態"] for t in table)
print(f"伝票{len(table)}枚：問題なし{n['問題なし']}、警告のみ{n[WARNING]}、エラーあり{n[ERROR]}")
for f in result:
  where = f"行{f.line}" if f.line else "伝票全体"
  print(f"[{f.level}] {f.voucher} {where} {f.kind}：{f.detail}")
  print("    修正案：", f.fix)

COLS = {"voucher": "伝票番号", "line": "行", "level": "重大度", "kind": "種類", "detail": "内容", "fix": "修正案"}
detail = pd.DataFrame([asdict(f) for f in result]).rename(columns=COLS)
with pd.ExcelWriter("仕訳検証.xlsx", engine="openpyxl") as w:
  detail.to_excel(w, sheet_name="検証結果", index=False)
  pd.DataFrame(table).to_excel(w, sheet_name="伝票別", index=False)
back = pd.read_excel("仕訳検証.xlsx", sheet_name=None)
print({k: len(v) for k, v in back.items()}, back["検証結果"]["重大度"].value_counts().to_dict())

Ctrl / ⌘ + Enter でも実行

この欄では、サンプルファイルが使えます。実行のたびに、ファイルは最初の状態に戻ります。

結果

▶ 実行を押すと、ここに結果が出ます

サンプルデータにわざと入れた問題が、すべて見つかりました。

J001 行3（エラー）：科目コード 2220 は、マスタにありません。借方と貸方の合計は合っているので、貸借のチェックは通ります。「近いコード」として 2210 未払金が挙がりますが、参考です。仮受消費税という科目が必要なのであれば、マスタに加えるかどうかを、経理の責任者に相談します
J005（エラー）：借方 98,000円・貸方 89,000円で、差額は 9,000円です。Lesson 38 の経費申請 E009 も 98,000円（接待交際費・会食）なので、借方が正しい可能性が高そうです。ただし、決めるのは証憑を見た人です
J008 の2行（エラー）：日付が 2026-10-12 です。年の打ち間違いかもしれません。2025-10-12 は日曜日なので、本当の日付かどうかも、証憑で確かめたいところです
J009 の2行（警告）：金額が0円です。借方と貸方が合っているので、エラーにはせず、警告にしました

「問題なし」の6伝票は、貸借の合計が合い、科目・日付・金額・摘要に問題が見つからなかったものです。問題が見つからないことは、仕訳の内容が正しいことの証明ではありません。たとえば、売上を別の科目に入れていても、このチェックでは分かりません。

ブラウザでは、Excelをダウンロードできません。そこで、書き出した 仕訳検証.xlsx を読み直して、シートごとの行数と、エラー・警告の件数を確かめました。自分のパソコンで動かせば、ファイルができます。

STEP 5

自分で書く

お題①　重さを変える。 次の設定では、「金額が0」は警告です。これをエラーに変えると、エラーの件数は何件になるでしょう。設定を1か所だけ書き換えて、エラーの件数を表示してください。

お題①：金額0をエラーにするコードは書き換えられます

Ctrl / ⌘ + Enter でも実行

結果

▶ 実行を押すと、ここに結果が出ます

ヒントを見る

書き換えるのは、SEVERITY の中の「金額が0」の右側だけです。WARNING を ERROR に変えます。

答えの例を見る

ERROR, WARNING = "エラー", "警告"
SEVERITY = {"貸借不一致": ERROR, "未登録の科目": ERROR, "日付が期間外": ERROR, "金額が0": ERROR}

# 見つかった問題（伝票番号, 種類）
found_kinds = [
  ("J001", "未登録の科目"), ("J005", "貸借不一致"),
  ("J008", "日付が期間外"), ("J008", "日付が期間外"),
  ("J009", "金額が0"), ("J009", "金額が0"),
]

errors = [v for v, kind in found_kinds if SEVERITY[kind] == ERROR]
print(len(errors))

お題②　ルールを足す。 1行の金額が1,000,000円以上の行を「高額」として見つけるルール check_big(rows) を完成させてください。該当する（伝票番号, 行）のリストを表示します。

お題②：高額の行を見つけるサンプルファイル付き・書き換えOK

Ctrl / ⌘ + Enter でも実行

この欄では、サンプルファイルが使えます。実行のたびに、ファイルは最初の状態に戻ります。

結果

▶ 実行を押すと、ここに結果が出ます

ヒントを見る

[(r["伝票番号"], r["行"]) for r in rows if r["金額"] >= 1000000] の形です。

答えの例を見る

import csv

with open("journal.csv", encoding="utf-8") as f:
  rows = list(csv.DictReader(f))
for r in rows:
  r["行"] = int(r["行"])
  r["金額"] = int(r["金額"])


def check_big(rows):
  return [(r["伝票番号"], r["行"]) for r in rows if r["金額"] >= 1000000]


print(check_big(rows))

お題③　自分の書き方で作る。 check_balance を使わずに、貸借の差額が0でない伝票を、辞書（伝票番号 → 差額）で表示してください。差額は「借方合計 − 貸方合計」です。

お題③：貸借の差額がある伝票サンプルファイル付き・書き換えOK

Ctrl / ⌘ + Enter でも実行

この欄では、サンプルファイルが使えます。実行のたびに、ファイルは最初の状態に戻ります。

結果

▶ 実行を押すと、ここに結果が出ます

ヒントを見る

diffs = defaultdict(int) を作り、借なら diffs[伝票番号] += 金額、貸なら -= 金額とします（金額は int(...) で数字にします）。最後に、{v: d for v, d in diffs.items() if d != 0} で絞ります。

答えの例を見る

import csv
from collections import defaultdict

with open("journal.csv", encoding="utf-8") as f:
  rows = list(csv.DictReader(f))

diffs = defaultdict(int)
for r in rows:
  amount = int(r["金額"])
  if r["借貸"] == "借":
      diffs[r["伝票番号"]] += amount
  else:
      diffs[r["伝票番号"]] -= amount

print({v: d for v, d in diffs.items() if d != 0})

STEP 6

振り返りと、これから

理解チェック検証の結果を「エラー」と「警告」に分けておく、いちばんの利点は何でしょう？

理解チェック貸借不一致の伝票を見つけたとき、プログラムが借方か貸方の金額を「自動で直さない」のはなぜでしょう？

中級編で学んだことが、どこで使われたか

この総合演習は、中級編の道具箱を総動員したものです。

学んだこと	使った場所
内包表記・`zip`・`sorted`（Lesson 01・05）	結果の絞り込み、並べ替え、列の組み立て
書式・文字の整え方（Lesson 02）	金額の桁区切り、半角カナの正規化
日付（Lesson 03）	休日の判定、期間チェック、月の計算
辞書・集合・入れ子（Lesson 06〜08）	伝票ごとの集計、マスタ照合、対応表
エラー処理・チェック・ログ（Lesson 09〜12）	日付の読み取り、検算、ログ
関数・モジュール・dataclass（Lesson 13〜17）	ルールの関数化、Finding、読みやすい名前
正規表現・CSV（Lesson 19〜20）	請求番号の取り出し
pandas の結合・集計・Excel出力（Lesson 22〜27）	突合、月次集計、確認用のExcel
テスト・安全に動かす習慣（Lesson 28〜29）	`assert`、dry-run、検算
自分のパソコンで動かす（Lesson 30〜32）	月次レポートの持ち帰り方

この先に進むには

中級編はここまでです。ここから先は、仕事で本当に使う中で、必要になったものから学ぶのがよいでしょう。たとえば、次のような方向があります。

Gitによる履歴管理：コードを直した履歴を残し、元に戻せるようにする
pytest：テストを増やしても、ひと続きに実行できる道具（Lesson 28 で名前だけ紹介しました）
SQLとデータベース：Excelやcsvでは扱いきれない量のデータを、検索・集計する
社内システムとの連携：会計ソフトや販売管理システムが用意している、データの入出力の仕組み（APIやCSV取り込み）
AIとの協働を深める：AIにコードを書かせ、点検し、テストで守る習慣（Chapter 9）

どの道に進む場合も、この総合演習で身に付けた、小さく作る・テストで守る・人が最後に確かめるという型が、土台になります。