Jevで仕訳の起票候補を作る｜証憑から科目・税区分・金額を決める

{ "借方科目": "交際費", "金額": 132000 }

RECEIPT = """領収書
2026年3月31日
株式会社大和田商事 御中
ご飲食代として
小計        120,000円
消費税(10%)  12,000円
合計        132,000円
上記正に領収いたしました
銀座あけぼの店 TEL 03-1234-5678
登録番号 T1234567890123
"""

import re

AMOUNT_RE = re.compile(r"[¥￥]?\d[\d,]*\s*円|[¥￥]\s*\d[\d,]*")


def find_amounts(text: str) -> list[str]:
    """金額らしき文字列を多めに拾う。絞り込みはしない。"""
    return list(dict.fromkeys(m.group().strip() for m in AMOUNT_RE.finditer(text)))


def to_int(amount: str) -> int:
    return int(re.sub(r"[^\d]", "", amount))

>>> find_amounts(RECEIPT)
['120,000円', '12,000円', '132,000円']

MAX_CHOICE_OPTIONS = 255


def ensure_choice_size(criteria: dict) -> None:
    if len(criteria) > MAX_CHOICE_OPTIONS:
        raise ValueError(f"選択肢が{len(criteria)}件。Choiceは{MAX_CHOICE_OPTIONS}件まで。段階を分ける")

ACCOUNT_GROUPS = {
    "entertainment_group": "取引先との飲食・贈答・供応に関する費用",
    "travel_group": "出張・移動にかかる交通費と宿泊費",
    "supplies_group": "文具・備品などの消耗品の購入",
    "other_group": "上記のいずれにも当てはまらない",
}

ACCOUNTS_BY_GROUP = {
    "entertainment_group": {
        "交際費": "取引先の接待・供応・贈答",
        "会議費": "社内または取引先との打合せにかかる飲食",
        "福利厚生費": "役員・従業員のみを対象とする慰安・懇親",
    },
    "travel_group": {
        "旅費交通費": "出張・移動の実費",
        "通勤費": "従業員の通勤にかかる定期代",
    },
    "supplies_group": {
        "消耗品費": "文具・少額の備品",
        "事務用品費": "事務用の消耗品",
    },
    "other_group": {"雑費": "他の科目に当てはまらない少額の費用"},
}

from typesafe_sdk import Choice, TypeSafeClient

TAX_CLASSES = {
    "課税仕入10": "標準税率10%の課税仕入れ",
    "課税仕入8": "軽減税率8%の課税仕入れ（飲食料品・新聞）",
    "非課税仕入": "非課税とされる仕入れ",
    "対象外": "消費税の課税対象外",
}


def first_pass(client: TypeSafeClient, text: str, amounts: list[str]):
    return client.system_one(
        state={"証憑": text, "金額候補": amounts},
        questions={
            "total": Choice(
                instructions="候補のうち、当社が支払う税込の総額はどれか",
                criteria={a: None for a in amounts},
            ),
            "group": Choice(
                instructions="この支出が属する勘定科目の大分類はどれか",
                criteria=ACCOUNT_GROUPS,
            ),
            "tax_class": Choice(
                instructions="この仕入れに適用される消費税の税区分はどれか",
                criteria=TAX_CLASSES,
            ),
        },
    )

def second_pass(client: TypeSafeClient, text: str, group: str):
    return client.system_one(
        state={"証憑": text},
        questions={
            "account": Choice(
                instructions="この支出の勘定科目はどれか",
                criteria=ACCOUNTS_BY_GROUP[group],
            )
        },
    )

from decimal import ROUND_DOWN, Decimal

TAX_RATES = {
    "課税仕入10": Decimal("0.10"),
    "課税仕入8": Decimal("0.08"),
    "非課税仕入": Decimal("0"),
    "対象外": Decimal("0"),
}

rate = TAX_RATES[tax_class]
tax = int((Decimal(total) * rate / (1 + rate)).quantize(Decimal("1"), rounding=ROUND_DOWN))
base = total - tax

def build_entry(client: TypeSafeClient, text: str) -> dict:
    amounts = find_amounts(text)
    if not amounts:
        return {"status": "金額候補なし", "confidence": 0.0}

    r1 = first_pass(client, text, amounts)
    group = r1.answers["group"].choice
    r2 = second_pass(client, text, group)

    total = to_int(r1.answers["total"].choice)
    tax_class = r1.answers["tax_class"].choice
    rate = TAX_RATES[tax_class]

    # 税額はコードで計算する。Jevには計算させない
    tax = int((Decimal(total) * rate / (1 + rate)).quantize(Decimal("1"), rounding=ROUND_DOWN))
    base = total - tax

    confidences = {
        "total": r1.answers["total"].confidence,
        "group": r1.answers["group"].confidence,
        "tax_class": r1.answers["tax_class"].confidence,
        "account": r2.answers["account"].confidence,
    }
    return {
        "debit_account": r2.answers["account"].choice,
        "debit_amount": base,
        "tax_account": "仮払消費税等",
        "tax_amount": tax,
        "credit_account": "未払金",
        "credit_amount": total,
        "tax_class": tax_class,
        "confidence": min(confidences.values()),
        "confidences": confidences,
        "model": r1.model,
    }

=== 起票候補 ===
  debit_account    交際費
  debit_amount     120000
  tax_account      仮払消費税等
  tax_amount       12000
  credit_account   未払金
  credit_amount    132000
  tax_class        課税仕入10

各項目のconfidence: {'total': 0.895, 'group': 0.907, 'tax_class': 0.907, 'account': 0.895}
採用するconfidence（最小値）: 0.895

def route(entry: dict) -> str:
    if entry["confidence"] < 0.7:
        return "人が起票"
    if entry["confidence"] < 0.95:
        return "起票候補（要承認）"
    return "自動起票"

def check(entry: dict) -> list[str]:
    """コード側の検算。ここを通らない仕訳は起票しない。"""
    errors = []
    debit = entry["debit_amount"] + entry["tax_amount"]
    if debit != entry["credit_amount"]:
        errors.append(f"貸借不一致: 借方 {debit} / 貸方 {entry['credit_amount']}")
    if entry["debit_amount"] <= 0:
        errors.append("本体価額が0以下")
    rate = TAX_RATES[entry["tax_class"]]
    expected = int((Decimal(entry["credit_amount"]) * rate / (1 + rate)).quantize(Decimal("1"), rounding=ROUND_DOWN))
    if entry["tax_amount"] != expected:
        errors.append(f"税額不一致: {entry['tax_amount']} / 期待値 {expected}")
    return errors

税区分を8%と誤認した仕訳の検算: ['税額不一致: 10909 / 期待値 8888']

小計(120,000)を総額と誤認した仕訳の検算: OK ← 通ってしまう

def sum_consistent_total(amounts: list[str]) -> int | None:
    """候補の中に a + b = c を満たす組があれば、その c が総額の可能性が高い。"""
    vals = sorted({to_int(a) for a in amounts})
    found = [c for i, a in enumerate(vals) for b in vals[i:] for c in vals if a + b == c]
    return max(found) if found else None

候補: ['120,000円', '12,000円', '132,000円']
小計+税額=合計 を満たす値: 132000
Jevの選択 132,000円: OK
Jevの選択 120,000円: ★不一致 → 人が確認

from datetime import datetime

entry["judged_at"] = datetime.now().isoformat()
entry["approved_by"] = user_id     # 承認した人
# entry["model"] にはモデル名（jev-1.13.0）が入っている
# entry["confidences"] には項目ごとの確信度が残っている