Transportschein erstellen

Erstellt einen neuen Transportschein.

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

Header

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

Body-Parameter

Feld	Typ	Pflicht	Beschreibung
customerUuid	string	Ja	UUID des zugeordneten Kunden
diagnose	string	Nein	Diagnose (ICD-Code oder Freitext)
publicTransport	boolean	Nein	Öffentliches Verkehrsmittel
therapyPlaceWish	boolean	Nein	Wunsch nach Therapieort
transportWasRequired	boolean	Nein	Transport war medizinisch notwendig
transportWasRequiredReason	string	Nein	Begründung der Notwendigkeit
escort	boolean	Nein	Begleitperson erforderlich
escortReason	string	Nein	Begründung für Begleitperson
paramedic	boolean	Nein	Sanitäter:in erforderlich
paramedicReason	string	Nein	Begründung für Sanitäter:in
printed	boolean	Nein	Transportschein wurde ausgedruckt
date	string	Nein	Datum des Transportscheins (YYYY-MM-DD, Standard: heute)

Response

Erfolg (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "diagnose": "M54.5",
    "publicTransport": false,
    "therapyPlaceWish": true,
    "transportWasRequired": true,
    "transportWasRequiredReason": "Patient:in nicht gehfähig",
    "escort": true,
    "escortReason": "Begleitperson medizinisch notwendig",
    "paramedic": false,
    "paramedicReason": null,
    "printed": false,
    "date": "2026-06-09",
    "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 Transportschein anzeigen für die vollständige Feldbeschreibung.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/transports" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "diagnose": "beispiel",
    "publicTransport": "beispiel",
    "therapyPlaceWish": "beispiel",
    "transportWasRequired": "beispiel",
    "transportWasRequiredReason": "beispiel",
    "escort": "beispiel",
    "escortReason": "beispiel",
    "paramedic": "beispiel",
    "paramedicReason": "beispiel",
    "printed": "beispiel",
    "date": "2026-04-15T10:00:00"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

diagnose string

publicTransport boolean

therapyPlaceWish boolean

transportWasRequired boolean

transportWasRequiredReason string

escort boolean

escortReason string

paramedic boolean

paramedicReason string

printed boolean

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