bimetricsEntwickler
Zuordnungen

Mahnkosten einer Zuordnung prüfen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/match/{id}/reminder-charges-preview

Sagt, ob sich die Zahlung über dem Rechnungsbetrag als Mahnkosten und Zinsen der zuletzt ausgestellten, nicht zurückgezogenen Mahnung buchen lässt, und liefert, was der Nutzer vorher bestätigt: Mahnungs- und Rechnungsnummer, Mehrbetrag, Aufteilung und Konten. Es braucht genau eine Ausgangsrechnung und einen gebuchten Euro-Eingang, kein Skonto und keine erfassten Zahlungen. Der Mehrbetrag darf höchstens so hoch sein wie Gebühren, Pauschale und Zinsen der Mahnung; ausgeglichen werden erst die Kosten, dann die Zinsen. Passt die Zuordnung nicht, antwortet die API mit eligible: false und nennt in refusal den Code. Verändert nichts.

Benötigt einen Schlüssel mit der Berechtigung read.

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 Objekts in dieser Firma (UUID).

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Ob sich der Mehrbetrag einer Zuordnung als Mahnkosten und Zinsen buchen lässt, und was das bucht. Speichert nichts.

eligible?boolean

True, wenn settleMatchReminderCharges den Mehrbetrag jetzt buchen kann.

expectedVersions?

Für settleMatchReminderCharges, unverändert.

exportedBookings?boolean

True, wenn beteiligte Buchungen schon an DATEV exportiert sind. Über die API steht eligible dann auf false. In der App bleiben die Buchungen stehen, und Mahnkosten und Zinsen kommen mit dem Datum der Zahlung dazu. DATEV bekommt sie erst, wenn der Monat der Zahlung noch einmal exportiert wird.

finalizedBookings?boolean

True, wenn beteiligte Buchungen festgeschrieben sind. Sie bleiben stehen, Storno und Neubuchung entstehen nur, wenn sich für DATEV etwas ändert; Mahnkosten und Zinsen sind neue Buchungen.

refusal?string

Bei eligible: false: der Fehlercode, mit dem der Aufruf abgelehnt würde.

reminderCharges?

Was bimetrics buchen würde.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/match/497f6eca-6276-4993-bfeb-53cbbbba6f08/reminder-charges-preview" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
{  "eligible": true,  "expectedVersions": {    "e21b3d18-17ea-4318-810c-919ec0a94dcb": "0e8ca8e3db88d8d5b74c965d0e17598a5909240c88376e0b0a4a23e53ee9356f"  },  "exportedBookings": false,  "finalizedBookings": false,  "reminderCharges": {    "costsAccount": 8603,    "costsMinor": 250,    "excessMinor": 1484,    "interestAccount": 2650,    "interestMinor": 1234,    "invoiceNumber": "RE-2026-1005",    "reminderId": "c58b1bf1-a4d7-45a8-944c-c97d54954314",    "reminderNumber": "MA-2026-0003"  }}

Mehrbetrag einer Zuordnung als Mahnkosten und Zinsen buchen POST

Bucht die Zahlung über dem Rechnungsbetrag als Mahnkosten und Verzugszinsen der Mahnung, wie „als Mahnkosten und Zinsen buchen“ in der App, ohne die Zuordnung vorher aufzuheben. Rufe das erst auf, wenn der Nutzer die Werte aus `previewMatchReminderCharges` bestätigt hat. bimetrics ersetzt die Zuordnung in einem Schritt durch eine neue über dieselbe Rechnung und Zahlung und bucht den Debitor an die Ertragskonten, ohne Umsatzsteuer; `replacedMatchId` nennt die alte. Der offene Betrag ist danach null, die Rechnung bleibt und lässt sich nicht mehr korrigieren. `expectedVersions` kommt unverändert aus `previewMatchReminderCharges`, auch die Version der Mahnung. Eine Wiederholung mit gleichem Schlüssel bucht nichts erneut. Nicht möglich, wenn die Zuordnung nicht passt oder schon Mahnkosten oder Skonto gebucht hat (`422 ReminderChargesNotEligible`) und 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. Benötigt einen Schlüssel mit der Berechtigung `matching:write`.