Preview

Terminanfragen

Externe Systeme können Terminanfragen oder Serviceanfragen strukturiert an Ordinavo übergeben und den Status nachvollziehen.

Endpunkte

POST/connect/v1/appointment-requests

GET/connect/v1/appointment-requests/{id}

GET/connect/v1/appointment-requests/{id}/status

POST/connect/v1/appointment-requests/{id}/cancel

Datenmodell: AppointmentRequest

Feld	Beschreibung
`externalReference`	Externe Referenznummer aus dem Quellsystem.
`serviceType`	Art der Anfrage, zum Beispiel Wartung, Besuch, Abholung oder Prüfung.
`priority`	Priorität der Anfrage.
`customer`	Kunde, Organisation oder anfragende Stelle.
`contact`	Ansprechpartner für Rückfragen oder Terminabstimmung.
`location`	Einsatzort.
`preferredTimeWindows`	Gewünschte Zeitfenster.
`description`	Beschreibung des Anliegens.
`metadata`	Zusätzliche technische oder fachliche Informationen des Quellsystems.

Statusmodell

Submitted Validated PendingReview Accepted Rejected Scheduled Assigned InProgress Completed Cancelled Failed

Stornierung

POST /connect/v1/appointment-requests/{id}/cancel
Authorization: Bearer {access_token}
Content-Type: application/json
Idempotency-Key: 85f1ac0e-d641-47f4-99c2-0e04af2a1c19

{
  "reason": "Customer requested cancellation",
  "cancelledBy": "external_system"
}

{
  "id": "apr_01JZ7YQ1H7MP6Q5V8N9D4G3A2B",
  "status": "Cancelled",
  "cancelledAt": "2026-06-15T15:12:00Z"
}