Reservation download process to keep in sync with WebHotelier bookings.

This section describes the standard procedure a 3rd party system has to follow in order to download and keep in sync with WebHotelier bookings.

When reservation sync is enabled for an API account, every new, modified or cancelled reservation is added to a special sync-queue. This queue can be queried to provide the pending-for-sync list of reservation ids. The API user is responsible to remove from the queue any reservation that has successfully downloaded and stored.


PULL mode Request flow

Either trigger the below process on-demand or repeat every x minutes (5' recommended for high traffic properties, 15' for normal).

  1. Call List Pending Reservations. The response will provide a list of reservation ids that have been added, modified or cancelled since the last call of this API method, or previous ones that have not been marked as synced.
  2. Loop over the above list of fetched reservation ids and download full info for each one with Reservation Retrieval
  3. For each reservation you have successfully processed and stored to your system, call Mark as Synced, in order for this reservation to be cleared out of the sync-queue.

Notice

The functionality described in this document requires a Hotelier API account (one account per property).