Privat bezahlt: Stand der Firma lesen

Dokumentiert für Eingangsbelege eine bereits erfolgte Bar- oder Privatzahlung, wie „Zahlung eintragen“ in der Mehrfachauswahl der App: je Beleg der volle offene Betrag, Zahltag ist das Belegdatum, bei einem Datum in der Zukunft heute. Geld bewegt sich nicht, es entsteht weder eine Banktransaktion noch ein Zahlungsauftrag. Standardmäßig ausgeschaltet (`403 ManualPaymentUnavailable`). Übersprungen werden wie in der App alles außer Eingangsbelegen (`kind`), Gutschriften (`credit`), stornierte Belege (`deleted`), Belege aus Dauerbuchungen oder Vorlagen (`linked`), Sammelzuordnungen (`collective`), an DATEV exportierte (`exported`), teilweise bezahlte (`partial`), bezahlte (`paid`), mit Buchungsfehlern (`issues`), noch nicht gelesene (`reading`), ungebuchte (`unbooked`), ohne Betrag (`noAmount`) oder ohne Datum (`noDate`). Dazu `notFound` und `notPreviewed`. Eine einzelne Zahlung nimmst du mit `POST /api/match/payment/reverse` zurück. Höchstens 50 Belege je Aufruf (`400 BulkLimitExceeded`). Die Antwort nennt je Beleg, was geschah: `change` geändert, `skipped` mit Grund übersprungen, `failed` mit Code abgelehnt. Das ist ein Teilerfolg wie in der App: Ein abgelehnter Beleg hält die anderen nicht auf, und die Route antwortet mit `200`. Mit `dryRun` ändert sie nichts und zeigt, was geschähe, mit einer `version` je Beleg. Zum Ausführen gibst du diese als `expectedVersions` zurück, sonst antwortet die Route mit `400 ExpectedVersionRequired`. Es ändert sich nur, was unter `change` stand und seitdem unverändert ist: Ein geänderter Beleg kommt mit `VersionConflict` in `failed`, die übrigen laufen, und ein Beleg ohne Eintrag bleibt mit `notPreviewed` in `skipped`. Jeder Beleg läuft als eigener Befehl mit eigenem Eintrag im Protokoll und zählt einzeln auf die Tagesgrenzen der Firma und der Testphase. Der ganze Aufruf zählt einmal auf die Grenzen je Minute. Eine Wiederholung mit gleichem Idempotency-Key ändert nichts doppelt und erledigt, was noch offen ist. Sie klärt auch den Stand, wenn ein Aufruf abbricht: `OutcomeUnknown` heißt, der Beleg kann schon gebucht sein. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.