1. User Guide
  2. Exchange
  3. Configuring Interface Mapping

29 Configuring Interface Mapping

Use Interface Mapping to configure conversion of OPERA Cloud codes and external system codes at Global (Chain) or Property level. When conversions are defined, the code from an external system is replaced with the OPERA Cloud code for inbound message from the external system; and the OPERA Cloud code is replaced with the code of the external system for outbound message delivered to the external system. Mapping UDFs allows the definition of all reservations, profile and stay UDFs to be exchanged with an external system.

You can use Copy Conversion Codes to quickly populate the interface conversion codes, instead of manually inputting the codes one by one. When copying, OPERA Cloud and External System values are populated with the same value in the conversion details.

In conversion scenarios where one code converts to multiple codes, one conversion entry must be selected as the default. For example, assume the external system has more market codes than OPERA Cloud, and that some of the OPERA Cloud market codes have to be entered multiple times in the conversion code. If a reservation with such a market code is sent to the external system, OXI must be configured with a conversion record.  The OPERA -> External Default is the identifier for the conversion record used.

OPERA Cloud Value External System Value External > OPERA Cloud OPERA Cloud > External

GRP

GROUP

Y

Y

GRP

LEIS

Y

N

IND

INDIVIDUAL

Y

N

IND

TRANSIENT

Y

Y

In the above example, a reservation made in OPERA Cloud with market code "GRP" will convert to "GROUP" when sent to the external system, as this is the OPERA > External System Default is set to Y.

  • If the reservation in OPERA Cloud is made with market code "IND", OXI will convert to "TRANSIENT" when sent to the external system, as this is the default set for this case.

  • The external system sends market codes 'GROUP' and 'LEIS’, which will both convert into market code 'GRP' in OPERA. Cloud. If the reservation is updated in OPERA Cloud, the OPERA market code 'GRP' is converted to 'GROUP' when sent to the external system, which could lead to a change in the original market code that the external system has used.

Seeded Conversions

A few conversion mapping groups are activated and auto-populated as they contain the same values for all interfaces.

Note:

Do not change these preset configurations for these interface mappings.
Conversion Group OPERA Cloud Value External Value External > OPERA OPERA > External

Action Type

CANCEL

CANCEL

Y

Y

 

CHECK IN

CHECKIN

Y

Y

 

CHECK OUT

CHECKOUT

Y

Y

 

DELETE RESERVATION

DELETE

Y

Y

 

JOIN GUEST

SHARE

Y

Y

 

NEW RESERVATION

ADD

Y

Y

 

NOSHOW

NOSHOW

Y

Y

 

REACTIVATE NO SHOW

REINSTATE

N

Y

 

REACTIVATE WAITLIST

WAITLISTTOACTIVE

Y

Y

 

REVERSE CHECK IN

CNXCHECKIN

Y

Y

 

REVERSE CHECK OUT

CNXCHECKOUT

Y

Y

 

ROLLBACK CANCEL

REINSTATE

Y

Y

 

SEPARATE GUEST FROM

ADD

N

Y

 

UPDATE RESERVATION

EDIT

Y

Y

Document Type

 

Y

Y

Guest Preference Type

NEWSPAPER

NEW

Y

Y

 

ROOM_FEATURES

FEA

Y

Y

 

SMOKING

PRS

Y

Y

 

SPECIALS

SPE

Y

Y

Profile Type

COMPANY

CORPORATE

Y

Y

 

D

GUEST

Y

Y

 

G

GROUP

Y

Y

 

S

WHOLESALER

Y

Y

 

TRAVEL_AGENT

TRAVEL

Y

Y

Reservation Status

CANCELLED

CANCELED

Y

Y

 

CHECKED IN

INHOUSE

Y

Y

 

CHECKED OUT

CHECKEDOUT

Y

Y

 

NO SHOW

NOSHOW

Y

Y

 

PROSPECT

REQUESTED

Y

Y

 

RESERVED

RESERVED

Y

Y

 

WAITLIST

WAITLISTED

Y

Y

Adding Interface Mapping

Note:

Select the Show Inactive check box for first time activation of the conversion group. Highlight the conversions groups that are required and select the Activate button. To deactivate a conversion group, uncheck the Show Inactive check box, then highlight a conversion code group, and select Inactivate.

  1. From the Exchange menu, select Interface Mapping and then select Interface Mapping.

  2. Enter search criteria and click Search.

  3. Select a conversion group on the left side of the page.

    1. Select the Show Inactive check box for first time activation of the conversion table. Highlight the conversions group that are required and select the Activate button.

    2. To deactivate a conversion group, uncheck the Show Inactive  check box, then highlight a conversion code group, and select Inactivate

  4. Click New and complete the following:

    1. Global: Select to configure global interface mapping. (Available with an OPERA Cloud Central Management Services subscription).

    2. Property: Enter or select the property.

    3. Interface: Enter or select the interface. .

    4. OPERA Code: Select an OPERA Cloud code from the list

    5. External Code: Enter the external system code/value.

    6. External-OPERA Default: Select check box to select as default in the case of multiple same entries in the external system value column. It is possible that more OPERA Cloud values than the external system values exist for a conversion code. In this case the external system values would need to be duplicated and will occur more than once in the external system value columns. Only one of the duplicate external system values can be set as External -> OPERA Default Y, and this is the record that OXI uses when processing data from the external system to OPERA Cloud. All other duplicate codes are set to N. OXI automatically warns you if a record has already been set to Y as a default, and you are trying to select another record with the same external system value the same way.

    7. OPERA-External Default: Select checkbox to select as default in the case of multiple same entries in the OPERA Cloud value column. It is possible that more external system values than OPERA Cloud values exist for a conversion code. In this case the OPERA Cloud values need to be duplicated and occur more than once in the OPERA Cloud value columns. Only one of the duplicate OPERA Cloud value can be set as OPERA > External Default Y, and this is the record that OXI uses when processing data from OPERA Cloud to the external system. All other duplicate codes are set to N. OXI automatically warns you if a record has already been set to Y as a default, and you are trying to select another record with the same external system value the same way. For example: The external system has more market codes than OPERA Cloud, and the OPERA Cloud market codes have to be entered multiple times in the conversion code. If a reservation with such a market code is sent by OPERA Cloud , OXI has to know which conversion record to use. The OPERA -> External Default is the identifier for the correct conversion record.

    8. Click Save.

Editing Interface Mapping

  1. From the Exchange menu, select Interface Mapping and then select Interface Mapping.

  2. Enter search criteria and click Search.

  3. From your search results, select a row, then click the vertical ellipsis Actions menu, and select Edit.

  4. Update the configuration.

  5. Click Save.

Deleting Interface Mapping

  1. From the Exchange menu, select Interface Mapping and then select Interface Mapping.

  2. Enter search criteria and click Search.

  3. From your search results, select a row, then click the vertical ellipsis Actions menu, and select Delete.

  4. Click Delete to confirm.

Related Topics

Parent topic: Exchange