feat: Kurs der Bank statt EZB-Naeherung, und Saldo uebernehmen
Bei einer Fremdwaehrungs-Zahlung nennt die Bank oft ihren echten Kurs und den Betrag in der Ausgangswaehrung. Certain warf das weg und naeherte mit dem EZB-Kurs. Das faellt genau dort auf, wo es teuer ist: Die spaeter gelieferte Gegenseite eines Uebertrags laesst sich mit einem geschaetzten Betrag nicht als dieselbe Bewegung wiedererkennen. Der Uebertrag waehlt jetzt in drei Stufen: der von der Bank genannte Gegenbetrag (exakt), sonst ihr Kurs, sonst die EZB. Nur die erste Stufe gilt als bekannt – daran haengt, ob bei einem angebundenen Zielkonto nachgefragt wird. Der Parser klopft mehrere Formen ab, weil die Feldnamen je Anbindung verschieden sind, und setzt still nichts, wenn keine passt. Keine dieser Formen ist gegen echte Daten geprueft; ein falscher Kurs saehe aus wie ein richtiger, deshalb wird lieber gar keiner gesetzt. Ausserdem ein Knopf auf der Kontenseite: den Saldo der Bank als richtig uebernehmen. Die Differenz wandert in den ANFANGSBESTAND – sie steht fuer Bewegungen, die Certain nie gesehen hat, und genau dafuer ist er da. Eine Korrekturbuchung stuende dagegen fuer immer in der Liste und liefe durch jede Auswertung. Die Buchungen bleiben unangetastet. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido
Claude Opus 5
@@ -678,6 +678,12 @@ class InboxItem(Base):
|
||||
transaction_id: Mapped[int | None] = mapped_column(
|
||||
ForeignKey("transactions.id", ondelete="SET NULL"), nullable=True
|
||||
)
|
||||
# Was die Bank ueber die Umrechnung mitteilt. Ihr eigener Kurs schlaegt die
|
||||
# EZB-Naeherung – und nur mit dem exakten Gegenbetrag laesst sich die
|
||||
# spaeter gelieferte Gegenseite eines Uebertrags wiedererkennen.
|
||||
fx_rate: Mapped[float | None] = mapped_column(Numeric(18, 8), nullable=True)
|
||||
counter_amount_cents: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
||||
counter_currency: Mapped[str | None] = mapped_column(String(3), nullable=True)
|
||||
# Kennung der Quelle (Message-ID der Mail, Kennung des Kurzbefehls):
|
||||
# schützt davor, dieselbe Meldung zweimal zu erfassen.
|
||||
external_id: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
||||
|
||||
@@ -239,6 +239,39 @@ def _entkoppele_uebertraege(db: Session, acc: Account) -> None:
|
||||
db.flush()
|
||||
|
||||
|
||||
@router.post("/{account_id}/saldo-uebernehmen", response_model=AccountOut)
|
||||
def adopt_bank_balance(account_id: int, db: Session = Depends(get_db),
|
||||
user: User = Depends(get_current_user)):
|
||||
"""Den von der Bank gemeldeten Saldo als richtig übernehmen.
|
||||
|
||||
Die Differenz wandert in den ANFANGSBESTAND, nicht in eine Korrektur-
|
||||
buchung. Sie steht für Bewegungen, die Certain nie gesehen hat – und
|
||||
genau dafür ist der Anfangsbestand da. Eine erfundene Buchung stünde
|
||||
dagegen für immer in der Liste und liefe durch jede Auswertung.
|
||||
|
||||
Die Buchungen selbst bleiben unangetastet.
|
||||
"""
|
||||
konto = get_owned(db, Account, account_id, user)
|
||||
verknuepfung = (
|
||||
db.query(BankAccountLink)
|
||||
.filter(BankAccountLink.owner_id == user.id,
|
||||
BankAccountLink.account_id == konto.id,
|
||||
BankAccountLink.balance_cents.isnot(None))
|
||||
.first()
|
||||
)
|
||||
if verknuepfung is None:
|
||||
raise HTTPException(
|
||||
status_code=status.HTTP_400_BAD_REQUEST,
|
||||
detail=("Für dieses Konto liegt kein Saldo der Bank vor. Erst "
|
||||
"abrufen, dann übernehmen."),
|
||||
)
|
||||
unterschied = verknuepfung.balance_cents - balances.account_balance_cents(db, konto)
|
||||
konto.opening_balance_cents += unterschied
|
||||
db.commit()
|
||||
db.refresh(konto)
|
||||
return to_out(db, konto, base_currency(db, user), date.today(), _bank_saldi(db, user))
|
||||
|
||||
|
||||
@router.delete("/{account_id}", status_code=status.HTTP_204_NO_CONTENT)
|
||||
def delete_account(
|
||||
account_id: int, db: Session = Depends(get_db), user: User = Depends(get_current_user)
|
||||
|
||||
@@ -537,6 +537,10 @@ class InboxItemOut(BaseModel):
|
||||
# das kann die Oberfläche einen Übertrag nicht von einer Ausgabe
|
||||
# unterscheiden und fragt weiter nach einer Kategorie.
|
||||
transfer_account_id: int | None = None
|
||||
# Was die Bank ueber die Umrechnung mitteilt – ihr Kurs schlaegt die EZB.
|
||||
fx_rate: float | None = None
|
||||
counter_amount_cents: int | None = None
|
||||
counter_currency: str | None = None
|
||||
created_at: datetime | None
|
||||
|
||||
model_config = ConfigDict(from_attributes=True)
|
||||
|
||||
@@ -309,6 +309,61 @@ def _betrag_cents(umsatz: dict) -> int | None:
|
||||
return cents
|
||||
|
||||
|
||||
def _betrag_mit_waehrung(wert) -> tuple[int, str] | None:
|
||||
"""Aus ``{"amount": "12.00", "currency": "EUR"}`` Cent und Waehrung."""
|
||||
if not isinstance(wert, dict):
|
||||
return None
|
||||
cents = csv_import.parse_amount(str(wert.get("amount")), ".")
|
||||
waehrung = wert.get("currency")
|
||||
if cents is None or not waehrung:
|
||||
return None
|
||||
return abs(cents), str(waehrung).upper()[:3]
|
||||
|
||||
|
||||
def _umrechnung(umsatz: dict, waehrung: str | None) -> tuple[float | None, int | None, str | None]:
|
||||
"""Kurs und Gegenbetrag, wie die Bank sie mitteilt.
|
||||
|
||||
Die Feldnamen unterscheiden sich je Anbindung, deshalb werden mehrere
|
||||
Formen abgeklopft – und es wird still NICHTS gesetzt, wenn keine passt.
|
||||
Raten waere hier schlimmer als die EZB-Naeherung, denn ein falscher Kurs
|
||||
sieht aus wie ein richtiger.
|
||||
"""
|
||||
wechsel = umsatz.get("currency_exchange")
|
||||
if isinstance(wechsel, list):
|
||||
wechsel = next((w for w in wechsel if isinstance(w, dict)), None)
|
||||
if not isinstance(wechsel, dict):
|
||||
wechsel = {}
|
||||
|
||||
kurs = None
|
||||
for feld in ("exchange_rate", "rate", "unit_rate"):
|
||||
roh = wechsel.get(feld) if wechsel else None
|
||||
if roh is None:
|
||||
roh = umsatz.get(feld)
|
||||
if roh is None:
|
||||
continue
|
||||
try:
|
||||
wert = float(str(roh).replace(",", "."))
|
||||
except (TypeError, ValueError):
|
||||
continue
|
||||
if wert > 0:
|
||||
kurs = wert
|
||||
break
|
||||
|
||||
# Der Betrag in der ANDEREN Waehrung. Nur brauchbar, wenn er sich von der
|
||||
# Waehrung des Umsatzes unterscheidet – sonst ist es derselbe Betrag.
|
||||
gegen = None
|
||||
for quelle in (wechsel, umsatz):
|
||||
for feld in ("instructed_amount", "original_amount", "source_amount"):
|
||||
treffer = _betrag_mit_waehrung((quelle or {}).get(feld))
|
||||
if treffer and treffer[1] != (waehrung or "").upper():
|
||||
gegen = treffer
|
||||
break
|
||||
if gegen:
|
||||
break
|
||||
|
||||
return kurs, (gegen[0] if gegen else None), (gegen[1] if gegen else None)
|
||||
|
||||
|
||||
def _text(umsatz: dict, ausgabe: bool) -> tuple[str | None, str | None]:
|
||||
"""Empfänger und Verwendungszweck. Bei einer Ausgabe zählt der Empfänger,
|
||||
bei einer Einnahme der Absender."""
|
||||
@@ -530,6 +585,9 @@ def hole_umsaetze(db: Session, user: User, verbindung: BankConnection,
|
||||
if zeile.get("is_duplicate"):
|
||||
continue
|
||||
|
||||
waehrung = ((umsatz.get("transaction_amount") or {}).get("currency")
|
||||
or konto.currency)
|
||||
kurs, gegen_betrag, gegen_waehrung = _umrechnung(umsatz, waehrung)
|
||||
eintrag = InboxItem(
|
||||
owner_id=user.id,
|
||||
source=InboxSource.bank,
|
||||
@@ -537,12 +595,14 @@ def hole_umsaetze(db: Session, user: User, verbindung: BankConnection,
|
||||
account_id=konto.id,
|
||||
date=tag,
|
||||
amount_cents=cents,
|
||||
currency=(umsatz.get("transaction_amount") or {}).get("currency")
|
||||
or konto.currency,
|
||||
currency=waehrung,
|
||||
payee=payee,
|
||||
note=zweck,
|
||||
category_id=zeile.get("category_id"),
|
||||
external_id=kennung,
|
||||
fx_rate=kurs,
|
||||
counter_amount_cents=gegen_betrag,
|
||||
counter_currency=gegen_waehrung,
|
||||
)
|
||||
db.add(eintrag)
|
||||
db.flush()
|
||||
|
||||
@@ -65,16 +65,30 @@ def ist_angebunden(db: Session, user: User, konto: Account) -> bool:
|
||||
|
||||
|
||||
def _gegenbetrag(db: Session, konto: Account, ziel: Account, betrag: int,
|
||||
datum) -> tuple[int | None, bool]:
|
||||
"""Betrag auf der Zielseite und ob er BEKANNT oder geschaetzt ist.
|
||||
datum, eintrag: InboxItem | None = None,
|
||||
) -> tuple[int | None, float | None, bool]:
|
||||
"""Betrag auf der Zielseite, Kurs, und ob der Betrag BEKANNT ist.
|
||||
|
||||
Gleiche Waehrung: derselbe Betrag, exakt. Sonst der EZB-Kurs – eine
|
||||
Naeherung, denn die Bank rechnet mit ihrem eigenen Kurs.
|
||||
Drei Stufen, absteigend nach Verlaesslichkeit:
|
||||
|
||||
1. Der Gegenbetrag, den die Bank selbst genannt hat – exakt.
|
||||
2. Ihr Kurs. Genauer als die EZB, aber der Betrag bleibt gerechnet.
|
||||
3. Der EZB-Kurs. Eine Naeherung; die Bank rechnet mit ihrem eigenen Kurs.
|
||||
|
||||
Nur in Stufe 1 gilt der Betrag als bekannt. Daran haengt, ob bei einem
|
||||
angebundenen Zielkonto nachgefragt wird: Ein gerechneter Betrag laesst sich
|
||||
beim naechsten Abruf nicht als dieselbe Bewegung wiedererkennen.
|
||||
"""
|
||||
if ziel.currency == konto.currency:
|
||||
return betrag, True
|
||||
umgerechnet = currency.convert(db, betrag, konto.currency, ziel.currency, datum)
|
||||
return umgerechnet, False
|
||||
return betrag, None, True
|
||||
|
||||
if (eintrag is not None and eintrag.counter_amount_cents
|
||||
and (eintrag.counter_currency or "").upper() == ziel.currency.upper()):
|
||||
return abs(eintrag.counter_amount_cents), None, True
|
||||
|
||||
kurs = float(eintrag.fx_rate) if eintrag is not None and eintrag.fx_rate else None
|
||||
umgerechnet = currency.convert(db, betrag, konto.currency, ziel.currency, datum, kurs)
|
||||
return umgerechnet, kurs, False
|
||||
|
||||
|
||||
def _pruefe(db: Session, user: User, konto: Account, ziel: Account,
|
||||
@@ -97,7 +111,8 @@ def _pruefe(db: Session, user: User, konto: Account, ziel: Account,
|
||||
|
||||
def _lege_an(db: Session, user: User, konto: Account, ziel: Account,
|
||||
betrag_signiert: int, ziel_betrag: int | None, datum,
|
||||
payee: str | None, beschreibung: str | None) -> Transaction:
|
||||
payee: str | None, beschreibung: str | None,
|
||||
kurs: float | None = None) -> Transaction:
|
||||
"""Die Uebertrags-Buchung, richtig herum.
|
||||
|
||||
Bei einem Zugang kennen wir den Betrag auf DIESEM Konto exakt – der gehoert
|
||||
@@ -119,6 +134,7 @@ def _lege_an(db: Session, user: User, konto: Account, ziel: Account,
|
||||
to_account_id=nach.id,
|
||||
amount_cents=von_betrag,
|
||||
to_amount_cents=nach_betrag,
|
||||
fx_rate=kurs,
|
||||
payee=payee,
|
||||
description=beschreibung,
|
||||
)
|
||||
@@ -185,11 +201,11 @@ def aus_eingang(db: Session, user: User, eintrag: InboxItem, ziel: Account,
|
||||
raise UebertragFehler("Kein Konto zugeordnet")
|
||||
|
||||
betrag = abs(eintrag.amount_cents)
|
||||
ziel_betrag, exakt = _gegenbetrag(db, konto, ziel, betrag, eintrag.date)
|
||||
ziel_betrag, kurs, exakt = _gegenbetrag(db, konto, ziel, betrag, eintrag.date, eintrag)
|
||||
_pruefe(db, user, konto, ziel, exakt, trotzdem)
|
||||
|
||||
txn = _lege_an(db, user, konto, ziel, eintrag.amount_cents, ziel_betrag,
|
||||
eintrag.date, eintrag.payee, eintrag.note)
|
||||
eintrag.date, eintrag.payee, eintrag.note, kurs)
|
||||
eintrag.transaction_id = txn.id
|
||||
eintrag.status = InboxStatus.booked
|
||||
eintrag.category_id = None
|
||||
@@ -212,7 +228,7 @@ def aus_buchung(db: Session, user: User, txn: Transaction, ziel: Account,
|
||||
raise UebertragFehler("Buchung ohne Konto")
|
||||
|
||||
signiert = txn.amount_cents if txn.type == TxnType.income else -txn.amount_cents
|
||||
ziel_betrag, exakt = _gegenbetrag(db, konto, ziel, abs(signiert), txn.date)
|
||||
ziel_betrag, _kurs, exakt = _gegenbetrag(db, konto, ziel, abs(signiert), txn.date)
|
||||
_pruefe(db, user, konto, ziel, exakt, trotzdem)
|
||||
|
||||
# Die vorhandene Buchung umschreiben statt eine zweite anzulegen: Alles, was
|
||||
|
||||
Reference in New Issue
Block a user