Mahnstufe anzeigen

Gibt die Details einer einzelnen Mahnstufe zurück.

Benötigte Lizenz

Dieser Endpoint erfordert das Add-on Mahnwesen.

Request

GET /api/oauth/v2/resource/invoices/dunnings/types/{uuid}

Header

Header	Wert
Authorization	Bearer {access_token}

URL-Parameter

Parameter	Typ	Pflicht	Beschreibung
uuid	string (UUID)	Ja	Eindeutige ID der Mahnstufe

Erforderlicher Scope: dunnings

Response

Erfolg (200 OK)

{
  "data": {
    "id": "0f6b1c4a-8d21-4b7e-9a33-5c81e2f40a17",
    "name": "1. Mahnung",
    "text": "Sehr geehrte Damen und Herren, wir erlauben uns, Sie an die folgende offene Rechnung zu erinnern.",
    "emailSubject": null,
    "emailBody": null,
    "color": "#f5a623",
    "sort": 1,
    "dunningFee": "5.00",
    "latePaymentInterestRate": "4.00",
    "paymentDeadline": 14,
    "tenancies": ["7c2f5b81-40de-4a19-b6c3-8ea1d0742f95"],
    "deleted": false
  }
}

Hinweis: Eine gelöschte Mahnstufe liefert weiterhin 200 – deleted steht dann auf true.

Response-Felder

Gleiche Feldstruktur wie eine Zeile aus Mahnstufen abrufen, unter data statt data[].

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/invoices/dunnings/types/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
401	invalid_client	Access Token ungültig oder abgelaufen
403	insufficient_scope	Scope dunnings nicht vorhanden
404	not_found	Mahnstufe nicht gefunden
429	rate_limit_exceeded	Zu viele Anfragen – siehe Fehlerbehandlung

Hinweis: Fehlt der Authorization-Header oder ist der Token ungültig, antwortet die API mit 401 und dem JSON-Envelope invalid_client. Das gilt für die OAuth-API allgemein, nicht nur für diesen Endpoint.