Lastschrift für PayPal buchen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/banktransaction/{id}/paypal-fundingKein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.
PayPal zieht eine Zahlung per Lastschrift vom Bankkonto ein, auf dem PayPal-Konto steht nur der Einkauf. Die Bankabbuchung wird dann als paypal_funding zugeordnet: Sie bucht Geldtransit an Bank (1360 in SKR03, 1460 in SKR04) am Tag der Wertstellung und PayPal an Geldtransit am Tag der PayPal-Zahlung. Die PayPal-Zahlung behält ihren Beleg, die Ausgabe zählt so nur einmal, Geldtransit und PayPal-Konto stehen danach auf 0. Es geht nur ein gebuchter, noch nicht zugeordneter Abgang eines Kontos, das kein PayPal-Konto ist, auf ein aktives PayPal-Konto derselben Firma in derselben Währung (sonst 409 PayPalFundingInvalidTarget bzw. PayPalFundingCurrencyMismatch). Mit fundedTransactionId nennst du die gedeckte PayPal-Zahlung: ein gebuchter Abgang dieses PayPal-Kontos in Euro, kein Geldtransfer, mindestens so hoch wie die Abbuchung (den Rest zahlt PayPal aus dem Guthaben) und höchstens 45 Tage vor ihr, je Zahlung nur eine Deckung. Sonst antwortet die Route mit 409 PayPalFundingInvalidLink, context.reason nennt den Grund: bank_side, payment, transfer, amount, window oder funded. Liegt einer der beiden Tage in einem Monat, den DATEV schon hat, lehnt bimetrics ab (409 FinalizedBookingsLocked mit exportedMonths). Rückgängig macht man es wie jede Zuordnung mit DELETE /api/match/{id}; der Beleg der PayPal-Zahlung bleibt. Sende bankAccountId, fundedTransactionId bzw. date und den planHash der bestätigten Vorschau, mit Header Idempotency-Key. Hat sich seitdem etwas geändert, antwortet die Route mit 409 MatchConflict: Vorschau neu holen.
Benötigt einen Schlüssel mit der Berechtigung matching:write.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Bankumsatzes der Abbuchung (UUID).
uuidIdempotency-Key*stringStabiler Schlüssel für genau diese Änderung: 1–128 druckbare ASCII-Zeichen ohne Leerzeichen. Bei Wiederholungen denselben Schlüssel und unveränderten Inhalt senden; das Ergebnis wird nicht nochmals erzeugt.
^[!-~]+$1 <= length <= 128PayPal account, payment and planHash of the preview
application/json- body
Bestätigung der Vorschau.
bankAccountId?stringID des PayPal-Kontos (UUID).
uuiddate?Ohne fundedTransactionId: Tag der Aufladung als JJJJ-MM-TT, höchstens 45 Tage vor der Abbuchung. Ohne ihn der Tag der Wertstellung.
fundedTransactionId?stringID der PayPal-Zahlung, die die Abbuchung deckt (UUID), optional.
uuidplanHash?stringplanHash der Vorschau.
Erfolg.
application/json- response
Lastschrift für PayPal: Vorschau oder Buchung.
bankAccountId?stringID des PayPal-Kontos (UUID).
uuidbankAccountName?stringName des PayPal-Kontos.
bookings?array<>|Geldtransit an Bank am Tag der Wertstellung, PayPal an Geldtransit am Tag der Aufladung.
date?Tag der Aufladung: der Tag der PayPal-Zahlung.
funded?Die gedeckte PayPal-Zahlung; fehlt ohne fundedTransactionId.
matchId?stringNach dem Buchen: die Zuordnung paypal_funding.
uuidplanHash?stringSHA-256 der Vorschau.
replayed?booleanWiederholung mit demselben Idempotency-Key.
transaction?Die Abbuchung.
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/paypal-funding" \ -H "Authorization: Bearer $BIMETRICS_API_KEY" \ -H "Idempotency-Key: rechnung-2026-001" \ -H "Content-Type: application/json" \ -d '{}'{ "bankAccountId": "8c2e4a6b-1d3f-4b5a-9c7e-2f4a6b8d0e13", "bankAccountName": "PayPal", "bookings": [ { "amountMinor": 6000, "bookingDate": { "day": 14, "month": 11, "year": 2026 }, "creditAccount": 1200, "creditName": "Geschäftskonto", "debitAccount": 1360, "debitName": "Geldtransit", "text": "Aufladung PayPal" }, { "amountMinor": 6000, "bookingDate": { "day": 12, "month": 11, "year": 2026 }, "creditAccount": 1360, "creditName": "Geldtransit", "debitAccount": 1201, "debitName": "PayPal", "text": "Aufladung PayPal" } ], "date": { "day": 12, "month": 11, "year": 2026 }, "funded": { "amountMinor": -6000, "bookingDate": { "day": 12, "month": 11, "year": 2026 }, "id": "6d8f0b2c-4e6a-4c8e-9a1b-3c5e7a9b1d35", "text": "Bürobedarf Weber · Bestellung 4471" }, "matchId": "5b7d9f1e-2a4c-4e6b-8d0f-1a3c5e7b9d24", "planHash": "abababababababababababababababababababababababababababababababab", "transaction": { "amountMinor": -6000, "bookingDate": { "day": 14, "month": 11, "year": 2026 }, "id": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033", "text": "PayPal Europe S.a.r.l. et Cie S.C.A · 1043587211 PP.4122.PP" }}Umsatz als Dublette kennzeichnen POST
Der Umsatz im Pfad ist der doppelt importierte Umsatz. keepId bleibt als Original erhalten. Offene Buchungen der Dublette entfallen, festgeschriebene bleiben erhalten und bekommen bei Bedarf ein Storno zum ursprünglichen Buchungsdatum. Nur aktive Inhaber können eine Dublette prüfen oder kennzeichnen. Sende keepId und planHash aus der bestätigten Vorschau. Die Dublette verschwindet aus der Umsatzliste. Du kannst das Kennzeichen nicht selbst zurücknehmen. Bei geändertem Plan erneut prüfen und bestätigen. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.
Lastschrift für PayPal prüfen GET
PayPal zieht eine Zahlung per Lastschrift vom Bankkonto ein, auf dem PayPal-Konto steht nur der Einkauf. Die Bankabbuchung wird dann als `paypal_funding` zugeordnet: Sie bucht Geldtransit an Bank (1360 in SKR03, 1460 in SKR04) am Tag der Wertstellung und PayPal an Geldtransit am Tag der PayPal-Zahlung. Die PayPal-Zahlung behält ihren Beleg, die Ausgabe zählt so nur einmal, Geldtransit und PayPal-Konto stehen danach auf 0. Es geht nur ein gebuchter, noch nicht zugeordneter Abgang eines Kontos, das kein PayPal-Konto ist, auf ein aktives PayPal-Konto derselben Firma in derselben Währung (sonst `409 PayPalFundingInvalidTarget` bzw. `PayPalFundingCurrencyMismatch`). Mit `fundedTransactionId` nennst du die gedeckte PayPal-Zahlung: ein gebuchter Abgang dieses PayPal-Kontos in Euro, kein Geldtransfer, mindestens so hoch wie die Abbuchung (den Rest zahlt PayPal aus dem Guthaben) und höchstens 45 Tage vor ihr, je Zahlung nur eine Deckung. Sonst antwortet die Route mit `409 PayPalFundingInvalidLink`, `context.reason` nennt den Grund: `bank_side`, `payment`, `transfer`, `amount`, `window` oder `funded`. Liegt einer der beiden Tage in einem Monat, den DATEV schon hat, lehnt bimetrics ab (`409 FinalizedBookingsLocked` mit `exportedMonths`). Rückgängig macht man es wie jede Zuordnung mit `DELETE /api/match/{id}`; der Beleg der PayPal-Zahlung bleibt. Die Vorschau führt die Zuordnung probeweise aus und nimmt sie zurück, sie lehnt also ab, was auch das Buchen ablehnt. Sie nennt beide Buchungen mit Soll und Haben und den `planHash`. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.