bimetricsEntwickler
Umsätze

Lastschrift für PayPal prüfen

Als Markdown ansehen

Benötigte Berechtigung:matching:write(Belege und Zahlungen zuordnen)

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
get/api/banktransaction/{id}/paypal-funding-preview

Kein 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.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Bankumsatzes der Abbuchung (UUID).

Formatuuid

Query-Parameter

bankAccountId*string

ID des PayPal-Kontos (UUID).

fundedTransactionId?string

ID der PayPal-Zahlung, die die Abbuchung deckt (UUID), optional.

date?string

Ohne fundedTransactionId: Tag der Aufladung als JJJJ-MM-TT, höchstens 45 Tage vor der Abbuchung. Ohne ihn der Tag der Wertstellung.

Antworten

Erfolg.

application/json
  1. response

Lastschrift für PayPal: Vorschau oder Buchung.

bankAccountId?string

ID des PayPal-Kontos (UUID).

Formatuuid
bankAccountName?string

Name 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?string

Nach dem Buchen: die Zuordnung paypal_funding.

Formatuuid
planHash?string

SHA-256 der Vorschau.

replayed?boolean

Wiederholung mit demselben Idempotency-Key.

transaction?

Die Abbuchung.

Beispielanfrage
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"
Beispielantwort
{  "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`.