Manage your connected channels
Resources
| Resource | Description |
|---|---|
| GET /v1/ChannelManager/ChannelNames | Get the channels that can be managed through the API. |
| GET /v1/ChannelManager/Channels | Get information about the connected channels. |
| POST /v1/ChannelManager/Prices | Update prices of the connected channels for selected room type and date range. |
Get the channels that can be managed through the API.
Response
The result is an array of Channel Name objects.
| Name | Type | Description |
|---|---|---|
| id | int | Channel Name ID |
| name | string | Channel name |
Example Response
<?xml version="1.0"?>
<ChannelNames>
<ChannelName id="1">BookingCom</ChannelName>
<ChannelName id="2">Expedia</ChannelName>
</ChannelNames>
[
{
"id": 1,
"name": "BookingCom"
},
{
"id": 2,
"name": "Expedia"
}...
]
Get information about the connected channels.
Response
The result is an array of Channel objects.
| Name | Type | Description |
|---|---|---|
| id | int | The ID of the channel in hoteliga. |
| isReservationsOnly | int | Whether this channel connection is one or two way. Value 0 is for two-way connection. Value 1 is for one-way connection. |
| channelPropertyId | string | The channel property ID. This is provided from the channel. |
| channelNameId | int | The channel name ID. |
| title | string | The selected title for this channel. |
| parameters | obj | Special parameters of the channel connection. |
| Name | Type | Description |
|---|---|---|
| name | string | Name of the parameter. |
| value | string | Value of the parameter. |
Example Response
<?xml version="1.0"?>
<Channels>
<Channel id="76" isReservationsOnly="0" channelPropertyId="1780229" channelNameId="1">
<Title>Test 1780229</Title>
<Parameters>
<Parameter name="has_derived_pricing">0</Parameter>
</Parameters>
</Channel>...
</Channels>
[
{
"id": 76,
"isReservationsOnly": 0,
"channelPropertyId": "1880338",
"channelNameId": 1,
"title": "BookingCom 1880338",
"parameters": [
{
"name": "has_derived_pricing",
"value": "0"
}
]
}...
]
Update prices of the connected channels for selected room type and date range.
Request parameters
The request should be an array of Prices For Date Range requests.
| Name | Type | Value |
|---|---|---|
| dateFrom | date (YYYY-MM-DD) | Starting date of the request. |
| dateTo | date (YYYY-MM-DD) | Ending date of the request. Your request cannot exceed a range of 365 days. |
| roomTypeId | int | Id of the hoteliga room type to be updated. |
| roomRateType | int | Rate type to be updated. Use 1 for standard rate and 2 for non-refundable rate. |
| price | decimal(2-digit) | The price to be uploaded to the channels. |
Notes:
1. The contracts of the channels to be updated should use the same price list.
2. The request is enqueued.
Example Request
<?xml version="1.0"?>
<Request>
<PricesForDateRanges>
<PriceForDateRange dateFrom="2021-03-01" dateTo="2021-03-10" roomTypeId="3" roomRateType="1" price="102.80"></PriceForDateRange>
</PricesForDateRanges>
</Request>
{
"pricesForDateRanges": [
{
"dateFrom": "2021-03-01",
"dateTo": "2021-03-01",
"roomTypeId": 3,
"roomRateType": 1,
"price": 103.80
},...
]
}
Response
The result is a Channel Response objects.
| Name | Type | Description |
|---|---|---|
| result | int | 1:OK, 2: OK With Warnings, 3. Error. |
| channelErrors | [obj] | Errors returned from the channel. |
| channelWarnings | [obj] | Warnings returned from hoteliga. |
| hoteligaErrors | [obj] | Errors returned from hoteliga. |
Example Response
{
"result": 1,
"channelErrors": [],
"channelWarnings": [],
"hoteligaErrors": []
}