Skip to main content
GET
/
v2
/
datev-rewe-read
/
permissions
RVO-Rechte-Probe
curl --request GET \
  --url https://api.business-os.de/v2/datev-rewe-read/permissions \
  --header 'x-api-key: <api-key>'
{ "subscription": "ok", "fiscalYearStartDate": "2026-01-01", "yearsCount": 2, "checks": { "stammdaten": { "status": "ok", "httpStatus": 200 }, "auswertungen": { "status": "ok", "httpStatus": 200 }, "kontobuchungen": { "status": "permission", "httpStatus": 403, "message": "Access to the requested resource is forbidden." }, "opos": { "status": "ok", "httpStatus": 200 } }, "tool": "DATEV Rechnungswesen - Read", "probedAt": "2026-05-30T09:24:46.125Z" }

Authorizations

​
x-api-key
string
header
required

Dein Business OS API Key. Erstelle einen unter app.business-os.de → API Keys.

Query Parameters

​
connectionId
string<uuid>
required

UUID der DATEV-Verbindung. Abrufbar über den /connections-Endpunkt des jeweiligen Moduls (z. B. GET /v2/datev-duo/connections).

Example:

"abbc18fd-ba5e-4dfd-afc4-9dec0c0ad145"

Response

Probe-Ergebnis pro RVO-Teilrecht

​
subscription
enum<string>
required

Aggregierter Status über alle 4 Teilrechte hinweg. ok wenn mindestens eines ok ist; missing wenn alle 4 mit 403 antworten (Service-/RVO-Recht fehlt komplett); expired wenn mindestens eines mit 401 antwortet (Token abgelaufen); sonst unknown.

Available options:
ok,
missing,
expired,
unknown
​
checks
object
required

Pro RVO-Teilrecht ein Check-Eintrag.

​
tool
string
required
Example:

"DATEV Rechnungswesen - Read"

​
probedAt
string<date-time>
required

Zeitstempel der Probe (ISO 8601).

​
fiscalYearStartDate
string<date> | null

Aus der Stammdaten-Probe (/accounting/fiscalYears) abgeleitetes Start-Datum des jüngsten Geschäftsjahres — wird intern für die anderen 3 Probes als Query-Parameter benötigt. null wenn Stammdaten-Probe nicht 200 zurückgegeben hat.

Example:

"2026-01-01"

​
yearsCount
integer | null

Anzahl Geschäftsjahre, die der Mandant in DATEV hat. null wenn Stammdaten-Probe nicht 200 zurückgegeben hat.

Example:

2