# Lastschrift für PayPal prüfen (https://developer.bimetrics.de/reference/bank-transactions/preview-pay-pal-funding)

`GET https://app.bimetrics.de/api/banktransaction/{id}/paypal-funding-preview`

operationId: `previewPayPalFunding` · Berechtigung (Scope): `matching:write` · Bereich: Umsätze

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

> **Achtung:** Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
>
> KI-Agenten fragen vor diesem Aufruf beim Nutzer nach.

### Authentifizierung

`Authorization: Bearer bm_…` (alternativ `X-API-KEY: bm_…`, nie beide zugleich).

### Parameter

| Name | Ort | Pflicht | Typ | Beschreibung |
| --- | --- | --- | --- | --- |
| `id` | path | ja | string (uuid) | ID des Bankumsatzes der Abbuchung (UUID). |
| `bankAccountId` | query | ja | string | ID des PayPal-Kontos (UUID). |
| `fundedTransactionId` | query | nein | string | ID der PayPal-Zahlung, die die Abbuchung deckt (UUID), optional. |
| `date` | query | nein | string | Ohne `fundedTransactionId`: Tag der Aufladung als `JJJJ-MM-TT`, höchstens 45 Tage vor der Abbuchung. Ohne ihn der Tag der Wertstellung. |

### Beispiel

```sh
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/{id}/paypal-funding-preview" \
  -H "Authorization: Bearer $BIMETRICS_API_KEY"
```

### Antworten

| Status | Beschreibung | Inhalt |
| --- | --- | --- |
| 200 | Erfolg. | `application/json`: PayPalFundingPlan |
| 400 | Ungültige Anfrage, z. B. ein Parameter mit ungültigem Wert wie eine ID, die keine UUID ist; korrigieren statt wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |
| 401 | Kein gültiger Schlüssel: fehlt (`Unauthorized`), ist unbekannt, abgelaufen oder widerrufen oder wurde nicht in genau einem Header gesendet (`InvalidAPIKey`). Schlüssel prüfen, nicht wiederholen. Auch eine ID, die zu einer anderen Firma gehört, ergibt `401 Unauthorized`. | `application/json`: Error |
| 403 | Dem Schlüssel fehlt die Berechtigung für diesen Endpunkt (`APIKeyPermissionDenied`, `context.scope` nennt sie; Berechtigungen sind fest: neuen Schlüssel anlegen, austauschen, alten widerrufen), der Endpunkt ist für API-Schlüssel nicht freigegeben (`APIKeyPermissionDenied` ohne `context.scope`), oder die Firma hat keinen API-Zugang (mehr), etwa nach Ende der Testphase oder des Abos (`APIUnavailable`). | `application/json`: Error |
| 404 | Nicht gefunden (`NotFound`). | `application/json`: Error |
| 413 | Die Anfrage ist zu groß (`APIRequestTooLarge`), siehe `x-bimetrics-limits`. | `application/json`: Error |
| 429 | Zu viele Anfragen; nach `Retry-After` Sekunden erneut senden. Mehr unter [Fehler](https://developer.bimetrics.de/errors). (Header: Retry-After) | `application/json`: Error |
| 500 | Serverfehler; die Anfrage später wiederholen. Mehr unter [Fehler](https://developer.bimetrics.de/errors). | `application/json`: Error |

#### Felder der Antwort 200 (`PayPalFundingPlan`)

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| `bankAccountId` | string (uuid) | ID des PayPal-Kontos (UUID). |
| `bankAccountName` | string | Name des PayPal-Kontos. |
| `bookings` | Array<PayPalFundingBooking>, kann null sein | Geldtransit an Bank am Tag der Wertstellung, PayPal an Geldtransit am Tag der Aufladung. |
| `date` | NaiveDate | Tag der Aufladung: der Tag der PayPal-Zahlung. |
| `funded` | PayPalFundingTransaction | Die gedeckte PayPal-Zahlung; fehlt ohne `fundedTransactionId`. |
| `matchId` | string (uuid) | Nach dem Buchen: die Zuordnung `paypal_funding`. |
| `planHash` | string | SHA-256 der Vorschau. |
| `replayed` | boolean | Wiederholung mit demselben Idempotency-Key. |
| `transaction` | PayPalFundingTransaction | Die Abbuchung. |

Verschachtelte Schemas stehen vollständig in der OpenAPI-Beschreibung: https://app.bimetrics.de/api/openapi.json
