Verordnung erstellen

Erstellt eine neue Verordnung.

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/regulations

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 Unternehmen des Tokens gehören)
services	string	Nein	Verordnete Leistungen
diagnose	string	Nein	Diagnose (ICD-Code oder Freitext)
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	Ausstellungsdatum (YYYY-MM-DD, Standard: heute)
printed	boolean	Nein	Ob die Verordnung gedruckt wurde

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "services": "Physiotherapie, Ergotherapie",
    "diagnose": "M54.5",
    "receiverName": "Dr. Klaus Berger",
    "receiverStreet": "Landstraß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 Verordnung anzeigen für die vollständige Feldbeschreibung.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/regulations" \
  -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