PMS Connectivity
Bookings
Retrieve Transaction Details
This API helps you to fetch booking details for specific transaction unique ID based on Room No, Guest, Identity No, Guest Email, Guest Mobile No, Guest Registration No. The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type* | VARCHAR(100) | Request Type | GetTransactionDetails |
| TranunkId* | VARCHAR(100) | Transaction Id single/multiple (comma separated) | xxxxx0000000000400 |
| RoomNo | VARCHAR(500) | Room No (It is Optional) | 101 |
| Guest | VARCHAR(100) | Guest Name (It is Optional) | test |
| IdentityNo | VARCHAR(255) | Identity No (It is Optional) | ASD43543 |
| GuestEmail | VARCHAR(255) | Guest Email (It is Optional) | abc@gmail.com |
| GuestMobileNo | VARCHAR(255) | Guest Mobile No (It is Optional) | XXXXXXXXXX |
| GuestRegistrationNo | VARCHAR(255) | Guest Registration No (It is Optional) | XXXXXX |
| HotelCode* | INT(11) | Unique Hotel code | xxxx |
| AuthCode* | VARCHAR(300) | Unique Authentication code | xxxxxxxxxx |
Request
{
"RES_Request": {
"Request_Type": "GetTransactionDetails,"
. "TranunkId": "xxxxx0000000000400",
"RoomNo": "101",
"Guest": "Joy T. Mnewy",
"IdentityNo": "ASD43543",
"GuestEmail": "XXXXXX@gmail.com",
"GuestMobileNo": "XXXXXXXXXX",
"GuestRegistrationNo": "XXXXXX",
"Authentication": {
"HotelCode": "XXXX",
"AuthCode": "XXXXXXXXXXXXXXXXXXX"
}
}
}
Response
| Name | Data Type | Description | Example |
| LocationId | INT(11) | Hotel code | xxxx |
| UniqueID | VARCHAR(255) | Unique Booking id/ Reservation No | 10125, 86436, B4525 etc |
| BookedBy | VARCHAR(255) | Information regarding Booked by | Booking.com etc |
| Salutation, FirstName, LastName, Gender, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email,RegistrationNo. | VARCHAR(255) | Here * denotes guest information like Salutation, FirstName, LastName, Gender, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email,RegistrationNo. | shown in JSON response below. |
| Source | VARCHAR(1000) | Booking generated source | Booking.com etc |
| PaymentMethod | VARCHAR(255) | Payment Mode selected by guest | Cash, Credit, CityLedger etc |
| IsChannelBooking | INT(1) | Is booking comes from channel [0 or 1]1 : Booking from the channel.0: Booking not from the channel. | 0 or 1 |
| BookingTran. SubBookingId | VARCHAR(255) | Sub booking Id | 138 |
| BookingTran. TransactionId | INT(20) | Booking Transaction ID | 112500000000000163 |
| BookingTran. Status | VARCHAR(100) | Booking Status | New or Modify or Cancel. |
| BookingTran.IsConfirmed | INT(1) | Booking Confirmation Flag. [1 or 0]1 : Confirmed0 : Not Confirmed | 1 or 0. |
| BookingTran.CurrentStatus | VARCHAR(100) | Booking Current Status | Arrived, Checked Out, Cancel, Void, etc |
| BookingTran.VoucherNo | VARCHAR(255) | Booking Voucher No | 10203049/8512 |
| BookingTran. PackageCode | INT(20) | Package Code | 112500000000000001 |
| BookingTran. PackageName | VARCHAR(1000) | Package Name | European Plan etc |
| BookingTran. RateplanCode | INT(20) | Unique RatePlan Code | 112500000000000006 |
| BookingTran. RateplanName | STRING(1000) | RatePlan Name | Grand Sea View Junior Suite |
| BookingTran. RoomTypeCode | INT(20) | Unique RoomType Code | 112500000000000006 |
| BookingTran. RoomTypeName | STRING(1000) | RoomType Name | Garden View Studio Room |
| BookingTran.RoomID | INT(20) | Unique RoomID | 112500000000000001 |
| BookingTran. RoomName | STRING(1000) | Room Name | 101 |
| BookingTran. Start | DATE | Check-in date[Format : yyyy-mm-dd] | 2017-12-25 |
| BookingTran. End | DATE | Check-out date [Format : yyyy-mm-dd] | 2017-12-27 |
| BookingTran.TotalRate | DECIMAL(19,4) | Rate on room in amount | 1500.43 |
| BookingTran.TotalDiscount | DECIMAL(19,4) | Discount on room in amount | 500 |
| BookingTran. TotalExtraCharge | DECIMAL(19,4) | Extra charges in amount(if any) | 300 |
| BookingTran.* | – | Here * denotes guest informations like Salutation, FirstName, LastName, Gender, DateOfBirth, SpouseDateOfBirth, WeddingAnniversary, Nationality, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email,RegistrationNo,IdentityType, IdentityNo, ExpiryDate. | |
| BookingTran. TransportationMode | VARCHAR(100) | Mode of transportation | Bus, car etc |
| BookingTran. Vehicle | VARCHAR(255) | Detail of vehicle | |
| BookingTran. PickupDate | DATE | Pickup date[Format : yyyy-mm-dd] | 2017-12-25 etc |
| BookingTran. PickupTime | TIME | Pickup time | |
| BookingTran. Source | VARCHAR(1000) | Booking generated source | Booking.com |
| BookingTran. Comment | VARCHAR(1000) | Additional Information or comment. | |
| BookingTran. AffiliateName | VARCHAR(1000) | Booking Affiliate Name | |
| BookingTran.AffiliateCode | VARCHAR(1000) | Booking Affiliate Code | |
| BookingTran.* | – | Here * denotes Credit Card Informations like CCLink, CCNo, CCType, CardHolderName, CCExpiryDate, | CCLink in encoded with base64_encode. |
| BookingTran.RentalInfo.RoomID | INT(20) | Unique RoomID | 112500000000000001 |
| BookingTran.RentalInfo. RoomName | STRING(1000) | Room Name | 101 |
| BookingTran.RentalInfo.EffectiveDate | DATETIME | Booking details for particular effective date | 2017-12-25 etc |
| BookingTran.RentalInfo.PackageCode | INT(20) | Package code | 112500000000000001 |
| BookingTran.RentalInfo.PackageName | VARCHAR(1000) | Package Name | European Plan |
| BookingTran.RentalInfo.RoomTypeCode | INT(20) | Unique RoomType Code | 112500000000000006 |
| BookingTran.RentalInfo.RoomTypeName | STRING(1000) | RoomType Name | Grand Sea View Junior Suite |
| BookingTran.RentalInfo.Adult | INT(11) | No. of Adults | 2,3,4 etc |
| BookingTran. RentalInfo.Child | INT(11) | No. of Child | 2,3,4 etc |
| BookingTran. RentalInfo.Rent | DECIMAL(19,4) | Room rental amount | 1500.43 |
| BookingTran. RentalInfo.Discount | DECIMAL(19,4) | Discount on rental room in amount | 500 |
| BookingTran.Sharer.* | – | Here * denotes Sharer informations like Salutation, FirstName, LastName, Gender, DateOfBirth, SpouseDateOfBirth, WeddingAnniversary, Nationality, Address, City, State, Country, Nationality,Zip Code, Phone, Mobile, Fax, Email,RegistrationNo,IdentityTypeID, IdentityNo, ExpiryDate. | |
| Errors.ErrorCode | – | Response Error Code | 104, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. etc |
Success
{
"Reservations": {
"Reservation": [
{
"BookingTran": [
{
"SubBookingId": "11241254",
"TransactionId": "112400000000001902",
"Createdatetime": "2019-09-04 11:40:30",
"Modifydatetime": "2019-09-04 11:40:30",
"Status": "New",
"IsConfirmed": "1",
"CurrentStatus": "Arrived",
"VoucherNo": "single1276/1",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RateplanCode": "112400000000000001",
"RateplanName": "Sea View Deluxe Room",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"RoomID": "112400000000000001",
"RoomName": "101",
"Start": "2019-09-26",
"End": "2019-09-28",
"ArrivalTime": "12:00:00",
"DepartureTime": "11:00:00",
"CurrencyCode": "USD",
"TotalAmountAfterTax": "976.00",
"TotalAmountBeforeTax": "800.00",
"TotalTax": "176.00",
"TotalDiscount": "0.00",
"TotalExtraCharge": "0.00",
"TotalPayment": "0.00",
"TACommision": "0.00",
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
“RegistrationNo” : "",
"IdentityType": "Pan card",
"IdentityNo": "12345667765",
"ExpiryDate": "",
"TransportationMode": "",
"Vehicle": "car",
"PickupDate": "",
"PickupTime": "",
"Source": "BookingEye",
"Comment": "",
"AffiliateName": "",
"AffiliateCode": "",
"CCLink": "",
"CCNo": "",
"CCType": "",
"CCExpiryDate": "",
"CardHoldersName": "",
"TaxDeatil": [
{
"TaxCode": "AA",
"TaxName": "VAT @ 12%",
"TaxAmount": "96.0000"
},
{
"TaxCode": "LT",
"TaxName": "Luxury @ 10%",
"TaxAmount": "80.0000"
}
],
"RentalInfo": [
{
"RoomID": "112400000000000001",
"RoomName": "101",
"EffectiveDate": "2019-09-26",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "550.00",
"Rent": "671.00",
"Discount": "0.00"
},
{
"RoomID": "112400000000000001",
"RoomName": "101",
"EffectiveDate": "2019-09-27",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "250.00",
"Rent": "305.00",
"Discount": "0.00"
}
],
"Sharer": [
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"RegistrationNo" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
},
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"Registration No" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
}
]
}
],
"LocationId": "1124",
"UniqueID": "11241254",
"BookedBy": "BookingEye",
"Salutation": "Ms.",
"FirstName": "Larry",
"LastName": "Forney",
"Gender": "Female",
"Address": "",
"City": "Brockway",
"State": "CA",
"Country": "USA",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"Source": "BookingEye",
"PaymentMethod": "Cash",
"IsChannelBooking": "1"
}
]
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 201 | Unauthorized request. (Request Type) the request is not valid for this hotel code OR OpenAPI platform is deactive |
| 202 | Unauthorized request. Hotel code is not active |
| 203 | Missing Parameter OR Invalid Parameter: TranunkId |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 303 | Auth Code is inactive. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 503 | No Reservation Found. |
Bookings
Booking Received Notification
You should strive to process new, modified, and canceled reservations almost instantly (see Retrieve all Bookings). This API is used to notify our system, that you have received bookings.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “BookingRecdNotification” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXX |
| BookingId * | VARCHAR(20) | Unique BookingId | 1234, RV123,G872 |
| PMS_BookingId* | VARCHAR(20) | Third party PMS Unique ID | 1234, RV123,G872 |
| Status | VARCHAR(20) | Booking Status (Optional) | New, Modify, Cancel |
Request
{
"RES_Request": {
"Request_Type": "BookingRecdNotification",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxx"
},
"Bookings": {
"Booking": [
{
"BookingId": "12345",
"PMS_BookingId": "123456",
"Status": "New"
},
{
"BookingId": "4321",
"PMS_BookingId": "45678",
"Status": "Cancel"
}
]
}
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | 2 booking(s) updated |
| Errors.ErrorCode | – | Response Error Code | 0, 301 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. Please check hotel code and authentication code |
Success
{
"Success": {
"SuccessMsg": "2 booking(s) updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 117 | Booking id(s) missing in booking received notification request |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 118 | Booking id(s) missing in booking received notification request |
Bookings
Retrieve a Booking
This API helps you to fetch booking details for specific booking ID based on Room No, Guest, Identity No, Guest Email, Guest Mobile No, Guest Registration No. The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type* | VARCHAR(100) | Request Type | FetchSingleBooking |
| BookingId* | INT(11) | Reservation No | 12345 |
| RoomNo | VARCHAR(500) | Room No (It is Optional) | 101 |
| Guest | VARCHAR(100) | Guest Name (It is Optional) | test |
| IdentityNo | VARCHAR(255) | Identity No (It is Optional) | ASD43543 |
| GuestEmail | VARCHAR(255) | Guest Email (It is Optional) | abc@gmail.com |
| GuestMobileNo | VARCHAR(255) | Guest Mobile No (It is Optional) | XXXXXXXXXX |
| GuestRegistrationNo | VARCHAR(255) | Guest Registration No (It is Optional) | XXXXXX |
| HotelCode* | INT(11) | Unique Hotel code | xxxx |
| AuthCode* | VARCHAR(300) | Unique Authentication code | xxxxxxxxxx |
Request
{
"RES_Request": {
"Request_Type": "FetchSingleBooking",
. "BookingId": "12345",
"RoomNo": "101",
"Guest": "Joy T. Mnewy",
"IdentityNo": "ASD43543",
"GuestEmail": "XXXXXX@gmail.com",
"GuestMobileNo": "XXXXXXXXXX",
"GuestRegistrationNo": "XXXXXX",
"Authentication": {
"HotelCode": "XXXX",
"AuthCode": "XXXXXXXXXXXXXXXXXXX"
}
}
}
Response
| Name | Data Type | Description | Example |
| LocationId | INT(11) | Hotel code | xxxx |
| UniqueID | VARCHAR(255) | Unique Booking id/ Reservation No | 10125, 86436, B4525 etc |
| BookedBy | VARCHAR(255) | Information regarding Booked by | Booking.com etc |
| Salutation, FirstName, LastName, Gender, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email,RegistrationNo. | VARCHAR(255) | Here * denotes guest information like Salutation, FirstName, LastName, Gender, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email,RegistrationNo. | shown in JSON response below. |
| Source | VARCHAR(1000) | Booking generated source | Booking.com etc |
| PaymentMethod | VARCHAR(255) | Payment Mode selected by guest | Cash, Credit, CityLedger etc |
| IsChannelBooking | INT(1) | Is booking comes from channel [0 or 1]1 : Booking from the channel.0: Booking not from the channel. | 0 or 1 |
| BookingTran. SubBookingId | VARCHAR(255) | Sub booking Id | 138 |
| BookingTran. TransactionId | INT(20) | Booking Transaction ID | 112500000000000163 |
| BookingTran. Status | VARCHAR(100) | Booking Status | New or Modify or Cancel. |
| BookingTran.IsConfirmed | INT(1) | Booking Confirmation Flag. [1 or 0]1 : Confirmed0 : Not Confirmed | 1 or 0. |
| BookingTran.CurrentStatus | VARCHAR(100) | Booking Current Status | Arrived, Checked Out, Cancel, Void, etc |
| BookingTran.VoucherNo | VARCHAR(255) | Booking Voucher No | 10203049/8512 |
| BookingTran. PackageCode | INT(20) | Package Code | 112500000000000001 |
| BookingTran. PackageName | VARCHAR(1000) | Package Name | European Plan etc |
| BookingTran. RateplanCode | INT(20) | Unique RatePlan Code | 112500000000000006 |
| BookingTran. RateplanName | STRING(1000) | RatePlan Name | Grand Sea View Junior Suite |
| BookingTran. RoomTypeCode | INT(20) | Unique RoomType Code | 112500000000000006 |
| BookingTran. RoomTypeName | STRING(1000) | RoomType Name | Garden View Studio Room |
| BookingTran.RoomID | INT(20) | Unique RoomID | 112500000000000001 |
| BookingTran. RoomName | STRING(1000) | Room Name | 101 |
| BookingTran. Start | DATE | Check-in date[Format : yyyy-mm-dd] | 2017-12-25 |
| BookingTran. End | DATE | Check-out date [Format : yyyy-mm-dd] | 2017-12-27 |
| BookingTran.TotalRate | DECIMAL(19,4) | Rate on room in amount | 1500.43 |
| BookingTran. | DECIMAL(19,4) | Discount on room in | 500 |
| TotalDiscount | Amount | ||
| BookingTran. TotalExtraCharge | DECIMAL(19,4) | Extra charges in amount(if any) | 300 |
| BookingTran.* | – | Here * denotes guest informations like Salutation, FirstName, LastName, Gender, DateOfBirth, SpouseDateOfBirth, WeddingAnniversary, Nationality, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email,RegistrationNo,IdentityType, IdentityNo, ExpiryDate. | |
| BookingTran. TransportationMode | VARCHAR(100) | Mode of transportation | Bus, car etc |
| BookingTran. Vehicle | VARCHAR(255) | Detail of vehicle | |
| BookingTran. PickupDate | DATE | Pickup date[Format : yyyy-mm-dd] | 2017-12-25 etc |
| BookingTran. PickupTime | TIME | Pickup time | |
| BookingTran. Source | VARCHAR(1000) | Booking generated source | Booking.com |
| BookingTran. Comment | VARCHAR(1000) | Additional Information or comment. | |
| BookingTran. AffiliateName | VARCHAR(1000) | Booking Affiliate Name | |
| BookingTran.AffiliateCode | VARCHAR(1000) | Booking Affiliate Code | |
| BookingTran.* | – | Here * denotes Credit Card Informations like CCLink, CCNo, CCType, CardHolderName, CCExpiryDate, | CCLink in encoded with base64_encode. |
| BookingTran.RentalInfo.RoomID | INT(20) | Unique RoomID | 112500000000000001 |
| BookingTran.RentalInfo. RoomName | STRING(1000) | Room Name | 101 |
| BookingTran.RentalInfo.EffectiveDate | DATETIME | Booking details for particular effective date | 2017-12-25 etc |
| BookingTran.RentalInfo.PackageCode | INT(20) | Package code | 112500000000000001 |
| BookingTran.RentalInfo.PackageName | VARCHAR(1000) | Package Name | European Plan |
| BookingTran.RentalInfo.RoomTypeCode | INT(20) | Unique RoomType Code | 112500000000000006 |
| BookingTran.RentalInfo.RoomTypeName | STRING(1000) | RoomType Name | Grand Sea View Junior Suite |
| BookingTran.RentalInfo.Adult | INT(11) | No. of Adults | 2,3,4 etc |
| BookingTran. RentalInfo.Child | INT(11) | No. of Childs | 2,3,4 etc |
| BookingTran. RentalInfo.Rent | DECIMAL(19,4) | Room rental amount | 1500.43 |
| BookingTran. RentalInfo.Discount | DECIMAL(19,4) | Discount on rental room in amount | 500 |
| BookingTran.Sharer.* | – | Here * denotes Sharer informations like Salutation, FirstName, LastName, Gender, DateOfBirth, SpouseDateOfBirth, WeddingAnniversary, Nationality, Address, City, State, Country, Nationality,Zip Code, Phone, Mobile, Fax, Email,RegistrationNo,IdentityTypeID, IdentityNo, ExpiryDate. | |
| Errors.ErrorCode | – | Response Error Code | 104, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. etc |
Success
{
"Reservations": {
"Reservation": [
{
"BookingTran": [
{
"SubBookingId": "11241254",
"TransactionId": "112400000000001902",
"Createdatetime": "2019-09-04 11:40:30",
"Modifydatetime": "2019-09-04 11:40:30",
"Status": "New",
"IsConfirmed": "1",
"CurrentStatus": "Arrived",
"VoucherNo": "single1276/1",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RateplanCode": "112400000000000001",
"RateplanName": "Sea View Deluxe Room",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"RoomID": "112400000000000001",
"RoomName": "101",
"Start": "2019-09-26",
"End": "2019-09-28",
"ArrivalTime": "12:00:00",
"DepartureTime": "11:00:00",
"CurrencyCode": "USD",
"TotalAmountAfterTax": "976.00",
"TotalAmountBeforeTax": "800.00",
"TotalTax": "176.00",
"TotalDiscount": "0.00",
"TotalExtraCharge": "0.00",
"TotalPayment": "0.00",
"TACommision": "0.00",
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
“RegistrationNo” : "",
"IdentityType": "Pan card",
"IdentityNo": "12345667765",
"ExpiryDate": "",
"TransportationMode": "",
"Vehicle": "car",
"PickupDate": "",
"PickupTime": "",
"Source": "BookingEye",
"Comment": "",
"AffiliateName": "",
"AffiliateCode": "",
"CCLink": "",
"CCNo": "",
"CCType": "",
"CCExpiryDate": "",
"CardHoldersName": "",
"TaxDeatil": [
{
"TaxCode": "AA",
"TaxName": "VAT @ 12%",
"TaxAmount": "96.0000"
},
{
"TaxCode": "LT",
"TaxName": "Luxury @ 10%",
"TaxAmount": "80.0000"
}
],
"RentalInfo": [
{
"RoomID": "112400000000000001",
"RoomName": "101",
"EffectiveDate": "2019-09-26",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "550.00",
"Rent": "671.00",
"Discount": "0.00"
},
{
"RoomID": "112400000000000001",
"RoomName": "101",
"EffectiveDate": "2019-09-27",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "250.00",
"Rent": "305.00",
"Discount": "0.00"
}
],
"Sharer": [
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"RegistrationNo" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
},
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"Registration No" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
}
]
}
],
"LocationId": "1124",
"UniqueID": "11241254",
"BookedBy": "BookingEye",
"Salutation": "Ms.",
"FirstName": "Larry",
"LastName": "Forney",
"Gender": "Female",
"Address": "",
"City": "Brockway",
"State": "CA",
"Country": "USA",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"Source": "BookingEye",
"PaymentMethod": "Cash",
"IsChannelBooking": "1"
}
]
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 212 | Missing Parameter OR Invalid Parameter |
| 213 | Parameter is blank |
Bookings
Retrieve all Bookings
This API will give you latest updates of bookings which are newly created, modified and canceled. The API can return data in JSON formats. The web service responds to HTTP POST requests.
We recommend periodically calling the API — every minute, so your system can remain in sync with our system thereby keeping your system up-to-date.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “Bookings” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
Request
{
"RES_Request": {
"Request_Type": "Bookings",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "XXXXXXXXXXXXXXXXXXXXXXXX"
}
}
}
Response
| Name | Data Type | Description | Example |
| LocationId | INT(11) | Hotel code | xxxx |
| UniqueID | VARCHAR(255) | Unique Booking id | 10125, 86436, B4525 etc |
| BookedBy | VARCHAR(255) | Information regarding Booked by | Booking.com etc |
| Salutation, FirstName, LastName, Gender, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email. | VARCHAR(255) | Here * denotes guest information like Salutation, FirstName, LastName, Gender, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email. | shown in JSON response below. |
| Source | VARCHAR(1000) | Booking generated source | Booking.com etc |
| PaymentMethod | VARCHAR(255) | Payment Mode selected by guest | Cash, Credit, CityLedger etc |
| IsChannelBooking | INT(1) | Is booking comes from channel [0 or 1] 1 : Booking from the channel. 0: Booking not from the channel. | 0 or 1 |
| BookingTran. SubBookingId | VARCHAR(255) | Sub booking Id | 138 |
| BookingTran. TransactionId | INT(20) | Booking Transaction ID | 112500000000000163 |
| BookingTran. Status | VARCHAR(1000) | Booking Status | New or Modify or Cancel. |
| BookingTran.I sConfirmed | INT(1) | Booking Confirmation Flag. [1 or 0] 1 : Confirmed 0 : Not Confirmed | 1 or 0. |
| BookingTran.CurrentStatus | VARCHAR(100) | Booking Current Status | Arrived, Checked Out, Cancel, Void, etc |
| BookingTran. VoucherNo | VARCHAR(255) | Booking Voucher No | 10203049/8512 |
| BookingTran. PackageCode | INT(20) | Package Code | 112500000000000001 |
| BookingTran. PackageName | VARCHAR(1000) | Package Name | European Plan etc |
| BookingTran. RateplanCode | INT(20) | Unique RatePlan Code | 112500000000000006 |
| BookingTran. RateplanName | STRING(1000) | RatePlan Name | Grand Sea View Junior Suite |
| BookingTran. RoomTypeCode | INT(20) | Unique RoomType Code | 112500000000000006 |
| BookingTran. RoomTypeName | STRING(1000) | RoomType Name | Garden View Studio Room |
| BookingTran. Start | DATE | Check-in date[Format : yyyy-mm-dd] | 2017-12-25 |
| BookingTran. End | DATE | Check-out date [Format : yyyy-mm-dd] | 2017-12-27 |
| BookingTran.TotalRate | DECIMAL(19,4) | Rate on room in amount | 1500.43 |
| BookingTran. | DECIMAL(19,4) | Discount on room in | 500 |
| TotalDiscount | Amount | ||
| BookingTran. TotalExtraCharge | DECIMAL(19,4) | Extra charges in amount(if any) | 300 |
| BookingTran. TotalPayment | DECIMAL(19,4) | Payment for room in amount | 2500.54 |
| BookingTran.* | – | Here * denotes guest informations like Salutation, FirstName, LastName, Gender, DateOfBirth, SpouseDateOfBirth, WeddingAnniversary, Nationality, Address, City, State, Country, Zip Code, Phone, Mobile, Fax, Email, RegistrationNo, IdentityType, IdentityNo, ExpiryDate. | |
| BookingTran. TransportationMode | VARCHAR(100) | Mode of transportation | Bus, car etc |
| BookingTran. Vehicle | VARCHAR(255) | Detail of vehicle | |
| BookingTran. PickupDate | DATE | Pickup date[Format : yyyy-mm-dd] | 2017-12-25 etc |
| BookingTran. PickupTime | TIME | Pickup time | |
| BookingTran. Source | VARCHAR(1000) | Booking generated source | Booking.com |
| BookingTran. Comment | VARCHAR(1000) | Additional Information or comment. | |
| BookingTran. AffiliateName | VARCHAR(1000) | Booking Affiliate Name | |
| BookingTran.AffiliateCode | VARCHAR(1000) | Booking Affiliate Code | |
| BookingTran.* | – | Here * denotes Credit Card Informations like CCLink, CCNo, CCType, CardHolderName, CCExpiryDate,etc | CCLink in encoded with base64_encode. |
| BookingTran.RentalInfo.EffectiveDate | DATETIME | Booking details for particular effective date | 2017-12-25 etc |
| BookingTran.RentalInfo.PackageCode | INT(20) | Package code | 112500000000000001 |
| BookingTran.RentalInfo.PackageName | VARCHAR(1000) | Package Name | European Plan |
| BookingTran.RentalInfo.R oomTypeCode | INT(20) | Unique RoomType Code | 112500000000000006 |
| BookingTran.RentalInfo.R oomTypeName | STRING(1000) | RoomType Name | Grand Sea View Junior Suite |
| BookingTran.RentalInfo.Adult | INT(11) | No. of Adults | 2,3,4 etc |
| BookingTran. RentalInfo.Child | INT(11) | No. of Childs | 2,3,4 etc |
| BookingTran. RentalInfo.Rent | DECIMAL(19,4) | Room rental amount | 1500.43 |
| BookingTran. RentalInfo.Discount | DECIMAL(19,4) | Discount on rental room in amount | 500 |
| BookingTran.Sharer.* | – | Here * denotes Sharer informations like Salutation, FirstName, LastName, Gender, DateOfBirth, SpouseDateOfBirth, WeddingAnniversary, Nationality, Address, City, State, Country, Nationality,Zip Code, Phone, Mobile, Fax, Email,RegistrationNo,IdentityTypeID, IdentityNo, ExpiryDate. | |
| Errors.ErrorCode | – | Response Error Code | 104, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. etc |
Success
1.Single Booking
{
"Reservations": {
"Reservation": [
{
"BookingTran": [
{
"SubBookingId": "12341254",
"TransactionId": "123400000000001902",
"Createdatetime": "2019-09-04 11:40:30",
"Modifydatetime": "2019-09-04 11:40:30",
"Status": "New",
"IsConfirmed": "1",
"CurrentStatus": "Arrived",
"VoucherNo": "single1276/1",
"PackageCode": "123400000000000001",
"PackageName": "European Plan",
"RateplanCode": "123400000000000001",
"RateplanName": "Sea View Deluxe Room",
"RoomTypeCode": "123400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Start": "2019-09-26",
"End": "2019-09-28",
"ArrivalTime": "12:00:00",
"DepartureTime": "11:00:00",
"CurrencyCode": "USD",
"TotalAmountAfterTax": "976.00",
"TotalAmountBeforeTax": "800.00",
"TotalTax": "176.00",
"TotalDiscount": "0.00",
"TotalExtraCharge": "0.00",
"TotalPayment": "0.00",
"TACommision": "0.00",
"Salutation": "Ms.",
"FirstName": "April",
"LastName": "Myers",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": "Decorah",
"State": "Decorah",
"Country": "IA",
"Nationality": "Malta",
"Zipcode": "52101",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "AprilAMyers@jourrapide.com",
"RegistrationNo" : "",
"IdentityType": "Pan card",
"IdentityNo": "12345667765",
"ExpiryDate": "",
"TransportationMode": "",
"Vehicle": "car",
"PickupDate": "",
"PickupTime": "",
"Source": "BookingEye",
"Comment": "",
"AffiliateName": "",
"AffiliateCode": "",
"CCLink": "",
"CCNo": "",
"CCType": "",
"CCExpiryDate": "",
"CardHoldersName": "",
"TaxDeatil": [
{
"TaxCode": "AA",
"TaxName": "VAT @ 12%",
"TaxAmount": "96.0000"
},
{
"TaxCode": "LT",
"TaxName": "Luxury @ 10%",
"TaxAmount": "80.0000"
}
],
"RentalInfo": [
{
"EffectiveDate": "2019-09-26",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "550.00",
"Rent": "671.00",
"Discount": "0.00"
},
{
"EffectiveDate": "2019-09-27",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "250.00",
"Rent": "305.00",
"Discount": "0.00"
}
],
"Sharer": [
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"RegistrationNo" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
},
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "Two",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"Registration No" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
}
]
}
],
"LocationId": "1124",
"UniqueID": "11241254",
"BookedBy": "BookingEye",
"Salutation": "Ms.",
"FirstName": "Hae ",
"LastName": " Giles ",
"Gender": "Female",
"Address": " Garfield Road ",
"City": "Peoria",
"State": " Peoria ",
"Country": "IL",
"Zipcode": "61614",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "HaeWGiles@jourrapide.com",
"Source": "BookingEye",
"PaymentMethod": "Cash",
"IsChannelBooking": "1"
}
]
}
}
2.Multiple booking :
{
"Reservations": {
"Reservation": [
{
"BookingTran": [
{
"SubBookingId": "11241254",
"TransactionId": "112400000000001902",
"Createdatetime": "2019-09-04 11:40:30",
"Modifydatetime": "2019-09-04 11:40:30",
"Status": "New",
"IsConfirmed": "1",
"VoucherNo": "single1276/1",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RateplanCode": "112400000000000001",
"RateplanName": "Sea View Deluxe Room",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Start": "2019-09-26",
"End": "2019-09-28",
"ArrivalTime": "12:00:00",
"DepartureTime": "11:00:00",
"CurrencyCode": "USD",
"TotalAmountAfterTax": "976.00",
"TotalAmountBeforeTax": "800.00",
"TotalTax": "176.00",
"TotalDiscount": "0.00",
"TotalExtraCharge": "0.00",
"TotalPayment": "0.00",
"TACommision": "0.00",
"Salutation": "Ms.",
"FirstName": "Lilly",
"LastName": "Harper",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Peoria ",
"State": "Peoria",
"Country": "IL",
"Nationality": "Malta",
"Zipcode": "61614",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LillyJHarper@jourrapide.com",
"RegistrationNo" : "",
"IdentiyType": "Pan card",
"IdentityNo": "12345667765",
"ExpiryDate": "",
"TransportationMode": "",
"Vehicle": "car",
"PickupDate": "",
"PickupTime": "",
"Source": "BookingEye",
"Comment": "",
"AffiliateName": "",
"AffiliateCode": "",
"CCLink": "",
"CCNo": "",
"CCType": "",
"CCExpiryDate": "",
"CardHoldersName": "",
"TaxDeatil": [
{
"TaxCode": "AA",
"TaxName": "VAT @ 12%",
"TaxAmount": "96.0000"
},
{
"TaxCode": "LT",
"TaxName": "Luxury @ 10%",
"TaxAmount": "80.0000"
}
],
"RentalInfo": [
{
"EffectiveDate": "2019-09-26",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "550.00",
"Rent": "671.00",
"Discount": "0.00"
},
{
"EffectiveDate": "2019-09-27",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "250.00",
"Rent": "305.00",
"Discount": "0.00"
}
]
}
],
"LocationId": "1124",
"UniqueID": "11241254",
"BookedBy": "BookingEye",
"Salutation": "Ms.",
"FirstName": "Hae ",
"LastName": " Giles ",
"Gender": "Female",
"Address": " Garfield Road ",
"City": "Peoria",
"State": " Peoria ",
"Country": "IL",
"Zipcode": "61614",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "HaeWGiles@jourrapide.com",
"Source": "BookingEye",
"PaymentMethod": "Cash",
"IsChannelBooking": "1"
},
{
"BookingTran": [
{
"SubBookingId": "11241255",
"TransactionId": "123450000000001903",
"Createdatetime": "2019-09-10 11:31:57",
"Modifydatetime": "2019-09-10 11:31:57",
"Status": "New",
"IsConfirmed": "1",
"CurrentStatus": "Arrived",
"VoucherNo": "",
"PackageCode": "12340000000000001",
"PackageName": "European Plan",
"RateplanCode": "123450000000000001",
"RateplanName": "Sea View Deluxe Room",
"RoomTypeCode": "123450000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Start": "2019-09-11",
"End": "2019-09-12",
"ArrivalTime": "12:00:00",
"DepartureTime": "11:00:00",
"CurrencyCode": "USD",
"TotalAmountAfterTax": "6832.00",
"TotalAmountBeforeTax": "5600.00",
"TotalTax": "1232.00",
"TotalDiscount": "0.00",
"TotalExtraCharge": "0.00",
"TotalPayment": "0.00",
"TACommision": "0.00",
"Salutation": "Dr.",
"FirstName": "Ellen",
"LastName": "Novak",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": "",
"State": "",
"Country": "",
"Nationality": "",
"Zipcode": "",
"Phone": "",
"Mobile": "+123 456 7890",
"Fax": "",
"Email": "EllenDNovak@dayrep.com",
"RegistrationNo" : "",
"IdentiyType": "",
"IdentityNo": "",
"ExpiryDate": "",
"TransportationMode": "",
"Vehicle": "",
"PickupDate": "",
"PickupTime": "",
"Source": "Internet Booking Engine",
"Comment": "",
"AffiliateName": "",
"AffiliateCode": "",
"CCLink": "",
"CCNo": "",
"CCType": "",
"CCExpiryDate": "",
"CardHoldersName": "",
"TaxDeatil": [
{
"TaxCode": "AA",
"TaxName": "VAT @ 12%",
"TaxAmount": "672.0000"
},
{
"TaxCode": "LT",
"TaxName": "Luxury @ 10%",
"TaxAmount": "560.0000"
}
],
"RentalInfo": [
{
"EffectiveDate": "2019-09-11",
"PackageCode": "123450000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "123450000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "2",
"Child": "0",
"RentPreTax": "5600.00",
"Rent": "6832.00",
"Discount": "0.00"
}
],
"Sharer": [
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "One",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"RegistrationNo" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
},
{
"Salutation": "Ms.",
"FirstName": "Test",
"LastName": "Two",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Brockway",
"State": "CA",
"Country": "USA",
"Nationality": "Malta",
"Zipcode": "95730",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "LarryLForney@rhyta.com",
"Registration No" : "",
"IdentityTypeID": "894300000000000003",
"IdentityNo": "12345667765",
"ExpiryDate": "",
}
]
}
],
"LocationId": "1234",
"UniqueID": "11241255",
"BookedBy": "Internet Booking Engine",
"Salutation": "Dr.",
"FirstName": "Audrey",
"LastName": "Manuel",
"Gender": "",
"Address": "",
"City": "",
"State": "",
"Country": "",
"Zipcode": "",
"Phone": "",
"Mobile": "+1234567890",
"Fax": "",
"Email": "AudreyJManuel@armyspy.com",
"Source": "Internet Booking Engine",
"IsChannelBooking": "0"
}
],
"CancelReservation": [
{
"LocationId": "1234",
"UniqueID": "11241008-1",
"Status": "Cancel",
"Canceldatetime": "2019-05-08 14:21:16",
"Remark": "Guest want to cancel reservation through Zenrooms",
"VoucherNo": "100335/1"
},
{
"LocationId": "1234",
"UniqueID": "11241008-2",
"Status": "Cancel",
"Canceldatetime": "2019-05-08 14:21:27",
"Remark": "Guest want to cancel reservation through Zenrooms",
"VoucherNo": "100335/2"
},
{
"LocationId": "1234",
"UniqueID": "11241011",
"Status": "Cancel",
"Canceldatetime": "2019-05-08 14:18:57",
"Remark": "Guest want to cancel reservation through Zenrooms",
"VoucherNo": "1253911111/2"
}
]
}
}
3.Modify Booking :
{
"Reservations": {
"Reservation": [
{
"BookingTran": [
{
"SubBookingId": "12345254",
"TransactionId": "123450000000001902",
"Createdatetime": "2019-09-04 11:40:30",
"Modifydatetime": "2019-09-04 11:40:30",
"Status": "Modify",
"IsConfirmed": "1",
"VoucherNo": "single1276/1",
"PackageCode": "123450000000000001",
"PackageName": "European Plan",
"RateplanCode": "112400000000000001",
"RateplanName": "Sea View Deluxe Room",
"RoomTypeCode": "123450000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Start": "2019-09-26",
"End": "2019-09-28",
"ArrivalTime": "12:00:00",
"DepartureTime": "11:00:00",
"CurrencyCode": "USD",
"TotalAmountAfterTax": "976.00",
"TotalAmountBeforeTax": "800.00",
"TotalTax": "176.00",
"TotalDiscount": "0.00",
"TotalExtraCharge": "0.00",
"TotalPayment": "0.00",
"TACommision": "0.00",
"Salutation": "Ms.",
"FirstName": "Valentina",
"LastName": "Riter",
"Gender": "Female",
"DateOfBirth": "",
"SpouseDateOfBirth": "",
"WeddingAnniversary": "",
"Address": "",
"City": " Peoria ",
"State": "Peoria",
"Country": "IL",
"Nationality": "Malta",
"Zipcode": "61614",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "ValentinaNRiter@jourrapide.com",
"IdentiyType": "Pan card",
"IdentityNo": "12345667765",
"ExpiryDate": "",
"TransportationMode": "",
"Vehicle": "car",
"PickupDate": "",
"PickupTime": "",
"Source": "BookingEye",
"Comment": "",
"AffiliateName": "",
"AffiliateCode": "",
"CCLink": "",
"CCNo": "",
"CCType": "",
"CCExpiryDate": "",
"CardHoldersName": "",
"TaxDeatil": [
{
"TaxCode": "AA",
"TaxName": "VAT @ 12%",
"TaxAmount": "96.0000"
},
{
"TaxCode": "LT",
"TaxName": "Luxury @ 10%",
"TaxAmount": "80.0000"
}
],
"RentalInfo": [
{
"EffectiveDate": "2019-09-26",
"PackageCode": "123450000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "123450000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "550.00",
"Rent": "671.00",
"Discount": "0.00"
},
{
"EffectiveDate": "2019-09-27",
"PackageCode": "112400000000000001",
"PackageName": "European Plan",
"RoomTypeCode": "112400000000000001",
"RoomTypeName": "Sea View Deluxe Room",
"Adult": "4",
"Child": "2",
"RentPreTax": "250.00",
"Rent": "305.00",
"Discount": "0.00"
}
]
}
],
"LocationId": "1234",
"UniqueID": "12345254",
"BookedBy": "BookingEye",
"Salutation": "Ms.",
"FirstName": "Valentina",
"LastName": "Riter",
"Gender": "Female",
"Address": "",
"City": "Charlotte",
"State": "Charlotte",
"Country": "NC",
"Zipcode": "28202",
"Phone": "",
"Mobile": "3534",
"Fax": "564564",
"Email": "ValentinaNRiter@jourrapide.com",
"Source": "BookingEye",
"PaymentMethod": "Cash",
"IsChannelBooking": "1"
}
]
}
}
4.Cancel Booking :
{
"Reservations": {
"CancelReservation": [
{
"LocationId": "xxxx",
"UniqueID": "12345228-1",
"Status": "Cancel",
"Canceldatetime": "2019-08-14 16:33:38",
"Remark": "",
"VoucherNo": ""
},
{
"LocationId": "xxxx",
"UniqueID": "12345228-2",
"Status": "Cancel",
"Canceldatetime": "2019-08-14 16:33:24",
"Remark": "",
"VoucherNo": ""
}
]
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
Rates & Availability
Retrieve Room Rates
The API provides a room rates data for a specific date range, room type and rate type for a property. The API can return data in XML formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | VARCHAR(250) | Use Keyword “Rate” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| FromDate * | DATE | To send a from date | 2020-07-05 |
| ToDate * | DATE | To send a to date | 2020-07-07 |
Request
<RES_Request> <Request_Type>Rate</Request_Type> <Authentication> <HotelCode>xxxx</HotelCode> <AuthCode>xxxxxxxxxx</AuthCode> </Authentication> <FromDate>2020-03-05</FromDate> <ToDate>2020-03-18</ToDate> </RES_Request>
Response
| Name | Data Type | Description | Example |
| RoomInfo.Source.RoomTypes. RoomType.RoomTypeID | INT(11) | Room Type Id | 1234500000000000001 |
| RoomInfo.Source.RoomTypes. RoomType.RateTypeID | INT(11) | Rate Plan Id | 1234500000000000013 |
| RoomInfo.Source.RoomTypes. RoomType.FromDate | DATETIME | From date | 2020-05-01 |
| RoomInfo.Source.RoomTypes. RoomType.ToDate | DATETIME | To date | 2020-05-10 |
| RoomInfo.Source.RoomTypes. RoomType.RoomRate.Base | Decimal(11,4) | Base Rate | 2500.0000 |
| RoomInfo.Source.RoomTypes. RoomType.RoomRate.ExtraAdult | Decimal(11,4) | Extra Adult Rate | 500.0000 |
| RoomInfo.Source.RoomTypes. RoomType.RoomRate.ExtraChild | Decimal(11,4) | Extra Child Rate | 200.0000 |
| Errors.ErrorCode | – | Response Error Code | 104, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. etc |
Success
<?xml version="1.0" encoding="UTF-8"?><RES_Response> <RoomInfo> <Source name="PMS"> <RoomTypes> <RateType> <RoomTypeID>1234500000000000001</RoomTypeID> <RateTypeID>1234500000000000013</RateTypeID> <FromDate>2020-03-14</FromDate> <ToDate>2020-03-18</ToDate> <RoomRate> <Base>2500.0000</Base> <ExtraAdult>500.0000</ExtraAdult> <ExtraChild>200.0000</ExtraChild> </RoomRate> </RateType> </RoomTypes> </Source> <Source name="Hotel Hilton - Web"> <RoomTypes> <RateType> <RoomTypeID>1234500000000000001</RoomTypeID> <RateTypeID>1234500000000000001</RateTypeID> <FromDate>2020-03-14</FromDate> <ToDate>2020-03-15</ToDate> <RoomRate> <Base>750.0000</Base> <ExtraAdult>350.0000</ExtraAdult> <ExtraChild>50.0000</ExtraChild> </RoomRate> </RateType> </RoomTypes> </Source> </RoomInfo> </RES_Response>
Error Codes
| Error Code | Error Name |
| 114 | Missing from date in some request |
| 115 | Missing to date in some request |
| 117 | From Date is not valid date |
| 118 | To Date is not valid date |
| 119 | Please check From and To date. To Date should be greater than From Date |
| 113 | Missing roomtype id in some request |
| 400 | Invalid Request Format |
| 302 | Authentication failed |
| 303 | Auth Code is inactive. |
| 301 | Unauthorized request. Request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 111 | Invalid Request |
Rates & Availability
Retrieve Room Inventory
The API provides a room inventory data for a specific date range and room type for a property. The API can return data in XML formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | VARCHAR(250) | Use Keyword “Inventory” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| FromDate * | DATE | To send a from date | 2020-07-05 |
| ToDate * | DATE | To send a to date | 2020-07-07 |
Request
<RES_Request> <Request_Type>Inventory</Request_Type> <Authentication> <HotelCode>xxxx</HotelCode> <AuthCode>xxxxxxxxxx</AuthCode> </Authentication> <FromDate>2020-03-05</FromDate> <ToDate>2020-03-18</ToDate> </RES_Request>
Response
| Name | Data Type | Description | Example |
| RoomInfo.Source.RoomTypes. RoomType.RoomTypeID | INT(11) | Room Type Id | 1234500000000000001 |
| RoomInfo.Source.RoomTypes. RoomType.FromDate | DATETIME | From date | 2020-05-01 |
| RoomInfo.Source.RoomTypes. RoomType.ToDate | DATETIME | To date | 2020-05-10 |
| RoomInfo.Source.RoomTypes. RoomType.Availability | INT(11) | No. Of room available | 4 |
| Errors.ErrorCode | – | Response Error Code | 104, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Unauthorized Request. etc |
Success
<?xml version="1.0" encoding="UTF-8"?><RES_Response> <RoomInfo> <Source name="Front"> <RoomTypes> <RoomType> <RoomTypeID>1234500000000000001</RoomTypeID> <FromDate>2020-03-11</FromDate> <ToDate>2020-03-16</ToDate> <Availability>1</Availability> </RoomType> <RoomType> <RoomTypeID>1234500000000000007</RoomTypeID> <FromDate>2020-03-18</FromDate> <ToDate>2020-03-18</ToDate> <Availability>5</Availability> </RoomType> </RoomTypes> </Source> </RoomInfo> </RES_Response>
Error Codes
| Error Code | Error Name |
| 114 | Missing from date in some request |
| 115 | Missing to date in some request |
| 117 | From Date is not valid date |
| 118 | To Date is not valid date |
| 119 | Please check From and To date. To Date should be greater than From Date |
| 113 | Missing roomtype id in some request |
| 400 | Invalid Request Format |
| 302 | Authentication failed |
| 303 | Auth Code is inactive. |
| 301 | Unauthorized request. Request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 111 | Invalid Request |
Rates & Availability
Update Close On Departure
This API helps you to apply close on departure restrictions for specific date ranges for a property. With this feature, you can restrict the availability of a room, by making a room unavailable to book if the guest checks out on a certain date.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateCOD” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| RatePlanID * | INT(20) | Unique Rate Plan ID | 123450000000000001 |
| FromDate * | DATETIME | Update From date. [Format: yyyy-mm-dd] | 2020-06-25 |
| ToDate * | DATETIME | Update To date [Format: yyyy-mm-dd] | 2020-06-27 |
| COD * | INT(1) | COD oprvalue [1 or 0] 1: Enable COD 0: Disable COD | 1 OR 0 |
Request
{
"RES_Request": {
"Request_Type": "UpdateCOD",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxxxxxx"
},
"RatePlan": [
{
"RatePlanID": "123450000000000001",
"FromDate": "2019-06-21",
"ToDate": "2019-06-22",
"COD": "0"
},
{
"RatePlanID": "123450000000000001",
"FromDate": "2019-06-25",
"ToDate": "2019-06-27",
"COD": "0"
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | COD Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 122, 127 etc |
| Errors.ErrorMessage | – | Generate Response Message | COD value is missing |
Success
{ "Success": {
"SuccessMsg": "COD Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 122 | Rate Plan ID is missing |
| 127 | COD value is missing |
| 128 | Invalid COD value |
Rates & Availability
Update Close On Arrival
This API helps you to apply close on arrival restrictions for specific date ranges for a property. With this feature, you can restrict the availability of a room, by making a room unavailable to book if the guest checks in on a certain date.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateCOA” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| RatePlanID * | INT(20) | Unique Rate Plan ID | 123450000000000001 |
| FromDate * | DATETIME | Update From date. [Format: yyyy-mm-dd] | 2020-06-25 |
| ToDate * | DATETIME | Update To date [Format: yyyy-mm-dd] | 2020-06-27 |
| COA * | INT(1) | COA oprvalue [1 or 0] 1: Enable COA 0: Disable COA | 1 OR 0 |
Request
{
"RES_Request": {
"Request_Type": "UpdateCOA",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxxxxxx"
},
"RatePlan": [
{
"RatePlanID": "123450000000000001",
"FromDate": "2019-06-21",
"ToDate": "2019-06-22",
"COA": "0"
},
{
"RatePlanID": "123450000000000001",
"FromDate": "2019-06-25",
"ToDate": "2019-06-27",
"COA": "0"
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | COA Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 122, 127 etc |
| Errors.ErrorMessage | – | Generate Response Message | COA value is missing |
Success
{ "Success": {
"SuccessMsg": "COA Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 122 | Rate Plan ID is missing |
| 127 | COA value is missing |
| 128 | Invalid COA value |
Rates & Availability
Update StopSell
This API helps you to open/close stop sell for specific date ranges for a property. With this feature, you can restrict the availability of a room, by making a room unavailable to book on a certain date.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateStopSell” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| RatePlanID * | INT(20) | Unique Rate Plan ID | 123450000000000001 |
| FromDate * | DATETIME | Update From date. [Format: yyyy-mm-dd] | 2020-06-25 |
| ToDate * | DATETIME | Update To date [Format: yyyy-mm-dd] | 2020-06-27 |
| StopSell * | INT(1) | Stopsell oprvalue [1 or 0] 1: Enable StopSell 0: Disable Stopsell | 1 OR 0 |
Request
{
"RES_Request": {
"Request_Type": "UpdateStopSell",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxx"
},
"RatePlan": [
{
"RatePlanID": "123450000000000001",
"FromDate": "2019-06-21",
"ToDate": "2019-06-22",
"StopSell": "0"
},
{
"RatePlanID": "123450000000000001",
"FromDate": "2019-06-25",
"ToDate": "2019-06-27",
"StopSell": "0"
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | StopSell Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 122, 127 etc |
| Errors.ErrorMessage | – | Generate Response Message | StopSell value is missing |
Success
{ "Success": {
"SuccessMsg": "StopSell Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 122 | Rate Plan ID is missing |
| 127 | StopSell value is missing |
| 128 | Invalid StopSell value |
Rates & Availability
Update Min Nights
This API helps you to update minimum nights for specific date ranges for a property. With this feature, you can restrict the availability of a room, by specifying a minimum length of stay if the reservation includes a certain date.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateMinNights” | |
| HotelCode * | INT(11) | Unique hotel code generated in the system | XXXX |
| AuthCode * | VARCHAR(300) | Unique code to enable the interface. | XXXXXXXXXXXXXXXXX |
| RatePlanID * | INT(20) | Unique Rate Plan ID | 112500000000000001 |
| FromDate * | DATETIME | Update From date. [Format: yyyy-mm-dd] | 2020-06-25 |
| ToDate * | DATETIME | Update To date [Format: yyyy-mm-dd] | 2020-07-27 |
| MinNight * | INT(11) | MinNight value | 2,5,10 etc |
Request
{ "RES_Request": {
"Request_Type": "UpdateMinNights",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxx"
},
"RatePlan": [
{
"RatePlanID": "123400000000000001",
"FromDate": "2019-06-25",
"ToDate": "2019-06-27",
"MinNight": "3"
},
{
"RatePlanID": "123400000000000006",
"FromDate": "2019-06-22",
"ToDate": "2019-06-24",
"MinNight": "3"
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | Min Nights Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 122, 127 etc |
| Errors.ErrorMessage | – | Generate Response Message | MinNight value is missing |
Success
{ "Success": {
"SuccessMsg": " Min Nights Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 122 | Rate Plan ID is missing |
| 127 | MinNight value is missing |
| 128 | Invalid MinNight value |
Rates & Availability
Update Max Nights
This API helps you to update maximum nights for specific date ranges for a property. With this feature, you can restrict the availability of a room, by specifying a maximum length of stay if the reservation includes a certain date.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateMaxNights” | |
| HotelCode * | INT(11) | Unique hotel code generated in the system | XXXX |
| AuthCode * | VARCHAR(300) | Unique code to enable the interface. | XXXXXXXXXXXXXXXXX |
| RatePlanID * | INT(20) | Unique Rate Plan ID | 112500000000000001 |
| FromDate * | DATETIME | Update From date. [Format: yyyy-mm-dd] | 2020-06-25 |
| ToDate * | DATETIME | Update To date [Format: yyyy-mm-dd] | 2020-07-27 |
| MaxNight * | INT(11) | MaxNight value | 2,5,10 etc |
Request
{ "RES_Request": {
"Request_Type": "UpdateMaxNights",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxx"
},
"RatePlan": [
{
"RatePlanID": "123400000000000001",
"FromDate": "2019-06-25",
"ToDate": "2019-06-27",
"MaxNight": "3"
},
{
"RatePlanID": "123400000000000006",
"FromDate": "2019-06-22",
"ToDate": "2019-06-24",
"MaxNight": "3"
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response Message | Max Nights Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 122, 127 etc |
| Errors.ErrorMessage | – | Generate Response Message | MaxNight value is missing |
Success
{ "Success": {
"SuccessMsg": " Max Nights Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 122 | Rate Plan ID is missing |
| 127 | MaxNight value is missing |
| 128 | Invalid MaxNight value |
Rates & Availability
Retrieve Room Rates with Source details
This API provides room types, rate types, rate plans and source information for a property. The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | VARCHAR(250) | Use Keyword “Separatesourcemapping” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
Request
{
"RES_Request": {
"Request_Type": "Separatesourcemapping",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxxxxx"
}
}
}
Response
| Name | Data Type | Description | Example |
| RoomType->ID | Integer | Id of room type | 2700000000000001 |
| RoomType->Name | String | Name of room type | Suite |
| RateType->ID | Integer | Id of rate type | 2700000000000003 |
| RateType->Name | String | Name of rate type | Non Refundable |
| RatePlan->RatePlanID | Integer | Rate Plan Id of rate plan | 2700000000000007 |
| RatePlan->Name | String | Name of rate plan | King RoomOnly |
| RatePlan->RoomTypeID | Integer | Room type id | 2700000000000001 |
| RatePlan->RoomType | String | Room Type | Suite |
| RatePlan->RateTypeID | Integer | Rate Type Id | 2700000000000003 |
| RatePlan->RateType | String | Rate Type | Non Refundable |
| Saparatechannelsource->Channel_name | String | It is giving remarks | OTA Common Pool |
| Saparatechannelsource->ChannelID | Integer | It is giving reservation no. | 2700000000000096 |
Success
{
"RoomInfo": {
"RoomTypes": {
"RoomType": [
{
"ID": "2700000000000001",
"Name": "Suite"
},
]
},
"RateTypes": {
"RateType": [
{
"ID": "2700000000000003",
"Name": "Non Refundable"
},
]
},
"RatePlans": {
"RatePlan": [
{
"RatePlanID": "2700000000000007",
"Name": "King RoomOnly",
"RoomTypeID": "2700000000000001",
"RoomType": "Suite",
"RateTypeID": "2700000000000003",
"RateType": "Non Refundable"
},
]
},
"Saparatechannelsources": {
"Saparatechannelsource": {
"Channel_name": "OTA Common Pool",
"ChannelID": "2700000000000096"
}
}
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error
{ "Errors": {
"ErrorCode": "301",
"ErrorMessage": "Unauthorized Request. Please check hotel code and authentication code"
}
}
Error Codes
| Error Code | Error Name |
| 202 | Unauthorized request. Hotel code is not active |
| 201 | Unauthorized request.Separatesourcemapping request is not valid for this hotel code |
| 100 | Missing required parameters. |
| 502 | Request Type is missing |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 303 | Auth Code is inactive. |
Rates & Availability
Update Non Linear Rate
This API provides a provision to set up occupancy based rates for a specified date range in any property. You must specify property’s rates based on combination of room type ID and rate type ID. In the non-linear pricing strategy, you’ll be able to levy your room charges as per the number of adults and children staying in a room. Naturally, the charges of adults and children will be separately configured.
Example : The base price of your room is $3000 for two adults and a child to stay in the room. If the guests bring in one extra child, you can charge an additional $300. If the guest bring in another child, you can charge in another $400. It goes the same for extra adults as well.
The non-linear price rate is flexible and can be edited to suit the requirements of your guests. The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateRoomRatesNL” | |
| HotelCode * | INT(11) | Unique hotel code generated in the system. | XXXX |
| AuthCode * | VARCHAR(300) | Unique code to enable the interface | XXXXXXXXXXXXXXXXX |
| Sources-> ContactId | VARCHAR(100) | Source Unique ID | 112500000000000001 |
| RateType -> RoomTypeID * | INT(20) | Unique RoomType ID | 112500000000000001 |
| RateType -> RateTypeID * | INT(20) | Unique RateType ID | 112500000000000001 |
| RateType -> FromDate * | DATETIME | Update From date. | 2020-06-25 |
| RateType -> ToDate * | DATETIME | Update To date | 2020-07-27 |
| RateType -> RoomRate -> Base * | DECIMAL(19,4) | Base rate amount | 4000, 1000 etc |
| RateType -> RoomRate -> ExtraAdult | DECIMAL(19,4) | Extra adult rate amount [optional] | 1000,800 etc |
| RateType -> RoomRate -> ExtraChild | DECIMAL(19,4) | Extra child rate amount [optional] | 500, 200 etc |
| RateType -> RoomRate -> Adult1 – Adult7 | DECIMAL(19,4) | Rate amount for upto 7 Adults [optional] | 500, 200 etc |
| RateType -> RoomRate -> Child1 – Child7 | DECIMAL(19,4) | Rate amount for upto 7 Childs [optional] | 500, 200 etc |
Request
{ "RES_Request": {
"Request_Type": "UpdateRoomRatesNL",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxx"
},
"Sources": {
"ContactId": [
"112400000000000873",
"112400000000000087"
]
},
"RateType": [
{
"RoomTypeID": "112400000000000003",
"RateTypeID": "112400000000000001",
"FromDate": "2019-08-07",
"ToDate": "2019-08-07",
"RoomRate": {
"Base": "300",
"ExtraAdult": "100",
"ExtraChild": "70",
"Adult1": "100",
"Adult2": "200",
"Adult3": "300",
"Adult4": "400",
"Adult5": "500",
"Adult6": "600",
"Adult7": "700",
"Child1": "100",
"Child2": "200",
"Child3": "300",
"Child4": "400",
"Child5": "500",
"Child6": "600",
"Child7": "700"
}
},
{
"RoomTypeID": "112400000000000002",
"RateTypeID": "112400000000000001",
"FromDate": "2019-08-07",
"ToDate": "2019-08-07",
"RoomRate": {
"Base": "300",
"ExtraAdult": "100",
"ExtraChild": "70",
"Adult1": "100",
"Adult2": "200",
"Adult3": "300",
"Adult4": "400",
"Adult5": "500",
"Adult6": "600",
"Adult7": "700",
"Child1": "100",
"Child2": "200",
"Child3": "300",
"Child4": "400",
"Child5": "500",
"Child6": "600",
"Child7": "700"
}
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response | Room Rates Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 104, 121 etc |
| Errors.ErrorMessage | – | Generate Response Message | No Rates to update |
Success
{ "Success": {
"SuccessMsg": " Room Rates Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error
{ "Errors": {
"ErrorCode": "301",
"ErrorMessage": "Unauthorized Request. Please check hotel code and authentication code"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 103 | Room type is missing |
| 104 | Rate type is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 113 | Invalid base rate |
| 114 | Invalid extra adult rate |
| 115 | Invalid extra child rate |
| 121 | No Rates to update |
| 135 | Invalid rate for any between adult1 to adult7 |
Rates & Availability
Update Linear Rate
This API provides a provision to set up linear rates for a specified date range in any property. You must specify property’s rates based on a combination of room type ID and rate type ID. In the linear pricing strategy, you can apply a linear rate to your base price.
Example : The base price of your room is $3000 for two adults and a child to stay in the room. If any of your guests want to use the same room with an extra adult and child, then the rate will increase by a fixed amount.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateRoomRates” | |
| HotelCode * | INT(11) | Unique hotel code generated in the system. | XXXX |
| AuthCode * | VARCHAR(300) | Unique code to enable the interface | XXXXXXXXXXXXXXXXX |
| Sources-> ContactId | VARCHAR(100) | Source Unique ID | 112500000000000001 |
| RateType -> RoomTypeID * | INT(20) | Unique RoomType ID | 112500000000000001 |
| RateType -> RateTypeID * | INT(20) | Unique RateType ID | 112500000000000001 |
| RateType -> FromDate * | DATETIME | Update From date. | 2020-06-25 |
| RateType -> ToDate * | DATETIME | Update To date | 2020-07-27 |
| RateType -> RoomRate -> Base * | DECIMAL(19,4) | Base rate amount | 4000, 1000 etc |
| RateType -> RoomRate -> ExtraAdult | DECIMAL(19,4) | Extra adult rate amount [optional] | 1000,800 etc |
| RateType -> RoomRate -> ExtraChild | DECIMAL(19,4) | Extra child rate amount [optional] | 500, 200 etc |
Request
{
"RES_Request": {
"Request_Type": "UpdateRoomRates",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxxxxxxx"
},
"Sources": {
"ContactId": [
"112400000000000873",
"112400000000000087"
]
},
"RateType": [
{
"RoomTypeID": "112400000000000003",
"RateTypeID": "112400000000000002",
"FromDate": "2019-06-20",
"ToDate": "2019-06-25",
"RoomRate": {
"Base": "159"
}
},
{
"RoomTypeID": "112400000000000003",
"RateTypeID": "112400000000000002",
"FromDate": "2019-06-02",
"ToDate": "2019-06-06",
"RoomRate": {
"Base": "159",
"ExtraAdult": "80",
"ExtraChild": "50"
}
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response | Room Rates Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 104, 113 etc |
| Errors.ErrorMessage | – | Generate Response Message | Invalid base rate |
Success
{ "Success": {
"SuccessMsg": "Room Rates Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error
{ "Errors": {
"ErrorCode": "301",
"ErrorMessage": "Unauthorized Request. Please check hotel code and authentication code"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 103 | Room type is missing |
| 104 | Rate type is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 113 | Invalid base rate |
| 114 | Invalid extra adult rate |
| 115 | Invalid extra child rate |
| 121 | No Rates to update |
Rates & Availability
Update Room Inventory
This API provides a provision to update Room(s) Inventory for the specified date range in any property. You must specify a property’s available inventory based on a room type ID. You can’t specify availability at rate plan level, even if the room type has multiple rates plans.
Example : If room type A is available 10 times, you can’t specify that it can be sold 3 times for rate plan X, and 7 times for rate plan Y. You can only specify the total availability for room type A as 10.
The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “UpdateAvailability” | |
| HotelCode * | INT(11) | Unique Hotel code | XXXX |
| AuthCode * | VARCHAR(300) | Unique Authentication code | XXXXXXXXXXXXXXXXX |
| RoomTypeID * | INT(20) | Unique RoomType ID | 112500000000000001 |
| FromDate * | DATETIME | Update From date. | 2020-07-25 |
| ToDate * | DATETIME | Update To date [Format: yyyy-mm-dd] | 2020-07-27 |
| Availability * | Integer | No. of Inv. Count | 5, 10 , 50 etc |
Request
{ "RES_Request": {
"Request_Type": "UpdateAvailability",
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxx"
},
"RoomType": [
{
"RoomTypeID": "112400000000000002",
"FromDate": "2019-06-24",
"ToDate": "2019-06-30",
"Availability": "9"
},
{
"RoomTypeID": "112400000000000002",
"FromDate": "2019-06-14",
"ToDate": "2019-06-20",
"Availability": "9"
}
]
}
}
Response
| Name | Data Type | Description | Example |
| Success.SuccessMsg | – | Generate Success Response | Room Inventory Successfully Updated |
| Errors.ErrorCode | – | Response Error Code | 301, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Update operation is not allowed |
Success
{ "Success": {
"SuccessMsg": "Room Inventory Successfully Updated"
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error
{ "Errors": {
"ErrorCode": "301",
"ErrorMessage": "Unauthorized Request. Please check hotel code and authentication code"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 103 | Room type is missing |
| 105 | From Date is missing |
| 106 | (From Date) – From Date is not a valid date |
| 107 | To Date is missing |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |
| 110 | Inventory value is missing |
| 111 | Invalid inventory value |
| 108 | (To Date) – To Date is not a valid date |
| 109 | From Date (From Date) To Date : (To Date) – Please check From and To date. To Date should be greater than fromdate |
| 134 | All Source(s) are using inventory of other source, thefore no update will be allowed. |
Configuration
Retrieve Room Information
This API provides room types, rate types and rate plans information for a property. The API can return data in JSON formats. The web service responds to HTTP POST requests.
End Point URL
Header
Parameter
| Name | Data Type | Description | Example |
| Request_Type * | – | Use Keyword “RoomInfo” | |
| NeedPhysicalRooms | INT(2) | If you need Room data, then put it “1”. It is optional | 1 / 0 |
| HotelCode * | INT(11) | Unique Hotel code | xxxx |
| AuthCode * | VARCHAR(300) | Unique Authentication code | xxxxxxxxxx |
Request
{
"RES_Request": {
"Request_Type": "RoomInfo",
"NeedPhysicalRooms":1,
"Authentication": {
"HotelCode": "xxxx",
"AuthCode": "xxxxxxxxxxxx"
}
}
}
Response
| Name | Data Type | Description | Example |
| RoomType.ID | Integer | Unique RoomType ID | 1234500000000000001 |
| RoomType.Name | String | RoomType Name | Garden View Studio Room |
| RoomType.Rooms. RoomID | Integer | Room Unique ID | 1234500000000000001 |
| RoomType.Rooms. RoomName | String | Room Number/Name | 101 |
| RateType.ID | Integer | Unique RateType ID | 1234500000000000001 |
| RateType.Name | String | RateType Name | European Plan |
| RatePlan.RatePlanID | Integer | Unique RatePlan ID | 1234500000000000001 |
| RatePlan.Name | String | RatePlan Name | Garden View Studio Room |
| RatePlan.RoomTypeID | Integer | RoomType ID | 1234500000000000001 |
| RatePlan.RoomType | String | RoomType Name | Garden View Studio Room |
| RatePlan.RateTypeID | Integer | RateType ID | 1234500000000000001 |
| RatePlan.RateType | String | RateType Name | European Plan |
| Errors.ErrorCode | – | Response Error Code | 301, 404 etc |
| Errors.ErrorMessage | – | Generate Response Message | Success, Unauthorized Request etc. |
Success
{ "RoomInfo": {
"RoomTypes": {
"RoomType": [
{
"ID": "1234500000000000001",
"Name": "Sea View Deluxe Room",
"Rooms": [
{
"RoomID": "1234500000000000001",
"RoomName": "101"
},
{
"RoomID": "1234500000000000002",
"RoomName": "102"
}
},
{
"ID": "1234500000000000002",
"Name": "Garden View Studio Room",
"Rooms": [
{
"RoomID": "1234500000000000004",
"RoomName": "201"
},
{
"RoomID": "1234500000000000005",
"RoomName": "202"
}
}
]
},
"RateTypes": {
"RateType": [
{
"ID": "1234500000000000001",
"Name": "European Plan"
},
{
"ID": "1234500000000000002",
"Name": "Continental Plan"
},
{
"ID": "1234500000000000005",
"Name": "Indian Plan"
}
]
},
"RatePlans": {
"RatePlan": [
{
"RatePlanID": "1234500000000000001",
"Name": "Sea View Deluxe Room",
"RoomTypeID": "1234500000000000001",
"RoomType": "Sea View Deluxe Room",
"RateTypeID": "1234500000000000001",
"RateType": "European Plan",
"RatePlanType": "INDEPENDENT"
},
{
"RatePlanID": "1234500000000000015",
"Name": "Garden View Studio Room",
"RoomTypeID": "1234500000000000002",
"RoomType": "Garden View Studio Room",
"RateTypeID": "1234500000000000001",
"RateType": "European Plan",
"RatePlanType": "MASTER"
}
]
}
},
"Errors": {
"ErrorCode": "0",
"ErrorMessage": "Success"
}
}
Error Codes
| Error Code | Error Name |
| 100 | Missing required parameters. |
| 500 | Error occurred during processing |
| 502 | Request Type is missing |
| 101 | Hotel Code is missing |
| 102 | Authentication Code is missing |
| 301 | Unauthorized Request. Please check hotel code and authentication code |
| 302 | Unauthorized Request. Integration is not allowed |
| 303 | Auth Code is inactive. |
| 201 | Unauthorized request.(Request Type) request is not valid for this hotel code |
| 202 | Unauthorized request. Hotel code is not active |