Rezept: PayPal-Konto in der Buchhaltung
PayPal-Umsätze täglich per API holen, Gebühren netto, Umbuchungen als Geldtransit, Einnahmen ohne Beleg je Monat sichtbar — Teil des Buchhaltungs-Pakets.
PayPal ist für die Buchhaltung ein eigenes Konto: Zahlungen gehen ein und aus, Gebühren werden abgezogen, Guthaben wandert aufs Bankkonto. Wer das per CSV-Export pflegt, hat am Monatsende doppelte Umsätze (einmal PayPal, einmal Bank) und Gebühren ohne Beleg. Dieses Rezept zeigt, wie TaskMonkey das PayPal-Konto automatisch mitführt.
Stand: Die Tools gehören zum Buchhaltungs-Paket. Die PayPal-Anbindung richten wir mit Ihnen ein, weil dafür eine eigene PayPal-App nötig ist.
Ziel
- PayPal-Umsätze kommen jeden Morgen automatisch in die Umsatzliste des Workspace.
- Gebühren stehen nicht als eigene Zeile da, der Umsatz ist netto (Brutto plus Gebühr).
- Umbuchungen PayPal ↔ Bank sind als Geldtransit markiert und brauchen keinen Beleg.
- Im Buchhaltungs-Chat sehen Sie je Monat, welche Einnahmen ohne Beleg noch offen sind.
Voraussetzungen
- Buchhaltungs-Paket im Workspace (Belege, Bankumsätze, Abgleich)
- PayPal-REST-App mit Zugriff auf die Transaktionssuche (Client-ID und Secret, als Secrets hinterlegt, nicht im Klartext in der Config)
- Das PayPal-Konto in der Konten-Liste der Buchhaltungs-Config (
accounting.konten, Typpaypal)
Bausteine
| Schritt | Tool | Was passiert |
|---|---|---|
| Abruf | syncPaypalTransactions |
Holt die Transaktionen über die PayPal Transaction Search API (Zeitfenster je Abruf max. 31 Tage, seitenweise). Nur buchungsrelevante Vorgänge, ausstehende, abgelehnte und reine Anzeige-Ereignisse fallen raus. |
| Idempotenz | intern | Jede Zeile bekommt ext_id = paypal:<transaction_id>. Ein zweiter Lauf legt nichts doppelt an. |
| Gebühren | intern | betrag = brutto + gebühr, keine eigene Gebührenzeile (gleiche Regel wie beim CSV-Import). |
| Geldtransit | syncPaypalTransactions, markGeldtransit |
Bankeinzahlung, Auszahlung aufs Bankkonto und Aufladung per Karte sind direkt Transit. markGeldtransit sucht zusätzlich die Gegenbuchung auf Bank oder Kreditkarte (umgekehrtes Vorzeichen, bis 5 Tage Abstand) und markiert sie ebenfalls. |
| Fremdwährung | intern | Die Umrechnung wird mit der Zahlung in Fremdwährung zusammengeführt. Fehlt die Umrechnung in Euro, wird nichts gebucht, sondern eine Frage an die Kanzlei notiert. |
| Status | accountingStatus |
Zeigt je Monat u. a. Einnahmen ohne Beleg: positive Umsätze ohne Beleg, nicht privat, nicht als „ohne Beleg ok“ markiert. |
Der Abruf läuft als geplante Aufgabe, z. B. täglich um 5:20 Uhr für die letzten 35 Tage.
Regeln für wiederkehrende Fälle
Für Umsätze, die nie einen Beleg haben oder privat sind, legen Sie im Chat eine Regel an. Die Regel greift danach bei jedem Abgleich:
- „Canva ist immer privat“
- „Kontoführungsgebühren der Bank brauchen keinen Beleg“
Beispiel-Prompts im Buchhaltungs-Chat
- „Was fehlt noch im September?“
- „Zeig mir die PayPal-Einnahmen ohne Beleg im Oktober.“
- „Welche PayPal-Zahlungen sind in Fremdwährung ohne Umrechnung?“
Grenzen
- Der DATEV-Stapel für PayPal bleibt aus, bis in der Config ein Sachkonto für PayPal steht. Welches Konto, klären Sie mit Ihrer Kanzlei.
- Eine eigene Regel speziell für PayPal-Einnahmen gibt es nicht, es gelten die allgemeinen Regeln (
privat,ohne Beleg). - Das ersetzt keine Steuerberatung.
Verwandte Rezepte: Kreditkarten-Abrechnung als DATEV-Stapel, Fehlende Belege aus Mails und Portalen.