> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fyvel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Buchungen

> Posten hinter einer Zeile und einer Periode.

```bash cURL theme={null}
curl --request POST \
  --url https://api.fyvel.io/v1/reports/{reportId}/bookings \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "companyIds": ["11111111-1111-4111-8111-111111111111"],
  "periodFrom": "2026-01",
  "periodTo": "2026-06",
  "aggregation": "monthly",
  "layerIds": ["44444444-4444-4444-8444-444444444444"],
  "costCenterCodes": [100],
  "key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "period": "2026-03",
  "page": 1,
  "pageSize": 50
}'
```

```json Body theme={null}
{
  "companyIds": ["11111111-1111-4111-8111-111111111111"],
  "periodFrom": "2026-01",
  "periodTo": "2026-06",
  "aggregation": "monthly",
  "layerIds": ["44444444-4444-4444-8444-444444444444"],
  "costCenterCodes": [100],
  "key": "account:aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
  "period": "2026-03",
  "page": 1,
  "pageSize": 50
}
```

```json 200 theme={null}
{
  "reportId": "66666666-6666-4666-8666-666666666666",
  "snapshot": false,
  "pagination": {
    "page": 1,
    "pageSize": 50,
    "hasNext": false,
    "hasPrevious": false
  },
  "bookings": [
    {
      "bookingId": "bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb",
      "date": "2026-03-18",
      "reportingPeriod": "2026-03-01",
      "documentNumber": "RE-100",
      "text": "Lizenz März",
      "debit": null,
      "credit": 8000,
      "amount": 8000,
      "costCenter": "100",
      "accountNumber": 8400,
      "accountName": "Erlöse",
      "offsetAccountNumber": 1200,
      "offsetAccountName": "Bank",
      "manual": false
    }
  ]
}
```

**Authorization** `string` *required*

`Bearer` und der API-Schlüssel. Siehe [Authentifizierung](https://docs.fyvel.io/api/authentication.md).

## Path parameters

**reportId** `string` *required*

Berichts-ID aus [Berichte](https://docs.fyvel.io/api/reports.md).

## Body

Der [Filter der Werte](https://docs.fyvel.io/api/report-values.md) plus die Felder der Zelle. `costCenterCodes` und `costCenterGroupIds` begrenzen die Posten auf diese Kostenstellen, genau wie bei den Werten. Dieselbe Auswahl, sonst summieren die Posten nicht zur Zahl.

**companyIds** `string[]` *required*

Eine oder mehrere Gesellschafts-IDs.

**periodFrom** `string` *required*

Inklusive, Format `YYYY-MM`.

**periodTo** `string` *required*

Inklusive, Format `YYYY-MM`. Darf nicht vor `periodFrom` liegen.

**aggregation** `string` (default: monthly)

`monthly`, `quarterly` oder `yearly`.

**layerIds** `string[]`

Buchungsebenen.

**layerGroupIds** `string[]`

Ebenengruppen.

**costCenterCodes** `number[]`

Kostenstellen-Codes. Die Posten enthalten nur diese Kostenstellen.

**costCenterGroupIds** `string[]`

Kostenstellengruppen.

**costCenter2Codes** `string[]`

Kostenträger-Codes.

**costCenter2GroupIds** `string[]`

Kostenträgergruppen.

**displayCurrency** `string`

Drei Buchstaben, für ein konsolidiertes Ergebnis.

**key** `string` *required*

`key` aus den [Zeilen](https://docs.fyvel.io/api/report-lines.md), `account:<id>` oder `category:<id>`. `header`, `spacer` und `calculated` haben keine Buchungen.

**period** `string`

Eine Zelle aus der Antwort, also `2026-03`, `2026-Q1` oder `2026`. Sie muss zu `aggregation` passen und im Filter liegen. Fehlt das Feld, gelten `periodFrom` und `periodTo`, also die ganze Zeile.

**page** `number` (default: 1)

Seite, von 1 bis 100. Siehe [Pagination](https://docs.fyvel.io/api/pagination.md). Die Seiten sind nach Datum und Buchungs-ID absteigend sortiert.

**pageSize** `number` (default: 500)

1 bis 1000.

## Response

**reportId** `string` *required*

Berichts-ID aus dem Pfad.

**snapshot** `boolean` *required*

`true`, wenn eine gewählte Ebene ein Snapshot ist. Dann ist `bookings` leer. Das ist keine leere Aktivität.

**pagination** `object` *required*

Siehe [Pagination](https://docs.fyvel.io/api/pagination.md).

**page** `number` *required*

Angefragte Seite.

**pageSize** `number` *required*

Größe dieser Seite.

**hasNext** `boolean` *required*

`true`, wenn eine weitere Seite folgt.

**hasPrevious** `boolean` *required*

`true`, wenn `page` größer als 1 ist.

**bookings** `object[]` *required*

**bookingId** `string` *required*

Buchungs-ID.

**date** `string` *required*

Belegdatum, `YYYY-MM-DD`.

**reportingPeriod** `string` *required*

Berichtsperiode, `YYYY-MM-DD`.

**documentNumber** `string | null` *required*

Belegnummer.

**text** `string | null` *required*

Buchungstext.

**debit** `number | null` *required*

Soll.

**credit** `number | null` *required*

Haben.

**amount** `number` *required*

Betrag.

**costCenter** `string | null` *required*

Kostenstellen-Code.

**accountNumber** `number | null` *required*

Kontonummer.

**accountName** `string | null` *required*

Kontoname.

**offsetAccountNumber** `number | null` *required*

Gegenkontonummer.

**offsetAccountName** `string | null` *required*

Gegenkontoname.

**manual** `boolean` *required*

Manuelle Buchung.

Diese Version erzeugt keine künstlichen Posten für Adjustment-Ebenen. Ein ungültiger `key` oder eine Periode außerhalb des Filters antwortet mit 400 und `INVALID_REQUEST`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.