Programma Les 221 van 250 · Project: dienst voor documentintelligentie
Project: dienst voor documentintelligentie

Verzondering met bedrijfsregels

Een

A record kan perfect gevormd zijn en toch wrong zijn. De regels tellen op tot $118 maar het vermelde totaal zegt $128. De datum is 2026-13-40. Het totaal is negatief. Schema validatie zal geen van deze vangen -> het zijn business-rule overtredingen, en het vangen ervan is wat een speltje onderscheidt van een service waar een boekhoudteam echt op zou vertrouwen.

Schrijf reconcile(record) -> een list van discrepantie-strings. Een lege lijst betekent dat het record schoon wordt verzoend. Elke regel die faalt voegt één leesbare string toe. Drie regels:

  • Items moeten optellen tot het totaal (binnen een cent). Tel de amount van elke invoer in line_items op en vergelijk dit met total. Als ze verschillen met meer dan 0.01, voeg "total mismatch: items sum to X but total is Y" toe (rond beide af naar 2 decimalen in de bericht). Floats zijn onnauwkeurig, dus vergelijk altijd met een tolerantie, nooit ==.
  • De datum moet worden geparsed als een echte kalenderdatum in YYYY-MM-DD vorm. Gebruik datetime.strptime(record["date"], "%Y-%m-%d") binnen een try/except ValueError; bij een fout voeg je "bad date: <value>" toe. (strptime wijst onmogelijke data zoals maand 13 voor je af.)
  • Het totaal moet positief zijn. Als total <= 0, voeg "non-positive total: <value>" toe.

De volgorde is belangrijk voor de tests: controleer eerst de sum, dan de date, dan de sign van het totaal, voeg ze in die volgorde toe zodat een record dat meerdere regels overtreedt ze voorspelbaar opsomt.

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 de reconciliatiestap die elk facturerings, uitgaven en grootboek systeem uitvoert voordat het een rij mag schrijven. Druk op Run om een schone record en een kapotte record te reconciliëren en zie de discrepanties uitlijnen.

Jij bent aan de beurt

Schrijf reconcile(record) dat een lijst van discrepancy strings retourneert voor een record met line_items (elke {"desc", "amount"}), total en date. Voeg in deze volgorde toe: een "total mismatch: items sum to X but total is Y" string wanneer de regelitems niet optellen tot total binnen een cent (waarden afgerond op 2 dp); een "bad date: <value>" string wanneer de datum geen echte YYYY-MM-DD datum is; en een "non-positive total: <value>" string wanneer total <= 0. Een schoon record retourneert [].

Een probleem ontdekt in deze les? Meld het · Vraag naar deze les

Deze oefening opent binnenkort

Maak de les ervoor af voordat deze wordt ontgrendeld. De hele cursus is gratis, geen account nodig, en je kunt deze les nu lezen.