Chilkat Online Tools

unicodeC / ORACLE Hospitality OPERA Cloud REST API Workflows / Create a new reservation

Back to Collection Items

#include <C_CkHttpW.h>
#include <C_CkJsonObjectW.h>
#include <C_CkHttpResponseW.h>

void ChilkatSample(void)
    {
    HCkHttpW http;
    BOOL success;
    HCkJsonObjectW json;
    HCkHttpResponseW resp;

    // This example assumes the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    http = CkHttpW_Create();

    // Use this online tool to generate code from sample JSON: Generate Code to Create JSON

    // The following JSON is sent in the request body.

    // {
    //   "reservations": {
    //     "reservation": [
    //       {
    //         "sourceOfSale": {
    //           "sourceType": "PMS",
    //           "sourceCode": "{{HotelId}}"
    //         },
    //         "roomStay": {
    //           "roomRates": [
    //             {
    //               "total": {
    //                 "amountBeforeTax": "200"
    //               },
    //               "rates": {
    //                 "rate": [
    //                   {
    //                     "base": {
    //                       "amountBeforeTax": "200",
    //                       "currencyCode": "USD"
    //                     },
    //                     "shareDistributionInstruction": "Full",
    //                     "total": {
    //                       "amountBeforeTax": "200"
    //                     },
    //                     "start": "{{currentdate}}",
    //                     "end": "{{currentdateplus1}}"
    //                   }
    //                 ]
    //               },
    //               "guestCounts": {
    //                 "adults": "1",
    //                 "children": "0"
    //               },
    //               "roomType": "{{RoomTypeCode}}",
    //               "ratePlanCode": "{{RatePlanCode}}",
    //               "start": "{{currentdate}}",
    //               "end": "{{currentdateplus1}}",
    //               "suppressRate": true,
    //               "marketCode": "LEISURE",
    //               "marketCodeDescription": "Leisure",
    //               "sourceCode": "PHONE",
    //               "sourceCodeDescription": "Over the Phone",
    //               "numberOfUnits": "1",
    //               "pseudoRoom": false,
    //               "roomTypeCharged": "{{RoomTypeCode}}",
    //               "houseUseOnly": false,
    //               "complimentary": false,
    //               "fixedRate": true,
    //               "discountAllowed": false,
    //               "bogoDiscount": false
    //             }
    //           ],
    //           "guestCounts": {
    //             "adults": "1",
    //             "children": "0"
    //           },
    //           "arrivalDate": "{{currentdate}}",
    //           "departureDate": "{{currentdateplus1}}",
    //           "guarantee": {
    //             "guaranteeCode": "6PM",
    //             "shortDescription": "6PM Hold"
    //           },
    //           "roomNumberLocked": false,
    //           "printRate": false
    //         },
    //         "reservationGuests": [
    //           {
    //             "profileInfo": {
    //               "profile": {
    //                 "customer": {
    //                   "personName": [
    //                     {
    //                       "givenName": "Jane",
    //                       "surname": "Smith",
    //                       "nameType": "Primary"
    //                     },
    //                     {
    //                       "nameType": "External"
    //                     }
    //                   ],
    //                   "language": "E"
    //                 },
    //                 "profileType": "Guest"
    //               }
    //             },
    //             "primary": true
    //           }
    //         ],
    //         "reservationPaymentMethods": [
    //           {
    //             "paymentMethod": "CA",
    //             "folioView": "1"
    //           }
    //         ],
    //         "comments": [
    //           {
    //             "comment": {
    //               "text": {
    //                 "value": "Please ensure I have tea in my room"
    //               },
    //               "commentTitle": "General Notes",
    //               "notificationLocation": "RESERVATION",
    //               "type": "GEN",
    //               "internal": false
    //             }
    //           }
    //         ],
    //         "hotelId": "{{HotelId}}",
    //         "roomStayReservation": true,
    //         "reservationStatus": "Reserved",
    //         "computedReservationStatus": "DueIn",
    //         "walkIn": false,
    //         "printRate": false,
    //         "preRegistered": false,
    //         "upgradeEligible": false,
    //         "allowAutoCheckin": false,
    //         "hasOpenFolio": false,
    //         "allowMobileCheckout": false,
    //         "allowMobileViewFolio": false,
    //         "allowPreRegistration": false,
    //         "optedForCommunication": false
    //       }
    //     ]
    //   }
    // }

    json = CkJsonObjectW_Create();
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].sourceOfSale.sourceType",L"PMS");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].sourceOfSale.sourceCode",L"{{HotelId}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].total.amountBeforeTax",L"200");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].base.amountBeforeTax",L"200");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].base.currencyCode",L"USD");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].shareDistributionInstruction",L"Full");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].total.amountBeforeTax",L"200");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].start",L"{{currentdate}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].rates.rate[0].end",L"{{currentdateplus1}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].guestCounts.adults",L"1");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].guestCounts.children",L"0");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].roomType",L"{{RoomTypeCode}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].ratePlanCode",L"{{RatePlanCode}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].start",L"{{currentdate}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].end",L"{{currentdateplus1}}");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].suppressRate",TRUE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].marketCode",L"LEISURE");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].marketCodeDescription",L"Leisure");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].sourceCode",L"PHONE");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].sourceCodeDescription",L"Over the Phone");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].numberOfUnits",L"1");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].pseudoRoom",FALSE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.roomRates[0].roomTypeCharged",L"{{RoomTypeCode}}");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].houseUseOnly",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].complimentary",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].fixedRate",TRUE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].discountAllowed",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomRates[0].bogoDiscount",FALSE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.guestCounts.adults",L"1");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.guestCounts.children",L"0");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.arrivalDate",L"{{currentdate}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.departureDate",L"{{currentdateplus1}}");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.guarantee.guaranteeCode",L"6PM");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].roomStay.guarantee.shortDescription",L"6PM Hold");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.roomNumberLocked",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStay.printRate",FALSE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[0].givenName",L"Jane");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[0].surname",L"Smith");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[0].nameType",L"Primary");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.personName[1].nameType",L"External");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationGuests[0].profileInfo.profile.customer.language",L"E");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationGuests[0].profileInfo.profile.profileType",L"Guest");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].reservationGuests[0].primary",TRUE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationPaymentMethods[0].paymentMethod",L"CA");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationPaymentMethods[0].folioView",L"1");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].comments[0].comment.text.value",L"Please ensure I have tea in my room");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].comments[0].comment.commentTitle",L"General Notes");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].comments[0].comment.notificationLocation",L"RESERVATION");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].comments[0].comment.type",L"GEN");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].comments[0].comment.internal",FALSE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].hotelId",L"{{HotelId}}");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].roomStayReservation",TRUE);
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].reservationStatus",L"Reserved");
    CkJsonObjectW_UpdateString(json,L"reservations.reservation[0].computedReservationStatus",L"DueIn");
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].walkIn",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].printRate",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].preRegistered",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].upgradeEligible",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].allowAutoCheckin",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].hasOpenFolio",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].allowMobileCheckout",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].allowMobileViewFolio",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].allowPreRegistration",FALSE);
    CkJsonObjectW_UpdateBool(json,L"reservations.reservation[0].optedForCommunication",FALSE);

    CkHttpW_SetRequestHeader(http,L"Content-Type",L"application/json");
    CkHttpW_SetRequestHeader(http,L"x-hotelid",L"{{HotelId}}");
    // Adds the "Authorization: Bearer <access_token>" header.
    CkHttpW_putAuthToken(http,L"<access_token>");
    CkHttpW_SetRequestHeader(http,L"x-app-key",L"{{AppKey}}");

    resp = CkHttpW_PostJson3(http,L"https://domain.com/rsv/v1/hotels/{{HotelId}}/reservations/",L"application/json",json);
    if (CkHttpW_getLastMethodSuccess(http) == FALSE) {
        wprintf(L"%s\n",CkHttpW_lastErrorText(http));
        CkHttpW_Dispose(http);
        CkJsonObjectW_Dispose(json);
        return;
    }

    wprintf(L"%d\n",CkHttpResponseW_getStatusCode(resp));
    wprintf(L"%s\n",CkHttpResponseW_bodyStr(resp));
    CkHttpResponseW_Dispose(resp);


    CkHttpW_Dispose(http);
    CkJsonObjectW_Dispose(json);

    }

Curl Command

curl -X POST
	-H "Authorization: Bearer <access_token>"
	-H "Content-Type: application/json"
	-H "x-hotelid: {{HotelId}}"
	-H "x-app-key: {{AppKey}}"
	-d '{
    "reservations": {
        "reservation": [
            {
                "sourceOfSale": {
                    "sourceType": "PMS",
                    "sourceCode": "{{HotelId}}"
                },
                "roomStay": {
                    "roomRates": [
                        {
                            "total": {
                                "amountBeforeTax": "200"
                            },
                            "rates": {
                                "rate": [
                                    {
                                        "base": {
                                            "amountBeforeTax": "200",
                                            "currencyCode": "USD"
                                        },
                                        "shareDistributionInstruction": "Full",
                                        "total": {
                                            "amountBeforeTax": "200"
                                        },
                                        "start": "{{currentdate}}",
                                        "end": "{{currentdateplus1}}"
                                    }
                                ]
                            },
                            "guestCounts": {
                                "adults": "1",
                                "children": "0"
                            },
                            "roomType": "{{RoomTypeCode}}",
                            "ratePlanCode": "{{RatePlanCode}}",
                            "start": "{{currentdate}}",
                            "end": "{{currentdateplus1}}",
                            "suppressRate": true,
                            "marketCode": "LEISURE",
                            "marketCodeDescription": "Leisure",
                            "sourceCode": "PHONE",
                            "sourceCodeDescription": "Over the Phone",
                            "numberOfUnits": "1",
                            "pseudoRoom": false,
                            "roomTypeCharged": "{{RoomTypeCode}}",
                            "houseUseOnly": false,
                            "complimentary": false,
                            "fixedRate": true,
                            "discountAllowed": false,
                            "bogoDiscount": false
                        }
                    ],
                    "guestCounts": {
                        "adults": "1",
                        "children": "0"
                    },
                    "arrivalDate": "{{currentdate}}",
                    "departureDate": "{{currentdateplus1}}",
                    "guarantee": {
                        "guaranteeCode": "6PM",
                        "shortDescription": "6PM Hold"
                    },
                    "roomNumberLocked": false,
                    "printRate": false
                },
                "reservationGuests": [
                    {
                        "profileInfo": {
                            "profile": {
                                "customer": {
                                    "personName": [
                                        {
                                            "givenName": "Jane",
                                            "surname": "Smith",
                                            "nameType": "Primary"
                                        },
                                        {
                                            "nameType": "External"
                                        }
                                    ],
                                    "language": "E"
                                },
                                "profileType": "Guest"
                            }
                        },
                        "primary": true
                    }
                ],
               "reservationPaymentMethods": [
                    {
                        "paymentMethod": "CA",
                        "folioView": "1"
                    }
                ],
                "comments": [
                    {
                        "comment": {
                            "text": {
                                "value": "Please ensure I have tea in my room"
                            },
                            "commentTitle": "General Notes",
                            "notificationLocation": "RESERVATION",
                            "type": "GEN",
                            "internal": false
                        }
                    }
                ],
                "hotelId": "{{HotelId}}",
                "roomStayReservation": true,
                "reservationStatus": "Reserved",
                "computedReservationStatus": "DueIn",
                "walkIn": false,
                "printRate": false,
                "preRegistered": false,
                "upgradeEligible": false,
                "allowAutoCheckin": false,
                "hasOpenFolio": false,
                "allowMobileCheckout": false,
                "allowMobileViewFolio": false,
                "allowPreRegistration": false,
                "optedForCommunication": false
            }
        ]
    }
}'
https://domain.com/rsv/v1/hotels/{{HotelId}}/reservations/

Postman Collection Item JSON

{
  "name": "Create a new reservation",
  "event": [
    {
      "listen": "test",
      "script": {
        "exec": [
          "var data = pm.response.headers.get(\"Location\").split(\"/\").pop();\r",
          "postman.setEnvironmentVariable(\"ReservationId\", data);"
        ],
        "type": "text/javascript"
      }
    }
  ],
  "request": {
    "auth": {
      "type": "bearer",
      "bearer": [
        {
          "key": "token",
          "value": "{{Token}}",
          "type": "string"
        }
      ]
    },
    "method": "POST",
    "header": [
      {
        "key": "Content-Type",
        "name": "Content-Type",
        "type": "text",
        "value": "application/json"
      },
      {
        "key": "x-hotelid",
        "type": "text",
        "value": "{{HotelId}}"
      },
      {
        "key": "x-app-key",
        "value": "{{AppKey}}",
        "type": "text"
      }
    ],
    "body": {
      "mode": "raw",
      "raw": "{\r\n    \"reservations\": {\r\n        \"reservation\": [\r\n            {\r\n                \"sourceOfSale\": {\r\n                    \"sourceType\": \"PMS\",\r\n                    \"sourceCode\": \"{{HotelId}}\"\r\n                },\r\n                \"roomStay\": {\r\n                    \"roomRates\": [\r\n                        {\r\n                            \"total\": {\r\n                                \"amountBeforeTax\": \"200\"\r\n                            },\r\n                            \"rates\": {\r\n                                \"rate\": [\r\n                                    {\r\n                                        \"base\": {\r\n                                            \"amountBeforeTax\": \"200\",\r\n                                            \"currencyCode\": \"USD\"\r\n                                        },\r\n                                        \"shareDistributionInstruction\": \"Full\",\r\n                                        \"total\": {\r\n                                            \"amountBeforeTax\": \"200\"\r\n                                        },\r\n                                        \"start\": \"{{currentdate}}\",\r\n                                        \"end\": \"{{currentdateplus1}}\"\r\n                                    }\r\n                                ]\r\n                            },\r\n                            \"guestCounts\": {\r\n                                \"adults\": \"1\",\r\n                                \"children\": \"0\"\r\n                            },\r\n                            \"roomType\": \"{{RoomTypeCode}}\",\r\n                            \"ratePlanCode\": \"{{RatePlanCode}}\",\r\n                            \"start\": \"{{currentdate}}\",\r\n                            \"end\": \"{{currentdateplus1}}\",\r\n                            \"suppressRate\": true,\r\n                            \"marketCode\": \"LEISURE\",\r\n                            \"marketCodeDescription\": \"Leisure\",\r\n                            \"sourceCode\": \"PHONE\",\r\n                            \"sourceCodeDescription\": \"Over the Phone\",\r\n                            \"numberOfUnits\": \"1\",\r\n                            \"pseudoRoom\": false,\r\n                            \"roomTypeCharged\": \"{{RoomTypeCode}}\",\r\n                            \"houseUseOnly\": false,\r\n                            \"complimentary\": false,\r\n                            \"fixedRate\": true,\r\n                            \"discountAllowed\": false,\r\n                            \"bogoDiscount\": false\r\n                        }\r\n                    ],\r\n                    \"guestCounts\": {\r\n                        \"adults\": \"1\",\r\n                        \"children\": \"0\"\r\n                    },\r\n                    \"arrivalDate\": \"{{currentdate}}\",\r\n                    \"departureDate\": \"{{currentdateplus1}}\",\r\n                    \"guarantee\": {\r\n                        \"guaranteeCode\": \"6PM\",\r\n                        \"shortDescription\": \"6PM Hold\"\r\n                    },\r\n                    \"roomNumberLocked\": false,\r\n                    \"printRate\": false\r\n                },\r\n                \"reservationGuests\": [\r\n                    {\r\n                        \"profileInfo\": {\r\n                            \"profile\": {\r\n                                \"customer\": {\r\n                                    \"personName\": [\r\n                                        {\r\n                                            \"givenName\": \"Jane\",\r\n                                            \"surname\": \"Smith\",\r\n                                            \"nameType\": \"Primary\"\r\n                                        },\r\n                                        {\r\n                                            \"nameType\": \"External\"\r\n                                        }\r\n                                    ],\r\n                                    \"language\": \"E\"\r\n                                },\r\n                                \"profileType\": \"Guest\"\r\n                            }\r\n                        },\r\n                        \"primary\": true\r\n                    }\r\n                ],\r\n               \"reservationPaymentMethods\": [\r\n                    {\r\n                        \"paymentMethod\": \"CA\",\r\n                        \"folioView\": \"1\"\r\n                    }\r\n                ],\r\n                \"comments\": [\r\n                    {\r\n                        \"comment\": {\r\n                            \"text\": {\r\n                                \"value\": \"Please ensure I have tea in my room\"\r\n                            },\r\n                            \"commentTitle\": \"General Notes\",\r\n                            \"notificationLocation\": \"RESERVATION\",\r\n                            \"type\": \"GEN\",\r\n                            \"internal\": false\r\n                        }\r\n                    }\r\n                ],\r\n                \"hotelId\": \"{{HotelId}}\",\r\n                \"roomStayReservation\": true,\r\n                \"reservationStatus\": \"Reserved\",\r\n                \"computedReservationStatus\": \"DueIn\",\r\n                \"walkIn\": false,\r\n                \"printRate\": false,\r\n                \"preRegistered\": false,\r\n                \"upgradeEligible\": false,\r\n                \"allowAutoCheckin\": false,\r\n                \"hasOpenFolio\": false,\r\n                \"allowMobileCheckout\": false,\r\n                \"allowMobileViewFolio\": false,\r\n                \"allowPreRegistration\": false,\r\n                \"optedForCommunication\": false\r\n            }\r\n        ]\r\n    }\r\n}",
      "options": {
        "raw": {
          "language": "json"
        }
      }
    },
    "url": {
      "raw": "{{HostName}}/rsv/v1/hotels/{{HotelId}}/reservations/",
      "host": [
        "{{HostName}}"
      ],
      "path": [
        "rsv",
        "v1",
        "hotels",
        "{{HotelId}}",
        "reservations",
        ""
      ]
    }
  },
  "response": [
  ]
}