The Owner needs a program that will send updates of availability and prices to Icnea.
If these are send in real time, we will have Icnea’s system and the OTA’s better synchronized without delays.
Endpoint: https://ws.icnea.net/availability_update.aspx
Request:
<availability_update>
<link>
<user>integer(4)</user>
<password>character(20)</password>
</link>
<lodgings>
<lodging>
<lodging_id>integer(8)</lodging_id>
<currency>iso4217 </currency>
<dates>
<date>
<day>yyyy-mm-dd (iso8601)</day>
<rooms>...</rooms>
</date>
</dates>
<adds_on_stay>...</adds_on_stay>
</lodging>
</lodgings>
</availability_update>
parameter | type | description | mandatory? |
|---|---|---|---|
link | Yes | ||
user | integer | 4-digits integer | Yes |
password | string | Yes | |
lodgings | Yes | ||
lodging | You can send availability for 1 property or for multiple ones, using different <lodging> nodes. | Yes | |
lodging_id | integer | 8-digits integer | Yes |
currency | string | EUR, USD… The currency configured in Icnea. | Yes |
dates | Yes | ||
date | You can send different dates in the same call with different <date> nodes. | Yes | |
day | date | Day that you want to update. Format: yyyy-MM-dd | Yes |
rooms | → node information room | Yes | |
adds_on_stay | → node information add_on_stay | No |
room
<room>
<room_id>character(10)</room_id>
<room_label>character(50)</room_label>
<availability>integer(3)</availability>
<room_units>
<units>
<unit_id>character(10)</unit_id>
<availability>integer(3)</availability>
</units>
</room_units>
<rates>...</rates>
<adds_on_room>...</adds_on_room>
</room>
parameter | type | description | mandatory? |
|---|---|---|---|
room_id | string | Yes | |
room_label | string | No | |
availability | integer | Yes | |
room_units | No | ||
units | No | ||
unit_id | string | No | |
availability | integer | No | |
rates | → node information rate | Yes | |
adds_on_room | → node information add_on_room | No |
rate
<rate> <rate_id>character(10)</rate_id> <rate_label>character(50)</rate_label> <people>integer(2)</people> <price>decimal</price> <discount>decimal</discount> <minimum_stay>integer(3)</minimum_stay> <rate_nights>integer(3)</rate_nights> <closed_to_arrival>false/true</closed_to_arrival> <closed_to_departure>false/true</closed_to_departure> <non_refundable>false/true</non_refundable> </rate>
add_on_room
<add_on_room> <add_on_room_id>integer(2)</add_on_room_id> <add_on_room_label>character(50)</add_on_room_label> <price>decimal</price> <price_per_person>false/true</price_per_person> <maximum>integer(3)</maximum> </add_on_room>
add_on_stay
<add_on_stay> <add_on_stay_id>integer(2)</add_on_stay_id> <add_on_stay_label>character(50)</add_on_stay_label> <price>decimal</price> <price_per_person>false/true</price_per_person> <maximum>integer(3)</maximum> <required>false/true</required> </add_on_stay>
Response:
If the update is successful, the answer will be:
<availability_update_response> <ok/> </availability_update_response>
If there has been some error:
<availability_update_response> <ko>Error message here</ko> </availability_update_response>
0 Comments