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
}'
{
"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
}
{
"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
}
]
}
Berichte
Buchungen
Posten hinter einer Zeile und einer Periode.
POST
/
v1
/
reports
/
{reportId}
/
bookings
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
}'
{
"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
}
{
"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
}
]
}
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
}'
{
"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
}
{
"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
}
]
}
Bearer und der API-Schlüssel. Siehe Authentifizierung.Path parameters
Berichts-ID aus Berichte.
Body
Der Filter der Werte 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.
key aus den Zeilen, account:<id> oder category:<id>. header, spacer und calculated haben keine Buchungen.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.Seite, von 1 bis 100. Siehe Pagination. Die Seiten sind nach Datum und Buchungs-ID absteigend sortiert.
Response
true, wenn eine gewählte Ebene ein Snapshot ist. Dann ist bookings leer. Das ist keine leere Aktivität.Siehe Pagination.
key oder eine Periode außerhalb des Filters antwortet mit 400 und INVALID_REQUEST.