Requirements

Security

All connections to and from the Levart API will be HTTPS using TLS1.2

Updates

Full Update

The PMS must send a full update (365 days+ of all inventory/rates) once per day, preferable in the early morning AWST. This requirement is a safety backup for the delta updates if any are not received or processed for any reason.

Delta Updates

At all times apart from the full update on delta changes should be send for inventory/rates. The Set Inventory and Set Rates messages support multiple ranges and multiple room types. Updates should be constructed in such a way as the number of single messages are kept to a minimum.

Example:

The following JSON shows a single Set Inventory messages where multiple periods with the same inventory are shown, together with multiple room types:

 
{
  "Authentication" : {
    "Username": "abc",
    "Password": "456"
  },
  "MessageID": "717b3bec-5321-4bad-84c1-075bff67f92c",
  "TimeStamp": "2016-09-28T15:15:00+08:00",
  "MessageType": "SetInventory",
  "InventoryData": [
    {
      "RoomTypeCode": "2BED",
      "StartDate": "2018-01-01",
      "EndDate": "2018-01-01",
      "Availability": 2
    },
    {
      "RoomTypeCode": "2BED",
      "StartDate": "2018-01-02",
      "EndDate": "2018-01-10",
      "Availability": 3
    },
    {
      "RoomTypeCode": "2BED",
      "StartDate": "2018-01-11",
      "EndDate": "2018-01-15",
      "Availability": 4
    },
    
      "RoomTypeCode": "STUD",
      "StartDate": "2018-01-01",
      "EndDate": "2018-01-15",
      "Availability": 4
    },
    
      "RoomTypeCode": "STUD",
      "StartDate": "2018-01-16",
      "EndDate": "2018-01-22",
      "Availability": 7
    }
  ]
}

Booking Updates

Before sending a booking to a PMS, Levart reduces the inventory on that room type in the Levart system. The PMS must still send a Set Inventory after receiving a booking, reducing the inventory on the rooms accordingly. As this will generally match the inventory in Levart there will be no change. If the inventory does not match then an update will be made in the Levart system for the appropriate room.