bimetricsEntwickler
Buchhaltung

Kategorien auflisten

Als Markdown ansehen

Benötigte Berechtigung:read(Daten lesen)

GET
/api/category/

Liefert die Kategorien, die die App der Firma zur Auswahl anbietet. Der Schlüssel (key) ist der Wert von category in Belegpositionen, Buchungsvorlagen und Zuordnungen; die Kategorie einer Position bestimmt das Konto ihrer Buchung. attributes sagt, wofür eine Kategorie taugt.

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.

Antworten

Erfolg.

application/json
  1. response
[index: integer]?

Eine Kategorie für Positionen, Buchungsvorlagen oder Zuordnungen.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/category/" \  -H "Authorization: Bearer $BIMETRICS_API_KEY"
Beispielantwort
[  {    "attributes": {      "receipt": true    },    "description": "Ausgaben für Büromaterialien wie Papier, Stifte und Notizblöcke.",    "key": "office_supplies",    "keywords": "Bürobedarf, Papier, Stift, Notizblock, Druckerpapier, Schreibwaren, Ordner",    "title": "Bürobedarf"  },  {    "attributes": {      "match": {        "document": "one_to_many",        "minimum": 2,        "transaction": "many"      }    },    "description": "Zuordnung von Zahlungen zu einer oder mehreren Rechnungen bzw. Belegen.",    "key": "payment",    "keywords": "",    "title": "Zahlung"  }]