Agoda – Seekom

If you have a live account with agoda you can now automate availability, rates and bookings by interfacing/connecting your iBex account to agoda.

Click here for more information on listing with agoda

Please read the important notes (bottom of page) about interface limitations.

Set up the connection yourself FREE OF CHARGE using our self help instructions below.

Note: If you would prefer Seekom Support to set up the connection for you a charge of $110 (+tax) per hour will apply with a minimum charge of $50 (+tax)

V4 Instructions

Step	Action
1	Click here to email agoda and request that they enable interface to Seekom iBex channel manager for your agoda account. Only when you have received confirmation from agoda complete remaining steps below. Only when you have received confirmation from agoda complete remaining steps below.
2	Login to your agoda account at https://ycs4.agoda.com.
3	Make a note of your agoda hotel code which will be towards the top right of each page (immediately left of your property name) as this will be required for step 16 below.
4	Go into the Settings tab and select Room Settings. Here you must ensure that the occupancy for your rooms match what is being sent from your iBex account. Since agoda’s occupancy settings are set differently, we recommend that you refer to the table at the bottom (Important notes) section about the connection. Save any changes that you have made.
5	Login to your iBex account.
6	From left menu select Sales Channels Add a sales Channel
7	At the pop up window titled ‘New Sales Channel’ click the button Register Available Sales Channel
8	Enter 'agoda' into search field at top right of window and press enter on your keyboard. Matching results will be displayed - see example screen image below.
9	If this is the first and only connection to Agoda click the green plus icon adjacent to Agoda (see above example). If this is an additional connection select Agoda (Connection 2) or Agoda (Connection 3) as appropriate. Refer Important Notes section below.
10	Optionally update General section fields as required. Notes are private. Refer sample example screen image below.
11	At Rules section: select what Selling Group you want agoda to be registered to (click here for more information about selling groups) select the Rate Modifier that you want agoda to use – Rate 1 will typically be same as you sell at, other options will be a % increase or discount (click here for more information about Rate Modifiers). Agoda bookings are retrieved with Net rates. We recommend to leave the Commission field blank. Refer example below.
12	Click Register Sales Channel button. Once saved, you will progress from the Details tab to the Channel Mapping tab where you can set email settings within iBex for Agoda.We recommend the settings are set as below although a full explanation of options are advised in steps 13 to 15.
13	The email that you enter in the iBex Notification Emails To field will be notified if there are any errors with the connection. It is recommended that you enter your reservations email address so that if there is a fault with the connection, you will be made aware and can update the mapping accordingly if necessary.
14	iBex Email on New Booking – This governs who will receive an automated email from iBex when a new booking is made. It is recommended that they are set as follows: Block Operator – not checked. Block Property – If you are a single property account – checked (as since your property email address is most likely the same as your operator email address, you would receive a duplicate email). If you are multi property account – not checked (so that the appropriate property receives the email notifications as well as the operator). Block Customer – checked (as they receive one directly from agoda).
15	iBex Booking Email Rule – This governs whether or not iBex sends the usual automated emails to the not checked options above (for example, when there is a change or cancellation to the booking). It is recommended that it is set to ‘Do not send emails’ (as agoda sends any subsequent emails about amendments, cancellations of the booking).
16	At Channel Property ID enter your your agoda Property ID (as obtained in step 3).
17	Complete each room mapping row as follows: Remote Room ID - enter room codes supplied by AA Travel Rate Name - Select as required To map any iBex room type to further room types at AA Travel (NZ) (eg. for differing minimum stays/rates - see notes at bottom of this page) click '+'
18	Set Allocation Handling field as required (we recommend Total per Room). This is only relevant if you will be mapping a single room type from iBex to multiple room types at agoda (eg. for length of stay price variations, etc).
19	Set agoda Pricing Model field according to your Agoda account. Most agoda accounts are set up on the Full Occupancy model as default but if you are unsure, you must contact agoda support to confirm.
20	Room and rate mapping will now be set - refer sample screen image below.
21	Once the screen has refreshed, the 2 systems have linked so you can now map the rooms and rates that you want to sell through Agoda with your rooms and rates in your iBex account. Complete each room mapping row as follows: Channel Room ID – enter Room ID as supplied by AA Travel (refer step 1). iBex Rate Name – select as required. Channel Rate ID – enter Rate ID as supplied by AA Travel (refer step 1). Click ‘+‘ to map any iBex room type to further room types at Agoda or the second ‘+’ to map any iBex rate to a second Agoda rate for the same room type. See image below for an example where the Double room has 2 different rates being sent from iBex.
22	Click Save button
23	Click Save & Update Channel button. iBex will now notify you that there is 1 queued update (just above the Save & Update Channel button).
24	Wait a few minutes and once the queued update notification has gone, click View Log button. If the Remote Service Log Viewer indicates queued updates are pending, wait a further few minutes and click the 'Refresh' button.
25	If you have performed the connection successfully you will see OK messages for inventory & rates uploaded. See example below:
26	You must now advise agoda that you have successfully uploaded rates & availability from the iBex channel manager so that they can check your account and then make your agoda account live for automated bookings. Email agoda agoda will then check your account and publish your listing as live.

V3 Instructions

Step

Action

Click here to email agoda and request that they enable interface to Seekom iBex channel manager for your agoda account.

Only when you have received confirmation from agoda complete remaining steps below.

Make a note of your agoda hotel code which will be towards the top right of each page (immediately left of your property name) as this will be required for step 16 below.

Go into the Settings tab and select Room Settings. Here you must ensure that the occupancy for your rooms match what is being sent from your iBex account.

Since agoda’s occupancy settings are set differently, we recommend that you refer to the table at the bottom (Important notes) section about the connection.

Save any changes that you have made.

Add agoda as an ODN agent in Seekom iBex:

From left menu select Users & Clients Create agent • no admin rights
At field labelled Seekom ODN Agents select Agoda (ODN)

Note: If setting a second connection select ‘Agoda (Connection 2)’ or for a third connection select ‘Agoda (Connection 3)’

Set User Group and Room Rate Value as required
Set other fields as required
Click Save button (towards bottom of screen)

From left menu select Users & Clients Agent Room-rate mapping.

Remote Service Control Panel screen will open

At 'Available Services' field select Agoda

Remote Service Control Panel will display - refer sample screen image below.

Note: If setting a second connection select 'Agoda (Connection 2)' or for a third connection select 'Agoda (Connection 3)'

Enter Remote Property ID (your agoda hotel code as obtained in step 3 above).

Ignore remaining fields at this stage and click Save button and then re-select Agoda.

Note: If you receive an error at this point you have likely missed step 1 where agoda must provide permission for Seekom iBex channel manager to interface to your agoda account.

Enter your email address at Notify Errors field.

Interface rules will now be set - refer sample screen image below:

It is recommended that Stop Emails are set as follows:

Operator – not checked
Property – checked
Customer – checked
Agent – checked
3rd Party – checked
Disable Auto – checked.

We recommend the field post Rates is checked.

Set Allocation Handling field as required.

This is only relevant if you will be mapping a single room type from iBex to multiple room types at agoda (eg. for length of stay price variations, etc)

Set field Min Stay Handling as required.

Relevant options for agoda are:

First Available – if you are setting up one to one room type mapping only and merely wish agoda to operate to lowest min stay pricing.
Specific Minstays – if you wish to map a specific min stay duration pricing to agoda and/or will be mapping one room type in iBex to multiple room stay variations at agoda.

Room and rate mapping will now be set - refer sample screen image below.

Complete each room mapping row as follows:

Remote Room Name - select as required (this is the room type name at agoda).
Rate Name - Select as required

To map any iBex room type to further room types at agoda (eg. for differing minimum stays/rates - see notes at bottom of this page) click '+'

Check Enabled field (top of screen), check Re-Synch field (bottom left of screen) and click Save button.

Wait a few minutes and click 'View Log' hyperlink (coloured blue).

If you have performed the connection successfully you will see OK messages for inventory & rates uploaded.

See example below:

Click here to email agoda and advise them you have successfully uploaded rates & availability from Seekom iBex channel manager.

Agoda will check your account and then publish your listing as live.

IMPORTANT NOTES

iBex supports up to 3 connections to AA Travel from a single property. Instructions vary at steps 3 and 5 above if setting up a 2nd or 3rd connection.
After any extensive modification of your rates/prices within iBex it is recommended you perform a full re-synch to AA Travel. Click Here for Instructions.

IMPORTANT NOTES

Agoda’s Auto Top Up functionality must be disabled in your Agoda account once iBex is connected as your Channel Manager as your iBex system will send them your true availability.

Function		Notes
Channel sends booking information	YES
Channel sends booking cancellations	YES
Channel sends booking changes	YES	Loaded as a “Rebooking” on iBex
Can map one iBex room to multiple channel rooms	YES
Rates values sent to channel	YES	Cannot disable this feature
Mapping requires rate IDs from channel
Can map multiple rates per channel room	YES
Can send specific iBex rate minstay values	YES	For each mapped iBex rate, a specific minstay value is used
Can send “first available” iBex rate minstay	YES	For each mapped iBex rate, the first available minstay value for the period is used
Can send “ordered” iBex rate minstay	YES	For each mapped iBex rate, the first defined minstay value is used
Can set rate maxstay at channel
Channel accepts a “1 pax” room rate	YES	Applies only when iBex rate base pax is one
iBex rate value sent for channel room rate	1,2	We send single, double (and full occupancy if the property is set to this pricing model)
Channel accepts no. of pax allowed at room rate
Channel can accept “per pax” pricing
Channel can accept “per occupancy” pricing

When setting up your rooms in your agoda account, the occupancy must match what is set in your iBex account. Please note that the maximum occupancy setting in the agoda account is notjust for the base rate but the additional guests as well. Please use the table below to guide you as to what you should be entering in your agoda account.

iBex - Total Guests	agoda - max	agoda - extra beds	Notes
1	1	0
2	2	0
3	3	0
4	3	1
5 (Base ≤ 3 pax)	3	1	max. occupancy at Agoda limited to 4 pax otherwise new (linked) rate plan required
5 (Base = 4 pax)	4	1
5 (Base = 5 pax)	5	0
6 (Base ≤ 3 pax)	3	1	max. occupancy at Agoda limited to 4 pax otherwise new (linked) rate plan required
6 (Base = 4 pax)	4	1	max. occupancy at Agoda limited to 5ked) rate plan required
6 (Base = 5 pax)	5	1
6 (Base = 6 pax)	6	0
7 (Base ≤ 3 pax)	3	1	max. occupancy at Agoda limited to 4 pax otherwise new (linked) rate plan required
7 (Base = 4 pax)	4	1	max. occupancy at Agoda limited to 5 pax otherwise new (linked) rate plan required
7 (Base = 5 pax)	5	1	max. occupancy at Agoda limited to 6 pax otherwise new (linked) rate plan required
7 (Base = 6 pax)	6	1
7 (Base = 7 pax)	7	0
8 (Base ≤ 3 pax)	3	1	max. occupancy at Agoda limited to 4 pax otherwise new (linked) rate plan required
8 (Base = 4 pax)	4	1	max. occupancy at Agoda limited to 5 pax otherwise new (linked) rate plan required
8 (Base = 5 pax)	5	1	max. occupancy at Agoda limited to 6 pax otherwise new (linked) rate plan required
8 (Base = 6 pax)	6	1	max. occupancy at Agoda limited to 7 pax otherwise new (linked) rate plan required
8 (Base = 7 pax)	7	1
8 (Base = 8 pax)	8	0

iBex supports up to 3 connections to agoda from a single property.
Agoda announced their new ePass payment platform September 2018. This new platform allows properties to batch payments, saving properties time spent processing individual credit card transactions. This also means credit card details will no longer be sent via API. Because multiple credit card payments can be processed in single transactions the batch payment system has greater security benefits and will save properties money in credit card processing fees. The downside to ePass lies in the fact that properties will now have to log in to the Agoda extranet to access virtual credit card details. Agoda have advised us to direct all ePass inquiries to their Property Partner Help Center.
After any extensive modification of your rates/prices within iBex it is recommended you perform a full re-synch to agoda. Click here for instructions.

Agoda extra bed/person price will be applied as a flat rate for all extra pax together. So you can only have one extra person per room, without having more people in for free.

e.g. can have $100 for 2 people + $20 for a third, but then you can't charge another $20 for the fourth.
Agoda max is the total number of people in the room, the extra beds number is subtracted from it to give the base + extra split.

e.g. max 4, extra bed 1

base pax in agoda = max - extra = 4 - 1 = 3

iBex should be set with base =3, extra = 1

Related to

Related articles