Create transport certificate

Creates a new transport certificate.

Note: This endpoint requires a user-scoped OAuth token. A pure client_credentials token without user context will be rejected. The treating user is automatically derived from the token and cannot be set manually.

Request

POST /api/oauth/v2/resource/transports

Header

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

Body parameters

Field	Type	Required	Description
customerUuid	string	Yes	UUID of the assigned customer
diagnose	string	No	Diagnosis (ICD code or free text)
publicTransport	boolean	No	Public transport
therapyPlaceWish	boolean	No	Preferred therapy location requested
transportWasRequired	boolean	No	Transport was medically necessary
transportWasRequiredReason	string	No	Reason for necessity
escort	boolean	No	Escort required
escortReason	string	No	Reason for escort
paramedic	boolean	No	Paramedic required
paramedicReason	string	No	Reason for paramedic
printed	boolean	No	Transport certificate has been printed
date	string	No	Date of the transport certificate (YYYY-MM-DD, default: today)

Response

Success (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "diagnose": "M54.5",
    "publicTransport": false,
    "therapyPlaceWish": true,
    "transportWasRequired": true,
    "transportWasRequiredReason": "Patient unable to walk",
    "escort": true,
    "escortReason": "Escort medically required",
    "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 fields

See Get transport certificate for the full field description.

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

Possible errors

Status	Code	Description
400	validation_error	Invalid request data (e.g. customerUuid missing)
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope medicals not present
404	not_found	Customer not found