Bonomi Event API
HomeInboxFree Trial

Reservation

webhook endpoint for sending reservation events to Bonomi

Event: Reservation Started

If you want to send a checked-in reservation to Bonomi, just set up a simple HTTPS POST request to our Reservation endpoint with the following settings:

POST https://bonomisite.bubbleapps.io/api/1.1/wf/reservation
Authentication: Bearer "API-TOKEN"
Content-Type: application/json 
{
     "IntegrationId": "1234-abcd",
     "PropertyId": "432686",
     "EventType": "ReservationStarted",
     
     "ReservationId": "bfee2c44-1f84-4326-a862-5289598f6e2d",
     "ReservationOrigin": "ChannelManager",
     "CreatedUtc": "2022-04-12T14:58:02Z",
     "StartUtc": "2022-05-20T13:00:00Z",
     "EndUtc": "2022-05-28T11:00:00Z",
     "ReservationState": "Started",
     "ReservationPurpose": "Leisure",
     "RoomTypeId: "abcad",
     "AssignedResourceNumber": "303",
     "AdultCounts": 2,
     "ChildCounts": 2,
     "RateId": "string",
     "MealPlan": "string",
     
     "CustomerId": "35d4b117-4e60-44a3-9580-c582117eff98",
     "BirthDate": "2016-02-22T11:00:00Z",
     "FirstName": "John",
     "LastName": "Doe",
     "Email": "john@doe.com",
     "Phone": "0036205149715",
     "NationalityCode": "US",
     "LoyaltyCode": "12ab",
     "PreferredLanguage": "hu-hu",
     "StaffComment": "loves fresh flowers"   
}
PropertyTypeContractDescription

IntegrationId

String

Required

Unique identifier of the PMS integration

PropertyId

String

Required

Unique identifier of the Property in PMS

EventType

String

Required

Determines type of event

ReservationId

String

Optional

Unique indentifier of the reservation in PMS

ReservationOrigin

String

Optional

Origin of the reservation

CreatedUtc

String

Optional

Creation date and time of reservation in UTC timezone

StartUtc

String

Required

Start of the reservation (arrival) in UTC timezone

EndUtc

String

Required

End of the reservation (departure) in UTC timezone

ReservationState

String

Required

State of the reservation.

ReservationPurpose

String

Optional

Purpose of the reservation

AsssignedResourceNumber

String

Required

Unique Identifier of the assigned resource (room)

AdultCounts

Number

Optional

Number of Adults the reservation was booked for

ChildCounts

Number

Optional

Number of Children the reservation was booked for

RateId

String

Optional

Identifier of the PMS reservation rate

MealPlan

String

Optional

Identifier of the PMS meal plan

CustomerId

String

Optional

Unique identifier of the Customer who owns the reservation (PMS)

BirthDate

String

Optional

Birth date of Customer (in ISO 8601 format)

Email

String

Optional

Email address of Customer

Phone

String

Optional

Phone number of Customer

NationalityCode

String

Optional

Customer's Country (ISO 3166-1 standard country code)

LoyaltyCode

String

Optional

Customer's Loyalty level or iD

PreferredLanguage

String

Optional

Customer's preferred language (ISO 639-1 standard language code)

StaffComment

String

Optional

Comment on Customer (in PMS)

Event Types

  • ReservationEnquired - Confirmed neither by the customer nor enterprise

  • ReservationRequested - Confirmed by the customer but not by the enterprise (waitlist)

  • ReservationConfirmed - Confirmed by both parties, before check-in.

  • ReservationStarted - Checked in

  • ReservationProcessed - Checked out

  • ReservationCanceled - Canceled

Reservation state

  • Enquired - Confirmed neither by the customer nor enterprise.

  • Requested - Confirmed by the customer but not by the enterprise (waitlist).

  • Optional - Confirmed by enterprise but not by the guest (the enterprise is holding resource for the guest).

  • Confirmed - Confirmed by both parties, before check-in.

  • Started - Checked in.

  • Processed - Checked out.

  • Canceled - Canceled.

Reservation origin

  • GDS

  • ChannelManager

  • BookingEngine

  • Other

Reservation purpose

  • Leisure

  • Business

  • Student

PreviousReceive Custom Events from Bonomi (soon :)

Last updated