Booking multi-rooms is slightly different, so here's an end-to-end scenario to walk you through it.
Hilton’s API supports multi-room bookings (for non-GDS clients). This allows you to make a reservation for several rooms at a property.
To make a multi-room booking, first send a Single Property Shop request. Use the response to validate that inventory [numRoomsAvail] is sufficient for the number of rooms required for a specific room & rate. Then use the info received to populate your Reservation request for the rooms to be booked.
Several things to keep in mind…
- If any of the rooms fail to be booked then the entire reservation request will fail
- Each room in the multi-room request can be for different guest counts, room types
- The reservation response will contain a Confirmation # for the reservation, and an individual GNR # unique to each room (stay) within the reservation
- To modify or cancel a stay, both the Confirmation # and GNR # must be provided. You cannot modify/cancel multiple stays within the reservation within a single request. Please refer to the Make/Manage reservation examples
- A GET request can be made to return all stays within a reservation, or to retrieve a specific stay within a reservation
- Hilton currently does not support adding additional guest names to each stay on the sell request. You will need to modify each stay to add the guest name if you want to add specific names to each stay.
The tutorial below covers the following business scenario:
- Jane wishes to stay at a hotel in Chicago, IL. She needs two rooms. These are the tasks performed:
- Find Availablity
A single property shop request is sent. Room count on the request is not supplied. All available rooms will be returned allowing Jane to:
-Pick two of the same rooms (those that returned numRoomsAvail of at least 2)
-Pick two different rooms - Create Reservation
The details received in the single property shop are used to reserve two rooms by passing a roomStay element for each
- Find Availablity
These samples begin after the Access Token has been received. See the Authenticate Your App page for this sample.
Single Property Shop (Step 1)
POST https://kapip-s.hilton.io/hospitality-partner/v2/dcshop/props/CHIDT
Content-Type: application/json
accept: application/json
Authorization: "Basic YOUR_BASE64_ENCODED_CLIENTID:CLIENTSECRET"
Request Body:
{
"arrivalDate": "2020-11-26",
"departureDate": "2020-11-28",
"numAdults": 2,
"numChildren": 0,
"travelAgentId": "07518206",
"ratePlanCandidates": [
{
"ratePlanCategory": "corporate",
"ratePlanId": "FHR"
}
]
}
{
"adultAge": 18,
"ageBasedPricing": true,
"arrivalDate": "2020-11-26",
"brandCode": "DT",
"currencyCode": "USD",
"departureDate": "2020-11-28",
"highRate": 199.0,
"lengthOfStay": 2,
"lowRate": 114.08,
"numAdults": 2,
"propCode": "CHIDT",
"propName": "D TREE Chicago Ohare Rosemon",
"statusCode": 0,
"clientAccounts": {
"0560079228": {
"clientId": "0560079228",
"clientName": "Corporate Account Name ABC",
"clientRatePlanFound": true,
"clientType": "corporate"
},
"0009876464": {
"clientId": "0009876464",
"clientName": "FHR",
"clientRatePlanFound": false,
"clientType": "corporate"
},
"0007518206": {
"clientId": "0007518206",
"clientName": "AAA COMMISSIONABLE RATE",
"clientType": "travelAgent"
}
},
"ratePlans": {
"LDT3XF": {
"clientIdRequired": true,
"commissionable": false,
"currencyCode": "USD",
"cxlPolicyCode": "04D",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "4 DAY CANCELLATION REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "GTD",
"guarPolicyDesc": "Hold for Arrival",
"highRate": 168.78,
"lowRate": 120.28,
"ratePlanCode": "LDT3XF",
"ratePlanOrder": 1,
"serviceChargesAndTaxesIncluded": false,
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"Corp Negotiated ST SEMI FLEX"
]
},
"SDTAH1": {
"clientIdRequired": true,
"commissionable": false,
"currencyCode": "USD",
"cxlPolicyCode": "NCXL",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "NON-CANCELABLE",
"displayCurrency": "USD",
"guarPolicyCode": "6PM",
"guarPolicyDesc": "HOLD UNTIL 6PM",
"highRate": 160.08,
"lowRate": 114.08,
"ratePlanCode": "SDTAH1",
"ratePlanOrder": 6,
"serviceChargesAndTaxesIncluded": false,
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"EXP HRN NREF"
]
},
"LDTAO1": {
"clientIdRequired": true,
"commissionable": false,
"currencyCode": "USD",
"cxlPolicyCode": "24H",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "24 HR CANCEL REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "6PM",
"guarPolicyDesc": "HOLD UNTIL 6PM",
"highRate": 199.0,
"lowRate": 149.0,
"ratePlanCode": "LDTAO1",
"ratePlanOrder": 3,
"serviceChargesAndTaxesIncluded": false,
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"EXP HRN BED BKFST VP"
]
},
"SDTXBB": {
"clientIdRequired": true,
"commissionable": true,
"commissionAmount": 10.0,
"currencyCode": "USD",
"cxlPolicyCode": "48H",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "48 HR CANCELLATION REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "GTD",
"guarPolicyDesc": "Hold for Arrival",
"highRate": 199.0,
"lowRate": 149.0,
"ratePlanCode": "SDTXBB",
"ratePlanOrder": 7,
"serviceChargesAndTaxesIncluded": false,
"commissionType": "percent",
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"Corp BB",
"HRCC OR HOTELS",
"DO NOT MODIFY ADJUST OR CANCEL"
]
},
"SDTXR1": {
"clientIdRequired": true,
"commissionable": true,
"commissionAmount": 13.5,
"currencyCode": "USD",
"cxlPolicyCode": "24H",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "24 HR CANCEL REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "GTD",
"guarPolicyDesc": "Hold for Arrival",
"highRate": 174.0,
"lowRate": 124.0,
"ratePlanCode": "SDTXR1",
"ratePlanOrder": 8,
"serviceChargesAndTaxesIncluded": false,
"commissionType": "percent",
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"CORP RETAIL"
]
},
"SDTAC1": {
"clientIdRequired": true,
"commissionable": false,
"currencyCode": "USD",
"cxlPolicyCode": "48H",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "48 HR CANCELLATION REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "GTD",
"guarPolicyDesc": "Hold for Arrival",
"highRate": 174.0,
"lowRate": 124.0,
"ratePlanCode": "SDTAC1",
"ratePlanOrder": 4,
"serviceChargesAndTaxesIncluded": false,
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"EXP HRN VAC PKG"
]
},
"SDTAD1": {
"clientIdRequired": true,
"commissionable": false,
"currencyCode": "USD",
"cxlPolicyCode": "48H",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "48 HR CANCELLATION REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "GTD",
"guarPolicyDesc": "Hold for Arrival",
"highRate": 174.0,
"lowRate": 124.0,
"ratePlanCode": "SDTAD1",
"ratePlanOrder": 5,
"serviceChargesAndTaxesIncluded": false,
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"EXP HRN RM ONLY"
]
},
"LDTAK1": {
"clientIdRequired": true,
"commissionable": false,
"currencyCode": "USD",
"cxlPolicyCode": "48H",
"cxlPolicyDeadline": "2023-10-19T05:00:00Z",
"cxlPolicyLocalDeadline": "2023-10-06T23:59",
"cxlPolicyDesc": "48 HR CANCELLATION REQUIRED",
"displayCurrency": "USD",
"guarPolicyCode": "6PM",
"guarPolicyDesc": "HOLD UNTIL 6PM",
"highRate": 199.0,
"lowRate": 149.0,
"ratePlanCode": "LDTAK1",
"ratePlanOrder": 2,
"serviceChargesAndTaxesIncluded": false,
"ratePlanCategory": "corporate",
"clientIds": [
"0560079228"
],
"guaranteeMethods": [
"TA",
"CC",
"CR",
"CD",
"FP"
],
"ratePlanDesc": [
"EXP HRN BED BKFST RO"
]
}
},
"roomTypes": {
"NKRCZ": {
"adaAccessibleRoom": false,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 50,
"roomOccupancy": 4,
"roomTypeCode": "NKRCZ",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1 KING YOGA RM W/EXTRA SPACE/YOGA EQUIPMENT",
"JALA MAT-CORK BRICKS-STRETCH STRAP-FOAM ROLLR",
"STABILITY BALL-ON DEMAND YOGA CONTENT ON TV"
]
},
"NK1D": {
"adaAccessibleRoom": false,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 30,
"roomOccupancy": 4,
"roomTypeCode": "NK1D",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1 KING BED CORNER ROOM-SOFABED-NONSMOKING",
"457 SQ FT - MINI-FRIDGE -INTERNET 12.95/DAY",
"FLAT SCREEN TV - SEPARATE SHOWER/TUB"
]
},
"NKRCX": {
"adaAccessibleRoom": false,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 40,
"roomOccupancy": 4,
"roomTypeCode": "NKRCX",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1 KING CARDIO ROOM W/PRECOR TRAINER",
"CUSTOM WORK BENCH-HAND WEIGHTS-STRETCH MAT",
"RESIST BANDS-STABLTY BALL-ON DEMAND TV CONTNT"
]
},
"NKRQF": {
"adaAccessibleRoom": true,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 998,
"roomOccupancy": 4,
"roomTypeCode": "NKRQF",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1KG MOBILITY/HEARING ACCESS 3X3SHW NO SMOK",
"VIS FIREALRM/DOOR/PHN ALRT",
"MINI-FRIDGE-INTERNET 12.95/DAY-FLAT SCRN TV"
]
},
"NK1": {
"adaAccessibleRoom": false,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 20,
"roomOccupancy": 4,
"roomTypeCode": "NK1",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1 KING W-SOFABED 275 SQ FT NON SMOKING",
"MINI-FRIDGE-INTERNET 12.95/DAY-FLAT SCRN TV",
"SEPARATE SHOWER/TUB"
]
},
"NKRQG": {
"adaAccessibleRoom": true,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 998,
"roomOccupancy": 4,
"roomTypeCode": "NKRQG",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1 KING HEARING ACCESSIBLE NO SMOK",
"VIS FIREALRM/DOOR/PHN ALRT",
"MINI-FRIDGE-INTERNET 12.95/DAY-FLAT SCRN TV"
]
},
"NKRQD": {
"adaAccessibleRoom": true,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 1,
"roomDisplayOrder": 998,
"roomOccupancy": 4,
"roomTypeCode": "NKRQD",
"smokingRoom": false,
"bedType": "king",
"roomTypeDesc": [
"1 KING MOBILITY/HEARING ACCESS TUB NO SMOK",
"VIS FIREALRM/DOOR/PHN ALRT",
"MINI-FRIDGE-INTERNET 12.95/DAY-FLAT SCRN TV"
]
},
"ND2": {
"adaAccessibleRoom": false,
"extraBedPermitted": false,
"extraPersonsAllowed": false,
"numBeds": 2,
"roomDisplayOrder": 10,
"roomOccupancy": 4,
"roomTypeCode": "ND2",
"smokingRoom": false,
"bedType": "double",
"roomTypeDesc": [
"2 DOUBLE BEDS 320 SQ FT NON SMOKING",
"MINI-FRIDGE-INTERNET 12.95/DAY-FLAT SCRN TV",
"SEPARATE SHOWER/TUB -BLACKOUT CURTAINS"
]
}
},
"roomRates": [
{
"amountAfterTax": 274.24,
"amountBeforeTax": 240.56,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 9,
"rateAmount": 120.28,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "ND2",
"totalServiceCharges": 0.0,
"totalTaxes": 33.68,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 121.52,
"rate2Person": 121.52,
"rate3Person": 131.32,
"rate4Person": 141.12,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 119.04,
"rate2Person": 119.04,
"rate3Person": 128.64,
"rate4Person": 138.24,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 274.24,
"amountBeforeTax": 240.56,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 9,
"rateAmount": 120.28,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NK1",
"totalServiceCharges": 0.0,
"totalTaxes": 33.68,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 121.52,
"rate2Person": 121.52,
"rate3Person": 131.32,
"rate4Person": 141.12,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 119.04,
"rate2Person": 119.04,
"rate3Person": 128.64,
"rate4Person": 138.24,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 384.82,
"amountBeforeTax": 337.56,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 6,
"rateAmount": 168.78,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NK1D",
"totalServiceCharges": 0.0,
"totalTaxes": 47.26,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 170.52,
"rate2Person": 170.52,
"rate3Person": 180.32,
"rate4Person": 190.12,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 167.04,
"rate2Person": 167.04,
"rate3Person": 176.64,
"rate4Person": 186.24,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 318.47,
"amountBeforeTax": 279.36,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 1,
"rateAmount": 139.68,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NKRCX",
"totalServiceCharges": 0.0,
"totalTaxes": 39.11,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 141.12,
"rate2Person": 141.12,
"rate3Person": 150.92,
"rate4Person": 160.72,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 138.24,
"rate2Person": 138.24,
"rate3Person": 147.84,
"rate4Person": 157.44,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 318.47,
"amountBeforeTax": 279.36,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 1,
"rateAmount": 139.68,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NKRCZ",
"totalServiceCharges": 0.0,
"totalTaxes": 39.11,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 141.12,
"rate2Person": 141.12,
"rate3Person": 150.92,
"rate4Person": 160.72,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 138.24,
"rate2Person": 138.24,
"rate3Person": 147.84,
"rate4Person": 157.44,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 274.24,
"amountBeforeTax": 240.56,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 4,
"rateAmount": 120.28,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NKRQD",
"totalServiceCharges": 0.0,
"totalTaxes": 33.68,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 121.52,
"rate2Person": 121.52,
"rate3Person": 131.32,
"rate4Person": 141.12,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 119.04,
"rate2Person": 119.04,
"rate3Person": 128.64,
"rate4Person": 138.24,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 274.24,
"amountBeforeTax": 240.56,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 8,
"rateAmount": 120.28,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NKRQF",
"totalServiceCharges": 0.0,
"totalTaxes": 33.68,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 121.52,
"rate2Person": 121.52,
"rate3Person": 131.32,
"rate4Person": 141.12,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 119.04,
"rate2Person": 119.04,
"rate3Person": 128.64,
"rate4Person": 138.24,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 274.24,
"amountBeforeTax": 240.56,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 8,
"rateAmount": 120.28,
"rateChangeIndicator": true,
"ratePlanCode": "LDT3XF",
"rollawayRate": 0.0,
"roomTypeCode": "NKRQG",
"totalServiceCharges": 0.0,
"totalTaxes": 33.68,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 121.52,
"rate2Person": 121.52,
"rate3Person": 131.32,
"rate4Person": 141.12,
"rollawayRate": 0.0
},
{
"cribRate": 0.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 119.04,
"rate2Person": 119.04,
"rate3Person": 128.64,
"rate4Person": 138.24,
"rollawayRate": 0.0
}
]
},
{
"amountAfterTax": 282.72,
"amountBeforeTax": 248.0,
"cribRate": 0.0,
"depositAmount": 0.0,
"numRoomsAvail": 8,
"rateAmount": 124.0,
"rateChangeIndicator": false,
"ratePlanCode": "SDTAD1",
"rollawayRate": 0.0,
"roomTypeCode": "NKRQF",
"totalServiceCharges": 0.0,
"totalTaxes": 34.72,
"meals": {
"mealPlan": "N"
},
"rateDetails": [
{
"cribRate": 0.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 124.0,
"rate2Person": 124.0,
"rate3Person": 134.0,
"rate4Person": 144.0,
"rollawayRate": 0.0
}
]
}
],
"taxPeriods": [
{
"effectiveDate": "2020-11-26",
"taxes": [
{
"amount": 14.0,
"basis": "perRoom",
"period": "perNight",
"type": "percent"
}
]
}
]
}
Multi-room Reservation (Step 2)
The below example request and response are for a two (2) room reservation with different products. Note that the response contains the overall reservation Confirmation # and a GNR # for each stay (i.e., room).
POST https://kapip-s.hilton.io/hospitality-partner/v2/dcres
Content-Type: application/json
accept: application/json
Authorization: "Basic YOUR_BASE64_ENCODED_CLIENTID:CLIENTSECRET"
Request Body:
{
"propCode": "CHIDT",
"guest": {
"name": {
"firstName": "TestFirst",
"lastName": "TestLast"
},
"addresses": [
{
"addressType": "home",
"addressLine1": "123 Main St",
"city": "Reno",
"country": "US",
"postalCode": "123456",
"state": "NV"
}
],
"phones": [
{
"phoneType": "home",
"phoneNumber": "123456789"
}
],
"emails": [
{
"emailAddress": "test@test.com",
"emailType": "home"
}
]
},
"roomStays": [
{
"arrivalDate": "2020-11-26",
"departureDate": "2020-11-28",
"numAdults": 2,
"numChildren": 0,
"roomTypeCode": "ND2",
"ratePlanCode": "LDT3XF"
},
{
"arrivalDate": "2020-11-26",
"departureDate": "2020-11-28",
"numAdults": 2,
"numChildren": 1,
"roomTypeCode": "NK1D",
"ratePlanCode": "SDTAH1"
}
],
"guarantee": {
"guarMethodCode": "CC",
"paymentCard": {
"cardNumber": "4411441144114411",
"cardCode": "VI",
"cardExpireDate": "1120"
}
},
"comments": [
"Test comments ABC,"
],
"externalResId": "324725898",
"clientAccounts": [
{
"clientId": "0560079228",
"clientType": "corporate"
},
{
"clientId": "0007723203",
"clientType": "travelAgent"
}
]
}
[
{
"adultAge": 18,
"ageBasedPricing": true,
"arrivalDate": "2020-11-26",
"confNumber": "86239068",
"departureDate": "2020-11-28",
"externalResId": "324725898",
"gnrNumber": 77549783,
"numAdults": 2,
"numRooms": 1,
"propCode": "CHIDT",
"resCreateDate": "2020-09-01T20:34:21Z",
"cost": {
"amountAfterTax": 274.24,
"amountBeforeTax": 240.56,
"currencyCode": "USD",
"serviceChargesInTaxCalc": false,
"totalServiceCharges": 0.0,
"totalTaxes": 33.68,
"meals": {
"mealPlan": "N",
"mealPlanDesc": "None"
},
"rateDetails": [
{
"cribRate": 0.0,
"discountAmount": 2.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 121.52,
"rate2Person": 121.52,
"rate3Person": 131.32,
"rate4Person": 141.12,
"rollawayRate": 0.0,
"roomRate": 121.52,
"discountType": "percentOff",
"taxes": [
{
"amount": 14.0,
"basis": "perRoom",
"period": "perNight",
"type": "percent"
}
]
},
{
"cribRate": 0.0,
"discountAmount": 4.0,
"effectiveDate": "2020-11-27",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 119.04,
"rate2Person": 119.04,
"rate3Person": 128.64,
"rate4Person": 138.24,
"rollawayRate": 0.0,
"roomRate": 119.04,
"discountType": "percentOff",
"taxes": [
{
"amount": 14.0,
"basis": "perRoom",
"period": "perNight",
"type": "percent"
}
]
}
]
},
"guarantee": {
"cxlPolicyCode": "04D",
"cxlPolicyDesc": "4 DAY CANCELLATION REQUIRED",
"guarMethodCode": "CC",
"guarMethodDesc": "GUARANTEED BY CREDIT CARD",
"guarPolicyCode": "GTD",
"guarPolicyDesc": "Hold for Arrival",
"paymentCard": {
"cardCode": "VS",
"cardExpireDate": "1120",
"cardNumber": "8041804116964411"
}
},
"guest": {
"name": {
"firstName": "TestFirst",
"lastName": "TestLast"
},
"addresses": [
{
"addressLine1": "123 Main St",
"city": "Reno",
"country": "US",
"postalCode": "123456",
"state": "NV",
"addressType": "home"
},
{
"addressLine1": "PO BOX 915204",
"city": "DALLAS",
"company": "PRICELINE",
"country": "US",
"postalCode": "75391-0001",
"state": "TX",
"addressType": "travel"
},
{
"addressLine1": "UNKNOWN",
"city": "X",
"company": "OTA COM DIRECT CONNECT",
"country": "US",
"postalCode": "00000",
"state": "XX",
"addressType": "business"
}
],
"emails": [
{
"emailAddress": "test@test.com",
"emailType": "home"
}
],
"phones": [
{
"phoneNumber": "123456789",
"phoneType": "home"
},
{
"phoneNumber": "12032998000",
"phoneType": "travel"
},
{
"phoneNumber": "12032998970",
"phoneType": "fax"
}
]
},
"ratePlan": {
"advancePurchase": false,
"ratePlanCode": "LDT3XF",
"ratePlanName": "OTA ST SEMI FLEX",
"serviceChargesAndTaxesIncluded": false
},
"roomType": {
"extraBedPermitted": false,
"roomOccupancy": 4,
"roomTypeCode": "ND2",
"smokingRoom": false,
"roomTypeDesc": [
"2 DOUBLE BEDS NONSMOKING"
]
},
"comments": [
"Test comments ABC,"
],
"bookingMessages": [
{
"endDate": "2173-10-14",
"message": "GUEST MUST BE 21 YEARS OF AGE OR OLDER TO CHECK IN",
"startDate": "2013-03-11"
},
{
"endDate": "2173-10-14",
"message": "HOTEL HAS SHIPPING FEES. CONTACT PROPERTY FOR PRICING.",
"startDate": "2016-11-09"
},
{
"endDate": "2173-10-14",
"message": "FYI: INTERNATIONAL ARRIVALS MUST CALL FOR SHUTTLE PICK UP",
"startDate": "2018-01-18"
},
{
"endDate": "2173-10-14",
"message": "FYI: SELF PARKING $29.00, VALET PARKING $35.00",
"startDate": "2018-01-18"
}
],
"clientAccounts": [
{
"clientId": "0560079228",
"clientName": "OTA COM DIRECT CONNECT",
"clientType": "corporate"
},
{
"clientId": "0007723203",
"clientName": "OTA Name",
"clientType": "travelAgent"
}
]
},
{
"arrivalDate": "2020-11-26",
"confNumber": "86239068",
"departureDate": "2020-11-28",
"externalResId": "324725898",
"gnrNumber": 77549784,
"numAdults": 2,
"numChildren": 1,
"numRooms": 1,
"propCode": "CHIDT",
"resCreateDate": "2020-09-01T20:34:22Z",
"cost": {
"amountAfterTax": 364.98,
"amountBeforeTax": 320.16,
"currencyCode": "USD",
"serviceChargesInTaxCalc": false,
"totalServiceCharges": 0.0,
"totalTaxes": 44.82,
"meals": {
"mealPlan": "N",
"mealPlanDesc": "None"
},
"rateDetails": [
{
"cribRate": 0.0,
"discountAmount": 8.0,
"effectiveDate": "2020-11-26",
"extraChildRate": 0.0,
"extraPersonRate": 0.0,
"rate1Person": 160.08,
"rate2Person": 160.08,
"rate3Person": 169.28,
"rate4Person": 178.48,
"rollawayRate": 0.0,
"roomRate": 160.08,
"discountType": "percentOff",
"taxes": [
{
"amount": 14.0,
"basis": "perRoom",
"period": "perNight",
"type": "percent"
}
]
}
]
},
"guarantee": {
"cxlPolicyCode": "NCXL",
"cxlPolicyDesc": "NON-CANCELABLE",
"guarMethodCode": "CC",
"guarMethodDesc": "GUARANTEED BY CREDIT CARD",
"guarPolicyCode": "6PM",
"guarPolicyDesc": "HOLD UNTIL 6PM",
"paymentCard": {
"cardCode": "VS",
"cardExpireDate": "1120",
"cardNumber": "8041804116964411"
}
},
"guest": {
"name": {
"firstName": "TestFirst",
"lastName": "TestLast"
},
"addresses": [
{
"addressLine1": "123 Main St",
"city": "Reno",
"country": "US",
"postalCode": "123456",
"state": "NV",
"addressType": "home"
},
{
"addressLine1": "PO BOX 915204",
"city": "DALLAS",
"company": "PRICELINE",
"country": "US",
"postalCode": "75391-0001",
"state": "TX",
"addressType": "travel"
},
{
"addressLine1": "UNKNOWN",
"city": "X",
"company": "OTA COM DIRECT CONNECT",
"country": "US",
"postalCode": "00000",
"state": "XX",
"addressType": "business"
}
],
"emails": [
{
"emailAddress": "test@test.com",
"emailType": "home"
}
],
"phones": [
{
"phoneNumber": "123456789",
"phoneType": "home"
},
{
"phoneNumber": "12032998000",
"phoneType": "travel"
},
{
"phoneNumber": "12032998970",
"phoneType": "fax"
}
]
},
"ratePlan": {
"advancePurchase": false,
"ratePlanCode": "SDTAH1",
"ratePlanName": "BEST AVAILABLE RATE",
"serviceChargesAndTaxesIncluded": false
},
"roomType": {
"extraBedPermitted": false,
"roomOccupancy": 4,
"roomTypeCode": "NK1D",
"smokingRoom": false,
"roomTypeDesc": [
"1 KING CORNER ROOM NONSMOK"
]
},
"comments": [
"Test comments ABC,"
],
"bookingMessages": [
{
"endDate": "2173-10-14",
"message": "GUEST MUST BE 21 YEARS OF AGE OR OLDER TO CHECK IN",
"startDate": "2013-03-11"
},
{
"endDate": "2173-10-14",
"message": "HOTEL HAS SHIPPING FEES. CONTACT PROPERTY FOR PRICING.",
"startDate": "2016-11-09"
},
{
"endDate": "2173-10-14",
"message": "FYI: INTERNATIONAL ARRIVALS MUST CALL FOR SHUTTLE PICK UP",
"startDate": "2018-01-18"
},
{
"endDate": "2173-10-14",
"message": "FYI: SELF PARKING $29.00, VALET PARKING $35.00",
"startDate": "2018-01-18"
}
],
"clientAccounts": [
{
"clientId": "0560079228",
"clientName": "OTA COM DIRECT CONNECT",
"clientType": "corporate"
},
{
"clientId": "0007723203",
"clientName": "OTA Name",
"clientType": "travelAgent"
}
]
}
]