Euro-Betrag aus der Zahlung prüfen
Benötigte Berechtigung:read(Daten lesen)
Sagt, ob sich für den Beleg einer Zuordnung, der in einer Fremdwährung ist und dessen Euro-Betrag fehlt (documentCurrency ohne euroAmountSource), der Euro-Betrag aus der Zahlung übernehmen lässt, und liefert, was der Nutzer vorher bestätigt: Belegwährung, Betrag vom Beleg, Euro-Betrag der Zahlungen und jede Position vorher und nachher. Nötig sind genau ein Beleg und mindestens ein gebuchter Euro-Umsatz, kein Skonto an der Zuordnung und keine erfassten Zahlungen am Beleg. Passt die Zuordnung nicht, antwortet die API mit eligible: false, refusal nennt den Code und refusalReason den Grund. Verändert nichts.
Benötigt einen Schlüssel mit der Berechtigung read.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Objekts in dieser Firma (UUID).
uuidErfolg.
application/json- response
Ob sich der Euro-Betrag der Zahlungen für den Beleg einer Zuordnung übernehmen lässt, und was das ändert. Speichert nichts.
documentCurrency?stringWährung des Belegs als Code nach ISO 4217.
documentId?stringDer Beleg, dessen Beträge sich ändern.
uuideligible?booleanTrue, wenn takeOverMatchEuroAmount den Euro-Betrag jetzt übernehmen kann.
euroTotalAmount?integerBruttobetrag danach in EUR-Cent: die Summe der zugeordneten Zahlungen.
expectedVersions?Für takeOverMatchEuroAmount, unverändert.
exportedBookings?booleanTrue, wenn beteiligte Buchungen schon an DATEV exportiert sind. Über die API steht eligible dann auf false. In der App bucht bimetrics Storno und Neubuchung im Monat des Belegs; DATEV bekommt sie erst, wenn dieser Monat noch einmal exportiert wird.
finalizedBookings?booleanTrue, wenn festgeschriebene Buchungen bleiben und Storno und Neubuchung im Monat des Belegs entstehen. Eine schon abgegebene Umsatzsteuer-Voranmeldung kann dann eine Berichtigung brauchen.
originalTotalAmount?integerBruttobetrag vom Beleg in Hundertsteln der Belegwährung; bleibt am Beleg.
positions?array<>Jede Position vorher und nachher, anteilig umgerechnet; die Summe stimmt auf den Cent.
refusal?stringBei eligible: false: der Fehlercode, mit dem der Aufruf abgelehnt würde.
refusalReason?stringBei EuroAmountNotEligible: notForeignCurrency Beleg in Euro oder Euro-Betrag schon da, notSingleDocument mehrere Belege in der Zuordnung, noBankPayment kein Umsatz, paymentNotEuro ein Umsatz nicht in Euro, paymentNotBooked ein Umsatz noch nicht gebucht, cashDiscount Skonto an der Zuordnung, manualPayment erfasste Zahlungen am Beleg, notConvertible die Zahlungen laufen in die andere Richtung oder eine Position fiele auf 0 Euro.
"notForeignCurrency""notSingleDocument""noBankPayment""paymentNotEuro""paymentNotBooked""cashDiscount""manualPayment""notConvertible"curl --fail-with-body "https://app.bimetrics.de/api/match/497f6eca-6276-4993-bfeb-53cbbbba6f08/euro-amount-preview" \ -H "Authorization: Bearer $BIMETRICS_API_KEY"{ "documentCurrency": "USD", "documentId": "a129ef0a-da5d-4204-804c-764d751bca95", "eligible": true, "euroTotalAmount": 3951, "expectedVersions": { "d00419ed-ecab-4800-ad69-d482b73a6961": "0e8ca8e3db88d8d5b74c965d0e17598a5909240c88376e0b0a4a23e53ee9356f" }, "exportedBookings": false, "finalizedBookings": false, "originalTotalAmount": 4389, "positions": [ { "after": 3951, "before": 4389, "label": "Kopierpapier A4 10 Pakete" } ]}Euro-Betrag aus der Zahlung übernehmen POST
Bucht den Beleg einer Zuordnung, der in einer Fremdwährung ist, mit dem Euro-Betrag seiner Zahlungen, wie „Euro-Betrag übernehmen“ in der App. Rufe das erst auf, wenn der Nutzer die Werte aus `previewMatchEuroAmount` bestätigt hat und die Zahlungen den ganzen Beleg decken, keine Teilzahlung. bimetrics rechnet jede Position anteilig auf die Summe der Zahlungen um, Steuersätze, Kategorien, Belegwährung und Originalbetrag bleiben; die Zuordnung bleibt bestehen, ihr offener Betrag ist danach null, und `euroAmountSource` steht auf `payment`. Der Bankbetrag folgt dem Kurs der Bank; für die deutsche Umsatzsteuer gilt grundsätzlich der Monatskurs des Bundesfinanzministeriums, das prüft die Steuerberatung. `expectedVersions` kommt unverändert aus `previewMatchEuroAmount`. Eine Wiederholung mit gleichem Schlüssel bucht nichts erneut. Nicht möglich, wenn die Zuordnung nicht passt (`400 EuroAmountNotEligible`, der Grund steht in `detail`) und wenn Buchungen schon an DATEV exportiert sind (`409 FinalizedBookingsLocked`); andere festgeschriebene Buchungen bleiben stehen und werden storniert und neu gebucht. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.
Zuordnung erweitern POST
Fügt einer Zuordnung Belege oder Umsätze hinzu, etwa eine zweite Teilzahlung, wie „Zuordnung erweitern“ in der App. `documentIds` und `transactionIds` nennen die vollständige neue Auswahl: alle bisherigen Einträge und mindestens einen neuen. bimetrics ersetzt die Zuordnung in einem Schritt durch eine neue mit derselben Kategorie und bucht neu; `replacedMatchId` nennt die alte. `expectedVersions` kommt unverändert aus `previewDeleteMatch`. Nicht möglich mit bestätigtem Skonto (`400 CashDiscountNotEligible`), mit gebuchten Mahnkosten (`422 ReminderChargesNotEligible`), mit einem Beleg aus einer Buchungsvorlage (`409 MatchNotExtendable`) und, wie beim Aufheben, wenn Buchungen schon an DATEV exportiert sind (`409 FinalizedBookingsLocked`). Andere festgeschriebene Buchungen bleiben stehen; storniert und neu gebucht werden sie nur, wenn sich für DATEV etwas ändert, etwa bei einer Sammelzahlung. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.