Cancellation

6min

Request
The table below describes the elements present in a request along with details around their implementation. Please take special note of required fields. 
Endpoint:
﻿﻿
Element Group
Element Name
Type
Req.
Element Description
cancellationRequest
cancellationRequest
Group
Yes 
﻿
cancellationRequest
timestamp
Attribute
Yes
The current timestamp. (YYYYMMDDThh:mm:ss)
cancellationRequest
control
Group
Yes
﻿
control
userName
Element
Yes
The user identifier assigned. This is the unique ID given to you by Bonotel.
control
passWord
Element
Yes
The password assigned. This is the unique password given to you by Bonotel.
cancellationRequest
supplierReferenceNo
Element
﻿
Internal reference no sent by Bonotel at the time of booking.
cancellationRequest
cancellationReason
Element
No
﻿
cancellationRequest
cancellationNotes
Element
No
﻿
Response
Element Group
Element Name
Type
Req.
Element Description
cancellationResponse
cancellationResponse
Group
Yes 
﻿
cancellationResponse
status
Attribute
Yes
Status of the cancellation. Valid values are 
Y – Cancellation was successful.    
N – Cancellation was unsuccessful.
cancellationResponse
errors
Group
No
﻿
errors
code
Element
No
An internal error code provided by Bonotel.
errors
description
Element
No
A message describing the error.
cancellationRequest
tourOperatorOrderNumber
Element
Yes
Reference number of the tour operator booking
cancellationResponse
cancellationNo
Element
Yes
Your confirmation number for the cancellation transaction.
cancellationResponse
canellationFee
Element
No
The charge for the cancellation if any. Yes, there is a spelling error in the element name.
Code Example
Request
﻿﻿
XML
<?xml version="1.0" encoding="utf-8" ?>
<cancellationRequest timestamp="20150325T00:00:00">
	<control>
		<userName>{{Username}}</userName>
		<passWord>{{Password}}</passWord>
	</control>
	<supplierReferenceNo>PRGFOUSCG</supplierReferenceNo>
	<cancellationReason/>
	<cancellationNotes>selected a different hotel.</cancellationNotes>
</cancellationRequest>
<?xml version="1.0" encoding="utf-8" ?>
<cancellationRequest timestamp="20150325T00:00:00">
	<control>
		<userName>{{Username}}</userName>
		<passWord>{{Password}}</passWord>
	</control>
	<supplierReferenceNo>PRGFOUSCG</supplierReferenceNo>
	<cancellationReason/>
	<cancellationNotes>selected a different hotel.</cancellationNotes>
</cancellationRequest>
﻿
Response
XML
<?xml version="1.0" encoding="utf-8" ?>
<cancellationResponse status="Y">
	<tourOperatorOrderNumber>123456</tourOperatorOrderNumber>
	<cancellationNo>C4759068</cancellationNo>
	<canellationFee>0</canellationFee>
</cancellationResponse>
<?xml version="1.0" encoding="utf-8" ?>
<cancellationResponse status="Y">
	<tourOperatorOrderNumber>123456</tourOperatorOrderNumber>
	<cancellationNo>C4759068</cancellationNo>
	<canellationFee>0</canellationFee>
</cancellationResponse>
﻿
Response Codes
﻿
﻿

Element Group	Element Name	Type	Req.	Element Description
cancellationRequest	cancellationRequest	Group	Yes
cancellationRequest	timestamp	Attribute	Yes	The current timestamp. (YYYYMMDDThh:mm:ss)
cancellationRequest	control	Group	Yes
control	userName	Element	Yes	The user identifier assigned. This is the unique ID given to you by Bonotel.
control	passWord	Element	Yes	The password assigned. This is the unique password given to you by Bonotel.
cancellationRequest	supplierReferenceNo	Element		Internal reference no sent by Bonotel at the time of booking.
cancellationRequest	cancellationReason	Element	No
cancellationRequest	cancellationNotes	Element	No

Element Group	Element Name	Type	Req.	Element Description
cancellationResponse	cancellationResponse	Group	Yes
cancellationResponse	status	Attribute	Yes	Status of the cancellation. Valid values are Y – Cancellation was successful. N – Cancellation was unsuccessful.
cancellationResponse	errors	Group	No
errors	code	Element	No	An internal error code provided by Bonotel.
errors	description	Element	No	A message describing the error.
cancellationRequest	tourOperatorOrderNumber	Element	Yes	Reference number of the tour operator booking
cancellationResponse	cancellationNo	Element	Yes	Your confirmation number for the cancellation transaction.
cancellationResponse	canellationFee	Element	No	The charge for the cancellation if any. Yes, there is a spelling error in the element name.

Updated 26 Jun 2024

Reservation

Lookup