Reservation POST from Aiosell to PMS

Reservation POST from Aiosell to PMS

New Reservation (Aiosell to PMS)


API Endpoint URL: https://sample-pms.com/update_reservation 

Notes*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 API is used by Aiosell to push new reservation details to the Property Management System (PMS). It ensures that bookings made through OTAs (Online Travel Agencies) or direct channels are synchronized with the hotel’s internal PMS.


Request Format
Method: POST


Sample Payload:

{
    "action": "book",
    "hotelCode": "SANDBOX-PMS",
    "channel": "Goingo",
    "bookingId": "111222333",
    "cmBookingId": "AAABBBCCC",
    "bookedOn": "2022-12-08 15:25:35",
    "checkin": "2022-12-10",
    "checkout": "2022-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-S-101",
            "guestName": "Akshay Kumar",
            "occupancy": {
                "adults": 1,
                "children": 0
            },
            "prices": [
                {
                    "date": "2022-12-10",
                    "sellRate": 537.5
                },
                {
                    "date": "2022-12-11",
                    "sellRate": 537.5
                }
            ]
        }
    ]
}

Sample Response:


{

    "success": true,

    "message": "Reservation Updated Successfully"

}

 

Reference of values: 

1. Action: (book, cancel, or modify) 

2. Channel: name of channel making the booking (partner name is OK) 

3. bookingID: unique booking ID to be decided by OTA / partner

4. cmBookingID: is same as booking ID or NULL or some OTA may send Itentnery ID

5. segment: can be predecided set of values that can be configured in Aiosell system 

6. pah: True / false. (True = payment collected at hotel. False if prepaid booking) 

7. Rest of fields are self explanatory


Modify 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 API enables Aiosell to push modifications to existing reservations in the Property Management System (PMS). It ensures that updated booking details, such as check-in/check-out dates or special requests, are reflected in the PMS.


Request FormatMethod: POST


Sample Payload:

{
    "action": "modify",
    "hotelCode": "SANDBOX-PMS",
    "channel": "Goingo",
    "bookingId": "111222333",
    "cmBookingId": "AAABBBCCC",
    "bookedOn": "2022-12-08 15:25:35",
    "checkin": "2022-12-10",
    "checkout": "2022-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-S-101",
            "guestName": "Akshay Kumar",
            "occupancy": {
                "adults": 1,
                "children": 0
            },
            "prices": [
                {
                    "date": "2022-12-10",
                    "sellRate": 537.5
                },
                {
                    "date": "2022-12-11",
                    "sellRate": 537.5
                }
            ]
        }
    ]
}


Sample Response:


{

    "success": true,

    "message": "Reservation Modified Successfully"

}


Reference of values: 

 

·  Action: (book, cancel, or modify) 

·  Channel: name of channel making the booking (partner name is OK) 

·  bookingID: unique booking ID to be decided by OTA / partner

·  cmBookingID: is same as booking ID or NULL or some OTA may send Itentnery ID

·  segment: can be predecided set of values that can be configured in Aiosell system 

·  pah: True / false. (True = payment collected at hotel. False if prepaid booking) 

·  Rest of fields are self explanatory


Cancel Reservation (Aiosell to PMS)

 

API Endpoint URL: https://sample-pms.com/update_reservation

Notes*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 API allows Aiosell to push reservation cancellations to the Property Management System (PMS). It ensures that canceled bookings are updated in real-time, freeing up room inventory and preventing overbookings.

 

Request Format | Method: POST


Sample Payload:

 

{

    "action": "cancel",

    "hotelCode": "SANDBOX-PMS",

    "channel": "Goingo",

    "bookingId": "111222333"

}

 

Response

 

Sample Response:

 

{

    "success": true,

    "message": "Reservation Cancelled Successfully"

}

 

Reference of values: 

 

·  Action: (book, cancel, or modify)

·  Rest of fields are self explanatory

    • Related Articles

    • 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, ...

    • 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 Push from PMS to Aiosell

      API Endpoint URL: https://live.aiosell.com/api/v2/cm/update/sample-pms Purpose This API is designed to allow Property Management Systems (PMS) to push updated room inventory data to Aiosell Channel Manager. This ensures accurate availability across ...

    • Rates Restrictions Push from PMS to Aiosell

      API Endpoint URL: https://live.aiosell.com/api/v2/cm/update-rates/sample-pms Purpose This API allows Property Management Systems (PMS) to push rate restrictions to Aiosell, ensuring that pricing rules and conditions are consistently applied across ...

    • Inventory Restrictions Push from PMS to Aiosell

      API Endpoint URL: https://live.aiosell.com/api/v2/cm/update/sample-pms Purpose This API allows Property Management Systems (PMS) to push room-specific restrictions to Aiosell. It ensures that restrictions like stop-sell, minimum stay, and ...