API - Booking Push

Endpoint: http://bookingmanager.aegissoftware.com.np/apiv1/BEConnectivity

Purpose

To push booking information to the Property Management System (PMS).

Request

Method: POST

Headers

• Authorization: Bearer <token>
• Content-Type: application/json

Request Body

{
  "hotel_code": "hotel001",
  "merchant_code": "m001",
  "reservations": [
    {
      "customer": {
        "countrycode": "NP",
        "email": "test@gmail.com",
        "telephone": ""
      },
      "rooms": [
        {
          "arrival_date": "2026-01-01",
          "departure_date": "2026-01-03",
          "specialrequest": "Need smoking room.",
          "guest_name": "Ramesh Karki",
          "id": "DLX",
          "numberofrooms": 5,
          "numberofchildren": 2,
          "numberofadults": 10,
          "roomstaystatus": "confirmed",
          "roomreservation_id": "RES001_DLX",
          "price": [
            {
              "date": "2026-01-01",
              "rate_id": "AP",
              "pricebeforetax": 100.00,
              "childrate": 50.00
            },
            {
              "date": "2026-01-02",
              "rate_id": "AP",
              "pricebeforetax": 100.00,
              "childrate": 50.00
            }
          ],
          "guest_name_list":[]
        }
      ],
      "id": "RES001",
      "status": "confirmed"
    }
  ]
}

Response

Success

{
  "error_code": "0",
  "status_code": "200"
}

Error

{
  "error_code": "1",
  "status_code": "500"
}

Key Components of the Request

• hotel_id: Id to identify hotels. <token> is different for each hotel. <token> & hotel_id must match to validate the request.
  
• merchant_code: Code of merchant. The one who is calling this API.
• reservations: An array of reservations. Each reservation contains the following:
  • customer: Details about the customer.
    • countrycode: Country code of the customer based on country_code.csv file.
    • email: Email address of the customer.
    • telephone: Telephone number of the customer.
  • rooms: An array of rooms that are reserved. Each room contains detailed booking information.
    • arrival_date: Arrival date of the reservation.
    • departure_date: Departure date of the reservation.
    • specialrequest: Any special request made by the guest. Max 500 character
      
    • guest_name: Name of the guest. Max 100 chatacter
      
    • id: Code of the room that is booked (e.g., DLX, SDLX). Mapped with PMS.
      
    • numberofrooms: Total No of rooms for this specific category.
      
    • numberofchildren: Number of children.
    • numberofadults: Number of adults.
    • roomstaystatus: Status of the booking (e.g., confirmed, modified, cancelled).
    • roomreservation_id: ID of the booking in your system. If it already exists, the booking is updated; otherwise, it is inserted. This is id associated to each booking of the reservation.
      
    • price: An array containing the rate for each day of the booking. It must contains data from arrival to 1 day before departure date.
      • date: Date of the rate.
      • rate_id: Code for the plan associated with the rate (e.g., BB, MAP).
      • pricebeforetax: Price before tax. This rate must be for each room not total.
        
        • If numberofrooms=5  & pricebeforetax = 100. It means, total 5 room rate of each if 100.
      • childrate: Rate for children.
    • "guest_name_list": List of guest name in string i.e ["Ram", "Hari].
      
      • Only send for adult, child data are not accepted.
      • Non mandatory, you can send blank array.
  • id: ID of the booking in your system. A single reservation can have multiple rooms. This ID is for the group of rooms, and roomreservation_id is for individual rooms. Both are mandatory.