bimetricsEntwickler
Buchhaltung

Buchungen suchen

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

POST
/api/accounting/booking/filter

Sucht Buchungen der Firma mit einem Filter und liefert eine Seite der Treffer.

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

Authentifizierung

AuthentifizierungBearer <token>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

In: header

Request-Body

application/json

Filter, Sortierung und Seite. Dokumentierte Filterattribute: x-bimetrics-filter.

TypeScript-Typen

Typ request body für TypeScript.

Suche mit Filter, Sortierung und Seiten. Der Filterausdruck steht auf oberster Ebene; {} liefert alle Einträge.

Filterattribute

Dokumentiert sind diese Attribute für attribute; für sort nur die als sortierbar markierten. Aufbau des Filters: Filtern und Paginieren.

AttributTypSortierbarBeschreibung
bookingDatedatejaBuchungsdatum.
accountintegerjaKonto.
accountContraintegerjaGegenkonto.
amountdecimaljaBetrag.
refDocumentIduuidjaID des gebuchten Belegs.
refBankTransactionIduuidjaID des gebuchten Umsatzes.
finalizeddate-timejaZeitpunkt der Festschreibung; `null` bei nicht festgeschriebenen Buchungen.
updatedAtdate-timejaZeitpunkt der letzten Änderung.

Antworten

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://app.bimetrics.de/api/accounting/booking/filter" \  -H "Content-Type: application/json" \  -d '{}'
{  "items": [    {      "account": 0,      "accountContra": 0,      "accountingModel": "string",      "amount": "string",      "bookingDate": {        "day": 0,        "month": 0,        "year": 0      },      "bookingFlags": "string",      "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",      "createdAt": "2019-08-24T14:15:22Z",      "finalized": "2019-08-24T14:15:22Z",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "label": "string",      "performanceFrom": {        "day": 0,        "month": 0,        "year": 0      },      "performanceTo": {        "day": 0,        "month": 0,        "year": 0      },      "refBankTransactionId": "346263b0-7db5-4151-a8e5-d641131746c9",      "refDocumentId": "3d1faf84-ac8e-4e99-a7c1-22b08ddf0438",      "refMatch": "38e85d86-d2e1-4bcd-b48f-bc18237ab5d5",      "revertsAccountBookingId": "ee3e3dd1-4b8c-4397-8f0f-709439f9c5a7",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "limit": 0,  "offset": 0,  "total": 0}