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": [] }