openapi: 3.0.1
info:
  title: eZee Technosys YCS Connectivity Inventory and Rates PMS Connectivity API
  description: Partner-facing connectivity API for the eZee Technosys (Yanolja Cloud Solution) hospitality platform - eZee Absolute PMS, eZee Centrix channel manager, eZee Reservation booking engine, and eZee Optimus POS. The API is not a self-serve public API; access is provisioned per property through the YCS Connectivity Portal (https://api.ezeetechnosys.com/). Every request is scoped to a property via a HotelCode plus an AuthCode (authentication token), supplied together with a vendor-identifying User-Agent header. The PMS connectivity surface accepts JSON POST requests to pms_connectivity.php, while inventory and rate reads use XML POST to getdataAPI.php. Endpoint paths and field names below are modeled from the public Connectivity Portal documentation and are subject to per-property provisioning; verify exact request and response payloads against the portal before integrating.
  termsOfService: https://www.ezeetechnosys.com
  contact:
    name: eZee Technosys / Yanolja Cloud Solution
    url: https://api.ezeetechnosys.com/
  version: '1.0'
servers:
- url: https://live.ipms247.com
  description: eZee / Yanolja Cloud Solution production connectivity host
security:
- HotelCodeAuthCode: []
tags:
- name: PMS Connectivity
paths:
  /pmsinterface/pms_connectivity.php:
    post:
      operationId: pmsConnectivity
      tags:
      - PMS Connectivity
      summary: PMS connectivity operations (bookings, inventory, rates, restrictions, configuration)
      description: 'Single JSON POST endpoint that multiplexes PMS connectivity operations via a RequestType field. Documented operations include: retrieving a booking, retrieving all bookings (new / modified / cancelled updates), retrieving transaction details, receiving a booking, updating room inventory, updating linear and non-linear rates, updating stay restrictions (StopSell, Close-on-Arrival, Close-on-Departure, Min Nights, Max Nights), retrieving room rates with source details, and retrieving room information (room types, rate types, rate plans). All requests are scoped by HotelCode and AuthCode.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - RequestType
              - Authentication
              properties:
                RequestType:
                  type: string
                  description: Operation selector, e.g. FetchBooking, FetchBookings, BookingRecieve, UpdateRoomInventory, SetRoomRate, UpdateMinStay, UpdateStopSell, FetchRoomInformation.
                Authentication:
                  type: object
                  required:
                  - HotelCode
                  - AuthCode
                  properties:
                    HotelCode:
                      type: string
                      description: Unique property identifier issued by eZee / Yanolja Cloud Solution.
                    AuthCode:
                      type: string
                      description: Property-scoped authentication token (API key).
      responses:
        '200':
          description: JSON response payload whose shape depends on RequestType.
          content:
            application/json:
              schema:
                type: object
components:
  securitySchemes:
    HotelCodeAuthCode:
      type: apiKey
      in: header
      name: Authorization
      description: Property-scoped credentials (HotelCode + AuthCode) provisioned through the YCS Connectivity Portal, supplied per the portal's authentication conventions (commonly carried in the request body and/or as HTTP Basic with a vendor-identifying User-Agent header). Not a self-serve public API key.