Read_Transactions für Finanzmanager¶

read_transactions – python Paket zum automatischen Abruf von Finanztransaktionen für den Finanzmanager.

Aktuell unterstützt:

Aktienkurse von Ariva
Umsätze von Trade Republic
Umsätze von American Express
Umsätze von Amazon Visa (Zinia)
Bestellungen von Amazon.de (mit integration in Amazon Visa)
Umsätze von PayPal (Beta)

Hier findest du die vollständige Dokumentation des CLI-Interfaces und der Klassen.

Um schnell loszulegen, siehe den Abschnitt Getting Started.

Für Fragen, Anmerkungen oder Probleme könnt ihr gern eine Diskussion im GitHub-Repository eröffnen.

Diese Scriptsammlung dient dazu, Transaktionen via „WebCrawler“
von verschiedenen Finanzdienstleistern automatisiert abzurufen und
anschließend in ein einheitliches CSV-Format zu überführen,
um diese z. B. im Finanzmanager zu importieren.

Alle abgeholten Umsätze werden nach Dienstleister sortiert im Ordner out gespeichert.
Diese CSV-Dateien können anschließend im Finanzmanager über
Datei → Export/Import → Datenimport → Umsätze eingelesen werden.
Zur Vereinfachung können Importvorlagen genutzt werden – eine Beispielvorlage liegt unter Vorlagen.dat.

Inhalt

🌟 Getting Started (empfohlene Nutzung)¶

Der einfachste Weg, das Tool zu verwenden, ist über das vorkompilierte CLI-Programm:

Download der Windows-EXE
Lade die Datei readtx.exe von der Release-Seite herunter
und lege sie z. B. in einen eigenen Ordner (z. B. C:\Tools\readtx).
Start über die Kommandozeile (CLI)
Öffne die Eingabeaufforderung (cmd) oder PowerShell und rufe auf:
```
readtx list
```
Damit siehst du alle verfügbaren Crawler (z. B. ariva, amex, amazon_visa, trade_republic).
Konfiguration anlegen
Erstelle deine persönliche Konfigurationsdatei:
```
readtx config init
```
Dadurch wird automatisch eine Beispiel-config.yaml unter
%USERPROFILE%\.config\read_transactions\config.yaml erstellt.
Trage dort deine Zugangsdaten (Benutzername/Passwort) ein oder nutze z. B. für amazon_visa:
```
readtx config set amazon_visa --user <USERNAME> --pwd <PASSWORT>
```
Hinweis:
Wenn du die Zugangsdaten über das CLI-Tool setzt, werden diese verschlüsselt in der Config-Datei gespeichert.
Crawler starten:

Starte den gewünschten Crawler mit dem run-Befehl.

Zum Beispiel den Amazon Visa-Crawler:
```
readtx run amazon_visa
```
Standardmäßig werden die Umsätze der letzten 6 Monate abgerufen.
Dabei werden die Umsätze mit den Bestellungen von Amazon.de abgeglichen und gespeichert (Details=True, save_orders=True).

Wenn du nur die Umsätze ohne Bestellungen abrufen möchtest, kannst du das so machen:
```
readtx run amazon_visa --o details=False save_orders=False
```
Du kannst start und End-Datum setzen, z. B. für das erste Quartal 2024:
```
readtx run amazon_visa --start 01.01.2024 --end 31.03.2024
```
oder den Trade-Republic-Crawler im Debug-Modus:
```
readtx run trade_republic --l DEBUG
```
Ergebnisse ansehen
Nach Abschluss findest du die CSV-Dateien im aktuellen working-Dir unter dem Ordner:
```
out\
```

⚙️ CLI-Kommandos¶

Das Tool ist vollständig über die Kommandozeile steuerbar.
Alle Befehle folgen dem Schema:

readtx <command> [options]

Verfügbare Hauptbefehle¶

Befehl	Beschreibung	Beispiel
`list`	Listet alle verfügbaren Crawler	`readtx list`
`run <crawler>`	Startet einen bestimmten Crawler	`readtx run ariva --start 01.01.2024 --end 31.03.2024`
`config show`	Zeigt die aktuelle Konfiguration an	`readtx config show`
`config set`	Setzt Benutzername und/oder Passwort verschlüsselt	`readtx config set amex --user max --pwd geheim`
`config edit`	Ändert beliebige Einträge in der Config	`readtx config edit urls.ariva.login https://www.ariva.de/login`
`config clear`	Löscht Config-Cache oder Datei	`readtx config clear --delete`
`config init`	Erstellt eine neue Standard-Config	`readtx config init --overwrite`

Parameter beim `run`-Befehl¶

Option	Bedeutung	Beispiel
`--start`	Startdatum (Standard: heute)	`--start 01.01.2024`
`--end`	Enddatum (Standard: heute − 6 Monate)	`--end 31.03.2024`
`--l`	Log-Level (DEBUG, INFO, WARNING, ERROR)	`--l DEBUG`
`--o`	Zusätzliche Parameter (key=value)	`--o output_path='myout' browser='chrome' headless=False`

🧩 Beispiel-Workflows¶

Ariva-Kurse für Q1 2024 abrufen¶

readtx run ariva --start 01.01.2024 --end 31.03.2024

Alle Kreditkartenumsätze der letzten 6 Monate abrufen¶

readtx run amex
readtx run amazon_visa

Amazon Visa-Umsätze mit Bestellungen von Amazon.de abgleichen¶

readtx run amazon_visa

ohne orders von amazon.de zu speichern (default ist save_orders=True):

readtx run amazon_visa --o save_orders=False

ohne speichern und ohne amazon orders abzurufen (default ist details=True):

readtx run amazon_visa --o details=False save_orders=False

TradeRepublic-Umsätze abrufen¶

ohne zusätzliche Details der Transaktionen mit Trades (default ist details=True) - wesentlich schneller:

readtx run trade_republic --o details=False

Config prüfen¶

readtx config show --credentials

Installation¶

You can use the following methods to install and use the package.

Install it in your Python environment
- set up a Python environment (see Setting-up Python Environment)
- install the package
  - from github (see install from github)
  - from wheel file (see install from wheel file)
Use the provided readtx.exe (Windows only)

install from github¶

aktivate your python environment
install the package with pip:

pip install git+https://github.com/th89dd/read_transactions_fm.git

install from wheel file¶

download the wheel from releases
aktivate your python environment
install the wheel file with pip:

pip read_transactions_fm-1.0.0-py3-none-any.whl

Setting-up Python Environment¶

You can use the following steps, or you can use the bat-file to set up the Python environment on your computer (with Windows).

Install Python 3.12 (or newer)
- download Python 3.12 from Python.org
- install Python
- you can check if Python is installed correctly:
```
python --version
```
Create a virtual environment:
- create a virtual environment in the project folder:
- open a terminal in the project folder and run:
```
python -m venv venv
```
Activate the virtual environment:
```
venv\Scripts\activate
```
Deactivate the virtual environment:
```
deactivate
```

Automatische Generierung¶

Diese Website wird bei jedem Push automatisch aus dem Quellcode erzeugt und veröffentlicht:

API-Referenz: via sphinx-autoapi aus den Docstrings unter src/read_transactions.
CLI-Hilfe: via sphinx-argparse aus dem argparse.ArgumentParser in read_transactions.cli.

Versionshistorie¶

Version	Datum	Beschreibung
2.2.0	2025-11-05	add paypal crawler - beta
2.1.1	2025-10-27	bugfixes (amazon_visa) - stable
2.1.0	2025-10-26	add amazon.de crawler
2.0.0	2025-10-25	Major Release mit neuem CLI-Interface
1.0.0	2024	Initiale Veröffentlichung

version 2.2.0 (2025-11-05)¶

Neuer Crawler: paypal - für PayPal Umsätze
Vereinheitlichungen der process Methoden in allen Crawlern
spezifisches Datenhandling in preprocess Methode umgesetzt

version 2.1.1 (2025-10-27)¶

amazon_visa wird jetzt in Intervallen runtergeladen, da die xls scheinbar nur 100-110 Einträge pro Datei zulässt
amazon_visa: erkennt jetzt Amazon als Empfänger und vereinheitlicht den Namen mit Amazon.de
Kleinere Bugfixes

version 2.1.0 (2025-10-26)¶

Neuer Crawler: amazon - für Amazon.de Bestellungen
Integration von Amazon Visa Umsätzen mit Amazon.de Bestellungen

version 2.0.0 (2025-10-26)¶

Major Release mit neuem CLI-Interface
Verbesserte Konfigurationsverwaltung
Neue Crawler-Optionen

version 1.0.0 (2024)¶

Initiale Veröffentlichung mit Crawlern für:
- Ariva Aktienkurse
- Trade Republic Umsätze
- American Express Umsätze
- Amazon Visa Umsätze

Lizenz¶

Dieses Projekt ist unter der MIT-Lizenz lizenziert.
Weitere Informationen finden Sie in der LICENSE-Datei.

Nutzungs- und Compliance-Hinweis¶

Nur für Test- und Privatgebrauch
Dieses Projekt und die bereitgestellten Werkzeuge (z. B. Crawler, Parser, CLI) sind ausschließlich für Testzwecke sowie die private, nicht-kommerzielle Nutzung gedacht.

Die Nutzung automatisierter Zugriffe auf Drittanbieter-Dienste (z. B. Banking-Portale, Kreditkarten-Webseiten, Kurs-/Finanzportale) kann gegen deren AGB, technische Nutzungsbedingungen oder geltendes Recht verstoßen. Du bist selbst verantwortlich, vor der Verwendung die anwendbaren Bedingungen zu prüfen und diese einzuhalten.

Kein Umgehen von Schutzmechanismen. Captchas, 2FA und ähnliche Sicherheitsmaßnahmen dürfen nicht umgangen werden.
Offizielle Exportpfade bevorzugen. Wenn verfügbar, nutze die vom Anbieter vorgesehenen Export-/Downloadfunktionen.
Keine Weiterveröffentlichung. Von Drittanbietern stammende Daten (z. B. Kurse, Kontoauszüge) dürfen nicht weiterverbreitet oder kommerziell genutzt werden, sofern dies nicht ausdrücklich erlaubt ist.
Keine Affiliation. Dieses Projekt steht in keiner Verbindung zu den genannten Anbietern und wird von diesen weder unterstützt noch geprüft.

Haftungsausschluss: Die Software wird „as is“ ohne Gewähr bereitgestellt. Die Autor:innen übernehmen keine Haftung für etwaige Schäden, Kontosperren, Vertragsverletzungen oder Datenverluste, die aus der Nutzung entstehen.

Hinweis zur Lizenz: Die Open-Source-Lizenz dieses Repos (z. B. MIT) bleibt unberührt. Dieser Abschnitt dient der Aufklärung/Compliance und begründet keine zusätzlichen Rechte.