Kurrikulum Leson 221 van 250 · Projek: Document Intelligence Service
Projek: Document Intelligence Service

Stem ooreen met Besigheidsreëls

'n

A rekord kan perfek gevorm wees en steeds wrong wees. Die reëls tel op tot $118 maar die vermelde totaal sê $128. Die datum is 2026-13-40. Die totaal is negatief. Skema-validasie sal nie enige van hierdie vang nie. Hulle is business-rule oortredings. Om hulle te vang is wat 'n speltuig van 'n diens onderskei wat 'n rekeningkundige span werklik sal vertrou.

Skryf reconcile(record) -> 'n lys van diskrepansiestringe. 'n Leë lys beteken die rekord stem skoon ooreen. Elke reël wat faal, voeg een menslike string by. Drie reëls:

  • Items moet bymekaar kom tot die totaal (binne 'n sent). Som die amount van elke item in line_items en vergelyk dit met total. As hulle meer as 0.01 verskil, voeg "total mismatch: items sum to X but total is Y" by (rond albei tot 2 plekke in die boodskap). Floats is onakkuraat, so vergelyk altyd met 'n toleransie, nooit == nie.
  • Die datum moet parse as 'n regte kalenderdatum in YYYY-MM-DD-vorm. Gebruik datetime.strptime(record["date"], "%Y-%m-%d") binne 'n try/except ValueError; by mislukking voeg "bad date: <value>" by. (strptime verwerp onmoontlike datums soos maand 13 vir jou.)
  • Die totaal moet positief wees. As total <= 0, voeg "non-positive total: <value>" by.

Orde is belangrik vir die toetse: kontroleer die sum eerste, dan die date, dan die sign van die totaal, voeg dit in daardie volgorde by sodat 'n rekord wat verskeie reëls breek dit voorspelbaar lys.

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

Dit is die vereenigstegstap wat elke fakturering, uitgawe en grootboekstelsel uitvoer voordat dit 'n ry skryf. Druk Run om 'n skoon rekord en 'n gebreekte een te vereenigste en sien hoe die verskille belyn.

Jou beurt

Skryf reconcile(record) wat 'n lys van diskrepansie-strings teruggee vir 'n rekord met line_items (elke {"desc", "amount"}), total, en date. Voeg by, in hierdie volgorde: 'n "total mismatch: items sum to X but total is Y"-string wanneer die lynitems nie tot total binne 'n sent optel nie (waardes afgerond tot 2 dp); 'n "bad date: <value>"-string wanneer die datum nie 'n werklike YYYY-MM-DD-datum is nie; en 'n "non-positive total: <value>"-string wanneer total <= 0. 'n Skoon rekord gee [] terug.

Sien jy 'n probleem in hierdie les? Rapporteer dit · Vra oor hierdie les

Hierdie oefening open binnekort

Voltooi die lesie voor dit en hierdie een sal ontvanklik wees. Die hele kursus is gratis, geen rekening nodig nie, en jy kan hierdie les nou lees.