Überweisung erstellen

Erstellt eine neue Ü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/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
services	string	Nein	Angeforderte Leistungen
diagnose	string	Nein	Diagnose auf der Überweisung
receiverName	string	Nein	Name der empfangenden Stelle
receiverStreet	string	Nein	Straße der empfangenden Stelle
receiverZip	string	Nein	PLZ der empfangenden Stelle
receiverCity	string	Nein	Ort der empfangenden Stelle
date	string	Nein	Datum der Überweisung (YYYY-MM-DD, Standard: heute)
printed	boolean	Nein	Ob die Überweisung gedruckt wurde

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "services": "Blutbild, EKG",
    "diagnose": "Hypertonie (I10)",
    "receiverName": "Dr. Thomas Berger",
    "receiverStreet": "Hauptstraße 12",
    "receiverZip": "4020",
    "receiverCity": "Linz",
    "date": "2026-06-09",
    "printed": false,
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    },
    "treatingUser": {
      "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "firstName": "Dr. Maria",
      "lastName": "Huber"
    }
  }
}

Response-Felder

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

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/referrals" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "services": "beispiel",
    "diagnose": "beispiel",
    "receiverName": "Muster GmbH",
    "receiverStreet": "Musterstraße 1",
    "receiverZip": "4020",
    "receiverCity": "Linz",
    "date": "2026-04-15T10:00:00",
    "printed": "beispiel"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

services string

diagnose string

receiverName string

receiverStreet string

receiverZip string

receiverCity string

date string

printed boolean

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