Aperçu

Demandes de rendez-vous

Les systèmes externes peuvent transmettre des demandes de rendez-vous ou de service à Ordinavo et suivre leur statut.

Endpoints

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

Modèle de données : AppointmentRequest

Champ	Description
`externalReference`	Référence externe du système source.
`serviceType`	Type de demande, par exemple maintenance, visite, enlèvement ou contrôle.
`priority`	Priorité de la demande.
`customer`	Client, organisation ou site demandeur.
`contact`	Contact pour questions ou coordination du rendez-vous.
`location`	Lieu d’intervention.
`preferredTimeWindows`	Créneaux souhaités.
`description`	Description de la demande.
`metadata`	Informations techniques ou métier supplémentaires du système source.

Modèle de statut

Submitted Validated PendingReview Accepted Rejected Scheduled Assigned InProgress Completed Cancelled Failed

Annulation

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"
}