Temario Lección 221 de 250 · Proyecto: servicio de inteligencia documental
Proyecto: servicio de inteligencia documental

Concilia con las reglas de negocio

Un registro puede tener una forma perfecta y aun así estar mal. Las líneas de concepto suman 118 $ pero el total indicado dice 128 $. La fecha es 2026-13-40. El total es negativo. La validación por esquema no atrapa nada de esto -> son violaciones de reglas de negocio, y atraparlas es lo que separa un juguete de un servicio en el que un equipo de contabilidad confiaría de verdad.

Escribe reconcile(record) -> una lista de cadenas de discrepancia. Una lista vacía significa que el registro concilia sin problemas. Cada regla que falla añade una cadena legible. Tres reglas:

  • Los conceptos deben sumar el total (con un margen de un céntimo). Suma el amount de cada entrada de line_items y compáralo con total. Si difieren en más de 0.01, añade "total mismatch: items sum to X but total is Y" (redondea los dos a 2 decimales en el mensaje). Los floats son imprecisos, así que compara siempre con una tolerancia, nunca con ==.
  • La fecha debe poder analizarse como una fecha real del calendario en formato YYYY-MM-DD. Usa datetime.strptime(record["date"], "%Y-%m-%d") dentro de un try/except ValueError; si falla, añade "bad date: <value>". (strptime rechaza por ti fechas imposibles como el mes 13.)
  • El total debe ser positivo. Si total <= 0, añade "non-positive total: <value>".

El orden importa para las pruebas: comprueba primero la suma, luego la fecha y luego el signo del total, añadiendo en ese orden para que un registro que rompa varias reglas las liste de forma predecible.

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

Este es el paso de conciliación que ejecuta todo sistema de facturación, gastos o libro contable antes de atreverse a escribir una fila. Pulsa Ejecutar para conciliar un registro limpio y uno roto, y ver alinearse las discrepancias.

Tu turno

Escribe reconcile(record), que devuelva una lista de cadenas de discrepancia para un registro con line_items (cada uno {"desc", "amount"}), total y date. Añade, en este orden: una cadena "total mismatch: items sum to X but total is Y" cuando los conceptos no sumen total con un margen de un céntimo (valores redondeados a 2 decimales); una cadena "bad date: <value>" cuando la fecha no sea una fecha YYYY-MM-DD real; y una cadena "non-positive total: <value>" cuando total <= 0. Un registro limpio devuelve [].

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.