Conteúdo do curso Lição 221 de 250 · Projeto: Serviço de Inteligência de Documentos
Projeto: Serviço de Inteligência de Documentos

Conciliar com as Regras de Negócio

O registro

A pode estar perfeitamente formatado e ainda assim estar errado. Os itens somam $118 mas o total declarado diz $128. A data é 2026-13-40. O total é negativo. A validação de Schema não vai pegar nenhum desses -> eles são violações de regras-de-negócio, e pegá-los é o que separa um brinquedo de um serviço que uma equipe de contabilidade realmente confiaria.

Escreva reconcile(record) -> uma list de strings de discrepância. Uma list vazia significa que o registro concilia perfeitamente. Cada regra que falha adiciona uma string legível por humanos. Três regras:

  • Os itens devem somar o total (dentro de um centavo). Some o amount de cada entrada em line_items e compare com total. Se eles diferirem por mais de 0.01, anexe "total mismatch: items sum to X but total is Y" (arredonde ambos para 2 casas na mensagem). Floats são imprecisos, então sempre compare com uma tolerância, nunca ==.
  • A data deve ser interpretada como uma data de calendário real no formato YYYY-MM-DD. Use datetime.strptime(record["date"], "%Y-%m-%d") dentro de um try/except ValueError; em caso de falha, anexe "bad date: <value>". (strptime rejeita datas impossíveis como mês 13 para você.)
  • O total deve ser positivo. Se total <= 0, anexe "non-positive total: <value>".

A ordem importa para os testes: verifique a sum primeiro, depois a date, depois a sign do total, anexando nessa ordem para que um registro que quebre várias regras os liste de forma previsível.

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 é o passo de reconciliação que todo sistema de faturamento, despesas e livro razão executa antes de ousar escrever uma linha. Pressione Run para reconciliar um registro limpo e um quebrado e ver as discrepâncias se alinharem.

Sua vez

Escreva reconcile(record) que retorna uma lista de strings de discrepância para um registro com line_items (cada {"desc", "amount"}), total e date. Adicione, nesta ordem: uma string "total mismatch: items sum to X but total is Y" quando os itens da linha não somam total dentro de um centavo (valores arredondados para 2 dp); uma string "bad date: <value>" quando a data não é uma data YYYY-MM-DD real; e uma string "non-positive total: <value>" quando total <= 0. Um registro limpo retorna [].

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.