Inntopia Commerce + Agilysys Versa®

The OTA/HTNG two-way integration between Inntopia’s Commerce platform and Agilysys Versa performs two main functions:

  • Agilysys Versa sends availability (restrictions), rates, and inventory (ARI) to Inntopia RMS.
  • Inntopia sends reservations, modifications, and cancellations (reservation delivery) to Agilysys Versa.

The integration supports the following:

  • Batch processing of OTA-compliant reservation (Create, Modify, and Cancel)
  • Availability
  • Rack Rate
  • Non-Rack Rates
  • Inventory messages
  • Payment Postings

Versa controls the frequency of availability, rate, and inventory updates to Inntopia. Reservation transmittal frequency is configurable and can be as frequent as every 15 seconds. You can also include the following information within the Special Instructions and/or Comments field on the Versa reservation:

  • supplier notes;
  • repeat guest information;
  • customer requests (via CRS or online booking);
  • package name;
  • fees;
  • insurance items;
  • summary of non-lodging items by product category booked with the reservation; and
  • any other non-lodging items booked with the reservation.

Inntopia maintains the reservation and room type code cross-references between the two systems. Once a reservation has been successfully transmitted to Versa, the integration is set up to "Acknowledge" the reservation. Inntopia can set up one or multiple email addresses to receive errors and warnings pertaining to the Versa integration.

To view successful bookings as well as manage and resubmit reservations that did not transmit, you can use the Remote System Reservations Report.

To determine the technical requirements for your specific set up needs, contact your Agilysis representative.

The initial setup of this integration requires steps by Agilysys and Inntopia. To request the Versa setup lead time and discuss whether they can implement this integration into your system, contact your Agilysys representative.

Inntopia requires a two-week lead time to perform the setup. To begin the implementation process with Inntopia:

  • Submit an INNTERACT request that includes:
    • Supplier IDs
    • Sales Channel ID that will house the Remote System Reservations Report
    • Partner Web Service URL and credentials (username and password from Agilysys)
    • Client email address(es) where reservation and error messages will be delivered
    • Rate code
    • Indicate whether or not you want Payment Postings enabled.

The following Reservation, Rate, Availability, and Inventory data is passed between Inntopia and Versa:

  • Arrival/Departure Date
  • Travel Agent (including IATA)
  • PMS Room Type Code
  • PMS Rate Code – Inntopia sends the resamount.

    Note: By default, the average daily rate is sent to Versa in the reservation message. To have the average nightly rate sent, contact Inntopia Partner Services to enable this feature.

  • Total Reservation Amount
  • Total Reservation Tax Amount
  • Extra Person Information
  • Company
  • First Name, Last Name
  • Address
  • City
  • State
  • Country
  • Phone
  • Email
  • Credit Card
  • Inntopia Itinerary ID

The following are sent in the Comments field of the reservation message:

  • Special requests entered by the guest
  • Promotion Name
  • Repeat Guest (Yes/No)
Notes:
  • Inntopia Promotion Cross Reference Code can be used to send a rate-plan code other than RACK to Versa with the reservation message.
  • Sending of Net Rates to Versa is not supported.
  • Room Type Code
  • Rate Amount Start and End Dates
  • Rate Plan Code
  • Rate Amount
  • Extra Person Charges
  • Room Type Code
  • Start and End Dates
  • Close Out Flag
  • Minimum Stay Requirement
  • Room Type Code
  • Start and End Dates
  • Quantity Available

The existing integration cannot differentiate the same exact room type across multiple lodging suppliers. Versa does not have the concept of a supplier; therefore, each room type must be unique and suppliers cannot share the same room type (with no Supplier ID, the integration does not know where to send an update).

To view all reservations transmitted from Inntopia to Versa, refer to the Remote System Reservations Report. This report shows successfully booked reservations, as well as manages the reservations that failed to transmit. You have the option to "View Details" as to why a transmission failed, and also are provided the option to Submit a reservation to be transmitted again. The Submit button lets you queue the reservation to be re-sent once the issue preventing message transmission has been resolved. A developer request must be made for the CRS to access the report.

Below is a sample error message generated from the Versa web service client that sends reservations to Versa. In such cases, the partner is expected to investigate and take action using the Inntopia Remote System Reservations Report. The error message below was generated by Versa, so they should be contacted first in this scenario:

Original Message-----

From: Notifications Mailbox

Sent: Thursday, October 13, 2024 1:08 AM

To: John Smith; Evelyn Johnson

Subject: Error Processing Itinerary via Versa Web Service Client: 5222145

The following error occurred in the Versa web service client for Itinerary: 5222145 For Supplier: 1712258

Session Id: 472f44e2-0e4d-4f15-8d84-967daf1890a3Code: 0001Message: Unable to Process the Request

Your Agilysys Versa integration can be configured to transmit advance deposit payments and customer refunds on lodging products via the Deposit/Refunds Posting feature. When the deposit/refund is sent to Versa, a dated transaction line-item posts to the guest ledger. Deposit payments collected in Inntopia are transmitted and posted to Versa as a credit on the guest ledger with a description of OTA Deposit. Customer refunds issued in Inntopia are transmitted and posted to Versa as a debit on the guest ledger with a description of OTA Cancel.

The following information is posted to the Versa reservation folio:

  • The individual deposit amounts collected
  • Deposit amounts collected upon modifying an itinerary
  • Refund amounts
  • Multiple deposits – Multiple deposits on multiple lodging products in the same itinerary are sent to Versa with the full deposit amount(s) on only one product.
  • Single-item refunds – Refunding a single item on an itinerary containing multiple lodging products requires cancelling all products, issuing a full refund, and rebooking the item(s) the guest wants to keep.

The following payment types are supported via the Deposit /Refunds Posting feature:

  • Credit Card Payment
  • Travel Agent Deduction Payment
  • Credit Card Refund
  • Travel Agent Deduction Refund
  • Cash/Check Payment
  • Customer Account Transfer Payment
  • Cash/Check Refund
  • Customer Account Transfer Refund
  • Supplier Transfer Payment
  • Affirm
  • Supplier Transfer Refund
  • PayPal
  • CRS Write off (comp)
  
  1. Agent reserves Versa item in Inntopia.
  2. A batch-mode reservation delivery process sends the reservation to Versa within one minute. If a payment was collected at the time of booking, then the amount is included in the reservation messaging.
  3. Versa responds immediately with its confirmation ID.
  • Collecting funds outside of the specified deposit policy in Inntopia transmits the full amount collected to Versa.
  • Processing refunds on an uncancelled item will not transmit the refund to Versa.
  • Deposit/refund amounts processed AFTER the checkout date will not trigger a payment to be sent to Versa (if a refund is taken in Inntopia after checkout, the partner must manually post the refund in Versa).
  • To test deposit postings in a stage environment, you must have an active Versa stage environment set up. It is not possible to point Versa production environment to the Inntopia stage environment.

The Deposit/Refund Postings feature must be turned on by Inntopia staff. To activate the Deposit/Refund Postings feature for your Agilysys Versa integration:

  1. Submit an INNTERACT request with the following information:
    • Request to complete “Agilysys Versa Payment Posting” integration setup
    • Supplier ID – Submit for each supplier using the integration
    • Account name – Submit for each supplier using the integration
    • Environment – Specify if you want the feature turned on in both Inntopia Stage and Production environments
    • Start Date – Specify the date you want the feature to become active
  2. Contact your Agilysys Versa account representative to request they configure the Inntopia Deposit feature for your account.

The following setup items MUST be configured for Inntopia suppliers using the integration: 

Email: Versasupport@agilysys.com