シラバス レッスン 250 中 221 · プロジェクト:ドキュメントインテリジェンスサービス
プロジェクト:ドキュメントインテリジェンスサービス

ビジネスルールで突き合わせる

レコードは形が完璧でも、間違っている ことがあります。明細の合計は $118 なのに、記載された合計は $128。日付は 2026-13-40。合計がマイナス。スキーマ検証ではどれも見つけられません -> これらは ビジネスルール の違反で、それを見つけられるかどうかが、おもちゃと、経理チームが本当に信頼するサービスとを分けます。

reconcile(record) を書いてください -> 不一致を表す文字列のリスト を返します。空のリストは、レコードがきれいに突き合わせられたことを意味します。失敗した各ルールが、人が読める文字列をひとつ追加します。ルールは 3 つです:

  • 明細の合計が total と一致すること(1 セント以内)。line_items の各要素の amount を合計し、total と比べます。差が 0.01 より大きければ "total mismatch: items sum to X but total is Y" を追加します(メッセージ内ではどちらも小数 2 桁に丸めます)。float は不正確なので、必ず許容誤差で比べ、== は決して使いません。
  • 日付が YYYY-MM-DD 形式の実在する暦日として解析できること。try/except ValueError の中で datetime.strptime(record["date"], "%Y-%m-%d") を使い、失敗したら "bad date: <value>" を追加します(strptime は 13 月のようなありえない日付を拒否してくれます)。
  • total が正であること。total <= 0 なら "non-positive total: <value>" を追加します。

テストでは順番が大事です。まず 合計、次に 日付、最後に total の 符号 を確認し、その順に追加します。そうすれば、いくつものルールを破るレコードでも、予測できる順で並びます。

from datetime import datetime

def reconcile(record):
    issues = []
    items_sum = sum(it["amount"] for it in record["line_items"])
    if abs(items_sum - record["total"]) > 0.01:
        issues.append(...)
    # then the date, then the sign
    return issues

これは、請求、経費、元帳のあらゆるシステムが、行を書き込む前に必ず実行する突き合わせのステップです。Run を押して、きれいなレコードと壊れたレコードを突き合わせ、不一致が並ぶのを見てみましょう。

あなたの番

line_items(それぞれ {"desc", "amount"})、total、date を持つレコードについて、不一致を表す文字列のリストを返す reconcile(record) を書いてください。次の順に追加します。明細が 1 セント以内で total に一致しないときは "total mismatch: items sum to X but total is Y" の文字列(値は小数 2 桁に丸める)、日付が実在する YYYY-MM-DD の日付でないときは "bad date: <value>" の文字列、total <= 0 のときは "non-positive total: <value>" の文字列です。きれいなレコードは [] を返します。

このレッスンに問題を見つけましたか?報告する · このレッスンについて質問する

この演習はまもなく開きます

その前のレッスンを終えると、このレッスンが解放されます。コース全体が無料でアカウントも不要、このレッスンは今すぐ読めます。