openapi: 3.2.0 info: title: OPERA Cloud Integration Configuration External Systems Config API description: APIs catering to Integration Configuration in OPERA Cloud. Operations such as get Hotel Interface Types, or get UDF mappings can be found in this module.

Compatible with OPERA Cloud release 26.2.0.0.

This document and all content within is available under the Universal Permissive License v 1.0 (https://oss.oracle.com/licenses/upl). Copyright (c) 2020, 2026 Oracle and/or its affiliates.

version: 26.2.0.0 termsOfService: https://www.oracle.com/legal/terms.html contact: email: hospitality_apis_ww_grp@oracle.com license: name: UPL url: https://opensource.org/licenses/upl servers: - url: /int/config/v1 tags: - name: ExternalSystemsConfig paths: /configuredExternalDevices: get: summary: Operation to fetch configured external devices. description: '

OperationId:getConfiguredExternalDevices

' operationId: getConfiguredExternalDevices parameters: - name: hotelId in: query required: false schema: type: string - name: active in: query required: false description: Flag that indicates whether the device is active. schema: type: boolean - name: id in: query required: false schema: type: string - name: idEditable in: query required: false schema: type: boolean - name: label in: query required: false schema: type: string - name: deviceType in: query required: false schema: type: string enum: - Scanner - CreditCard - Fiscal - Device uniqueItems: true - name: deviceCode in: query required: false schema: type: string enum: - TtiScannerMobile - TtiScannerDesktop - SamsotechScanner - GenScannerDesktop - GenScannerMobile - ChipAndPin - FiscalTerminal - Device uniqueItems: true - name: deviceArea in: query required: false description: The area where the device is installed schema: type: string - name: displayName in: query required: false description: External device display name. schema: type: string - name: mobileYN in: query required: false description: Indicator if device type is mobile or desktop. schema: type: boolean - name: desktopYN in: query required: false description: Indicator if device type is mobile or desktop. schema: type: boolean - name: registerAddress in: query required: false description: The address which the Cash Register ID ( Device ID ) is associated with. schema: type: string - name: deviceValue in: query required: false description: External device Value. schema: type: string - name: parameterName in: query required: false description: Name of the parameter. schema: type: string - name: parameterValue in: query required: false description: Value of the parameter. schema: type: string - name: includeInactive in: query required: false description: Flag to choose to include inactive external devices or not. schema: type: boolean - name: fiscalPartnerCode in: query required: false description: Used for fiscal partner codes. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X. schema: type: string - name: partnerCode in: query description: Used for fiscal partner codes. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X. required: false style: form explode: true schema: type: array items: type: string - name: fetchInstruction in: query required: false description: Fetch instructions that can be used for all or partner specific. schema: type: string enum: - Default - Partner uniqueItems: true - name: partnerPayloadType in: query required: false description: Used for searching a partner code configured with the specified fiscal payload type. schema: type: string enum: - CheckOut - FolioGeneration uniqueItems: true - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response for Ping operation. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedConfiguredExternalDevices' '204': description: ConfiguredExternalDevices not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /deliveryMethods: get: summary: Operation to fetch delivery methods. description: '

OperationId:getDeliveryMethods

' operationId: getDeliveryMethods parameters: - name: hotelId in: query required: false description: Property code. schema: type: string - name: croCode in: query required: false description: CRO code. schema: type: string - name: usages in: query description: Settings for Text Message Delivery of Queue Reservation status required: false style: form explode: true schema: type: array items: type: string enum: - General - QueueReservation - Confirmation - GuestMessage - BillingFolio - QueueRush - AR - OtherFolio - PayByLink uniqueItems: true - name: includeInactive in: query required: false description: If true this will include inactive records(This is only applicable for general SMTP delivery method ). schema: type: boolean - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response to request to fetch the delivery method for a property/HUB/Chain and its configurations. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedDeliveryMethods' '204': description: DeliveryMethods not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig put: summary: Operation to change delivery methods. description: '

OperationId:putDeliveryMethods

' operationId: putDeliveryMethods parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedDeliveryMethods' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeDeliveryMethods' description: Request to change the delivery method for a property/HUB/Chain and its configurations. required: true delete: summary: Operation to remove delivery methods. description: '

OperationId:deleteDeliveryMethods

' operationId: deleteDeliveryMethods parameters: - name: hotelId in: query required: false description: Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X. schema: type: string - name: type in: query required: false description: Settings for Text Message Delivery of Queue Reservation status schema: type: string enum: - General - QueueReservation - Confirmation - GuestMessage - BillingFolio - QueueRush - AR - OtherFolio uniqueItems: true - name: options in: query description: SFTP delivery configurations required: false style: form explode: true schema: type: array items: type: string enum: - Email - Fax - TextMessage - Sftp uniqueItems: true - name: configurationId in: query description: Unique id associated with this configuration required: false style: form explode: true schema: type: array items: type: integer - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig post: summary: Operation to create delivery methods. description: '

OperationId:postDeliveryMethods

' operationId: postDeliveryMethods parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '201': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/createDeliveryMethods' description: Request to create the delivery method for a property/HUB/Chain and its configurations. required: true /externalDevices/configurations: get: summary: Operation to fetch external device configurations. description: '

OperationId:getExternalDeviceConfigurations

' operationId: getExternalDeviceConfigurations parameters: - name: hotelId in: query required: false schema: type: string - name: active in: query required: false description: Flag that indicates whether the device is active. schema: type: boolean - name: id in: query required: false schema: type: string - name: idEditable in: query required: false schema: type: boolean - name: label in: query required: false schema: type: string - name: deviceType in: query required: false schema: type: string enum: - Scanner - CreditCard - Fiscal - Device uniqueItems: true - name: deviceCode in: query required: false schema: type: string enum: - TtiScannerMobile - TtiScannerDesktop - SamsotechScanner - GenScannerDesktop - GenScannerMobile - ChipAndPin - FiscalTerminal - Device uniqueItems: true - name: deviceArea in: query required: false description: The area where the device is installed schema: type: string - name: displayName in: query required: false description: External device display name. schema: type: string - name: mobileYN in: query required: false description: Indicator if device type is mobile or desktop. schema: type: boolean - name: desktopYN in: query required: false description: Indicator if device type is mobile or desktop. schema: type: boolean - name: registerAddress in: query required: false description: The address which the Cash Register ID ( Device ID ) is associated with. schema: type: string - name: deviceValue in: query required: false description: External device Value. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response for Ping operation. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedExternalDeviceConfigurations' '204': description: ExternalDeviceConfigurations not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig put: summary: Operation to change external device configurations. description: '

OperationId:putExternalDeviceConfigurations

' operationId: putExternalDeviceConfigurations parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedExternalDeviceConfigurations' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeExternalDeviceConfigurations' description: Request to change the external device activated for the hotel and its configurations. required: true /externalSystems/config/ping: get: summary: Operation to ping. description: '

OperationId:ping

' operationId: ping parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response for Ping operation. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/operaVersion' '204': description: ping not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /externalSystems/{externalSystemCode}/hotels/{hotelId}/publishers: post: summary: Operation to create publishers. description: '

OperationId:postPublishers

' operationId: postPublishers parameters: - name: hotelId in: path required: true description: Unique OPERA Id used to find a property in OPERA. schema: type: string maxLength: 2000 minLength: 1 - name: externalSystemCode in: path required: true description: Unique OPERA Code used to find External System in OPERA. schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '201': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/createPublishers' description: Request to create publishers. required: true delete: summary: Operation to remove publisher. description: '

OperationId:deletePublisher

' operationId: deletePublisher parameters: - name: hotelId in: path required: true description: Unique OPERA Id used to find a property in OPERA. schema: type: string maxLength: 2000 minLength: 1 - name: externalSystemCode in: path required: true description: Unique OPERA Code used to find External System in OPERA. schema: type: string maxLength: 2000 minLength: 1 - name: subscriberHotelId in: query required: false schema: type: string - name: code in: query required: false schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /externalSystems/{externalSystemCode}/publishers: get: summary: Operation to fetch publishers. description: '

OperationId:getPublishers

' operationId: getPublishers parameters: - name: externalSystemCode in: path required: true description: Unique OPERA Code used to find External System in OPERA. schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: query required: false schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response to request to fetch the external systems content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedPublishers' '204': description: Publishers not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /hotelInerface: post: summary: Operation to create hotel interface. description: '

OperationId:postHotelInterface

' operationId: postHotelInterface parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '201': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/hotelInterface' description: Request object for creating a new Hotel Interface. required: true put: summary: Operation to change hotel interface. description: '

OperationId:putHotelInterface

' operationId: putHotelInterface parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/hotelInterface' description: Request object for updating a Hotel Interface. required: true /hotelInterfaceTypes: get: summary: Operation to fetch hotel interfaces. description: '

OperationId:getHotelInterfaces

' operationId: getHotelInterfaces parameters: - name: hotelIds in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: interfaceTypes in: query description: XML Posting Interface required: false style: form explode: true schema: type: array items: type: string enum: - Bms - Cas - Ccw - Dls - Eft - Exp - Mak - Mbs - Msc - Pbx - Pos - Svs - Tik - Vid - Vms - Www - Xml uniqueItems: true - name: logosCodes in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: includeInactive in: query required: false description: If true this will set the criteria to include inactive records. schema: type: boolean - name: includeOutboundCode in: query required: false description: If true this will set the criteria to include interfaces that are configured to use outbound code. schema: type: boolean - name: includeExternalSystem in: query required: false description: If true this will set the criteria to include interfaces that are configured to use external system. schema: type: boolean - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving Hotel Interfaces. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedHotelInterfaces' '204': description: HotelInterfaces not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /hotels/{hotelId}/hotelInerface: delete: summary: Operation to remove hotel interface. description: '

OperationId:deleteHotelInterface

' operationId: deleteHotelInterface parameters: - name: hotelId in: path required: true schema: type: string maxLength: 2000 minLength: 1 - name: logo in: query required: false description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /hotels/{hotelId}/interfaces/{interfaceId}/accounts: post: summary: Operation to create interface account. description: '

OperationId:postInterfaceAccount

' operationId: postInterfaceAccount parameters: - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '201': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/createInterfaceAccount' description: Request object for creating an Interface Account of a Hotel Interface record. required: true /hotels/{hotelId}/interfaces/{interfaceId}/accounts/{accountId}: put: summary: Operation to change interface account. description: '

OperationId:putInterfaceAccount

' operationId: putInterfaceAccount parameters: - name: accountId in: path required: true description: OPERA Id for Account schema: type: string maxLength: 2000 minLength: 1 - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedInterfaceAccount' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeInterfaceAccount' description: Request object for updating an Interface Account of a Hotel Interface record. required: true delete: summary: Operation to remove interface account. description: '

OperationId:deleteInterfaceAccount

' operationId: deleteInterfaceAccount parameters: - name: accountId in: path required: true description: OPERA Id for Account schema: type: string maxLength: 2000 minLength: 1 - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - name: autoBalance in: query required: false description: Auto balance flag of postings setup. schema: type: boolean - name: paymentMethod in: query required: false description: Payment method of posting accounts in transaction codes setup. schema: type: string - name: account in: query required: false description: Account of posting accounts in transaction codes setup. schema: type: string - name: accountDescription in: query required: false description: Account description of posting accounts in transaction codes setup. schema: type: string - name: salesOutlet in: query required: false description: Sales outlet of posting accounts in transaction codes setup. schema: type: string - name: trxCode in: query required: false description: Transaction code of posting accounts in transaction codes setup. schema: type: string - name: description in: query required: false description: Description of posting accounts in transaction codes setup. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /hotels/{hotelId}/interfaces/{interfaceId}/roomStatus: get: summary: Operation to fetch interface room statuses. description: '

OperationId:getInterfaceRoomStatuses

' operationId: getInterfaceRoomStatuses parameters: - name: interfaceId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Collection of Hotel Interface Room Statuses. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedInterfaceRoomStatuses' '204': description: InterfaceRoomStatuses not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig put: summary: Operation to change interface room status. description: '

OperationId:putInterfaceRoomStatus

' operationId: putInterfaceRoomStatus parameters: - name: interfaceId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedInterfaceRoomStatus' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeInterfaceRoomStatus' description: Request object for updating a Hotel Interface Room Status. If it does not exist, then creates the Hotel Interface Room Status. required: true delete: summary: Operation to remove interface room status. description: '

OperationId:deleteInterfaceRoomStatus

' operationId: deleteInterfaceRoomStatus parameters: - name: interfaceId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: entryCode in: query required: false description: Entry code of a Hotel Interface Room Status. schema: type: string - name: status in: query required: false description: Room Status which is either Vacant (V) or Occupied (O). schema: type: string - name: housekeepingStatus in: query required: false description: Housekeeping status of a room. schema: type: string - name: customRoomTranslation in: query required: false description: Custom Room Translation of a Hotel Interface. It is a concatenation of a Status (V-Vacant or O-Occupied) and Housekeeping Status (IS-Inspected, CL-Clean, etc.) The delimiter is a period. Sample values are V.IS, V.CL, O.IS, O.CL. schema: type: string - name: description in: query required: false description: Description of the Hotel Interface Room Status. schema: type: string - name: interfaceRoomStatusId in: query required: false description: Row number to identify all the records belonging to a single group of Hotel Interface Room Status. schema: type: integer - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /hotels/{hotelId}/interfaces/{interfaceId}/rooms: get: summary: Operation to fetch interface rooms. description: '

OperationId:getInterfaceRooms

' operationId: getInterfaceRooms parameters: - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - name: fromRoom in: query required: false description: From Room Number schema: type: string maxLength: 20 minLength: 1 - name: toRoom in: query required: false description: To Room Number schema: type: string maxLength: 20 minLength: 1 - name: fromLineType in: query required: false description: From Line Type schema: type: string maxLength: 20 minLength: 1 - name: toLineType in: query required: false description: To Line Type schema: type: string maxLength: 20 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Collection of Hotel Interface Rooms. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedInterfaceRooms' '204': description: InterfaceRooms not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig post: summary: Operation to create interface room. description: '

OperationId:postInterfaceRoom

' operationId: postInterfaceRoom parameters: - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '201': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/createInterfaceRoom' description: Request object for creating an Interface Room of a Hotel Interface record. required: true delete: summary: Operation to remove interface room. description: '

OperationId:deleteInterfaceRoom

' operationId: deleteInterfaceRoom parameters: - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - name: roomType in: query required: false description: Front Office Room Type. schema: type: string - name: roomNumber in: query required: false description: Front Office Room Number. schema: type: string - name: lineNumber in: query required: false description: External System's extension number. schema: type: string - name: oldLineNumber in: query required: false description: External System's extension number. It is used for editing a record. It is logically part of the record ID, and can actually be updated. schema: type: string - name: type in: query required: false description: Line Type of an Interface Room. schema: type: string - name: dataLine in: query required: false description: Line Out schema: type: string enum: - In - Out uniqueItems: true - name: dataLineId in: query required: false description: Translation Table Id as defined in the IFC_CTRL table. It is also referred as Xlat Id. schema: type: string - name: wakeUpCall in: query required: false description: Value to set/check if the wake up call functionality is enabled/disabled for the particular line number. schema: type: boolean - name: doNotDisturb in: query required: false description: Do Not Disturb is set to available and freely switchable. schema: type: string enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable uniqueItems: true - name: classOfService in: query required: false description: Class Of Service is set to available and freely switchable. schema: type: string enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable uniqueItems: true - name: directInwardDial in: query required: false description: Direct Inward Dial is set to available and freely switchable. schema: type: string enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable uniqueItems: true - name: messageWaiting in: query required: false description: Message Waiting is set to available and freely switchable. schema: type: string enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable uniqueItems: true - name: maskDialNumber in: query required: false description: Mask the dialled digits as per the room configuration. schema: type: string enum: - NoMasking - MaskLast2Digits - MaskLast4Digits - Mask4DigitsLeaveLast2Intact - MaskAllExceptFirst2 - MaskAll - MaskingPerRoom uniqueItems: true - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /hotels/{hotelId}/interfaces/{interfaceId}/rooms/import: post: summary: Operation to import interface rooms. description: '

OperationId:importInterfaceRooms

' operationId: importInterfaceRooms parameters: - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '201': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/importInterfaceRooms' description: Request object for importing the Interface Rooms for a Hotel Interface record. required: true /hotels/{hotelId}/interfaces/{interfaceId}/rooms/{roomId}: put: summary: Operation to change interface room. description: '

OperationId:putInterfaceRoom

' operationId: putInterfaceRoom parameters: - name: roomId in: path required: true description: '' schema: type: string maxLength: 2000 minLength: 1 - name: interfaceId in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedInterfaceRoom' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeInterfaceRoom' description: Request object for updating an Interface Room of a Hotel Interface record. required: true /hotels/{hotelId}/interfaces/{interfaceId}/unitCharges: get: summary: Operation to fetch interface unit charges. description: '

OperationId:getInterfaceUnitCharges

' operationId: getInterfaceUnitCharges parameters: - name: interfaceId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: logo in: query required: false description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving the Interface Unit Charges. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedInterfaceUnitCharges' '204': description: InterfaceUnitCharges not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig put: summary: Operation to change interface unit charges. description: '

OperationId:putInterfaceUnitCharges

' operationId: putInterfaceUnitCharges parameters: - name: interfaceId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedInterfaceUnitCharges' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeInterfaceUnitCharges' description: Request object for updating Hotel Interface Unit Charges. required: true /hotels/{hotelId}/logos/{logo}: get: summary: Operation to fetch hotel interface details. description: '

OperationId:getHotelInterfaceDetails

' operationId: getHotelInterfaceDetails parameters: - name: logo in: path required: true description: OPERA Id for Logo schema: type: string maxLength: 2000 minLength: 1 - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - name: fetchInstructions in: query description: Transaction codes of a Hotel Interface. required: false style: form explode: true schema: type: array items: type: string enum: - PrimaryInfo - AdditionalInfo - GeneralInfo - CommunicationInfo - IfcTranslation - IfcClassOfService - IfcImportRooms - WorkstationSetupInfo - PostingsInfo - CustomDataInfo - ExportDataInfo - TransactionCodesInfo uniqueItems: true - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving the details of a Hotel Interface. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedHotelInterfaceDetails' '204': description: HotelInterfaceDetails not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /interfaceControllerRegistry: get: summary: Operation to fetch hotel interface controller registry. description: '

OperationId:getHotelInterfaceControllerRegistry

' operationId: getHotelInterfaceControllerRegistry parameters: - name: machine in: query required: false description: Used for Character Strings, length 0 to 40. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving Hotel Interface Controller Registry. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedHotelInterfaceControllerRegistry' '204': description: HotelInterfaceControllerRegistry not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /interfaceErrors: get: summary: Operation to fetch hotel interface errors. description: '

OperationId:getHotelInterfaceErrors

' operationId: getHotelInterfaceErrors parameters: - name: limit in: query required: false description: Indicates maximum number of records a Web Service should return. schema: type: integer - name: offset in: query required: false description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned. schema: type: integer default: 0 - name: hotelIds in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: interfaceTypes in: query description: XML Posting Interface required: false style: form explode: true schema: type: array items: type: string enum: - Bms - Cas - Ccw - Dls - Eft - Exp - Mak - Mbs - Msc - Pbx - Pos - Svs - Tik - Vid - Vms - Www - Xml uniqueItems: true - name: logoCodes in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: includeInactive in: query required: false description: If true this will set the criteria to include inactive records. schema: type: boolean - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving Hotel Interface Errors. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedHotelInterfaceErrors' '204': description: HotelInterfaceErrors not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /interfaceFailedMessages: get: summary: Operation to fetch hotel interface failed messages. description: '

OperationId:getHotelInterfaceFailedMessages

' operationId: getHotelInterfaceFailedMessages parameters: - name: limit in: query required: false description: Indicates maximum number of records a Web Service should return. schema: type: integer - name: offset in: query required: false description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned. schema: type: integer default: 0 - name: hotelIds in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: interfaceTypes in: query description: XML Posting Interface required: false style: form explode: true schema: type: array items: type: string enum: - Bms - Cas - Ccw - Dls - Eft - Exp - Mak - Mbs - Msc - Pbx - Pos - Svs - Tik - Vid - Vms - Www - Xml uniqueItems: true - name: logoCodes in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: includeInactive in: query required: false description: If true this will set the criteria to include inactive records. schema: type: boolean - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving Hotel Interface Failed Messages. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedHotelInterfaceFailedMessages' '204': description: HotelInterfaceFailedMessages not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /interfaceRights: put: summary: Operation to change interface right. description: '

OperationId:putInterfaceRight

' operationId: putInterfaceRight parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedInterfaceRight' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeInterfaceRight' description: Request object for updating a Hotel Interface Right. It will create the Hotel Interface Right if it does not exist on the database. required: true delete: summary: Operation to remove interface right. description: '

OperationId:deleteInterfaceRight

' operationId: deleteInterfaceRight parameters: - name: hotelId in: query required: false description: Hotel Code to which the Interface Right belongs to. schema: type: string - name: id in: query required: false description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. schema: type: string - name: idExtension in: query required: false description: Additional identifying value assigned by the creating system. schema: type: integer - name: idContext in: query required: false description: Used to identify the source of the identifier (e.g., IATA, ABTA). schema: type: string - name: type in: query required: false description: A reference to the type of object defined by the UniqueID element. schema: type: string - name: right in: query required: false description: Internal code for each allowed right of a Hotel Interface record. schema: type: integer - name: code in: query required: false description: User defined code for an Interface Right. schema: type: string - name: description in: query required: false description: User defined description for an Interface Right. schema: type: string - name: interfaceRightDescription in: query required: false description: System Description of an allowed Interface Right. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig get: summary: Operation to fetch interface rights. description: '

OperationId:getInterfaceRights

' operationId: getInterfaceRights parameters: - name: hotelId in: query required: false description: Used for codes in the OPERA Code tables. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X. schema: type: string - name: id in: query required: false description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. schema: type: string - name: idExtension in: query required: false description: Additional identifying value assigned by the creating system. schema: type: integer - name: idContext in: query required: false description: Used to identify the source of the identifier (e.g., IATA, ABTA). schema: type: string - name: type in: query required: false description: A reference to the type of object defined by the UniqueID element. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Collection of Hotel Interface Tasks. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedInterfaceRights' '204': description: InterfaceRights not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /interfaceSchemas: get: summary: Operation to fetch hotel interface schemas. description: '

OperationId:getHotelInterfaceSchemas

' operationId: getHotelInterfaceSchemas parameters: - name: limit in: query required: false description: Indicates maximum number of records a Web Service should return. schema: type: integer - name: offset in: query required: false description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned. schema: type: integer default: 0 - name: hotelIds in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: interfaceTypes in: query description: XML Posting Interface required: false style: form explode: true schema: type: array items: type: string enum: - Bms - Cas - Ccw - Dls - Eft - Exp - Mak - Mbs - Msc - Pbx - Pos - Svs - Tik - Vid - Vms - Www - Xml uniqueItems: true - name: logoCodes in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: includeInactive in: query required: false description: If true this will set the criteria to include inactive records. schema: type: boolean - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving Hotel Interface Schemas. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedHotelInterfaceSchemas' '204': description: HotelInterfaceSchemas not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /interfaces/{interfaceId}/databases/{databaseId}/availableResorts: get: summary: Operation to fetch external database available properties. description: '

OperationId:getExternalDatabaseAvailableProperties

' operationId: getExternalDatabaseAvailableProperties parameters: - name: databaseId in: path required: true description: OPERA Id for Databsase schema: type: string maxLength: 2000 minLength: 1 - name: interfaceId in: path required: true description: OPERA Id for interface schema: type: string maxLength: 2000 minLength: 1 - name: includeInactive in: query required: false description: Flag that indicates to include inactive records. schema: type: boolean - name: interfaceCodes in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - name: hotelIds in: query required: false style: form explode: true schema: type: array items: type: string maxItems: 4000 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Response object for retrieving the Available properties for External Databases. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedExternalDatabaseAvailableProperties' '204': description: ExternalDatabaseAvailableProperties not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /machines: get: summary: Operation to fetch interface machines. description: '

OperationId:getInterfaceMachines

' operationId: getInterfaceMachines parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Collection of Hotel Interface Machines. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedInterfaceMachines' '204': description: InterfaceMachines not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /machines/{machineId}: put: summary: Operation to change interface machine. description: '

OperationId:putInterfaceMachine

' operationId: putInterfaceMachine parameters: - name: machineId in: path required: true description: OPERA Id for machine schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedInterfaceMachine' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeInterfaceMachine' description: Request object for updating a Hotel Interface Machine. If it does not exist, then creates the Hotel Interface Machine. required: true delete: summary: Operation to remove interface machine. description: '

OperationId:deleteInterfaceMachine

' operationId: deleteInterfaceMachine parameters: - name: machineId in: path required: true description: OPERA Id for machine schema: type: string maxLength: 2000 minLength: 1 - name: machine in: query required: false description: Unique Machine name of the running Interface. schema: type: string - name: program in: query required: false description: Path and name of the Interface program running on every Machine. schema: type: string - name: controllerPort in: query required: false description: Opera Interface controller (server) port for the connecting clients. schema: type: integer - name: vncPort in: query required: false description: VNC server port for connecting to the VNC server. schema: type: integer - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: HATEOAS links which help the consumer to navigate to resources content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/status' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig /udfMappings: get: summary: Operation to send a response to the Look up of UDFs. description: Operation to send a response to the Look-up of UDFs.

OperationId:getUDFMappings

operationId: getUDFMappings parameters: - name: type in: query required: false description: A reference to the type of object defined by the Type for Reservation and Profile Type. schema: type: string - name: uDFName in: query required: false description: Name of the user-defined function (UDF) field. schema: type: string - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' description: Message received on an UDFs Lookup. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/fetchedUDFMappings' '204': description: UDFMappings not found. '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig put: summary: Operation to send a response to the Change in UDF. description: Operation to send a response to the Change in UDF.

OperationId:putUDFMapping

operationId: putUDFMapping parameters: - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedUDFMapping' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changeUDFMapping' description: Self-contained Request object that is used when Updating UDFMapping. required: true /upsert/hotels/{hotelId}/printers: put: summary: Operation to create/change printer. description: '

OperationId:putUpsertPrinter

' operationId: putUpsertPrinter parameters: - name: hotelId in: path required: true description: OPERA Id for Property schema: type: string maxLength: 2000 minLength: 1 - $ref: '#/components/parameters/authKey' - $ref: '#/components/parameters/externalData' - $ref: '#/components/parameters/x-app-key' - $ref: '#/components/parameters/x-request-id' - $ref: '#/components/parameters/x-originating-application' - $ref: '#/components/parameters/x-hotelid' - $ref: '#/components/parameters/x-externalsystem' - $ref: '#/components/parameters/Accept-Language' responses: '200': headers: Content-Language: description: Audience language x-example: en-GB schema: type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' Location: description: Location of newly created resource schema: type: string description: Response Body. content: application/json;charset=UTF-8: schema: $ref: '#/components/schemas/changedPrinter' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '405': $ref: '#/components/responses/405' '406': $ref: '#/components/responses/406' '413': $ref: '#/components/responses/413' '414': $ref: '#/components/responses/414' '415': $ref: '#/components/responses/415' '500': $ref: '#/components/responses/500' '502': $ref: '#/components/responses/502' '503': $ref: '#/components/responses/503' tags: - ExternalSystemsConfig requestBody: content: application/json;charset=UTF-8: schema: allOf: - $ref: '#/components/schemas/changePrinter' description: Request object for updating a new Printer and Print Task required: true components: schemas: hotelInterfaceErrorType: type: object properties: hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 actionName: description: Action Name type: string minLength: 0 maxLength: 40 message: description: Message type: string minLength: 0 maxLength: 4000 error: description: Error type: string minLength: 0 maxLength: 2000 resvNameId: description: Schema type: string minLength: 0 maxLength: 40 insertDate: description: Date time stamp of a Hotel Interface Schema. Uses database time zone. type: string format: date-time ifcType: description: ifcType type: string minLength: 0 maxLength: 4000 changeInterfaceUnitCharges: type: object description: Request object for updating Hotel Interface Unit Charges. properties: details: $ref: '#/components/schemas/interfaceUnitChargesType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' fetchedInterfaceUnitCharges: type: object description: Response object for retrieving the Interface Unit Charges. properties: details: $ref: '#/components/schemas/interfaceUnitChargesType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' interfaceRoomStatusType: type: object properties: hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 entryCode: description: Entry code of a Hotel Interface Room Status. type: string minLength: 0 maxLength: 2000 status: description: Room Status which is either Vacant (V) or Occupied (O). type: string minLength: 0 maxLength: 20 housekeepingStatus: description: Housekeeping status of a room. type: string minLength: 0 maxLength: 20 customRoomTranslation: description: Custom Room Translation of a Hotel Interface. It is a concatenation of a Status (V-Vacant or O-Occupied) and Housekeeping Status (IS-Inspected, CL-Clean, etc.) The delimiter is a period. Sample values are V.IS, V.CL, O.IS, O.CL. type: string minLength: 0 maxLength: 2000 description: description: Description of the Hotel Interface Room Status. type: string minLength: 0 maxLength: 2000 interfaceRoomStatusId: description: Row number to identify all the records belonging to a single group of Hotel Interface Room Status. type: integer changedExternalDeviceConfigurations: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' createDeliveryMethods: type: object description: Request to create the delivery method for a property/HUB/Chain and its configurations. properties: deliveryMethods: description: Collection of delivery method types to create. $ref: '#/components/schemas/configuredExternalDeliveryMethodsType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' hotelInterfaceFailedMessagesType: type: array description: Collection of Hotel Interface Failed Messages. maxItems: 4000 items: $ref: '#/components/schemas/hotelInterfaceFailedMessageType' changedInterfaceUnitCharges: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' pspEndpointValue: type: object description: Generic endpoint configuration. properties: endpointId: type: string description: obfuscated id. pspId: type: string description: PSP Id. opera9TerminalWsNo: type: string description: OPERA 9 TERMINAL value. pspEndpointParams: type: array description: Parameters for PSP endpoint configuration. items: $ref: '#/components/schemas/pspEndpointParamValue' interfaceAdditionalInfoType: type: object properties: menuType: description: Internal representation for Interface Type $ref: '#/components/schemas/ifcMenuTypeType' menuName: description: Name of the Interface sub-menu type: string minLength: 0 maxLength: 20 controllerPort: description: Opera IFC controller (server) port for the connecting clients. type: integer vncPort: description: VNC server port for connecting to a VNC server. type: integer cashierId: description: Cashier Number. type: integer pathId1: description: Used if interface has to support more than one front office system. type: integer timeout: description: Used by the Interface module. ( IFC7.exe ) type: string minLength: 0 maxLength: 3 displayFlag: description: True if the interface will be displayed. type: boolean autoStartFlag: description: Decides if the interface will be started automatically when the controller is restarted. type: boolean activeFlag: description: Indicator if the Hotel Interface is active or not. This is different from the Interface Status, which is either STOPPED or RUNNING. type: boolean interfaceStatus: description: Status if the Hotel Interface is STOPPED or RUNNING. This is different from the Active Flag, which is either 1 or 0. $ref: '#/components/schemas/hotelInterfaceStatusType' version: description: Version no. of each external interface that is installed type: string minLength: 0 maxLength: 10 msgExpiresAfter: description: (Internal Use) Message Expires After type: string minLength: 0 maxLength: 8 useDataThroughFlag: type: boolean nAStart: description: Indicator if the Hotel Interface handles night audit commands. type: boolean multipleRoomKey: description: Indicator if the Hotel Interface allows multiple room selection for keys. type: boolean onlineKeySystem: description: Indicator if the Hotel Interface is an online key system. type: boolean deleteIfcKeysOnKeyDelete: description: Indicator if the Interface Keys will be deleted on KeyDelete. type: boolean sendTrack1Data: description: Indicator for Hotel Interface Send Track 1 Data. type: boolean sendTrack2Data: description: Indicator for Hotel Interface Send Track 2 Data. type: boolean sendRoomStatus: description: Indicator if the Room Status will be sent. type: boolean telephoneCharge: description: Indicates on what the post unit charge is based on. $ref: '#/components/schemas/telephoneChargeType' additionalRoomsLimit: description: Maximum number of additional rooms allowed. type: integer minimum: 1 maximum: 999 sendValidStartDateTime: description: Indicator if the DLS Interface allows to send valid start date and time. type: boolean sequence: description: Display Order sequence for Interfaces type: number dMLCommandType: type: string enum: - Insert - Update - Delete description: A data manipulation language command for deleting an existing record. sVTransactionType: type: string description: Status of the Hotel Interface either STOPPED or RUNNING. enum: - OperaTransaction - VendorTransaction - OperaAndVendorTransaction classOfServiceType: type: object properties: cosMsgLmpRg: description: '' type: string minLength: 0 maxLength: 1 cosChkRg: description: '' type: string minLength: 0 maxLength: 1 cosMsgCmdRg: description: '' type: string minLength: 0 maxLength: 1 roomEquipCi: description: '' type: boolean roomEquipCo: description: '' type: boolean guestDataChangeCo: description: '' type: boolean standardNameFormat: description: Standard name format in the class of service. type: string minLength: 0 maxLength: 5 definedNameFormat: description: Defined name format in the class of service. type: array maxItems: 4000 items: $ref: '#/components/schemas/definedNameFormatType' resvInQueue: description: Indicates whethe a message will be triggered when a room/reservation is placed on QUEUE type: boolean printerSetupType: type: object description: Entity schema to persist Printers. properties: printerCode: description: Code for the printer. type: string minLength: 0 maxLength: 40 outputType: description: Default value "PRINT". $ref: '#/components/schemas/printerOutputType' description: description: Description of the printer record. type: string minLength: 0 maxLength: 2000 printerNetworkLocation: description: Full printer name (with path) for the printer. e.g. \\Printer\NewPrinter\ type: string minLength: 0 maxLength: 200 printerEmail: description: Email address for the printer. The print job will be emailed to this address to be printed. type: string minLength: 0 maxLength: 200 printerAttachedToServer: description: This flag signifies if Printer is attached to server or not. Server printers are used for printing background scheduled jobs. type: boolean inactiveDate: description: The date the record was marked as inactive. type: string format: date maxLength: 8 folioPrintingAllowed: description: This flag signifies that site is part of Fiscal Folio printing legal requirement and printer is already setup for the folio printing. type: boolean queueName: description: The queue name to send output to. type: string minLength: 0 maxLength: 200 hotelId: description: Properties to which printer belongs. Can be null. type: string minLength: 0 maxLength: 20 alertPrintingAllowed: description: This flag signifies if current printer can be used for printing alerts. type: boolean printTaskList: description: Print tasks attached to this printer. $ref: '#/components/schemas/codeListType' startBillNumber: description: Starting Bill No for the Printer. Used in Latin American Countries. type: integer managedBy: $ref: '#/components/schemas/managedByOptions' guestMessageDeliveryMethodType: type: object description: Guest text message configuration, settings for Text Message Delivery of Guest Messages properties: textMessage: $ref: '#/components/schemas/textMessageDeliveryConfigurationType' hotelInterfaceSchemaType: type: object properties: hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 actionName: description: Action Name type: string minLength: 0 maxLength: 40 schemaName: description: Schema Name type: string minLength: 0 maxLength: 40 schema: description: Schema type: string minLength: 0 maxLength: 4000 insertDate: description: Date time stamp of a Hotel Interface Schema. Uses database time zone. type: string format: date-time ifcType: description: ifcType type: string minLength: 0 maxLength: 4000 publishersType: type: array description: Information of all the publishers for a given subscriber. maxItems: 4000 items: $ref: '#/components/schemas/externalSystemType' faxDeliveryConfigurationType: type: object description: Email content configuration template properties: fromAddress: type: string minLength: 0 maxLength: 200 userId: type: string minLength: 0 maxLength: 80 userPassword: type: string minLength: 0 maxLength: 80 serverName: type: string minLength: 0 maxLength: 80 subject: type: string minLength: 0 maxLength: 2000 body: type: string minLength: 0 maxLength: 2000 format: description: 'EMAIL Format: HTML, RTF, PDF. Fax Format: TIF' $ref: '#/components/schemas/emailDeliveryFormatType' type: description: 'Deliver Type, possible values: AR, BILLING, CONFIRMATION, LEADS, OWS, OVOS.' $ref: '#/components/schemas/emailDeliveryMethodType' hotelId: description: Hotel code type: string minLength: 0 maxLength: 20 faxPrefix: type: string minLength: 0 maxLength: 20 faxSuffix: type: string minLength: 0 maxLength: 20 faxDomain: type: string minLength: 0 maxLength: 40 activateEmailToFax: description: This option must be selected in order to activate faxing from an SMTP compliant fax server type: boolean changeInterfaceRoomStatus: type: object description: Request object for updating a Hotel Interface Room Status. If it does not exist, then creates the Hotel Interface Room Status. properties: details: $ref: '#/components/schemas/interfaceRoomStatusType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' warningsType: type: array description: Used in conjunction with the Success element to define a business error. maxItems: 4000 items: $ref: '#/components/schemas/warningType' externalDatabaseAssociatedHotelType: type: object properties: hotelId: description: Pertain associated hotel code for external database. type: string minLength: 0 maxLength: 20 hotelName: description: Pertain associated hotel code for external database. type: string minLength: 0 maxLength: 80 uniqueID_Type: type: object description: An identifier used to uniquely reference an object in a system (e.g. an airline reservation reference, customer profile reference, booking confirmation number, or a reference to a previous availability quote). properties: id: description: A unique identifying value assigned by the creating system. The ID attribute may be used to reference a primary-key value within a database or in a particular implementation. type: string minLength: 0 maxLength: 80 type: description: A reference to the type of object defined by the UniqueID element. type: string minLength: 0 maxLength: 40 hotelInterfaceErrorsType: type: array description: Collection of Hotel Interface Errors. maxItems: 4000 items: $ref: '#/components/schemas/hotelInterfaceErrorType' classOfServiceConfigType: type: string description: Class Of Service is set to available and freely switchable. enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable fetchedInterfaceMachines: type: array description: Collection of Hotel Interface Machines. items: $ref: '#/components/schemas/interfaceMachineType' interfaceRightType: type: object properties: hotelId: description: Hotel Code to which the Interface Right belongs to. type: string minLength: 0 maxLength: 20 interfaceId: description: Unique DB internal number of a Hotel Interface record. $ref: '#/components/schemas/uniqueID_Type' right: description: Internal code for each allowed right of a Hotel Interface record. type: integer code: description: User defined code for an Interface Right. type: string minLength: 0 maxLength: 5 description: description: User defined description for an Interface Right. type: string minLength: 0 maxLength: 80 interfaceRightDescription: description: System Description of an allowed Interface Right. type: string minLength: 0 maxLength: 80 interfaceUnitChargesType: type: object description: Collection of Hotel Interface Unit Charges. properties: hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 unitCharges: type: array maxItems: 4000 items: $ref: '#/components/schemas/interfaceUnitChargeType' interfaceAccountType: type: object properties: hotelId: description: Hotel Code of the Interface Account. type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 postingAccount: description: Posting information of transaction codes setup. $ref: '#/components/schemas/postingAccountType' fetchedDeliveryMethods: type: object description: Response to request to fetch the delivery method for a property/HUB/Chain and its configurations. properties: deliveryMethods: description: Collection of all delivery method types. $ref: '#/components/schemas/configuredExternalDeliveryMethodsType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' interfaceRoomType: type: object properties: hotelId: description: Hotel Code of the Interface Room. type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 roomType: description: Front Office Room Type. type: string minLength: 0 maxLength: 20 roomId: description: Front Office Room Number. type: string minLength: 0 maxLength: 20 lineNumber: description: External System's extension number. type: string minLength: 0 maxLength: 20 oldLineNumber: description: External System's extension number. It is used for editing a record. It is logically part of the record ID, and can actually be updated. type: string minLength: 0 maxLength: 20 fromRoom: description: From Room Number type: string minLength: 1 maxLength: 20 toRoom: description: To Room Number type: string minLength: 1 maxLength: 20 fromLine: description: From Line Number type: string minLength: 1 maxLength: 20 toLine: description: To Line Number type: string minLength: 1 maxLength: 20 type: description: Line Type of an Interface Room. type: string minLength: 0 maxLength: 20 dataLine: description: I/O Lines type, which is either IN or OUT. $ref: '#/components/schemas/dataLineType' dataLineId: description: Translation Table Id as defined in the IFC_CTRL table. It is also referred as Xlat Id. type: string minLength: 0 maxLength: 100 wakeUpCall: description: Value to set/check if the wake up call functionality is enabled/disabled for the particular line number. type: boolean doNotDisturb: description: Value to set/check if the Do Not Disturb functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/doNotDisturbType' classOfService: description: Value to set/check if the Class of Service functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/classOfServiceConfigType' directInwardDial: description: Value to set/check if the Direct Inward Dial functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/directInwardDialType' messageWaiting: description: Value to set/check if the Message Waiting functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/messageWaitingType' maskDialNumber: description: Value to set/check the type number masking used for the particular line number. $ref: '#/components/schemas/maskDialNumberType' opiInfoType: type: object properties: tokenEndpoint: description: Token endpoint $ref: '#/components/schemas/pspEndpointValue' ccEndpoint: description: CreditCard endpoint $ref: '#/components/schemas/pspEndpointValue' pblEndpoint: description: PayByLink endpoint $ref: '#/components/schemas/pspEndpointValue' fetchedExternalDatabaseAvailableProperties: type: object description: Response object for retrieving the Available properties for External Databases. properties: availailableProperties: $ref: '#/components/schemas/externalDatabaseAssociatedHotelsType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' urlFormatType: type: string description: Url content format enum: - Xml - Text changeDeliveryMethods: type: object description: Request to change the delivery method for a property/HUB/Chain and its configurations. properties: deliveryMethods: description: Collection of delivery method types to change. $ref: '#/components/schemas/configuredExternalDeliveryMethodsType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' importRoomsType: type: object properties: requiresLineNumberSetup: description: Indicator for Requires line number setup, from Import Rooms related information of a Hotel Interface. type: boolean virtualNumberSetup: description: Indicator for Virtual number setup, from Import Rooms related information of a Hotel Interface. type: boolean ioLines: description: Indicator for support of Input/Output Lines for Hotel Room Categories. type: boolean inXlatId: description: Translation table for incoming messages. type: string minLength: 0 maxLength: 100 ouXlatId: description: Translation table for outgoing messages. type: string minLength: 0 maxLength: 100 selectedRoomTypes: description: Concatenated label of Hotel Room Categories for which SendToInterface flag should be set as true. type: string minLength: 0 maxLength: 4000 changedInterfaceRight: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' tCPConfigType: type: object properties: iPAddress: description: IP address of the interface server type: string minLength: 0 maxLength: 20 portNumber: description: Logical Port assignment type: string minLength: 0 maxLength: 80 codeListType: type: array maxItems: 4000 items: type: string minLength: 0 maxLength: 20 ifcMenuTypeType: type: string enum: - Cas - Kss - Mbs - Pbx - Pos - Vss - Dcs description: Data Card System instanceLink: type: object description: Metadata describing link description objects that MAY appear in the JSON instance representation. properties: href: description: URI [RFC3986] or URI Template [RFC6570]. If the value is set to URI Template, then the "templated" property must be set to true. type: string rel: description: Name of the link relation that, in addition to the type property, can be used to retrieve link details. For example, href or profile. type: string templated: description: Boolean flag that specifies that "href" property is a URI or URI Template. If the property is a URI template, set this value to true. By default, this value is false. type: boolean default: false method: description: HTTP method for requesting the target of the link. type: string enum: - GET - POST - PUT - DELETE - PATCH - OPTIONS - HEAD targetSchema: description: Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource.. type: string operationId: description: The operationId of the path you can call to follow this link. This allows you to look up not only the path and method, but the description of that path and any parameters you need to supply. type: string title: description: Exact copy of the "summary" field on the linked operation. type: string changeInterfaceRight: type: object description: Request object for updating a Hotel Interface Right. It will create the Hotel Interface Right if it does not exist on the database. properties: details: $ref: '#/components/schemas/interfaceRightType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' hotelInterfaceControllerRegsType: type: array description: Collection of Hotel Interface Controller Registry. maxItems: 4000 items: $ref: '#/components/schemas/hotelInterfaceControllerRegType' queueRushDeliveryMethodType: type: object description: Queue rush delivery method configuration, settings for Text Message Delivery of Queue Reservation status properties: textMessage: $ref: '#/components/schemas/textMessageDeliveryConfigurationType' fetchedExternalDeviceConfigurations: type: object properties: externalDeviceConfigurations: description: Collection of configurations for the external device. $ref: '#/components/schemas/externalDeviceConfigurationType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' interfaceUnitChargeType: type: object properties: trunkId: description: Trunk ID of the CAS or PBX. type: string minLength: 0 maxLength: 10 lineType: description: Line Types setup in IFC_ROOM table. type: string minLength: 0 maxLength: 10 vipCode: description: Guest VIP Code. type: string minLength: 0 maxLength: 40 startUnit: description: Starting number of units for the unit range. type: integer endUnit: description: Ending number of units for the unit range. type: integer pricePerUnit: description: Amount charged per unit. type: integer changedUDFMapping: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' fiscalPartnerCodeType: type: string description: Used for fiscal partner codes. Possible values of this pattern are 1, 101, 101.EQP, or 101.EQP.X. maxLength: 100 minLength: 0 deviceConfigurationType: type: object description: Type that contains the parameters and configurations used by the device. properties: name: description: Internal name of the configuration. type: string minLength: 0 maxLength: 80 displayName: description: Configuration display name. type: string minLength: 0 maxLength: 2000 value: description: Value of the configuration. type: string minLength: 0 maxLength: 2000 required: description: Flag that indicates whether the configuration is required or not. type: boolean encrypted: description: Flag that indicates whether the configuration value should be encrypted or not. type: boolean printerOutputType: type: string enum: - Print - Email hotelInterfaceType: type: object properties: interfaceId: description: Unique DB internal number of a Hotel Interface record. $ref: '#/components/schemas/uniqueID_Type' hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 interfaceName: description: Name of the Hotel Interface type: string minLength: 0 maxLength: 40 interfaceType: description: Three letter code for each interface that identifies the interface. $ref: '#/components/schemas/hotelInterfaceTypeType' logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 machineName: description: Unique machine name of the running IFC. type: string minLength: 0 maxLength: 80 status: description: The current status of the IFC. $ref: '#/components/schemas/hotelInterfaceStatusType' activeFlag: description: Indicator if the Hotel Interface is active or not. This is different from the Interface Status, which is either STOPPED or RUNNING. type: boolean outboundCode: description: Stores the Outbound Code to identify the target system. type: string minLength: 0 maxLength: 20 externalSystem: description: Stores the external system to identify the target system. type: string minLength: 0 maxLength: 40 generalInfoType: type: object properties: createSVCheckIn: description: Create stored value during checkin of a Hotel Interface type: boolean enableFailover: description: Enable failover of a Hotel Interface type: boolean ccVaultFunction: description: CC vault of a Hotel Interface type: boolean enableResend: description: Enable resend of a Hotel Interface type: boolean sendARAuthType: description: Send AR auth type of a Hotel Interface type: boolean enableDBVerification: description: Enable DB verification of a Hotel Interface type: boolean allowCCCancelTransaction: description: Allow CC cancel transactions of a Hotel Interface type: boolean showStoredValuePin: description: Show stored value pin of a Hotel Interface type: boolean showSVTransaction: description: Show SV transaction of a Hotel Interface $ref: '#/components/schemas/sVTransactionType' storedValueSystem: description: Stored value system of a Hotel Interface type: boolean sendEnhancedFields: description: Send enhanced fields of a Hotel Interface type: boolean cardPresentFlag: description: Card present of a Hotel Interface type: boolean handleNightAudit: description: Handle night audit command of a Hotel Interface type: boolean regularTransaction: description: Regular transaction command of a Hotel Interface type: boolean courtesyCardHandling: description: Courtesy card handling command of a Hotel Interface type: boolean sendEndOfDay: description: Send end of day of a Hotel Interface type: boolean portNumber1: description: Logical port number 1 of a the Hotel Interface type: string minLength: 0 maxLength: 40 portNumber2: description: Logical port number 2 of a the Hotel Interface type: string minLength: 0 maxLength: 40 portNumber3: description: Logical port number 3 of a the Hotel Interface type: string minLength: 0 maxLength: 40 portNumber4: description: Logical port number 4 of a the Hotel Interface type: string minLength: 0 maxLength: 200 iPAddress: description: IP Address of a the Hotel Interface type: string minLength: 0 maxLength: 40 sVRedeemTrx: description: Stored value reedeem transaction of a the Hotel Interface type: string minLength: 0 maxLength: 40 device: description: Device of a the Hotel Interface type: string minLength: 0 maxLength: 40 departmentCode1: description: Department code 1 of a the Hotel Interface type: string minLength: 0 maxLength: 40 departmentCode2: description: Department code 2 of a the Hotel Interface type: string minLength: 0 maxLength: 40 rollupTransactions: description: Rollup transactions flag of the Hotel Interface type: boolean allowVideoCheckout: description: Indicator if video checkout is allowed or not. type: boolean checkCreditLimit: description: One of the video checkout options whether to check the credit limit. type: boolean checkBalance: description: One of the video checkout options whether to check the balance. type: boolean checkRouting: description: One of the video checkout options whether to check the routing. type: boolean wakeupYn: description: Indicator if the Hotel Interface handles wakeup calls. type: boolean wakeupHandledBy: description: Determines who handles the wakeup calls, either by Opera (0) or a Vendor (1). type: string minLength: 0 maxLength: 1 wakeRetry: description: Wakeup retry limit of the Hotel Interface. Value range is 0 to 999. type: integer wakeDelay: description: Wakeup delay value of the Hotel Interface. type: integer prevWake: description: Used by the Interface module (IFC7.exe). type: integer folioDisplayOption: description: Folio display option of the Hotel Interface applicable to VID and MSC. "0" means folio display option off. "A" means a guest folio display option. "U" means user defined folio display option. type: string minLength: 0 maxLength: 1 userDefinedFolio1: description: Indicator if the User defined folio 1 is utilized. type: boolean userDefinedFolio2: description: Indicator if the User defined folio 2 is utilized. type: boolean userDefinedFolio3: description: Indicator if the User defined folio 3 is utilized. type: boolean userDefinedFolio4: description: Indicator if the User defined folio 4 is utilized. type: boolean displayPhoneName: description: Indicator if the phone name will be displayed. type: boolean keyPinActive: description: Indicator if the Key Pin is active or not. It is supported only if OPERA Control Display Key Pin is active. type: boolean allPrintDetailOn: description: Indicator for Default All Print Details On. type: boolean doNotDisturbType: type: string description: Do Not Disturb is set to available and freely switchable. enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable externalDatabaseAssociatedHotelsType: type: array description: Collection of Hotel for external database. maxItems: 4000 items: $ref: '#/components/schemas/externalDatabaseAssociatedHotelType' changedInterfaceAccount: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' fetchedHotelInterfaceSchemas: type: object description: Response object for retrieving Hotel Interface Schemas. properties: schemas: description: Collection of Hotel Interface Schemas. $ref: '#/components/schemas/hotelInterfaceSchemasType' totalPages: description: Evaluated total page count based on the requested max fetch count. type: integer offset: description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned. type: integer limit: description: Indicates maximum number of records a Web Service should return. type: integer hasMore: description: Indicates whether all the records are included in the response or not. Absence of the attribute values should be consider as all rows fetched in the response. type: boolean totalResults: description: Total number of rows queried type: integer links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' emailDeliveryFormatType: type: string description: Email delivery format enum: - Htmlcss - Pdf - Rtf - Tif arDeliveryMethodType: type: object description: Delivery Method configuration for Email and Fax Delivery for Accounts Receivables. properties: email: $ref: '#/components/schemas/emailDeliveryConfigurationType' fax: $ref: '#/components/schemas/faxDeliveryConfigurationType' status: type: object description: Response Body. properties: warnings: $ref: '#/components/schemas/warningsType' links: $ref: '#/components/schemas/links' interfaceCustomDataDetailsType: type: array description: Collection of custom data details of a hotel interface. maxItems: 4000 items: $ref: '#/components/schemas/interfaceCustomDataDetailType' fetchedUDFMappings: type: object description: Message received on an UDFs Lookup. properties: uDFMappings: description: Criteria for fetching UDFs. type: array items: $ref: '#/components/schemas/uDFMappingType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' hotelInterfaceControllerRegType: type: object properties: id: description: Internal ID to reference the records. type: number machine: description: Machine Name type: string minLength: 0 maxLength: 80 cntrlRegSetting: description: Controller Registry Setting type: string minLength: 0 maxLength: 20 data: description: Data type: string minLength: 0 maxLength: 400 description: description: Description type: string minLength: 0 maxLength: 4000 postingAccountType: type: object properties: id: description: Internal ID to reference the records. type: number paymentMethod: description: Payment method of posting accounts in transaction codes setup. type: string minLength: 0 maxLength: 10 account: description: Account of posting accounts in transaction codes setup. type: string minLength: 0 maxLength: 50 accountDescription: description: Account description of posting accounts in transaction codes setup. type: string minLength: 0 maxLength: 100 salesOutlet: description: Sales outlet of posting accounts in transaction codes setup. type: string minLength: 0 maxLength: 100 transactionCode: description: Transaction code of posting accounts in transaction codes setup. type: string minLength: 0 maxLength: 40 description: description: Description of posting accounts in transaction codes setup. type: string minLength: 0 maxLength: 2000 autoBalance: description: Auto balance flag of postings setup. type: boolean externalSystemCodeType: type: object description: External System Code properties: code: type: string minLength: 0 maxLength: 40 fetchedHotelInterfaceErrors: type: object description: Response object for retrieving Hotel Interface Errors. properties: hotelInterfaceErrors: description: Collection of Hotel Interface Errors. $ref: '#/components/schemas/hotelInterfaceErrorsType' totalPages: description: Evaluated total page count based on the requested max fetch count. type: integer offset: description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned. type: integer limit: description: Indicates maximum number of records a Web Service should return. type: integer hasMore: description: Indicates whether all the records are included in the response or not. Absence of the attribute values should be consider as all rows fetched in the response. type: boolean totalResults: description: Total number of rows queried type: integer links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' uDFMappingType: type: object description: Generic self-contained request object that is used when updating and fetching UDFs. properties: uDFName: description: Name of the user-defined function (UDF) field. type: string minLength: 0 maxLength: 40 uDFLabel: description: Label the user-defined function (UDF) field shared with external system which will be send in the request message for mapping of actual UDF Name. type: string minLength: 0 maxLength: 200 active: description: A flag to indicate whether the UDF mapping is active in the Interface system or not. type: boolean updateAllowed: description: A flag to indicate whether the update is allowed in the Interface system or not. type: boolean type: description: A reference to the type of object defined by the Type for Reservation and Profile Type. type: string minLength: 0 maxLength: 20 itemizerType: type: object properties: splitCode: description: Split code of the itemizer setup. type: string minLength: 0 maxLength: 10 splitPost: description: Split posting of the itemizer setup. type: integer splitText: description: Split text of the itemizer setup. type: string minLength: 0 maxLength: 50 splitFactor: description: Split factor of the itemizer setup. type: integer directInwardDialType: type: string description: Direct Inward Dial is set to available and freely switchable. enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable otherFolioDeliveryMethodType: type: object description: Delivery Method configuration for Email and Fax Delivery for Other Folios properties: email: $ref: '#/components/schemas/emailDeliveryConfigurationType' fax: $ref: '#/components/schemas/faxDeliveryConfigurationType' supportedExternalDeviceType: type: object properties: deviceType: description: Internal device type used to identify in which group the external device belongs to. $ref: '#/components/schemas/deviceType' deviceCode: description: Internal device code used to identify the external device. $ref: '#/components/schemas/deviceCode' deviceArea: description: The area where the device is installed type: string minLength: 0 maxLength: 40 displayName: description: External device display name. type: string minLength: 0 maxLength: 2000 mobileYN: description: Indicator if device type is mobile or desktop. type: boolean desktopYN: description: Indicator if device type is mobile or desktop. type: boolean registerAddress: description: The address which the Cash Register ID ( Device ID ) is associated with. type: string minLength: 0 maxLength: 200 deviceValue: description: External device Value. type: string minLength: 0 maxLength: 40 fiscalPartnerCode: description: Fiscal Partner associated with the terminal. $ref: '#/components/schemas/fiscalPartnerCodeType' primary: description: Flag to designate the primary Fiscal Terminal. type: boolean active: description: Flag that indicates whether the device is active. type: boolean id: type: string minLength: 0 maxLength: 100 label: type: string minLength: 0 maxLength: 100 translatableLabel: description: Translatable Label for the external devices. $ref: '#/components/schemas/translationTextType2000' iDEditable: type: boolean managedBy: $ref: '#/components/schemas/managedByOptions' description: External device details. fetchedInterfaceRoomStatuses: type: array description: Collection of Hotel Interface Room Statuses. items: $ref: '#/components/schemas/interfaceRoomStatusType' interfaceControlSpecType: type: object properties: hotelId: description: Hotel Code of the hotel interface. type: string minLength: 0 maxLength: 20 logo: description: Logo of the hotel interface. type: string minLength: 0 maxLength: 20 internalCode: description: Internal code of a translation specification setup. type: integer selector: description: Selector of a translation specification setup. type: string minLength: 0 maxLength: 100 specification: description: Specification of a translation specification setup. type: string minLength: 0 maxLength: 100 priority: description: Priority of a translation specification setup. type: string minLength: 0 maxLength: 100 position: description: Position of a translation specification setup. type: string minLength: 0 maxLength: 100 changedInterfaceMachine: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' billingFolioDeliveryMethodType: type: object description: Billing folio delivery method configuration, settings for Email and Fax Delivery of Guest Folios properties: email: $ref: '#/components/schemas/emailDeliveryConfigurationType' fax: $ref: '#/components/schemas/faxDeliveryConfigurationType' interfacePrimaryInfoType: type: object properties: interfaceId: description: Unique DB internal number of a Hotel Interface record. $ref: '#/components/schemas/uniqueID_Type' hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 interfaceName: description: Name of the Hotel Interface type: string minLength: 0 maxLength: 40 interfaceType: description: Three letter code for each interface that identifies the interface. $ref: '#/components/schemas/hotelInterfaceTypeType' productCode: description: Three letter code that uniquely identifies the external interface. type: string minLength: 0 maxLength: 4 licenseCode: description: Interface License code type: string minLength: 0 maxLength: 20 machineId: description: The ID stored in IFC_MACHINES table. type: integer machineName: description: Unique machine name of the running IFC. type: string minLength: 0 maxLength: 80 interfaceProductCode: description: FKT Logo required for the external interface. type: string minLength: 0 maxLength: 40 outboundCode: description: Stores the Outbound Code to identify the target system. type: string minLength: 0 maxLength: 20 externalSystem: description: Stores the External System Code to identify the target system. type: string minLength: 0 maxLength: 40 definedNameFormatType: type: object properties: hotelId: description: Hotel Code where the defined name format is associated. type: string minLength: 0 maxLength: 20 definedFormatId: description: ID of the defined name format. type: string minLength: 0 maxLength: 20 expressionTable: description: Table from which the info will be retrieved. type: string minLength: 0 maxLength: 200 expression: description: Expression of the defined name format It basically contains all formats that are being set. type: string minLength: 0 maxLength: 4000 logo: description: Logo of the hotel interface. type: string minLength: 0 maxLength: 20 generalDeliveryMethodType: type: object description: General delivery method SFTPConfigurationType configuration, settings for Email and Fax Delivery of General Letters properties: email: $ref: '#/components/schemas/emailDeliveryConfigurationType' fax: $ref: '#/components/schemas/faxDeliveryConfigurationType' sftpConfigurations: $ref: '#/components/schemas/sftpConfigurationsListType' interfaceCommunicationInfoType: type: object properties: tCPConfig: $ref: '#/components/schemas/tCPConfigType' hotelInterfaceFailedMessageType: type: object properties: hotelId: description: Hotel Code type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 actionName: description: Action Name type: string minLength: 0 maxLength: 40 message: description: Message type: string minLength: 0 maxLength: 4000 insertDate: description: Date time stamp of a Hotel Interface Schema. Uses database time zone. type: string format: date-time ifcType: description: ifcType type: string minLength: 0 maxLength: 4000 interfaceExportDataDetailsType: type: array description: Collection of export data details of a hotel interface. maxItems: 4000 items: $ref: '#/components/schemas/interfaceExportDataDetailType' fetchedPublishers: type: object description: Response to request to fetch the external systems properties: publishers: description: Collection of publisher external systems information. $ref: '#/components/schemas/publishersType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' changeExternalDeviceConfigurations: type: object description: Request to change the external device activated for the hotel and its configurations. properties: externalDeviceConfigurations: description: Configuration details of the external device that will be enabled for the hotel. $ref: '#/components/schemas/externalDeviceConfigurationType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' managedByOptions: description: Describes of the Configuration is Managed by Enterprise or Property. type: string enum: - EnterpriseManaged - PropertyManaged - EnterpriseEnforced - PropertyOverridden deviceType: type: string enum: - Scanner - CreditCard - Fiscal - Device changedPrinter: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' changeUDFMapping: type: object description: Self-contained Request object that is used when Updating UDFMapping. properties: uDFMapping: $ref: '#/components/schemas/uDFMappingType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' changedInterfaceRoomStatus: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' changedInterfaceRoom: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' changedDeliveryMethods: type: object description: Response Body. properties: links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' fetchedHotelInterfaceDetails: type: object description: Response object for retrieving the details of a Hotel Interface. properties: details: $ref: '#/components/schemas/hotelInterfaceDetailType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' hotelInterface: type: object description: Request object for creating a new Hotel Interface. properties: details: $ref: '#/components/schemas/hotelInterfaceDetailType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' emailDeliveryMethodType: type: string description: Email delivery method type enum: - Billing - Confirmation - General - Other - AR - PayByLink transactionCodeDetailType: type: object properties: servingPeriod: description: Serving period of transaction code setup. type: string minLength: 0 maxLength: 50 rowNum: description: Row number of transaction code setup. type: integer revenueCenter: description: Revenue center of transaction code setup. type: string minLength: 0 maxLength: 50 terminal: description: Terminal of transaction code setup. type: string minLength: 0 maxLength: 50 paymentNum: description: Payment number of transaction code setup. type: string minLength: 0 maxLength: 50 userId: description: User id of transaction code setup. type: string minLength: 0 maxLength: 50 postRoute: description: Post route of transaction code setup. type: string minLength: 0 maxLength: 50 dialedDigits: description: Dialed digits of transaction code setup. type: string minLength: 0 maxLength: 50 lineType: description: Line type of transaction code setup. type: string minLength: 0 maxLength: 50 code: description: Code of transaction code setup. type: string minLength: 0 maxLength: 50 tipCode: description: Tip code of transaction code setup. type: string minLength: 0 maxLength: 50 description: description: Description of transaction code setup. type: string minLength: 0 maxLength: 50 itemizersShortInfo: description: Itemizer short info of transaction code setup. type: array maxItems: 4000 items: $ref: '#/components/schemas/itemizerShortInfoType' fetchedHotelInterfaceControllerRegistry: type: object description: Response object for retrieving Hotel Interface Controller Registry. properties: reg: description: Collection of Hotel Interface Controller Registry. $ref: '#/components/schemas/hotelInterfaceControllerRegsType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' changePrinter: type: object description: Request object for updating a new Printer and Print Task properties: printerSetup: $ref: '#/components/schemas/printerSetupType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' warningType: type: object description: Used when a message has been successfully processed to report any warnings or business errors that occurred. properties: value: type: string description: Property Value shortText: description: An abbreviated version of the error in textual format. type: string maxLength: 2000 code: description: If present, this refers to a table of coded values exchanged between applications to identify errors or warnings. type: string minLength: 0 maxLength: 20 docURL: description: If present, this URL refers to an online description of the error that occurred. type: string maxLength: 2000 status: description: If present, recommended values are those enumerated in the ErrorRS, (NotProcessed Incomplete Complete Unknown) however, the data type is designated as string data, recognizing that trading partners may identify additional status conditions not included in the enumeration. type: string maxLength: 2000 tag: description: If present, this attribute may identify an unknown or misspelled tag that caused an error in processing. It is recommended that the Tag attribute use XPath notation to identify the location of a tag in the event that more than one tag of the same name is present in the document. Alternatively, the tag name alone can be used to identify missing data [Type=ReqFieldMissing]. type: string maxLength: 2000 recordId: description: If present, this attribute allows for batch processing and the identification of the record that failed amongst a group of records. This value may contain a concatenation of a unique failed transaction ID with specific record(s) associated with that transaction. type: string maxLength: 2000 type: description: The Warning element MUST contain the Type attribute that uses a recommended set of values to indicate the warning type. The validating XSD can expect to accept values that it has NOT been explicitly coded for and process them by using Type ="Unknown". type: string minLength: 0 maxLength: 20 language: description: Language identification. type: string pattern: '[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*' rph: description: Reference Place Holder used as an index for this warning. type: string minLength: 1 maxLength: 8 exceptionDetailType: title: Error Detail description: Complex type that contains error details for a REST call. type: object properties: type: type: string description: Absolute URI [RFC3986] that identifies the problem type. When dereferenced, it SHOULD provide a human-readable summary of the problem (for example, using HTML). title: type: string description: Short, human-readable summary of the problem. The summary SHOULD NOT change for subsequent occurrences of the problem, except for purposes of localization. status: type: integer description: HTTP status code for this occurrence of the problem, set by the origin server. detail: type: string description: Human-readable description specific to this occurrence of the problem. instance: type: string description: Absolute URI that identifies the specific occurrence of the problem. It may or may not provide additional information if dereferenced. o:errorCode: type: string description: Application error code, which is different from HTTP error code. o:errorPath: type: string description: Path to the problem at the resource or property level. o:errorDetails: description: Details of the error message, consisting of a hierarchical tree structure. type: array items: $ref: '#/components/schemas/errorInstance' links: $ref: '#/components/schemas/links' required: - type - title importInterfaceRooms: type: object description: Request object for importing the Interface Rooms for a Hotel Interface record. properties: details: $ref: '#/components/schemas/importInterfaceRoomsType' dMLCommand: $ref: '#/components/schemas/dMLCommandType' targetedImport: $ref: '#/components/schemas/interfaceRoomType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' translationTextType2000: type: object description: Contains Multiple translated texts and language codes. properties: defaultText: description: Default text with Character length from 0 to 2000. type: string minLength: 0 maxLength: 2000 translatedTexts: description: List of translated text and language codes. $ref: '#/components/schemas/translationsTextType' changeInterfaceMachine: type: object description: Request object for updating a Hotel Interface Machine. If it does not exist, then creates the Hotel Interface Machine. properties: details: $ref: '#/components/schemas/interfaceMachineType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' hotelInterfaceStatusType: type: string description: Status of the Hotel Interface either STOPPED or RUNNING. enum: - Stopped - Running - Waiting - StopInitiated - StartInitiated - RebootInitiated - Other interfaceControlArticleType: type: object properties: hotelId: description: Hotel Code of the hotel interface. type: string minLength: 0 maxLength: 20 logo: description: Logo of the hotel interface. type: string minLength: 0 maxLength: 20 internalCode: description: Internal code of a translation article setup. type: integer selector: description: Selector of a translation article setup. type: string minLength: 0 maxLength: 100 articleNo: description: Article Number of a translation article setup. type: string minLength: 0 maxLength: 100 description: description: Description of a translation article setup. type: string minLength: 0 maxLength: 100 interfaceExportDataDetailType: type: object description: This gives information of export detail of a hotel interface. properties: sourceTableName: description: Specifies the table where the event data is stored. type: string minLength: 0 maxLength: 50 columnName: description: Specifies the column name found in the table. type: string minLength: 0 maxLength: 50 dataType: description: Specifies the type of data in the column. type: string minLength: 0 maxLength: 20 dataLength: description: Specifies the length of data in the column. type: integer xMLTagName: description: Specifies the tag name found in the export. type: string minLength: 0 maxLength: 50 columnSelected: description: Specifies whether the column is chosen to be included in the export. type: boolean dataLineType: type: string enum: - In - Out description: Line Out hotelExternalDevicesType: type: object description: Type for the external device supported by the hotel. properties: hotelId: description: Property for which the device is configured. type: string minLength: 0 maxLength: 20 supportedDevices: $ref: '#/components/schemas/supportedExternalDevicesType' configuredExternalDeliveryMethodsType: type: object description: External system configuration delivery methods for a property(chain or hub). properties: general: $ref: '#/components/schemas/generalDeliveryMethodType' queueReservation: $ref: '#/components/schemas/queueReservationDeliveryMethodType' confirmation: $ref: '#/components/schemas/confirmationDeliveryMethodType' guestMessage: $ref: '#/components/schemas/guestMessageDeliveryMethodType' billingFolio: $ref: '#/components/schemas/billingFolioDeliveryMethodType' queueRush: $ref: '#/components/schemas/queueRushDeliveryMethodType' ar: $ref: '#/components/schemas/arDeliveryMethodType' otherFolios: $ref: '#/components/schemas/otherFolioDeliveryMethodType' payByLink: $ref: '#/components/schemas/payByLinkDeliveryMethodType' interfaceControlCfgType: type: object properties: hotelId: description: Hotel Code of the hotel interface. type: string minLength: 0 maxLength: 20 logo: description: Logo of the hotel interface. type: string minLength: 0 maxLength: 20 internalCode: description: Internal code of a translation configuration setup. type: integer originCode: description: Origin code of a translation configuration setup. type: string minLength: 0 maxLength: 100 merchantId: description: Merchant Id of a translation configuration setup. type: string minLength: 0 maxLength: 100 deviceCode: type: string enum: - TtiScannerMobile - TtiScannerDesktop - SamsotechScanner - GenScannerDesktop - GenScannerMobile - ChipAndPin - FiscalTerminal - Device hotelInterfaceSchemasType: type: array description: Collection of Hotel Interface Schemas. maxItems: 4000 items: $ref: '#/components/schemas/hotelInterfaceSchemaType' workstationSetupType: type: array description: List of workstations of a hotel interface. maxItems: 4000 items: $ref: '#/components/schemas/interfaceWorkstationType' sftpConfigurationType: type: object description: Information which uniquely identifies SFTP Configuration properties: configurationId: description: Unique id associated with this configuration type: integer destination: description: SFTP destination type: string minLength: 0 maxLength: 20 description: description: Description of the destination, such as Shift Reports. type: string minLength: 0 maxLength: 200 inactive: description: Indicates whether the configuration is inactive or not. type: boolean hotelId: description: Hotel code type: string minLength: 0 maxLength: 20 transactionCodeInfoType: type: object properties: allChargesCode: description: All charges code of transaction code setup type: string minLength: 0 maxLength: 10 miniBarCode: description: Minibar charges code of transaction code setup type: string minLength: 0 maxLength: 10 cashCreditCardPosting: description: Cash or credit card posting of transaction code setup type: string minLength: 0 maxLength: 1 subtotalPosting: description: Subtotal posting of transaction code setup type: string minLength: 0 maxLength: 1 differencePosting: description: Difference posting of transaction code setup type: string minLength: 0 maxLength: 1 calcTrxCodePosting: description: Calculated transaction code posting of transaction code setup type: string minLength: 0 maxLength: 1 numberOfDialedDigits: description: Number of dialed digits transaction code setup type: string minLength: 0 maxLength: 1 postingAccounts: description: Postings information of transaction codes setup. type: array maxItems: 4000 items: $ref: '#/components/schemas/postingAccountType' itemizers: description: Split information of transaction code setup. type: array maxItems: 4000 items: $ref: '#/components/schemas/itemizerType' transactionCodes: description: Split information of transaction code setup. type: array maxItems: 4000 items: $ref: '#/components/schemas/transactionCodeDetailType' interfaceMachineType: type: object properties: id: description: Unique Id for every interface machine. $ref: '#/components/schemas/uniqueID_Type' machine: description: Unique Machine name of the running Interface. type: string minLength: 0 maxLength: 80 program: description: Path and name of the Interface program running on every Machine. type: string minLength: 0 maxLength: 2000 controllerPort: description: Opera Interface controller (server) port for the connecting clients. type: integer vncPort: description: VNC server port for connecting to the VNC server. type: integer changeInterfaceAccount: type: object description: Request object for updating an Interface Account of a Hotel Interface record. properties: account: $ref: '#/components/schemas/interfaceAccountType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' maskDialNumberType: type: string description: Mask the dialled digits as per the room configuration. enum: - NoMasking - MaskLast2Digits - MaskLast4Digits - Mask4DigitsLeaveLast2Intact - MaskAllExceptFirst2 - MaskAll - MaskingPerRoom configuredExternalDevices: type: object description: Collection of hotels and the external devices that were configured for the hotel. properties: deviceType: $ref: '#/components/schemas/deviceType' supportedExternalDevices: type: array maxItems: 4000 items: $ref: '#/components/schemas/hotelExternalDevicesType' interfaceExportDataInfoType: type: object description: This type holds the export data of a hotel interface. properties: interfaceExportDataDetails: description: Collection which shows the manually selected columns for the export data of a hotel interface. $ref: '#/components/schemas/interfaceExportDataDetailsType' interfaceExportDataMandatoryDetails: description: Collection which shows the mandatory columns for the export data of a hotel interface. $ref: '#/components/schemas/interfaceExportDataDetailsType' confirmationDeliveryMethodType: type: object description: Confirmation letter delivery method configuration, settings for Text Message, Email and Fax Delivery of Confirmation Letters properties: email: $ref: '#/components/schemas/emailDeliveryConfigurationType' fax: $ref: '#/components/schemas/faxDeliveryConfigurationType' textMessage: $ref: '#/components/schemas/textMessageDeliveryConfigurationType' interfaceCustomDataInfoType: type: object description: This type holds the custom data of a hotel interface. properties: exportAsXml: description: Specifies whether the details have to be exported as XML. If true, then the details are exported as XML else details are exported as text. type: boolean includeDoorcardField: description: Specifies whether the Doorcard field details have to be included in the XML Export. If true, Doorcard field details will be included in the XML Export else details will not be included. This field is available only when the Export as XML field is selected. type: boolean interfaceCustomDataDetails: description: Collection of custom data details of a hotel interface. $ref: '#/components/schemas/interfaceCustomDataDetailsType' operaVersionNumberType: type: string description: Current Opera Version Number minLength: 0 maxLength: 40 hotelInterfacesType: type: array description: Collection of Hotel Interfaces. maxItems: 4000 items: $ref: '#/components/schemas/hotelInterfaceType' supportedExternalDevicesType: type: array maxItems: 4000 items: $ref: '#/components/schemas/supportedExternalDeviceType' fetchedInterfaceRooms: type: array description: Collection of Hotel Interface Rooms. items: $ref: '#/components/schemas/interfaceRoomType' payByLinkDeliveryMethodType: type: object description: Pay By Link delivery method configuration, settings for Email containing payment url properties: email: $ref: '#/components/schemas/emailDeliveryConfigurationType' itemizerShortInfoType: type: object properties: code: description: Code of the itemizer on a transaction code setup. type: string minLength: 0 maxLength: 50 itemizerName: description: Itemizer name on a transaction code setup. type: string minLength: 0 maxLength: 50 itemNumber: description: Itemizer number which is the split post on a transaction code setup. type: integer translationsTextType: type: array description: Language code for the translation. maxItems: 4000 items: type: object properties: value: type: string description: Used for Character Strings, length 0 to 2000. minLength: 0 maxLength: 2000 language: description: Language identification. type: string minLength: 0 maxLength: 20 description: Language code for the translation. interfaceCustomDataDetailType: type: object description: This gives information of custom detail of a hotel interface. properties: customDataField: description: Specifies the type of data stored. type: string minLength: 0 maxLength: 200 customDataValue: description: Specifies the actual data corresponding to each value in the field. type: string minLength: 0 maxLength: 2000 createInterfaceRoom: type: object description: Request object for creating an Interface Room of a Hotel Interface record. properties: room: $ref: '#/components/schemas/interfaceRoomType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' translationType: type: object properties: guestNoLength: description: Guest number length of a translation setup. type: string minLength: 0 maxLength: 2 guestMessageIdLength: description: Guest message id length of a translation setup. type: string minLength: 0 maxLength: 2 groupNoLength: description: Group number length of a translation setup. type: string minLength: 0 maxLength: 2 defaultCharge: description: Default charge of a translation setup. type: integer configuation: description: Translation configuration of a hotel interface. type: array maxItems: 4000 items: $ref: '#/components/schemas/interfaceControlCfgType' articles: description: Translation article setup of a hotel interface. type: array maxItems: 4000 items: $ref: '#/components/schemas/interfaceControlArticleType' specifications: description: Translation specifications setup of a hotel interface. type: array maxItems: 4000 items: $ref: '#/components/schemas/interfaceControlSpecType' languages: description: Translation languages setup of a hotel interface. type: array maxItems: 4000 items: $ref: '#/components/schemas/interfaceControlLangType' changeInterfaceRoom: type: object description: Request object for updating an Interface Room of a Hotel Interface record. properties: room: $ref: '#/components/schemas/interfaceRoomType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' roomMaskSetupType: type: object properties: wakeUpCall: description: Value to set/check if the wake up call functionality is enabled/disabled for the particular line number. type: boolean doNotDisturb: description: Value to set/check if the Do Not Disturb functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/doNotDisturbType' classOfService: description: Value to set/check if the Class of Service functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/classOfServiceConfigType' directInwardDial: description: Value to set/check if the Direct Inward Dial functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/directInwardDialType' messageWaiting: description: Value to set/check if the Message Waiting functionality is enabled/disabled/NA for the particular line number. $ref: '#/components/schemas/messageWaitingType' maskDialNumber: description: Value to set/check the type number masking used for the particular line number. $ref: '#/components/schemas/maskDialNumberType' fetchedInterfaceRights: type: array description: Collection of Hotel Interface Rights. items: $ref: '#/components/schemas/interfaceRightType' fetchedHotelInterfaces: type: object description: Response object for retrieving Hotel Interfaces. properties: hotelInterfaces: description: Collection of Hotel Interfaces. $ref: '#/components/schemas/hotelInterfacesType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' errorInstance: title: Error Instance Details description: Complex type that contains error instance details for a REST call. type: object properties: type: type: string description: Absolute URI [RFC3986] that identifies the problem type. When dereferenced, it SHOULD provide a human-readable summary of the problem (for example, using HTML). title: type: string description: Short, human-readable summary of the problem. The summary SHOULD NOT change for subsequent occurrences of the problem, except for purposes of localization. status: type: integer description: HTTP status code for this occurrence of the problem, set by the origin server. detail: type: string description: Human-readable description specific to this occurrence of the problem. instance: type: string description: Absolute URI that identifies the specific occurrence of the problem. It may or may not provide additional information if dereferenced. o:errorCode: type: string description: Application error code, which is different from HTTP error code. o:errorPath: type: string description: Path to the problem at the resource or property level. required: - type - title interfaceControlLangType: type: object properties: hotelId: description: Hotel Code of the hotel interface. type: string minLength: 0 maxLength: 20 logo: description: Logo of the hotel interface. type: string minLength: 0 maxLength: 20 internalCode: description: Internal code of a translation language setup. type: integer selector: description: Selector of a translation language setup. type: string minLength: 0 maxLength: 100 languageCode: description: Language code of a translation language setup. type: string minLength: 0 maxLength: 100 hotelInterfaceDetailType: type: object properties: primaryInfo: description: Primary information of a Hotel Interface. $ref: '#/components/schemas/interfacePrimaryInfoType' additionalInfo: description: Additional information of a Hotel Interface. $ref: '#/components/schemas/interfaceAdditionalInfoType' generalInfo: description: General information of a Hotel Interface. $ref: '#/components/schemas/generalInfoType' communicationInfo: description: Communication related information of a Hotel Interface. $ref: '#/components/schemas/interfaceCommunicationInfoType' translationInfo: description: Communication related information of a Hotel Interface. $ref: '#/components/schemas/translationType' classOfServiceInfo: description: Information related to Class of Service of a Hotel Interface. $ref: '#/components/schemas/classOfServiceType' importRoomsInfo: description: Information related to Import Rooms of a Hotel Interface. $ref: '#/components/schemas/importRoomsType' workstationSetupInfo: description: Workstation setup of a hotel interface. $ref: '#/components/schemas/workstationSetupType' postingsInfo: description: Postings of a hotel interface. $ref: '#/components/schemas/postingInfoType' customDataInfo: description: Information related to Custom Data of a Hotel Interface. $ref: '#/components/schemas/interfaceCustomDataInfoType' exportDataInfo: description: Information related to Export Data of a Hotel Interface. $ref: '#/components/schemas/interfaceExportDataInfoType' transactionsInfo: description: Postings of a hotel interface. $ref: '#/components/schemas/transactionCodeInfoType' opiOnboardingInfo: description: Information required to onboard OPI $ref: '#/components/schemas/opiInfoType' postingInfoType: type: object properties: referenceField: description: Reference field of postings setup. type: string minLength: 0 maxLength: 1 chargeScaling: description: Charge scaling of postings setup. type: string minLength: 0 maxLength: 1 zeroChargePostings: description: Zero charge posting of postings setup. type: string minLength: 0 maxLength: 1 postings: description: Postings of postings setup. type: string minLength: 0 maxLength: 1 postType: description: Post type of postings setup. type: string minLength: 0 maxLength: 1 conversion: description: Conversion of postings setup. type: integer reference: description: Reference of postings setup. type: string minLength: 0 maxLength: 50 supplement: description: Supplement of postings setup. type: string minLength: 0 maxLength: 50 overrideCreditLimit: description: Override credit limit of postings setup. type: boolean noPostFlag: description: No post flag of postings setup. type: boolean generatesTax: description: IFC generate tax of postings setup. type: boolean dialedNumberMasking: description: Type of number masking used for the dialed numbers in the particular interface. $ref: '#/components/schemas/maskDialNumberType' articleNoPrefix: description: Article Prefix of postings setup. type: boolean emailDeliveryConfigurationType: type: object description: Email content configuration template properties: fromAddress: type: string minLength: 0 maxLength: 200 userId: type: string minLength: 0 maxLength: 80 userPassword: type: string minLength: 0 maxLength: 80 serverName: type: string minLength: 0 maxLength: 80 subject: type: string minLength: 0 maxLength: 2000 body: type: string minLength: 0 maxLength: 2000 format: description: 'EMAIL Format: HTML, RTF, PDF. Fax Format: TIF' $ref: '#/components/schemas/emailDeliveryFormatType' type: description: 'Deliver Type, possible values: AR, BILLING, CONFIRMATION, LEADS, OWS, OVOS.' $ref: '#/components/schemas/emailDeliveryMethodType' hotelId: description: Hotel code type: string minLength: 0 maxLength: 20 activateDelivery: description: This option must be selected in order to activate emailing from an SMTP compliant email server type: boolean hTMLFormatDelivery: description: Available for Confirmation Letters only and when Activate Email Delivery is selected type: boolean attachICalender: type: boolean outboundCode: description: Outbound Code type: string minLength: 0 maxLength: 20 externalDeviceConfigurationType: type: object description: Type for the configurations available to the device. properties: hotelId: description: Property for which the device is configured. type: string minLength: 0 maxLength: 20 device: description: External device. $ref: '#/components/schemas/supportedExternalDeviceType' deviceConfigurations: type: array maxItems: 4000 items: $ref: '#/components/schemas/deviceConfigurationType' codeMappings: description: Type that contains the mappings of the codes used in the external device to the code used in OPERA. type: array maxItems: 4000 items: $ref: '#/components/schemas/deviceMappingType' fetchedConfiguredExternalDevices: type: object properties: configuredExternalDevices: description: Collection of all active external devices. $ref: '#/components/schemas/configuredExternalDevices' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' queueReservationDeliveryMethodType: type: object description: Queue reservation delivery method configuration, settings for Text Message Delivery of Queue Reservation status properties: textMessage: $ref: '#/components/schemas/textMessageDeliveryConfigurationType' pspEndpointParamValue: type: object description: Parameter key-value for PSP endpoint. properties: paramId: type: string value: type: string textMessageDeliveryConfigurationType: type: object description: Text message delivery configuration properties: userId: description: Partner or User ID, Text field for Partner ID or User ID for the delivery provider, Name of the Text Messaging Provider. type: string minLength: 0 maxLength: 80 serverName: description: Text field for Service type or email server address for the SMTP. type: string minLength: 0 maxLength: 80 account: description: Text field for Service ID or email account for the SMTP as advised by Text Messaging Provider. type: string minLength: 0 maxLength: 80 password: type: string minLength: 0 maxLength: 80 timeOut: description: Number field for Delivery time out in seconds for the message. Any message exceeding this limit will be timed out. Add word Seconds using small grey font next to the number box. type: integer url: description: Text field for URL address or the Text Messaging Provider. type: string minLength: 0 maxLength: 2000 uRLParameter: description: Url parameter(format) is supported by Text Messaging Provider, it can be either an XML or TEXT format. $ref: '#/components/schemas/urlFormatType' format: description: Text field for entering any special formatting for the delivery, or multi select LOV type, for example the one used for Address Format for selection of SID fields, to allow users choosing from a list of tags that may be used to customize this field. type: string minLength: 0 maxLength: 4000 message: description: Text field for entering the Text Message for delivery. type: string minLength: 0 maxLength: 4000 type: description: 'Type of Delivery Method HTTP/SMTP: HTTP for URL, SMTP for Email' $ref: '#/components/schemas/textDeliveryMethodType' hotelId: description: Hotel code type: string minLength: 0 maxLength: 20 telephoneChargeType: type: string enum: - '0' - '1' - '2' description: Auto Choose externalSystemType: type: object description: External System Information properties: hotelId: type: string minLength: 0 maxLength: 20 externalSystemCode: $ref: '#/components/schemas/externalSystemCodeType' sftpConfigurationsListType: type: array description: Type that holds sftp configurations maxItems: 4000 items: $ref: '#/components/schemas/sftpConfigurationType' interfaceWorkstationType: type: object properties: hotelId: description: Hotel Code of a workstation. type: string minLength: 0 maxLength: 20 logo: description: Logo of a workstation. type: string minLength: 0 maxLength: 20 internalCode: description: Internal code of a workstation. type: integer workstation: description: Workstation of a hotel interface. type: string minLength: 0 maxLength: 200 deviceIp: description: IP of a workstation. type: string minLength: 0 maxLength: 200 orderSequence: description: Display Order sequence. type: number location: description: Location of a workstation. type: string minLength: 0 maxLength: 200 type: description: Type of a workstation. type: string minLength: 0 maxLength: 2 deviceLocation: description: Device Group / Area. type: string minLength: 0 maxLength: 40 textDeliveryMethodType: type: string description: Text delivery method type enum: - Url - Email createPublishers: type: object description: Request to create publishers. properties: subscriber: description: Subscriber external system information. $ref: '#/components/schemas/externalSystemType' publishers: description: Collection of publisher external systems information. $ref: '#/components/schemas/publishersType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' operaVersion: type: object description: Response for Ping operation. properties: operaVersion: description: Opera version number. $ref: '#/components/schemas/operaVersionNumberType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' links: type: array items: $ref: '#/components/schemas/instanceLink' deviceMappingType: type: object description: Type that contains the codes used in/provided by the external device and their counterpart in OPERA. properties: codeType: description: Internal code type of the mapping entry. type: string minLength: 0 maxLength: 800 externalCode: description: Code used/provided by the external device or application. type: string minLength: 0 maxLength: 2000 displayName: description: Display name of the code mapping. type: string minLength: 0 maxLength: 2000 operaCode: description: Corresponding code value in OPERA. type: string minLength: 0 maxLength: 2000 messageWaitingType: type: string description: Message Waiting is set to available and freely switchable. enum: - NotAvailable - AlwaysOn - AlwaysOff - FreelySwitchable importInterfaceRoomsType: type: object properties: hotelId: description: Hotel Code to which the Interface Room belongs to. type: string minLength: 0 maxLength: 20 logo: description: Hotel Interface Logo. On the database, this is also referred as DBF Logo. This is a three letter code followed by an underscore(_). This tells us which DBF files and log files with the prefix that IFC7 is going to create. type: string minLength: 0 maxLength: 20 dataLine: description: I/O Lines type, which is either IN or OUT. $ref: '#/components/schemas/dataLineType' numberOfLines: description: Number of lines to use for the import of a Hotel Interface Room. type: integer removeLeadingZeros: description: Number of lines to use for the import of a Hotel Interface Room. type: boolean line1Prefix: description: Prefix for the Hotel Interface Room number for Line 1. type: integer line1AddTo: description: Numeric value to be summed with the Hotel Interface Room number for Line 1. type: integer line2Prefix: description: Prefix for the Hotel Interface Room number for Line 2. type: integer line2AddTo: description: Numeric value to be summed with the Hotel Interface Room number for Line 2. type: integer line3Prefix: description: Prefix for the Hotel Interface Room number for Line 3. type: integer line3AddTo: description: Numeric value to be summed with the Hotel Interface Room number for Line 3. type: integer line4Prefix: description: Prefix for the Hotel Interface Room number for Line 4. type: integer line4AddTo: description: Numeric value to be summed with the Hotel Interface Room number for Line 4. type: integer selectedRoomTypes: description: Concatenated label of Hotel Room Categories, which will be imported to the Hotel Interface. type: string minLength: 0 maxLength: 4000 maskLines: description: Mask configurations for different line types. type: array maxItems: 4000 items: $ref: '#/components/schemas/roomMaskSetupType' fetchedHotelInterfaceFailedMessages: type: object description: Response object for retrieving Hotel Interface Failed Messages. properties: messages: description: Collection of Hotel Interface Failed Messages. $ref: '#/components/schemas/hotelInterfaceFailedMessagesType' totalPages: description: Evaluated total page count based on the requested max fetch count. type: integer offset: description: Index or initial index of the set(page) being requested. If the index goes out of the bounds of the total set count then no data will be returned. type: integer limit: description: Indicates maximum number of records a Web Service should return. type: integer hasMore: description: Indicates whether all the records are included in the response or not. Absence of the attribute values should be consider as all rows fetched in the response. type: boolean totalResults: description: Total number of rows queried type: integer links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' createInterfaceAccount: type: object description: Request object for creating an Interface Account of a Hotel Interface record. properties: account: $ref: '#/components/schemas/interfaceAccountType' links: $ref: '#/components/schemas/links' warnings: $ref: '#/components/schemas/warningsType' hotelInterfaceTypeType: type: string enum: - Bms - Cas - Ccw - Dls - Eft - Exp - Mak - Mbs - Msc - Pbx - Pos - Svs - Tik - Vid - Vms - Www - Xml description: XML Posting Interface responses: '406': description: Not acceptable. '414': description: Request URI Too Large '503': description: Service Unavailable '413': description: Request Entity Too Large '500': description: System Error content: application/json: schema: $ref: '#/components/schemas/exceptionDetailType' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/exceptionDetailType' '502': description: Bad Gateway '403': description: Forbidden '415': description: Unsupported Media Type '404': description: Resource not found content: application/json: schema: $ref: '#/components/schemas/exceptionDetailType' '401': description: Unauthorized '405': description: Method not allowed parameters: x-hotelid: name: x-hotelid description: Mandatory parameter to identify the hotel code where the end user is logged in in: header required: true schema: type: string authKey: name: authorization description: Bearer token that needs to be passed which is generated post user authentication in: header required: true schema: type: string externalData: name: externalData description: Pass this header as true, if payload needs DVM in: header schema: type: string Accept-Language: name: Accept-Language description: Language code in: header schema: type: string x-app-key: name: x-app-key description: Client or Partner's Application Key in: header required: true schema: type: string pattern: ^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89aAbB][a-f0-9]{3}-[a-f0-9]{12}$ x-externalsystem: name: x-externalsystem description: External system code. in: header x-example: EXTERNALSYSTEMCODE schema: type: string maxLength: 40 x-originating-application: name: x-originating-application description: Customer's Integration Application Id in: header schema: type: string x-request-id: name: x-request-id description: Request Id of an incoming request in: header schema: type: string pattern: ~*[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12} externalDocs: description: Find out more about Oracle Hospitality url: https://docs.oracle.com/en/industries/hospitality/integration_platforms.html