Reservation POST from 3rd Party to Aiosell

Reservation POST from 3rd Party to Aiosell

API Endpoint URL: https://live.aiosell.com/api/v2/cm/push/sample-ota


Purpose: This API facilitates the transfer of reservation details from Online Travel Agencies (OTAs) to Aiosell. It supports creating, modifying, and canceling reservations, ensuring seamless synchronization of booking information.


Supported Actions

1. New Reservation: action: "book"

2. Modify Reservation: action: "modify"

3. Cancel Reservation: action: "cancel"


A. New Reservation


PurposeTo create a new reservation in Aiosell when a booking is made through an OTA.


Request Format


{

    "action": "book",

    "hotelCode": "SANDBOX-OTA",

    "channel": "Goingo",

    "bookingId": "111222333",

    "cmBookingId": "AAABBBCCC",

    "bookedOn": "2022-12-08 15:25:35",

    "checkin": "2025-12-10",

    "checkout": "2025-12-12",

    "segment": "OTA",

    "specialRequests": "Airport Taxi Required",

    "pah": false,

    "amount": {
           "amountAfterTax": 13789.44,
           "amountBeforeTax": 12312.0,
           "tax": 1477.44,
           "currency": "INR",
           "commission": 2462.4,
           "tcs": 61.56,
           "tds": 12.32
         },
    "guest": {

        "firstName": "Akshay",

        "lastName": "Kumar",

        "email": "akshaykumar@gmail.com",

        "phone": "9988776655",

        "address": {

            "line1": "51",

            "city": "Bangalore",

            "state": "Karnataka",

            "country": "India",

            "zipCode": "560035"

        }

    },

    "rooms": [

        {

            "roomCode": "SUITE",

            "rateplanCode": "SUITE-D-101",

            "guestName": "Akshay Kumar",

            "occupancy": {

                "adults": 1,

                "children": 0

            },

            "prices": [

                {

                    "date": "2022-12-10",

                    "sellRate": 537.5

                },

                {

                    "date": "2022-12-11",

                    "sellRate": 537.5

                }

            ]

        }

    ]

}


Response


{

    "success": true,

    "message": "Reservation Updated Successfully"

}


B. Modify Reservation


Purpose

To modify an existing reservation in Aiosell when changes are made via an OTA.


Request Format


{

    "action": "modify",

    "hotelCode": "SANDBOX-OTA",

    "channel": "Goingo",

    "bookingId": "111222333",

    "cmBookingId": "AAABBBCCC",

    "bookedOn": "2022-12-08 15:25:35",

    "checkin": "2025-12-10",

    "checkout": "2025-12-12",

    "segment": "OTA",

    "specialRequests": "Airport Taxi Required",

    "pah": false,

    "amount": {

          "amountAfterTax": 13789.44,
           "amountBeforeTax": 12312.0,
           "tax": 1477.44,
           "currency": "INR",
           "commission": 2462.4,
           "tcs": 61.56,
           "tds": 12.32

    },

    "guest": {

        "firstName": "Akshay",

        "lastName": "Kumar",

        "email": "akshaykumar@gmail.com",

        "phone": "9988776655",

        "address": {

            "line1": "51",

            "city": "Bangalore",

            "state": "Karnataka",

            "country": "India",

            "zipCode": "560035"

        }

    },

    "rooms": [

        {

            "roomCode": "SUITE",

            "rateplanCode": "SUITE-D-101",

            "guestName": "Akshay Kumar",

            "occupancy": {

                "adults": 1,

                "children": 0

            },

            "prices": [

                {

                    "date": "2022-12-10",

                    "sellRate": 537.5

                },

                {

                    "date": "2022-12-11",

                    "sellRate": 537.5

                }

            ]

        }

    ]

}


Response


{

    "success": true,

    "message": "Reservation Modified Successfully"

}


C. Cancel Reservation


Purpose

To cancel an existing reservation in Aiosell when it is canceled on the OTA.


Request Format


{

    "action": "cancel",

    "hotelCode": "SANDBOX-OTA",

    "channel": "Goingo",

    "bookingId": "111222333"

}


Response


{

    "success": true,

    "message": "Reservation Cancelled Successfully"

}

    • Related Articles

    • Reservation POST from Aiosell to PMS

      New Reservation (Aiosell to PMS) API Endpoint URL: https://sample-pms.com/update_reservation *Note: This is a sample url for reference purpose, 3rd Party/ PMS will need to create an END POINT / WEBHOOK and share it with Aiosell team* Purpose: This ...

    • Inventory POST from Aiosell to 3rd Party

      API Endpoint URL: BASE URL TO BE SHARED BY OTA Purpose This API allows Aiosell to communicate inventory updates, including availability and restrictions, to third-party OTAs (Online Travel Agencies). It ensures inventory consistency across platforms. ...

    • Inventory Restrictions POST from Aiosell to 3rd Party

      API Endpoint URL: BASE URL TO BE SHARED BY OTA Purpose: This API allows Aiosell to communicate inventory restrictions, to third-party OTAs (Online Travel Agencies). Request Format | Method: POST Sample Payload: { "hotelCode": "SANDBOX-OTA", ...

    • Rate POST from Aiosell to 3rd Party / OTA

      API ENDPOINT URL: TO BE SHARED BY OTA Purpose This API allows Aiosell to communicate updated room rates and restrictions to third-party OTAs (Online Travel Agencies). It ensures consistency in pricing across all platforms. Request Format | Method: ...

    • Rates Restrictions POST from Aiosell to 3rd Party

      API Endpoint URL: BASE URL TO BE SHARED BY OTA Purpose This API allows Aiosell to communicate restrictions to third-party OTAs. Request Format | Method: POST Sample Payload: { "hotelCode": "SANDBOX-OTA", "updates": [ { "startDate": "2025-02-22", ...