Set Ari Request
Element / Attribute |
Data Type |
Occurs |
Required |
Examples |
Description |
RequestTimestamp |
Numeric | 1 | Y | 1483526410357 (GMT: Wed, 04 Jan 2017 10:40:10.357) |
A timestamp is a sequence of characters or encoded information identifying when a certain event occurred. Time provided must correspond with the time in the originating system and in EPOCH. System requires EPOCH timestamps in milliseconds. |
| Type | Numeric Length 1 | 1 | Y | 1 | This number identifies a particular request: 1 SetAri 2 GetAri 3 GetBookingList 4 GetBookingDetail 5 GetProduct 8 SetProduct 9 GetBookingListV2 10 SetAriV2 |
CriteriaProperty Id |
String Length 1-8 | 1 | Y | 123 | Every request must contain a valid property ID that partner has access to. Every property has a unique ID in Agoda and every Channel Manager partner has to have the access to this specific property via an authorized API key. |
InventoryUpdate room_id |
Numeric Length 1-8 | unbounded | Y | 72027 | This is the Agoda room ID related to the property inventory element. Agoda active Room IDs can be returned with Getproduct request. If no room is specified in the request, all active Rooms will be returned in the response. |
| date_range from to | Date YYYY-MM-DD | unbounded | Y | 2016-04-02 | Date Range information for request. From = inclusive start date for the inventory request To = inclusive end date for the inventory request |
| dow | Numeric Length 1-7 | 1 to 7 | N | 1 | Denotes the day of the week which needs to be updated via the SetAri request: 1 = Monday 2 = Tuesday 3 = Wednesday 4 = Thursday 5 = Friday 6 = Saturday 7 = Sunday Note: DOW can only be used in conjunction with date_range |
| allotment | Numeric length 1-3 | 1 | Y | 2 | Controls if room type is open for sale or closed to sale. Close will stop room type regular inventory being sold even if inventory is available. Guaranteed inventory is still available for sale if close is applied. |
Restrictionsclosed |
boolean | 1 | Y | TRUE or 1 | Controls if room type is open for sale or closed to sale. Close will stop room type regular inventory being sold even if inventory is available. Guaranteed inventory is still available for sale if close is applied. |
| ctd | boolean | 1 | N | FALSE or 0 | Set to make room type open for departure for this date or closed for departure on this date. Customer can still stay through this date if they depart on future date. Not mandatory and if element not sent, Close to Departure status in extranet remains same as current. |
| cta | boolean | N | FALSE or 0 | Set to make room type open for arrival for this date or closed for arrival on this date. Customer can still stay through this date if they arrive on past date. Not mandatory and if element not sent, Close to Arrival status in extranet remains same as current. | |
RateUpdate room_id |
Numeric Length 1-8 | unbounded | Y | 72027 | This is the Agoda room ID related to the property inventory element. Agoda active Room IDs can be returned with Getproduct request. If no room is specified in the request, all active Rooms will be returned in the response. |
| Rateplan_id | Numeric Length 1-6 | unbounded | Y | 1 to 6 | This is the Agoda Rateplan ID related to a particular offer active on a room. Agoda active Rate Type IDs can be returned with Getproduct request. If no Rateplan ID is specified in the request, all active Rateplans will be returned in the response. |
| Date_values value | Date YYYY-MM-DD | 1 to 31 | Y | Maximum 31 date values can be set in the request. Alternatively, the date_range from/to can be used at this point of the request. | |
pricescurrency |
Alpha 3 | 1 | Y | THB | The Currency must match with the property currency. |
Normal Default |
Numeric Length 1-9 | 1 | N | 250.0 | The rate is applied to all occupancies |
| Normal Occupancy Person | Numeric | unbounded | N | 300.0 | Number of occupancies the price will applied to. |
| Normal Occupancy Price | Numeric Length 1-9 | unbounded | N | 350.0 | The price for the specified occupancy. |
| deviation base_price | Numeric Length 1-9 | 1 | N | 400.0 | This price is use as the base for the deviation (amount or percentage) of each occupancy. |
| deviation occupancy percentage | Numeric Lenght 1-9 | unbounded | N | 10 | The deviation in percentage for the specified occupancy. |
| deviation occupancy ammount | Numeric Lenght 1-9 | unbounded | N | 10.0/td> | The deviation in ammount for the specified occupancy. |
| Extra bed | Numeric nnn.nn | 1 | N | 100.0/td> | This rate is used as the extra bed rate and is available to all hotel occupancy models. ‘0’ extra bed rate indicates extra bed is not available for sale for the specified room, rateplan and date (closed for sale). Extra bed rate can only be set if num_extrabed is set to ‘1’ or more. |
child_rateschild_rate price |
Numeric nnn.nn | unbounded | N | 200.0 | This is the rate amount for the child pricing for the specific age band. ‘0’ child price rate indicates the child will not be charged for the specified room, rateplan and date. |
| child_rate age_band_code | Numeric | unbounded | N | 2 | This is the code used to uniquely identify the child age band. |
Restrictionsclosed |
boolean | 1 | N | TRUE or 1 | Controls if room type is open for sale or closed to sale. Close will stop room type regular inventory being sold even if inventory is available. Guaranteed inventory is still available for sale if close is applied. Not mandatory and if element not sent, close out status in extranet remains same as current. |
| ctd | boolean | 1 | N | FALSE or 0 | Set to make rate type open for departure for this date or closed for departure on this date. Customer can still stay through this date if they depart on future date. Not mandatory and if element not sent, Close to Departure status in extranet remains same as current. |
| cta | boolean | 1 | N | FALSE or 0 | Set to make rate type open for arrival for this date or closed for arrival on this date. Customer can still stay through this date if they arrive on past date. Not mandatory and if element not sent, Close to Arrival status in extranet remains same as current. |
LOSmin |
Numeric length 1-2 | 1 | N | 1 to 99 | Minimum length of stay that is required to search and book this room type. MinLOS cannot be greater than maxLOS. To remove minLOS restriction, default value = ‘1’. |
| max | Numeric length 1-2 | 1 | N | 0 to 99 | Minimum length of stay that is required to search and book this room type. MaxLOS cannot be less than minLOS. To remove maxLOS restriction, default value = ‘0’. |
ADVANCE PURCHASEmin |
Numeric length 1-3 | 0 | N | 0 to 365 | Minimum Advance Purchase that is required to search and book this room type. To remove min Advance Purchase restriction, default value = ‘0’. |
| max | Numeric length 1-3 | 0 | N | 0 to 365 | Maximum Advance Purchase that is required to search and book this room type. To remove max Advance Purchase restriction, default value = ‘0’. |
| STAYTHROUGH min |
Numeric | 1 | N | 0 to 30 | Minimum length of stay that is required to search and book this room type for stay through. Not mandatory and if element not sent, Min stay through remains same as current. To remove min stay through restriction, set min = ‘0’. |
Set Ari Response
Element / Attribute |
Data Type |
Occurs |
Required |
Examples |
Description |
ResultTUID |
String length 13 | 1 | Y | 89f66310-6718-11e5-b298-0758c951ac41 | A Track Unique Identifier (TUID) is an identifier which is guaranteed to be unique and it has a specific tracking purpose. |
| Timestamp | Numeric | 1 | Y | 1483526410357 (GMT: Wed, 04 Jan 2017 10:40:10.357) |
A timestamp is a sequence of characters or encoded information identifying when a certain event occurred. Time provided will correspond with the time in the originating system and in EPOCH. System requires EPOCH timestamps in milliseconds. |
Get Ari Request
Element / Attribute |
Data Type |
Occurs |
Required |
Examples |
Description |
RequestTimestamp |
Numeric | 1 | Y | 1483526410357 (GMT: Wed, 04 Jan 2017 10:40:10.357) |
A timestamp is a sequence of characters or encoded information identifying when a certain event occurred. Time provided must correspond with the time in the originating system and in EPOCH. System requires EPOCH timestamps in milliseconds. |
| Type | Numeric Length 1 | 1 | Y | 2 | This number identifies a particular request: 1 SetAri 2 GetAri 3 GetBookingList 4 GetBookingDetail 5 GetProduct 8 SetProduct 9 GetBookingListV2 10 SetAriV2 |
Criteriafrom to |
Datetime YYYY-MM-DD HH:MM:SS | 1 | Y | 2015-09-01T00:00:00+07:00 | The inclusive start (from) and end (to) date and time for the query. Time of reference is always UTC time zone +/- to identify other timezones. The date range cannot be longer than 31 days. |
PropertyId |
String Length 1-8 | 1 to 5 | Y | 123 | Every request must contain a valid property ID that partner has access to. Every property has a unique ID in Agoda and every Channel Manager partner must have the access to this specific property via an authorized API key. Maximum 5 property IDs can be queried in this GetARI request. |
| Room_id | Numeric Length 1-8 | 1 | N | 85236 | This is the Agoda room ID related to the property inventory element. Agoda active Room IDs can be returned with Getproduct request. If no room is specified in the request, all active Rooms will be returned in the response. |
| Rateplan_id | Numeric Length 1-6 | 1 | N | 24468 | This is the Agoda Rateplan ID related to a particular offer active on a room. Agoda active Rate Type IDs can be returned with Getproduct request. If no Rateplan ID is specified in the request, all active Rateplans will be returned in the response. |
| Type | Alpha | 1 | N | Inventory | The type in the criteria>>request can be one of the following: rate inventory both |
Get Ari Response
Element / Attribute |
Data Type |
Occurs |
Required |
Examples |
Description |
RequestTimestamp |
Numeric | 1 | Y | 1483526410357 (GMT: Wed, 04 Jan 2017 10:40:10.357) |
A timestamp is a sequence of characters or encoded information identifying when a certain event occurred. Time provided must correspond with the time in the originating system and in EPOCH. System requires EPOCH timestamps in milliseconds. |
| Type | Numeric Length 1 | 1 | Y | 2 | This number identifies a particular request: 1 SetAri 2 GetAri 3 GetBookingList 4 GetBookingDetail 5 GetProduct 8 SetProduct 9 GetBookingListV2 10 SetAriV2 |
Criteriafrom to |
Datetime YYYY-MM-DD HH:MM:SS | 1 | Y | 2015-09-01T00:00:00+07:00 | The inclusive start (from) and end (to) date and time for the query. Time of reference is always UTC time zone +/- to identify other timezones. The date range cannot be longer than 31 days. |
PropertyId |
String Length 1-8 | 1 to 5 | Y | 123 | Every request must contain a valid property ID that partner has access to. Every property has a unique ID in Agoda and every Channel Manager partner must have the access to this specific property via an authorized API key. Maximum 5 property IDs can be queried in this GetARI request. |
| Room_id | Numeric Length 1-8 | 1 | N | 85236 | This is the Agoda room ID related to the property inventory element. Agoda active Room IDs can be returned with Getproduct request. If no room is specified in the request, all active Rooms will be returned in the response. |
| Rateplan_id | Numeric Length 1-6 | 1 | N | 24468 | This is the Agoda Rateplan ID related to a particular offer active on a room. Agoda active Rate Type IDs can be returned with Getproduct request. If no Rateplan ID is specified in the request, all active Rateplans will be returned in the response. |
| Type | Alpha | 1 | N | Inventory | The type in the criteria>>request can be one of the following: rate inventory both |