<ContactInfo ContactProfileType="PhysicalLocation">

<Addresses>

            <Address Language="en-US">

              <AddressLine>213 Street Name.</AddressLine>

              <CityName>Bangkok</CityName>

              <PostalCode>10250</PostalCode>

              <CountryName>TH</CountryName>

            </Address>

          </Addresses>

</ContactInfo>

• No, we do not shared pushed email or phone with guest at the moment

• Please make sure you push cancellation policy to Agoda, either at the property level or hotelproduct level. Otherwise, Agoda will default the cancellation policy to “Cancel 1 day prior to arrival date, the first-night charge, No Show, the first-night charge”.
  If there are cancellation policies at both level or more than one policy, Agoda will apply the strictest one.

• After you create a property, we will save the data into our database tables. There will be a delay in our system for around 5 minute before you can start pushing the room or rate plan, or sign contract.

• There will be around 1 min delay time after HotelProduct creation and ARI update.

This is a validation for single unit vacation rentals (Agoda Homes) to have only 1 rate plan and 1 room type per property.

Property will be categorized as single-unit vacation rentals when:

• GuestRoomInfo->Quantity = 1

• HotelCategory is matched with one of the below:

• Same as no. 8

1. Transaction limit: 10 requests/second - PRODUCTION

2. 1 min delay time after HotelProduct creation and ARI update -Both PRODUCTION & SANDBOX

3. 1 min delay time after property creation and the next request for that specific property - Both PRODUCTION & SANDBOX

4. Image / photo requirement:

• Minimum picture dimension is 800 x 600 px

• Maximum file size is 10 MB

• Supported file formats are jpeg, jpg, gif, png

• In this version, the following HotelCategories will be auto-signed/live from the email account signing, regardless of room quantity:

• Surcharges/fees created via Content API will be flagged as 'Agoda do not take commission'. However, partner can select to allow/not allow Agoda to take the commission on surcharges in our extranet. The commission would be the same % as room price. You can find more details here: https://agodapropertypartnerhelp.zendesk.com/hc/en-us/articles/360001445708-How-do-I-manage-additional-fees- 

• Please find the details here: https://agodapropertypartnerhelp.zendesk.com/hc/en-us/articles/360051821373-How-do-I-calculate-my-booking-rates-

1. The contract signing from the property owner is mandatory in order to reach the fraud check step and eventual activation of the property

2. If the contract is not signed, no fraud check or activation will be done

3. For inidividual property, please use hotelContractsSign call. For vacation rentals property manager who have multiple Agoda Homes properties under the same email account, please use hostContractsSign call.

4. If CM does not want to implement contract signing, property owner can sign the contract in Agoda extranet (YCS or Host Manage).

PGPB = Per Guest Per Booking

PB = Per Booking

PGPN = Per Guest Per Night

PRPB = Per Room Per Booking

PN = Per Night

PAPB = Per Adult Per Booking

PCPB = Per Child Per Booking

PAPN = Per Adult Per Night

PCPN = Per Child Per Night 

M = Mandatory (Agoda Collect) where Agoda will collect the fee when the booking is made

E = External (Property Collect) where property owner will collect the fee upon arrival 

There are certain attributes that cannot be updated via content push API.

Some will get an error warning that the value of the attribute cannot be updated while some will just simply be ignored.

Certain chain ID must be added to your API key first in our backend set up to allow property to be created with that chain ID using your API Key.

On our backend set up, each API key has certain property allowance. This error generates only when the allowance is met. Please contact Agoda support to increase the allowance for you.

Onboarding API Certification consists of 2 stages: Self-Certification and Pilot.

Self-Certification: A script testing in survey format for partner to complete after finishing the development. Once the script testing has been validated by Agoda, we will inform partner to move to the next stage.

Self-Certification Link >>> Please click here.

Pilot: Partner starts pushing 2-3 real properties to onboard on Agoda. Once the properties have been auto-enabled by the system with no issue, we will inform partner that they are certified.

End-to-end process is available in production environment only so we suggest you to push a test property to production in Test city. Below are coordinates and details of the Test city.

longitude = 43.331237

latitude = -11.636096

Country code = KM

City name = Test City

It is because the property is flagged as duplication with an existing property on Agoda. Below are the criteria for duplication logic.

• Non-chain: Same property name / same location (check lat/long by first 3 decimals)

• Chain: same external id within the same chain id

Usually it takes 24-48 hours for a property to live on Agoda by the automated flow given that all required criteria are met.

• Images > 3

• Main Image

• Contract Signed 

Once these 3 criteria are met, the automation flow will submit the property to fraud check stage and when it passes fraud check, the property will be activated on Agoda.

Image URL must be whitelisted on Agoda first before images can be processed. Please also note that image URL must be accessible via internet browser.

In case image URL is already whitelisted, it could be server performance issue. Please contact Agoda Support to check on case-by-case basis.

Yes, we recommend 10 minutes wait-time between each creation request when pushing a new property to Agoda.

• Property Creation Request

• Room Creation Request

• Rate Plan Creation Request

• Product Creation Request

• All images including the existing ones must be included in the property request with OVERLAY or DELTA mode. Images are OVERWRITE by default, therefore, if property would like to add more images, channel manager must include existing images + new images in the request, otherwise, images would be deleted.

Property Route:

• Service

• Channel

• CancelPolicy

• ChildAgeBand

Room Route:

• AmenityCode

• Text Language

RatePlan Route:

• ChannelCode

• RentalLicense

• Direction

• HouseRule

• LocalRecommendation

Properties will be deleted if they do not go live after 60 days of initial onboarding. In order for property to go live,  all required criteria must be met.

• Images > 3

• Main Image

• Contract Signed 

Once these 3 criteria are met, the automation flow will submit the property to fraud check stage and when it passes fraud check, the property will be activated on Agoda.

Product is always in overwrite mode so our system would take whatever is the latest push of that particular rate plan.

Therefore, if there's a mistake in product creation, a new request push would correct the mistake by overwriting the existing product.