The hoteliga API

Channels

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 /v1/ChannelManager/ChannelNames

Get the channels that can be managed through the API.

Response

The result is an array of Channel Name objects.

Response Object properties
Channel Name Object
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 /v1/ChannelManager/Channels

Get information about the connected channels.

Response

The result is an array of Channel objects.

Channel Object
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.
Channel Parameters Object
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"
            }
        ]
    }...
]            
            

POST /v1/ChannelManager/Prices

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.

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