Dauermedikation erstellen

Erstellt eine neue Dauermedikation.

Hinweis: Dieser Endpoint erfordert einen benutzerbezogenen OAuth-Token. Ein reiner client_credentials-Token ohne Benutzerkontext wird abgelehnt. Der Kunde muss dem Unternehmen des authentifizierten Benutzers zugeordnet sein.

Request

POST /api/oauth/v2/resource/long-term-medications

Header

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

Body-Parameter

Feld	Typ	Pflicht	Beschreibung
customerUuid	string	Ja	UUID des zugeordneten Kunden
medicamentName	string	Ja	Name des Medikaments
medicament	string	Nein	Handelsname / genaue Bezeichnung
medicamentAmount	string	Nein	Menge (z.B. "1", "500")
medicamentUnit	string	Nein	Einheit (z.B. "Tablette", "mg")
op	integer	Nein	Originalpackungsanzahl
dosage1	string	Nein	Dosierung morgens
dosage2	string	Nein	Dosierung mittags
dosage3	string	Nein	Dosierung abends
dosage4	string	Nein	Dosierung nachts
dosage5	string	Nein	Weitere Dosierungsangabe
dosageText	string	Nein	Freitext zur Dosierung

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "medicamentName": "Ramipril",
    "medicament": "Ramipril-ratiopharm 5 mg",
    "medicamentAmount": "1",
    "medicamentUnit": "Tablette",
    "op": 30,
    "dosage1": "1",
    "dosage2": "0",
    "dosage3": "0",
    "dosage4": "1",
    "dosage5": null,
    "dosageText": "Morgens und abends je 1 Tablette",
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    }
  }
}

Response-Felder

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

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/long-term-medications" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "medicamentName": "Muster GmbH",
    "medicament": "beispiel",
    "medicamentAmount": "beispiel",
    "medicamentUnit": "beispiel",
    "op": "1",
    "dosage1": "beispiel",
    "dosage2": "beispiel",
    "dosage3": "beispiel",
    "dosage4": "beispiel",
    "dosage5": "beispiel",
    "dosageText": "beispiel"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

medicamentName *string

medicament string

medicamentAmount string

medicamentUnit string

op integer

dosage1 string

dosage2 string

dosage3 string

dosage4 string

dosage5 string

dosageText string

Zuerst Token anfordern

Mögliche Fehler

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