Oracle Hospitality

Oracle Hospitality External Systems Config API

The ExternalSystemsConfig API from Oracle Hospitality — 27 operation(s) for externalsystemsconfig.

GitHub OpenAPI

Operations 43

GET /configuredExternalDevices Operation to fetch configured external devices. #
GET /deliveryMethods Operation to fetch delivery methods. #
PUT /deliveryMethods Operation to change delivery methods. #
DELETE /deliveryMethods Operation to remove delivery methods. #
POST /deliveryMethods Operation to create delivery methods. #
GET /externalDevices/configurations Operation to fetch external device configurations. #
PUT /externalDevices/configurations Operation to change external device configurations. #
GET /externalSystems/config/ping Operation to ping. #
POST /externalSystems/{externalSystemCode}/hotels/{hotelId}/publishers Operation to create publishers. #
DELETE /externalSystems/{externalSystemCode}/hotels/{hotelId}/publishers Operation to remove publisher. #
GET /externalSystems/{externalSystemCode}/publishers Operation to fetch publishers. #
POST /hotelInerface Operation to create hotel interface. #
PUT /hotelInerface Operation to change hotel interface. #
GET /hotelInterfaceTypes Operation to fetch hotel interfaces. #
DELETE /hotels/{hotelId}/hotelInerface Operation to remove hotel interface. #
POST /hotels/{hotelId}/interfaces/{interfaceId}/accounts Operation to create interface account. #
PUT /hotels/{hotelId}/interfaces/{interfaceId}/accounts/{accountId} Operation to change interface account. #
DELETE /hotels/{hotelId}/interfaces/{interfaceId}/accounts/{accountId} Operation to remove interface account. #
GET /hotels/{hotelId}/interfaces/{interfaceId}/roomStatus Operation to fetch interface room statuses. #
PUT /hotels/{hotelId}/interfaces/{interfaceId}/roomStatus Operation to change interface room status. #
DELETE /hotels/{hotelId}/interfaces/{interfaceId}/roomStatus Operation to remove interface room status. #
GET /hotels/{hotelId}/interfaces/{interfaceId}/rooms Operation to fetch interface rooms. #
POST /hotels/{hotelId}/interfaces/{interfaceId}/rooms Operation to create interface room. #
DELETE /hotels/{hotelId}/interfaces/{interfaceId}/rooms Operation to remove interface room. #
POST /hotels/{hotelId}/interfaces/{interfaceId}/rooms/import Operation to import interface rooms. #
PUT /hotels/{hotelId}/interfaces/{interfaceId}/rooms/{roomId} Operation to change interface room. #
GET /hotels/{hotelId}/interfaces/{interfaceId}/unitCharges Operation to fetch interface unit charges. #
PUT /hotels/{hotelId}/interfaces/{interfaceId}/unitCharges Operation to change interface unit charges. #
GET /hotels/{hotelId}/logos/{logo} Operation to fetch hotel interface details. #
GET /interfaceControllerRegistry Operation to fetch hotel interface controller registry. #
GET /interfaceErrors Operation to fetch hotel interface errors. #
GET /interfaceFailedMessages Operation to fetch hotel interface failed messages. #
PUT /interfaceRights Operation to change interface right. #
DELETE /interfaceRights Operation to remove interface right. #
GET /interfaceRights Operation to fetch interface rights. #
GET /interfaceSchemas Operation to fetch hotel interface schemas. #
GET /interfaces/{interfaceId}/databases/{databaseId}/availableResorts Operation to fetch external database available properties. #
GET /machines Operation to fetch interface machines. #
PUT /machines/{machineId} Operation to change interface machine. #
DELETE /machines/{machineId} Operation to remove interface machine. #
GET /udfMappings Operation to send a response to the Look up of UDFs. #
PUT /udfMappings Operation to send a response to the Change in UDF. #
PUT /upsert/hotels/{hotelId}/printers Operation to create/change printer. #

Documentation

📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_distribution_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_oracle_hospitality_nor1_integrated_upsell_apis.htm
📖
Documentation
https://docs.oracle.com/cd/F29336_01/doc.201/f27480/c_property_apis.htm

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-externalsystemsconfig-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/oracle-hospitality-externalsystemsconfig-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

oracle-hospitality-externalsystemsconfig-api-openapi.yml Raw ↑ 
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.<br /><br /> Compatible with OPERA Cloud release 26.2.0.0.<br /><br /><p> 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.</p>
  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: ' <p><strong>OperationId:</strong>getConfiguredExternalDevices</p>'
      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: ' <p><strong>OperationId:</strong>getDeliveryMethods</p>'
      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: ' <p><strong>OperationId:</strong>putDeliveryMethods</p>'
      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: ' <p><strong>OperationId:</strong>deleteDeliveryMethods</p>'
      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: ' <p><strong>OperationId:</strong>postDeliveryMethods</p>'
      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: ' <p><strong>OperationId:</strong>getExternalDeviceConfigurations</p>'
      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: ' <p><strong>OperationId:</strong>putExternalDeviceConfigurations</p>'
      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: ' <p><strong>OperationId:</strong>ping</p>'
      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: ' <p><strong>OperationId:</strong>postPublishers</p>'
      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: ' <p><strong>OperationId:</strong>deletePublisher</p>'
      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: ' <p><strong>OperationId:</strong>getPublishers</p>'
      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
         

# --- truncated at 32 KB (235 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/oracle-hospitality/refs/heads/main/openapi/oracle-hospitality-externalsystemsconfig-api-openapi.yml