This article describes the Agoda channel connection in RMS, including the data exchanged between Agoda and RMS.
Overview
Agoda is an online booking channel that can be connected to RMS via the Channel Manager. Once connected, Agoda and RMS exchange availability, rate, restriction, and reservation data automatically.
This article outlines which data is sent and received between Agoda and RMS, and provides a reference for the supported and unsupported functions of the integration.
Please Note! RMS is highly configurable. Some Terminology, User Access & Permissions, Images, Labels, and Functions used in these articles may differ from your setup. CLICK HERE to find out more.
Key Points
- Agoda supports single reservations, group reservations, and cancellations.
- Email confirmations for bookings made through Agoda are sent by Agoda, not by RMS.
- Live availability is limited to 365 Days.
- Agoda is a push connection: RMS sends availability, rates, and restrictions to Agoda rather than Agoda retrieving them.
- Both the Agoda Collect and Property Collect payment models are supported, and each delivers a different rate amount to RMS.
Preparing to Connect
The Agoda Connection can be setup to use the Pricing Model of Occupancy Based Pricing or Full Pattern Length of Stay, with both Agoda Collect and Property Collect payment methods supported.
Connection Information
Agoda requires one piece of connection information: the Agoda Hotel ID. Enter the Agoda Hotel ID in the Ref No field on the Connection Information tab of the Channel Mapping screen. Agoda provides the Hotel ID for the property.
Tax Settings
Agoda accepts rates that include tax. For properties configured as tax-exclusive, the Inc Tax option in the Channel Mapping grid controls whether tax is included in the rates sent to Agoda. For full details, see Tax Settings in Channel Mapping.
Maximum Occupancy
Important! The Category setup 'Max Occupants Per Area' must match the 'Max Occupancy on Existing Bedding' value set in Agoda. If they do not match, rates and availability will not update successfully from RMS to Agoda. Agoda rejects the messages sent by RMS and returns error responses, which causes availability, rate, and inventory discrepancies between RMS and the Agoda extranet.
Connecting Agoda to RMS
To connect Agoda as a channel in RMS, follow the general Channel Connection process. This involves activating the channel in the RMS Channel Manager, mapping your properties, categories, and rate types, and then enabling the connection.
Tip! For step-by-step instructions on connecting a channel, see the Channel Connection article.
Please Note! Once mapping is saved and the connection is set live, updates are sent to the Agoda extranet within 10 to 15 minutes.
Availability, Rate & Reservation Data Exchange
The following tables show which availability, rate, restriction, guest, and reservation data is sent and received between Agoda and RMS.
| Category | Feature | Support Status |
|---|---|---|
| Availability | Allotments | Supported |
| Live Availability | 365 Days * | |
| Rates | Additionals Rates * | Supported |
| Currency | Supported | |
| Rate Amount | Supported | |
| Rate Description | Not Supported | |
| Override Amount | Supported | |
| Person Base | Supported | |
| Restrictions | Closed to Arrival | Supported |
| Closed to Departure | Supported | |
| Maximum Nights | Supported | |
| Minimum Nights (MLOS) * | Supported | |
| Minimum Nights (Soft Close) | Not Supported | |
| Stop Sell | Supported | |
| Guests | Surname | Supported |
| Given | Supported | |
| Address | Not Supported | |
| Town/Suburb | Not Supported | |
| State | Not Supported | |
| Postcode | Not Supported | |
| Country | Supported | |
| Phone | Not Supported | |
| Not Supported | ||
| Reservations | Single Reservation | Supported |
| Group Reservation | Supported | |
| Modification | Supported | |
| Cancellation | Supported | |
| Email Confirmation Sent By | Agoda | |
| Reservation Details | Adults | Supported |
| Children | Supported | |
| Infants | Supported | |
| Arrive & Depart Date | Supported | |
| Booking Source | Supported | |
| Category | Supported | |
| ETA | Supported | |
| OTA Notes | Supported | |
| Rate Type | Supported | |
| Travel Agent | Supported |
-
Live Availability
- RMS sends and maintains 365 days of live availability and inventory to Agoda. Dates beyond 365 days are not loaded.
-
Additionals Rates
- Additional adult rates are sent to Agoda.
- Additional child rates are not sent to Agoda.
-
Minimum Nights (MLOS)
- Agoda applies the minimum length of stay restriction on arrival only. A minimum stay that applies to any day within the stay period (Soft Close) is not supported.
Please Note! Fees and Requirements are not exchanged with Agoda. Fees are not sent to Agoda and are not included in reservations received from Agoda, and Requirements are not included in reservations received from Agoda.
Tip! For definitions of the terms used in the data exchange table above, see the Availability, Rate & Reservation Glossary for Channel Connections article.
Payment Models
Agoda supports two payment models, set at property level in Agoda. The model in use determines whether card details are delivered to RMS and whether the Total Rate on the reservation arrives as a net or gross amount.
Agoda Collect
Agoda Collects requires payment from the guest at the time of booking, and the amount passed to the Total Rate field in RMS is the net amount (the sell rate less Agoda's commission):
- For tax-inclusive properties, the net inclusive amount is the sell rate less commission.
- For tax-exclusive properties, the net exclusive amount is the sell rate less commission less taxes.
Agoda ePass is Agoda's extranet financial portal where properties view, manage, and settle payments for Agoda Collect reservations.
VCC Payouts: If your property's ePass payment method is set to Virtual Credit Card (VCC), Agoda issues a VCC for the net rate of each booking. Credit card details are delivered to RMS (or can be retrieved directly via ePass) for processing.
Direct Transfer Payouts: If your property's ePass setup uses direct bank transfer (e-Pay) instead of VCC, payments are remitted directly to your bank account rather than issued via a card.
Property Collect
Property Collect requires properties to collect payment from guests on their arrival and does not include credit card information being passed to RMS.
The amount passed to the Total Rate field in RMS is the gross amount (the full sell rate, with no commission deducted). Any commission payable to Agoda is invoiced separately.
Tip! Commission on reservations received from Agoda can be calculated automatically. See Channel Agent Commission Setup on a Channel Management Connection and OTA Commission with a NET Multiplier.
Related Articles
- Channel Agent Commission Setup on a Channel Management Connection
- Channel Connection
- OTA Commission with a NET Multiplier
- Tax Settings in Channel Mapping
Comments
0 comments
Please sign in to leave a comment.