Arztbrief erstellen

Erstellt einen neuen Arztbrief.

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/doctor-letters

Header

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

Body-Parameter

Feld	Typ	Pflicht	Beschreibung
customerUuid	string	Ja	UUID des zugeordneten Kunden
name	string	Nein	Bezeichnung des Arztbriefs
text	string	Nein	Inhalt des Arztbriefs
printed	boolean	Nein	Ob der Brief gedruckt wurde
date	string	Nein	Datum des Arztbriefs (YYYY-MM-DD, Standard: heute)
receiver	object	Nein	Empfänger:in des Arztbriefs
receiver.title	string	Nein	Titel
receiver.firstName	string	Nein	Vorname
receiver.lastName	string	Nein	Nachname
receiver.institute	string	Nein	Institut oder Einrichtung
receiver.street	string	Nein	Straße
receiver.zip	string	Nein	Postleitzahl
receiver.city	string	Nein	Ort
receiver.country	string	Nein	Land (ISO 3166-1 alpha-2)
receiver.tel	string	Nein	Telefonnummer
receiver.telCode	string	Nein	Telefonvorwahl
receiver.fax	string	Nein	Faxnummer
receiver.email	string	Nein	E-Mail-Adresse

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "Arztbrief zur Überweisung",
    "text": "Sehr geehrte Kollegin, sehr geehrter Kollege, ich berichte über die Patientin Anna Muster...",
    "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"
    },
    "receiver": {
      "title": "Dr.",
      "firstName": "Klaus",
      "lastName": "Berger",
      "institute": "Facharztpraxis Innere Medizin",
      "street": "Hauptstraße 12",
      "zip": "4020",
      "city": "Linz",
      "country": "AT",
      "tel": "0732123456",
      "telCode": "+43",
      "fax": null,
      "email": "k.berger@beispiel.at"
    }
  }
}

Response-Felder

Siehe Arztbrief anzeigen für die vollständige Feldbeschreibung.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/doctor-letters" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "name": "Muster GmbH",
    "text": "beispiel",
    "printed": "beispiel",
    "date": "2026-04-15T10:00:00",
    "receiver.title": "beispiel",
    "receiver.firstName": "Muster GmbH",
    "receiver.lastName": "Muster GmbH",
    "receiver.institute": "beispiel",
    "receiver.street": "Musterstraße 1",
    "receiver.zip": "4020",
    "receiver.city": "Linz",
    "receiver.country": "AT",
    "receiver.tel": "+43 664 1234567",
    "receiver.telCode": "+43 664 1234567",
    "receiver.fax": "beispiel",
    "receiver.email": "anna.muster@example.com"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

name string

text string

printed boolean

date string

receiver.title string

receiver.firstName string

receiver.lastName string

receiver.institute string

receiver.street string

receiver.zip string

receiver.city string

receiver.country string

receiver.tel string

receiver.telCode string

receiver.fax string

receiver.email 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