Users with Operator level of access need to request the user creation to Cangooroo support team and then the Operator need to enable the user.
You need to use the URL https://ws-[operatorid].cangooroo.net. Please make sure that you have the correct ws- URL.
Whenever you find a date field in the API (no matter if REST or SOAP) send it as string in the following format: "YYYY-MM-DD".
Cangooroo has some status that is returned when attempting to do a booking, here they are:
Confirmed: booking confirmed by the supplier. No further action is necessary;
Rejected: booking not confirmed by the supplier. No further action is necessary;
Cancelled: booking cancelled. No further action is necessary;
The following status can be changed manually in the Cangooroo by its license owner:
OnRequest: booking is on request, the status of this booking can change to Confirmed or Rejected/Cancelled;
AwatingPayment: booking is not confirmed and is waiting for payment;
The following status needs to be handled manually in the Cangooroo by its license owner (eg: tour operator):
TechnicalProblem: means that we have an unrecoverable problem (a TechnicalProblem) and therefore the booking need to be handled manually;
InProgress: when the response has this status is necessary to use booking detail method to recover the actual booking status;
PendingCancellation: a failure on try to cancel a booking;
For more information: https://kb.cangooroo.net/display/KBC/Cangooroo+reservations+status.
Our token duration is 30 minutes and you can do only one booking process per token.
You need to check the time out configuration, if your response time is the same of the configuration or below we consider that nothing is wrong.
We don't support pagination on our API at this time. If we do you will find it on each service documentation.
Please contact the owner of the Cangooroo licence in order to have this information.
When you request the operation "getCancellationPolicies"/"getBookingConditions" with more than one room with the same configuration, for example 3 rooms with 1 adult, you must inform the same roomId in getCancellationPolicies quantity times, for example:
<RoomsIds>
<string>ABCD123</string>
<string>ABCD123</string>
<string>ABCD123</string>
</RoomsIds>
obs: For the same room configuration you can't book differents rooms!
You must certify that the rooms that you're trying to book were in the last request of GetBookingConditions that you made.
The time between search and book must be less than 30 minutes.
You must request the GetBookingConditions method before DoBooking method.
Whenever you receive a correct response from our API with a Confirmed status (please see the section Booking Status above).
If you receive any errors, especially ones like HTTP 5xx or HTTP 4xx (usually HTTP 429), you should keep your booking with a pending status and use our ClientBackoffice endpoint to check the booking with your reference code. We suggest a specific flow here.