Error Codes

When interacting with our API it is possible that you may encounter the following error codes in response to your requests. This list may change in future and so your integration should be built to handle additional error codes as and when they are introduced. Where possible, the system will return helpful human-readable error messages in addition to the error codes below to indicate the nature of the problem.

Error Codes

Error Code	Error Type	Error Description
1001	CompletedButFailedToRespond	The operation completed but there was an error generating the response. Resubmitting a request in this case may result in a duplicate booking
1002	CompletedWithErrors	The operation completed with some non-fatal errors. Please contact Stuba to confirm the status of the booking.
2001	InvalidRequest	The request was in an invalid format.
2002	MissingParameter	The request was missing a required parameter / element.
2003	InvalidParameterValue	The request contained a parameter / element with an illegal value.
2004	WrongUserMode	The operation requested is not available to this user type.
3001	FeatureNotSupported	The feature requested is not supported on this version.
4001	SystemError	General system error.
4002	UserError	General user error. The error message should give sufficient details of the problem to enable it to be corrected.
4003	BookingAccessFailed	Could not access requested booking. You may not have permission to view this booking Id.
4004	OperationFailed	Operation failed.
4005	OperationPreviouslyPerformed	OperationPreviouslyPerformed. This booking could not be cancelled. To cancel please contact the booking support team. Thanks
4006	QuoteDoesNotMatchBooking	The details you have provided when attempting to book do not match those on the quote. For example – the pax counts differ. The booking cannot be made in this situation.
4007	SiteUnavailable	This means Stuba has disabled the XML interface, and generally indicates the system is undergoing maintenance or is temporarily offline. Please check with Stuba for further information.
4008	Timeout	Timeout: the request exceeded the time-limit for generating a response. If the request was a search, you might like to retry it with more restrictive parameters.
5001	InvalidCardType	The payment type is unrecognised or not supported on this version.
6002	DuplicateExtrasInBooking	You attempted to make a booking with duplicate extras.
6004	InvalidExtraInBooking	The extra specified for the booking is invalid.
6006	UnknownUpgradeType	The upgrade specified for the booking is invalid.
6007	PriceChargeableDisagree	The price for the upgrade could not be calculated.
7001	QuotePriceChanged	The price of a quote changed when booking.
7002	QuoteAccessDenied	Could not access requested quote. Either you do not have permission, or the quote Id was incorrect.
7003	QuoteNotAvailable	The specified quote is no longer available.

XML Response Samples

Samples

<AvailabilitySearch> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <HotelId>{{HotelId}}</HotelId> <HotelStayDetails> <ArrivalDate>{{arrivaldate}}</ArrivalDate> <Nights>1</Nights> <Nationality>GB</Nationality> <Room> </Room> </HotelStayDetails> <DetailLevel>basic</DetailLevel> </AvailabilitySearch>

<Error><Code>2001</Code> <Description>InvalidRequest: A Room element with no Guests was found in the request. (92001/X)</Description> <Details></Details> </Error>

<AvailabilitySearch> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <HotelId>{{HotelId}}</HotelId> <HotelStayDetails> <ArrivalDate>{{arrivaldate}}</ArrivalDate> <Nights>1</Nights> <Nationality>GB</Nationality> </HotelStayDetails> <DetailLevel>basic</DetailLevel> </AvailabilitySearch>

<Error><Code>2002</Code> <Description>MissingParameter: Required child parameter 'Room' of 'HotelStayDetails' was not not found in the request. (6426123/29)</Description> <Details></Details> </Error>

<AvailabilitySearch> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>CXX</Version> </Authority> <HotelId>{{HotelId}}</HotelId> <HotelStayDetails> <ArrivalDate>{{arrivaldate}}</ArrivalDate> <Nights>1</Nights> <Nationality>GB</Nationality> <Room> <Guests> <Adult /> <Adult /> </Guests> </Room> </HotelStayDetails> <DetailLevel>basic</DetailLevel> </AvailabilitySearch>

<Error><Code>2003</Code> <Description>InvalidParameterValue: 'CXX' is not a valid value for parameter 'Version' (6426157/1)</Description> <Details></Details> </Error>

<BookingQuery> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <DetailLevel>full</DetailLevel> <QueryParams> </QueryParams> </BookingQuery>

<Error><Code>4001</Code> <Description>SystemError: An error has occured (1282009953/704668258)</Description> <Details></Details> </Error>

<AvailabilitySearch> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <RegionId>{{RegionId}}</RegionId> <HotelStayDetails> <ArrivalDate>{{arrivaldate}}</ArrivalDate> <Nights>1</Nights> <Nationality>GB</Nationality> <Room> <Guests> <Adult /> <Adult /> <Child age="25" /> </Guests> </Room> </HotelStayDetails> <DetailLevel>basic</DetailLevel> </AvailabilitySearch>

<Error><Code>4002</Code> <Description>UserError: Child ages must be 18 or less! (6439484/14)</Description> <Details></Details> </Error>

<BookingCancel> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <BookingId>{{BookingId}}</BookingId> <CommitLevel>confirm</CommitLevel> </BookingCancel>

<Error><Code>4005</Code> <Description>OperationPreviouslyPerformed: This booking is already cancelled (57445/2)</Description> <Details></Details> </Error>

<BookingCreate> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <AgentReference>{{YourReference}}</AgentReference> <QuoteId>{{QuoteID}}</QuoteId> <HotelStayDetails> <Room> <Guests> <Adult title="Mr" first="A" last="Test"> </Adult> <Adult title="Ms" first="B" last="Test"> </Adult> <Child age="5" title="Mstr" first="C" last="Test" /> </Guests> </Room> </HotelStayDetails> <DetailLevel>basic</DetailLevel> <CommitLevel>prepare</CommitLevel> </BookingCreate>

<Error><Code>4006</Code> <Description>QuoteDoesNotMatchBooking: The value of the Guests element does not match that specified in quote 26140084-0 (57316/1)</Description> <Details></Details> </Error>

<BookingCreate> <Authority> <Org>{{Org}}</Org> <User>{{User}}</User> <Password>{{Password}}</Password> <Currency>{{DefaultCurrency}}</Currency> <Version>1.28</Version> </Authority> <AgentReference>{{YourReference}}</AgentReference> <QuoteId>9400591-0</QuoteId> <HotelStayDetails> <Room> <Guests> <Adult title="Mr" first="A" last="Test"> </Adult> <Adult title="Ms" first="B" last="Test"> </Adult> </Guests> </Room> </HotelStayDetails> <DetailLevel>basic</DetailLevel> <CommitLevel>prepare</CommitLevel> </BookingCreate>

<Error><Code>7002</Code> <Description>QuoteAccessFailed: No items found for the quote. This may have been caused by an invalid QuoteId. (6426157/5)</Description> <Details></Details> </Error>