Eingehende Überweisung erstellen

Erstellt eine neue eingehende Überweisung.

Hinweis: Dieser Endpoint erfordert einen benutzerbezogenen OAuth-Token. Ein reiner client_credentials-Token ohne Benutzerkontext wird abgelehnt. Die behandelnde Person wird automatisch aus dem Token ermittelt und kann nicht manuell gesetzt werden.

Request

POST /api/oauth/v2/resource/incoming-referrals

Header

Header	Wert
Authorization	Bearer {access_token}
Content-Type	application/json

Body-Parameter

Feld	Typ	Pflicht	Beschreibung
customerUuid	string	Ja	UUID des zugeordneten Kunden (muss zum selben Unternehmen gehören)
services	array	Nein	Liste der überwiesenen Leistungen
diagnose	string	Nein	Diagnose zur Überweisung
date	string	Nein	Überweisungsdatum (YYYY-MM-DD, Standard: heute)

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "services": ["Physiotherapie", "Ultraschall"],
    "diagnose": "M54.5",
    "date": "2026-06-09",
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    },
    "practitioner": {
      "name": "Dr. Thomas Berger"
    }
  }
}

Response-Felder

Siehe Eingehende Überweisung anzeigen für die vollständige Feldbeschreibung.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/incoming-referrals" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "services": "beispiel",
    "diagnose": "beispiel",
    "date": "2026-04-15T10:00:00"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

services array

diagnose string

date string

Zuerst Token anfordern

Mögliche Fehler

Status	Code	Beschreibung
400	validation_error	Ungültige Request-Daten (z.B. customerUuid fehlt)
401	invalid_client	Ungültiger oder fehlender Access Token
403	insufficient_scope	Scope medicals nicht vorhanden
404	not_found	Kunde nicht gefunden