Overview
The web service where the calls are specified is:
{YOUR.PROVIDER.DOMAIN}/destservices/destservices.asmx
Below you can see the functionality of each of the messages available in the I Need Tours interface:
XML methods
All calls to XML methods must be made through POST to the URL of each of them.
POST {YOUR.PROVIDER.DOMAIN}/destservices/destservices.asmx
| Action | Method | Description |
|---|---|---|
| GET AVAILABILITY | DestServicesAvailV2 | List of products and their availability |
| ADD BOOKING | DestServicesBookV2 | Add a service to a reservation |
| CONFIRM BOOKING | DestServicesCommitV2 | Confirm the services of a reservation |
| GET BOOKING DATA | DestServicesReadV2 | Retrieve data from a reservation |
| GET CANCEL FEE | DestServicesCancellationFeesV2 | Obtain cancellation fees for a reservation |
| CANCEL BOOKING | DestServicesCancelV2 | Cancel a reservation |
| STATIC DATA | DestServicesStaticDataV2 | Get static data needed to reserve |
General notes
Wrong PrimaryLangID: If the language code sent in the attribute "PrimaryLangID" is wrong, the response are returned in spanish.
Amount management
Method: DestServicesAvailV2
In the response of this method, you can obtain the price structure in each "AvailResponseV2Detail"
In this node, you have the node "Total" with the price breackdown, and you can fint this different cases:
1.- Only the node "Taxes" was returned
In this case, you are obtaining the net price, therefore, the net amount of this detail is the amount indicated in the attribute "Amount" in the currency of the attribute "CurrencyCode".
2.- The node "Taxes" have the sub node "Commissions"
In this case, you are obtaining the gross price, therefore, the gross amount of this detail is the amount indicated in the attribute "Amount" in the currency of the attribute "CurrencyCode", and the breackdown of the prices are detailed in the node "Commissions".
In the node "Commissions", you can find the node "NetAmount", with the net amount of the detail, and the node "SellingPrice" With the amount at which the final customer reserve is to be sold.
To calculate the final amount, all details that are not optional (node "IsOptional" equal to "false") must be taken into account, therefore, if several details ("AvailResponseV2Detail") that are not optional are returned, the final amount will be the sum of all of them.
Optional details ("IsOptional" node equal to "true"), shall be provided to end customers to be optionally selected if they wish to include them in the booking.
In addition, the amount can be defined per unit or per booking total.
This means that if the "PerPerson" node is returned with the value "true", the amounts should be multiplied by the requested units.
In addition to this, the following considerations should be taken into account:
1.- Product available for different days:
If in the node "AvailResponseV2Detail" the node "Date" is reported, it means that the booking can be made for the dates returned, so that if we get, for example, 3 details with the dates "2025-01-01", "2025-01-02" and "2025-01-03", the amounts should only be taken into account for the date indicated, and the amounts of the 3 details should not be added together.
Methods: DestServicesBookV2, DestServicesCommitV2 and DestServicesReadV2
In the response of these methods, in addition to the breakdown of amounts in the details, the structure of amounts at concept level is also returned ("BookResponseV2Concept"" node).
In the "Total" node at concept level, the already calculated amount of all details included in the booking is returned, and this will be the final amount of the booking.
In the event that the amounts vary between the availability response ("DestServicesAvailV2Response") and the booking creation response ("DestServicesBookV2Response"), the correct amount will be the amount returned at the time of creating the booking ("DestServicesBookV2Response"), and the client must be informed of the change in amounts and the booking process aborted if the new amounts are not accepted.
In the case of booking confirmation, in all cases, the correct amounts shall be considered to be those returned in the booking creation response ("DestServicesBookV2Response").
Structure of the amounts in the "Total" node: In the "DestServicesBookV2", "DestServicesCommitV2" and "DestServicesReadV2" methods, unlike the "AvailResponseV2Detail" method, the amount returned in the "Amount" attribute of the "Total" node corresponds to the net amount of the booking, and in no case shall it correspond to the gross amount.