Abrechnungsleistungen abrufen

Gibt eine paginierte Liste aller Abrechnungsleistungen des Unternehmens zurück.

Request

GET /api/oauth/v2/resource/fee-note-services

Header

Header	Wert
Authorization	Bearer {access_token}

Query-Parameter

Parameter	Typ	Pflicht	Beschreibung
from	string	Nein	Beginn des Zeitraums, ISO-Datum oder Zeitstempel. Gefiltert wird nach date, bei Zeilen ohne date nach createdAt
until	string	Nein	Ende des Zeitraums, ISO-Datum oder Zeitstempel. Bei reinem Datum gilt der Tag bis 23:59:59
billStatus	string	Nein	Kommaliste aus open, invoiced, ignore, unknown
treatingUserId	string (UUID)	Nein	Filtert nach Behandler
customerId	string (UUID)	Nein	Filtert nach Kunde. Erfordert zusätzlich den Scope customers
offset	integer	Nein	Startposition (Standard: 0)
limit	integer	Nein	Anzahl Ergebnisse (Standard: 50, Max: 200)

Die Standard-Sortierung ist date absteigend, bei gleichem Datum id absteigend. meta.total zählt nur Zeilen, die du sehen darfst.

Response

Erfolg (200 OK)

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Erstkonsultation",
      "internalNumber": "01",
      "description": "Erste ärztliche Untersuchung inkl. Anamnese",
      "diagnose": "Z00.0",
      "date": "2026-06-08",
      "quantity": 1.0,
      "gross": 120.00,
      "net": 100.00,
      "netPerUnit": 100.00,
      "unit": "Einheit",
      "billStatus": "open",
      "customer": {
        "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
        "firstName": "Anna",
        "lastName": "Muster"
      },
      "treatingUser": "6f1c1a2b-3c4d-5e6f-7890-abcdef123456",
      "insuranceService": "3a8b1c2d-3e4f-5061-7283-94a5b6c7d8e9",
      "appointment": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
      "resource": "7c2f5b81-40de-4a19-b6c3-8ea1d0742f95"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Blutabnahme",
      "internalNumber": "02",
      "description": null,
      "diagnose": null,
      "date": "2026-06-08",
      "quantity": 1.0,
      "gross": 25.00,
      "net": 20.83,
      "netPerUnit": 20.83,
      "unit": null,
      "billStatus": "invoiced",
      "customer": {
        "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
        "firstName": "Anna",
        "lastName": "Muster"
      },
      "treatingUser": "6f1c1a2b-3c4d-5e6f-7890-abcdef123456",
      "insuranceService": "3a8b1c2d-3e4f-5061-7283-94a5b6c7d8e9",
      "appointment": "c4d5e6f7-a8b9-4c0d-8e1f-2a3b4c5d6e7f",
      "resource": "7c2f5b81-40de-4a19-b6c3-8ea1d0742f95"
    }
  ],
  "meta": {
    "total": 84,
    "offset": 0,
    "limit": 50
  }
}

Response-Felder

Feld	Typ	Beschreibung
data	Array	Liste der Abrechnungsleistungen
data[].id	string (UUID)	Eindeutige ID der Abrechnungsleistung
data[].name	string	Bezeichnung der Leistung
data[].internalNumber	string | null	Interne Leistungsnummer
data[].description	string | null	Beschreibung der Leistung
data[].diagnose	string | null	Diagnose (z.B. ICD-Code)
data[].date	string | null	Leistungsdatum (YYYY-MM-DD)
data[].quantity	float	Anzahl der Einheiten
data[].gross	float	Bruttobetrag
data[].net	float	Nettobetrag gesamt
data[].netPerUnit	float	Nettobetrag pro Einheit
data[].unit	string | null	Einheit (z.B. "Einheit", "Stunde")
data[].billStatus	string	Verrechnungsstatus: open, invoiced, ignore, unknown
data[].customer	object | null	Zugeordneter Kunde
data[].customer.id	string (UUID)	Kunden-ID
data[].customer.firstName	string	Vorname des Kunden
data[].customer.lastName	string	Nachname des Kunden
data[].treatingUser	string (UUID) | null	Behandler. Nachladbar über Benutzer anzeigen. null, wenn nicht vorhanden
data[].insuranceService	string (UUID) | null	ID der Leistung. Kein eigener OAuth-Endpoint zum Nachladen, siehe Konventionen. null, wenn nicht vorhanden
data[].appointment	string (UUID) | null	Zugehöriger Termin. Von/Bis-Zeiten und Kurs über Termin anzeigen. null, wenn nicht vorhanden
data[].resource	string (UUID) | null	Ressource des Termins. Kein eigener OAuth-Endpoint zum Nachladen. null, wenn nicht vorhanden
meta.total	integer	Gesamtanzahl der Abrechnungsleistungen
meta.offset	integer	Aktuelle Startposition
meta.limit	integer	Anzahl der zurückgegebenen Einträge

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/fee-note-services?from=beispiel&until=beispiel&billStatus=beispiel&treatingUserId=b2c3d4e5-f6a7-8901-bcde-f01234567890&customerId=b2c3d4e5-f6a7-8901-bcde-f01234567890&offset=0&limit=50" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

from string

until string

billStatus string

treatingUserId string

customerId string

offset integer

limit integer

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	from oder until ist kein gültiges ISO-Datum bzw. kein gültiger Zeitstempel
400	validation_error	Ungültiger billStatus. Erlaubt sind open, invoiced, ignore, unknown
400	validation_error	treatingUserId oder customerId ist kein gültiges UUID-Format
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope medicals nicht vorhanden
403	insufficient_scope	customerId gesetzt, aber Scope customers nicht vorhanden (error_description: Filtering by customerId requires the "customers" scope.)
404	not_found	treatingUserId (User not found) oder customerId (Customer not found) verweist auf keinen existierenden Datensatz