Files
certain/backend/app/routers/bank.py
T
GuidoandClaude Opus 5 63de8368f0 feat: Kontostand von der Bank – die eigene Rechnung wird geprueft
Certain rechnet den Saldo bisher ausschliesslich selbst aus: Anfangsbestand
plus alle Buchungen. Stimmt eine Buchung nicht, faellt das erst auf, wenn man
von Hand mit dem Auszug vergleicht.

Der von der Bank gemeldete Saldo wird jetzt mitgefuehrt und danebengestellt.
Weicht er ab, fehlt oder doppelt eine Buchung – und man sieht es auf der
Kontenseite und in den Einstellungen sofort, statt es zu suchen.

Banken melden mehrere Saldi nebeneinander; ausgewaehlt wird der gebuchte, denn
nur der ist mit Certains Rechnung vergleichbar. Ein verfuegbarer Saldo enthaelt
Vorgemerktes oder einen Ueberziehungsrahmen.

Die Saldi kommen auch fuer noch nicht zugeordnete Konten: Bei mehreren
Revolut-Pockets ist der Betrag oft das Einzige, woran man sie unterscheidet.
Ein Fehler bei einem Konto beendet den Durchlauf nicht.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-26 23:08:56 +02:00

198 lines
7.1 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Bankkonten über PSD2 verbinden und abrufen."""
from fastapi import APIRouter, Depends, HTTPException, status
from sqlalchemy.orm import Session
from ..database import get_db
from ..deps import get_current_user, get_owned
from ..models import Account, BankAccountLink, BankApp, BankConnection, User
from ..schemas import (
BankAccountLinkOut,
BankAppIn,
BankAppOut,
BankConnectionOut,
BankConnectStart,
)
from ..services import bank_sync, geheimnis
from ..services.bank_api import BankFehler
router = APIRouter(prefix="/bank", tags=["bank"])
def _fehler(e: BankFehler) -> HTTPException:
return HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail=str(e))
# --- Die Anwendung dieser Installation ---------------------------------------
@router.get("/app", response_model=BankAppOut | None)
def get_app(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
return db.query(BankApp).filter(BankApp.owner_id == user.id).first()
@router.put("/app", response_model=BankAppOut)
def set_app(payload: BankAppIn, db: Session = Depends(get_db),
user: User = Depends(get_current_user)):
"""Application ID, Schlüsseldatei und Rückleitungs-Adresse hinterlegen."""
app = db.query(BankApp).filter(BankApp.owner_id == user.id).first()
if app is None:
app = BankApp(owner_id=user.id)
db.add(app)
app.application_id = payload.application_id.strip()
app.private_key_enc = geheimnis.verschluesseln(payload.private_key)
app.base_url = payload.base_url
db.commit()
db.refresh(app)
return app
@router.delete("/app", status_code=status.HTTP_204_NO_CONTENT)
def delete_app(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
app = db.query(BankApp).filter(BankApp.owner_id == user.id).first()
if app is not None:
db.delete(app)
db.commit()
@router.get("/banks")
def list_banks(country: str | None = None, search: str | None = None,
db: Session = Depends(get_db),
user: User = Depends(get_current_user)) -> dict:
"""Banken suchen – in einem Land oder über alle hinweg.
Ohne ``country`` wird überall gesucht. Das braucht es, weil die IBAN nicht
verrät, wo eine Bank sitzt: Revolut vergibt deutsche IBANs aus Litauen.
"""
if not country and not search:
raise HTTPException(
status_code=status.HTTP_400_BAD_REQUEST,
detail="Bitte ein Land wählen oder einen Suchbegriff eingeben.",
)
try:
return bank_sync.banken(db, user, country, search)
except BankFehler as e:
raise _fehler(e) from e
# --- Verbindungen ------------------------------------------------------------
@router.get("/connections", response_model=list[BankConnectionOut])
def list_connections(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
verbindungen = (
db.query(BankConnection)
.filter(BankConnection.owner_id == user.id, BankConnection.session_id.isnot(None))
.order_by(BankConnection.id)
.all()
)
out = []
for v in verbindungen:
eintrag = BankConnectionOut.model_validate(v)
eintrag.expires_soon = bank_sync.laeuft_bald_ab(v)
out.append(eintrag)
return out
@router.post("/connect")
def connect(payload: BankConnectStart, db: Session = Depends(get_db),
user: User = Depends(get_current_user)) -> dict:
"""Autorisierung starten. Die Antwort enthält die Adresse der Bank."""
try:
return bank_sync.starte_verbindung(
db, user, payload.aspsp_name, payload.country, payload.psu_type)
except BankFehler as e:
raise _fehler(e) from e
@router.post("/callback")
def callback(state: str, code: str, db: Session = Depends(get_db),
user: User = Depends(get_current_user)) -> dict:
"""Der Code von der Rückleitung wird zur Sitzung samt Kontoliste."""
try:
return bank_sync.schliesse_verbindung(db, user, state, code)
except BankFehler as e:
raise _fehler(e) from e
@router.post("/connections/{connection_id}/sync")
def sync(connection_id: int, db: Session = Depends(get_db),
user: User = Depends(get_current_user)) -> dict:
verbindung = get_owned(db, BankConnection, connection_id, user)
try:
return bank_sync.hole_umsaetze(db, user, verbindung)
except BankFehler as e:
verbindung.last_error = str(e)[:500]
db.commit()
raise _fehler(e) from e
@router.post("/connections/{connection_id}/salden")
def refresh_balances(connection_id: int, db: Session = Depends(get_db),
user: User = Depends(get_current_user)) -> dict:
"""Nur die Saldi auffrischen, ohne Umsätze zu holen.
Eigener Endpunkt, weil das auch vor jeder Zuordnung nützt: Bei mehreren
Pockets ist der Betrag oft das Einzige, woran man sie unterscheidet.
"""
verbindung = get_owned(db, BankConnection, connection_id, user)
try:
return {"saldi": bank_sync.hole_salden(db, user, verbindung)}
except BankFehler as e:
verbindung.last_error = str(e)[:500]
db.commit()
raise _fehler(e) from e
@router.delete("/connections/{connection_id}", status_code=status.HTTP_204_NO_CONTENT)
def delete_connection(connection_id: int, db: Session = Depends(get_db),
user: User = Depends(get_current_user)):
db.delete(get_owned(db, BankConnection, connection_id, user))
db.commit()
# --- Kontozuordnung ----------------------------------------------------------
@router.get("/links", response_model=list[BankAccountLinkOut])
def list_links(db: Session = Depends(get_db), user: User = Depends(get_current_user)):
return (
db.query(BankAccountLink)
.filter(BankAccountLink.owner_id == user.id)
.order_by(BankAccountLink.id)
.all()
)
@router.post("/links/{link_id}/account/{account_id}", response_model=BankAccountLinkOut)
def set_link_account(link_id: int, account_id: int, db: Session = Depends(get_db),
user: User = Depends(get_current_user)):
"""Ein Bankkonto einem Konto in Certain zuordnen.
Ohne Zuordnung wird nichts abgerufen – Certain rät nicht, wohin fremde
Umsätze gehören.
"""
verknuepfung = get_owned(db, BankAccountLink, link_id, user)
konto = get_owned(db, Account, account_id, user)
if konto.currency.upper() != verknuepfung.currency.upper():
raise HTTPException(
status_code=status.HTTP_400_BAD_REQUEST,
detail=(f"Währungen passen nicht: Das Bankkonto führt "
f"{verknuepfung.currency}, das Konto '{konto.name}' führt "
f"{konto.currency}."),
)
verknuepfung.account_id = konto.id
db.commit()
db.refresh(verknuepfung)
return verknuepfung
@router.delete("/links/{link_id}/account", response_model=BankAccountLinkOut)
def clear_link_account(link_id: int, db: Session = Depends(get_db),
user: User = Depends(get_current_user)):
verknuepfung = get_owned(db, BankAccountLink, link_id, user)
verknuepfung.account_id = None
db.commit()
db.refresh(verknuepfung)
return verknuepfung