Lastschrift für PayPal prüfen
Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)
Echte Wirkung
/api/banktransaction/{id}/paypal-funding-previewKein 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. 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.
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).
uuidbankAccountId*stringID des PayPal-Kontos (UUID).
fundedTransactionId?stringID der PayPal-Zahlung, die die Abbuchung deckt (UUID), optional.
date?stringOhne fundedTransactionId: Tag der Aufladung als JJJJ-MM-TT, höchstens 45 Tage vor der Abbuchung. Ohne ihn der Tag der Wertstellung.
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-preview?bankAccountId=string" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "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" }, "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" }}Lastschrift für PayPal buchen POST
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`.
Merker für fehlenden Beleg entfernen DELETE
Entfernt den Merker des Umsatzes, auch wenn der Umsatz inzwischen zugeordnet ist oder nicht mehr in der Liste steht. Ohne Merker bleibt alles unverändert. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.