{"id":659,"date":"2020-01-24T13:45:11","date_gmt":"2020-01-24T08:15:11","guid":{"rendered":"https:\/\/effectivetours.com\/docs\/?post_type=yada_wiki&#038;p=659"},"modified":"2020-01-24T13:45:11","modified_gmt":"2020-01-24T08:15:11","slug":"retrieve-reservations","status":"publish","type":"yada_wiki","link":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/","title":{"rendered":"Retrieve Reservations"},"content":{"rendered":"\n<p style=\"font-size:15px\">The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the <code>OTA_ReadRQ <\/code>message.Effective Tours API will respond with a<code>OTA_ResRetrieveRS<\/code> that contain\u00a0the reservations, modifications or cancellations that meet the request criteria in the read request.<\/p>\n\n\n\n<blockquote class=\"wp-block-quote\"><p>The integrated PMS\u00a0MUST\u00a0return the reduced &#8216;Availability&#8217; (<code>BookingLimit<\/code>)\u00a0value via the &#8216;Inventory API&#8217; immediately after a reservation has been delivered. It is expected that the integrated PMS will pass back &#8216;Availability&#8217; changes (reduction or replenishment) once a reservation, modification or cancellation message has been processed to confirm availability.<\/p><\/blockquote>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"ota_readrq\">OTA_ReadRQ<\/h4>\n\n\n\n<p style=\"font-size:15px\">The message below will return all undelivered reservations, modifications and cancellations for the hotel with HotelCode ABC<\/p>\n\n\n\n<p style=\"font-size:15px\"><strong>Request all undelivered for a hotel<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;OTA_ReadRQ xmlns=\"http:\/\/www.opentravel.org\/OTA\/2003\/05\" Version=\"1.0\" TimeStamp=\"2005-08-01T09:30:47+08:00\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;POS>\n\u00a0\u00a0\u00a0\u00a0&lt;Source>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;RequestorID Type=\"22\" ID=\"PMS1\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/Source>\n\u00a0\u00a0&lt;\/POS>\n\u00a0\u00a0&lt;ReadRequests>\n\u00a0\u00a0\u00a0\u00a0&lt;HotelReadRequest HotelCode=\"ABC\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;SelectionCriteria SelectionType=\"Undelivered\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/HotelReadRequest>\n\u00a0\u00a0&lt;\/ReadRequests>\n&lt;\/OTA_ReadRQ>\n<\/code><\/pre>\n\n\n\n<p style=\"font-size:15px\">The message below will return all undelivered new reservation for the hotel with HotelCode ABC<\/p>\n\n\n\n<p style=\"font-size:15px\"><strong>Request undelivered reservations<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;OTA_ReadRQ xmlns=\"http:\/\/www.opentravel.org\/OTA\/2003\/05\" Version=\"1.0\" TimeStamp=\"2005-08-01T09:30:47+08:00\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;POS>\n\u00a0\u00a0\u00a0\u00a0&lt;Source>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;RequestorID Type=\"22\" ID=\"PMS1\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/Source>\n\u00a0\u00a0&lt;\/POS>\n\u00a0\u00a0&lt;ReadRequests>\n\u00a0\u00a0\u00a0\u00a0&lt;HotelReadRequest HotelCode=\"ABC\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;SelectionCriteria SelectionType=\"Undelivered\" ResStatus=\"Book\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/HotelReadRequest>\n\u00a0\u00a0&lt;\/ReadRequests>\n&lt;\/OTA_ReadRQ>\n<\/code><\/pre>\n\n\n\n<p style=\"font-size:15px\">The message below will return all undelivered cancellations for the hotel with HotelCode ABC<\/p>\n\n\n\n<p style=\"font-size:15px\"><strong>Request undelivered cancellations<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;OTA_ReadRQ xmlns=\"http:\/\/www.opentravel.org\/OTA\/2003\/05\" Version=\"1.0\" TimeStamp=\"2005-08-01T09:30:47+08:00\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;POS>\n\u00a0\u00a0\u00a0\u00a0&lt;Source>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;RequestorID Type=\"22\" ID=\"PMS1\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/Source>\n\u00a0\u00a0&lt;\/POS>\n\u00a0\u00a0&lt;ReadRequests>\n\u00a0\u00a0\u00a0\u00a0&lt;HotelReadRequest HotelCode=\"ABC\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;SelectionCriteria SelectionType=\"Undelivered\" ResStatus=\"Cancel\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/HotelReadRequest>\n\u00a0\u00a0&lt;\/ReadRequests>\n&lt;\/OTA_ReadRQ>\n<\/code><\/pre>\n\n\n\n<p style=\"font-size:15px\">The message below will return all undelivered modifications for the hotel with HotelCode ABC<\/p>\n\n\n\n<p style=\"font-size:15px\"><strong>Request undelivered modifications<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;OTA_ReadRQ xmlns=\"http:\/\/www.opentravel.org\/OTA\/2003\/05\" Version=\"1.0\" TimeStamp=\"2005-08-01T09:30:47+08:00\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;POS>\n\u00a0\u00a0\u00a0\u00a0&lt;Source>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;RequestorID Type=\"22\" ID=\"PMS1\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/Source>\n\u00a0\u00a0&lt;\/POS>\n\u00a0\u00a0&lt;ReadRequests>\n\u00a0\u00a0\u00a0\u00a0&lt;HotelReadRequest HotelCode=\"ABC\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;SelectionCriteria SelectionType=\"Undelivered\" ResStatus=\"Modify\"\/>\n\u00a0\u00a0\u00a0\u00a0&lt;\/HotelReadRequest>\n\u00a0\u00a0&lt;\/ReadRequests>\n&lt;\/OTA_ReadRQ>\n<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">OTA_ReadRQ Specification<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>OTA_ReadRQ<\/td><td>1<\/td><td>Root element<\/td><\/tr><tr><td>@Version<\/td><td>1<\/td><td>Current Version 1.0<\/td><\/tr><tr><td>@EchoToken<\/td><td>1<\/td><td>Globally unique identifier for the request, value will be returned as an EchoToken in the response.<\/td><\/tr><tr><td>@TimeStamp<\/td><td>1<\/td><td>Time of the transaction in xml schema dateTime format<\/td><\/tr><tr><td>OTA_ReadRQ \/ POS \/ Source \/ RequestorID<\/td><td>1<\/td><td>This identifies the system which is sending the reservation. This element must appear in the first Source element.<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Fixed at 22 (ESRP)<\/td><\/tr><tr><td>@ID<\/td><td>1<\/td><td>The ID used will be agreed by the trading partners and remain the same throughout the messages.<\/td><\/tr><tr><td>OTA_ReadRQ \/ ReadRequests<\/td><td>1<\/td><td><\/td><\/tr><tr><td>ReadRequests \/ HotelReadRequest<\/td><td>1<\/td><td><\/td><\/tr><tr><td>@HotelCode<\/td><td>0..1<\/td><td>Hotel code as recognised by pmsXchange. If omitted all reservations for the PMS will be returned.<strong>Note:<\/strong>&nbsp;This attribute is only optional for central property management systems. It is mandatory for on-site systems.<\/td><\/tr><tr><td>HotelReadRequest \/ SelectionCriteria<\/td><td>1<\/td><td><\/td><\/tr><tr><td>@SelectionType<\/td><td>1<\/td><td>Must be &#8220;Undelivered&#8221;<\/td><\/tr><tr><td>@ResStatus<\/td><td>0..1<\/td><td>Allowed values are &#8220;Book&#8221;, &#8220;Modify&#8221; or &#8220;Cancel&#8221;. If omitted new, modified and cancelled reservations will be returned.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\" id=\"ota_resretrievers\">OTA_ResRetrieveRS<\/h4>\n\n\n\n<p style=\"font-size:15px\">This message is returned by Effective Tours API in response to the <code>OTA_ReadRQ<\/code>. It&#8217;s primary payload is a list of HotelReservations which meet the request criteria in the <code>OTA_ReadRQ<\/code>.<\/p>\n\n\n\n<h5 class=\"wp-block-heading\">Reservations that meet the request criteria are returned<\/h5>\n\n\n\n<p style=\"font-size:15px\">Effective Tours API is channeling reservations from multiple different booking sources. The <code>OTA_ResRetrieveRS<\/code> Specification below has a number listed next to the node name to indicate if the node is mandatory or not.&nbsp;The <code>OTA_ResRetrieveRS<\/code> spec below is not designed to appear exactly in the order presented below. Coding to Effective Tours API should be flexible and allow for order variations to nodes\/elements.<\/p>\n\n\n\n<ul><li>The&nbsp;<code>&lt;Success\/&gt;<\/code>&nbsp;element indicates a successful response<\/li><li>In this example 2 new reservations are returned. As covered in Retrieve &amp; Confirm Use Cases documents, the Effective Tours API reservation identifiers are &#8220;WTF-001&#8221; and &#8220;HTL-002&#8221; and the message ids for these reservations are &#8220;1243132&#8221; and &#8220;1243133&#8221;.<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;tns:OTA_ResRetrieveRS Version=\"1.0\" TimeStamp=\"2005-08-01T09:32:47+0000\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;tns:Success>&lt;\/tns:Success>\n\u00a0\u00a0&lt;tns:ReservationsList>\n\u00a0\u00a0\u00a0\u00a0&lt;tns:HotelReservation CreateDateTime=\"2007-12-09T08:51:45+00:00\" ResStatus=\"Book\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;tns:UniqueID Type=\"14\" ID=\"WTF-001\"\/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;tns:UniqueID Type=\"16\" ID=\"ETR-442570-1565094220-237891\" ID_Context=\"MESSAGE_UNIQUE_ID\"\/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;!-- HOTEL RESERVATION DETAILS OMITTED -->\n\u00a0\u00a0\u00a0\u00a0&lt;\/tns:HotelReservation>\n\u00a0\u00a0\u00a0\u00a0&lt;tns:HotelReservation CreateDateTime=\"2007-12-09T08:51:45+00:00\" ResStatus=\"Book\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;tns:UniqueID Type=\"14\" ID=\"HTL-002\"\/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;tns:UniqueID Type=\"16\" ID=\"ETR-441670-1565160285-2102652\" ID_Context=\"MESSAGE_UNIQUE_ID\"\/>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0&lt;!-- HOTEL RESERVATION DETAILS OMITTED -->\n\u00a0\u00a0\u00a0\u00a0&lt;\/tns:HotelReservation>\n\u00a0\u00a0&lt;\/tns:ReservationsList>\n&lt;\/tns:OTA_ResRetrieveRS>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">No reservations are found that meet the request criteria<\/h5>\n\n\n\n<ul><li>The presence of the&nbsp;<code>&lt;Success\/&gt;<\/code>&nbsp;element indicates successful processing but the lack of the&nbsp;<code>ReservationsList<\/code>&nbsp;element shows no reservations were available.<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;tns:OTA_ResRetrieveRS Version=\"1.0\" TimeStamp=\"2005-08-01T09:31:00+0000\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;tns:Success>&lt;\/tns:Success>\n&lt;\/tns:OTA_ResRetreiveRS>\n<\/code><\/pre>\n\n\n\n<h5 class=\"wp-block-heading\">An error occurred processing the request<\/h5>\n\n\n\n<ul><li>The presence of the&nbsp;<code>&lt;Errors\/&gt;<\/code>&nbsp;element indicates an error in business logic occurred.<\/li><\/ul>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;tns:OTA_ResRetrieveRS Version=\"1.0\" TimeStamp=\"2005-08-01T09:31:00+08:00\" EchoToken=\"echo-abc123\">\n\u00a0\u00a0&lt;tns:Errors>\n\u00a0\u00a0\u00a0\u00a0&lt;tns:Error Type=\"3\" Code=\"392\">Invalid Hotel Code&lt;\/Error>\n\u00a0\u00a0&lt;\/tns:Errors>\n&lt;\/tns:OTA_ResRetreiveRS>\n<\/code><\/pre>\n\n\n\n<h4 class=\"wp-block-heading\">OTA_ResRetrieveRS Specification<\/h4>\n\n\n\n<p style=\"font-size:15px\">The main payload of the <code>OTA_ResRetrieveRS<\/code> message is a list of <code>HotelReservation<\/code> elements. The content will vary because Effective Tours API is delivering reservations from many different upstream sources (Booking Channels), many of which have vastly different reservation formats and data structures.&nbsp;<\/p>\n\n\n\n<p style=\"font-size:15px\">In general, the following can be said about <code>HotelReservations<\/code>:<\/p>\n\n\n\n<ul><li>A&nbsp;<code>HotelReservation<\/code>&nbsp;represents a single reservation made with an upstream system.<\/li><li>A&nbsp;<code>HotelReservation<\/code>&nbsp;can have one or more&nbsp;<code>RoomStays<\/code>, one for each room type booked.<\/li><li>A&nbsp;<code>RoomStay<\/code>&nbsp;represents a stay in one room type over a continuous timespan, non-continuous timespan stays (split stays) will result in multiple&nbsp;<code>RoomStays<\/code>.<\/li><li>A&nbsp;<code>HotelReservation<\/code>&nbsp;can have zero, one or many&nbsp;<code>ResGuests<\/code>&nbsp;linked to either the&nbsp;<code>RoomStay<\/code>&nbsp;the guest stay in or the reservation.<\/li><\/ul>\n\n\n\n<p style=\"font-size:15px\">Elements and attributes marked with Number=1 or more are mandatory and will always be sent. 0..n means that the element or attribute is optional.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element&nbsp; &nbsp;&nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>OTA_ResRetrieveRS<\/td><td>1<\/td><td>Root element<\/td><\/tr><tr><td>@Version<\/td><td>1<\/td><td>Current Version 1.0<\/td><\/tr><tr><td>@EchoToken<\/td><td>1<\/td><td>Globally unique identifier for the request, value will be returned as an EchoToken in the response.<\/td><\/tr><tr><td>@TimeStamp<\/td><td>1<\/td><td>Time of the transaction in xml schema dateTime format<\/td><\/tr><tr><td>OTA_ResRetrieveRS \/ Success<\/td><td>0..1<\/td><td>Should only be present if the request processed successfully. The Errors node will not be present if the Success node is present.<\/td><\/tr><tr><td>OTA_ResRetrieveRS \/ Errors<\/td><td>0..1<\/td><td>Contains a list of errors if the request failed to process.<\/td><\/tr><tr><td>Errors \/ Error<\/td><td>1..n<\/td><td>Should be at least one node if there is an Errors Node.<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Mandatory if Error present. Any type from the OTA code table for &#8216;Error Warning Type (EWT)&#8217; can be used. In particular, the following types are used<\/td><\/tr><tr><td><\/td><td><\/td><td>3: Biz rule (The business rules for the request message were not met)<\/td><\/tr><tr><td><\/td><td><\/td><td>4: Authentication error (If username and password are not authenticated)<\/td><\/tr><tr><td><\/td><td><\/td><td>6: Authorization error (If authenticated username is not authorized to alter hotel data)<\/td><\/tr><tr><td><\/td><td><\/td><td>10: Required field missing (If xml does not meet the schema, i.e missing request fields or invalid data types.)<\/td><\/tr><tr><td>@Code<\/td><td>0..1<\/td><td>Any code from the OTA code table for &#8216;Error Codes (ERR)&#8217; can be used.<\/td><\/tr><tr><td>OTA_ResRetrieveRS \/ ReservationsList<\/td><td>0..1<\/td><td>ReservationList is only present if there are HotelReservation elements.&nbsp;<\/td><\/tr><tr><td>ReservationsList \/ HotelReservation<\/td><td>1..n<\/td><td>At least one reservation element if ReservationList exists.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">HotelReservationType<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>@CreateDateTime<\/td><td>1<\/td><td>This is the date when the reservation was first made. Mandatory if ResStatus is &#8220;Book&#8221;.<\/td><\/tr><tr><td>@LastModifyDateTime<\/td><td>0..1<\/td><td>This indicates the last date and time when the reservation was last modified. Mandatory if ResStatus is &#8220;Modify&#8221; or &#8220;Cancel&#8221;.<\/td><\/tr><tr><td>@ResStatus<\/td><td>1<\/td><td>Status is &#8220;Book&#8221;, &#8220;Modify&#8221; or &#8220;Cancel&#8221;<\/td><\/tr><tr><td>HotelReservation \/ UniqueID<\/td><td>1..2<\/td><td>The reservation reference in Effective Tours. The&nbsp;<strong><em>first<\/em><\/strong>&nbsp;UniqueID element will contain the unique identifier for the entire reservation. This identifier will identify the reservation through any subsequent modifications or cancellations. The&nbsp;<strong><em>second<\/em><\/strong>&nbsp;UniqueID element with ID_Context=&#8221;MESSAGE_UNIQUE_ID&#8221; is the unique id for this&nbsp;<strong><em>message<\/em><\/strong>.This identifier should be used to confirm the message once processed<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Value &#8217;14&#8217; is the unique id for the reservation in Effective Tours. Value &#8217;16&#8217; is the unique id for the message transferring the reservation.<\/td><\/tr><tr><td>@ID<\/td><td>1<\/td><td>Identifier of the reservation according to Effective Tours. Note, this is NOT the reservation id according to the upstream system. This is located in the HotelReservationID element.There is the possiblility that this ID will contain special characters such as &#8216;\/&#8217;.<\/td><\/tr><tr><td>@ID_Context<\/td><td>0..1<\/td><td>Only present for the second UniqueID element and when present it will always be &#8220;MESSAGE_UNIQUE_ID&#8221;<\/td><\/tr><tr><td>HotelReservation \/ POS<\/td><td>1<\/td><td>Point of sale<\/td><\/tr><tr><td>POS \/ Source<\/td><td>1..2<\/td><td>Source of the reservation. A second POS \/ Source node can be present to define a secondary channel source.<\/td><\/tr><tr><td>Source \/ RequestorID<\/td><td>0..1<\/td><td>This identifies the system which is sending the reservation. This element will only appear in the first Source element.<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Fixed at 22 (ESRP)<\/td><\/tr><tr><td>@ID<\/td><td>1<\/td><td>Value is always &#8216;EFFECTIVETOURS&#8217;<\/td><\/tr><tr><td>Source \/ BookingChannel<\/td><td>1<\/td><td>Contains booking channel information<\/td><\/tr><tr><td>@Primary<\/td><td>1<\/td><td>Indicates the primary booking source<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Always &#8216;7&#8217; for &#8216;Internet&#8217;.<\/td><\/tr><tr><td>BookingChannel \/ CompanyName<\/td><td>1<\/td><td>Name of the Booking Channel.<strong>NOTE:<\/strong>&nbsp;This name is subject to change\/variation by the Booking Channel. Please use the @Code attribute below to identify Booking Channels on incoming reservations.<\/td><\/tr><tr><td>@Code<\/td><td>0..1<\/td><td>Effective Tours&#8217;s code to identify the Booking Channel. See the [OTA Booking Channel Type (BCT)]table for reference. For secondary channels this code may not be available, when present it will be the secondary channel code as provided by the source channel.<\/td><\/tr><tr><td>HotelReservation \/ RoomStays \/ RoomStay<\/td><td>0..n<\/td><td>One instance of RoomStay per room booked. A RoomStay element will always exist if ResStatus is &#8220;Book&#8221; or &#8220;Modify&#8221;. If ResStatus is &#8220;Cancel&#8221; it is possible that no RoomStay element exists.<\/td><\/tr><tr><td>Reservation \/ ResGuests \/ ResGuest<\/td><td>0..n<\/td><td>One instance of ResGuest per reservation guests. This guest information is dependent on the sometimes limited information retrieved from the booking agents. ResGuests might not always be directly linkable to the RoomStays. Either all ResGuests are linked to RoomStays or none are.<\/td><\/tr><tr><td>HotelReservation \/ ResGlobalInfo<\/td><td>1<\/td><td>Contains general information about the Reservation<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">ResGlobalInfo<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>HotelReservationIDs \/ HotelReservationID<\/td><td>0..2<\/td><td>Reference number\/string or PNR as supplied by the Booking agent will be supplied here. If this reservation is linked under an itinerary, the itinerary id given by the source booking agent will be supplied in a second.<\/td><\/tr><tr><td>@ResID_Type<\/td><td>1<\/td><td>Will be sent as 14 or 26.14: OTA code for &#8216;Travel Agent PNR&#8217;. If this type is used the @ResID_Value will be the reservation identifier as provided by the source booking channel.26: OTA code for &#8216;Associated itinerary reservation&#8217;. If this type is used the @ResID_Value will be the itinerary identifier for one or more bookings in an itinerary as provided by the source booking channel.<\/td><\/tr><tr><td>@ResID_Value<\/td><td>1<\/td><td>Reference number\/string supplied by the Booking agent. ResID_Value could potentially contain special characters such &#8216;\/&#8217;.<\/td><\/tr><tr><td>Total<\/td><td>0..1<\/td><td>The total amount for the Reservation. Will add up to the sum of the RoomStay totals PLUS any additional fees sent by the BookingAgent.<strong>NOTE:<\/strong>&nbsp;It is possible that some OTAs do not provide any form of Rate information. As such we cannot guarantee Rate information will be provided.<\/td><\/tr><tr><td>Fees \/ Fee<\/td><td>0..n<\/td><td>A container for added fees<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Always &#8216;Inclusive&#8217;<\/td><\/tr><tr><td>@Amount<\/td><td>0..1<\/td><td>Commission amount<\/td><\/tr><tr><td>Comments \/ Comment \/ Text<\/td><td>0..n<\/td><td>Reservation comments<\/td><\/tr><tr><td>BasicPropertyInfo<\/td><td>1<\/td><td>Holds information about the Hotelier which this reservation is for.<\/td><\/tr><tr><td>@HotelCode<\/td><td>1<\/td><td>The code for the Hotel for which the booking was made.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">ResGuestType<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>@PrimaryIndicator<\/td><td>0..1<\/td><td>When true indicates this is the primary guest<\/td><\/tr><tr><td>ResGuest \/ Profiles<\/td><td>1<\/td><td>Contains the guest profile information<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">RoomStayType<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>RoomStay \/ UniqueID<\/td><td>1<\/td><td>The room reference inside reservation.<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>Value &#8217;17&#8217; is the unique id for the room inside reservation in Effective Tours.<\/td><\/tr><tr><td>@ID<\/td><td>1<\/td><td>Identifier of the room inside reservation according to Effective Tours.<\/td><\/tr><tr><td>RoomStay \/ RoomTypes \/ RoomType<\/td><td>0..1<\/td><td>Container for room information, will be omitted if none was provided by the source channel. There will only ever be one RoomType per RoomStay<\/td><\/tr><tr><td>@RoomType<\/td><td>0..1<\/td><td>The name of the RoomType as provided by source channel<\/td><\/tr><tr><td>@RoomTypeCode<\/td><td>0..1<\/td><td>Room code, identifier for the room in Effective Tours<\/td><\/tr><tr><td>@ChannelRoomTypeCode<\/td><td>0..1<\/td><td>Room code, identifier for the room in the source channel<\/td><\/tr><tr><td>RoomType \/ RoomDescription \/ Text<\/td><td>0..1<\/td><td>A text description of the room<\/td><\/tr><tr><td>RoomStay \/ RatePlans<\/td><td>0..1<\/td><td>Container for room information, will be omitted if none was provided by the source channel<\/td><\/tr><tr><td>RatePlans \/ RatePlan<\/td><td>0..n<\/td><td>Contains information for the Rate Plan(s) used for the RoomStay.<\/td><\/tr><tr><td>@RatePlanCode<\/td><td>0..1<\/td><td>Rate code, identifier for the rate plan in Effective Tours<\/td><\/tr><tr><td>@ChannelRatePlanCode<\/td><td>0..1<\/td><td>Rate code, identifier for the rate plan in the source channel<\/td><\/tr><tr><td>@RatePlanName<\/td><td>0..1<\/td><td>Name of the rate plan as provided the source channel<\/td><\/tr><tr><td>RatePlan \/ RateDescription \/ Text<\/td><td>0..1<\/td><td>A text description of the rate<\/td><\/tr><tr><td>RoomStay \/ RoomRates \/ RoomRate<\/td><td>1..n<\/td><td>Multiple RoomRates per RoomStay. Multiple rates are listed under each RoomRate. This can happen when there is a single room booked but more than one rate plan applies during the stay.<\/td><\/tr><tr><td>RoomStay \/ GuestCounts \/ GuestCount<\/td><td>0..3<\/td><td>How many guests will be staying in the room. The count is split over potentially three GuestCount elements under GuestCounts, one for each type of guest: adult, child or infant.<\/td><\/tr><tr><td>@AgeQualifyingCode<\/td><td>1<\/td><td>Specifies the guest type for this GuestCount &#8211; uses OTA Spec for identifiers, will be one of three values 10 &#8211; Adult, 8 &#8211; Child, 7 &#8211; Infant<\/td><\/tr><tr><td>@Count<\/td><td>1<\/td><td>The actual count for this type of guest<\/td><\/tr><tr><td>RoomStay \/ RoomGuests<\/td><td>0..1<\/td><td>Contains guest names for this room<\/td><\/tr><tr><td>RoomGuests \/ RoomGuest<\/td><td>0..n<\/td><td>Contains guest name<\/td><\/tr><tr><td>@Name<\/td><td>1<\/td><td>Full guest name<\/td><\/tr><tr><td>RoomStay \/ TimeSpan<\/td><td>1<\/td><td>Contains the timespan which this RoomStay covers<\/td><\/tr><tr><td>@Start<\/td><td>1<\/td><td>Check in date<\/td><\/tr><tr><td>@End<\/td><td>1<\/td><td>Check out date<\/td><\/tr><tr><td>RoomStay \/ Total<\/td><td>0..1<\/td><td>The total amount of the RoomStay.<\/td><\/tr><tr><td>RoomStay \/ Total \/ Taxes&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The total tax amount for the RoomStay<\/td><\/tr><tr><td>@Amount&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The tax amount<\/td><\/tr><tr><td>RoomStay \/ BasicPropertyInfo<\/td><td>1<\/td><td>Holds information about the Hotelier which this reservation is for.<strong>NOTE:<\/strong>&nbsp;If you are requesting reservations for all your hotels, using a single OTA_ReadRQ (centralised) we recommend using [ResGlobal \/ BasicPropertyInfo \/ @HotelCode]<\/td><\/tr><tr><td>@HotelCode<\/td><td>1<\/td><td>The code for the Hotel for which the booking was made.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">RoomRateType<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>RoomStay \/ RoomRates \/ RoomRate<\/td><td>1..n<\/td><td>Multiple RoomRates per RoomStay. Multiple rates are listed under each RoomRate. This can happen when there is a single room booked but more than one rate plan applies during the stay.<\/td><\/tr><tr><td>@RoomTypeCode<\/td><td>1<\/td><td>The code of the room booked<\/td><\/tr><tr><td>@NumberOfUnits<\/td><td>1<\/td><td>Always 1. Each room will be listed in it&#8217;s own RoomStay element.<\/td><\/tr><tr><td>@RatePlanCode<\/td><td>1<\/td><td>This is the rate booked for the room type code listed in the RoomTypeCode attribute.<\/td><\/tr><tr><td>RoomRate \/ Rates<\/td><td>0..1<\/td><td>Container for the daily rate breakdown information, if none was provided by the channel this will be omitted<\/td><\/tr><tr><td>Rates \/ Rate<\/td><td>1..n<\/td><td>The Rate element contains a timespan with daily rate information. The dates covered in the Rates will cover all the dates in the RoomStay\/TimeSpan element.<\/td><\/tr><tr><td>@RateTimeUnit<\/td><td>1<\/td><td>Always &#8220;Day&#8221;<\/td><\/tr><tr><td>@EffectiveDate<\/td><td>1<\/td><td>The date of the rate in the form yyyy-MM-dd.<\/td><\/tr><tr><td>@Amount<\/td><td>1<\/td><td>The amount charged for the Rate.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">ProfilesType<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>Profiles \/ ProfileInfo<\/td><td>1..n<\/td><td>Profile information<\/td><\/tr><tr><td>ProfileInfo \/ UniqueID<\/td><td>0..n<\/td><td>Contains profile ids provided by the source channel. There can 0 to many identifiers passed through here<\/td><\/tr><tr><td>@Type<\/td><td>1<\/td><td>This will always be &#8220;16&#8221; to represent &#8216;Reference&#8217; from the OTA code table Unique Id Type (UIT)<\/td><\/tr><tr><td>@ID<\/td><td>1<\/td><td>The reference identifier for the profile as provided by the source channel<\/td><\/tr><tr><td>@ID_Context<\/td><td>1<\/td><td>This can be one of 2 values:&nbsp;<strong>CHANNEL:<\/strong>&nbsp;To specify that this is a channel reference id.&nbsp;<strong>IATA:<\/strong>&nbsp;To specify that this is an IATA identifier for a travel agent<\/td><\/tr><tr><td>ProfileInfo \/ Profile<\/td><td>1<\/td><td>Contains the profile information<\/td><\/tr><tr><td>@ProfileType<\/td><td>1<\/td><td>The type of profile<\/td><\/tr><tr><td>Profile \/ Customer<\/td><td><\/td><td><\/td><\/tr><tr><td>Customer \/ PersonName<\/td><td>0..1<\/td><td>Profile name details. Always present for type Customer.<\/td><\/tr><tr><td>PersonName \/ GivenName<\/td><td>0..1<\/td><td>The name of the profile. Always present for type Customer.<\/td><\/tr><tr><td>PersonName \/ Surname<\/td><td>0..1<\/td><td>The last name of the profile. Always present for type Customer.<\/td><\/tr><tr><td>Customer \/ Telephone<\/td><td>0..1<\/td><td>Contact telephone number for the profile if available<\/td><\/tr><tr><td>@PhoneNumber<\/td><td>0..1<\/td><td>The actual number, will be there if the Telephone element is there<\/td><\/tr><tr><td>Customer \/ Email<\/td><td>0..1<\/td><td>The email address of the profile if available<\/td><\/tr><tr><td>Customer \/ Address<\/td><td>0..1<\/td><td>Address information for the profile if available<\/td><\/tr><tr><td>Address \/ AddressLine<\/td><td>0..n<\/td><td>One or more address lines for the profile<\/td><\/tr><tr><td>Address \/ CityName<\/td><td>0..1<\/td><td>Customer city of residence if available<\/td><\/tr><tr><td>Address \/ PostalCode<\/td><td>0..1<\/td><td>Post code for profile if available<\/td><\/tr><tr><td>Address \/ CountryName<\/td><td>0..1<\/td><td>Country name<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h4 class=\"wp-block-heading\">TotalType<\/h4>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"\"><thead><tr><th>Element &nbsp;<\/th><th>Number<\/th><th>Description<\/th><\/tr><\/thead><tbody><tr><td>@CurrencyCode&nbsp;&nbsp;&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The ISO currency code for the total<\/td><\/tr><tr><td>@AmountAfterTax&nbsp;&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The total amount after tax<\/td><\/tr><tr><td>@AmountBeforeTax&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The total amount before tax<\/td><\/tr><tr><td>Taxes&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The total tax amount for the TotalType<\/td><\/tr><tr><td>@Amount&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<\/td><td>0..1&nbsp;<\/td><td>The total tax amount<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>Last Updated:\u00a0Nov 26, 2019 <\/p>\n\n\n\n<p style=\"font-size:15px\">&#8212;- &#8212;-  &#8212;-  &#8212;-  &#8212;-  &#8212;-  &#8212;- &#8212; &#8212;  &#8212;  &#8212;  &#8212; <br><a href=\"https:\/\/effectivetours.com\/docs\/wiki\/effective-tours-api-v-2-0\/\">Back to API Documentation<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0},"wiki_cats":[52],"wiki_tags":[],"aioseo_notices":[],"aioseo_head":"\n\t\t<!-- All in One SEO 5.0.0.1 - aioseo.com -->\n\t<meta name=\"description\" content=\"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced &#039;Availability&#039; (BookingLimit) value via the &#039;Inventory API&#039; immediately after a reservation has been delivered.\" \/>\n\t<meta name=\"robots\" content=\"max-image-preview:large\" \/>\n\t<meta name=\"author\" content=\"ric\"\/>\n\t<link rel=\"canonical\" href=\"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/\" \/>\n\t<meta name=\"generator\" content=\"All in One SEO (AIOSEO) 5.0.0.1\" \/>\n\t\t<meta property=\"og:locale\" content=\"en_US\" \/>\n\t\t<meta property=\"og:site_name\" content=\"Effective Tours Knowledge Base\" \/>\n\t\t<meta property=\"og:type\" content=\"article\" \/>\n\t\t<meta property=\"og:title\" content=\"Retrieve Reservations | Effective Tours Knowledge Base\" \/>\n\t\t<meta property=\"og:description\" content=\"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced &#039;Availability&#039; (BookingLimit) value via the &#039;Inventory API&#039; immediately after a reservation has been delivered.\" \/>\n\t\t<meta property=\"og:url\" content=\"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/\" \/>\n\t\t<meta property=\"og:image\" content=\"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/02\/ET-Logo.png\" \/>\n\t\t<meta property=\"og:image:secure_url\" content=\"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/02\/ET-Logo.png\" \/>\n\t\t<meta property=\"article:published_time\" content=\"2020-01-24T08:15:11+00:00\" \/>\n\t\t<meta property=\"article:modified_time\" content=\"2020-01-24T08:15:11+00:00\" \/>\n\t\t<meta name=\"twitter:card\" content=\"summary\" \/>\n\t\t<meta name=\"twitter:title\" content=\"Retrieve Reservations | Effective Tours Knowledge Base\" \/>\n\t\t<meta name=\"twitter:description\" content=\"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced &#039;Availability&#039; (BookingLimit) value via the &#039;Inventory API&#039; immediately after a reservation has been delivered.\" \/>\n\t\t<meta name=\"twitter:image\" content=\"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/02\/ET-Logo.png\" \/>\n\t\t<script type=\"application\/ld+json\" class=\"aioseo-schema\">\n\t\t\t{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#breadcrumblist\",\"itemListElement\":[{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs#listItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/effectivetours.com\\\/docs\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/#listItem\",\"name\":\"Wiki Pages\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/#listItem\",\"position\":2,\"name\":\"Wiki Pages\",\"item\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki_cats\\\/api\\\/#listItem\",\"name\":\"API\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs#listItem\",\"name\":\"Home\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki_cats\\\/api\\\/#listItem\",\"position\":3,\"name\":\"API\",\"item\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki_cats\\\/api\\\/\",\"nextItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#listItem\",\"name\":\"Retrieve Reservations\"},\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/#listItem\",\"name\":\"Wiki Pages\"}},{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#listItem\",\"position\":4,\"name\":\"Retrieve Reservations\",\"previousItem\":{\"@type\":\"ListItem\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki_cats\\\/api\\\/#listItem\",\"name\":\"API\"}}]},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/#organization\",\"name\":\"Effective Tours Knowledge Base\",\"url\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wp-content\\\/uploads\\\/2020\\\/01\\\/ET-Logo-100px.jpg\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#organizationLogo\"},\"image\":{\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#organizationLogo\"}},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/author\\\/ric\\\/#author\",\"url\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/author\\\/ric\\\/\",\"name\":\"ric\",\"image\":{\"@type\":\"ImageObject\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#authorImage\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/e8dca2574d7f060610cfaa2e8d067848?s=96&d=mm&r=g\",\"width\":96,\"height\":96,\"caption\":\"ric\"}},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#webpage\",\"url\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/\",\"name\":\"Retrieve Reservations | Effective Tours Knowledge Base\",\"description\":\"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced 'Availability' (BookingLimit) value via the 'Inventory API' immediately after a reservation has been delivered.\",\"inLanguage\":\"en-US\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/#website\"},\"breadcrumb\":{\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/wiki\\\/retrieve-reservations\\\/#breadcrumblist\"},\"author\":{\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/author\\\/ric\\\/#author\"},\"creator\":{\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/author\\\/ric\\\/#author\"},\"datePublished\":\"2020-01-24T13:45:11+05:30\",\"dateModified\":\"2020-01-24T13:45:11+05:30\"},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/#website\",\"url\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/\",\"name\":\"Effective Tours Knowledge Base\",\"inLanguage\":\"en-US\",\"publisher\":{\"@id\":\"https:\\\/\\\/effectivetours.com\\\/docs\\\/#organization\"}}]}\n\t\t<\/script>\n\t\t<!-- All in One SEO -->\n\n","aioseo_head_json":{"title":"Retrieve Reservations | Effective Tours Knowledge Base","description":"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced 'Availability' (BookingLimit) value via the 'Inventory API' immediately after a reservation has been delivered.","canonical_url":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/","robots":"max-image-preview:large","keywords":"","webmasterTools":{"miscellaneous":""},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"BreadcrumbList","@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#breadcrumblist","itemListElement":[{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs#listItem","position":1,"name":"Home","item":"https:\/\/effectivetours.com\/docs","nextItem":{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki\/#listItem","name":"Wiki Pages"}},{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki\/#listItem","position":2,"name":"Wiki Pages","item":"https:\/\/effectivetours.com\/docs\/wiki\/","nextItem":{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki_cats\/api\/#listItem","name":"API"},"previousItem":{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs#listItem","name":"Home"}},{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki_cats\/api\/#listItem","position":3,"name":"API","item":"https:\/\/effectivetours.com\/docs\/wiki_cats\/api\/","nextItem":{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#listItem","name":"Retrieve Reservations"},"previousItem":{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki\/#listItem","name":"Wiki Pages"}},{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#listItem","position":4,"name":"Retrieve Reservations","previousItem":{"@type":"ListItem","@id":"https:\/\/effectivetours.com\/docs\/wiki_cats\/api\/#listItem","name":"API"}}]},{"@type":"Organization","@id":"https:\/\/effectivetours.com\/docs\/#organization","name":"Effective Tours Knowledge Base","url":"https:\/\/effectivetours.com\/docs\/","logo":{"@type":"ImageObject","url":"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/01\/ET-Logo-100px.jpg","@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#organizationLogo"},"image":{"@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#organizationLogo"}},{"@type":"Person","@id":"https:\/\/effectivetours.com\/docs\/author\/ric\/#author","url":"https:\/\/effectivetours.com\/docs\/author\/ric\/","name":"ric","image":{"@type":"ImageObject","@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#authorImage","url":"https:\/\/secure.gravatar.com\/avatar\/e8dca2574d7f060610cfaa2e8d067848?s=96&d=mm&r=g","width":96,"height":96,"caption":"ric"}},{"@type":"WebPage","@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#webpage","url":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/","name":"Retrieve Reservations | Effective Tours Knowledge Base","description":"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced 'Availability' (BookingLimit) value via the 'Inventory API' immediately after a reservation has been delivered.","inLanguage":"en-US","isPartOf":{"@id":"https:\/\/effectivetours.com\/docs\/#website"},"breadcrumb":{"@id":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/#breadcrumblist"},"author":{"@id":"https:\/\/effectivetours.com\/docs\/author\/ric\/#author"},"creator":{"@id":"https:\/\/effectivetours.com\/docs\/author\/ric\/#author"},"datePublished":"2020-01-24T13:45:11+05:30","dateModified":"2020-01-24T13:45:11+05:30"},{"@type":"WebSite","@id":"https:\/\/effectivetours.com\/docs\/#website","url":"https:\/\/effectivetours.com\/docs\/","name":"Effective Tours Knowledge Base","inLanguage":"en-US","publisher":{"@id":"https:\/\/effectivetours.com\/docs\/#organization"}}]},"og:locale":"en_US","og:site_name":"Effective Tours Knowledge Base","og:type":"article","og:title":"Retrieve Reservations | Effective Tours Knowledge Base","og:description":"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced 'Availability' (BookingLimit) value via the 'Inventory API' immediately after a reservation has been delivered.","og:url":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/","og:image":"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/02\/ET-Logo.png","og:image:secure_url":"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/02\/ET-Logo.png","article:published_time":"2020-01-24T08:15:11+00:00","article:modified_time":"2020-01-24T08:15:11+00:00","twitter:card":"summary","twitter:title":"Retrieve Reservations | Effective Tours Knowledge Base","twitter:description":"The connected PMS should retrieve reservations, modifications and cancellations from Effective Tours using the OTA_ReadRQ message.Effective Tours API will respond with aOTA_ResRetrieveRS that contain the reservations, modifications or cancellations that meet the request criteria in the read request. The integrated PMS MUST return the reduced 'Availability' (BookingLimit) value via the 'Inventory API' immediately after a reservation has been delivered.","twitter:image":"https:\/\/effectivetours.com\/docs\/wp-content\/uploads\/2020\/02\/ET-Logo.png"},"aioseo_meta_data":{"post_id":"659","title":null,"description":null,"keywords":null,"keyphrases":null,"primary_term":null,"canonical_url":null,"og_title":null,"og_description":null,"og_object_type":"default","og_image_type":"default","og_image_url":null,"og_image_width":null,"og_image_height":null,"og_image_custom_url":null,"og_image_custom_fields":null,"og_video":null,"og_custom_url":null,"og_article_section":null,"og_article_tags":null,"twitter_use_og":false,"twitter_card":"default","twitter_image_type":"default","twitter_image_url":null,"twitter_image_custom_url":null,"twitter_image_custom_fields":null,"twitter_title":null,"twitter_description":null,"schema":{"blockGraphs":[],"customGraphs":[],"default":{"data":{"Article":[],"Course":[],"Dataset":[],"FAQPage":[],"Movie":[],"Person":[],"Product":[],"ProductReview":[],"Car":[],"Recipe":[],"Service":[],"SoftwareApplication":[],"WebPage":[]},"graphName":"","isEnabled":true},"graphs":[],"defaultGraph":"","defaultPostTypeGraph":""},"schema_type":null,"schema_type_options":null,"pillar_content":false,"robots_default":true,"robots_noindex":false,"robots_noarchive":false,"robots_nosnippet":false,"robots_nofollow":false,"robots_noimageindex":false,"robots_noodp":false,"robots_notranslate":false,"robots_max_snippet":null,"robots_max_videopreview":null,"robots_max_imagepreview":"large","priority":null,"frequency":null,"local_seo":null,"breadcrumb_settings":null,"limit_modified_date":false,"ai":null,"created":"2021-08-03 09:11:55","updated":"2025-06-04 00:42:23","seo_analyzer_scan_date":null,"focus_keyword":null,"additional_keywords":null,"truseo_locale":null},"aioseo_breadcrumb":"<div class=\"aioseo-breadcrumbs\"><span class=\"aioseo-breadcrumb\">\n\t\t\t<a href=\"https:\/\/effectivetours.com\/docs\" title=\"Home\">Home<\/a>\n\t\t<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\t\t\t<a href=\"https:\/\/effectivetours.com\/docs\/wiki\/\" title=\"Wiki Pages\">Wiki Pages<\/a>\n\t\t<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\t\t\t<a href=\"https:\/\/effectivetours.com\/docs\/wiki_cats\/api\/\" title=\"API\">API<\/a>\n\t\t<\/span><span class=\"aioseo-breadcrumb-separator\">&raquo;<\/span><span class=\"aioseo-breadcrumb\">\n\t\t\tRetrieve Reservations\n\t\t<\/span><\/div>","aioseo_breadcrumb_json":[{"label":"Home","link":"https:\/\/effectivetours.com\/docs"},{"label":"Wiki Pages","link":"https:\/\/effectivetours.com\/docs\/wiki\/"},{"label":"API","link":"https:\/\/effectivetours.com\/docs\/wiki_cats\/api\/"},{"label":"Retrieve Reservations","link":"https:\/\/effectivetours.com\/docs\/wiki\/retrieve-reservations\/"}],"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/yada_wiki\/659"}],"collection":[{"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/yada_wiki"}],"about":[{"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/types\/yada_wiki"}],"author":[{"embeddable":true,"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/yada_wiki\/659\/revisions"}],"predecessor-version":[{"id":660,"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/yada_wiki\/659\/revisions\/660"}],"wp:attachment":[{"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/media?parent=659"}],"wp:term":[{"taxonomy":"wiki_cats","embeddable":true,"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/wiki_cats?post=659"},{"taxonomy":"wiki_tags","embeddable":true,"href":"https:\/\/effectivetours.com\/docs\/wp-json\/wp\/v2\/wiki_tags?post=659"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}