bimetricsEntwickler
Umsätze

Lastschrift für PayPal buchen

Als Markdown ansehen

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

Echte Wirkung

Ändert Daten der Firma; wird atomar mit Idempotenzbeleg und Herkunft protokolliert.
post/api/banktransaction/{id}/paypal-funding

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

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

Header-Parameter

Idempotency-Key*string

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

Muster^[!-~]+$
Länge1 <= length <= 128

Request-Body

PayPal account, payment and planHash of the preview

application/json
  1. body

Bestätigung der Vorschau.

bankAccountId?string

ID des PayPal-Kontos (UUID).

Formatuuid
date?

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

fundedTransactionId?string

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

Formatuuid
planHash?string

planHash der Vorschau.

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" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Idempotency-Key: rechnung-2026-001" \  -H "Content-Type: application/json" \  -d '{}'
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"  },  "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`.