Create health notification

Creates a new health notification.

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

Request

POST /api/oauth/v2/resource/health-notifications

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
date	string	No	Date of the health notification (YYYY-MM-DD, default: today)
customStartDate	string	No	Custom start date (YYYY-MM-DD)
customEndDate	string	No	Custom end date (YYYY-MM-DD)
diagnose	string	No	Diagnosis
reason	string	No	Reason
bedrest	boolean	No	Bed rest ordered
curfew1StartTime	string	No	Start of 1st curfew period (HH:MM)
curfew1EndTime	string	No	End of 1st curfew period (HH:MM)
curfew2StartTime	string	No	Start of 2nd curfew period (HH:MM)
curfew2EndTime	string	No	End of 2nd curfew period (HH:MM)
hospitalCareStartTime	string	No	Hospital care start time (HH:MM)
hospitalCareEndTime	string	No	Hospital care end time (HH:MM)
hospitalCareStartDate	string	No	Hospital care start date (YYYY-MM-DD)
hospitalCareEndDate	string	No	Hospital care end date (YYYY-MM-DD)
occupationalDisease	integer	No	Occupational disease (0 = no)
electricalAccident	boolean	No	Electrical accident
reorderDate1	string	No	1st follow-up appointment (YYYY-MM-DD)
reorderDate2	string	No	2nd follow-up appointment (YYYY-MM-DD)
reorderDate3	string	No	3rd follow-up appointment (YYYY-MM-DD)
reasonForBackdating	string	No	Reason for backdating
specialIllnessReason	string	No	Reason for special illness
noticeForInsurance	string	No	Notice for insurance
printed	boolean	No	Already printed

Response

Success (201 Created)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "date": "2026-06-09",
    "customStartDate": "2026-06-09",
    "customEndDate": "2026-06-16",
    "diagnose": "Common cold",
    "reason": null,
    "bedrest": true,
    "curfew1StartTime": "08:00",
    "curfew1EndTime": "12:00",
    "curfew2StartTime": null,
    "curfew2EndTime": null,
    "hospitalCareStartTime": null,
    "hospitalCareEndTime": null,
    "hospitalCareStartDate": null,
    "hospitalCareEndDate": null,
    "occupationalDisease": 0,
    "electricalAccident": false,
    "reorderDate1": "2026-06-12",
    "reorderDate2": null,
    "reorderDate3": null,
    "reasonForBackdating": null,
    "specialIllnessReason": null,
    "noticeForInsurance": null,
    "printed": false,
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    }
  }
}

Response fields

See Get health notification for the full field description.

Beispiele

bash

curl -X POST "https://my.offisy.at/api/oauth/v2/resource/health-notifications" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "customerUuid": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "date": "2026-04-15T10:00:00",
    "customStartDate": "2026-04-15T10:00:00",
    "customEndDate": "2026-04-15T10:00:00",
    "diagnose": "beispiel",
    "reason": "beispiel",
    "bedrest": "beispiel",
    "curfew1StartTime": "beispiel",
    "curfew1EndTime": "beispiel",
    "curfew2StartTime": "beispiel",
    "curfew2EndTime": "beispiel",
    "hospitalCareStartTime": "beispiel",
    "hospitalCareEndTime": "beispiel",
    "hospitalCareStartDate": "2026-04-15T10:00:00",
    "hospitalCareEndDate": "2026-04-15T10:00:00",
    "occupationalDisease": "1",
    "electricalAccident": "b2c3d4e5-f6a7-8901-bcde-f01234567890",
    "reorderDate1": "2026-04-15T10:00:00",
    "reorderDate2": "2026-04-15T10:00:00",
    "reorderDate3": "2026-04-15T10:00:00",
    "reasonForBackdating": "beispiel",
    "specialIllnessReason": "beispiel",
    "noticeForInsurance": "beispiel",
    "printed": "beispiel"
  }'

Server

Client-ID

Client-Secret

Parameter

customerUuid *string

date string

customStartDate string

customEndDate string

diagnose string

reason string

bedrest boolean

curfew1StartTime string

curfew1EndTime string

curfew2StartTime string

curfew2EndTime string

hospitalCareStartTime string

hospitalCareEndTime string

hospitalCareStartDate string

hospitalCareEndDate string

occupationalDisease integer

electricalAccident boolean

reorderDate1 string

reorderDate2 string

reorderDate3 string

reasonForBackdating string

specialIllnessReason string

noticeForInsurance string

printed boolean

Zuerst Token anfordern

Possible errors

Status	Code	Description
400	invalid_request	No user-scoped token provided
400	validation_error	customerUuid missing
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope medicals not present
404	not_found	Customer not found