bimetricsEntwickler
Zuordnungen

Offenen Zuordnungsbetrag berechnen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/match/util/amountopen

Berechnet den offenen Betrag für ausgewählte Belege und Umsätze ohne Speicherung. Betrag als Dezimalzahl in Euro.

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.

Request-Body

application/json
  1. body

Belege und Umsätze für eine unverbindliche Betragsberechnung.

category?|

Optionale Zuordnungskategorie.

confirmCashDiscount?boolean

Skontodifferenz bei der Berechnung bestätigen.

confirmReminderCharges?boolean

Mehrbetrag als Mahnkosten und Zinsen buchen; nur beim Anlegen der Zuordnung, die Berechnung ändert er nicht.

documentIds?array<string>|

Beleg-IDs.

documentSeriesIds?array<string>|

Buchungsvorlagen-IDs.

origin?|

Für die unverbindliche Vorschau ohne Herkunftswirkung.

suggestionId?|

Optionale Referenz eines Zuordnungsvorschlags.

transactionIds?array<string>|

Umsatz-IDs.

Antworten

Erfolg.

application/json
  1. response

Vorschau des offenen Zuordnungsbetrags.

amountOpen?string

Offener Betrag als Dezimalzahl in Euro.

Muster^-?[0-9]+(\.[0-9]+)?$
Formatdecimal
cashDiscount?

Ermittelter Skonto.

cashDiscountReference?

Mit cashDiscount: Was der Nutzer vor dem Bestätigen vergleicht.

cashDiscountRefusal?string

Ohne cashDiscount, obwohl die Zahlung höchstens 5 % unter den Eingangsbelegen liegt: warum es kein Skonto gibt (supplier, category, taxRates oder documentAmount).

reminderCharges?

Mehrbetrag einer Zahlung über einer Rechnung, den confirmReminderCharges als Mahnkosten und Zinsen der zuletzt ausgestellten Mahnung buchen würde; fehlt sonst.

transferValidation?

Ergebnis der Prüfung einer Kontoumbuchung.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/match/util/amountopen" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "amountOpen": "59.5"}