Rezgo XML Gateway API - Reference Manual
Rezgo XML Gateway API - Reference Manual
rezgo
XML Gateway API - Reference Manual
Copyright ©2008
1 of 38
Sentias Software Corp. Rezgo XML API
Revision History
Primary Author Description Rezgo Version API Doc Version Date
Marc Raiser API Initial Draft ø 1.0 23 Jan 2007
Jeffrey Qua Rezgo API – Revision 3.8.5 2.0 08 May 2008
Jeffrey Qua Rezgo API – Revision 3.10.0 2.1 09 Jul 2008
Jeffrey Qua Rezgo API – Major Revision 4.0.0 3.0 28 Oct 2008
Jeffrey Qua Rezgo API – Minor Revision 4.1.4 3.1 02 Mar 2009
Jeffrey Qua Rezgo API – Minor Revision 4.1.4 3.2 13 Mar 2009
Jeffrey Qua Rezgo API – Revision/XML Changes 4.7.0 3.3 02 Nov 2009
Miyuki Shiomi Rezgo API – Revision/XML Changes 4.8.0 3.4 12 Nov 2009
Revision Notes
API v3.3, 3.4 - Rezgo Version 4.8.0 (XML changes)
-group pricing, re-check item details on Booking Details page(4.8)
-modifications to forms node in i=search_items query(4.7)
-support for multiple/additional locations in i=search_items query(4.6.3)
-support for i=region_list query on supplier site(4.6.2)
-major change in structure of month query(4.3)
-external XML queries now require use of valid API key (4.2)
-generated time <gt> node added for all queries; denotes time taken by server to return results
Copyright ©2008
2 of 38
Sentias Software Corp. Rezgo XML API
Table of Contents
Before You Start............................................................................................................................................................... 4
Introduction...................................................................................................................................................................... 5
Instructions....................................................................................................................................................................... 5
i=company.................................................................................................................................................................................... 5
i=about........................................................................................................................................................................................... 7
i=headers...................................................................................................................................................................................... 8
i=tags............................................................................................................................................................................................. 9
i=search_items......................................................................................................................................................................... 10
i=search_items – more examples ........................................................................................................................................ 16
i=search_items – promotional code example ................................................................................................................. 17
i=month....................................................................................................................................................................................... 19
i=commit..................................................................................................................................................................................... 23
i=search_bookings................................................................................................................................................................... 26
i=region_list............................................................................................................................................................................... 31
Copyright Notice
This document and the software to which it refers to is copyrighted by Sentias Software Corp. Use of this documentation
and the software to which it refers is subject to the acceptance of the Terms of Use referenced in this documentation
and available online at http://www.rezgo.com. All rights reserved. All other trademarks, and registered trademarks
are the property of their respective owners.
Copyright ©2008
3 of 38
Sentias Software Corp. Rezgo XML API
Transcode
The transcode is either the unique identifier of the Rezgo account holder (returned as cid in the response) or
the unique identifier of a vendor prefixed by ‘p’ (eg., transcode=p4). The transcode/company id can be
found in Rezgo Admin > Settings.
API Key
The API Key is required for third-party parsers and can be located for each Rezgo client in Rezgo Admin >
Settings.
Instruction
The following is a list of instructions that are described independently later in this document:
1) i=company
2) i=about
3) i=headers
4) i=tags
5) i=search_items
6) i=month
7) i=commit
8) i=search_bookings
9) i=region_list
10) i=classification_list
Copyright ©2008
4 of 38
Sentias Software Corp. Rezgo XML API
Introduction
The gateway is your source for information stored in Rezgo. Gateway queries require a transcode and an
instruction. All queries will also return with a generated time <gt> node to denote the time it takes for the
server to generate a response to the query. (We will not include this in the examples)
Instructions
The instructions in this section are meant for individual Rezgo tour providers only. As such, the transcode
must be a number and not a p of a vendor.
i=company
The company query returns information about the company associated with the submitted transcode. This
query does not need any additional arguments.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=company
Query response:
<response>
<company_name><![CDATA[Booking Server Test]]></company_name>
<type>tour</type>
<domain>testcompany</domain>
<cards><![CDATA[MasterCard, Visa]]></cards>
<payment_methods><![CDATA[Credit Cards, PayPal, Cheques]]></payment_methods>
<paypal_email>info@sentias.com</paypal_email>
<get_cvv>1</get_cvv>
<date_format>M d, Y</date_format>
<time_format>+0</time_format>
<label_tour><![CDATA[Rezgo Tours]]></label_tour>
<sti_show>0</sti_show>
<sti_value>7.00</sti_value>
</response>
The returned data corresponds to the company information for the account with the given transcode. Some
of the fields may be wrapped in CDATA tags to allow special characters to be formatted in XML.
Copyright ©2008
6 of 38
Sentias Software Corp. Rezgo XML API
i=about
The about query returns HTML-encoded information about the company represented by the submitted
transcode. This query does not need any additional arguments.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=about
Query response:
<response>
<intro><![CDATA[... HTML Code ...]]></intro>
<about><![CDATA[... HTML Code ...]]></about>
</response>
The returned data corresponds to the company introduction and descriptions for the account with the given
transcode.
Copyright ©2008
7 of 38
Sentias Software Corp. Rezgo XML API
i=headers
The headers query returns HTML-encoded information about the company and currently active modules
represented by the submitted transcode. This query does not need any additional arguments.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=headers
Query response:
<response>
<header><![CDATA[... HTML Code ...]]></header>
<footer><![CDATA[... HTML Code ...]]></footer>
<analytics_general><![CDATA[ ... HTML/JS Analytics code ...]]></analytics_general>
<book_now><![CDATA[Reserve Now]]></book_now>
<site_status>1</site_status>
<triggers>1</triggers>
</response>
The returned data corresponds to the template data, and specific site variables for the account with the
given transcode.
Note: the triggers field is only returned only for supplier queries as triggerable promo codes are
not enabled for vendors
Copyright ©2008
8 of 38
Sentias Software Corp. Rezgo XML API
i=tags
The tags query returns information about tags, the tag id number, and the number of products in each. This
helps to divide tags into how popular they are.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=tags
Query response:
<response>
<total>2</total>
<tag>
<num>1</num>
<name><![CDATA[Walking Tours]]></name>
<uid>872</uid>
<count>0</count>
</tag>
<tag>
<num>2</num>
<name><![CDATA[Daily Tours]]></name>
<uid>873</uid>
<count>2</count>
</tag>
</response>
The returned data corresponds to the tag information for the account with the given transcode.
Copyright ©2008
9 of 38
Sentias Software Corp. Rezgo XML API
i=search_items
The search_items query returns information about tours that match the search parameters. The tours
returned are from the company represented by the submitted transcode. This query has multiple additional
arguments that help refine the search of found tours. All these optional arguments are independent of each
other.
Optional arguments:
1) q : query (the search string, may contain * wildcards).
2) t : target {com, name, uid, category(tag)} - the search target.
3) d : date {Y-m-d format} – search for tours that are available on this date.
4) a : additional arguments {image, active, group, featured} - skip image a true or false additional
identifier, (ie a=image, a=active, a=skip_cutoff), a=group only returns group info (Returns only 1
item from each group), a=skip_cutoff allows searches to ignore the cutoff date, use commas to
separate multiple arguments, eg a=group,featured
5) f : search refinement {f[search_parameter] = search_pattern} - an array for additional search
criteria (ie f[keywords]=camping).
6) trigger_code: a promotional code used to apply/enable a rule.
The following illustrates a request for a list of all tours. We run a search_items query for items that has a
name or common id matching * (wildcard), so we return all tours. The price data for a certain date is only
returned if a date is given.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=search_items&t=name&q=*&d=2008-05-01
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=search_items&t=com&q=*&d=2008-05-01
Query response:
<response>
<total>21</total>
<item>
<num>1</num>
<uid>1663</uid>
<com>1663</com>
<name><![CDATA[Guided Tour & Cruise]]></name>
<time><![CDATA[1:30PM - 9:30PM]]></time>
<category>50</category>
<classification>None</classification>
<starting>2.00</starting>
<group>require</group>
<per>2</per>
<cutoff>2</cutoff>
<duration><![CDATA[8 hours]]></duration>
<date value="2008-05-01">
<active>1</active>
<availability>25</availability>
<price_adult>25</price_adult>
<price_child></price_child>
<price_senior></price_senior>
Copyright ©2008
10 of 38
Sentias Software Corp. Rezgo XML API
<price4></price4>
<price5></price5>
<price6></price6>
<price7></price7>
<price8></price8>
<price9></price9>
</date>
<adult_label><![CDATA[Adult]]></adult_label>
<child_label><![CDATA[Child]]></child_label>
<senior_label><![CDATA[Senior]]></senior_label>
<price4_label><![CDATA[Price 4]]></price4_label>
<price5_label><![CDATA[Price 5]]></price5_label>
<price6_label><![CDATA[Price 6]]></price6_label>
<price7_label><![CDATA[Price 7]]></price7_label>
<price8_label><![CDATA[Price 8]]></price8_label>
<price9_label><![CDATA[Price 9]]></price9_label>
<adult_required>1</adult_required>
<child_required>0</child_required>
<senior_required>0</senior_required>
<price4_required>0</price4_required>
<price5_required>0</price5_required>
<price6_required>0</price6_required>
<price7_required>0</price7_required>
<price8_required>0</price8_required>
<price9_required>0</price9_required>
<currency_symbol>$</currency_symbol>
<currency_separator>,</currency_separator>
<currency_decimals>2</currency_decimals>
<currency_base> CAD</currency_base>
<city>Vancouver</city>
<state>BC</state>
<country>ca</country>
<additional_locations>
<location>
<loc_country>ca</loc_country>
<loc_state>ab</loc_state>
<loc_city>Calgary</loc_city>
</location>
<location>
<loc_country>ca</loc_country>
<loc_state>on</loc_state>
<loc_city>Toronto</loc_city>
</location>
</additional_locations>
<lat></lat>
<lon></lon>
<zoom>13</zoom>
<taxes>12%</taxes>
<tax_calc>0</tax_calc>
<start_date>1181890800</start_date>
<end_date>1213426800</end_date>
<total_adult>25</total_adult>
<total_child>0</total_child>
<total_senior>0</total_senior>
<total_price4>0</total_price4>
Copyright ©2008
11 of 38
Sentias Software Corp. Rezgo XML API
<total_price5>0</total_price5>
<total_price6>0</total_price6>
<total_price7>0</total_price7>
<total_price8>0</total_price8>
<total_price9>0</total_price9>
<overall_total>0</overall_total>
<deposit></deposit>
<deposit_value></deposit_value>
<total_availability>25</total_availability>
<forms>
<total_forms>2</total_forms>
<form num=”1”>
<id>1233</id>
<show>primary</show>
<type>text</type>
<label><![CDATA[Special requests]]></label>
<require>0</require>
<value></value>
<comments><![CDATA[Do you have any special needs you would like us to
provide?]]></comments>
</form>
<form num=”2”>
<id>1234</id>
<show>group</show>
<type>checkbox</type>
<label><![CDATA[Deluxe Dinner]]></label>
<require>1</require>
<price>+20</price>
<value></value>
<comments><![CDATA[The deluxe dinner for the cruise requires a preparation
fee]]></comments>
</form>
</forms>
<schedule>
<departs></departs>
<unavailable></unavailable>
<itinerary></itinerary>
<pick_up></pick_up>
<drop_off></drop_off>
<bring></bring>
</schedule>
<details>
<introduction><![CDATA[The sights and scenery of beautiful Vancouver]]></introduction>
<overview><![CDATA[The sights and scenery of beautiful Vancouver...]]></overview>
<inclusions></inclusions>
<exclusions></exclusions>
<cancellation></cancellation>
<description><![CDATA[<div>A guided tour & cruise of beautiful downtown Vancouver. Enjoy an
afternoon of shopping in the heart of Vancouver in the Robson shopping district. Then set sail on a sunset cruise into English
Bay and a scenic voyage around Stanley Park.</div><img width="140" height="94" src="/i/1/38.jpg" alt=""
title="">]]></description>
</details>
<image_gallery value=”1”>
<image value=”1-1663-1.jpg”></image>
</image_gallery>
Copyright ©2008
12 of 38
Sentias Software Corp. Rezgo XML API
<video_gallery value=”1”>
<video value=”http://www.youtube.com/watch?v=kdTdp7Ep6AM”>
<caption></caption>
<image>youtube-kdTdp7Ep6AM.jpg</image>
</video>
</video_gallery>
<cid>1</cid>
<exists>1</exists>
<image>1</image>
</item>
<item>
<num>2</num>
<uid>160</uid>
<com>160</com>
<name><![CDATA[Guided Tour & Cruise]]></name>
...
</item>
</response>
Copyright ©2008
13 of 38
Sentias Software Corp. Rezgo XML API
In the previous section we have not set a=group and so, we would get back results for ALL options. If we only
want tour results and not all tour options for the previous example, we would use the following queries:
http://xml.rezgo.com/xml?
key=REZGO_API_KEY&transcode=1&i=search_items&t=name&q=*&a=group &d=2008-05-01
http://xml.rezgo.com/xml?
key=REZGO_API_KEY&transcode=1&i=search_items&t=com&q=*&a=group&d=2008-05-01
Search for tour option with uid 95 with prices for Jan 1 2010
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=search_items&t=uid&q=95&d=2010-01-01
Practical examples
Copyright ©2008
14 of 38
Sentias Software Corp. Rezgo XML API
The search_items query can include the trigger_code variable to enable a special rule to affect availability
or prices. Any changes in prices will create the base_prices node in the date node.
The following illustrates a request for a specific tour using a trigger code to enable a special rule. We apply
the promotional code discount20 which decreases price1/adult by 20 percent. The base prices node includes
nodes for all prices that have been changed and has the value of the original price.
Example query:
http://xml.dev.rezgo.com/xml?
key=REZGO_API_KEY&transcode=1&l=tour&i=search_items&t=com&q=6573 &d=2009-03-
31&trigger_code=discount20
Query response:
<response>
<total>2</total>
<item>
<num>1</num>
<uid>6573</uid>
<com>6573</com>
<name><![CDATA[Awesome Tour]]></name>
<time><![CDATA[12:00]]></time>
<category>873</category>
<classification>None</classification>
<starting>1999.99</starting>
<group>request</group>
<per>1</per>
<cutoff>0</cutoff>
<duration><![CDATA[5 minutes]]></duration>
<date value="2009-03-31">
<active>1</active>
<availability>25</availability>
<price_adult>12.79</price_adult>
<price_child>2.50</price_child>
<price_senior/>
<price4>24</price4>
<price5>25</price5>
<price6>26</price6>
<price7/>
<price8/>
<price9/>
<base_prices>
<price_adult>19.99</price_adult>
</base_prices>
</date>
...
<total_adult>12.79</total_adult>
<total_child>2.5</total_child>
<total_senior>0</total_senior>
<total_price4>24</total_price4>
Copyright ©2008
15 of 38
Sentias Software Corp. Rezgo XML API
<total_price5>25</total_price5>
<total_price6>26</total_price6>
<total_price7>0</total_price7>
<total_price8>0</total_price8>
<total_price9>0</total_price9>
<overall_total>0</overall_total>
</item>
...
Copyright ©2008
16 of 38
Sentias Software Corp. Rezgo XML API
The returned data corresponds to the information for matching tours of the company with the given
transcode.
Copyright ©2008
17 of 38
Sentias Software Corp. Rezgo XML API
Copyright ©2008
18 of 38
Sentias Software Corp. Rezgo XML API
Copyright ©2008
19 of 38
Sentias Software Corp. Rezgo XML API
Copyright ©2008
20 of 38
Sentias Software Corp. Rezgo XML API
i=month
The month query returns availability information for a specified tour. This query has one required argument
in order to find specific month availability. There are two optional arguments that can provide access to all
the items in the group and/or a date to indicate which month to check availability for. The uid pattern
match is set to q=160 in the following example.
Required arguments:
1) q : uid – uid of tour option to search for
Optional arguments:
1) g : group {1} – if this is set to 1, then return all matching items/tour options in the same tour; else it
will only return results for that tour option
2) d: date {Y-m-d format} – if this is set, then the search will be for the given month, else it will search
the current month
3) trigger_code: a code used to apply/enable a rule
Example query
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=month&g=1&q=160&d=2008-05-01
Query response:
<response>
<month>May</month>
<item value="25">
<uid>9</uid>
<name><![CDATA[test1234]]></name>
</item>
<item value="24">
<uid>10</uid>
<name><![CDATA[test2222222]]></name>
</item>
<item value="25">
<uid>11</uid>
<name><![CDATA[test three]]></name>
</item>
</day>
... Other days ...
<day value="31" condition="a">>
<item value="25">
<uid>4</uid>
<name><![CDATA[1:30PM - 9:30PM]]></name>
</item>
<item value="15">
<uid>5</uid>
<name><![CDATA[0900 - 1700]]></name>
</item>
<item value="15">
<uid>6</uid>
<name><![CDATA[0930 - 1700]]></name>
</item>
<item value="45">
<uid>7</uid>
<name><![CDATA[0130-0445]]></name>
</item>
<item value="25">
<uid>8</uid>
<name><![CDATA[sup & name]]></name>
</item>
<item value="25">
<uid>9</uid>
<name><![CDATA[test1234]]></name>
</item>
<item value="24">
<uid>10</uid>
<name><![CDATA[test2222222]]></name>
</item>
</day>
</response>
Copyright ©2008
22 of 38
Sentias Software Corp. Rezgo XML API
The month query can include the trigger_code variable to enable a special rule to affect availability or
prices. Any changes in availability will affect the value attribute of the item node.
The following illustrates a request for a specific tour using a trigger code to enable a special rule. We apply
the promotional code space20 which increases spot availability 20.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=month&g=1&q=160&d=2008-05-
01&trigger_code=space20
Query response:
<response>
<month>May</month>
<uid>11</uid>
<name><![CDATA[test three]]></name>
</item>
</day>
... Other days ...
<day value="31" condition="a">>
<item value="45">
<uid>4</uid>
<name><![CDATA[1:30PM - 9:30PM]]></name>
</item>
<item value="35">
<uid>5</uid>
<name><![CDATA[0900 - 1700]]></name>
</item>
<item value="35">
<uid>6</uid>
<name><![CDATA[0930 - 1700]]></name>
</item>
<item value="65">
<uid>7</uid>
<name><![CDATA[0130-0445]]></name>
</item>
<item value="45">
<uid>8</uid>
<name><![CDATA[sup & name]]></name>
</item>
<item value="45">
<uid>9</uid>
<name><![CDATA[test1234]]></name>
</item>
<item value="44">
<uid>10</uid>
<name><![CDATA[test2222222]]></name>
</item>
</day>
</response>
Copyright ©2008
24 of 38
Sentias Software Corp. Rezgo XML API
The returned data corresponds to the availability information of the requested group or item provided by the
company with the given transcode.
Copyright ©2008
25 of 38
Sentias Software Corp. Rezgo XML API
i=commit
The commit query processes the booking data in order to create a booking. This query should be transferred
as secure data using https. Required arguments must be enough to identify an item and the booking details.
There are other required/optional arguments depending on the item. The variables sent must be urlencoded.
Required arguments:
1) date : booking date {Y-m-d format date}
2) book : item uid - uid
3) price_options to be booked
4) tour contact information
Optional arguments:
1) trigger_code: a code used to apply/enable a rule
Example query
The necessary arguments are highlighted in the following request. Some variables such as other price
options, do not need to be sent as they will be assumed to be 0.
https://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1
&i=commit&book_action=complete&book_confirm=confirm&cat=Guided+Tours
&date=2008-05-06
&book=1663
&adult_num=2
&tour_first_name=John
&tour_last_name=Smith
&tour_address_1=1234+Sesame+Street
&tour_address_2=
&tour_city=Vancouver
&tour_stateprov=BC
&tour_country=ca
&tour_postal_code=A1A2B2
&tour_phone_number=%28123%29456-7890
&tour_email_address=elmo%40tickles.com
&tour_group[adult][1][first_name]=Elmo
&tour_group[adult][1][last_name]=E
&tour_group[adult][1][phone]=
&tour_group[adult][1][email]=
&tour_group[adult][1][forms][1234]=on
&tour_group[adult][2][first_name]=Big
&tour_group[adult][2][last_name]=Bird
&tour_group[adult][2][phone]=
&tour_group[adult][2][email]=
&tour_group[adult][2][forms][1234]=on
&tour_forms[1233]=Can+you+tell+me+how+to+get+to+Sesame+Street%3F+
&agree_terms=1
Copyright ©2008
26 of 38
Sentias Software Corp. Rezgo XML API
The returned data corresponds to the availability information of the requested group or item provided by the
company with the given transcode.
Copyright ©2008
27 of 38
Sentias Software Corp. Rezgo XML API
Query response:
<response>
<message>Booking complete</message>
<trans_num>1B4M7R2K1K</trans_num>
<txid>1</txid>
<analytics_convert>... HTML/Javascript Analytics Code ...</analytics_convert>
</response>
This is an example of a booking with a payment declined problem, such as an invalid credit card
<response>
<message>payment declined by gateway</message>
</response>
The returned data corresponds to the result of the commit query attempt at creating a booking.
Copyright ©2008
28 of 38
Sentias Software Corp. Rezgo XML API
i=search_bookings
The search_booking query returns transaction information matching the passed transaction code. This query
has one required argument q=(transaction code) in order to find the transaction to be returned. The
transaction code pattern match is set to q=1B4M7R2K1K in the following example.
Required arguments:
1) q : transaction code – code of transaction to search for
Example query
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=1&i=search_bookings&q=1B4M7R2K1K
Query response:
This is an example of a booking retrieval for a transaction code that is not in the system
<response>
<total>0</total>
</response>
<response>
<total>1</total>
<item_id>1663</item_id>
<tour_name>Test Tour</tour_name>
<option_name>Morning Departure</option_name>
<date>1210057200</date>
<date_range>1210057200</date_range>
<date_purchased>1209757083</date_purchased>
<prices>
<price_adult>25</price_adult>
</prices>
<adult_num>2</adult_num>
<child_num>0</child_num>
<senior_num>0</senior_num>
<price4_num></price4_num>
<price5_num></price5_num>
<price6_num></price6_num>
<price7_num></price7_num>
<price8_num></price8_num>
<price9_num></price9_num>
<adult_label><![CDATA[Adult]]></adult_label>
<child_label><![CDATA[Child]]></child_label>
<senior_label><![CDATA[Senior]]></senior_label>
<price4_label><![CDATA[Price 4]]></price4_label>
<price5_label><![CDATA[Price 5]]></price5_label>
<price6_label><![CDATA[Price 6]]></price6_label>
<price7_label><![CDATA[Price 7]]></price7_label>
Copyright ©2008
29 of 38
Sentias Software Corp. Rezgo XML API
<price8_label><![CDATA[Price 8]]></price8_label>
<price9_label><![CDATA[Price 9]]></price9_label>
<fees>12%</fees>
<triggered_fees>
<total_triggered_fees>1</total_triggered_fees>
<triggered_fee_1>
<label><![CDATA[Deluxe Dinner]]></label>
<amount>+20</amount>
<total_amount>40</total_amount>
</triggered_fee_1>
</triggered_fees>
<first_name><![CDATA[John]]></first_name>
<last_name><![CDATA[Smith]]></last_name>
<address_1><![CDATA[1234 Sesame Street]]></address_1>
<address_2><![CDATA[]]></address_2>
<city><![CDATA[Vancouver]]></city>
<stateprov><![CDATA[BC]]></stateprov>
<country>ca</country>
<postal_code>A1A2B2</postal_code>
<phone_number>(123)456-7890</phone_number>
<email_address>elmo@tickles.com</email_address>
<adult_1>
<first_name>Elmo</first_name>
<last_name>E</last_name>
<phone_number></phone_number>
<email_address></email_address>
<total_forms>1</total_forms>
<form_1>
<type>checkbox</type>
<question><![CDATA[Deluxe Dinner]]></question>
<answer><![CDATA[on]]></answer>
</form_1>
</adult_1>
<adult_2>
<first_name>Big</first_name>
<last_name>Bird</last_name>
<phone_number></phone_number>
<email_address></email_address>
<total_forms>1</total_forms>
<form_1>
<type>checkbox</type>
<question><![CDATA[Deluxe Dinner]]></question>
<answer><![CDATA[on]]></answer>
</form_1>
</adult_2>
Copyright ©2008
30 of 38
Sentias Software Corp. Rezgo XML API
<price_senior></price_senior>
<price4></price4>
<price5></price5>
<price6></price6>
<price7></price7>
<price8></price8>
<price9></price9>
</date>
<tax_calc>6</tax_calc>
<overall_total>96</overall_total>
<trigger_code></trigger_code>
<payment_method><![CDATA[PayPal]]></payment_method>
<status>Payment Pending</status>
<checkin_status></checkin_status>
<ticketing>0</ticketing>
<trans_num>1B4M7R2K1K</trans_num>
<class>tour</class>
<primary_forms>
<total_forms>2</total_forms>
<form_1>
<type>text</type>
<question><![CDATA[Special requests]]></question>
<answer><![CDATA[Can you tell me how to get to Sesame Street? ]]></answer>
</form_1>
</primary_forms>
</response>
The returned data corresponds to the result of the search_bookings query retrieving booking information
price4_label –
label for (price4 – price9) price option
price9_label
fees tax percentage charged on booking
XML node of triggerable fees/prices agreed upon for the booking – refer to
triggered_fees
triggered_fees node definition
first_name Billing info - First name
last_name Billing info - Last name
address_1 Billing info – Address
address_2 Billing info – Address 2 (Optional)
city Billing info – City
stateprov Billing info – State/Province
country Billing info – Country
postal_code Billing info – Postal Code
phone_number Billing info – Phone Number
email_address Billing info – E-mail address
the passenger information for the x-th price_option passenger (ie. adult_1,
price_option_x
adult_2, child_1, etc.) – refer to the passenger node definition
price_range list of price options
XML node of prices for the day in the value attribute(in Y-m-d format) – refer to
date
date node definition
tax_calc total amount of tax cost after calculation
overall_total total cost of booking
deposit amount of deposit; only shown if deposits are required
trigger/coupon code used with this booking; only shown if a trigger code is
trigger_code
submitted
payment_method payment method used {PayPal}
card_type type of credit card used; only used if paid with credit card
card_name name on credit card used; only used if paid with credit card
card_number number on credit card used; only used if paid with credit card
status status of payment {Payment Pending}
trans_num transaction code / transaction number of this booking (alphanumeric characters)
class type of item {tour}
group forms, these forms are only filled once for each booking – refer to
primary_forms
Passenger/Group form node definition
Copyright ©2008
32 of 38
Sentias Software Corp. Rezgo XML API
Copyright ©2008
33 of 38
Sentias Software Corp. Rezgo XML API
Copyright ©2008
34 of 38
Sentias Software Corp. Rezgo XML API
i=region_list
The region_list query returns a list of regions accepted by the filter set by the supplier/vendor corresponding
to the transcode. This query does not need any additional arguments.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=p4&i=region_list
Query response:
<response>
<countries total="181" all="1">
<country>CF</country>
<country>AL</country>
<country>AS</country>
<country>AD</country>
<country>AI</country>
<country>AG</country>
<country>AR</country>
<country>AM</country>
<country>AW</country>
...
</countries>
</response>
The returned data corresponds to the result of the region_list query retrieving a list of regions that are being
accepted by the vendor’s filter
Copyright ©2008
35 of 38
Sentias Software Corp. Rezgo XML API
i=classification_list
The classification_list query returns a list of item classifications accepted by the filter set by the vendor
corresponding to the transcode. This query does not need any additional arguments.
Example query:
http://xml.rezgo.com/xml?key=REZGO_API_KEY&transcode=p4&i=classification_list
Query response:
<response>
<classifications total="71" all="1">
<classification>Adventure Tours</classification>
<classification>Aerial Tours</classification>
<classification>Attraction</classification>
<classification>Biking</classification>
<classification>Bike Tours</classification>
<classification>Birding / Bird Watching</classification>
<classification>Boating</classification>
...
</classifications>
</response>
The returned data corresponds to the result of the classification_list query retrieving a list of classifications
that are being accepted by the vendor’s filter
Copyright ©2008
36 of 38
Sentias Software Corp. Rezgo XML API
i=modify_bookings
The modify_bookings query is used to cancel valid bookings that have not been checked in yet. This query
cancels one booking which relates to the corresponding cancel code AND voucher code. This query has three
required arguments, the cancel action, cancellation code, and the voucher code. The cancellation and
voucher codes will be unique to each transaction and must match in order for the cancellation to be
successfully processed.
Required arguments:
1) a: action – action (a=cancel)
2) cancel_code : cancellation code – cancellation code of transaction (found in i=search_bookings
response)
3) q: voucher code – voucher code (found on voucher page)
Example query:
http://xml.rezgo.com/xml?
key=REZGO_API_KEY&transcode=p4&i=modify_bookings&a=cancel&q=ABC123&cancel_code=CANCEL123
Query response:
<response>
<message>Cancellation complete</message>
<cancel_amount>20.25</cancel_amount>
</response>
<response>
<message>Instruction invalid for this transit code.</message>
</response>
<response>
<message>Booking not found.</message>
</response>
Copyright ©2008
37 of 38
Sentias Software Corp. Rezgo XML API
The returned data corresponds to the result of the classification_list query retrieving a list of classifications
that are being accepted by the vendor’s filter
Copyright ©2008
38 of 38