Last updated 3 months ago
Enquiry to Booking Journey The following diagram illustrates the complete booking journey from enquiry creation through to confirmation, showing the interaction between all key parties in the Xenia Connect ecosystem.
The diagram includes the flows for webhook notifications to your system. If you do not plan on subscribing to webhooks, you can safely ignore any steps associated with the "Your Webhook Endpoints" participant.
Visual Guide:
🔵 Blue highlighted sections : API calls made by the Third Party to Xenia Connect Regular arrows: Internal Xenia operations and webhook notifications Third Party (You) Xenia Connect Your Webhook Endpoints (if subscribed) Accommodation Specialist ENQUIRY CREATION PHASE SPECIALIST ASSIGNMENT SHORTLISTING PHASE QUOTING PHASE par [Simultaneous webhook triggers] CLIENT REVIEWS QUOTE BOOKING CONFIRMATION PHASE PARTNER CONFIRMATION CLIENT CONFIRMATION CHECK-IN DETAILS Alternative Flow - CANCELLATION alt [Booking Cancelled] Alternative Flow - ENQUIRY CLOSED alt [Enquiry Closed Without Booking] POST /enquiries (Create new enquiry) Validate & Store enquiry 201 Created (xeniaReference, externalId) Trigger ENQUIRY.CREATED Webhook notification 204 No Content Assign specialist to enquiry Trigger ENQUIRY.SPECIALIST_ASSIGNED Webhook notification 204 No Content Begin property shortlisting Update enquiry state Trigger ENQUIRY.SHORTLISTING Webhook notification 204 No Content Research & select suitable properties Add shortlisted properties Create quote with selected properties Generate quote Send quote to client Update enquiry state to QUOTED Trigger QUOTE.CREATED Webhook notification 204 No Content Trigger ENQUIRY.QUOTED Webhook notification 204 No Content GET /quotes (Retrieve quote details) Quote with properties & pricing Client accepts quote (External process) Create booking from quote Generate booking Trigger BOOKING.PENDING Webhook notification 204 No Content Confirm with accommodation partner Send partner confirmation Email confirmation to partner Trigger BOOKING.PARTNER_CONFIRMATION_DETAILS_SENT Webhook notification 204 No Content Confirm with accommodation Client Send client confirmation Email confirmation to client Trigger BOOKING.CLIENT_CONFIRMATION_DETAILS_SENT Webhook notification 204 No Content Send check-in details Email check-in info Trigger BOOKING.CHECK_IN_DETAILS_SENT Webhook notification 204 No Content Cancel booking Trigger BOOKING.CANCELLED Webhook notification 204 No Content Close enquiry (with closure reason) Trigger ENQUIRY.CLOSED Webhook notification 204 No Content Third Party (You) Xenia Connect Your Webhook Endpoints (if subscribed) Accommodation Specialist