# Cancel Booking Source: https://docs.axisdata.net/api-reference/endpoint/bookingmgmt/cancel POST /bookcancel OTA_CancelRQ Playground Use this message to cancel or partially cancel an existing booking. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../bookingmgmt/bookCancelRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Modify Booking Source: https://docs.axisdata.net/api-reference/endpoint/bookingmgmt/modify POST /bookmodify OTA_HotelResModifyRQ Playground Use this message to modify an existing hotel booking. Use ReadRQ first. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../bookingmgmt/bookModifyRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Read Booking Source: https://docs.axisdata.net/api-reference/endpoint/bookingmgmt/read POST /bookread OTA_ReadRQPlayground Use this message to retrieve information of an existing booking. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../bookingmgmt/bookReadRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Activity Availability Source: https://docs.axisdata.net/api-reference/endpoint/excursion/availability POST /activityavailability OTA_TourActivityAvailRQ Playground Use this message to retrieve available activities and its products, rates for detailed pax and location information. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../excursion/availXARQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Activity Book Source: https://docs.axisdata.net/api-reference/endpoint/excursion/book POST /activitybook OTA_TourActivityBookRQ Playground Use this message to book an available activity. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../excursion/bookXARQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Activity NBC Source: https://docs.axisdata.net/api-reference/endpoint/excursion/nbc POST /activitynbc OTA_ProductDescriptiveInfoRQ Playground Use this message to retrieve NBC data for a specific tour activity. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../excursion/mappingXARQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Activity Search Source: https://docs.axisdata.net/api-reference/endpoint/excursion/search POST /activitysearch OTA_TourActivitySearchRQ Playground Use this message to retrieve available activities in an area and some of its NBC data. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../excursion/searchXARQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Hotel Availability Source: https://docs.axisdata.net/api-reference/endpoint/hotel/availability POST /hotelavailability Use this request to retrieve available units given pax number, dates and location. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../hotel/searchRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Hotel Booking Source: https://docs.axisdata.net/api-reference/endpoint/hotel/book POST /hotelbook OTA_HotelResRQ Playground Use this request to book an available unit for the desired number of pax, dates, service. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../hotel/bookRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Hotel NBC Source: https://docs.axisdata.net/api-reference/endpoint/hotel/nbc POST /hotelnbc OTA_HotelDescriptiveInfoRQ Playground Use this message to retrieve all necessary NBC or Portfolio information as specified in the request. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../hotel/mappingRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Transfer Availability Source: https://docs.axisdata.net/api-reference/endpoint/transfer/availability POST /transferavailability OTA_GroundAvailRQ Playground Use this message to request available transfer services for the specified airport, location, dates and pax. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../transfer/searchTRRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Transfer Book Source: https://docs.axisdata.net/api-reference/endpoint/transfer/book POST /transferbook OTA_GroundResRQ Playground Use this message to book an available transfer service. > [!TIP] > > Find all the necessary information regarding the request message [here](../../../transfer/bookTRRQ) *** > [!WARNING] > > The endpoint (url) shown in the code snippet is for Sandbox only. If you need to throw the requests from Postman or other tools, please use [https://sintesb.axisdata.net/apu-test/ota](https://sintesb.axisdata.net/apu-test/ota) after whitelisting your IPs. More info at [Access to our Systems](../../../authentication/access) # Access to our Systems Source: https://docs.axisdata.net/authentication/access This site shows how the acess from an external system to our test and production APIs has to be defined. ## TEST Environment Please contact our Integration Team of Axis Data who will provide you with the Test credentials.\ Once you have them put them in the POS Section of the Request: ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "Type": "22", "ID": "TEST", "ID_Context": "AxisData" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` > [!WARNING] > > Only HTTPS connections are supported. > [!WARNING] > > Use recognizable client references and pax names for filtering test bookings, since the access is not unique. **Test URL:** `https://sintesb.axisdata.net/apu-test/ota` ## PRODUCTION Environment Once you have been successfully tested and certified in our INTEGRATION environment, our integration team coordinates the go-live. \ Integration analysts will be in charge of creating and sharing your credentials for PRODUCTION. You’ll receive a unique `` ID. > [!CAUTION] > > **Important:** Never share credentials unless requested by an integration analyst. Use encrypted email for passwords. * **Production URL:** `https://sxml.axisdata.net/apu/ota` Furthermore the access to our production systems is protected by a firewall. \ Our partners must provide their external IPs to be whitelisted on our side. Once this step is done you're ready to go live. Test the connectivity to the server by using this command: `curl https://sxml.axisdata.net` Or using the [OTA\_PingRQ](#checking-connectivity) described below. ### **Partner Identification** Messages are being authenticated and authorized by using the POS tag of the Request. **Example**: ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "Type": "22", "ID": "TEST", "ID_Context": "AxisData" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` **RequestorID Types:** The RequestorID represents your entity and will be given to you by AxisData when you are going to Production. * `22` – Identifier of your organization * `29` – Booking Agent (Brand/Sales Channel). If you have multiple brands within your organization we can identify them by using the Brand/Sales channel parameter * `88` – Authentication (User & Password) > [!TIP] > > You may repeat `` with different `RequestorID` types for additional identifiers. **Extended Example**: ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "Type": "22", "ID": "TEST", "ID_Context": "AxisData" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] }, { "RequestorID": [ { "Type": "29", "ID": "BRAND", "ID_Context": "AxisData" } ] } ] } } ``` * `ID`: Identifier * `ID_Context`: Always “AxisData” * `Instance`: Defines message format details The main ID determines market, portfolio, and currency settings. *** ## **Checking Connectivity** Use `OTA_PingRQ` to verify connectivity. ### Ping Request ```xml theme={null} Connectivity test ``` ```json theme={null} { "OTA_PingRQ" : { "EchoData" : "Connectivity test", "EchoToken" : "12345", "TimeStamp" : 1297249200000, "Target" : "Test", "Version" : 1.003, "PrimaryLangID" : "EN" } } ``` **Response**: ```xml theme={null} Connectivity test ``` ```json theme={null} { "OTA_PingRS": { "Success": {}, "EchoData": "Connectivity test", "EchoToken": "12345", "TimeStamp": 1297249200000, "Target": "Test", "Version": 1.003, "PrimaryLangID": "EN" } } ``` Use this to verify connectivity from new systems or endpoints. # OTA_CancelRQ Source: https://docs.axisdata.net/bookingmgmt/bookCancelRQ > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_CancelRQ API call](/api-reference/endpoint/bookingmgmt/cancel) > > Skip & Hit the Playground. ## Purpose * Cancel a confirmed reservation (`CancelType="Commit"`). * Request a penalty quote without cancelling (`CancelType="Quote"`). * Target the booking by either the client reference or Axis Data internal reference (`UniqueID/@ID` with `ID_Context="Client"` or `ID_Context="Internal"`). ## Structure - Root Element ```xml RootElement theme={null} ``` ```json RootElement theme={null} "OTA_CancelRQ" ``` **Key Attributes:** * `Version`: e.g., "2008.1". * `CancelType`: "Commit" | "Quote" (required). * `xmlns`: "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)". ## Structure - Core Elements ### POS (Point of Sale) Identifies the requesting party and contains credentials. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "Type": "22", "ID": "TEST", "ID_Context": "AxisData" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` ### UniqueID Required. Specifies the booking or component to be cancelled or quoted. * `ID` (required): booking reference number (client or Axis Data internal). * `ID_Context`: "Client" or "Internal". * `Type`: "36". ```xml theme={null} ``` ```json theme={null} { "UniqueID": [ { "Type": "36", "ID": "TEST_AXIS", "ID_Context": "Client" } ] } ``` #### Partial Cancellation Add the component, not the whole booking. * `ID` (required): booking reference number (client or Axis Data internal). * `ID_Context`: "Client" or "Internal". * `Type`: "37". ```xml theme={null} ``` ```json theme={null} { "UniqueID": [ { "Type": "37", "ID": "TEST_AXIS_ac1", "ID_Context": "Client" } ] } ``` ## Behavior & Rules * `CancelType="Commit"` performs the cancellation if allowed. * `CancelType="Quote"` returns penalty information; no cancellation performed. * **Partial cancellation**: If you include a child item reference, only indicated item will be cancelled. If this removes the last valid item, the entire booking will be cancelled. * **Response heads-up**: `OTA_CancelRS` will return `Status="Committed"` after a successful cancel, or `Status="Pending"` for quotes, and may include `CancelRule@CancelByDate` indicating the timestamp the cancel was registered. * When a booking is already active, the API will not allow cancellations. ## Complete Examples > [tab] Cancel Booking > > ```xml expandable theme={null} > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_CancelRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "UniqueID" : [ { > "Type" : "36", > "ID" : "TEST_AXIS", > "ID_Context" : "Client" > } ], > "CancelType" : "Quote", > "Version" : 2008.1 > } > } > > ``` > [tab] Partial Cancel > > ```xml expandable theme={null} > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_CancelRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "UniqueID" : [ { > "Type" : "36", > "ID" : "TEST_AXIS", > "ID_Context" : "Client" > }, { > "Type" : "37", > "ID" : "TEST_AXIS_ac1", > "ID_Context" : "Client" > } ], > "CancelType" : "Quote", > "Version" : 2008.1 > } > } > ``` ## Best Practices 1. Use the correct booking reference and matching `ID_Context` to avoid cancelling the wrong booking. 2. Prefer `CancelType="Quote"` before `Commit` to surface penalties and cutoffs to the user. 3. Keep credentials in `POS/Source/RequestorID` aligned with your test/production environment. ## Playground > [card] [OTA\_CancelRQ API call](/api-reference/endpoint/bookingmgmt/cancel) > > Try our API playground in real time. > [!TIP] > > Use the examples to hit the test environment; # OTA_CancelRS Source: https://docs.axisdata.net/bookingmgmt/bookCancelRS The `OTA_CancelRS` (Cancel Response) confirms a booking cancellation or returns a penalty quote depending on the originating `OTA_CancelRQ` `CancelType`. It follows OpenTravel Alliance (OTA) message patterns and retains original namespaces/prefixes. ## Purpose This message is returned by Axis Data after an `OTA_CancelRQ`: * `Status="Committed"` → cancellation has been executed and confirmed. * `Status="Pending"` → quote mode; cancellation penalties/rules are provided but the booking is **not** cancelled yet. ## Structure – Root Element ```xml RootElement theme={null} ``` ```json RootElement theme={null} "OTA_CancelRS" ``` **Key Attributes:** * `xmlns`: `"http://www.opentravel.org/OTA/2003/05"`. * `Version`: OTA version string (e.g., `"2008.1"`). * `TimeStamp` (optional): ISO-8601 date-time when the response was generated. * `Status`: `Committed` (finalized cancellation) or `Pending` (quote only). ## Structure – Core Elements ### Booking References Both the Axis Data internal booking reference and the client booking reference are returned. ```xml theme={null} ``` ```json theme={null} { "UniqueID": [ { "Type": "36", "ID": "12345", "ID_Context": "Internal" }, { "Type": "36", "ID": "test-001", "ID_Context": "Client", "CompanyName": { "Code": "TEST" } } ] } ``` ### Cancellation Rules When the cancellation is committed, the response includes the exact cancellation timestamp. ```xml theme={null} ``` ```json theme={null} { "CancelRules": { "CancelRule": [ { "CancelByDate": "2024-01-01T11:22:02" } ] } } ``` For quotes (pending), cancellation rules may be returned describing applicable windows and penalties without performing the cancellation. ## Complete Examples > [tab] Committed (final) > > ```xml theme={null} > > > > > > > > > > > ``` > > ```json theme={null} > { > "OTA_CancelRS": { > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2008.1", > "TimeStamp": "2025-10-15T14:20:00Z", > "Status": "Committed", > "Success": "", > "UniqueID": [ > { > "Type": "36", > "ID": "12345", > "ID_Context": "Internal" > }, > { > "Type": "36", > "ID": "test-001", > "ID_Context": "Client", > "CompanyName": { > "Code": "TEST" > } > } > ], > "CancelRules": { > "CancelRule": [ > { > "CancelByDate": "2024-01-01T11:22:02" > } > ] > } > } > } > ``` > [tab] Quote (pending) > > ```xml theme={null} > > > > > > > > > > > > > ``` > > ```json theme={null} > { > "OTA_CancelRS": { > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2008.1", > "TimeStamp": "2025-10-15T14:20:00Z", > "Status": "Pending", > "Success": "", > "UniqueID": [ > { > "Type": "36", > "ID": "12345", > "ID_Context": "Internal" > }, > { > "Type": "36", > "ID": "test-001", > "ID_Context": "Client", > "CompanyName": { > "Code": "TEST" > } > } > ], > "CancelRules": { > "CancelRule": [ > { > "FromDate": "2025-10-20T00:00:00", > "ToDate": "2025-10-21T23:59:59" > }, > { > "FromDate": "2025-10-22T00:00:00", > "ToDate": "2025-10-23T23:59:59" > } > ] > } > } > } > ``` ## Common Use Cases * **Full cancellation confirmation**: Returned after `CancelRQ` with `CancelType="Commit"` → `Status="Committed"`. * **Penalty quote**: Returned after `CancelRQ` with `CancelType="Quote"` → `Status="Pending"` plus cancellation windows/rules. ## Best Practices 1. Include `EchoToken` in requests to correlate `RQ/RS` pairs during cancellation workflows. 2. Provide `PrimaryLangID` in the request if you require localized descriptions in any returned text fields. 3. Preserve and store both internal and client `UniqueID` values in your system when processing responses. 4. Treat `Pending` responses as **advisory** only; send a subsequent `CancelRQ` with `CancelType="Commit"` to finalize. # OTA_HotelResModifyRQ Source: https://docs.axisdata.net/bookingmgmt/bookModifyRQ The OTA\_HotelResModifyRQ (Hotel Reservation **Modify** Request) is used to request changes to an existing booking. It supports lightweight updates (minor changes) as well as recalculation-triggering updates (major changes). > [!WARNING] > > This feature is only supported for hotel bookings. > [!TIP] > > Already know OTA messages? Jump straight into Testing. > [card] [OTA\_HotelResModify API call](/api-reference/endpoint/bookingmgmt/modify) > > Skip & Hit the Playground. ## Purpose This message is used to: * Apply **minor changes** without recalculating prices. * Initiate **major changes** that **recalculate** the booking and may change price and cancellation terms. * Carry partner and child references that tie the modification to the original booking. * Occupancy changes are not allowed via OTA Modify. ## Supported Changes ### Minor Changes * Name change of a **non lead** pax (Change name, surname or prefix). * Change minor details of any pax (email, telphone number, address, fax). * Comments / Booking notes can be added. Existing ones can not be deleted nor modified. ### Major Changes * Room can be changed if the conditions allow it. * Board change. * Dates change. > [!WARNING] > > All the Major Changes are subject to availability, conditions, and will trigger a recalculation based on the current status of the contract. ## Non-Supported Changes Changes that are not allowed via HotelResModify. Cancel and rebook: * Occupancy changes: add or remove passengers. * Birthdate changes: change the birthdate of a pax, possibly changing its age group. * Lead Pax name. * Accomodation change. Viable with other methods: * Adding a room: Should be done using [Master and Child References](../general/messaging#master-and-child-references). * Cancel a room: [Partial Cancelation](./bookCancelRQ) should be used. ## Structure – Root Element ```xml RootElement theme={null} ``` ```json RootElement theme={null} "OTA_HotelResModifyRQ" ``` **Key Attributes:** * `ResStatus`: `Quote` (preview) or `Commit` (apply changes). * `Version`: OTA message version (e.g., "2008.1"). * `PrimaryLangID`: ISO 639 language code (optional). * `xmlns`: "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)". ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and includes credentials. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID_Context": "AxisData", "Type": "22", "ID": "TEST" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` ### HotelResModify Container for one modification transaction and its content. Very similar to the OTA\_HotelResModifyRQ. #### RoomStay Defines the room(s) being modified and links them to guests and services. ```xml theme={null} ``` ```json theme={null} { "RoomStays": { "RoomStay": { "RPH": "1", "RoomTypes": { "RoomType": [ { "RoomTypeCode": "RM00CRMV00;0P000" } ] }, "TimeSpan": { "End": "2026-07-24", "Start": "2026-07-17" }, "BasicPropertyInfo": { "HotelCode": "AESPMI5L46" }, "ResGuestRPHs": { "ResGuestRPH": [ { "RPH": "1" }, { "RPH": "2" }, { "RPH": "3" } ] }, "ServiceRPHs": { "ServiceRPH": [ { "RPH": "1" } ] } } } } ``` #### Service Non-room services linked to a room or guests (e.g., meal plan code at booking level). ```xml theme={null} ``` ```json theme={null} { "Services": { "Service": [ { "ServiceInventoryCode": "BB", "ServiceRPH": "1" } ] } } ``` #### ResGuest Passenger details linked by `ResGuestRPH`. ```xml expandable theme={null} Mr Bender Bending Dr John Zoidberg Jr Ben Bending ``` ```json expandable theme={null} { "ResGuests": { "ResGuest": [ { "AgeQualifyingCode": "10", "ResGuestRPH": "1", "Profiles": { "ProfileInfo": [ { "Profile": { "Customer": { "BirthDate": "1996-09-04", "PersonName": { "NamePrefix": "Mr", "GivenName": "Bender", "Surname": "Bending" } } } } ] }, "GuestCounts": { "GuestCount": [ { "Count": "1", "Age": "27" } ] } }, { "AgeQualifyingCode": "10", "ResGuestRPH": "2", "Profiles": { "ProfileInfo": [ { "Profile": { "Customer": { "BirthDate": "1996-09-05", "PersonName": [ { "NamePrefix": [ "Dr" ], "GivenName": [ "John" ], "Surname": "Zoidberg" } ] } } } ] }, "GuestCounts": { "GuestCount": [ { "Count": "1", "Age": "27" } ] } }, { "AgeQualifyingCode": "8", "ResGuestRPH": "3", "Profiles": { "ProfileInfo": [ { "Profile": { "Customer": { "BirthDate": "2018-09-06", "PersonName": [ { "NamePrefix": [ "Jr" ], "GivenName": [ "Ben" ], "Surname": "Bending" } ] } } } ] }, "GuestCounts": { "GuestCount": [ { "Count": "1", "Age": "6" } ] } } ] } } ``` #### ResGlobalInfo Booking-level info such as comments and references. ```xml theme={null} late arrival - flight lands at 22:55 local time Silent top floor non-smoking room please ``` ```json theme={null} { "ResGlobalInfo": { "Comments": { "Comment": [ { "Name": "Applicant Notice", "Text": "late arrival - flight lands at 22:55 local time" }, { "Name": "Applicant Notice", "Text": "Silent top floor non-smoking room please" } ] }, "HotelReservationIDs": { "HotelReservationID": [ { "ResID_SourceContext": "Client", "ResID_Type": "36", "ResID_Value": "TEST_AXIS" }, { "Item_RPH": "1", "ResID_SourceContext": "Client", "ResID_Type": "37", "ResID_Value": "TEST_AXIS_ac1" } ] } } } ``` ## Process & Rules * **Always start with an OTA\_ReadRQ** to fetch the current state before modifying. * Validate that immutable identifiers **match the original booking**: distributor reference, lead pax first/last name, ClientID, and HotelCode. * Use `ResStatus="Quote"` first to preview recalculation and upgrade offers; send `ResStatus="Commit"` to apply. * If the connected supplier **does not support modifications**, expect an error (e.g., *modification not possible*) and perform cancel + rebook under the same distributor reference with a new child reference. * **Minor changes** (e.g., comments, non-lead pax name, contact details) do **not** trigger recalculation. * **Major changes** (e.g., room/board change, dates, optional extras) **do** trigger recalculation; pricing and cancel penalties may change. ## Complete Example ```xml Modify expandable highlight={57-59, 93-95} theme={null} Mr Bender Bending Dr John Zoidberg Jr Ben Bending late arrival - flight lands at 22:55 local time Silent top floor non-smoking room please ``` ```json Modify expandable highlight={120-128, 191-192} theme={null} { "OTA_HotelResModifyRQ": { "POS": { "Source": [ { "RequestorID": [ { "ID_Context": "AxisData", "Type": "22", "ID": "TEST" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] }, "HotelResModifies": { "HotelResModify": [ { "RoomStays": { "RoomStay": [ { "RoomTypes": { "RoomType": [ { "RoomTypeCode": "RM00CRMV00;0P000" } ] }, "TimeSpan": { "End": "2026-07-24", "Start": "2026-07-17" }, "BasicPropertyInfo": { "HotelCode": "AESPMI5L46" }, "ResGuestRPHs": { "ResGuestRPH": [ { "RPH": "1" }, { "RPH": "2" }, { "RPH": "3" } ] }, "ServiceRPHs": { "ServiceRPH": [ { "RPH": "1" } ] }, "RPH": "1" } ] }, "Services": { "Service": [ { "ServiceInventoryCode": "BB", "ServiceRPH": "1" } ] }, "ResGuests": { "ResGuest": [ { "Profiles": { "ProfileInfo": { "Profile": [ { "Customer": { "PersonName": [ { "NamePrefix": [ "Mr" ], "GivenName": [ "Bender" ], "Surname": "Bending" } ], "BirthDate": "1996-09-04" } } ] } }, "GuestCounts": { "GuestCount": [ { "Count": "1", "Age": "27" } ] }, "AgeQualifyingCode": "10", "ResGuestRPH": "1" }, { "Profiles": { "ProfileInfo": { "Profile": [ { "Customer": { "PersonName": [ { "NamePrefix": [ "Dr" ], "GivenName": [ "John" ], "Surname": "Zoidberg" } ], "BirthDate": "1996-09-05" } } ] } }, "GuestCounts": { "GuestCount": [ { "Count": "1", "Age": "27" } ] }, "AgeQualifyingCode": "10", "ResGuestRPH": "2" }, { "Profiles": { "ProfileInfo": { "Profile": [ { "Customer": { "PersonName": [ { "NamePrefix": [ "Jr" ], "GivenName": [ "Ben" ], "Surname": "Bending" } ], "BirthDate": "2018-09-06" } } ] } }, "GuestCounts": { "GuestCount": [ { "Count": "1", "Age": "6" } ] }, "AgeQualifyingCode": "8", "ResGuestRPH": "3" } ] }, "ResGlobalInfo": { "Comments": { "Comment": [ { "Text": "late arrival - flight lands at 22:55 local time", "Name": "Applicant Notice" }, { "Text": "Silent top floor non-smoking room please", "Name": "Applicant Notice" } ] }, "HotelReservationIDs": { "HotelReservationID": [ { "ResID_SourceContext": "Client", "ResID_Type": "36", "ResID_Value": "TEST_AXIS" }, { "Item_RPH": "1", "ResID_SourceContext": "Client", "ResID_Type": "37", "ResID_Value": "TEST_AXIS_ac1" } ] } } } ] }, "xmlns": "http://www.opentravel.org/OTA/2003/05", "ResStatus": "Quote", "Version": "2008.1", "PrimaryLangID": "EN" } } ``` ## Best Practices 1. Send `Quote` first; only `Commit` after user confirmation. 2. Keep **references stable**: do not change distributor/child references when not required. 3. Maintain **consistent guest ordering** and RPH linking between `RoomStay`, `Services`, and `ResGuests`. 4. Limit comments to operationally relevant notes; use `Name="Applicant Notice"` when adding comments. ## Playground > [card] [OTA\_HotelResModify API call](/api-reference/endpoint/bookingmgmt/modify) > > Skip & Hit the Playground. > [!TIP] > > Use the examples to hit the TEST environment; # OTA_HotelResModifyRS Source: https://docs.axisdata.net/bookingmgmt/bookModifyRS The `OTA_HotelResModifyRS` is the response to a modification request for an existing hotel reservation. It confirms whether the requested change was accepted (minor vs. major), returns updated monetary totals when recalculation occurs, and may offer optional extras or upgrade options. ## Purpose This message is used to: * Acknowledge **minor changes** (e.g., comments, non–lead-pax name, contact details) without price recalculation. * Return updated totals for **major changes** (e.g., room/board change) when recalculation is required. * Provide **status** of the modification (`` or ``), and optionally expose **Extras** and **Upgrades** in `TPA_Extensions`. ## Structure – Root Element ```xml RootElement theme={null} ``` ```json RootElement theme={null} "OTA_HotelResModifyRS" ``` **Key Attributes** * `Version`: OTA message version (e.g., `2017.2`). * `EchoToken`: Echoes the request token for pairing. * `TimeStamp`: Response generation time (ISO 8601 UTC). * `xmlns`: `http://www.opentravel.org/OTA/2003/05`. ## Structure – Core Elements ### Errors Returned when the modification is rejected. Example rejection: * `Booking not changed - data received differs from stored data`. ### HotelResModify Container for the modified booking state. ```xml theme={null} ``` ```json theme={null} { "HotelResModify": { "CreateDateTime": "2025-10-15T14:21:20", "LastUpdateDateTime": "2025-10-15T14:22:59" } } ``` The attributes are ISO 8601 timestamps for creation and the last update of the reservation record. #### Further Components The rest of the response follows the same structure as a [OTA\_HotelResRS](../hotel/bookRS) ## Complete Example ```xml Modify expandable theme={null} Double Standard Room (Non-Refundable) BB Breakfast late arrival - flight lands at 22:55 local time late arrival - flight lands at 22:55 local time late arrival - flight lands at 22:55 local time Silent top floor non-smoking room please Tax Payable Locally, Currency: EUR, type: city tax Due to the local logistics infrastructure, there is a possibility that your meeting point for arrival and departure transfer may not be direct at the hotel door, Approx. Distance: > 600 m Restaurant for Breakfast, Comment: Breakfast is served in the Sky Bar ``` ```json Modify expandable theme={null} { "OTA_HotelResModifyRS": { "Success": "", "HotelResModifies": { "HotelResModify": [ { "RoomStays": { "RoomStay": [ { "RoomTypes": { "RoomType": [ { "RoomDescription": { "Text": { "Language": "EN", "text": "Double Standard Room (Non-Refundable)" } }, "RoomTypeCode": "RM00CRMV00;0P000" } ] }, "RatePlans": { "RatePlan": [ { "RatePlanID": "0P000" } ] }, "RoomRates": { "RoomRate": [ { "Features": { "Feature": [ { "Description": { "Text": [ "BB", { "Language": "EN", "text": "Breakfast" } ] } } ] }, "RoomTypeCode": "RM00CRMV00;0P000" } ] }, "BasicPropertyInfo": { "HotelCode": "AESPMI5L46", "HotelName": "Hostal Cuba" }, "Total": { "CurrencyCode": "EUR", "AmountAfterTax": "1811.33", "RateOverrideIndicator": "true" }, "RPH": "1", "IndexNumber": "3" } ] }, "ResGlobalInfo": { "Total": { "CurrencyCode": "EUR", "AmountAfterTax": "1811.33", "RateOverrideIndicator": "true" }, "Comments": { "Comment": [ { "Text": "late arrival - flight lands at 22:55 local time", "Name": "GENERAL", "CommentOriginatorCode": "DISTRIBUTOR" }, { "Text": "late arrival - flight lands at 22:55 local time", "Name": "GENERAL", "CommentOriginatorCode": "DISTRIBUTOR" }, { "Text": "late arrival - flight lands at 22:55 local time", "Name": "Applicant Notice", "CommentOriginatorCode": "DISTRIBUTOR" }, { "Text": "Silent top floor non-smoking room please", "Name": "Applicant Notice", "CommentOriginatorCode": "DISTRIBUTOR" } ] }, "HotelReservationIDs": { "HotelReservationID": [ { "ResID_Type": "36", "ResID_SourceContext": "Client", "ResID_Value": "TEST_AXIS" }, { "ResID_Value": "68486556", "ResID_Type": "36", "ResID_SourceContext": "Internal" }, { "Item_RPH": "1", "ResID_Value": "TEST_AXIS_ac1", "ResID_Type": "37", "ResID_SourceContext": "Client" }, { "Item_RPH": "1", "ResID_Value": "3", "ResID_Type": "37", "ResID_SourceContext": "Internal" } ] }, "CancelPenalties": { "CancelPenalty": [ { "Deadline": { "OffsetUnitMultiplier": "0", "OffsetTimeUnit": "Hour", "OffsetDropTime": "AfterBooking", "AbsoluteDeadline": "2025-10-15T16:21:21" }, "AmountPercent": { "Amount": "1811.33", "CurrencyCode": "EUR", "BasisType": "FullStay", "Percent": "100" }, "Item_RPH": "1" }, { "Deadline": { "OffsetUnitMultiplier": "0", "OffsetTimeUnit": "Hour", "OffsetDropTime": "AfterBooking", "AbsoluteDeadline": "2025-10-15T16:23:01" }, "AmountPercent": { "Amount": "1811.33", "CurrencyCode": "EUR", "BasisType": "FullStay", "Percent": "100" }, "Item_RPH": "2" }, { "Deadline": { "OffsetUnitMultiplier": "0", "OffsetTimeUnit": "Hour", "OffsetDropTime": "AfterBooking", "AbsoluteDeadline": "2025-10-15T17:23:57" }, "AmountPercent": { "Amount": "1811.33", "CurrencyCode": "EUR", "BasisType": "FullStay", "Percent": "100" }, "Item_RPH": "1" } ] }, "BasicPropertyInfo": { "VendorMessages": { "VendorMessage": [ { "SubSection": { "Paragraph": { "Text": "Tax Payable Locally, Currency: EUR, type: city tax" } }, "Title": "IncidentsAndErrata", "InfoType": "5" }, { "SubSection": { "Paragraph": { "Text": "Due to the local logistics infrastructure, there is a possibility that your meeting point for arrival and departure transfer may not be direct at the hotel door, Approx. Distance: > 600 m" } }, "Title": "IncidentsAndErrata", "InfoType": "5" }, { "SubSection": { "Paragraph": { "Text": "Restaurant for Breakfast, Comment: Breakfast is served in the Sky Bar" } }, "Title": "IncidentsAndErrata", "InfoType": "5" } ] }, "HotelCodeContext": "354402", "AreaID": "927", "HotelName": "Hostal Cuba", "HotelCode": "AESPMI5L46" } }, "TPA_Extensions": { "BookingStatus": { "xmlns:ns1": "http://www.opentravel.org/OTA/2003/05/tpa", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "xsi:type": "ns1:BookingStatusType", "ReservationStatusType": "Available", "prefix": "ns1" }, "Extras": "", "Upgrades": "" }, "CreateDateTime": "2025-10-15T14:21:20", "LastUpdateDateTime": "2025-10-15T14:22:59" } ] }, "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2008.1" } } ``` ## Best Practices * If a connected PMS/Channel Manager **does not support modifications**, the system returns an error; execute cancel & rebook under the same Distributor reference with a new Child reference. * **Hotel changes** (switching to a different property) require cancel & rebook. * **Adding rooms**: send a new `OTA_HotelResRQ` with the same Distributor reference and a new Child reference; no modify needed. * On every modify cycle: `ReadRQ` → `ModifyRQ (Quote)` → review response → `ModifyRQ (Commit)`. * Use `RateOverrideIndicator` to detect whether recalculation occurred at room and booking levels. # OTA_ReadRQ Source: https://docs.axisdata.net/bookingmgmt/bookReadRQ The OTA\_ReadRQ (Booking Search & Retrieve Request) allows partners to **search** bookings and **retrieve booking details** from Axis Data using the standard OpenTravel schema. > [!TIP] > > Recommended flow: perform a **search** to get booking references, then **retrieve details** per reference. Use `ReturnListIndicator` to switch modes. > [card] [OTA\_ReadRQ API call](/api-reference/endpoint/bookingmgmt/read) > > Skip & Hit the Playground. ## Purpose This message is used to: * Search bookings that match selection criteria (e.g., date windows, hotel filters, status). * Retrieve lists of booking references (up to service limits) for synchronization. * Retrieve the full booking details for a specific reference (hotel, excursions, etc.). * Request optional enrichment in the response via `Instance` flags. ## Structure – Root Element ```xml Root Element theme={null} ``` ```json Root Element theme={null} "OTA_ReadRQ" ``` **Key Attributes:** * `xmlns`: `"http://www.opentravel.org/OTA/2003/05"`. * `Version`: Specification version (e.g., `"2008.1"`). * `ReturnListIndicator`: `true` → **Search/List** mode · `false` → **Retrieve Details** mode. * `PrimaryLangID`: Desired language for textual descriptions in the **details** response (fallback to English if unavailable). ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and carries credentials and optional enrichment selector (`Instance`). ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": { "_ID_Context": "AxisData", "_ID": "TEST", "_Type": "22", "_Instance": "MF123" } }, { "RequestorID": { "_Type": "88", "_ID": "TEST", "_MessagePassword": "testpass" } } ] } } ``` **Attributes (Common):** * `ID_Context`, `ID`, `Type`: Authentication identifiers. * `MessagePassword`: Password for the Type `88` credential. * `Instance` (on the Type `22` credential): Optional flags to **enrich** the response. Combine digits as needed, e.g., `MF1`, `MF12`, `MF123`. **Instance Flags:** | Digit | Adds to response | | :- | :- | | `1` | Item status (include cancelled items) | | `2` | Cancellation policies (confirmed) / cancellation cost (cancelled) | | `3` | Per-pax rate breakdown (active bookings) | > The enrichment is applied to **OTA\_ResRetrieveRS**; the request only signals which enrichments to include. *** ### ReadRequests / HotelReadRequest (Search Mode) Container for one or more hotel search filters. ```xml theme={null} ``` ```json theme={null} { "ReadRequests": { "HotelReadRequest": { "_HotelCode": "AESPMI5L46", "SelectionCriteria": { "_Start": "2027-07-17", "_End": "2027-07-24", "_DateType": "ArrivalDate", "_ResStatus": "Reserved" }, "TPA_Extensions": { "Criterion": { "RefPoint": [ { "_CodeContext": "Country", "_Name": "Spain" }, { "_CodeContext": "Region", "_Name": "Mallorca" }, { "_CodeContext": "Resort", "_Name": "Palma City" } ] } } } } } ``` #### SelectionCriteria * `Start`, `End`: Date (YYYY-MM-DD) or datetime (e.g., `YYYY-MM-DDThh:mm`) bounds. * `DateType`: One of `ArrivalDate`, `CreateDate`, `DepartureDate`, `LastUpdateDate`. * `ResStatus` *(optional)*: Booking status filter. **Typical Interpretations:** * `Start="2020-06-21" End="2020-06-21" DateType="LastUpdateDate"` → bookings created/modified on June 21. * `Start="2020-06-21" End="2020-06-28" DateType="LastUpdateDate"` → created/modified between June 21–28. * `Start="2020-06-21" DateType="LastUpdateDate"` → created/modified on/after June 21. * `Start="2020-06-21T17:15" DateType="LastUpdateDate"` → created/modified on/after June 21 at 17:15 CET. * `End="2020-06-21" DateType="LastUpdateDate"` → created/modified **before** June 21 (service limit applies). * `DateType="ArrivalDate"` or `"DepartureDate"` → filter by check-in/out dates. #### Criterion → RefPoint Use `RefPoint` with `CodeContext` to filter by geography: * `Country`, `Airport`, `Region`, `Resort`. Multiple `RefPoint` entries can be combined in one `Criterion`. *** ### UniqueID (Details Mode) Provide a booking reference to retrieve **full** details. Either the client’s reference or the internal Axis Data reference can be used. ```xml theme={null} ``` ```json theme={null} { "UniqueID": { "_Type": "36", "_ID": "TEST_AXIS", "_ID_Context": "Client" } } ``` ## Complete Examples > [tab] Search Bookings > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_ReadRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "ReadRequests" : { > "HotelReadRequest" : [ { > "SelectionCriteria" : [ { > "DateType" : "ArrivalDate", > "ResStatus" : "Reserved", > "Start" : "2027-07-17", > "End" : "2027-07-24" > } ], > "TPA_Extensions" : { > "Criterion" : [ { > "RefPoint" : [ { > "CodeContext" : "Country", > "Name" : "Spain" > }, { > "CodeContext" : "Region", > "Name" : "Mallorca" > }, { > "CodeContext" : "Resort", > "Name" : "Palma City" > } ] > } ] > }, > "HotelCode" : "AESPMI5L46" > } ] > }, > "ReturnListIndicator" : true, > "Version" : 2016.2 > } > } > ``` > [tab] Retrieve details > > ```xml expandable theme={null} > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_ReadRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF123", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "UniqueID" : { > "Type" : "36", > "ID" : "TEST_AXIS", > "ID_Context" : "Client" > }, > "ReturnListIndicator" : false, > "Version" : 2008.1, > "PrimaryLangID" : "EN" > } > } > ``` ## Common Use Cases * **Delta sync**: `ReturnListIndicator="true"` with `DateType="LastUpdateDate"` to get references changed since last poll; then request details per `UniqueID`. * **Direct lookup**: `ReturnListIndicator="false"` with `UniqueID` when you already know the distributor or internal reference. * **Bulk list**: Omit filters to retrieve up to the service’s maximum list (avoid exceeding 1,000 to prevent timeouts). ## Best Practices 1. Always set `ReturnListIndicator` to reflect intent (list vs. details). 2. Include `PrimaryLangID` when you need localized descriptions in the details response. 3. Use ISO `YYYY-MM-DD` (and optional `Thh:mm`) formats for date filters. 4. Keep search windows tight to reduce payload size and processing time. 5. For region filtering, prefer `RefPoint` with clear `CodeContext` values. 6. Respect service limits (max list size \~1,000) and paginate by date windows if needed. ## Playground > [card] [OTA\_ReadRQ API call](/api-reference/endpoint/bookingmgmt/read) > > Try our API playground in real time. > [!TIP] > > Use the examples to hit the TEST environment; # OTA_ResRetrieveRS Source: https://docs.axisdata.net/bookingmgmt/bookReadRS The `OTA_ResRetrieveRS` (Reservation Retrieve Response) returns either a **list of booking references** or **full booking details** in response to an `OTA_ReadRQ`, depending on the request parameters. It can also include optional enrichments such as item statuses, cancellation rules, and per‑passenger rate breakdowns. ## Purpose * **Search bookings (list)** — When the request uses `ReturnListIndicator="true"`, the response returns only identifiers and status for each booking that matches the selection criteria. * **Retrieve booking details** — When the request uses `ReturnListIndicator="false"` and specifies a booking reference in `UniqueID`, the response returns the reservation details (hotel, transfers, excursions) for those bookings. ## Structure – Root Element ```xml Root Element theme={null} ``` ```json Root Element theme={null} "OTA_ResRetrieveRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05" } ``` **Notes** * The message may include `` or `` / `` according to outcome. * Payload content is returned inside `ReservationsList`. ## Structure – Core Elements ### ReservationsList Container for one or more retrieved reservations. #### HotelReservation (Summary List) Returned when searching with `ReturnListIndicator="true"`. * `ResStatus` — Current reservation status (e.g., `Reserved`, `Cancelled`). * Two `UniqueID` elements are expected per item: * Internal booking reference (`ID_Context="Internal"`). * Client booking reference (`ID_Context="Client"`). * Client code can be provided via `CompanyName Code` under the client `UniqueID`. #### HotelReservation (Detailed) Returned when retrieving details with `ReturnListIndicator="false"`. * Follows the **HotelReservationType** structure (same as `OTA_HotelResRS`). * When requested via enrichment flags in `OTA_ReadRQ.Instance`, the response may include: * **Item status** for cancelled items (visible in the reservation content). * **Cancellation policies / cancellation costs** for active or cancelled items. * **Per‑passenger rate breakdown** (codes defined by the distributor; returned in extensions). ## Examples > [tab] Search list (summary) > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_ResRetrieveRS": { > "Success": "", > "ReservationsList": { > "HotelReservation": [ > { > "UniqueID": [ > { > "Type": "36", > "ID": "12345", > "ID_Context": "Internal" > }, > { > "CompanyName": { > "Code": "TEST" > }, > "Type": "36", > "ID": "TEST-001", > "ID_Context": "Client" > } > ], > "ResStatus": "Reserved" > }, > { > "UniqueID": [ > { > "Type": "36", > "ID": "12347", > "ID_Context": "Internal" > }, > { > "CompanyName": { > "Code": "TEST" > }, > "Type": "36", > "ID": "TEST-003", > "ID_Context": "Client" > } > ], > "ResStatus": "Cancelled" > } > ] > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2008.1", > "EchoToken": "1" > } > } > ``` > [tab] Retrieve details (hotel) > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > Double Standard Room (Non-Refundable) > > > > > > > > > > > > BB > Breakfast > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Double Standard Room (Non-Refundable) > > > > > > > > > > > > BB > Breakfast > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Mr > Bender > Bending > > > > > > > > > > > > > > > > Mrs > Angelina > Bending > > > > > > > > > > > > > > > > Jr > Ben > Bending > > > > > > > > > > > > > > > late arrival - flight lands at 22:55 local time > > > late arrival - flight lands at 22:55 local time > > > > > > > > > > > > > > > > > > > > > > > > > > Tax Payable Locally, Currency: EUR, type: city tax > > > > > > > Due to the local logistics infrastructure, there is a possibility that your meeting point for arrival and departure transfer may not be direct at the hotel door, Approx. Distance: > 600 m > > > > > > > Restaurant for Breakfast, Comment: Breakfast is served in the Sky Bar > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_ResRetrieveRS": { > "Success": "", > "ReservationsList": { > "HotelReservation": { > "POS": { > "Source": { > "RequestorID": [ > { > "CompanyName": { > "CompanyShortName": "TEST", > "Code": "TEST" > }, > "Type": "22", > "ID_Context": "OTS", > "ID": "TEST" > } > ] > } > }, > "UniqueID": [ > { > "ID": "68486556", > "ID_Context": "Internal", > "Type": "14" > }, > { > "ID": "TEST_AXIS", > "ID_Context": "Client", > "Type": "14" > } > ], > "RoomStays": { > "RoomStay": [ > { > "RoomTypes": { > "RoomType": [ > { > "RoomDescription": { > "Text": { > "Language": "EN", > "value": "Double Standard Room (Non-Refundable)" > } > }, > "RoomTypeCode": "RM00CRMV00;0P000" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "0P000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Features": { > "Feature": [ > { > "Description": { > "Text": [ > "BB", > { > "Language": "EN", > "value": "Breakfast" > } > ] > } > } > ] > }, > "RoomTypeCode": "RM00CRMV00;0P000" > } > ] > }, > "BasicPropertyInfo": { > "HotelCode": "AESPMI5L46", > "HotelName": "Hostal Cuba" > }, > "TPA_Extensions": { > "POS": { > "Source": [ > { > "RequestorID": [ > { > "CompanyName": { > "CompanyShortName": "OTS Open Travel Services AG", > "Code": "ICCHOTS" > }, > "Type": "4", > "ID_Context": "OTS", > "ID": "ICCHOTS" > } > ] > }, > { > "RequestorID": [ > { > "Type": "39", > "ID_Context": "OTS", > "ID": "AESPMI5L46Y26OWN2" > } > ] > }, > { > "RequestorID": [ > { > "Type": "2", > "ID_Context": "OTS", > "ID": "OTSHQ" > } > ] > }, > { > "RequestorID": [ > { > "Type": "45", > "ID_Context": "OTS", > "ID": "OWN2" > } > ] > } > ] > } > }, > "Reference": { > "ID": "4503599660031695", > "Type": "14" > }, > "TimeSpan": { > "End": "2026-07-24", > "Start": "2026-07-17" > }, > "ResGuestRPHs": { > "ResGuestRPH": [ > { > "RPH": "1" > }, > { > "RPH": "2" > }, > { > "RPH": "3" > } > ] > }, > "ServiceRPHs": { > "ServiceRPH": [ > { > "RPH": "1" > } > ] > }, > "Total": { > "CurrencyCode": "EUR", > "AmountAfterTax": "1811.33" > }, > "IndexNumber": "1", > "RoomStayStatus": "Book" > }, > { > "RoomTypes": { > "RoomType": [ > { > "RoomDescription": { > "Text": { > "Language": "EN", > "value": "Double Standard Room (Non-Refundable)" > } > }, > "RoomTypeCode": "RM00CRMV00;0P000" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "0P000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Features": { > "Feature": [ > { > "Description": { > "Text": [ > "BB", > { > "Language": "EN", > "text": "Breakfast" > } > ] > } > } > ] > }, > "RoomTypeCode": "RM00CRMV00;0P000" > } > ] > }, > "BasicPropertyInfo": { > "HotelCode": "AESPMI5L46", > "HotelName": "Hostal Cuba" > }, > "TPA_Extensions": { > "POS": { > "Source": [ > { > "RequestorID": [ > { > "CompanyName": { > "CompanyShortName": "OTS Open Travel Services AG", > "Code": "ICCHOTS" > }, > "Type": "4", > "ID_Context": "OTS", > "ID": "ICCHOTS" > } > ] > }, > { > "RequestorID": [ > { > "Type": "39", > "ID_Context": "OTS", > "ID": "AESPMI5L46Y26OWN2" > } > ] > }, > { > "RequestorID": [ > { > "Type": "2", > "ID_Context": "OTS", > "ID": "OTSHQ" > } > ] > }, > { > "RequestorID": [ > { > "Type": "45", > "ID_Context": "OTS", > "ID": "OWN2" > } > ] > } > ] > } > }, > "Reference": { > "ID": "4503599660031696", > "Type": "14" > }, > "TimeSpan": { > "End": "2026-07-24", > "Start": "2026-07-17" > }, > "ResGuestRPHs": { > "ResGuestRPH": [ > { > "RPH": "1" > }, > { > "RPH": "2" > }, > { > "RPH": "3" > } > ] > }, > "ServiceRPHs": { > "ServiceRPH": [ > { > "RPH": "2" > } > ] > }, > "Total": { > "CurrencyCode": "EUR", > "AmountAfterTax": "1811.33" > }, > "IndexNumber": "2", > "RoomStayStatus": "Book" > } > ] > }, > "Services": { > "Service": [ > { > "ServiceInventoryCode": "BB", > "ServiceRPH": "1" > }, > { > "ServiceInventoryCode": "BB", > "ServiceRPH": "2" > } > ] > }, > "ResGuests": { > "ResGuest": [ > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Mr" > ], > "GivenName": [ > "Bender" > ], > "Surname": "Bending" > } > ], > "BirthDate": "1996-09-04" > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": "27" > } > ] > }, > "AgeQualifyingCode": "10", > "ResGuestRPH": "1" > }, > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Mrs" > ], > "GivenName": [ > "Angelina" > ], > "Surname": "Bending" > } > ], > "BirthDate": "1996-09-05" > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": "27" > } > ] > }, > "AgeQualifyingCode": "10", > "ResGuestRPH": "2" > }, > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Jr" > ], > "GivenName": [ > "Ben" > ], > "Surname": "Bending" > } > ], > "BirthDate": "2018-09-06" > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": "6" > } > ] > }, > "AgeQualifyingCode": "8", > "ResGuestRPH": "3" > } > ] > }, > "ResGlobalInfo": { > "Total": { > "CurrencyCode": "EUR", > "AmountAfterTax": "3622.66" > }, > "Comments": { > "Comment": [ > { > "Text": "late arrival - flight lands at 22:55 local time", > "Name": "GENERAL", > "CommentOriginatorCode": "DISTRIBUTOR" > }, > { > "Text": "late arrival - flight lands at 22:55 local time", > "Name": "GENERAL", > "CommentOriginatorCode": "DISTRIBUTOR" > } > ] > }, > "HotelReservationIDs": { > "HotelReservationID": [ > { > "ResID_Type": "36", > "ResID_SourceContext": "Client", > "ResID_Value": "TEST_AXIS" > }, > { > "ResID_Value": "68486556", > "ResID_Type": "36", > "ResID_SourceContext": "Internal" > }, > { > "Item_RPH": "1", > "ResID_Value": "TEST_axis_ac1", > "ResID_Type": "37", > "ResID_SourceContext": "Client" > }, > { > "Item_RPH": "1", > "ResID_Value": "1", > "ResID_Type": "37", > "ResID_SourceContext": "Internal" > }, > { > "Item_RPH": "2", > "ResID_Value": "TEST_axis_ac2", > "ResID_Type": "37", > "ResID_SourceContext": "Client" > }, > { > "Item_RPH": "2", > "ResID_Value": "2", > "ResID_Type": "37", > "ResID_SourceContext": "Internal" > } > ] > }, > "CancelPenalties": { > "CancelPenalty": [ > { > "Deadline": { > "OffsetUnitMultiplier": "0", > "OffsetTimeUnit": "Hour", > "OffsetDropTime": "AfterBooking", > "AbsoluteDeadline": "2025-10-15T16:21:21" > }, > "AmountPercent": { > "Amount": "1811.33", > "CurrencyCode": "EUR", > "BasisType": "FullStay", > "Percent": "100" > }, > "Item_RPH": "1" > }, > { > "Deadline": { > "OffsetUnitMultiplier": "0", > "OffsetTimeUnit": "Hour", > "OffsetDropTime": "AfterBooking", > "AbsoluteDeadline": "2025-10-15T16:23:01" > }, > "AmountPercent": { > "Amount": "1811.33", > "CurrencyCode": "EUR", > "BasisType": "FullStay", > "Percent": "100" > }, > "Item_RPH": "2" > } > ] > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": { > "Paragraph": { > "Text": "Tax Payable Locally, Currency: EUR, type: city tax" > } > }, > "Title": "IncidentsAndErrata", > "InfoType": "5" > }, > { > "SubSection": { > "Paragraph": { > "Text": "Due to the local logistics infrastructure, there is a possibility that your meeting point for arrival and departure transfer may not be direct at the hotel door, Approx. Distance: > 600 m" > } > }, > "Title": "IncidentsAndErrata", > "InfoType": "5" > }, > { > "SubSection": { > "Paragraph": { > "Text": "Restaurant for Breakfast, Comment: Breakfast is served in the Sky Bar" > } > }, > "Title": "IncidentsAndErrata", > "InfoType": "5" > } > ] > }, > "HotelCodeContext": "354402", > "AreaID": "927", > "HotelName": "Hostal Cuba", > "HotelCode": "AESPMI5L46" > } > }, > "TPA_Extensions": { > "RateDetails": { > "GuestDetails": [ > { > "RateComponents": [ > { > "StayDay": "1", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "1", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "2", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "2", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "3", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "3", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "4", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "4", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "5", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "5", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "6", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "6", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "7", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "7", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "1", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "1", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "2", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "2", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "3", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "3", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "4", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "4", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "5", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "5", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "6", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > }, > { > "StayDay": "6", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "7", > "ResGuestRPH": "1", > "Code": "AMT8", > "Edition": "0.00", > "Rate": "246.44", > "CurrencyCode": "EUR", > "CodeType": "STDRATE" > }, > { > "StayDay": "7", > "ResGuestRPH": "1", > "Code": "SMS1", > "Edition": "0.00", > "Rate": "12.32", > "CurrencyCode": "EUR", > "CodeType": "EXTR" > } > ], > "ResGuestRPH": "1", > "TotalAmount": "3622.67", > "CurrencyCode": "EUR", > "RateCode": "Price" > }, > { > "ResGuestRPH": "2", > "TotalAmount": "0.00", > "CurrencyCode": "EUR", > "RateCode": "Price" > }, > { > "ResGuestRPH": "3", > "TotalAmount": "0.00", > "CurrencyCode": "EUR", > "RateCode": "Price" > } > ], > "Totals": { > "Total": [ > { > "Override": "false", > "TotalType": "Price", > "CurrencyType": "Price", > "CurrencyCode": "EUR", > "AmountAfterTax": "1811.33" > }, > { > "Override": "false", > "TotalType": "Price", > "CurrencyType": "Price", > "CurrencyCode": "EUR", > "AmountAfterTax": "1811.33" > } > ] > } > }, > "BookingStatus": { > "xmlns:ns1": "http://www.opentravel.org/OTA/2003/05/tpa", > "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", > "xsi:type": "ns1:BookingStatusType", > "ReservationStatusType": "Reserved", > "ConfirmationStatusType": "OK", > "prefix": "ns1" > }, > "Extras": "" > }, > "ResStatus": "Reserved", > "CreateDateTime": "2025-10-15T14:21:20", > "LastModifyDateTime": "2025-10-15T14:22:59" > } > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2016.2" > } > } > ``` ## Common Use Cases * **Booking list response** — Minimal identifiers for all bookings matching `SelectionCriteria` and date filters from the request. * **Booking details response** — Full reservation content for specific `UniqueID`(s). * **Enriched details** — Include item statuses, cancellation rules, and per‑passenger price breakdowns when the request specifies appropriate `Instance` flags. ## Best Practices 1. Use `EchoToken` to correlate response to the originating request. 2. Honor `ResStatus` in list responses; do not infer cancel status from missing items. 3. When `PrimaryLangID` is set in the request, descriptions in the response (room/board) are returned in indicated language when available; otherwise default to English. 4. If requesting enrichments, be prepared to process cancellation rules and per‑pax price breakdowns returned under extensions. # Breaking changes Source: https://docs.axisdata.net/changelog/breaking See the most important changes throughout the versions None to display yet. # Deprecations Source: https://docs.axisdata.net/changelog/deprecations See the most important changes throughout the versions None to display yet. # Version history Source: https://docs.axisdata.net/changelog/versions See all our version releases **October 2026** v1.4 Added features and functionalities: * The API is now also available in JSON format. * All examples and snippets in JSON and XML. **July 2026** v1.3 Added features and functionalities: * Beta Version of new Axis Data Dynamic Inventory API. * New section starting from [Dynamic Inventory Introduction](../rptoken/rptoken-introduction) **May 2026** v1.2 Added features and functionalities: * FlatFile concatenated vs separated rateplans * FlatFile deltadeliveries * Rate Limit error scenario * Updated pages: [FlatFile](../pushmodel/hotelFF), [Error Scenarios](../glossary/errors#miscellaneous) **December 2025** v1.1 Added features and functionalities: * Descriptive text for images * Recommended Retail Price * Promotional Offer Tags * Updated pages: [HotelDescriptiveInfoRS](../hotel/mappingRS#multimediadescriptions), [HotelAvailRS](../hotel/searchRS#reccomended-retail-price), [General Messaging](../general/messaging#offer-tags-and-extras) **November 2025** v1.0 Initial version of AxisData on-line documentation. You will find: * Guides with explanations to all our messages * General guides and information * XML API Playground to test the requests in real time * References tab with downloadable useful content # OTA_TourActivityAvailRQ Source: https://docs.axisdata.net/excursion/availXARQ > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_TourActivity API call](/api-reference/endpoint/excursion/availability) > > Skip & Hit the Playground. ## Search VS Avail To get activities from the system we have 2 message-types: ### OTA\_TourActivitySearchRQ This is a search request message used to: * Find available tour and activity products based on search criteria. * Query what tours/activities are offered in a destination. * Filter by location, dates, activity types, price ranges, etc. * Get a broad list of matching products. * Get NBC data for the matching products. * Get "best scenario" cheapest price for the matching products. Think of it as the initial discovery phase - "What tours are available in Rome next week?" ### OTA\_TourActivityAvailRQ This is an availability request message used to: * Check specific availability for a particular tour or activity. * Get detailed pricing, time slots, and capacity for a known product. * Verify real-time availability before booking. * Retrieve detailed schedules and options for a specific offering. Think of it as the detailed inquiry phase - "Is the Colosseum tour available at 2 PM on Tuesday for 4 people, and how much does it cost?" Key Difference Search = "Show me what exists" (broader, exploratory). Availability = "Tell me if this specific thing is available" (narrower, transactional). In a typical booking flow, you'd use SearchRQ first to find options, then AvailRQ to check specific details before making a booking with OTA\_TourActivityBookRQ. ## Purpose The **OTA\_TourActivityAvailRQ** message is used to request availability information for tours and activities. This request allows travel systems to query suppliers for available tour and activity products based on various search criteria including dates, locations, categories, and participant information. ## Structure - Root Element ```xml Root Element theme={null} ``` ```json Root Element theme={null} "OTA_TourActivitySearchRQ" ``` | Attribute | Type | Required | Description | | :- | :- | :- | :- | | `Version` | String | Yes | Schema version being used | | `xmlns` | String | Yes | "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)" | | `TimeStamp` | DateTime | No | Creation timestamp of the message | | `PrimaryLangID` | String | No | Primary language code (ISO 639) | | `EchoToken` | String | No | Reference for asynchronous transactions | | `MaxResponses` | Integer | No | Maximum number of results to return | ## Structure - Core Elements ### POS (Point of Sale) Identifies the party or connection making the request. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID": "TEST", "ID_Context": "AxisData", "Type": "22" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` Identifies the requesting party and contains credentials. Check [Access to our Systems](../authentication/access#partner-identification). #### Instance | Switch | Behavior | | :- | :- | | `MF002` | Returns one **cheapest price per service** (price-from, per person). | | `MF001` | Returns **all schedules** and **all products/subservices** for the selected service (prices per group). | > [!TIP] > > Recommended workflow: Initial search with `MF002` per area for cheapest prices, then detailed search with `MF001` per product for selected service. ### TourActivity Core element containing search criteria for tours and activities. ```xml theme={null} AESPMI5L46 XESPMI5L4U 10 PerPerson ``` ```json theme={null} { "TourActivity": { "BasicInfo": {}, "Location": [ { "Context": "Source", "Region": { "RegionCode": "HotelCode", "value": "AESPMI5L46" } }, { "Context": "Service", "Region": { "RegionCode": "Product", "value": "XESPMI5L4U" } } ], "Schedule": { "StartPeriod": "2027-07-17", "EndPeriod": "2027-07-24" }, "ParticipantCount": { "Quantity": "1", "QualifierInfo": [ { "value": "10" } ] }, "MultimodalOffer": { "RequestedOffer": { "GuidelinePricing": { "Method": { "value": "PerPerson" }, "MaximumPrice": { "Amount": "999", "CurrencyCode": "EUR", "CurrencyDecimal": "2" } } } } } } ``` #### Location * Two contexts: `Context="Source"` (guest origin/pick-up base) and `Context="Service"` (where the activity runs). * Use one location type per context: Areas (`Country` → `Region` → `Resort`), `HotelCode`, `GIATA`, `Product`, or geocode via `Position`. * When using areas, always include `Country`. > [!NOTE] > > * Source locations allowed: Area (Country, Region, Resort), GIATA code, Hotel Code or Geo Location. > * Destination locations allowed: Area (Country, Region, Resort), TourActivity Code. ```xml theme={null} AESPMI5L46 ``` ```json theme={null} { "Location": { "Context": "Source", "Region": { "RegionCode": "HotelCode", "value": "AESPMI5L46" } } } ``` #### Schedule Defines temporal search criteria: * `StartPeriod`: Start date for availability search. * `EndPeriod`: End date for availability search. ```xml theme={null} ``` ```json theme={null} { "Schedule": { "StartPeriod": "2027-07-17", "EndPeriod": "2027-07-24" } } ``` Duration can optionally be included. #### ParticipantCount Details about participants: ```xml theme={null} 10 ``` ```json theme={null} { "ParticipantCount": { "Quantity": "1", "Age": "26", "QualifierInfo": [ { "value": "10" } ] } } ``` **Age QualifierInfo Codes:** * `8`: Child * `10`: Adult * `7`: Infant #### MultimodalOffer Can be used to specify a maximum price and it's type (PerPerson, PerUnit). ```xml theme={null} PerPerson ``` ```json theme={null} { "MultimodalOffer": { "RequestedOffer": { "GuidelinePricing": { "Method": { "value": "PerPerson" }, "MaximumPrice": { "Amount": "999", "CurrencyCode": "EUR", "CurrencyDecimal": "2" } } } } } ``` ## Complete Examples > [tab] Avail by Product > > ```xml expandable theme={null} > > > > > > > > > > > > > AESPMI5L46 > > > XESPMI5L4U > > > > 10 > > > > > PerPerson > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_TourActivityAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF001", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "TourActivity" : { > "BasicInfo" : [ { } ], > "Location" : [ { > "Region" : [ { > "value" : "AESPMI5L46", > "RegionCode" : "HotelCode" > } ], > "Context" : "Source" > }, { > "Region" : [ { > "value" : "XESPMI5L4U", > "RegionCode" : "Product" > } ], > "Context" : "Service" > } ], > "Schedule" : [ { > "StartPeriod" : "2027-07-17", > "EndPeriod" : "2027-07-24" > } ], > "ParticipantCount" : [ { > "QualifierInfo" : { }, > "Quantity" : 1 > } ], > "MultimodalOffer" : { > "RequestedOffer" : { > "GuidelinePricing" : { > "MaximumPrice" : { > "CurrencyCode" : "EUR", > "CurrencyDecimal" : 2, > "Amount" : 999 > }, > "Method" : { > "value" : "PerPerson" > } > } > } > } > }, > "Version" : 2011.2 > } > } > ``` > [tab] Avail by Region > > ```xml expandable theme={null} > > > > > > > > > > > > > AESPMI5L46 > > > Spain > Lanzarote > > > > 10 > > > > > PerPerson > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_TourActivityAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF002", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "TourActivity" : { > "BasicInfo" : [ { } ], > "Location" : [ { > "Region" : [ { > "value" : "AESPMI5L46", > "RegionCode" : "HotelCode" > } ], > "Context" : "Source" > }, { > "Region" : [ { > "value" : "Spain", > "RegionCode" : "Country" > }, { > "value" : "Lanzarote", > "RegionCode" : "Region" > } ], > "Context" : "Service" > } ], > "Schedule" : [ { > "StartPeriod" : "2027-07-17", > "EndPeriod" : "2027-07-24" > } ], > "ParticipantCount" : [ { > "QualifierInfo" : { }, > "Quantity" : 1 > } ], > "MultimodalOffer" : { > "RequestedOffer" : { > "GuidelinePricing" : { > "MaximumPrice" : { > "CurrencyCode" : "EUR", > "CurrencyDecimal" : 2, > "Amount" : 999 > }, > "Method" : { > "value" : "PerPerson" > } > } > } > } > }, > "Version" : 2011.2 > } > } > > ``` ## Common Use Cases * **Product Availability Request**: Searches a specific activity, ideally with instance MF001 to get all the possible results of the product. * **Region Availability Request**: Searches multiple activities in one region, ideally with instance MF002 to get only the cheapest combination of each product. ## Best Practices 1. **Be Specific**: Include as many relevant search criteria as possible to get accurate results. 2. **Date Ranges**: Use reasonable date ranges to avoid overwhelming results. 3. **Participant Details**: Always specify participant counts and age categories for accurate pricing. 4. **MaxResponses**: Set appropriate limits to manage result sets. 5. **Language**: Specify PrimaryLangID to receive results in the desired language. 6. **Time Zones**: Be aware that timestamps should include timezone information. 7. **Error Handling**: Implement proper error handling for the response messages. ## Playground > [card] [OTA\_TourActivity API call](/api-reference/endpoint/excursion/availability) > > Hit the Playground. > [!TIP] > > Use the desired request at the playground and receive responses from our test environment API! # OTA_TourActivityAvailRS Source: https://docs.axisdata.net/excursion/availXARS The OTA\_TourActivityAvailRS (Tour & Activity Availability **Response**) returns available excursion services and pricing, corresponding to the search parameters sent in `OTA_TourActivityAvailRQ`. A `` element indicates the request was processed; otherwise errors are returned. Results may be aggregated as one **price-from per service** (MF002) or expanded **per product/subservice** (MF001). ## Structure – Root Element ```xml Root Element theme={null} ``` ```json Root Element theme={null} "OTA_TourActivityAvailRS" ``` **Key Attributes:** * `xmlns`: `http://www.opentravel.org/OTA/2003/05`. * `Version`: `2016.b` (OTA Tour Activity messaging pack). * `TransactionIdentifier`: Correlates the transaction across systems (optional). ## Structure – Core Elements ### TourActivityInfo Container for one available service result. #### BasicInfo Service identification and labeling for the product/subservice. * `SupplierProductCode`: Specifies which product(unit) of a stock is being described. * `Name`: Full name of the tour. * `ShortName`: Name of the product. * `TourActivityID`: MTS activity code. * `SupplierServiceCode`: Type of service. ```xml theme={null} ``` ```json theme={null} { "BasicInfo": { "SupplierProductCode": "FK000000", "Name": "Fuerteventura Leisure", "ShortName": "Ferry Ticket - ticket only", "TourActivityID": "XESPMI5L4U", "SupplierServiceCode": "TIC" } } ``` #### Schedule Availability summary for the specific departure/slot. * `Summary/@Start`: Start datetime (ISO 8601). * `Summary/@End`: End datetime (ISO 8601). * `Summary/@Duration`: ISO 8601 duration (e.g., `PT8H`). ```xml theme={null} ``` ```json theme={null} { "Schedule": { "Summary": { "Start": "2026-07-17T09:30:00", "Duration": "PT8H", "End": "2026-07-17T17:30:00" } } } ``` #### CategoryAndType Classification of the service. * `Category/@Code`: Category (e.g., Excursion vs Ticket). * `Type/@Code`: Activity type code (implementation-defined). ```xml theme={null} ``` ```json theme={null} { "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "BT" } } } ``` #### Description Short text describing the service. * `ShortDescription` ```xml theme={null} Fuerteventura Leisure ``` ```json theme={null} { "Description": { "ShortDescription": "Fuerteventura Leisure" } } ``` #### Location Where the service operates; includes postal address, regions, and geo position. * `Address`: `AddressLine`, `CityName`, `PostalCode`, `Country`, `StateProv`. * `Region`: `@RegionCode` values such as `Country`, `Destination`, `Region`, `Resort`, `TravelDestination`. * `Position`: `@Latitude`, `@Longitude`. ```xml theme={null}
Corralejo Playa Blanca 35660 ES Lanzarote
ES Canarian Islands Lanzarote Playa Blanca ACE
``` ```json theme={null} { "Location": { "Address": { "AddressLine": "Corralejo", "CityName": "Playa Blanca", "PostalCode": "35660", "Country": "ES", "StateProv": "Lanzarote" }, "Region": [ { "RegionCode": "Country", "value": "ES" }, { "RegionCode": "Destination", "value": "Canarian Islands" }, { "RegionCode": "Region", "value": "Lanzarote" }, { "RegionCode": "Resort", "value": "Playa Blanca" }, { "RegionCode": "TravelDestination", "value": "ACE" } ], "Position": { "Latitude": "28.86275", "Longitude": "-13.82973" } } } ``` #### Pricing Price container. Returned format depends on MF mode: * **MF002 (price-from per service)** — `Summary/@MinCharge` with `CurrencyCode`; `PricingType` = `PerPerson`. * **MF001 (detailed per product/subservice)** — `Summary/@Amount` with `CurrencyCode`; `PricingType` = `PerGroup`. ```xml theme={null} PerPerson ``` ```json theme={null} { "Pricing": { "Summary": { "MinCharge": "40.00", "CurrencyCode": "EUR", "PricingType": "PerPerson" } } } ``` #### PickupDropoff (MF001 results with transfer service) Operational pickup/dropoff information and indicators. * `@PickupInd`: `true` for pickup records; `false` for dropoff. * `@DateTime`: Pickup/dropoff local datetime. * `@LocationName`, `@Code`, `@MeetingLocation`: Operational details (as provided). ## Complete Examples > [tab] Basic Response (MF002) > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > Dolphin Sightseeing > > >
> Paseo Del Mar 60 > Cala Millor > 07558 > ES > Baleares >
> ES > Balearic Islands > Mallorca > Cala Millor > PMI > >
> > > PerPerson > > > > > > > > Early Booking Offers [XA] 10% > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_TourActivityAvailRS": { > "Success": {}, > "TourActivityInfo": [ > { > "BasicInfo": { > "SupplierProductCode": "SS0HDBT0", > "Name": "Dolphin Sightseeing", > "ShortName": "Sightseeing Tour (Halfday - Incl. Boat Trip) - ticket only", > "TourActivityID": "XESPMI5L4U", > "SupplierServiceCode": "TIC" > }, > "Schedule": { > "Summary": [ > { > "Start": "2027-07-17T09:00:00", > "Duration": "PT4H", > "End": "2027-07-17T13:00:00" > }, > { > "Start": "2027-07-18T09:00:00", > "Duration": "PT4H", > "End": "2027-07-18T13:00:00" > }, > { > "Start": "2027-07-19T09:00:00", > "Duration": "PT4H", > "End": "2027-07-19T13:00:00" > }, > { > "Start": "2027-07-20T09:00:00", > "Duration": "PT4H", > "End": "2027-07-20T13:00:00" > }, > { > "Start": "2027-07-21T09:00:00", > "Duration": "PT4H", > "End": "2027-07-21T13:00:00" > }, > { > "Start": "2027-07-22T09:00:00", > "Duration": "PT4H", > "End": "2027-07-22T13:00:00" > }, > { > "Start": "2027-07-23T09:00:00", > "Duration": "PT4H", > "End": "2027-07-23T13:00:00" > }, > { > "Start": "2027-07-24T09:00:00", > "Duration": "PT4H", > "End": "2027-07-24T13:00:00" > } > ] > }, > "CategoryAndType": { > "Category": { > "Code": "XA" > }, > "Type": [ > { > "Code": "TT" > } > ] > }, > "Description": { > "ShortDescription": "Dolphin Sightseeing" > }, > "Location": { > "Address": { > "AddressLine": [ > "Paseo Del Mar 60" > ], > "CityName": "Cala Millor", > "PostalCode": "07558", > "Country": "ES", > "StateProv": { > "value": "Baleares" > } > }, > "Region": [ > { > "value": "ES", > "RegionCode": "Country" > }, > { > "value": "Balearic Islands", > "RegionCode": "Destination" > }, > { > "value": "Mallorca", > "RegionCode": "Region" > }, > { > "value": "Cala Millor", > "RegionCode": "Resort" > }, > { > "value": "PMI", > "RegionCode": "TravelDestination" > } > ], > "Position": { > "Latitude": "39.60469", > "Longitude": "3.38801" > } > }, > "Pricing": { > "Summary": { > "PricingType": { > "value": "PerPerson" > }, > "MinCharge": 45.90, > "CurrencyCode": "EUR" > }, > "ParticipantCategory": [ > { > "TPA_Extensions": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Early Booking Offers [XA] 10%" > } > ] > } > ], > "SubTitle": "10%", > "SubCode": "Value" > }, > { > "SubTitle": "EBOLA", > "SubCode": "OTS" > } > ], > "Title": "Early Booking Offers [XA]", > "InfoType": "3" > } > ] > } > } > } > ] > } > } > ], > "Version": 2011.2, > "TransactionIdentifier": "1-1/1" > } > } > ``` > [tab] Detailed Response TRP (MF001) > > ```xml expandable theme={null} > > > > > > > > > > > > > > Dolphin Sightseeing > > >
> Paseo Del Mar 60 > Cala Millor > 07558 > ES > Baleares >
> ES > Balearic Islands > Mallorca > Cala Millor > PMI > >
> > > PerPerson > > > > > > > > Early Booking Offers [XA] 10% > > > > > > > > > > > > > > > > > > > > > Dolphin Sightseeing > > >
> Paseo Del Mar 60 > Cala Millor > 07558 > ES > Baleares >
> ES > Balearic Islands > Mallorca > Cala Millor > PMI > >
> > > PerPerson > > > > > > > > Early Booking Offers [XA] 10% > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_TourActivityAvailRS": { > "Success": {}, > "TourActivityInfo": [ > { > "BasicInfo": { > "SupplierProductCode": "SS0HDBT0", > "Name": "Dolphin Sightseeing", > "ShortName": "Sightseeing Tour (Halfday - Incl. Boat Trip) - ticket only", > "TourActivityID": "XESPMI5L4U", > "SupplierServiceCode": "TIC" > }, > "Schedule": { > "Summary": [ > { > "Start": "2027-07-17T09:00:00", > "Duration": "PT4H", > "End": "2027-07-17T13:00:00" > } > ] > }, > "CategoryAndType": { > "Category": { > "Code": "XA" > }, > "Type": [ > { > "Code": "TT" > } > ] > }, > "Description": { > "ShortDescription": "Dolphin Sightseeing" > }, > "Location": { > "Address": { > "AddressLine": [ > "Paseo Del Mar 60" > ], > "CityName": "Cala Millor", > "PostalCode": "07558", > "Country": "ES", > "StateProv": { > "value": "Baleares" > } > }, > "Region": [ > { > "value": "ES", > "RegionCode": "Country" > }, > { > "value": "Balearic Islands", > "RegionCode": "Destination" > }, > { > "value": "Mallorca", > "RegionCode": "Region" > }, > { > "value": "Cala Millor", > "RegionCode": "Resort" > }, > { > "value": "PMI", > "RegionCode": "TravelDestination" > } > ], > "Position": { > "Latitude": "39.60469", > "Longitude": "3.38801" > } > }, > "Pricing": { > "Summary": { > "PricingType": { > "value": "PerPerson" > }, > "MinCharge": 45.90, > "CurrencyCode": "EUR" > }, > "ParticipantCategory": [ > { > "TPA_Extensions": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Early Booking Offers [XA] 10%" > } > ] > } > ], > "SubTitle": "10%", > "SubCode": "Value" > }, > { > "SubTitle": "EBOLA", > "SubCode": "OTS" > } > ], > "Title": "Early Booking Offers [XA]", > "InfoType": "3" > } > ] > } > } > } > ] > }, > "PickupDropoff": [ > { > "Code": "AESPMI5L46", > "LocationName": "Hotel Overlook", > "PickupInd": false > } > ] > }, > { > "BasicInfo": { > "SupplierProductCode": "SS0HDBT0", > "Name": "Dolphin Sightseeing", > "ShortName": "Sightseeing Tour (Halfday - Incl. Boat Trip) - incl. pickUp & dropOff", > "TourActivityID": "XESPMI5L4U", > "SupplierServiceCode": "TRF" > }, > "Schedule": { > "Summary": [ > { > "Start": "2027-07-17T09:00:00", > "Duration": "PT4H", > "End": "2027-07-17T13:00:00" > } > ] > }, > "CategoryAndType": { > "Category": { > "Code": "XA" > }, > "Type": [ > { > "Code": "TT" > } > ] > }, > "Description": { > "ShortDescription": "Dolphin Sightseeing" > }, > "Location": { > "Address": { > "AddressLine": [ > "Paseo Del Mar 60" > ], > "CityName": "Cala Millor", > "PostalCode": "07558", > "Country": "ES", > "StateProv": { > "value": "Baleares" > } > }, > "Region": [ > { > "value": "ES", > "RegionCode": "Country" > }, > { > "value": "Balearic Islands", > "RegionCode": "Destination" > }, > { > "value": "Mallorca", > "RegionCode": "Region" > }, > { > "value": "Cala Millor", > "RegionCode": "Resort" > }, > { > "value": "PMI", > "RegionCode": "TravelDestination" > } > ], > "Position": { > "Latitude": "39.60469", > "Longitude": "3.38801" > } > }, > "Pricing": { > "Summary": { > "PricingType": { > "value": "PerPerson" > }, > "MinCharge": 55.08, > "CurrencyCode": "EUR" > }, > "ParticipantCategory": [ > { > "TPA_Extensions": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Early Booking Offers [XA] 10%" > } > ] > } > ], > "SubTitle": "10%", > "SubCode": "Value" > }, > { > "SubTitle": "EBOLA", > "SubCode": "OTS" > } > ], > "Title": "Early Booking Offers [XA]", > "InfoType": "3" > } > ] > } > } > } > ] > }, > "PickupDropoff": [ > { > "DateTime": "2027-07-17T08:50:00", > "Code": "AESPMI5L46", > "LocationName": "Hotel Overlook", > "MeetingLocation": "Hotel Overlook [Hotel entrance]", > "PickupInd": true > } > ] > } > ], > "Version": 2011.2, > "TransactionIdentifier": "1-2/2" > } > } > ``` ## Notes & Constraints * **MF modes:** MF002 returns a single price-from (per person) per service; MF001 returns detailed products/subservices priced per group with operational details like pickups. * **Pickup/dropoff in Ticket-only services:** Not included when the service is a pure ticket (no transfer). * **Region usage:** When regions are provided, `Country` is required; other levels (Destination/Region/Resort/TravelDestination) are optional as applicable. # OTA_TourActivityBookRQ Source: https://docs.axisdata.net/excursion/bookXARQ The OTA\_TourActivityBookRQ (Excursion Book Request) is used to **quote** and **commit** tour & activity bookings. > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_TourActivityBookRQ API call](/api-reference/endpoint/excursion/book) > > Skip & Hit the Playground. ## Purpose This message is used to: * Request a quote (availability + total price) for a specific activity using `ResStatus="Quote"`. * Confirm a booking using `ResStatus="Commit"` (binding if accepted). ## Structure – Root Element ```xml Root Element theme={null} ``` ```json Root Element theme={null} "OTA_TourActivityBookRQ" ``` **Key Attributes:** * `Version`: Specification version (e.g., "2011.2"). * `ResStatus`: Booking intent. Allowed values: `Quote` | `Commit`. * `xmlns`: "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)". ## Structure – Core Elements ### POS Identifies the requesting party and contains credentials. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID": "TEST", "ID_Context": "AxisData", "Type": "22", "Instance": "PriceBreakdown" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` ### BookingInfo Container for the service, participants, schedule, pricing, and optional extras. #### BasicInfo Provide the **full service identifier** returned by the search. ```xml theme={null} ``` ```json theme={null} { "BasicInfo": { "TourActivityID": "XESPMI5L4U", "SupplierProductCode": "ST", "SupplierServiceCode": "TRF" } } ``` #### ParticipantInfo Each traveler is described with a `Category` and `Individual` node. * `Category/@QualifierInfo`: Age Qualifying Code (AQC) per OTA standard. * `Individual/@Age`: **Age at time of service**. * `Individual/@ParticipantID`: Unique within request. ```xml theme={null} Bender Mr Bending Angeline Ms Bending ``` ```json theme={null} { "ParticipantInfo": [ { "Category": { "QualifierInfo": "10" }, "Individual": { "Age": "36", "ParticipantID": "1", "GivenName": "Bender", "NamePrefix": "Mr", "Surname": "Bending" } }, { "Category": { "QualifierInfo": "10" }, "Individual": { "Age": "32", "ParticipantID": "2", "GivenName": "Angeline", "NamePrefix": "Ms", "Surname": "Bending" } } ] } ``` #### Schedule Use a **single calendar date** for the service. Times may be included. ```xml theme={null} ``` ```json theme={null} { "Schedule": { "Start": "2027-07-17T09:30:00", "End": "2027-07-17T17:30:00" } } ``` #### PickupDropoff Include pickup time and location if the activity requires it (e.g. TRF). ```xml theme={null} ``` ```json theme={null} { "PickupDropoff": { "DateTime": "2027-07-17T08:25:00", "LocationName": "AESPMI5L46", "PickupInd": "true" } } ``` #### Pricing Send back the total price from the detailed search for consistency. ```xml theme={null} ``` ```json theme={null} { "Pricing": { "Summary": { "Amount": "130.00", "CurrencyCode": "EUR" } } } ``` #### Extras Add optional extras returned by search. Do **not** include compulsory extras (already priced). ```xml theme={null} ``` ```json theme={null} { "Extra": { "SupplierCode": "EXFOOD", "Description": "Extra Food", "quantity": "1" } } ``` ### TPA\_Extensions Partner references are required for idempotency and voucher printing. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "UniqueID": [ { "Type": "36", "ID": "123456789", "ID_Context": "Client" }, { "Type": "37", "ID": "123456789_1", "ID_Context": "Client" } ] } } ``` ## Complete Examples ```xml Book Activity expandable theme={null} Bender Mr Bending Angeline Ms Bending ``` ```json Book Activity expandable theme={null} { "OTA_TourActivityBookRQ" : { "POS" : { "Source" : [ { "RequestorID" : [ { "Type" : "22", "Instance" : "PriceBreakdown", "ID" : "TEST", "ID_Context" : "AxisData" } ] }, { "RequestorID" : [ { "Type" : "88", "ID" : "TEST", "MessagePassword" : "testpass" } ] } ] }, "BookingInfo" : { "BasicInfo" : { "SupplierProductCode" : "SS0HDBT0", "TourActivityID" : "XESPMI5L4U", "SupplierServiceCode" : "TRF" }, "ParticipantInfo" : [ { "Category" : { "QualifierInfo" : 10 }, "Individual" : { "NamePrefix" : [ "Mr" ], "GivenName" : [ "Bender" ], "Surname" : "Bending", "ParticipantID" : "1", "Age" : 36 } }, { "Category" : { "QualifierInfo" : 10 }, "Individual" : { "NamePrefix" : [ "Ms" ], "GivenName" : [ "Angeline" ], "Surname" : "Bending", "ParticipantID" : "2", "Age" : 32 } } ], "Schedule" : { "Start" : "2027-07-17T09:30:00", "End" : "2027-07-17T17:30:00" }, "Extra" : [ { "SupplierCode" : "EXFOOD", "Description" : "Extra Food" } ], "PickupDropoff" : [ { "DateTime" : "2027-07-17T08:25:00", "LocationName" : "AESPMI5L46", "PickupInd" : true } ], "Pricing" : { "Summary" : { "CurrencyCode" : "EUR", "Amount" : 130.00 } } }, "TPA_Extensions" : { "UniqueID" : [ { "Type" : "36", "ID_Context" : "Client", "ID" : "123456789" }, { "Type" : "37", "ID_Context" : "Client", "ID" : "123456789_1" } ] }, "ResStatus" : "Quote", "Version" : 2011.2 } } ``` ## Best Practices 1. Always include partner references in `TPA_Extensions` to prevent duplicate bookings. 2. Use ages **at service date** in `Individual/@Age`. 3. Keep `Start` and `End` within the same calendar day for day activities. 4. Echo back the returned price in `Pricing/Summary` for consistency checks. ## Playground > [card] [OTA\_TourActivityBookRQ API call](/api-reference/endpoint/excursion/book) > > Try our API playground in real time. > [!TIP] > > Use the desired request in the playground and receive responses from our test environment API! # OTA_TourActivityBookRS Source: https://docs.axisdata.net/excursion/bookXARS The **OTA\_TourActivityBookRS** (Excursion Book **Response**) confirms a quote or a committed booking for a tour/activity service. It returns confirmation details such as service identifiers, participant data, pricing, partner/internal references, cancellation rules, and (optionally) QR codes. ## Purpose * **Quote**: Confirms availability and final price without creating a reservation (no commitment). * **Commit**: Creates a binding booking in the reservation system; penalties may apply to changes/cancellations. * If the booking cannot be processed, the response **omits** `` and returns error details under ``. [Error Scenarios](../glossary/errors) ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_TourActivityBookRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2008.1", ... } } ``` **Key attributes** * `Version`: OTA spec version (e.g., `2008.1`). * `xmlns`: `http://www.opentravel.org/OTA/2003/05`. ## Structure – Core Elements ### BasicInfo Confirms the booked service identifiers returned from search/detail. ```xml theme={null} ``` ```json theme={null} { "BasicInfo": { "TourActivityID": "XESPMIAZ9U", "SupplierProductCode": "TE0CC00A", "SupplierServiceCode": "TRF" } } ``` ### Location Optional region/location context for the service. ```xml theme={null} Mallorca ``` ```json theme={null} { "Location": { "Context": "Service", "Region": { "RegionCode": "Region", "value": "Mallorca" } } } ``` ### ParticipantInfo Echoes each participant’s **age at the time of service**, a unique `ParticipantID`, and the age qualifier code (`QualifierInfo`) following OTA AQC conventions (e.g., `10` adult, `8` child). ```xml theme={null} Mr Bender Bending ``` ```json theme={null} { "ParticipantInfo": { "Category": { "QualifierInfo": "10" }, "Individual": { "Age": "36", "ParticipantID": "1", "NamePrefix": "Mr", "GivenName": "Bender", "Surname": "Bending" } } } ``` ### Pricing Final confirmed amounts appear under `Pricing`. Values in `Summary` are **final for accountancy**. Group size (when relevant) is returned as `KnownGroupsize`. ```xml theme={null} ``` ```json theme={null} { "Pricing": { "Summary": { "Amount": "130.00", "CurrencyCode": "EUR" }, "Group": { "KnownGroupsize": "3" } } } ``` ### Extras Extras confirmed in the booking appear in the response; their amounts are already included in the total charge. ```xml theme={null} ``` ```json theme={null} { "Extra": { "SupplierCode": "EXFOOD", "Description": "Extra Food", "quantity": "1" } } ``` ### TPA\_Extensions Includes general information returned by the provider. #### References Partner and AxisData internal references are returned as `UniqueID` entries. Use **client** references for vouchers and communications; both client and internal references support cancellation. Master (`Type=36`) and child (`Type=37`) references are provided. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "1234567890" }, { "Type": "36", "ID_Context": "Internal", "ID": "121212121212" }, { "Type": "37", "ID_Context": "Client", "ID": "1234567890_1" }, { "Type": "37", "ID_Context": "Internal", "ID": "1" } ] } } ``` #### CancelPenalties Cancellation policy is returned for **both** Quote and Commit responses. Use child references for **partial** cancellations. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "CancelPenalties": { "CancelPenalty": [ { "Deadline": { "OffsetUnitMultiplier": "24", "OffsetTimeUnit": "Hour", "OffsetDropTime": "BeforeArrival" }, "AmountPercent": { "Percent": "50", "BasisType": "FullStay" } }, { "Deadline": { "OffsetUnitMultiplier": "72", "OffsetTimeUnit": "Hour", "OffsetDropTime": "BeforeArrival" }, "AmountPercent": { "Percent": "5", "BasisType": "FullStay" } } ] } } } ``` #### QR Codes Some providers return **tickets/QR codes** via `UniqueID Type="30"` under `TPA_Extensions`: * **Direct QR value**: `ID` contains the QR string to render as a code. * **QR URL**: `ID` contains a URL to download the QR/ticket. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "UniqueID": [ { "Type": "30", "ID_Context": "Client", "ID": "/OI/P1437/I0/AN002137/E176/N001/B003/J1/F210605/H1600/G51/R1:Y2-B3F210605-H1600" }, { "Type": "30", "ID_Context": "Client", "ID": "https://pre-portaventuraworld.api.experticket.com/TransactionDownload/SalesDocument?SaleId=5603191358506446612" } ] } } ``` #### BookingStatus When present, booking status may also be returned as a TPA element: ```xml theme={null} ``` ```json theme={null} { "BookingStatus": { "xmlns:ns1": "http://www.opentravel.org/OTA/2003/05/tpa", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "xsi:type": "ns1:BookingStatusType", "ReservationStatusType": "Reserved" } } ``` ## Complete Examples ```xml Book RS expandable theme={null} Bender Mr Bending Angeline Ms Bending ``` ```json Book RS expandable theme={null} { "OTA_TourActivityBookRS": { "Success": "", "BasicInfo": { "TourActivityID": "XESPMI5L4U", "SupplierProductCode": "SS0HDBT0", "SupplierServiceCode": "TRF" }, "Location": { "Region": { "RegionCode": "Region", "value": "Mallorca" }, "Context": "Service" }, "ParticipantInfo": { "Category": { "QualifierInfo": "10" }, "Individual": { "NamePrefix": "Mr", "GivenName": "Bender", "Surname": "Bending", "Age": "36", "ParticipantID": "1" } }, "Pricing": { "Summary": { "Amount": "130.00", "CurrencyCode": "EUR" }, "Group": { "KnownGroupsize": "3" } }, "TPA_Extensions": { "CancelPenalties": { "CancelPenalty": [ { "Deadline": { "OffsetUnitMultiplier": "24", "OffsetTimeUnit": "Hour", "OffsetDropTime": "BeforeArrival" }, "AmountPercent": { "Percent": "50", "BasisType": "FullStay" } }, { "Deadline": { "OffsetUnitMultiplier": "72", "OffsetTimeUnit": "Hour", "OffsetDropTime": "BeforeArrival" }, "AmountPercent": { "Percent": "5", "BasisType": "FullStay" } } ] }, "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "1234567890" }, { "Type": "36", "ID_Context": "Internal", "ID": "121212121212" }, { "Type": "37", "ID_Context": "Client", "ID": "1234567890_1" }, { "Type": "37", "ID_Context": "Internal", "ID": "1" }, { "Type": "30", "ID_Context": "Client", "ID": "/OI/P1437/I0/AN002137/E176/N001/B003/J1/F210605/H1600/G51/R1:Y2-B3F210605-H1600" }, { "Type": "30", "ID_Context": "Client", "ID": "https://pre-portaventuraworld.api.experticket.com/TransactionDownload/SalesDocument?SaleId=5603191358506446612" } ], "BookingStatus": { "xmlns:ns1": "http://www.opentravel.org/OTA/2003/05/tpa", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "xsi:type": "ns1:BookingStatusType", "ReservationStatusType": "Reserved", "prefix": "ns1" } }, "Extra": { "SupplierCode": "EXFOOD", "Description": "Extra Food", "quantity": "1" }, "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2008.1" } } ``` ## Best Practices 1. Use **client** references for external communications (voucher/finance), but retain **internal** references for support and cancellations. 2. Provide accurate **ages at service date** with correct OTA AQC codes in `ParticipantInfo`. 3. Read `CancelPenalties` for both quotes and commits; use child references to scope **partial** cancellations. # OTA_ProductDescriptiveInfoRQ Source: https://docs.axisdata.net/excursion/mappingXARQ The `OTA_ProductDescriptiveInfoRQ` (Excursion Details Request) is used to request NBC mapping data for a specific excursion. It follows the OTA schema and is the entry point in the transactional model to retrieve descriptive data for excursions. > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_TourActivityBookRQ API call](/api-reference/endpoint/excursion/nbc) > > Try our API playground in real time. ## Purpose This request fetches descriptive information for excursions needed for NBC mapping, by referencing a specific `TourActivityID`. It is analogous in intent to product descriptive requests in other verticals, but targeted at excursions. ## Structure – Root Element ```xml theme={null} ``` ```json theme={null} "OTA_ProductDescriptiveInfoRQ" ``` **Key Attributes:** * `Version`: Specification version (e.g., "2016.2"). * `PrimaryLangID`: Primary language code (ISO 639). * `AltLangID`: Alternate language code (ISO 639). * `SequenceNmbr`: Client-assigned sequence number for idempotence/tracking. * `xmlns`: "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)". ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and contains credentials. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID": "TEST", "ID_Context": "AxisData", "Type": "22" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` ### ProductDescriptiveInfos / TourActivityDescriptiveInfo Container specifying which excursion to describe. * `TourActivityDescriptiveInfo/@TourActivityID` — **required**. Identifies the excursion to be described. ```xml theme={null} ``` ```json theme={null} { "ProductDescriptiveInfos": { "TourActivityDescriptiveInfo": { "TourActivityID": "XESPMI5L4U" } } } ``` ## Complete Example ```xml theme={null} ``` ```json theme={null} { "OTA_ProductDescriptiveInfoRQ" : { "POS" : { "Source" : [ { "RequestorID" : [ { "Type" : "22", "ID" : "TEST", "ID_Context" : "AxisData" } ] }, { "RequestorID" : [ { "Type" : "88", "ID" : "TEST", "MessagePassword" : "testpass" } ] } ] }, "ProductDescriptiveInfos" : { "TourActivityDescriptiveInfo" : [ { "TourActivityID" : "XESPMI5L4U" } ] }, "Version" : 2016.2, "SequenceNmbr" : 1, "PrimaryLangID" : "EN", "AltLangID" : "EN" } } ``` ## Common Use Cases * **Excursion Details Request (NBC mapping):** Request descriptive data for a single excursion by `TourActivityID` to drive mapping of products/services. ## Playground > [card] [OTA\_TourActivityBookRQ API call](/api-reference/endpoint/excursion/nbc) > > Try our API playground in real time. > [!TIP] > > Use the desired request in the playground and receive responses from our test environment API! # OTA_ProductDescriptiveInfoRS Source: https://docs.axisdata.net/excursion/mappingXARS The `OTA_ProductDescriptiveInfoRS` is an OTA **response** message used in the Excursions NBC (Notification‑Based Content) flow to deliver descriptive product metadata for a tour activity. It surfaces the **Excursion identifier**, the set of **Products** offered, and the available **Service** types. ## Purpose This response provides: * **TourActivityID** — unique identifier of the excursion. * **Products** — product options offered under the excursion (e.g., 15‑min vs 30‑min tour). * **Services** — service delivery types (e.g., ticket only, with pickup). * **Descriptive text** for display. ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_ProductDescriptiveInfoRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2008.1", ... } } ``` **Common Attributes** * `Version` — OTA spec version (e.g., `2008.1`). * `xmlns` — `http://www.opentravel.org/OTA/2003/05`. ## Structure - Core Elements ### TourActivityDescriptiveInfo Container of one or more tour activities returned in the response. The structure is similar to [Hotel NBC](../hotel/mappingRS). #### TourActivityDescriptiveContent Contains the retrieved service details. ```xml theme={null} ``` ```json theme={null} { "TourActivityDescriptiveContent": { "TourActivityID": "XESPMI5L4U", "TourActivityName": "Music Show", "RPH": "1" } } ``` #### Schedule Displays the available schedules for the retrieved Tour Activity. ```xml theme={null} ``` ```json theme={null} { "Schedule": { "Summary": { "Start": "09:30:00", "Duration": "PT8H" } } } ``` #### TourActivityCategory Displays the category of the retrieved activity. See [Activity Codes](../glossary/codes#excursion-related-codes). ```xml theme={null} ``` ```json theme={null} { "TourActivityCategory": { "CategoryCode": "SE", "CategoryName": "Show Events", "TypeCode": "BP", "TypeName": "BaseProduct" } } ``` #### ProductInfo Shows short descriptions for each unit (`Code`). ```xml theme={null} Entrance fee, Dinner, Souvenir brochure (drinks not included) ``` ```json theme={null} { "ProductInfo": { "Code": "ST", "CodeDetail": "Standard Entrance", "Descriptions": { "MultimediaDescriptions": { "MultimediaDescription": [ { "TextItems": { "TextItem": { "Description": { "Language": "EN", "value": "Entrance fee, Dinner, Souvenir brochure (drinks not included)" } } } } ] } } } } ``` #### ServiceInfo Short description of the available service types. ```xml theme={null} ticket only ``` ```json theme={null} { "ServiceInfo": { "Code": "TIC", "CodeDetail": "ticket only", "DescriptiveText": "ticket only" } } ``` #### ZoneInfo Describes the zones where the Tour Activity operates. **RefPoints** Zone information. Can be used in Search and Avail messages. ```xml theme={null} ``` ```json theme={null} { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Lanzarote" }, { "Name": "Destination", "RefPointName": "Canarian Islands" }, { "Name": "Region", "RefPointName": "Lanzarote" }, { "Name": "Resort", "RefPointName": "Arrecife" } ] } } ``` **OperationTime** Description of the pick up and drop off points for the services that include transfer. ```xml theme={null} ``` ```json theme={null} { "OperationTime": { "SupplierProductCode": "TB000000", "PickupDropoff": [ { "LocationName": "AESACE5UIO", "OtherInfo": "OTHERS", "PickupInd": "true", "MeetingLocation": "OTHERS / Intercambiador BUSES - CABILDO", "DateTime": "08:00:00", "TimeOffset": "90", "Latitude": "28.96227", "Longitude": "-13.54585" }, { "LocationName": "AESACE5YBY", "OtherInfo": "OTHERS", "PickupInd": "true", "MeetingLocation": "OTHERS / Intercambiador BUSES - CABILDO", "DateTime": "08:00:00", "TimeOffset": "90", "Latitude": "28.958", "Longitude": "-13.55322" }, { "LocationName": "AESACE6N66", "OtherInfo": "OTHERS", "PickupInd": "true", "MeetingLocation": "OTHERS / Intercambiador BUSES - CABILDO", "DateTime": "08:00:00", "TimeOffset": "90" }, { "LocationName": "AESACE7EZG", "OtherInfo": "OTHERS", "PickupInd": "true", "MeetingLocation": "OTHERS / Intercambiador BUSES - CABILDO", "DateTime": "08:00:00", "TimeOffset": "90" }, { "LocationName": "AESACE8TDK", "OtherInfo": "OTHERS", "PickupInd": "true", "MeetingLocation": "OTHERS / Intercambiador BUSES - CABILDO", "DateTime": "08:00:00", "TimeOffset": "90", "Latitude": "28.95898", "Longitude": "-13.55373" }, { "LocationName": "AESACE97T0", "OtherInfo": "OTHERS", "PickupInd": "true", "MeetingLocation": "OTHERS / Intercambiador BUSES - CABILDO", "DateTime": "08:00:00", "TimeOffset": "90", "Latitude": "28.95512", "Longitude": "-13.58238" } ] } } ``` #### Descriptions Includes a long description in the requested language if available. ```xml theme={null} This long-running comedy variety show has been entertaining audiences for years with its unique blend of humor, music, and theatrical flair. Hosted in its original venue, the show features a talented cast performing lively dinner performances filled with laughter, music, and unforgettable parodies of iconic stars and films. It's a night of fun for all ages, promising non-stop entertainment, catchy tunes, and hilarious sketches that keep the audience engaged from start to finish. Even those who think this type of show isn’t for them often leave saying it was the highlight of their trip. Tickets typically include a three-course meal along with keepsakes to remember the evening. ``` ```json theme={null} { "Descriptions": { "DescriptiveText": "This long-running comedy variety show has been entertaining audiences for years with its unique blend of humor, music, and theatrical flair.\nHosted in its original venue, the show features a talented cast performing lively dinner performances filled with laughter, music, and unforgettable parodies of iconic stars and films.\nIt's a night of fun for all ages, promising non-stop entertainment, catchy tunes, and hilarious sketches that keep the audience engaged from start to finish.\nEven those who think this type of show isn’t for them often leave saying it was the highlight of their trip.\nTickets typically include a three-course meal along with keepsakes to remember the evening." } } ``` #### Position Geo location of the product. ```xml theme={null} ``` ```json theme={null} { "Position": { "Latitude": "30.0", "Longitude": "-15.0" } } ``` #### Services Shows different facts of the retrieved product. ```xml theme={null} Difficulty|Easy| Key Details|Instant Confirmation| ``` ```json theme={null} { "Service": [ { "CodeDetail": "EX_DIFFIC|EX_DIF_1", "DescriptiveText": "Difficulty|Easy|" }, { "CodeDetail": "EXCURSION|EX_ICONF", "DescriptiveText": "Key Details|Instant Confirmation|" } ] } ``` > [!NOTE] > > `Service@CodeDetail` encodes a hierarchy using line breaks (pipes in textual examples). Related values can appear under `Features/Feature@CodeDetail` with a `DescriptiveText` value. Duration windows may be modeled with `OperationSchedules/OperationSchedule`. #### MultimediaDescriptions See Hotel [Multimedia Descriptions](..//hotel/mappingRS#multimediadescriptions). #### ContactInfos See Hotel [Contact Infos](..//hotel/mappingRS#contactinfos). ## Complete example ```xml NBC Response expandable theme={null} Entrance fee, Dinner, Souvenir brochure (drinks not included) ticket only incl. pickUp & dropOff This long-running comedy variety show has been entertaining audiences for years with its unique blend of humor, music, and theatrical flair. Hosted in its original venue, the show features a talented cast performing lively dinner performances filled with laughter, music, and unforgettable parodies of iconic stars and films. It's a night of fun for all ages, promising non-stop entertainment, catchy tunes, and hilarious sketches that keep the audience engaged from start to finish. Even those who think this type of show isn’t for them often leave saying it was the highlight of their trip. Tickets typically include a three-course meal along with keepsakes to remember the evening. Difficulty|Easy| What`s included|Meals| Prices include a 3 course Dinner plus a Souvenir Photo & Program. What`s included|Other:| What`s included|Vegetarian Food| English Key Details|Languages spoken| What`s not included|Drinks| What`s not included|Hotel pickup and drop-off (optional)| Key Details|Printed Voucher accepted| Audience|Anybody| Theme|Entertainment| Experience the funniest night out in the Canary Islands! Fit for all ages! Highlights|Description|
Centro Commercial Playa Puerto del Carmen 35555 ES
fake_int@axisdata.net http://www.fakeaxis.com/
``` ```json NBC Response expandable theme={null} { "OTA_ProductDescriptiveInfoRS": { "Success": {}, "ProductDescriptiveContents": { "TourActivityDescriptiveContent": [ { "TourActivityInfo": { "Schedule": { "Summary": { "Start": "09:00:00", "Duration": "PT4H" } }, "CategoryCodes": { "TourActivityCategory": { "CategoryCode": "TT", "CategoryName": "Trips and Tours", "TypeCode": "BP", "TypeName": "BaseProduct" }, "ProductInfo": [ { "Code": "SS0HDBT0", "CodeDetail": "Sightseeing Tour (Halfday - Incl. Boat Trip)" } ], "ServiceInfo": [ { "DescriptiveText": "ticket only", "Code": "TIC", "CodeDetail": "ticket only" }, { "DescriptiveText": "incl. pickUp & dropOff", "Code": "TRF", "CodeDetail": "incl. pickUp & dropOff" } ], "ZoneInfo": [ { "SubZoneInfo": [ { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Mallorca" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Arenal" } ] }, "OperationTime": [ { "PickupDropoff": [ { "LocationName": "AESPMI5L4K", "OtherInfo": "HOTELENTRANCE", "PickupInd": true, "MeetingLocation": "HOTELENTRANCE / HotelEntrance", "DateTime": 25200000, "TimeOffset": 60, "Latitude": 39.50136, "Longitude": 2.75537 } ], "SupplierProductCode": "SS0HDBT0" } ], "Code": "0895AR" }, { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Mallorca" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Playa de Palma" } ] }, "OperationTime": [ { "PickupDropoff": [ { "LocationName": "AESPMI5L64", "PickupInd": true, "DateTime": 28800000, "TimeOffset": 0, "Latitude": 39.53601, "Longitude": 2.7117 } ], "SupplierProductCode": "SS0HDBT0" } ], "Code": "0930PL" } ], "Code": "A" }, { "SubZoneInfo": [ { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Mallorca" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Can Picafort" } ] }, "OperationTime": [ { "PickupDropoff": [ { "LocationName": "AESPMI5L4A", "OtherInfo": "HOTELENTRANCE", "PickupInd": true, "MeetingLocation": "HOTELENTRANCE / HotelEntrance", "DateTime": 26100000, "TimeOffset": 45, "Latitude": 39.76643, "Longitude": 3.15554 } ], "SupplierProductCode": "SS0HDBT0" } ], "Code": "0914CA" } ], "Code": "G" }, { "SubZoneInfo": [ { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Mallorca" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Costa de los Pinos" } ] }, "OperationTime": [ { "PickupDropoff": [ { "LocationName": "AESPMI5L46", "OtherInfo": "HOTELENTRANCE", "PickupInd": true, "MeetingLocation": "HOTELENTRANCE / HotelEntrance", "DateTime": 28200000, "TimeOffset": 10, "Latitude": 39.63897, "Longitude": 3.41551 } ], "SupplierProductCode": "SS0HDBT0" } ], "Code": "7308CO" } ], "Code": "I" }, { "SubZoneInfo": [ { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Mallorca" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Puigpunyent" } ] }, "OperationTime": [ { "PickupDropoff": [ { "LocationName": "AESPMI5L3Q", "OtherInfo": "HOTELENTRANCE", "PickupInd": true, "MeetingLocation": "HOTELENTRANCE / HotelEntrance", "DateTime": 23400000, "TimeOffset": 90, "Latitude": 2.55605, "Longitude": 39.60744 } ], "SupplierProductCode": "SS0HDBT0" } ], "Code": "4726PU" }, { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "TurismDestinationName", "RefPointName": "Mallorca" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Petra" } ] }, "OperationTime": [ { "PickupDropoff": [ { "LocationName": "AESPMI5L4M", "OtherInfo": "HOTELENTRANCE", "PickupInd": true, "MeetingLocation": "HOTELENTRANCE / HotelEntrance", "DateTime": 27000000, "TimeOffset": 30, "Latitude": 39.60201, "Longitude": 3.09446 } ], "SupplierProductCode": "SS0HDBT0" } ], "Code": "5116PE" } ], "Code": "M" } ] }, "Descriptions": { "DescriptiveText": [ "Welcome to an unforgettable dolphin sightseeing adventure along the beautiful coast of Mallorca. Step aboard a traditional Mallorcan boat and set sail across the crystal-clear waters of the Mediterranean Sea. As you cruise through the open sea, keep an eye out for wild dolphins swimming freely in their natural habitat, often playfully jumping alongside the boat. This unique excursion offers an incredible opportunity to observe these magnificent marine animals up close while enjoying breathtaking coastal views and the refreshing sea breeze. If conditions allow, you may also have the chance to take a refreshing swim in the clear waters, creating memories that will last a lifetime during this authentic Mallorcan experience." ] }, "Position": { "Latitude": "39.60469", "Longitude": "3.38801" }, "Services": { "Service": [ { "DescriptiveText": "Difficulty|Easy|", "CodeDetail": "EX_DIFFIC|EX_DIF_1" }, { "DescriptiveText": "Sustainable Conscious|Free of Plastics|", "CodeDetail": "EX_ENVIR|EX_E003" }, { "DescriptiveText": "Sustainable Conscious|Natural Conservation|", "CodeDetail": "EX_ENVIR|EX_E006" }, { "DescriptiveText": "What`s included|Drinks|", "CodeDetail": "EX_INCL|EX_INCL_DRINK" }, { "Features": { "Feature": [ { "DescriptiveText": "Free of Charge", "CodeDetail": "Charge Type:" } ] }, "DescriptiveText": "What`s included|Photos|", "CodeDetail": "EX_INCL|EX_INCL_PHOTOS" }, { "DescriptiveText": "What`s included|Guide|", "CodeDetail": "EX_INCL|EX_INCL_TG" }, { "Features": { "Feature": [ { "DescriptiveText": "English, German, French, Dutch, Spanish, Italian, Arabic, Russian, Turkish, Portuguese, Greek, Polish, Czech, Finnish, Swedish, Hungarian, Chinese, Danish, Japanese, Maltese, Hebrew, Norwegian, Bulgarian, Mandarin, Romanian, Slovenian, Slovak", "CodeDetail": "Languages:" } ] }, "DescriptiveText": "Key Details|Languages spoken|", "CodeDetail": "EXCURSION|EX_LANGSPOKEN" }, { "DescriptiveText": "What`s needed|Sun protection|", "CodeDetail": "EX_NEEDED|EX_NEEDED_SUB" }, { "DescriptiveText": "What`s needed|Swimsuit|", "CodeDetail": "EX_NEEDED|EX_NEEDED_SWIM" }, { "DescriptiveText": "What`s not included|Meals|", "CodeDetail": "EX_NOTINCL|EX_NOTINCL_FOOD" }, { "DescriptiveText": "Recommendations|Sunglasses|", "CodeDetail": "EX_RECCOM|EX_RECCOM_SUNG" }, { "DescriptiveText": "Restrictions|Not Smoking|", "CodeDetail": "EX_RESTR|EX_RESTR_NOTSMO" }, { "DescriptiveText": "Audience|Anybody|", "CodeDetail": "EX_TARGET|EX_TARGET_ALL" }, { "DescriptiveText": "Theme|Nature Lovers|", "CodeDetail": "EX_THEME|EX_THEME_NATURE" }, { "DescriptiveText": "Theme|Protected Wildlife|", "CodeDetail": "EX_THEME|EX_THEME_PROTECTED" } ] } }, "AreaInfo": { "RefPoints": { "RefPoint": [ { "Name": "Country", "RefPointName": "Spain" }, { "Name": "Destination", "RefPointName": "Balearic Islands" }, { "Name": "TurismDestination", "RefPointName": "Mallorca" }, { "Name": "Resort", "RefPointName": "Cala Millor" }, { "Name": "Region", "RefPointName": "Mallorca" }, { "Name": "TravelDestination", "RefPointName": "PMI" }, { "Latitude": "39.60469", "Longitude": "3.38801" } ] } }, "MultimediaDescriptions": { "MultimediaDescription": [ { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Width": 640, "Height": 360, "Format": "0", "FileName": "xespmi5l4u_209416_1.jpg", "DimensionCategory": "original", "Sort": 1, "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 113, "Format": "0", "FileName": "xespmi5l4u_209416_2.jpg", "DimensionCategory": "thumbnail", "Sort": 1, "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 253, "Format": "0", "FileName": "xespmi5l4u_209416_3.jpg", "DimensionCategory": "display", "Sort": 1, "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209416_4.jpg", "DimensionCategory": "print", "Sort": 1, "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209416_5.jpg", "DimensionCategory": "print_lead", "Sort": 1, "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "TT-MISC", "LastModifyDateTime": "2026-09-21T14:12:02" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 1920, "Height": 1280, "Format": "0", "FileName": "xespmi5l4u_209418_1.jpg", "DimensionCategory": "original", "Sort": 2, "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "0", "FileName": "xespmi5l4u_209418_2.jpg", "DimensionCategory": "thumbnail", "Sort": 2, "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "0", "FileName": "xespmi5l4u_209418_3.jpg", "DimensionCategory": "display", "Sort": 2, "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 800, "Format": "0", "FileName": "xespmi5l4u_209418_4.jpg", "DimensionCategory": "print", "Sort": 2, "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209418_5.jpg", "DimensionCategory": "print_lead", "Sort": 2, "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "TT-MISC", "LastModifyDateTime": "2026-09-21T14:12:02" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 1920, "Height": 1280, "Format": "0", "FileName": "xespmi5l4u_209414_1.jpg", "DimensionCategory": "original", "Sort": 3, "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "0", "FileName": "xespmi5l4u_209414_2.jpg", "DimensionCategory": "thumbnail", "Sort": 3, "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "0", "FileName": "xespmi5l4u_209414_3.jpg", "DimensionCategory": "display", "Sort": 3, "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 800, "Format": "0", "FileName": "xespmi5l4u_209414_4.jpg", "DimensionCategory": "print", "Sort": 3, "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209414_5.jpg", "DimensionCategory": "print_lead", "Sort": 3, "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "TT-MISC", "LastModifyDateTime": "2026-09-21T14:12:02" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 1920, "Height": 1280, "Format": "0", "FileName": "xespmi5l4u_209420_1.jpg", "DimensionCategory": "original", "Sort": 4, "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "0", "FileName": "xespmi5l4u_209420_2.jpg", "DimensionCategory": "thumbnail", "Sort": 4, "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "0", "FileName": "xespmi5l4u_209420_3.jpg", "DimensionCategory": "display", "Sort": 4, "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 800, "Format": "0", "FileName": "xespmi5l4u_209420_4.jpg", "DimensionCategory": "print", "Sort": 4, "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209420_5.jpg", "DimensionCategory": "print_lead", "Sort": 4, "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "TT-MISC", "LastModifyDateTime": "2026-09-21T14:12:02" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 2199, "Height": 1467, "Format": "0", "FileName": "xespmi5l4u_209422_1.jpg", "DimensionCategory": "original", "Sort": 5, "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "0", "FileName": "xespmi5l4u_209422_2.jpg", "DimensionCategory": "thumbnail", "Sort": 5, "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "0", "FileName": "xespmi5l4u_209422_3.jpg", "DimensionCategory": "display", "Sort": 5, "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 801, "Format": "0", "FileName": "xespmi5l4u_209422_4.jpg", "DimensionCategory": "print", "Sort": 5, "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209422_5.jpg", "DimensionCategory": "print_lead", "Sort": 5, "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "TT-MISC", "LastModifyDateTime": "2026-09-21T14:12:02" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 2048, "Height": 1367, "Format": "0", "FileName": "xespmi5l4u_209424_1.jpg", "DimensionCategory": "original", "Sort": 6, "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "0", "FileName": "xespmi5l4u_209424_2.jpg", "DimensionCategory": "thumbnail", "Sort": 6, "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "0", "FileName": "xespmi5l4u_209424_3.jpg", "DimensionCategory": "display", "Sort": 6, "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 801, "Format": "0", "FileName": "xespmi5l4u_209424_4.jpg", "DimensionCategory": "print", "Sort": 6, "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Format": "0", "FileName": "xespmi5l4u_209424_5.jpg", "DimensionCategory": "print_lead", "Sort": 6, "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "TT-MISC", "LastModifyDateTime": "2026-09-21T14:12:03" } ] } } ] }, "ContactInfos": { "ContactInfo": [ { "Addresses": { "Address": [ { "AddressLine": [ "Paseo Del Mar 60" ], "CityName": "Cala Millor", "PostalCode": "07558", "CountryName": { "value": "ES" } } ] }, "Phones": { "Phone": [ { "PhoneTechType": "1", "PhoneNumber": "656454545" } ] }, "Emails": { "Email": [ { "value": "dolphins@tourscm.es" } ] }, "URLs": { "URL": [ { "value": "www.tourscm.es", "Type": "Web" } ] } } ] }, "TourActivityID": "XESPMI5L4U", "TourActivityName": "Dolphin Sightseeing", "RPH": "1" } ] }, "Version": 2016.2, "TransactionIdentifier": "1-1/1" } } ``` ## Best Practices 1. Treat `TourActivityID` as the **stable key** for excursion mapping. 2. Use `ProductInfo/@Code` and `ServiceInfo/@Code` to build your **SKU axes**; validate availability via incoming NBC rate plan notifications. 3. If multiple `TourActivityDescriptiveInfo` blocks are present, index on `RPH` and `TourActivityID` for deterministic merges. # OTA_TourActivitySearchRQ Source: https://docs.axisdata.net/excursion/searchXARQ > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_TourActivity API call](/api-reference/endpoint/excursion/search) > > Skip & Hit the Playground. ## Search VS Avail To get activities from the system we have 2 message-types: ### OTA\_TourActivitySearchRQ This is a search request message used to: * Find available tour and activity products based on search criteria. * Query what tours/activities are offered in a destination. * Filter by location, dates, activity types, price ranges, etc. * Get a broad list of matching products. * Get NBC data for the matching products. * Get "best scenario" cheapest price for the matching products. Think of it as the initial discovery phase - "What tours are available in Rome next week?" ### OTA\_TourActivityAvailRQ This is an availability request message used to: * Check specific availability for a particular tour or activity. * Get detailed pricing, time slots, and capacity for a known product. * Verify real-time availability before booking. * Retrieve detailed schedules and options for a specific offering. Think of it as the detailed inquiry phase - "Is the Colosseum tour available at 2 PM on Tuesday for 4 people, and how much does it cost?" Key Difference Search = "Show me what exists" (broader, exploratory). Availability = "Tell me if this specific thing is available" (narrower, transactional). In a typical booking flow, you'd use SearchRQ first to find options, then AvailRQ to check specific details before making a booking with OTA\_TourActivityBookRQ. ## Purpose The **OTA\_TourActivitySearchRQ** message is used to perform general search queries for tours and activities. Unlike OTA\_TourActivityAvailRQ which focuses on availability for specific dates and participants, this message is designed for broader discovery searches, allowing users to browse and explore tour and activity options based on various criteria without necessarily committing to specific dates or participant counts. ## Structure - Root Element ```xml theme={null} ``` ```json theme={null} { "OTA_TourActivitySearchRQ": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2011.2", "PrimaryLangID": "EN" } } ``` | Attribute | Type | Required | Description | | :- | :- | :- | :- | | `Version` | String | Yes | Schema version being used | | `xmlns` | String | Yes | "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)" | | `TimeStamp` | DateTime | No | Creation timestamp of the message | | `PrimaryLangID` | String | No | Primary language code (ISO 639) | | `EchoToken` | String | No | Reference for asynchronous transactions | | `MaxResponses` | Integer | No | Maximum number of results to return | ## Structure - Core Elements ### POS (Point of Sale) Identifies the party or connection making the request. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID": "TEST", "ID_Context": "AxisData", "Type": "22" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` Identifies the requesting party and contains credentials. Check [Access to our Systems](../authentication/access#partner-identification). ### SearchCriteria The core element containing all search parameters. ```xml theme={null} AESPMI5L46 XESPMI5L4U ``` ```json theme={null} { "SearchCriteria": { "DateTimePref": { "Start": "2027-07-17", "End": "2027-07-24" }, "LocationPref": [ { "Context": "Source", "Region": { "RegionCode": "HotelCode", "value": "AESPMI5L46" } }, { "Context": "Service", "Region": { "RegionCode": "Product", "value": "XESPMI5L4U" } } ], "OtherPref": { "SpokenLanguage": { "Code": "EN" } } } } ``` #### DateTimePref Specifies the date range for the excursion search (max 28 days). Duration can optionally be included. ```xml theme={null} ``` ```json theme={null} { "DateTimePref": { "Start": "2027-03-01", "End": "2027-03-15", "Duration": "P6h" } } ``` #### LocationPref * Two contexts: `Context="Source"` (guest origin/pick-up base) and `Context="Service"` (where the activity runs). * Use one location type per context: Areas (`Country` → `Region` → `Resort`), `HotelCode`, `GIATA`, `Product`, or geocode via `Position`. * When using areas, always include `Country`. > [!NOTE] > > * Source locations allowed: Area (Country, Region, Resort), GIATA code, Hotel Code or Geo Location. > * Destination locations allowed: Area (Country, Region, Resort), TourActivity Code. ```xml theme={null} AESPMI5L46 ``` ```json theme={null} { "LocationPref": { "Context": "Source", "Region": { "RegionCode": "HotelCode", "value": "AESPMI5L46" } } } ``` #### OtherPref Defines in this case spoken language preferences. ```xml theme={null} ``` ```json theme={null} { "OtherPref": { "SpokenLanguage": { "Code": "EN" } } } ``` #### CategoryTypePref (optional) Optional section to filter by excursion categories. ```xml theme={null} Ticket Adventure ``` ```json theme={null} { "CategoryTypePref": { "Category": "Ticket", "Type": "Adventure" } } ``` ## Complete Examples > [tab] Search by Region > > ```xml expandable theme={null} > > > > > > > > > > > > > AESPMI5L46 > > > Spain > Lanzarote > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_TourActivitySearchRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "SearchCriteria" : { > "DateTimePref" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "LocationPref" : [ { > "Region" : [ { > "value" : "AESPMI5L46", > "RegionCode" : "HotelCode" > } ], > "Context" : "Source" > }, { > "Region" : [ { > "value" : "Spain", > "RegionCode" : "Country" > }, { > "value" : "Lanzarote", > "RegionCode" : "Region" > } ], > "Context" : "Service" > } ], > "OtherPref" : { > "SpokenLanguage" : [ { > "Code" : "EN" > } ] > } > }, > "Version" : 2011.2, > "PrimaryLangID" : "EN" > } > } > ``` > [tab] Search by Product > > ```xml expandable theme={null} > > > > > > > > > > > > > AESPMI5L46 > > > XESPMI5L4U > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_TourActivitySearchRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "SearchCriteria" : { > "DateTimePref" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "LocationPref" : [ { > "Region" : [ { > "value" : "AESPMI5L46", > "RegionCode" : "HotelCode" > } ], > "Context" : "Source" > }, { > "Region" : [ { > "value" : "XESPMI5L4U", > "RegionCode" : "Product" > } ], > "Context" : "Service" > } ], > "OtherPref" : { > "SpokenLanguage" : [ { > "Code" : "EN" > } ] > } > }, > "Version" : 2011.2, > "PrimaryLangID" : "EN" > } > } > ``` ## Best Practices 1. **Always include EchoToken** - Essential for matching requests with responses. 2. **Validate regions** - Confirm region names before sending requests. 3. **Be Specific**: Include as many relevant search criteria as possible to get accurate results. 4. **Date Ranges**: Use reasonable date ranges to avoid overwhelming results. 5. **Participant Details**: Always specify participant counts and age categories for accurate pricing. 6. **MaxResponses**: Set appropriate limits to manage result sets. 7. **Language**: Specify PrimaryLangID to receive results in the desired language. 8. **Time Zones**: Be aware that timestamps should include timezone information. 9. **Error Handling**: Implement proper error handling for the response messages. ## Playground > [card] [OTA\_TourActivity API call](/api-reference/endpoint/excursion/search) > > Hit the Playground. > [!TIP] > > Use the desired request at the playground and receive responses from our test environment API! # OTA_TourActivitySearchRS Source: https://docs.axisdata.net/excursion/searchXARS An OTA Tour Activity **Search Response** message listing tour/excursion services for the requested area. It may include high‑level product metadata (ID, schedule, category, description, location, policies) and, where provided by the contract, indicative pricing. > [!TIP] > > SearchRS returns **catalog data** for services in scope. Use AvailRS for date/option‑level availability & final pricing. ## Purpose This message is used to: * Return the catalog of **tour activities** matching the requested location(s). * Provide **service identifiers** used later in Avail and Book flows. * Convey **descriptions, categories, locations**, and **policies** (cancellation, participant rules). * Optionally include **expected/indicative rates** for reference. ## Structure – Root Element ```xml theme={null} ``` ```json theme={null} "OTA_TourActivitySearchRS" ``` **Key Attributes:** * `Version`: OTA messaging pack version (e.g., `2016.b`) * `xmlns`: `http://www.opentravel.org/OTA/2003/05` ## Structure – Core Elements ### TourActivityInfo Repeating container of returned services. #### BasicInfo SpecifieS the service identifiers. ```xml theme={null} ``` ```json theme={null} { "BasicInfo": { "SupplierProductCode": "TE0GV003", "Name": "Exclusive Visit to Las Salinas de Janubio", "ShortName": "Entrance (Guided visit - 3) - ticket only", "TourActivityID": "XESPMI5L4U", "SupplierServiceCode": "TIC" } } ``` * `SupplierProductCode`: Specifies which product(unit) of a stock is being described. * `Name`: Full name of the tour. * `ShortName`: Name of the product. * `TourActivityID`: MTS activity code. * `SupplierServiceCode`: Type of service. #### Schedule Availability window for the **service**. ```xml theme={null} ``` ```json theme={null} { "Schedule": { "Summary": { "Start": "2026-07-17", "End": "2026-07-17" } } } ``` #### CategoryAndType Indicates the excursoin **type** and **category**. Later in the avail request, these can be used to filter out responses. ```xml theme={null} ``` ```json theme={null} { "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } } } ``` #### Description Shows main NBC content of the product: * Short and long descriptions of the activity. * `Multimedia` with images of the activity. For more details, see [MultimediaDescription](../hotel/mappingRS#multimediadescriptions). * `TextItems` describes different facts of the activity. See [Complete Examples](#complete-examples). #### Location Location of the activity. Consists of: * `Address`. * `Region` hierarchy. * `Position` (geo codes). ```xml theme={null}
Centro Commercial Playa Puerto del Carmen 35555 ES Lanzarote
Spain Canarian Islands Lanzarote Puerto del Carmen ACE
``` ```json theme={null} { "Location": { "Address": { "AddressLine": "Centro Commercial Playa", "CityName": "Puerto del Carmen", "PostalCode": "35555", "Country": "ES", "StateProv": "Lanzarote" }, "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Canarian Islands" }, { "RegionCode": "Region", "value": "Lanzarote" }, { "RegionCode": "Resort", "value": "Puerto del Carmen" }, { "RegionCode": "TravelDestination", "value": "ACE" } ], "Position": { "Latitude": "30.0", "Longitude": "-15.0" } } } ``` #### PickupDropoff The response includes all the operation times, duration of the service and pickup times. The attribute PickupInd="true" indicates if the location and date time corresponds to the pickup (true) or dropoff (false). ```xml theme={null} ``` ```json theme={null} { "PickupDropoff": { "LocationName": "AESACE5UIO", "PickupInd": "true", "DateTime": "2026-07-17", "Schedule": { "OperationTimes": { "OperationTime": { "Start": "2026-07-17", "End": "2026-07-17" } } } } } ``` #### Policies May include: * `CancelPolicy`: Cancellation policy of the tour, similar structure as hotel cancel policies. * `Participant`: Participant rules. #### Pricing Returns the cheapest possible price for the tour and it's type. ```xml theme={null} PerPerson ``` ```json theme={null} { "Pricing": { "MinPrice": "75.00", "CurrencyCode": "EUR", "PricingType": "PerPerson" } } ``` ## Complete Examples ```xml Basic Response expandable theme={null} Music Show This long-running comedy variety show has been entertaining audiences for years with its unique blend of humor, music, and theatrical flair. Hosted in its original venue, the show features a talented cast performing lively dinner performances filled with laughter, music, and unforgettable parodies of iconic stars and films. It's a night of fun for all ages, promising non-stop entertainment, catchy tunes, and hilarious sketches that keep the audience engaged from start to finish. Even those who think this type of show isn’t for them often leave saying it was the highlight of their trip. Tickets typically include a three-course meal along with keepsakes to remember the evening. Easy Meals Prices include a 3 course Dinner plus a Souvenir Photo & Program. Vegetarian Food English Drinks Hotel pickup and drop-off (optional) Printed Voucher accepted Anybody Entertainment Experience the funniest night out in the Canary Islands! Fit for all ages!
Centro Commercial Playa Puerto del Carmen 35555 ES Lanzarote
Spain Canarian Islands Lanzarote Puerto del Carmen ACE
PerPerson ``` ```json Basic Response expandable theme={null} { "OTA_TourActivitySearchRS": { "Success": {}, "TourActivityInfo": [ { "BasicInfo": { "SupplierProductCode": "SS0HDBT0", "Name": "Dolphin Sightseeing", "ShortName": "Sightseeing Tour (Halfday - Incl. Boat Trip) - ticket only", "TourActivityID": "XESPMI5L4U", "SupplierServiceCode": "TIC" }, "Schedule": { "Summary": { "Start": "2027-07-17T09:00:00", "Duration": "PT4H", "End": "2027-07-17T13:00:00" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": [ { "Code": "TT" } ] }, "Description": { "ShortDescription": "Dolphin Sightseeing", "LongDescription": "Welcome to an unforgettable dolphin sightseeing adventure along the beautiful coast of Mallorca. Step aboard a traditional Mallorcan boat and set sail across the crystal-clear waters of the Mediterranean Sea. As you cruise through the open sea, keep an eye out for wild dolphins swimming freely in their natural habitat, often playfully jumping alongside the boat. This unique excursion offers an incredible opportunity to observe these magnificent marine animals up close while enjoying breathtaking coastal views and the refreshing sea breeze. If conditions allow, you may also have the chance to take a refreshing swim in the clear waters, creating memories that will last a lifetime during this authentic Mallorcan experience.", "Multimedia": { "MultimediaDescription": [ { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Width": 640, "Height": 360, "Format": "6", "FileName": "XESPMI5L4U_209416.jpg", "DimensionCategory": "original", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 113, "Format": "6", "FileName": "XESPMI5L4U_209416.jpg", "DimensionCategory": "thumbnail", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209416.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 253, "Format": "6", "FileName": "XESPMI5L4U_209416.jpg", "DimensionCategory": "display", "Title": "Miscellaneous", "RecordID": "3" } ], "Category": "TT-MISC", "ID": "1" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 1920, "Height": 1280, "Format": "6", "FileName": "XESPMI5L4U_209418.jpg", "DimensionCategory": "original", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "6", "FileName": "XESPMI5L4U_209418.jpg", "DimensionCategory": "thumbnail", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "6", "FileName": "XESPMI5L4U_209418.jpg", "DimensionCategory": "display", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209418.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 800, "Format": "6", "FileName": "XESPMI5L4U_209418.jpg", "DimensionCategory": "print", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "TT-MISC", "ID": "2" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 1920, "Height": 1280, "Format": "6", "FileName": "XESPMI5L4U_209414.jpg", "DimensionCategory": "original", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "6", "FileName": "XESPMI5L4U_209414.jpg", "DimensionCategory": "thumbnail", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "6", "FileName": "XESPMI5L4U_209414.jpg", "DimensionCategory": "display", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209414.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 800, "Format": "6", "FileName": "XESPMI5L4U_209414.jpg", "DimensionCategory": "print", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "TT-MISC", "ID": "3" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 1920, "Height": 1280, "Format": "6", "FileName": "XESPMI5L4U_209420.jpg", "DimensionCategory": "original", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "6", "FileName": "XESPMI5L4U_209420.jpg", "DimensionCategory": "thumbnail", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "6", "FileName": "XESPMI5L4U_209420.jpg", "DimensionCategory": "display", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209420.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 800, "Format": "6", "FileName": "XESPMI5L4U_209420.jpg", "DimensionCategory": "print", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "TT-MISC", "ID": "4" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 2199, "Height": 1467, "Format": "6", "FileName": "XESPMI5L4U_209422.jpg", "DimensionCategory": "original", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "6", "FileName": "XESPMI5L4U_209422.jpg", "DimensionCategory": "thumbnail", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "6", "FileName": "XESPMI5L4U_209422.jpg", "DimensionCategory": "display", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209422.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 801, "Format": "6", "FileName": "XESPMI5L4U_209422.jpg", "DimensionCategory": "print", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "TT-MISC", "ID": "5" }, { "ImageFormat": [ { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 2048, "Height": 1367, "Format": "6", "FileName": "XESPMI5L4U_209424.jpg", "DimensionCategory": "original", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 200, "Height": 133, "Format": "6", "FileName": "XESPMI5L4U_209424.jpg", "DimensionCategory": "thumbnail", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 450, "Height": 300, "Format": "6", "FileName": "XESPMI5L4U_209424.jpg", "DimensionCategory": "display", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESPMI5L4U_209424.jpg", "UnitOfMeasureCode": "9", "Width": 1200, "Height": 801, "Format": "6", "FileName": "XESPMI5L4U_209424.jpg", "DimensionCategory": "print", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "TT-MISC", "ID": "6" } ] }, "TextItems": { "TextItem": [ { "Description": [ { "value": "Easy" } ], "Category": "EX_DIFFIC", "SourceID": "EX_DIF_1" }, { "Description": [ { "value": "Free of Plastics" } ], "Category": "EX_ENVIR", "SourceID": "EX_E003" }, { "Description": [ { "value": "Natural Conservation" } ], "Category": "EX_ENVIR", "SourceID": "EX_E006" }, { "Description": [ { "value": "Drinks" } ], "Category": "EX_INCL", "SourceID": "EX_INCL_DRINK" }, { "Description": [ { "value": "Free of Charge" } ], "Category": "EX_INCL", "SourceID": "EX_INCL_PHOTOS" }, { "Description": [ { "value": "Guide" } ], "Category": "EX_INCL", "SourceID": "EX_INCL_TG" }, { "Description": [ { "value": "English, German, French, Dutch, Spanish, Italian, Arabic, Russian, Turkish, Portuguese, Greek, Polish, Czech, Finnish, Swedish, Hungarian, Chinese, Danish, Japanese, Maltese, Hebrew, Norwegian, Bulgarian, Mandarin, Romanian, Slovenian, Slovak" } ], "Category": "EXCURSION", "SourceID": "EX_LANGSPOKEN" }, { "Description": [ { "value": "Sun protection" } ], "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SUB" }, { "Description": [ { "value": "Swimsuit" } ], "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SWIM" }, { "Description": [ { "value": "Meals" } ], "Category": "EX_NOTINCL", "SourceID": "EX_NOTINCL_FOOD" }, { "Description": [ { "value": "Sunglasses" } ], "Category": "EX_RECCOM", "SourceID": "EX_RECCOM_SUNG" }, { "Description": [ { "value": "Not Smoking" } ], "Category": "EX_RESTR", "SourceID": "EX_RESTR_NOTSMO" }, { "Description": [ { "value": "Anybody" } ], "Category": "EX_TARGET", "SourceID": "EX_TARGET_ALL" }, { "Description": [ { "value": "Nature Lovers" } ], "Category": "EX_THEME", "SourceID": "EX_THEME_NATURE" }, { "Description": [ { "value": "Protected Wildlife" } ], "Category": "EX_THEME", "SourceID": "EX_THEME_PROTECTED" } ] } } ] } }, "Location": { "Address": { "AddressLine": [ "Paseo Del Mar 60" ], "CityName": "Cala Millor", "PostalCode": "07558", "Country": "ES", "StateProv": { "value": "Baleares" } }, "Region": [ { "value": "Spain", "RegionCode": "Country" }, { "value": "Balearic Islands", "RegionCode": "Destination" }, { "value": "Mallorca", "RegionCode": "Region" }, { "value": "Cala Millor", "RegionCode": "Resort" }, { "value": "PMI", "RegionCode": "TravelDestination" } ], "Position": { "Latitude": "39.60469", "Longitude": "3.38801" } }, "PickupDropoff": [ { "Schedule": { "OperationTimes": { "OperationTime": [ { "Start": "2027-07-17", "End": "2027-07-17" } ] }, "Duration": "PT4H" }, "LocationName": "AESPMI5L4K", "PickupInd": true, "OtherInfo": "HOTELENTRANCE / HotelEntrance", "DateTime": "2027-07-17T08:00:00" }, { "Schedule": { "OperationTimes": { "OperationTime": [ { "Start": "2027-07-17", "End": "2027-07-17" } ] }, "Duration": "PT4H" }, "LocationName": "AESPMI5L64", "PickupInd": true, "DateTime": "2027-07-17T09:00:00" }, { "Schedule": { "OperationTimes": { "OperationTime": [ { "Start": "2027-07-17", "End": "2027-07-17" } ] }, "Duration": "PT4H" }, "LocationName": "AESPMI5L4A", "PickupInd": true, "OtherInfo": "HOTELENTRANCE / HotelEntrance", "DateTime": "2027-07-17T08:15:00" }, { "Schedule": { "OperationTimes": { "OperationTime": [ { "Start": "2027-07-17", "End": "2027-07-17" } ] }, "Duration": "PT4H" }, "LocationName": "AESPMI5L46", "PickupInd": true, "OtherInfo": "HOTELENTRANCE / HotelEntrance", "DateTime": "2027-07-17T08:50:00" }, { "Schedule": { "OperationTimes": { "OperationTime": [ { "Start": "2027-07-17", "End": "2027-07-17" } ] }, "Duration": "PT4H" }, "LocationName": "AESPMI5L3Q", "PickupInd": true, "OtherInfo": "HOTELENTRANCE / HotelEntrance", "DateTime": "2027-07-17T07:30:00" }, { "Schedule": { "OperationTimes": { "OperationTime": [ { "Start": "2027-07-17", "End": "2027-07-17" } ] }, "Duration": "PT4H" }, "LocationName": "AESPMI5L4M", "PickupInd": true, "OtherInfo": "HOTELENTRANCE / HotelEntrance", "DateTime": "2027-07-17T08:30:00" } ], "Policies": { "Participant": { "MinParticipants": 1, "MaxParticipants": 99 } }, "Pricing": { "PricingType": { "value": "PerPerson" }, "MinPrice": 45.90, "CurrencyCode": "EUR" } } ] } } ``` ## Best Practices 1. Expect **empty lists** when no services match the request; this is not an error. 2. Treat any `Pricing` in SearchRS as **reference only**; fetch final pricing with AvailRS before quoting. 3. Persist `TourActivityID` and any supplier codes for efficient follow‑up calls. 4. Honor **participant limits** and cancellation rules surfaced in `Policies` when building UI constraints. # Main Flow Source: https://docs.axisdata.net/general/flow Description of the main flow used from mapping, to search, to booking. ## Mapping Codes Process of aligning supplier's codes (rooms, transfer types, offers, etc.) into internal codes. * [Get our codes](/glossary/codes) ## Mapping NBC Process of aligning external hotel non bookable content with internal systems. This is typically done with: * **OTA\_HotelDescriptiveInfoRQ**\ Used to retrieve hotel descriptions, images, amenities, and other metadata necessary for mapping hotel content. *** ## Searching Involves checking room availability and pricing for a given hotel and date range. This is handled through: * **OTA\_HotelAvailRQ**\ Used to request availability and pricing information for hotels. *** ## Booking Booking a hotel room is a two-step process involving **quoting** and **committing**, both handled through the **OTA\_HotelResRQ** message. ### Quoting Used to validate that the selected room is still available at the displayed price and conditions. This step ensures: * The room hasn't been sold out. * The price hasn't changed. * The cancellation and payment policies are still valid. This is a **non-binding** operation and does not create a reservation yet. It’s often used to show final details to the user before confirming the booking. ### Committing Once the user confirms the booking, committing finalizes the reservation. This step: * Creates the actual booking in the supplier’s system. * Returns a confirmation number and booking details. Both quoting and committing use the **OTA\_HotelResRQ** message, but with different intent flags or parameters to distinguish between the two stages. *** ## Cancelling Cancelling a booking involves both **quoting** and **committing** stages. **OTA\_CancelRQ** used to: * Quote cancellation terms. * Commit the cancellation of a booking. **Cancellation Scope** * Supports **full** and **partial** cancellations. * Applies to **any service** booked via the XML interface. **Cancellation Fees** * May apply if: * A **non-refundable room** was booked. * A **cancellation policy** is in effect. *** # Transfer Transfers involve only **searching**, **booking** and **cancellation**, it does not have NBC. Only codes need to be mapped: * **Searching**: Check availability and pricing for transfer services. * **Booking**: Quote and commit the transfer service. * **Cancelling**: Quote and commit the cancellation. *** # Excursion Excursions follow the same flow as hotels: * **Mapping**: Align excursion content. * **Searching**: Check availability and pricing. * **Booking**: Quote and commit the booking. * **Cancelling**: Quote and commit the cancellation. # General Messaging Source: https://docs.axisdata.net/general/messaging Complete summary of all general real-time messaging concepts. Check this section and implement the needed features. ## **Languages** A language may be specified for any descriptive texts returned in real-time responses. Supported across NBC, Hotel, Transfer, and Excursion messaging. ```xml Example for German theme={null} ``` ```json Example for German theme={null} { "OTA_HotelDescriptiveInfoRQ": { "PrimaryLangID": "DE", "AltLangID": "EN" }, "OTA_HotelAvailRQ": { "PrimaryLangID": "DE", "AltLangID": "EN" }, "OTA_GroundAvailRQ": { "PrimaryLangID": "DE", "AltLangID": "EN" }, "OTA_TourActivitySearchRQ": { "PrimaryLangID": "DE", "AltLangID": "EN" } } ``` * If `PrimaryLangID` is not specified, default is `'EN'`. * If `AltLangID` is not specified, default is `'EN'`. * If description for `PrimaryLangID` exists, it is used; otherwise `AltLangID` is used. * If neither exists, no description is returned. **Language Coverage (ISO 639-1):** * **Hotel Main Description**: CS, DA, DE, EN, ES, FI, FR, HU, IT, NB, NL, NO, PL, PT, SV, RU, TR, IS, CZ, ZH * **Room Descriptions**: DE, DA, EN, ES, FI, FR, HU, IT, NL, NO, PL, PT, SV, RU, TR * **Facts**: EN *** ## **Currencies** Your `ClientID` can be configured to deliver prices in a single currency or in the original currency of the agreement with the provider. **Supported Currencies (ISO 4217):** EUR, USD, AED, BGN, BRL, CAD, CHF, CVE, DKK, DOP, EGP, GBP, HRK, MAD, MXN **Currency Settings** Each `RequestorID` can have one of two currency settings: * **Selling Currency:** Prices are converted to a fixed currency (e.g., EUR). * **Contract Currency = Client Currency:** No conversion; partner handles it. > [!NOTE] > > OTA response (`OTA_HotelAvailRS`) may contain mixed currencies. *** ## **InSeries** For synchronous (less than 5 seconds) processing of multiple commits (e.g., hotel + transfer), include `TransactionStatusCode="InSeries"` in the root element of every message. This property enables a synchronous processing of the message, so it is necessary to wait until the response before sending a related commit message. ```xml Example theme={null} ``` ```json Example theme={null} { "OTA_HotelResRQ": { "EchoToken": "1", "ResStatus": "Commit", "Version": "2016.2", "TransactionStatusCode": "InSeries" } } ``` > [!WARNING] > > This delays the response (aprox. 1 second) until the booking is saved and ready for the next step. Only valid for `Commit` messages. *** ## **Master and Child References** This functionality improves booking management and packaging services at the booking level. Each booking includes: * **One Master Reference** (Super PNR) * **Multiple Child References** (one per booking item) **Master Reference** * **Purpose**: Represents the entire booking and packages all items (e.g., hotel, transfer, excursion). * **Impact**: Actions on the master reference affect all items (e.g., retrieve, cancel). ```xml Identification theme={null} ``` ```json Identification theme={null} { "UniqueID": { "Type": "36", "ID_Context": "Client", "ID": "AAA" } } ``` **Child Reference** * **Purpose**: Represents individual booking items (e.g., a room or a transfer). * **Relation**: Linked to items using `RPH` values. ```xml Identification theme={null} ``` ```json Identification theme={null} { "UniqueID": { "Type": "37", "ID_Context": "Client", "ID": "aaa1" } } ``` **Example: Hotel Booking with 2 Rooms** ```xml Request (OTA_HotelResRQ) theme={null} ... ... ``` ```json Request (OTA_HotelResRQ) theme={null} { "RoomStay": [ { "RPH": "1" }, { "RPH": "2" } ], "HotelReservationID": [ { "ResID_SourceContext": "Client", "ResID_Type": "36", "ResID_Value": "AAA" }, { "ResID_SourceContext": "Client", "ResID_Type": "37", "ResID_Value": "aaa1", "Item_RPH": "1" }, { "ResID_SourceContext": "Client", "ResID_Type": "37", "ResID_Value": "aaa2", "Item_RPH": "2" } ] } ``` ```xml Response (OTA_HotelResRS) theme={null} ``` ```json Response (OTA_HotelResRS) theme={null} { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "AAA" }, { "Type": "36", "ID_Context": "Internal", "ID": "TK1234567890" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa1" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1234" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa2" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1235" } ] } ``` **Example: Transfer Booking** ```xml Request (OTA_GroundBookRQ) theme={null} ... ... ``` ```json Request (OTA_GroundBookRQ) theme={null} { "Location": [ { "RPH": "1" }, { "RPH": "2" } ], "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "AAA" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa3", "Item_RPH": "1" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa4", "Item_RPH": "2" } ] } ``` ```xml Response (OTA_GroundBookRS) theme={null} ``` ```json Response (OTA_GroundBookRS) theme={null} { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "AAA" }, { "Type": "36", "ID_Context": "Internal", "ID": "TK1234567890" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa3" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1236" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa4" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1237" } ] } ``` **Booking Retrieval** ```xml Request (OTA_ReadRQ) theme={null} ``` ```json Request (OTA_ReadRQ) theme={null} { "UniqueID": { "Type": "36", "ID_Context": "Client", "ID": "AAA" } } ``` ```xml Response (OTA_ResRetrieveRS) theme={null} ``` ```json Response (OTA_ResRetrieveRS) theme={null} { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "AAA" }, { "Type": "36", "ID_Context": "Internal", "ID": "TK1234567890" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa1" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1234" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa2" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1235" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa3" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1236" }, { "Type": "37", "ID_Context": "Client", "ID": "aaa4" }, { "Type": "37", "ID_Context": "Internal", "ID": "1234_1237" } ] } ``` **Rules and Constraints** * Duplicate child references for the same master reference will result in an error. * If only a master reference is provided, child references will be auto-generated and returned in the response. * RPH values must be unique across different message types within the same booking. * Reference ID Length: Max 20 characters (not 64 as per OTA). * Allowed Characters: * Digits: `0–9` * Letters: `A–Z` * Symbols: `~`, `-` (non-HTTP/XML restricted) *** ## **Non-Refundable Rooms** Rooms with 100% cancellation penalty from the moment of booking. **Identification:** * Room code includes promo code `N` * Description includes “Non-Refundable” * DRV code includes `AT04-NRF` > [!TIP] > > It is recommended to identify these rooms via the room code (Promo code N) ```xml Example theme={null} Room_Standard/Non-Refundable ``` ```json Example theme={null} { "RoomType": { "RoomTypeCode": "RMSD00000N", "RoomDescription": { "Text": [ { "Language": "EN", "value": "Room_Standard/Non-Refundable" } ] } } } ``` > [!NOTE] > > Semi-non-refundable rooms may include grace periods and use `OffsetDropTime="AfterBooking"`. *** ## **Vendor Messages** Important room-specific information in responses. This information shall be processed and/or shown to the end customer. These messages include concepts like non-refundable rooms, offer tags, incidents and erratas, complimentary extras, etc. Each type of message is identified using the InfoType property, an OTA INF (Information Type) code. **InfoType Codes:** * 2: Policy * 3 and 5: Promotional tags, see subsection [Offer Tags and Extras](#offer-tags-and-extras) * 12: Facilities ```xml Examples theme={null} No Restaurant, Comment: Only main restaurant at annex open during winter, Distance: 500 m, Action: at nearby restaurant Non refundable room ``` ```json Examples theme={null} { "VendorMessages": { "VendorMessage": [ { "Title": "IncidentsAndErrata", "InfoType": "12", "SubSection": { "Paragraph": { "Text": "No Restaurant, Comment: Only main restaurant at annex open during winter, Distance: 500 m, Action: at nearby restaurant" } } }, { "Title": "CancellationConditions", "InfoType": "2", "SubSection": { "Paragraph": { "Text": "Non refundable room" } } } ] } } ``` These messages can also use [DRV codes](../glossary/specs#drv) from Deutscher Reiseverband. ### **Cancellation Policies** ```xml Example theme={null} ``` ```json Example theme={null} { "VendorMessages": { "VendorMessage": { "Title": "FreeCancellationConditions", "InfoType": "2", "SubSection": [ { "SubTitle": "FCP-RATE", "SubCode": "DRV" }, { "SubTitle": "FCB-P0H", "SubCode": "DRV" } ] } } } ``` * **FCP**: Stands for Free Cancellation Policy, where the booking would be cancellable free of charge for the given amount of days before arrival/check-in date. * **FCB**: Stands for Free Cancellation after Booking, where the booking would be cancellable free of charge for the given amount of hours, or days after booking time. Some examples: * FCP-P12H – free cancellation 12 hours before check-in * FCP-P2D – free cancellation 2 days before check-in * FCB-P0H – free cancellation 0 hours after booking (meaning non-refundable) * FCB-P1D – free cancellation 1 day after booking ### **Offer Tags and Extras** Returned in search and booking responses for promotional purposes as Vendor Messages. * **InfoType 3**: Offers * **InfoType 5**: Extras As an optional setup for distributors, the response can additionally return Offer tags. These can be specified at two levels, depending on the setup: * Codes only: The only offer tag shown is the code corresponding to the offer. ```xml Example theme={null} Early Booking 20% ``` ```json Example theme={null} { "VendorMessage": { "Title": "Early Booking", "InfoType": "3", "SubSection": [ { "SubCode": "Value", "SubTitle": "20%", "Paragraph": { "Text": "Early Booking 20%" } }, { "SubTitle": "EBO", "SubCode": "OTS" } ] } } ``` > [!NOTE] > > The description is based and generated directly from the code * Codes + Promotional Descriptions: The code is shown, but also the Promotional text for the offer. > [!WARNING] > > This feature (Promotional text) is only enabled for hotel searches ```xml Example theme={null} Special Date Offers 30% Promotional Offer Text ``` ```json Example theme={null} { "VendorMessage": { "Title": "Special Date Offers", "InfoType": "3", "SubSection": [ { "SubTitle": "30%", "SubCode": "Value", "Paragraph": { "Text": "Special Date Offers 30%" } }, { "SubTitle": "EBO", "SubCode": "OTS" }, { "SubTitle": "PROMO", "SubCode": "OTS", "Paragraph": { "Language": "EN", "Text": "Promotional Offer Text" } } ] } } ``` > [!NOTE] > > The offer and extra codes that contain the attribute SubCode=”DRV” use GlobalTypes from the [Deutscher Reiseverband](../glossary/specs#drv). ## **Message Compression** Mandatory for communication with webservices. * Based on HTTP gzip compression. * Enable via HTTP header: `Accept-Encoding: gzip` See [RFC2616](http://toolshttp://tools.ietf.org/html/ration) and [RFC1952](https://datatracker.ietf.org/doc/html/rfc1952). ## **Provider Identification** Provider info is included in all messages under `TPA_extensions`. This extra information can be used for mapping purposes and future multi provider products. ```xml Example theme={null} ``` ```json Example theme={null} { "POS": { "Source": { "RequestorID": { "CompanyName": { "Code": "OTS", "CompanyShortName": "Open Travel Service AG" }, "ID_Context": "AxisData", "Type": "47" } } } } ``` *** ## **Transaction Control** In order to identify all messages related to a specific transaction, all messages in the same transaction should use the same `EchoToken`. ```xml Example theme={null} ``` ```json Example theme={null} "OTA_HotelAvailRQ" ``` *** ## **Packaging** The interface supports two main package models: * **Pre-Packaged** * **Dynamic Package** ### Pre-Packaged Model In this model, two or more services are offered together. Services are grouped in two ways: **1. Combination of Products** * Example: Hotel + Rent-a-Car * These combinations form a new room with a unique inventory code. * Hotel codes include a 2-character extension: * `AR` = Accommodation + Rent-a-Car * `AG` = Accommodation + Golf * Car packages are notified as an additional inventory code at room level. * Car codes follow the ACRISS standard and are listed in **Appendix H**. * Car codes per hotel can be retrieved from the services section of the `OTA_HotelDescriptiveInfo` message using the `SUMMARY` template. * Prices and availability for room + car packages are available: * In notification messages (Notification Model) * In search results (Transactional Model) Other examples of packages on sale include: * Schlagersterne Festival in Mallorca * Island Hopping in Greece * Fly & Drive in the Algarve * Blue Cruises in Turkey * Nile Cruises in Egypt **2. Hotel-Supplied Extras** * Offered as a different room code containing a **compulsory extra** (e.g., spa treatments). * Commonly used for hotel-provided offers. * **Disadvantages**: * Poor visibility of room descriptions in the German market. * Dependency on room descriptions in search results in other markets. > [!NOTE] > > Packages with **optional services** (e.g., ski pass, ski lessons, ski equipment rental) are often included as a **RatePlan**, allowing dynamic pricing and allotment from the normal hotel contract. ### Dynamic Package Model In this model, any service offered within the interface (hotel, transfer, rent-a-car, excursion) can be booked into a **single booking**, creating a package. * Uses **master and child references** to group services. * Allows services to be **added or cancelled individually**. *** ## **Price Breakdown** Add `Instance="PriceBreakdown"` to `RequestorID` to receive detailed pricing. ```xml Example theme={null} ``` ```json Example theme={null} { "RequestorID": [ { "ID_Context": "AxisData", "Instance": "PriceBreakdown", "Type": "22", "ID": "TEST" } ] } ``` Returned in `TPA_Extensions > RateDetails`. Includes: * Per pax/day breakdown * Codes like AA, AI, AP, EX, EBO2 *** ## **Payment Identification** The Payment ID is added to the booking request during the **booking commit post-process** by including `BillingInstructionCode` structures. These structures support various payment scenarios: **Single Payment for All Passengers** A single payment covers the entire booking and all its items. ```xml Example theme={null} ``` ```json Example theme={null} { "BillingInstructionCode": { "ResGuestRPH": [ { "RPH": "1" }, { "RPH": "2" }, { "RPH": "3" }, { "RPH": "4" } ], "BillingCode": "xxxxx", "AuthorizationCode": "yyyyyy1", "AccountNumber": "WireCard" } } ``` **One Payment per Passenger** Each passenger makes a separate payment that covers all items assigned to them. The same `BillingCode` is used, but each entry is specific to one passenger. ```xml Example theme={null} ``` ```json Example theme={null} { "BillingInstructionCode": [ { "BillingCode": "xxxxx", "AuthorizationCode": "yyyyyy1", "AccountNumber": "WireCard", "ResGuestRPH": { "RPH": "1" } }, { "BillingCode": "xxxxx", "AuthorizationCode": "yyyyyy2", "AccountNumber": "WireCard", "ResGuestRPH": { "RPH": "2" } }, { "BillingCode": "xxxxx", "AuthorizationCode": "yyyyyy3", "AccountNumber": "WireCard", "ResGuestRPH": { "RPH": "3" } }, { "BillingCode": "xxxxx", "AuthorizationCode": "yyyyyy4", "AccountNumber": "WireCard", "ResGuestRPH": { "RPH": "4" } } ] } ``` **Grouped Payments (e.g., 2 Payments for 2 Rooms)** Payments are split between groups of passengers. For example, each couple pays for their room. ```xml Example theme={null} ``` ```json Example theme={null} { "BillingInstructionCode": [ { "BillingCode": "xxxxx1", "AuthorizationCode": "yyyyyy1", "AccountNumber": "WireCard", "ResGuestRPH": [ { "RPH": "1" }, { "RPH": "2" } ] }, { "BillingCode": "xxxxx2", "AuthorizationCode": "yyyyyy2", "AccountNumber": "WireCard", "ResGuestRPH": [ { "RPH": "3" }, { "RPH": "4" } ] } ] } ``` > [!NOTE] > > * Each passenger (`ResGuestRPH`) is linked to specific booking items. > * Payments are directly related to the items assigned to each passenger. > * Partners must use **master/child reference logic** to ensure correct linkage. > * **Contact the integrations department** before implementing this concept. *** ## **Date/Time Formats** In various places we specify deadlines for specific concepts. For example the absolute deadline in cancellation policies or early booking discount prepayment. All these concepts use the local system time of our servers hosted on premises in ZRH and in our ZRH based AWS cloud. All Date/Time fields are in CET. ```xml Example theme={null} ``` ```json Example theme={null} { "HotelReservation": { "CreateDateTime": "2023-02-17T17:33:33", "CancelPenalty": { "Item_RPH": "0", "Deadline": { "OffsetUnitMultiplier": "3", "OffsetTimeUnit": "Day", "OffsetDropTime": "BeforeArrival", "AbsoluteDeadline": "2023-03-31T00:00:00" } } } } ``` > [!WARNING] > > It is important to consider this also for making a booking when release is concerned: making a booking at 7PM PST for arrival today, means for our system that you specify yesterday as in CET it is already 4AM the next day and conclusively our system will not allow a booking for arrival "yesterday". # Integration Models Source: https://docs.axisdata.net/general/models Understand and compare the Pull and Push models. \[!TIP] Check this document if you are not sure which model fits better to your system ## Pull Model Used when selling “hotel only” or for dynamic packaging. It is Axis Data's most applied model and main focus of this documentation. ### Workflow * Partners submit customer searches to Axis Data systems. * **Search** is high-performance, updated within 7 seconds, and does not access the database. * Real-time search, quote, book, and cancel messages. * XML-API offers fast response times: * **Search**: \~0.1 sec * **Quote**: \~0.5 sec ### Performance Notes * **Search/Book Ratio**: * Must not exceed **20,000:1** * Target is below **10,000:1** ## Push Model Used when hotels and transfers are packaged with flights and partners need to **hold rates and availability** in their systems. This model involves **pushing data** in near real-time. ### Workflow * Rates and availability are pushed to partner systems. * Partners use this data to respond to customer searches. * Booking requests are sent to Axis Data systems for confirmation. * **Quote** is a confirmation step, not suitable for search. ### Notification Formats * [EDF Notifications](/pushmodel/hotelEDF) * [OTA Notifications](/pushmodel/hotelOTA) * [OTDS Notifications](/pushmodel/hotelOTDS) * [Flatfile Notifications](/pushmodel/hotelFF) ### Performance Notes * **Quote/Book Ratio**: * Must not exceed **1000:1** * **100–1000:1** is a warning zone ## Choosing Between Models * Depends on partner system and workflow. * **Pull Model** offers less control over product data but price differences are avoided. * **Push Model** provides better product management but requires careful quote usage. ![A comparison of the two models](https://mintcdn.com/axisdata-0b02f380/3fbF6Ck_50e6Mm2G/general/imagesGeneral/models.png?fit=max\&auto=format\&n=3fbF6Ck_50e6Mm2G\&q=85\&s=26bb13fd7a5fbf7c95d09197bd7ac291) # RatePlans and MultiContracting Source: https://docs.axisdata.net/general/rateplans_multicontracting ## Purpose This page explains how to implement **multicontracting** in both the **Push** model and the **Pull** model. It also clarifies how RatePlan codes are structured under multicontracting and shows concrete XML examples. ## Overview Multicontracting lets you distribute **multiple contracts under a single hotel code** so that the system can surface **the best availability and rates across different contracting models** (e.g., integrated vs. manual), and also support **simple packages** (hotel + other products). This functionality is **ready for PROD**. Under multicontracting, the **RatePlan code** is extended from the original 5-character concept to a **three-part code**: \[simple-package-code]-\[contract-code]-\[rateplan-code] Example: **AR-OWN1-S0000** Where `AR` is a simple package (Accommodation + Car), `OWN1` is the contract code, and `S0000` is the rateplan code. > **Note on RatePlan code details**: visit [RatePlan codes](../glossary/codes#rateplan-codes) RatePlan codes are constructed from the below elements Rate Type(1), Rate Group(1), Rate Refund(1), Rate Sub Type(2) Example: BHSP2 – BAR Rates - Hotel only - Semi-flexible – Promotional Rate 2 There is also a possibility of duplicating RatePlan which already exists in the contract. In this case the “.” character, and a number starting with 1, and then subsecuently every iteration. Example: BHSP2.1 ### Code Construction RatePlan codes are constructed from the below elements:\ **Rate Type (1), Rate Group (1), Rate Refund (1), Rate Sub Type (2)** | Rate Type | | Rate Group | | Rate Refund | | Rate Sub Type | | | :- | :- | :- | :- | :- | :- | :- | :- | | 0 | Rates | 0 | undefined | 0 | Undefined | 00 | Undefined | | R | Retail rates | H | Hotel only | N | Non refundable | A0 | Advanced Purchase | | S | Static rates | P | Packaging | S | Semi-flexible | A2 | Advanced Purchase 2 | | F | FIT Rates | O | Opaque | F | Flexible | A3 | Advanced Purchase 3 | | B | BAR rates | R | Rack | | | P0 | Promotional Rate | | | | | | | | P2 | Promotional Rate 2 | | | | | | | | P3 | Promotional Rate 3 | | | | | | | | P4 | Promotional Rate 4 | | | | | | | | P5 | Promotional Rate 5 | | | | | | | | P6 | Promotional Rate 6 | | | | | | | | P7 | Promotional Rate 7 | | | | | | | | P8 | Promotional Rate 8 | | | | | | | | P9 | Promotional Rate 9 | | | | | | | | 01 | \[1] | | | | | | | | 02 | \[2] | | | | | | | | 03 | \[3] | | | | | | | | 04 | \[4] | | | | | | | | 05 | \[5] | | | | | | | | 06 | \[6] | | | | | | | | 07 | \[7] | | | | | | | | 08 | \[8] | | | | | | | | 09 | \[9] | #### Rate Type * **0** → Not defined – rate stays unchanged like in the basic contract edition. * **B** → Bar - best available rates (changing due to rate updates) * **S** → Static – unchanged contract rate till the time of a promotion or an offer introduction * **F** → FIT - free individual traveller rates * **R** → Retail – advised end-price #### Rate Group * **H** → Hotel only - rates valid when booking contains only hotel * **P** → Packaging - rates valid when booking contains hotel + another product * **O** → Opaque - hotel rates must not be visible for end consumer * **R** → Rack - walk-in hotel rates for end consumer Funcionality of the Rate Group: The Rate Group indicates the distribution that needs to be followed. When the Rate Group is marked as P or O, these rates should not be visible to end users and may only be used as part of a package, ensuring they are not directly exposed. #### Rate Refund * **N** → Non refundable - immediately after booking * **S** → Semi-flexible – cancellation without fees up to 12 hours after booking * **F** → Flexible – cancellation without fees up to 24 hours after booking Functionality logic of Rate Refund – 3nd character of rateplan: * If there is a character N on the rateplan 3rd position means it’s completely non-refundable OR at the roomtype code on the last position * When the character is 0 and IF there is no rateplan NOR N as the last character of the room code, means the room is refundable and conditions will be shared on the Vendor Messages on the AvailRS and ResRS (Quote/Book) #### Rate Sub Type * **A** → Advanced Purchase - booking has to be paid before confirming * **P** → Promotion Rate RatePlan Codes can be expressed by two following options: **Concatenated codes** → adding to the room code the Rateplan Code - "RMSD000000;0PNA0" **Separated codes** → this requieres the implementation of a RoomKey attribute, because the communication will be as a separate room code attribute RMSD000000" and an attribute RoomKey "0PNA0". The option chosen by the client has to be set in our system. ## Pull Model ### What Changes in Search Results Search results for the same hotel may include **multiple contracts as RatePlans**, allowing integrated and manual contracts to **compete** for best availability and price across seasons/windows. If you need to **de‑duplicate or filter** multicontracting search results, you can use the following request switches explained in [OTA\_HotelAvailRQ](../hotel/searchRQ#pos-point-of-sale) ### What to Send / Receive in Realtime * **Use `RoomTypeCode` in realtime messages** instead of a RatePlan ID. **OTA RS examples (RoomTypeCode variations under multicontracting)**: ```xml theme={null} ``` ```json theme={null} { "RoomType": [ { "RoomTypeCode": "STSD000000;FP000" }, { "RoomTypeCode": "STSD000000;-ABC1-" }, { "RoomTypeCode": "STSD000000;AR-ABC1-FP000" }, { "RoomTypeCode": "STSD000000;-OWN1-FP000" }, { "RoomTypeCode": "STSD000000;AR-ABC1-" } ] } ``` ### Package Examples (Search / Book) * **Accommodation+Car**: `AR-OWN1-S0000` (room might be `STSD000000-ECMR` for car class). * **Other simple packages** supported conceptually: ski (`SP1`), golf, spa, yoga, cooking classes, etc. (package prefix + contract + rateplan). ### Implementation Notes * For **non‑refundable identification**, ensure you read the **3rd character from the end** of the RatePlan code (due to the extended prefixing), not the 3rd from the start. * Clients using **pull** and **push** models have **no behavioral impact** beyond the longer RatePlan codes. *** ## Push Model ### What You Receive Partners with a multicontracting + rateplan integration receive the relevant information **via notification files**; the format is equivalent across notification variants. ### How RatePlans Are Delivered You can consume RatePlans in notifications in **two ways**: 1. **Concatenated** into the RoomCode, e.g. `RMSD000000;OwWN1-P0N00` (no dev to add a new field, but existing room mapping must be updated and any “best price” logic on mapped codes may only surface the cheapest option). Non‑refundable plans may exist in rooms without an `N` at the 10th position. 2. **Separate attribute** via `RoomKey` / `RatePlanID`, e.g. RoomCode `RMSD000000` and RoomKey `P0N00.2`. This keeps mapping unchanged, but requires implementing the RoomKey attribute (not available in OTDS). #### Examples (Separate Code) **OTA** ```xml theme={null} ... ``` ```json theme={null} { "RatePlans": { "_HotelCode": "AESSVQ4GKU", "RatePlan": { "_RatePlanID": "OWN1-P0N00" } }, "SellableProducts": { "SellableProduct": { "_InvCode": "RMSD000000", "_InvType": "ROOM" } } } ``` **EDF / ASNF**: ```xml theme={null} ``` ```json theme={null} { "EDF": { "Room": { "_Code": "AP00T10000", "_RateCode": "-SUP1-0P000", "_RoomKey": "-SUP1-0P000" } }, "ASNF": { "Room": { "_Code": "AP00T10000", "_Name": "1 Bedroom Apartment", "RatePlans": { "RatePlan": { "_Code": "-SUP1-0P000" } } } } } ``` ### Packaging Support in Notifications Simple packages are supported via the **simple-package-code** prefix. For instance, an Accommodation+Car package uses `AR`, with the car type appended to the room when applicable (e.g., `STSD000000-ECMR`). ### Flatfile Users If you opted for concatenated codes, the **room code field and the rateplan code size** are extended in **Version 3** of the flatfile definition. *** ## At a Glance **Examples tied to a single hotel & room:** * HotelCode `AESPMI1234`, RoomCode `RMSDDB0000`, `RateplanCode="-ABC1-0P0A0"` → Contract `ABC1` with a **Packaging Advanced Purchase** rateplan from the hotel. * HotelCode `AESPMI1234`, RoomCode `RMSDDB0000`, `RateplanCode="-DEF1-S0N00"` → Contract `DEF1` with a **Static, Non‑Refundable** rate. * `RateplanCode="-OWN1-"` → Manual contract with **no rateplans** in the contract. * `RateplanCode="AR-OWN1-S0000"`, RoomCode `STSD000000-ECMR` → **Accommodation + Car** package using contract `OWN1` and static rates; `ECMR` denotes an **Economy Manual A/C** car class. *** ## Next Steps * INT examples (RQ/RS) and a Postman collection are available for integration tests. Provide feedback on your test cases, complete **certification for multicontracting**, and then roll out to **PROD**. *** ## Appendix * If your distribution excludes Opaque or Packaging rates on hotel‑only websites, re‑check any code parsing logic to account for the **prefixed** code structure. * Test users: `TST3` (separate code/RoomKey) and `TST4` (concatenated code). # Introduction Source: https://docs.axisdata.net/getting-started/introduction TravelKISS API is built for simplicity and performance, allowing you to concentrate on delivering exceptional features to your users. It offers smooth and reliable access to comprehensive touristic data, covering availability, pricing, and booking options, making it an ideal solution for travel and hospitality platforms. ## Purpose of the API The purpose of this API is to provide a unified, efficient, and scalable interface for accessing and managing data related to **hotels**, **activities**, and **transfers** within the travel and hospitality ecosystem. It is designed to support seamless integration with third-party platforms, internal systems, and mobile applications, enabling real-time data exchange and automation across services. #### **Key Objectives** * **Standardization**: Offer a consistent data structure and access method for diverse services such as hotel bookings, activity reservations, and transfer logistics. * **Efficiency**: Reduce manual operations by enabling automated data retrieval, updates, and synchronization. * **Scalability**: Support high-volume transactions and dynamic content updates to meet the needs of DMCs, OTAs, and hotel trading platforms. * **Flexibility**: Allow for customizable queries and endpoints to suit different business models and integration requirements. #### **Use Cases** * Retrieve hotel availability, pricing, and descriptions. * Access detailed activity listings, schedules, and booking options. * Manage transfer services including routes, vehicle types, and timing. * Synchronize inventory and booking data across multiple systems. This API is a core component of the Axis Data platform, empowering partners to build robust travel solutions with reliable and up-to-date information. ## Architecture overview * **Foundation**: The documentation is built on a modular XML schema, allowing for clear separation of concerns between service types (e.g., hotel, activity, transfer) while maintaining a unified structure. * **Service-Oriented**: Each service is encapsulated within its own XML node hierarchy, describing available operations (e.g., search, book, cancel), required parameters, and expected responses. * **Validation & Consistency**: XML Schema Definitions (XSD) are used to enforce data integrity, ensuring that all requests and responses conform to predefined formats and business rules. * **Extensibility**: The architecture supports versioning and custom extensions, allowing partners to adapt the documentation to evolving business needs without disrupting existing integrations. * **API Binding**: The XML documentation is tightly coupled with the API layer, enabling dynamic generation of service descriptions and facilitating automated client code generation in various programming languages. * **JSON Format**: Since Q3 2026 our API is also available for the JSON format, based on the XML requests. # Quickstart Source: https://docs.axisdata.net/getting-started/quickstart Welcome to the fastest way to get started with our API. No API keys, no setup headaches — just results in under a minute. > [!TIP] > > Our API authentication is in the request as an attribute, so you can start testing right away without API Keys or managing tokens. ## What You’ll Do **1. Understand the Payload** Our API works with XML. Authentication is embedded directly in the payload — no headers, no keys. The ID to set in POS node is `TEST` and the password is `testpass` **2. Try a Live Request** Use our [API Playground](../api-reference/endpoint) to send a real request and get a live response. **3. Explore Responses** See how our API handles your XML input and returns structured, reliable data. ## Try It Now > [card] [API Playground](/api-reference/endpoint/hotel/availability) > > Hit the playground ## Next Steps Now that you have tested the API, explore these key features: > [card] [Accommodation](/hotel/searchRQ) > > Learn to search for availability and prices and how to get information about the accommodation. > [card] [Activity](/excursion/searchXARQ) > > All about search and book of our activities and excursions > [card] [Transfer](/transfer/searchTRRQ) > > Search and book private or shuttle transfers. > [card] [General](/bookingmgmt/bookReadRQ) > > Common requests, like a Read request to get a list of bookings. # Mapping Codes Source: https://docs.axisdata.net/glossary/codes This site shows all of our custom codes that need to be mapped on consumers end. Find also the codes inside of an excel or inside of CSV files in our [Resources](../resources/downloadables#mapping-codes) ## Common Codes > [accordion] Price Breakdown Codes > > | **Main calculation concepts** | | > | :- | :- | > | AA | Accommodation adult | > | AC | Accommodation child | > | EX | Extras | > | HB, AI, etc | Board (see board codes) | > > | **Offer codes** | | > | :- | :- | > | DPO | Special date offer | > | LMO | Last minute offer | > | AOO | Adult only offer | > | COO | Child only offer | > | LSO | Long stay offer | > | EBO | Early booking offer | > | EBR | Early booking offer (flat reduction) | > | FRU | Free room upgrade | > | FSO | Free stay offer | > | INF | Free infant | > | SCR | Senior reduction | > | SPO | Special Offers | > | MSO | Minimum Stay Offers | > | FBU | Free Board Upgrades | > | KGF | Kids Go Free | > [accordion] RatePlan Codes > > RatePlan codes are constructed from the below elements:\ > **Rate Type (1), Rate Group (1), Rate Refund (1), Rate Sub Type (2)** > > | Rate Type | | Rate Group | | Rate Refund | | Rate Sub Type | | > | :- | :- | :- | :- | :- | :- | :- | :- | > | 0 | Rates | 0 | undefined | 0 | Undefined | 00 | Undefined | > | R | Retail rates | H | Hotel only | N | Non refundable | A0 | Advanced Purchase | > | S | Static rates | P | Packaging | S | Semi-flexible | A2 | Advanced Purchase 2 | > | F | FIT Rates | O | Opaque | F | Flexible | A3 | Advanced Purchase 3 | > | B | BAR rates | R | Rack | | | P0 | Promotional Rate | > | | | | | | | P2 | Promotional Rate 2 | > | | | | | | | P3 | Promotional Rate 3 | > | | | | | | | P4 | Promotional Rate 4 | > | | | | | | | P5 | Promotional Rate 5 | > | | | | | | | P6 | Promotional Rate 6 | > | | | | | | | P7 | Promotional Rate 7 | > | | | | | | | P8 | Promotional Rate 8 | > | | | | | | | P9 | Promotional Rate 9 | > | | | | | | | 01 | \[1] | > | | | | | | | 02 | \[2] | > | | | | | | | 03 | \[3] | > | | | | | | | 04 | \[4] | > | | | | | | | 05 | \[5] | > | | | | | | | 06 | \[6] | > | | | | | | | 07 | \[7] | > | | | | | | | 08 | \[8] | > | | | | | | | 09 | \[9] | > > #### Rate Type > > * **0** → Not defined – rate stays unchanged like in the basic contract edition. > * **B** → Bar - best available rates (changing due to rate updates) > * **S** → Static – unchanged contract rate till the time of a promotion or an offer introduction > * **F** → FIT - free individual traveller rates > * **R** → Retail – advised end-price > > #### Rate Group > > * **H** → Hotel only - rates valid when booking contains only hotel > * **P** → Packaging - rates valid when booking contains hotel + another product > * **O** → Opaque - hotel rates must not be visible for end consumer > * **R** → Rack - walk-in hotel rates for end consumer > > #### Rate Refund > > * **N** → Non refundable - immediately after booking > * **S** → Semi-flexible – cancellation without fees up to 12 hours after booking > * **F** → Flexible – cancellation without fees up to 24 hours after booking > > #### Rate Sub Type > > * **A** → Advanced Purchase - booking has to be paid before confirming > * **P** → Promotion Rate > [accordion] Stock Types > > | Code | Stock Type | > | :- | :- | > | TR | Transfer - Airport to Resort | > | CR | Car Rental | > | AC | Accommodation | > | CT | Circuits & Tours | > | FD | Hotel Packages | > | GI | Groups & Incentives | > | MP | Other Packages | > | GA | Guest Assistance | > | GS | Guides & Other Staff | > | XA | Excursions & Activities | > | OA | Outdoor Activities | > | SF | Safaris | > | PU | Meeting Points | > | SA | Sights and Attractions | > | SZ | Service Zones | > | GF | Golf | > | WS | Wellness & Spa | > | RS | Restaurants | > | TP | Theme Parks | > | MM | Museums & Monuments | > | SE | Shows & Events | > | BN | Bars, Wine, & Nightlife | > | ES | Educational Services | > | TT | Sightseeing & Tours | > | MI | MICE Services | > | LP | Licenses & Permissions | > | IS | Insurances | > | FT | Fees & Taxes | > | SS | Ski & Snow | > | PX | Package of Excursions | > | CS | Catering Services | > | CP | Custom & Private | > | IA | Indoor Activities | > | TG | Tour Guides | > | DR | Drivers | > | MS | Miscellaneous | > | AR | Accommodation + Car | > | AG | Accommodation + Golf | > | TRS | Transfer - Seaport to Resort | > | TUR | Tour Transport | > | TIT | Inter-Transfer | > | TAA | Transfer - Airport to Airport | > | TAS | Transfer - Airport to Seaport | > | TSS | Transfer - Seaport to Seaport | > | LA | Leisure & Activities | > | OP | Other Services | > | VS | Visa Services | > | AT | Air Tours | > | BT | Boat Tours | > | EX | Excursions | > | LG | Local Guides | > | BG | Bus Guide | > | GIM | MICE | > | GIS | SERIES | > | GIO | OTHER GROUPS | > | GIA | A LA CARTE | > | WW | Water & Wind | > | AS | Airport Services | > | PC | Passes & Cards | > | HS | Health Services | > [accordion] Custom Type Code Definition > > Custom Types are used as part of the DRV GlobalType structure, see [www.globaltypecenter.de](http://www.globaltypecenter.de). > > **Max length:** 11 chars; e.g. `CTxx-abcdef` > > | Category | CustomType | Description | > | :- | :- | :- | > | SOA | CT03-SOASTC | SealOfApproval - Safe Tourism Certified. Spain | > | | CT03-SOASST | SealOfApproval - Certificate Of Safe Tourism. Turkey | > | | CT03-SOASTM | SealOfApproval - Safe Travels CPPSIT. Mexico | > | | CT03-SOACSP | SealOfApproval - Clean and Safe. Portugal | > | | CT03-SOACCM | SealOfApproval - Certified Compliant COVID-19. Malta | > | | CT03-SOAAUE | SealOfApproval - Assured DUBAI | > | | CT03-SOAAPC | SealOfApproval - Advanced Precaution Certified. NORTH CYPRUS | > | | CT03-SOARST | SealOfApproval - Ready and Safe. Tunisia | > | General NHSP | CT03-WHO | Compliance of the WHO recommendations and local laws | > | | CT03-SASCSE | Safe access with sanitary controls to suppliers and employees | > | | CT03-SRP | Staff Replacement Policy | > | | CT03-ICDPAA | Intense cleaning and disinfection protocols for all areas | > | | CT03-SCO | Self Catering Options available | > | | CT03-DIST2M | General distance of 2 meters | > | Restaurant | CT03-DK | Disposable Kitchenware | > | | CT03-TBLD2M | Table distance of 2 meters | > | | CT03-ICBO | Individual / Closed Bottles only | > | Pool | CT03-AACRA | Additional adapted Chill-out/ Relaxation areas | > | | CT03-SBDD2M | SunBed distance of 2 meters | > | Guest | CT03-SPGAG | Self-protecting gear Available for guests (Masks/ Gloves/ Hand sanitizer) | > | | CT03-ACTFG | Available Covid-19 tests for guests | > | | CT03-GIP | Guest Infection Policy | > | | CT03-TCMFG | Temperature control measures for guests | > | Housekeeping | CT05-CSR | Clean and sanitized room | > | | CT05-EDCP | Intensification of disinfection / Cleaning protocols | > | | CT05-24CICO | 24h time between check-out and check-in | > | | CT05-IO | Individual amenities | > | | CT05-IWT | Individual Wrapped Towels | > | | CT05-CTSC | Clean Towels (service cycle) | > | | CT05-RDSC | Room disinfection (Service cycle) | > | Kids Club | CT03-AAKC | Adapted Activities at Kids Club | > | | CT03-RGGA | Reduced Groups and Guided activities | > | Spa & Wellness | CT03-ASWT | Adapted Spa / Wellness Treatments | > | | CT03-ASWRA | Adapted Spa and Wellness Relax Areas | > | Gym | CT03-SPGG | Self-protecting gear Available in the gym | > | | CT03-UCRLG | Usage of Changing Rooms/ Lockers in the gym | *** ## Hotel Related Codes > [accordion] Hotel Codes > > * **Classic:** 3 elements. E.g. `AMTSES0FFG` (A = Accommodation, MTSES = Incoming Agent, 0FFG = counter) > * **New destinations:** 4 elements. E.g. `AEGHRG10SY` (A = Accommodation, EG = Country, HRG = destination, 10SY = counter) > * Handling office for each hotel is included in the `OTA_HotelDescriptiveInfo`. > [accordion] Hotel Category Codes > > | Description | Code | > | :- | :- | > | Hotel | 20 | > | Villa | 35 | > | Aparthotel | 29 | > | Traditional House | 48 | > | MTS Code | 22 | > | Holiday Village | 18 | > | Bungalow Complex | 5 | > | Apartment Complex | 3 | > | Hostel | 19 | > | Holiday House | 34 | > [accordion] Hotel Rating Codes > > | Apartments | Rural | Hotels | Other | > | :- | :- | :- | :- | > | 1 Key | 1 Palm | 1 Star | No Rating | > | 2 Keys | 2 Palm | 1.5 Stars | | > | 3 Keys | 3 Palm | 2 Stars | | > | 4 Keys | 4 Palm | 2.5 Stars | | > | 5 Keys | 5 Palm | 3 Stars | | > | | | 3.5 Stars | | > | | | 4 Stars | | > | | | 4.5 Stars | | > | | | 5 Stars | | > | | | 5.5 Stars | | > | | | 6 Stars | | > | | | 7 Stars | | > [accordion] Hotel Room Codes (Large) > > * RoomClassificationCode in `OTA_HotelAvailRQ` can be any “Type” value. > * Room codes are assembled from various room characteristics: e.g. `RMSDDBSV00` > * Subtypes (0, A, B, etc.) define themselves through listed `` in `OTA_HotelInvNotif` and `OTA_HotelDescriptiveInfo (UNIT)`. > * Example: > * `RMSD000000`: plain double room > * `RMSD000000`: “BALCONY” under `` > * `RMSDDB00B0`: “KITCHENETTE” and “JACUZZI” under `` > * Special case: Subtype A, B, etc. suffix but no differences in amenities = different board bases (meal plans). > > **Room Code Structure**\ > Type(2) / Grade(2) / Base(2) / View(2) / Subtype(2) > > | Type | | Grade | | Base | | View | | Subtype | | > | :- | :- | :- | :- | :- | :- | :- | :- | :- | :- | > | **Code** | **Name** | **Code** | **Name** | **Code** | **Name** | **Code** | **Name** | **Code** | **Name** | > | 72 | Room-Inc.2 Rounds of Golf | 0 | Not Defined | 0 | Not Defined | 0 | Not Defined | 0 | Not Defined | > | 73 | Room-Inc.3 Rounds of Golf | 0W | Overwater | 10 | 10 Bedroom | 2 | Sunset View | 1 | GolfPackage | > | 74 | Room-Inc.4 Rounds of Golf | 50 | Premium Leisure Club Executive Arabian Deluxe | 1X | 1 Bedroom Duplex | 3 | Resort View | 2 | SpaPackage | > | 75 | Room-Inc.5 Rounds of Golf | 51 | Premium Leisure Club Executive Ocean Deluxe | 2A | 2 Adjacent Rooms | 4 | Burj Khalifa View | 3 | ThallasoPackage | > | 76 | Room-Inc.4 Rounds of Golf Including Buggy | 52 | Arabian Suite | 2K | 2 King Beds | 5 | Canal View | 5 | Action | > | 77 | Room-Inc.5 Rounds of Golf Including Buggy | 53 | Ocean Gulf Summerhouse | 2S | 2 Single Beds | 6 | Burj Al Arab View | 6 | Activities Package | > | 78 | Room-Unlimited Golf | 77 | Penn Plaza Renovated | 2T | 2 Twin Beds | 9 | Palm View | 7 | CarPackage | > | AH | Arabian Summerhouse | A0 | Arabian | 2W | 2 Queen Beds-resort fee waived | 11 | Walk View | 8 | ServicePackage | > | AP | Apartment | A1 | Armani Deluxe | 2X | 2 Bedroom Duplex | 17 | Marina View | 9 | WaterparkPackage | > | BU | Bungalow | A2 | Armani Classic | 3A | 3 adjacent rooms | 18 | Race Track View | 0A | Attic | > | BV | BeachVilla | A3 | Armani Premier | 3R | 3 Rooms | 19 | Marina or Pool View | 0B | Best-Price | > | CA | Capsule | A4 | Armani Executive | 3S | 3 Single Beds | 20 | Souk View | 0C | Low Cost | > | CC | CruiseCabin | A5 | Armani Ambassador | 3T | 3 Twin Beds | 2P | Chill-Out Pool View | 0D | Dreamer | > | CH | Chalet | A6 | Armani Signature | 3X | 3 Bedroom Duplex | 31 | Desert View | 0E | Economy | > | CT | Cottage | A7 | Armani Dubai | BW | BunkBeds-resort fee waived | AC | Acrópolis | 0F | Staff | > | CV | Campervan | A8 | Armani Residence | CR | 2 Connecting Rooms | AN | Panoramic Acrópolis | 0G | SingleSaver | > | FA | Family Lake House | A9 | Anthurium | D1 | 1 Double Bed | AP | Pool Access | 0H | Honeymooners | > | FB | FamilyBungalow | AA | Arabian Superior | D2 | 2 Double Beds | AV | Volcano View | 0I | Kids Free | > | FH | Farmhouse | AB | Adjacent Beach | DB | Double | BA | Beach Access | 0J | Fast Pay | > | FJ | Family Junior Suite | AC | Arabian Club Superior | DM | Dormitory | BF | BeachFront | 0L | LadiesOnly | > | FL | FamilyLodging | AD | Arabian Deluxe | DX | Duplex | BH | BosphorusView | 0M | Reduced Mobility | > | FM | Family House | AE | Al Rimal Enclosed | FU | Full | BV | BayView | 0N | Non-Refundable | > | FP | FamilyApartment | AF | Aloft | IN | SingleUse | CP | Castle-Palace View | 0O | Offer | > | FR | FamilyRoom | AG | Arabian Gulf | K1 | King | CR | CreekView | 0P | Promotion | > | FS | FamilySuite | AH | Abu Dhabi | KB | King Bed | CS | Chill-Out Sea View | 0Q | Adults Only | > | FT | Family Tent | AI | Al Ain | KG | King or Queen | CT | City View (Palm Residences) | 0R | Senior 60+ | > | FV | FamilyVilla | AJ | Ambassador | KS | King SingleUse | CV | CityView | 0S | Senior 55+ | > | FX | FamilyStudio | AL | Atlantic | KW | King-resort fee waived | CW | Country/Pool View | 0T | Student | > | GH | Gulf Summerhouse | AM | Armani | LB | Bunkbed | CY | CourtyardView | 0V | VipTreatment | > | GR | GardenRoom | AN | Anantara | LR | Large | DD | Disney View | 0W | Sol | > | HF | HolidayFlat | AQ | Aqua | MB | MultipleBed | DS | Dubai Skyline | 0X | Agent | > | HH | HolidayHouse | AR | Astor | OC | Octuple | DT | Downtown | 0Y | Resort Fee Included | > | HO | House | AS | Annex Superior | Q1 | Queen | DV | DunesView | 0Z | SpecialPackage | > | JS | JuniorSuite | AT | Al Khaimah Tented | Q2 | 2 Queen Beds | ES | Creek Scene | 10 | Spa | > | JT | JuniorStudio | AU | Austral | QI | Quintuple | FR | Front Row | 1N | Spa Non-Refundable | > | LO | Loft | AX | Annex | QS | Queen SingleUse | FV | FountainView | 1P | Spa Promotion | > | LS | Loft Suite | B0 | Beach | QU | Quad | G2 | Garden or Pool View | 20 | Spa - Private Pool | > | LV | LagoonVilla | B1 | Baros | QW | Queen-resort fee waived | G3 | Garden or Sea View | 2N | Spa - Private Pool Non-Refundable | > | MA | Maisonette | B2 | Barachois | R2 | 2 Rooms | GH | GoldenHorn View | 30 | Rooftop | > | MH | MobileHome | BA | Basic | SC | Single w\.Child | GO | GolfCourseView | 3E | Rooftop Economy | > | MI | Mini-Suite | BB | Royal Beit Al Bahar | SG | Single | GP | Garden-Pool View | 3N | Rooftop Non-Refundable | > | MS | Mansion | BC | Boulevard Club | SP | Septuple | GS | Garden-Sea View | 3P | Rooftop Promotion | > | OA | Oasis | BD | Deluxe Delight Beach | ST | Sextuple | GV | GardenView | 40 | TypeB | > | OT | Room Tower | BE | Premium Beach | T1 | 1 Bedroom | HV | HarborView | 4B | TypeB Best-Price | > | PH | Penthouse | BF | Deluxe Beach (Ground Floor) | T2 | 2 Bedroom | IL | Inland View | 4E | TypeB Economy | > | PK | Package | BG | BVLGARI | T3 | 3 Bedroom | IN | Interior | 4L | TypeB Low cost | > | PS | Penthouse Suite | BH | Bahia | T4 | 4 Bedroom | IW | Island View | 4M | TypeB Reduced Mobility | > | PV | Pavilion | BN | Business | T5 | 5 Bedroom | JV | Jungle View | 4N | TypeB Non-Refundable | > | RC | Room Club | BO | O Beach | T6 | 6 Bedroom | KS | Skyline Sea View | 4O | TypeB Offer | > | RD | Room Deluxe | BP | Palm Beach Premier | T7 | 7 Bedroom | LA | LagoonView | 4P | TypeB Promotion | > | RM | Room | BR | Residence Beach | T8 | 8 Bedroom | LC | LandscapeView | 4Q | TypeB Adults Only | > | RS | Rock Suite | BS | Sangu Beach | T9 | 9 Bedroom | LF | LakeSide | 4Z | TypeB SpecialPackage | > | RT | Retreat | BT | Al Bahar Tented Beach | TP | Triple | LL | Lateral LakeView | 50 | Speedboat | > | SC | Suite Club | BU | Bedouin | TW | Twin | LP | Laguna Pool Side | 5H | Speedboat Honeymooners | > | SS | SeniorSuite | BV | Boulevard | W1 | 1 Double Bed-resort fee waived | LS | LateralSeaView | 5P | Speedboat Promotion | > | ST | Studio | C1 | Sea Scape | W2 | 2 Double Beds-resort fee waived | LV | LakeView | 60 | Shared Pool | > | SU | Suite | C2 | Palm Scape | | | LW | Lagoon Water Pool View | 6N | Shared Pool Non-Refundable | > | SV | SuiteVilla | C3 | Sky View | | | LX | LagoonAccess | 6P | Shared Pool Promotion | > | TH | Townhome | C4 | Sky Terrace | | | M2 | Mountain or Pool View | 6Q | Shared Pool Adults Only | > | TN | Tent | C5 | Sky Pool | | | MC | Mosque/Canal View | 70 | With Jacuzzi - Speedboat | > | TS | Studio Suite | C6 | Sky Scape | | | MG | Mountain or Garden View | 80 | With Slide and Pool - Seaplane | > | TV | Loft Villa | C7 | Horizon | | | MP | Main Pool View | 81 | With Slide and Pool - Domestic Flight | > | UT | Suite Tower | C8 | Panoramic | | | MS | Mountain or Sea View | 90 | Domestic Flight | > | VI | Villa | C9 | Jabal Terrace | | | MU | Mountain View | 99 | Domestic Flight WaterparkPackage | > | XX | Extras | CB | Cabana | | | MV | MountainView | 9H | Domestic Flight Honeymooners | > | | | CC | Cool Corner | | | NV | NileView | 9P | Domestic Flight Promotion | > | | | CD | Arabian Court Deluxe | | | OF | Ocean Front | A0 | Balcony or Terrace | > | | | CE | Arabian Court Executive | | | OV | Ocean View | A1 | Balcony or Terrace GolfPackage | > | | | CF | Comfort | | | P1 | Pool Sunsrise | A2 | Balcony or Terrace SpaPackage | > | | | CG | Grand Club | | | P2 | Pool Sunset | A3 | Balcony or Terrace ThallasoPackage | > | | | CH | Anything Can Happen | | | PA | PanoramaView | A4 | Balcony or Terrace HolidayPackage | > | | | CI | Colonial | | | PC | Pool or City View | A5 | Balcony or Terrace Action | > | | | CL | Club | | | PD | PoolSide | A6 | Balcony or Terrace Activities Package | > | | | CN | Central Location | | | PF | Pool Front | A7 | Balcony or Terrace CarPackage | > | | | CO | Coral | | | PH | Partial Harborview | A8 | Balcony or Terrace ServicePackage | > | | | CP | Arabian Court Prince | | | PK | Park View | A9 | Balcony or Terrace WaterparkPackage | > | | | CR | Corner | | | PL | Partial Lake View | AA | Balcony or Terrace Attic | > | | | CS | Classic | | | PM | Pyramid View | AB | Balcony or Terrace Best-Price | > | | | CU | Crusoe | | | PO | Partial Ocean View | AC | Balcony or Terrace Low Cost | > | | | CV | Covet | | | PR | PartialRiverView | AD | Balcony or Terrace Dreamer | > | | | CW | Ocean Water | | | PS | Pool-Sea View | AE | Balcony or Terrace Economy | > | | | CX | Club Luxury | | | PT | Patio View | AG | Balcony or Terrace SingleSaver | > | | | CY | Crystal | | | PV | PoolView | AH | Balcony or Terrace Honeymooners | > | | | D1 | Deluxe Lake | | | PW | Partial Waterfall View | AI | Balcony or Terrace Kids Free | > | | | DA | Deluxe Lagoon | | | RP | River or Pool View | AJ | Balcony or Terrace Fast Pay | > | | | DB | Deluxe Beach | | | RV | RiverView | AK | Balcony or Terrace Late Check-Out | > | | | DC | Deluxe Club | | | S1 | Palm Sea View | AL | Balcony or Terrace LadiesOnly | > | | | DD | Deluxe Signature | | | S2 | Sea or Pool View | AM | Balcony or Terrace Reduced Mobility | > | | | DE | Design | | | S3 | Lateral Sea View or Pool View | AN | Balcony or Terrace Non-Refundable | > | | | DF | Deluxe Upper Floor | | | S4 | Lateral Sea View and Pool Shared Terrace | AO | Balcony or Terrace Offer | > | | | DH | Dolphin | | | S5 | Lateral Sea View or Pool Shared Terrace | AP | Balcony or Terrace Promotion | > | | | DI | Diamond | | | SB | SeaView Balcony | AQ | Balcony or Terrace Adults Only | > | | | DL | Deluxe | | | SF | SeaFront | AR | Balcony or Terrace Senior 60+ | > | | | DN | Dhoni | | | SG | StageView | AS | Balcony or Terrace Senior 55+ | > | | | DO | Grand Overwater | | | SL | Skyline View | AV | Balcony or Terrace VipTreatment | > | | | DP | Diplomatic | | | SM | Sea/Palm View | AW | Balcony or Terrace Type B | > | | | DQ | Deluxe-Unique | | | SP | Sea-Pool Side | AZ | Balcony or Terrace SpecialPackage | > | | | DR | Grand Reef | | | SS | SeaSide | B0 | Balcony | > | | | DS | Deluxe Superior | | | ST | StreetView | B1 | Balcony GolfPackage | > | | | DV | Deluxe V Level | | | SV | SeaView | B2 | Balcony SpaPackage | > | | | DW | Deluxe Water | | | TV | Tropical View | B3 | Balcony ThallasoPackage | > | | | E1 | Emirates | | | VC | Country View | B5 | Balcony Action | > | | | EC | Executive Club | | | VG | Glacial View | B6 | Balcony Activities Package | > | | | ED | Executive Downtown | | | VH | Horizon View | B7 | Balcony CarPackage | > | | | EE | Reef | | | VP | Partial Sea View | B9 | Balcony WaterparkPackage | > | | | EF | Efficiency | | | VR | Ridge View | BA | Balcony Attic | > | | | EH | Etihad | | | VS | Sunrise View | BB | Balcony Best-Price | > | | | EI | Emiri | | | VT | SeaView Terrace | BC | Balcony Low Cost | > | | | EL | Elegance | | | VV | ValleyView | BD | Balcony Dreamer | > | | | EM | Emerald | | | VY | Vineyard View | BE | Balcony Economy | > | | | EN | Palm Manor Executive | | | WF | Waterfront | BG | Balcony SingleSaver | > | | | EP | Residence Prestige | | | WS | WaterView | BH | Balcony Honeymooners | > | | | ER | Royal Estate | | | WV | Waterfall View | BM | Balcony Reduced Mobility | > | | | ET | Earth | | | YS | City Scene | BN | Balcony Non-Refundable | > | | | EW | Escape Water | | | YV | Party View | BO | Balcony Offer | > | | | EX | Executive | | | | | BP | Balcony Promotion | > | | | FB | Beachfront | | | | | BQ | Balcony Adults Only | > | | | FC | Raffles Club | | | | | BS | Balcony Senior 55+ | > | | | FD | Fairmont Grand | | | | | BV | Balcony VipTreatment | > | | | FG | Fairmont Gold | | | | | BW | Balcony Sol | > | | | FI | Fitness | | | | | BX | Balcony Agent | > | | | FM | Fairmont | | | | | BZ | Balcony SpecialPackage | > | | | FO | Fabulous Overwater | | | | | C0 | TypeC | > | | | FS | Life Style | | | | | C5 | TypeC Action | > | | | FT | Fantastic | | | | | CB | TypeC Best-Price | > | | | FV | Fashion Victim | | | | | CC | TypeC Low Cost | > | | | FW | Reefwater | | | | | CD | TypeC Dreamer | > | | | FY | Fully Theme | | | | | CE | TypeC Economy | > | | | G1 | Gold Corner | | | | | CI | TypeC Kids Free | > | | | G2 | Gold Deluxe | | | | | CJ | TypeC Fast Pay | > | | | GB | GardenBuilding | | | | | CM | TypeC Reduced Mobility | > | | | GC | Regal Club | | | | | CN | TypeC Non-Refundable | > | | | GD | GrandDeluxe | | | | | CO | TypeC Offer | > | | | GE | Guest | | | | | CP | TypeC Promotion | > | | | GH | Grand Beach | | | | | CS | TypeC Senior 55+ | > | | | GI | Grand Imperial | | | | | CV | TypeC VipTreatment | > | | | GL | Gold | | | | | CZ | TypeC SpecialPackage | > | | | GO | Gulf Ocean | | | | | D0 | TypeD | > | | | GP | Palm Manor Grand | | | | | DB | TypeD bestprice | > | | | GR | Grand | | | | | DE | TypeD Economy | > | | | GW | Grand Water | | | | | DI | TypeD Kids Free | > | | | GX | Grand Luxury | | | | | DJ | TypeD Fast Pay | > | | | HA | Charm | | | | | DL | TypeD Lowcost | > | | | HD | Horizon Club Deluxe | | | | | DM | TypeD Reduced Mobility | > | | | HE | Heritage | | | | | DN | TypeD Non-Refundable | > | | | HM | Harmony | | | | | DO | TypeD offer | > | | | HP | Horizon Club Premier | | | | | DP | TypeD Promotion | > | | | HR | Royal Etihad | | | | | DS | TypeD Senior 55+ | > | | | HV | Haven | | | | | DV | TypeD VipTreatment | > | | | HW | Horizon Water | | | | | DZ | TypeD SpecialPackage | > | | | HY | Heavenly | | | | | E0 | TypeE | > | | | II | Infinity | | | | | EE | TypeE Economy | > | | | IN | Inspire | | | | | EN | TypeE Non-Refundable | > | | | IO | Inocean | | | | | EP | TypeE Promotion | > | | | IP | Imperial | | | | | EZ | TypeE SpecialPackage | > | | | IR | Island Residence | | | | | F0 | FrenchBalcony | > | | | IS | Island | | | | | F2 | FrenchBalcony SpaPackage | > | | | JB | Jabal | | | | | F4 | FrenchBalcony HolidayPackage | > | | | JC | Junior Club | | | | | FC | FrenchBalcony Low Cost | > | | | JT | Jet | | | | | FE | FrenchBalcony Economy | > | | | JY | Joy | | | | | FM | FrenchBalcony Reduced Mobility | > | | | KD | Khaleej Deluxe | | | | | FN | FrenchBalcony Non-Refundable | > | | | KH | Khaleej | | | | | FO | FrenchBalcony Offer | > | | | KO | Kohinoor | | | | | FP | FrenchBalcony Promotion | > | | | KP | Park | | | | | FZ | FrenchBalcony SpecialPackage | > | | | KX | Park Executive | | | | | G0 | Private-Garden | > | | | L0 | Lagoon | | | | | G5 | Private-Garden Action | > | | | LA | Platinum | | | | | GA | Private-Garden Attic | > | | | LB | Lagoon Beach | | | | | GE | Private-Garden Economy | > | | | LC | Club Scenic | | | | | GG | Private-Garden SingleSaver | > | | | LD | Palace Deluxe | | | | | GN | Private-Garden Non-Refundable | > | | | LE | Luxe | | | | | GO | Private-Garden Offer | > | | | LF | Lower Floor | | | | | GP | Private-Garden Promotion | > | | | LI | Life | | | | | GQ | Private-Garden Adults Only | > | | | LM | Landmark | | | | | GZ | Private-Garden SpecialPackage | > | | | LO | Overwater Lagoon | | | | | H0 | With Jacuzzi | > | | | LP | Lagoon Prestige | | | | | H5 | With Jacuzzi Action | > | | | LR | Club Rotana | | | | | HA | With Hammam | > | | | LS | Standard Lagoon | | | | | HE | With Jacuzzi Economy | > | | | LU | Luux | | | | | HH | With Jacuzzi Honeymooners | > | | | LV | Level | | | | | HN | With Jacuzzi Non-Refundable | > | | | LW | Laamu Water | | | | | HO | With Jacuzzi Offer | > | | | LX | Luxury | | | | | HP | With Jacuzzi Promotion | > | | | MA | Maharaja | | | | | HV | With Jacuzzi VipTreatment | > | | | MB | MainBuilding | | | | | HZ | With Jacuzzi SpecialPackage | > | | | MJ | Majestic | | | | | I0 | Private Pool - Domestic Flight | > | | | ML | Premium V Level | | | | | IH | Private Pool - Domestic Flight Honeymooners | > | | | MM | Semi-Basement | | | | | J0 | Private Jacuzzi Terrace | > | | | MN | Manta | | | | | J2 | Private Jacuzzi Terrace SpaPackage | > | | | MO | Premium Ocean | | | | | JE | Private Jacuzzi Terrace Economy | > | | | MP | Palm Manor Premier | | | | | JH | Private Jacuzzi Terrace Honeymooners | > | | | MQ | Premium Unique | | | | | JM | Private Jacuzzi Terrace Reduced Mobility | > | | | MR | Mandarin | | | | | JN | Private Jacuzzi Terrace Non-Refundable | > | | | MT | Master | | | | | JO | Private Jacuzzi Terrace Offer | > | | | MV | Marvelous | | | | | JP | Private Jacuzzi Terrace Promotion | > | | | MW | Semi Water | | | | | JS | Private Jacuzzi Terrace Senior 55+ | > | | | MZ | Mezzanine | | | | | JU | Slilts | > | | | NA | Al Naseem Tented Beach | | | | | JV | Private Jacuzzi Terrace VipTreatment | > | | | NB | Nirvana Beach | | | | | JZ | Private Jacuzzi Terrace SpecialPackage | > | | | NE | Anelia | | | | | K0 | Private Pool - Seaplane | > | | | NL | All Night Long | | | | | KH | Private Pool - Seaplane Honeymooners | > | | | NS | New Style | | | | | L0 | 2 Bathrooms | > | | | NT | Nature | | | | | LE | 2 Bathrooms Economy | > | | | O0 | Ocean | | | | | LN | 2 Bathrooms Non-Refundable | > | | | O1 | Ocean Club Superior | | | | | LO | 2 Bathrooms Offer | > | | | O2 | Ocean Premier | | | | | LP | 2 Bathrooms Promotion | > | | | OB | Ocean Beach | | | | | M0 | 3 bathrooms | > | | | OC | Ocean Club | | | | | MN | 3 bathrooms Non-Refundable | > | | | OD | Ocean Deluxe | | | | | N0 | NonSmoking | > | | | OF | Fabulous | | | | | NE | Non-Smoking Economy | > | | | OL | Ocean Lagoon | | | | | NM | Non-Smoking Reduced Mobility | > | | | OM | Ocean Romantic | | | | | NN | NonSmoking Non-Refundable | > | | | ON | Coccoon | | | | | O0 | Private Pool - Speedboat | > | | | OO | Overwater Ocean | | | | | ON | Private Pool - Speedboat Non-Refundable | > | | | OP | Opera | | | | | P0 | Private-PoolTerrace | > | | | OR | Ocean Reef | | | | | P2 | Private-PoolTerrace SpaPackage | > | | | OS | Ocean Residence | | | | | PB | Private-PoolTerrace Best-Price | > | | | OT | Ocean Terrace | | | | | PE | Private-PoolTerrace Economy | > | | | OW | Overwater | | | | | PH | Private-PoolTerrace Honeymooners | > | | | P0 | Premier Overwater | | | | | PN | Private-PoolTerrace Non-Refundable | > | | | P1 | Premier | | | | | PO | Private-PoolTerrace Offer | > | | | P2 | Palace | | | | | PP | Private-PoolTerrace Promotion | > | | | P3 | Pearl Club | | | | | PV | Private-PoolTerrace VipTreatment | > | | | P4 | Plus | | | | | PZ | Private-PoolTerrace SpecialPackage | > | | | PA | Pearl | | | | | Q0 | Shared-PoolTerrace | > | | | PB | ParkBuilding | | | | | Q3 | Shared-PoolTerrace ThallasoPackage | > | | | PD | Palace Superior Deluxe | | | | | QN | Shared-PoolTerrace Non-Refundable | > | | | PE | SuperiorSerenity | | | | | QO | Shared-PoolTerrace Offer | > | | | PG | Palace Gold Club | | | | | QP | Shared-PoolTerrace Promotion | > | | | PH | Plush | | | | | QV | Shared-PoolTerrace VipTreatment | > | | | PI | Premium Indulgence Water | | | | | R0 | Private Pool | > | | | PK | Pocket | | | | | R5 | Private Pool Action | > | | | PL | Priority Location | | | | | RB | Private Pool Best-Price | > | | | PM | Premium | | | | | RD | Private Pool Dreamer | > | | | PN | Prince | | | | | RE | Private Pool Economy | > | | | PO | Popular | | | | | RH | Private Pool Honeymooners | > | | | PP | Palapa | | | | | RM | Private Pool Reduced Mobility | > | | | PQ | Superior-Unique | | | | | RN | Private Pool Non-Refundable | > | | | PR | Prestige | | | | | RO | Private Pool Offer | > | | | PS | Presidential | | | | | RP | Private Pool Promotion | > | | | PT | Premium Water | | | | | S0 | SharedTerrace | > | | | PU | Superior Upper Floor | | | | | SH | SharedTerrace Honeymooners | > | | | PV | Privilege | | | | | SP | SharedTerrace Promotion | > | | | PW | Prestige Water | | | | | SR | Smoking Room | > | | | PX | Palace Executive | | | | | SS | SharedTerrace Senior 55+ | > | | | PY | Palace Royal | | | | | T0 | Terrace | > | | | R0 | Resort | | | | | T1 | Terrace GolfPackage | > | | | R1 | Resort Deluxe | | | | | T4 | Terrace HolidayPackage | > | | | R2 | Resort Superior | | | | | T8 | Terrace ServicePackage | > | | | R3 | Resort Standard (ROH) | | | | | TA | Terrace Attic | > | | | R4 | Resort (ROH) | | | | | TB | Terrace Best-Price | > | | | R5 | Resort Superior (ROH) | | | | | TC | Terrace Low Cost | > | | | R6 | Rabdan | | | | | TE | Terrace Economy | > | | | RA | Adapted Room | | | | | TH | Terrace Honeymooners | > | | | RB | ResortBuilding | | | | | TM | Terrace Reduced Mobility | > | | | RC | RoyalClub | | | | | TN | Terrace Non-Refundable | > | | | RE | Reethi | | | | | TO | Terrace Offer | > | | | RF | Reethi Faru | | | | | TP | Terrace Promotion | > | | | RH | RunOfHouse | | | | | TQ | Terrace Adults Only | > | | | RI | Al Rimal | | | | | TT | Terrace Student | > | | | RL | Residence Lagoon | | | | | TV | Terrace VipTreatment | > | | | RN | Regency | | | | | TW | Terrace Sol | > | | | RO | Romantic | | | | | TZ | Terrace SpecialPackage | > | | | RP | RoyalSuperior | | | | | U0 | SwimUp-PoolTerrace | > | | | RR | Rock Royalty | | | | | UE | SwimUp-PoolTerrace Economy | > | | | RS | Residence | | | | | UH | SwimUp-PoolTerrace Honeymooners | > | | | RT | Royal Club Tower | | | | | UN | SwimUp-PoolTerrace Non-Refundable | > | | | RU | Regency Executive | | | | | UO | SwimUp-PoolTerrace Offer | > | | | RW | Residence Overwater | | | | | UP | SwimUp-PoolTerrace Promotion | > | | | RX | RoyalSuperiorClub | | | | | UQ | SwimUp-PoolTerrace Adults Only | > | | | RY | Royal | | | | | UV | SwimUp-PoolTerrace VipTreatment | > | | | S0 | Spectacular | | | | | UZ | SwimUp-PoolTerrace SpecialPackage | > | | | S1 | Standard Beach | | | | | V0 | With Jacuzzi - Seaplane | > | | | S2 | Semi-Detached | | | | | VE | With Jacuzzi - Seaplane Economy | > | | | S3 | Sultan | | | | | VP | With Jacuzzi - Seaplane Promotion | > | | | S4 | Silver | | | | | VR | With Veranda | > | | | S5 | Sunset | | | | | W0 | Without Balcony-Terrace | > | | | S6 | Secret | | | | | WB | Without Balcony-Terrace Best-Price | > | | | S7 | Split Level | | | | | WC | Without Balcony-Terrace Low Cost | > | | | SA | Al Sahari Secluded | | | | | WD | Without Balcony-Terrace Dreamer | > | | | SB | Superior Beach | | | | | WE | Without Balcony-Terrace Economy | > | | | SC | SuperiorClub | | | | | WG | Without Balcony-Terrace SingleSaver | > | | | SD | Standard | | | | | WH | Without Balcony-Terrace Honeymooners | > | | | SE | Serenity | | | | | WK | With Kitchenette | > | | | SF | Soneva Fushi | | | | | WM | Without Balcony-Terrace Reduced Mobility | > | | | SG | Signature | | | | | WN | Without Balcony-Terrace Non-Refundable | > | | | SH | Superior Charm Beach | | | | | WO | Without Balcony-Terrace Offer | > | | | SK | Sky | | | | | WP | Without Balcony-Terrace Promotion | > | | | SL | Select | | | | | WS | Without Balcony-Terrace Senior 55+ | > | | | SM | Superior MainBuilding | | | | | WV | with Premium Veranda and Sharing Pool | > | | | SN | Sun | | | | | WZ | Without Balcony-Terrace SpecialPackage | > | | | SO | Superior Overwater | | | | | X0 | Seaplane | > | | | SP | Superior | | | | | XH | Seaplane Honeymooners | > | | | SQ | Sun Aqua | | | | | XP | Seaplane Promotion | > | | | SR | St. Regis | | | | | Y0 | Plunge Pool | > | | | SS | Spa Sanctuary | | | | | YN | Plunge Pool Non-Refundable | > | | | ST | Saadiyat | | | | | YP | Plunge Pool Promo | > | | | SU | Standard Upper Floor | | | | | YV | Plunge Pool VipTreatment | > | | | SV | Superior Vista | | | | | Z0 | With Jacuzzi - Domestic Flight | > | | | SW | Sangu Water | | | | | | | > | | | SX | Super Deluxe | | | | | | | > | | | SY | Speciality | | | | | | | > | | | TB | Standalone Beach | | | | | | | > | | | TC | TowerClub | | | | | | | > | | | TD | Traders Deluxe | | | | | | | > | | | TH | Theme | | | | | | | > | | | TM | Traders Premier | | | | | | | > | | | TO | Tower | | | | | | | > | | | TP | Traders Superior | | | | | | | > | | | TR | Tree | | | | | | | > | | | TS | Superior Tower | | | | | | | > | | | TT | Treeptop | | | | | | | > | | | TV | Tryp VYP | | | | | | | > | | | TY | Tryp | | | | | | | > | | | UF | Upper Floor | | | | | | | > | | | UL | Superior V Level | | | | | | | > | | | UP | Supreme | | | | | | | > | | | UQ | Unique | | | | | | | > | | | UT | Ultra | | | | | | | > | | | VN | Venetian | | | | | | | > | | | VR | Red Level | | | | | | | > | | | W0 | Water | | | | | | | > | | | W1 | World (ROH) | | | | | | | > | | | W2 | World Standard (ROH) | | | | | | | > | | | WA | Waldorf Astoria | | | | | | | > | | | WB | Wonderful Beach | | | | | | | > | | | WD | Wind | | | | | | | > | | | WE | E-Wow | | | | | | | > | | | WF | Wonderful | | | | | | | > | | | WL | Wellness | | | | | | | > | | | WO | Wow Ocean Escape | | | | | | | > | | | WP | Presidential Water | | | | | | | > | | | WS | Superior Water | | | | | | | > | | | WW | Wow | | | | | | | > | | | XC | Exclusive | | | | | | | > | | | XL | Relax | | | | | | | > | | | XO | Deluxe Overwater | | | | | | | > | | | XP | Premier Deluxe | | | | | | | > | | | XR | Residence Executive | | | | | | | > | | | XS | Deluxe Scenic | | | | | | | > | | | XW | Extreme Wow Ocean Haven | | | | | | | > | | | YG | Yas Grand | | | | | | | > [accordion] Hotel Board Codes > > | Board | Description | > | :- | :- | > | AI | All Inclusive | > | AI+ | All Inclusive Plus | > | AI- | All Inclusive Light | > | AIU | Ultra All Inclusive | > | BB | Bed & Breakfast | > | DO | Dinner Only | > | FB | Full Board | > | FB+ | Full Board Plus | > | HB | Half Board | > | HB+ | Half Board Plus | > | LO | Lunch Only | > | RO | Room Only | > | DB | Dinner Buffet | > | SC | Self Catering | > | AP | According to Programme\* | > > \* This board is used in accommodation packages only. ## Excursion Related Codes > [accordion] Excursion Category Codes > > | Code | Name | Description | > | :- | :- | :- | > | AT | Air Tours | Planes, Helicopters, Ballooning... | > | BN | Bars, Wine, & Nightlife | Entrances, Wine Tastings, Rentals... | > | BT | Boat Tours | Cruising, Yachting, Boat Trips, Fishing Trips... | > | CP | Custom & Private | Custom & Private activities | > | EX | Excursions | Packaged day trip with programme | > | GF | Golf | Courses, Green Fees... | > | MM | Museums & Monuments | Museums & Monuments | > | OA | Outdoor Activities | Bike or Horse Rides, Walking Tours, Segway Rentals, Climbing, Paintball... | > | RS | Restaurants | Breakfast, Beverages, Meals... | > | SE | Shows & Events | Dinner Shows, Sport Events, Concerts... | > | SF | Safaris | Jeep, Buggy, Quad, etc.. | > | SS | Ski & Snow | Skiing, Snowboarding and other Winter Activities | > | TP | Theme Parks | Theme Parks | > | TT | Sightseeing & Tours | Sightseeing Tours, Coach Tour, Shopping Tour... | > | WS | Wellness & Spa | Wellness Spots, Spas, Hammam, Beauty Salons, Personal Trainer… | > | WW | Water & Wind | Diving, Surfing, Jet Skiing, Snorkeling, Kayaking, Rafting, Flyboard... | > [accordion] Excursion Type Codes > > | Code | Description | > | :- | :- | > | LA | Leisure & Activities | > | XA | Excursions & Activities | > [accordion] Excursion Service Codes > > | Code | Description | > | :- | :- | > | AI | All Inclusive | > | AP | According To Programme | > | BB | Breakfast | > | DA | Dinner + Alcoholic drinks | > | DS | Dinner + Softdrinks | > | FB | Fullboard | > | FD | Fullday | > | FH | Full Hour | > | HB | Halfboard | > | HD | Halfday | > | HH | Half Hour | > | IN | Inbound | > | LA | Lunch + Alcoholic drinks | > | LS | Lunch + Softdrinks | > | OT | Outbound | > | OW | One Way | > | RT | Return | > | SO | Snacks | > | TDO | incl. dropOff only | > | TFP | incl. transfer by provider | > | THG | Hotel Guest | > | TIC | ticket only / no transport | > | TNH | Non Hotel Guest | > | TPU | incl. pickUp only | > | TRF | incl. pickUp & dropOff / pick-up & drop-off transport incl. | > | TRP | incl. transfer by provider | > | TRV | incl. private transfer | > | WD | Dinner Included | > | WL | Lunch Included | > | WT | Wine Tasting Included | > | XO | Excursion Only | > [accordion] Excursion Supplier Product Code > > There are currently 3.624 codes. Multilingual description is provided in the messages. Please request codelist if required. Below are listed only the most used ones for your reference: > > | Service | Description | > | :- | :- | > | TIC | Ticket Only | > | TRF | Includes hotel pick-up-drop-off - generic | > | TRP | Includes transfer by provider | > | TPU | incl. pick-up only | > | TDO | incl. drop-off only | > | TRV | incl. private transfer | > | TFP | incl. transfer by provider | > [accordion] Activity Codes > > | Category | Category name | SourceID | Description | > | :- | :- | :- | :- | > | EX\_DIFFIC | Difficulty | EX\_DIF\_1 | Easy | > | EX\_DIFFIC | Difficulty | EX\_DIF\_2 | Moderate | > | EX\_DIFFIC | Difficulty | EX\_DIF\_3 | Hard | > | EX\_INCL | What's included | EX\_INCL\_ALLADM | All admissions to sights | > | EX\_INCL | What's included | EX\_INCL\_DRINK | Drinks | > | EX\_INCL | What\`s included | EX\_INCL\_FOOD | Meals | > | EX\_INCL | What\`s included | EX\_INCL\_HPD | Hotel pick-up and drop-off | > | EX\_INCL | What\`s included | EX\_INCL\_O | Other: | > | EX\_INCL | What\`s included | EX\_INCL\_SNACKS | Snacks | > | EX\_INCL | What\`s included | EX\_INCL\_TG | Guide | > | EX\_INCL | What\`s included | EX\_INCL\_TIPS | Gratuities | > | EX\_INCL | What\`s included | EX\_INCL\_TRF | Transport | > | EX\_INCL | What\`s included | EX\_INCL\_WATER | Bottle of water | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_DCODE | Dress Code required | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_DLICENCE | Driving License required | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_OTHER | Other: | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_PADI | PADI certificate required | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_PASSID | Passport/ID required | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_SHOES | Comfortable Shoes | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_SUB | Sun protection | > | EX\_NEEDED | What\`s needed | EX\_NEEDED\_SWIM | Swimsuit | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_ADM | Admissions to optional sites | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_DRINK | Drinks | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_FOOD | Meals | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_HPD | Hotel pickup and drop-off (optional) | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_O | Other: | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_TG | Guide | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_TIPS | Gratuities (optional) | > | EX\_NOTINCL | What\`s not included | EX\_NOTINCL\_TRF | Transport | > | EX\_TARGET | Audience | EX\_TARGET\_ADTO | Adults Only | > | EX\_TARGET | Audience | EX\_TARGET\_ALL | Anybody | > | EX\_TARGET | Audience | EX\_TARGET\_COUPLES | Couples | > | EX\_TARGET | Audience | EX\_TARGET\_FAMILY | Families | > | EX\_TARGET | Audience | EX\_TARGET\_FRIENDS | Friend Groups | > | EX\_THEME | Theme | EX\_THEME\_CULTURE | Cultural | > | EX\_THEME | Theme | EX\_THEME\_ENTERT | Entertainment | > | EX\_THEME | Theme | EX\_THEME\_NATURE | Nature Lovers | > | EX\_THEME | Theme | EX\_THEME\_PARTYING | Partying | > | EX\_THEME | Theme | EX\_THEME\_RELAXING | Relaxing | > | EX\_THEME | Theme | EX\_THEME\_SHOP | Good for Shopping | > | EX\_THEME | Theme | EX\_THEME\_SIGHTS | Sightseeing | > | EX\_THEME | Theme | EX\_THEME\_SPORT | Adventurous | > | EX\_THEME | Theme | EX\_THEME\_WATER | Water Activities | > | EXCURSION | Key Details | EX\_CIRTIME | Reporting/Check-In time prior to service | > | EXCURSION | Key Details | EX\_ICONF | Instant Confirmation | > | EXCURSION | Key Details | EX\_LANGSPOKEN | Languages spoken | > | EXCURSION | Key Details | EX\_MVOUCHER | Mobile Voucher accepted | > | EXCURSION | Key Details | EX\_OTHERD | Other: | > | EXCURSION | Key Details | EX\_PVOUCHER | Printed Voucher accepted | > | EXCURSION | Key Details | EX\_WHEELCHAIR | Wheelchair Accessible | ## Transfer Related Codes > [accordion] Vehicle Codes > > | Type | | | Grade | | | Subtype | | | Base | | | > | :- | :- | :- | :- | :- | :- | :- | :- | :- | :- | :- | :- | > | **Code** | **Name** | **OTA** | **Code** | **Name** | **OTA** | **Code** | **Name** | **OTA** | **Code** | **Name** | **OTA** | > | S | Shared | 90 | 0 | standard | 5 | 0 | Undefined | | 00 | Undefined | | > | P | Private | 91 | L | Luxury | 4 | B | Bus | 25 | MG | meet & greet | | > | | | | P | Premium | 90 | M | Minibus | 91 | XL | extra-luggage | | > | | | | D | Direct | 91 | V | Van | 2 | 04 | 4 Seater | 104 | > | | | | S | Speedy | 92 | T | Taxi | 90 | 06 | 6 Seater | 106 | > | | | | X | Executive | 93 | C | Car | 1 | 20 | 20 Seater | 120 | > | | | | W | Wheelchair Adapted | 94 | L | Limousine | 7 | XX | XX Seater | 1xx | > | | | | V | VIP | | S | SUV | | LL | Luggage | | > | | | | A | Vintage | 95 | W | WaterTaxi | | 11 | 11 seater | | > | | | | R | Rapid | | Z | Strech Limo | | 13 | 13 seater | | > | | | | B | Large | | 1 | Shuttle | | 14 | 14 seater | | > | | | | E | Economy | | 4 | 4x4 | | | | | > | | | | G | On the go | | 9 | Special Vehicle | | | | | > | | | | M | Small | | 2 | Luxury Boat | | | | | > | | | | I | Elite | | 3 | Speedboat | | | | | > | | | | H | Electric | | 5 | Seaplane | | | | | > | | | | | | | 6 | Domestic flight | | | | | > | | | | | | | H | Helicopter | | | | | > [accordion] Car Codes > > | Category | | Type | | Transmission/Drive | | Fuel/AirCon | | > | :- | :- | :- | :- | :- | :- | :- | :- | > | **Code** | **Description** | **Code** | **Description** | **Code** | **Description** | **Code** | **Description** | > | M | Mini | A | 2-3 Door | M | Manual | R | Unspecified Fuel/Power With Air | > | N | Mini Elite | C | 2/4 Door | C | Manual 4WD | N | Unspecified Fuel/Power Without Air | > | E | Economy | D | 4-5 Door | A | Auto Unspecified Drive | D | Diesel Air | > | H | Economy Elite | W | Wagon/Estate | B | Auto 4WD | Q | Diesel No Air | > | C | Compact | V | Passenger Van | D | Auto AWD | H | Hybrid Air | > | D | Compact Elite | L | Limousine | | I | Hybrid No Air | | > | I | Intermediate | S | Sport | | | E | Electric Air | > | J | Intermediate Elite | T | Convertible | | | C | Electric No Air | > | S | Standard | F | SUV | | | L | LPG/Compressed Gas Air | > | R | Standard Elite | J | Open Air All Terrain | | | S | LPG/Compressed Gas No Air | > | F | Fullsize | X | Special | | | A | Hydrogen Air | > | G | Fullsize Elite | P | Pick up Regular Cab | | | B | Hydrogen No Air | > | P | Premium | Q | Pick up Extended Cab | | | M | Multi Fuel/Power Air | > | U | Premium Elite | Z | Special Offer Car | | | F | Multi Fuel/Power No Air | > | L | Luxury | E | Coupe | | | V | Petrol Air | > | W | Luxury Elite | M | Monospace | | | Z | Petrol No Air | > | O | Oversize | R | Recreational Vehicle | | | U | Ethanol Air | > | X | Special | Y | Motor Home | | | X | Ethanol No Air | > | | | Y | 2 Wheel Vehicle | | | | | > | | | N | Roadster | | | | | > | | | G | Crossover | | | | | > | | | K | Commercial Van/Truck | | | | | > [accordion] Specific Car Codes > > | Code | Definition | Category | Type | Transmission/Drive | Fuel/AirCon | > | :- | :- | :- | :- | :- | :- | > | ACAR | Any Standard Vehicle | Any | Any except K, Y, R & H | Any | Any | > | ALLB | 2-3 Door | Any | B, C, E or N | Any | Any | > | ALLC | 2 or 4 Door | Any | Any Except R, H, Y, K P or Q | Any | Any | > | ALLD | 4-5 Door | Any | D, F, G L V or W | Any | Any | > | AELT | Any Elite | N H D J R G U W | Any | Any | Any | > | ACPR | Couple/Roadster | E or N | Any | Any | Any | > | ASPC | Non-Standard Fleet | Any | Any | Any | Any | > | APUP | Pickup | Any | Q or P | Any | Any | > | AWGN | Estate/Wagon | Any | V F W G | Any | Any | > | AREC | Recreational Vehicle | Any | F | Any | Any | > | ASUV | Any SUV | Any | F | Any | Any | > | AVAN | Passenger Van | Any | V | Any | Any | > | ASIX | Any 6+ Pax Van | I J S R F G P U L W X O | V | Any | Any | > | ASEV | Pax van | S R F G P U L W X O | V | Any | Any | > | AEIG | Pax+Van | P U L W X O | V | Any | Any | > | ANIN | Pax+Van | L W X O | V | Any | Any | > | AFWD | Any 4WD/AWD | Any | Any | N, C, B or D | Any | > | ATRV | All Terrain | Any | J | Any | Any | > | ACGO | Commercial Truck | Any | K | Any | Any | > | ALMO | Limousine | Any | L | Any | Any | > | ASPT | Sport | Any | S | Any | Any | > | ACNV | Convertible | Any | T | Any | Any | > | AOFR | Special Offer Car | Any | Z | Any | Any | > | AMNO | Monospace | Any | M | Any | Any | > | AMTO | Motor Home | Any | H | Any | Any | > | AMCY | 2-Wheel Vehicle | Any | Y | Any | Any | > | ACRS | Crossover | Any | G | Any | Any | > | AMAN | All Manual Transmission | Any | Any | M, N, C | Any | > | AUTO | All Automatic Transmission | Any | Any | A, B, D | Any | > | APET | All Petrol Powered Vehicles | Any | Any | Any | N, V, R, Z | > | ADSL | All Diesel Powered Vehicles | Any | Any | Any | D, Q | > | AGRN | Any Lower Emission Vehicles (Hybrid, Electric, LPG, Hydrogen, Ethanol, Multi Fuel) | Any | Any | Any | H, I, E, C, L, S, A, B, M, F, U, X | > | AHYB | All Hybrid Vehicles | Any | Any | Any | H, I | > | AELC | All Electric Powered Vehicles | Any | Any | Any | E, C | > | AHYD | All Hydrogen Powered Vehicles | Any | Any | Any | A, B | > | AMFP | All Multi Fuel Powered Vehicles | Any | Any | Any | M, F | > | ACPG | All LPG/Compressed Gas-Powered Vehicles | Any | Any | Any | L, S | > | AETH | All Ethanol-Powered Vehicles | Any | Any | Any | U, X | # Error Scenarios Source: https://docs.axisdata.net/glossary/errors ## Error Scenarios This section describes the most common and important errors and causes that can be found in our B2B interface. An error is considered when the response has the following format: ```xml theme={null} Invalid hotel code ``` What do we see? * No `Success` element present in the response. * An `Errors` element containing all encountered errors from the request. * A `Code` that identifies each type of error. * A brief description of the cause. > [!WARNING] > > Not every single error is present in this page, only the common and important ones. If needed, when "unknown" errors are returned, contact Integrations. ### Price Price related error responses or incidences. > [accordion] Price differences > > * Case: Price retrieved from the Cache file or XML interface does not match with the price received in a quote response. > * Error received: None. > * Test steps: > * Do a search for hotel xxx, room xxx, board xxx from xxx to xxx, get details. > * Do a following search or quote for hotel xxx, room xxx, board xxx from yyy to yyy, price will mismatch. Take time ranges from different seasons to force the error. > * Complete error response: N/A. ### Availability Availability related error responses or incidences. > [accordion] Max number of multi-room > > * **Case**: Search, quote or commit has more than 5 rooms. > * **Error received**: > * Type 3 > * Code 378 > * Detail: Invalid - max number of rooms (5) exceeded > * **Test steps**: > * Do a search or quote for more than 5 rooms, return error and ensure proceeding to Commit is not possible. > * **Complete error response**: > ```xml theme={null} > > > Invalid - max number of rooms (5) exceeded > > > ``` > [accordion] Stop Sales > > * **Case**: After doing a book request system returns "Stop Sale" error. This can happen when the stop sales in contract was activated after a succesful search (pull) or after the last delivered file (push). > * **Error received**: > * Type 3 > * Code 158 > * Detail: Stop-Sale: HOTEL\_CODE-HOTEL\_NAME > * **Test steps**: > * Do a quote for room with Stop Sales. Contact integrations if the case is needed. > * **Complete error response**: > ```xml theme={null} > > > Stop-Sale: AMTSES0008-Garden Beach > > > ``` > [accordion] Close out > > * **Case**: After doing a book request system returns "Close Out" error. This can happen when the close out in contract was activated after a succesful search (pull) or after the last delivered file (push). > * **Error received**: > * Type 3 > * Code 507, 508 > * Detail: > * NotAvailable. Room Restrictions failed: Restriction 1, DateRestriction 1 - stay start failure > * NotAvailable. Room Restrictions failed: Restriction 1, DateRestriction 1 - stay end failure > * **Test steps**: > * Very uncommon case, if test is required it needs to be forced, contact integrations. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Room Restrictions failed: Restriction 1, DateRestriction 1 - stay start failure > NotAvailable. Room Restrictions failed: Restriction 1, DateRestriction 1 - stay end failure > > > ``` > [accordion] Not enough availability > > * **Case**: Room no longer available, last room for the specified dates sold, subsequent requests fail with an availability error. > * **Error received**: > * Type 3 > * Code 5000 > * Detail: NotAvailable. Insufficient remaining allotments > * **Test steps**: > * Do a quote for a room with 0 allotment. Contact integrations if the case is needed. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Insufficient remaining allotments > NotAvailable. SubAllotment: insufficient remaining allotments for requested hotel AMTSES0FDO, room JSSD00SVA0 and board code > NotAvailable. SubAllotment: insufficient remaining allotments for requested hotel AMTSES0FDO, room JSSD00SVA0 > > > ``` > [accordion] Invalid hotel code > > * **Case**: Hotel code not specified or wrong code element construction. > * **Error received**: > * Type 3 > * Code 392 > * Detail: Invalid hotel code > * **Test steps**: > * Do a quote for room xxx, board xxx from xxx to xxx without the HotelCode element or leaving it empty. > * **Complete error response**: > ```xml theme={null} > > > Invalid hotel code > > > ``` > [accordion] Hotel no longer available > > * **Case**: Hotel no longer available, hotel not assigned to the portfolio. > * **Error received**: > * Type 3 > * Code 14 > * Detail: No suitable services found > * **Test steps**: > * Do a search for hotel xxx, room that does not exist, board xxx from xxx to xxx, get details for hotel not existent, service not available error will be returned. > * **Complete error response**: > ```xml theme={null} > > > No suitable services found > > > ``` > [accordion] Missing room code > > * **Case**: Room code not specified or not following room code element structure. > * **Error received**: > * Type 3 > * Code 402 > * Detail: Invalid room type > * **Test steps**: > * Do a quote without the RoomCode element or leaving it empty. > * **Complete error response**: > ```xml theme={null} > > > Invalid room type > > > ``` > [accordion] Room no longer available > > * **Case**: Room no longer available, room not available for a specific hotel. > * **Error received**: > * Type 3 > * Code 14 > * Detail: Invalid service unit: ROOM\_CODE. Valid unit codes for HOTEL\_CODE: ROOM\_CODE\_LIST > * **Test steps**: > * Do a search for hotel xxx, wrong room, board xxx from xxx to xxx, get details. > * Do a following search or quote for hotel yyy, wrong room, board xxx from xxx to xxx, room not available error returned with a list of available rooms. > * **Complete error response**: > ```xml theme={null} > > > > Invalid service unit: APSDDM00A0. Valid unit codes for AMTSES0Z7K: APSD0000A0, APSD0000A0, APSD00SV00, APSD00SV00, APSDIN00A0, APSDIN00A0! > > > > ``` > [accordion] Board code missing or wrong > > * **Case**: Board code not specified or not following room code element structure. > * **Error received**: > * Type 3 > * Code 115 > * Detail: Invalid board basis/meal plan > * **Test steps**: > * Do a quote without the Board Code element or leaving it empty. > * **Complete error response**: > ```xml theme={null} > > > Invalid board basis/meal plan > > > ``` > [accordion] Board no longer available > > * **Case**: Board no longer available, board not available for a specific hotel and/or room. > * **Error received**: > * Type 3 > * Code 14 > * Detail: Invalid board: BOARD\_CODE. Valid boards for product HOTEL\_CODE and unit ROOM\_CODE: BOARD\_CODE\_LIST > * **Test steps**: > * Do a search for hotel xxx, room xxx, wrong board from xxx to xxx, get details. > * Do a following search or quote for hotel xxx, room xxx, wrong board from xxx to xxx, board not available error returned with a list of available boards. > * **Complete error response**: > ```xml theme={null} > > > > Invalid board: SC. Valid boards for product AAEFJR1WHS and unit RMCSDB00B0: AI,BB,FB,HB,RO > > > > ``` > [accordion] Not available (empty response) > > * **Case**: No hotels/transfers/excursions available for specified parameters. > * **Error received**: > * Type: N/A > * Code: N/A > * Detail: Empty response > * **Test steps**: > * Do a search with correct but not existent parameters. > * **Complete error response**: > ```xml theme={null} > > > > No rooms available for requested dates > > > > > > > No services available for requested dates > No services available for requested dates > > > > > > > No Amenities available for requested dates > > > ``` > [accordion] Release error > > * **Case**: Release condition not accomplished. Request date is too close to the booking start date, restriction defined at room or hotel level. > * **Error received**: > * Type 3 > * Code 515, 415 > * Detail: > * NotAvailable. Room Restrictions failed: Restriction 1, DateRestriction 1 - release time failure > * NotAvailable. Hotel Restrictions failed: Restriction 1, DateRestriction 1 - release time failure > * **Test steps**: > * Do a quote for hotel with release, 1 day prior to the start date, release error will be returned. Contact integrations if the case is needed. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Room Restrictions failed: Restriction 1, DateRestriction 1 - release time failure > > > > > > NotAvailable. Hotel Restrictions failed: Restriction 1, DateRestriction 1 - release time failure > > > ``` > [accordion] Unavailable, allotment status > > * **Case**: Allotment status is not open; allotment is set to OnRequest, StopSale or closed. > * **Error received**: > * Type 3 > * Code 5200, 5100, 5300 > * Detail: > * NotAvailable. Allotment Closed > * NotAvailable. Allotment OnRequest > * NotAvailable. Allotment StopSale > * **Test steps**: > * Very uncommon case, if test is required it needs to be forced, contact integrations. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Allotment Closed > NotAvailable. SubAllotment: allotment closed for requested hotel AMTSES0S6S, room RM00CRMV00 and board code > NotAvailable. SubAllotment: allotment closed for requested hotel AMTSES0S6S, room RM00CRMV00 > > > > > > NotAvailable. Allotment OnRequest > NotAvailable. SubAllotment: allotment on request for requested hotel AMTSBG2AXK, room RMSD00000E and board code > > > > > > NotAvailable. Allotment StopSale > NotAvailable. SubAllotment: insufficient remaining allotments > NotAvailable. SubAllotment: insufficient remaining allotments for requested hotel AMTSES0F74, room RM00CRMV00 and board code > NotAvailable. SubAllotment: allotment stop sale for requested hotel AMTSES0F74, room RM00CRMV00 > > > ``` ### Occupancy Occupancy related error responses or incidences. > [accordion] Pax details are incomplete > > * **Case**: Pax names are missing or child age is not provided for AgeQualifyingCode 7 and 8. > * **Error received**: > * Type 3 > * Code 27 > * Detail: Passenger details are mandatory > * **Test steps**: > * Do a search for hotel xxx, room xxx, board xxx from xxx to xxx and xxx adults, get details. > * Do a following search or quote for hotel xxx, room xxx, board xxx from xxx to xxx and YYY adults, without specifying first name and/or last name. > * **Complete error response**: > ```xml theme={null} > > > Passenger details are mandatory > > > ``` > [accordion] Pax can’t be allocated > > * **Case**: Pax number is over or under the limits of the room, the room cannot hold the pax requested. > * **Error received**: > * Type 3 > * Code 14 > * Detail: > * Invalid occupancy. No. of pax (ACTUAL\_PAX\_NUMBER) exceeds the maximum allowed! (MAX\_PAX\_NUMBER) > * Invalid occupancy. No. of pax (ACTUAL\_PAX\_NUMBER) falls below the minimum required! (MIN\_PAX\_NUMBER) > * **Test steps**: > * Do a search for hotel xxx, room xxx, board xxx from xxx to xxx and xxx adults, get details. > * Do a following search or quote for hotel xxx, room xxx, board xxx from xxx to xxx and YYY+5 adults, room can’t hold that number of pax. > * **Complete error response**: > ```xml theme={null} > > > Invalid occupancy. No. of pax (4) exceeds the maximum allowed! (3) > > > > > > Invalid occupancy. No. of pax (1) falls below the minimum required! (2) > > > ``` > [accordion] Pax type can’t be allocated > > * **Case**: Pax type is over or under the limits of the room, the room cannot hold the pax type requested. > * **Error received**: > * Type 3 > * Code 14 > * Detail: > * Invalid occupancy. No. of PAX\_TYPE (PAX\_TYPE\_NUMBER) exceeds the maximum allowed! (MAX\_PAX\_TYPE\_NUMBER) > * Invalid occupancy. No. of PAX\_TYPE (PAX\_TYPE\_NUMBER) falls below the minimum required! (MIN\_PAX\_TYPE\_NUMBER) > * **Test steps**: > * Do a search for hotel xxx, room xxx, board xxx from xxx to xxx with xxx child, get details. > * Do a following search or quote for hotel xxx, room xxx, board xxx from xxx to xxx and YYY children, room can’t hold children. > * **Complete error response**: > ```xml theme={null} > > > Invalid occupancy. No. of children (1) exceeds the maximum allowed! (0) > > > > > > Invalid occupancy. No. of adults (1) falls below the minimum required! (2) > > > ``` > [accordion] Invalid occupancy > > * **Case**: A restriction for a specific occupancy has been set, quote for that specific occupation will fail. > * **Error received**: > * Type 3 > * Code 209 > * Detail: NotAvailable. Invalid Occupancy: combination of adults+children not allowed > * **Test steps**: > * Very uncommon case, if test is required it needs to be forced, contact integrations. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Invalid Occupancy: combination of adults+children not allowed > Invalid Occupancy: 3 Adult/s + 1 Child/ren are not allowed! > > > ``` ### Stay Stay related error responses or incidences. > [accordion] Searches above the maximum stay > > * **Case**: Stay requested in the search is over the maximum that can be provided, which is 99 days. > * **Error received**: > * Type 3 > * Code 356 > * Detail: Searches over 99 days are not permitted > * **Test steps**: > * Do a search for hotel xxx, room xxx, board yyy from xxx to xxx, stay is over 99, search will be responded with error. > * **Complete error response**: > ```xml theme={null} > > > Error Type="3" Code="356">Searches over 99 days are not permitted > > > ``` > [accordion] Min stay errors > > * **Case**: Minimum stay condition not met, stay is lower than the minimum specified. > * **Error received**: > * Type 3 > * Code 517 > * Detail: NotAvailable. Room Restrictions failed: Restriction A\_NUMBER, StayRestriction A\_NUMBER - duration min. failure > * **Test steps**: > * Do a quote for hotel with min stay with less stay than allowed. Contact integrations if the case is needed. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Room Restrictions failed: Restriction 3, StayRestriction 1 - duration min. failure > > > ``` > [accordion] Invalid stay > > * **Case**: Stay includes days not available, contract does not cover all the stay. > * **Error received**: > * Type 3 > * Code 145 > * Detail: Duration period or dates incorrect > * **Test steps**: > * Do a search or quote without start and/or end dates, leaving them empty, use a wrong format or with a start date in the past. > * **Complete error response**: > ```xml theme={null} > > > Duration period or dates incorrect > > > ``` ### References References related error responses or incidences. > [accordion] Booking reference not found > > * **Case**: A booking cancellation or retrieve is requested using a non-existing reference; booking cannot be found in the system. > * **Error received**: > * Type 3 > * Code 127 > * Detail: Booking reference not found > * **Test steps**: > * Do a cancellation for a booking with an inexistent reference; booking won’t be found in the system and an error will be returned. > * **Complete error response**: > ```xml theme={null} > > > Booking reference not found > > > ``` > [accordion] Booking item not found > > * **Case**: A booking cancellation or retrieve is requested using a non-existing **item** reference in a booking; booking item cannot be found in the system. > * **Error received**: > * Type 3 > * Code 150 > * Detail: FATAL BOOKING ERROR! Contact Support! > * **Test steps**: > * Do a cancellation for a booking item with an inexistent reference; booking item won’t be found in the system and an error will be returned. > * **Complete error response**: > ```xml theme={null} > > > FATAL BOOKING ERROR! Contact Support! > > > ``` > * **Note**: This specific error is raised as a FATAL error, as it means a possible mismatch between the status of the items of a booking. An immediate communication with integrations is required. ### Credentials Credential related error responses or incidences. > [accordion] User authentication error > > * **Case**: A request with wrong or inexistent authentication is sent; user and password validation fails and the message is rejected. > * **Error received**: > * Type 3 > * Code 175, 182 > * Detail: > * Username or Password invalid > * Username and Password required > * **Test steps**: > * Do a request using either invalid user + password values or without the authentication section; an error response will be returned according to the case. > * **Complete error response**: > ```xml theme={null} > > > Username or Password invalid > > > > > > Username and Password required > > > ``` > [accordion] Invalid ClientID > > * **Case**: A request with wrong credential (ClientID) is sent; system rejects the message as partner is not configured in the system. > * **Error received**: > * Type 3 > * Code 305 > * Detail: Invalid client code > * **Test steps**: > * Do a request using either invalid user + password values or without the authentication section; an error response will be returned according to the case. > * **Complete error response**: > ```xml theme={null} > > > Invalid client code > > > ``` ### Miscellaneous Miscellaneous error responses or incidences. > [accordion] Room no longer in contract during contract update > > * **Case**: Room no longer available for the contract; room not available for a specific hotel but was previously included. > * **Error received**: > * Type: Internal-Error > * Code: 7001 > * Detail: NotAvailable. Hotel EDF not found > * **Test steps**: > * Not applicable; internal error occurring in between contract updates. > * **Complete error response**: > ```xml theme={null} > > > NotAvailable. Hotel EDF not found > > > ``` > [accordion] Data structure > > * **Case**: Request XML is not well-formed. > * **Error received**: > * Type: N/A > * Code: N/A > * Detail: OTA request validation failed. ERROR\_DETAIL\_DESCRIPTION > * **Test steps**: > * N/A; general validation errors should be here. > * **Complete error response**: > ```xml theme={null} > > false > OTA request validation failed. No guests found. > > > ``` > [accordion] Rate Limit Exceeded > > * **Case**: The searches per second limit is exceeded. > * **Complete error response**: > ```xml theme={null} > > > Service restriction - security (Rate Limit Exceeded) > > > ``` > [accordion] Timeout error > > * **Case**: The timeout limit is exceeded. The timeout limits are 10s for Avail and 60s for Quote/Books. # Official Specifications Source: https://docs.axisdata.net/glossary/specs ## Specifications and Schemas This documentation is mainly based on the OpenTravel Alliance (OTA) specification. Always refer to the official schema documentation for complete details and the latest updates.For complete specification details, refer to the OpenTravel Alliance documentation at: [https://www.opentravel.org/](https://www.opentravel.org/) ### OTA The [www.opentravel.org](http://www.opentravel.org) website is extremely helpful for your integration with our systems. Every year an "A" and "B" update of the specifications are provided. We do not always follow immediately to keep our interface stable, but we sometimes are ahead of the next implementation, when we propose functionality as an OTA member. We recommend: * Download of the latest .xsd’s and installation of a graphical viewing tool like XML spy * Use of the Model Viewer provided by PilotFish, available under specifications. * Become a registered user to use the forum – most of your questions will be listed there! #### Tools These are some useful recommended tools to understand and develop our API: * XML Spy * PilotFish Model Viewer * OTA Forum *** ### EDF All details on the official Peakwork products, including the EDF format, can be found at: [http://www.peakwork.com/](http://www.peakwork.com/) We recommend: * Download of the latest .xsd’s and installation of a graphical viewing tool like XML spy * Become a registered user to get proper access to the documentation ([https://documentation.peakwork.com/](https://documentation.peakwork.com/)). *** ### OTDS The OTDS format (Open Travel Data Standard) is an initiative of the association OTDS e.V. in Berlin, Germany. All information, specifications and schemas can be obtained after registration on: [https://www.otds.de/en/](https://www.otds.de/en/) for access. *** ### DRV The **DRV** is Germany’s leading travel industry association, representing tour operators, travel agencies, and service providers. It promotes industry standards, sustainability, and digitalization. [Official Website](https://www.drv.de/) # Troubleshooting Source: https://docs.axisdata.net/glossary/troubleshooting See how to approach different issues when encountered. ### **Product Related Issues** This section includes product and mapping related scenarios. ![First flow step mapping](https://mintcdn.com/axisdata-0b02f380/BKowRIdGb7K0BIsF/glossary/imagesGlossary/productIssues.png?fit=max\&auto=format\&n=BKowRIdGb7K0BIsF\&q=85\&s=14052005d3f954557c3ec0bda81b280c) * **I can’t see a property in our system**. * Cause: Property is not assigned to this feed but to another feed.\ Action: Check you are using the correct feed for that market. * Cause: Property is not mapped in your system.\ Action: Contact your product manager to map it. * Cause: Property is not assigned to your feed.\ Action: Contact your account manager in OTS. * **I can’t find details of a property in our system (images, descriptions)**. * Cause: Property was not fully mapped or had a mapping error.\ Action: Contact your product manager/IT. * Cause: Some concepts are not included in the NBC message.\ Action: Contact Axis Data Integrations. * Cause: Property is on sale but NBC was not mapped yet.\ Action: Contact your product manager/IT. * **Some details of a property are incorrect or different from what I got via other systems**. * Cause: Property was incorrectly mapped.\ Action: Check the property to ensure it was correctly identified. * Cause: Property has outdated data in OTS.\ Action: Contact OTS NBC. * Cause: Property has outdated data in your/other systems.\ Action: Contact your product manager. * **I can’t find a specific area in our system**. * Cause: Area was incorrectly mapped.\ Action: Check the area to property mapping to ensure it was correctly identified. * Cause: Area name has changed in OTS, property-area mapping failed.\ Action: Contact OTS NBC. * **I can’t find a property under a specific area**. * Cause: Property was incorrectly mapped.\ Action: Check the property to ensure it was correctly identified. * Cause: Property has outdated data in OTS.\ Action: Contact OTS NBC. * Cause: Property has outdated data in your/other systems.\ Action: Contact your product manager. * **I have a property located in a wrong area**. * Cause: Area was incorrectly mapped.\ Action: Check the area to property mapping to ensure it was correctly identified. *** ### **Search Related Issues** This section covers issues when a search is performed for both data retrieved from our cache and live requests. ![Second and third step search](https://mintcdn.com/axisdata-0b02f380/BKowRIdGb7K0BIsF/glossary/imagesGlossary/searchIssues.png?fit=max\&auto=format\&n=BKowRIdGb7K0BIsF\&q=85\&s=c57a23df802caba94a8e665373668130) * **I can’t get results for a specific property**. * Cause: Property does not have enough allotment or it's in Stop sales.\ Action: Select another property or dates. * Cause: Property is not assigned to this feed but to another feed.\ Action: Check you are using the correct feed for that market. * Cause: Requested stay is over the maximum defined by OTS (55 days).\ Action: This request can’t be processed. * **I get a specific property in a search response but it fails when I try a quotation**. * Causes: * Pax ages are different in the search request than in the quote request. Children might be considered as adults, causing occupancy error. * Allotment was consumed during the search to quote step. * Property/room/board was closed/stop sales during the search to quote step.\ Action: Property not available for the requested parameters, start a new search. * Causes: * Allotment was consumed since the cache file delivery (old cache). * Property/room/board was closed/stop sales since the cache file delivery (old cache).\ Action: Property not available for the requested parameters, choose a different option. * **I get results only for high occupancies (bypassing the cache file)**. * Cause: Property was included recently, a cache file was not delivered yet.\ Action: Wait for the cache file to be delivered. *** ### **Booking Related Scenarios** This section covers all issues related to the booking process: quote, book and cancellations. ![Last step booking](https://mintcdn.com/axisdata-0b02f380/BKowRIdGb7K0BIsF/glossary/imagesGlossary/bookingIssues.png?fit=max\&auto=format\&n=BKowRIdGb7K0BIsF\&q=85\&s=47f00df72625ef55f34b060da1670dfd) * **I can’t book a property from which I got a favorable quotation (initial quotes)**. * Causes: * Allotment was consumed during the quote to book step. * Property/room/board was closed/stop sales during the quote to book step.\ Action: Verify data with a new quotation. If a quote is returned OK and an immediate book fails, contact integrations. * Cause: A network issue prevented the request or the response from reaching the destination in time.\ Action: Verify the status of the booking in the ClientNet. * **I can’t cancel a booking, I got an error indicating the reference does not exist**. * Causes: * Reference is incorrect. * Booking was not stored. Action: Contact customer support. * **I get a price difference between my search result and my quotation result**. * Causes: * Price may have changed in the last minutes. * Pax ages are different in the search request than in the quote request. Children might be considered as adults.\ Action: Property not available for the requested parameters, choose a different option. ### **Ghost Bookings** When an XML message to confirm a booking is sent but no response is received (timeout), there are various scenarios for errors to occur: * **While sending**: * In the Distributor systems: booking request never gets sent. * In the internet: message gets lost/corrupted. * In our systems: message does not get processed. * **While responding**: * In our systems: booking response never gets sent. * In the internet: message gets lost/corrupted. * In Distributor systems: message does not get processed. It is technically only possible to detect these cases by the sender of the request. Conclusively, we require a **“failed booking process”** during certification of every integration to define actions to be taken by the client when a booking request is not responded to in an agreed time (in general 10 seconds). Options are: * If the booking is **not confirmed to the end customer** (and no flights are reserved), send **automatic cancellation** after 5 minutes of detection. Keep logs for troubleshooting and disputes. * If the booking **is confirmed to the end customer or flights are booked**, send **automatic rebooking message** with the exact same reference after 5 minutes of detection. * If the booking was not processed, it will then be automatically confirmed. * If the booking was already made with the first request, a **“Booking already exists”** error will be returned. * An `OTA_Read` message can be implemented to obtain our booking references and response details like price and price breakdown. * If none of the above technical solutions can be put in place, some clients opt for sending an **email to their support department** to review and resolve the situation on ClientNet. If a booking request is received and the client does not receive a booking response, the booking remains **payable**, if not cancelled. # OTA_HotelResRQ Source: https://docs.axisdata.net/hotel/bookRQ The `OTA_HotelResRQ` (Hotel Reservation Request) is used to **quote** or **commit** a reservation. This message links rooms, guests, and ancillary services via `RPH` references within a single booking. > [!TIP] > > Already know the flow? Jump straight into testing the payloads below. > [card] [OTA\_HotelResRQ API call](/api-reference/endpoint/hotel/book) > > Skip & Hit the Playground. ## Purpose * Quote or book room stays and associated services under one reservation. * Link rooms to specific guests and services using `RPH`. * Support multi-room bookings (up to 5 rooms). ## Structure – Root Element ```xml theme={null} ``` ```json theme={null} "OTA_HotelResRQ" ``` **Key Attributes:** * `ResStatus` * `Quote` validates availability and returns per-room totals, cancellation rules, and offers; no booking is created. * `Commit` performs the same calculations and commits the reservation; penalties may apply for later changes. * `Version`: e.g., `2008.1` * `PrimaryLangID`: ISO 639 (e.g., `EN`) * `xmlns`: `http://www.opentravel.org/OTA/2003/05` ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and contains credentials. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID_Context": "AxisData", "Type": "22", "ID": "TEST", "Instance": "PriceBreakdown" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` Setting `Instance = "PriceBreakdown` ensures that the response section `TPA_Extensions/RateDetails` returns per-day `RateComponents` and per-guest totals; when applicable, `EBPrepayment` includes due date and amount. ### HotelReservation Container for one booking transaction. Include one or more `` entries. Use `` (e.g., board codes) and `` to provide guest details. Use `` for booking-level references and comments. #### RoomStay Element Each `` represents one room in the booking. Link guest and service RPHs here. ```xml theme={null} ``` ```json theme={null} { "RoomStay": [ { "ResGuestRPHs": { "ResGuestRPH": [ { "RPH": 1 }, { "RPH": 2 } ] }, "ServiceRPHs": { "ServiceRPH": [ { "RPH": "1" } ] }, "RoomTypes": { "RoomType": [ { "RoomTypeCode": "RM00CRMV00" } ] }, "RatePlans": { "RatePlan": [ { "RatePlanID": "-OWN2-BH000" } ] }, "TimeSpan": { "Start": "2027-10-17", "End": "2027-10-24" }, "BasicPropertyInfo": { "HotelCode": "AESPMI5L46" } } ] } ``` * `RoomTypeCode`: send the contracted room code. * `RatePlanID`: Here is where the RatePlan and Multicontracting code needs to be specified, e.g., `-OWN2-BH000`. See [RatePlans and Multicontracting](../general/rateplans_multicontracting). * `TimeSpan`: check-in/-out at room level. * `BasicPropertyInfo`: send the contracted hotel code. * Link guests to rooms via `RoomStay/ResGuestRPHs`; the first adult is the room responsible. * Link non-room services (board/extras/transfers) using `ServiceRPHs` and pax-level `ResGuestRPHs`. * Up to **5** `` items per booking. > [!TIP] > > If the RatePlan code is configured as concatenated, it would be inside the RoomTypeCode as returned in Search. The RatePlans node would not be needed. #### Services Use for board codes and other ancillary services. Reference them from `` inside each linked ``. Board is sent via `ServiceInventoryCode` (e.g., `RO`, `BB`). ```xml theme={null} ``` ```json theme={null} { "Services": { "Service": [ { "ServiceRPH": "1", "ServiceInventoryCode": "BB" } ] } } ``` #### ResGuest Provide guest details per RPH. Adults, children, and infants are differentiated via `AgeQualifyingCode`. For **Quote**, pax profiles may be omitted; for **Commit**, include adult titles. ```xml theme={null} Mr Bender Bending ``` ```json theme={null} { "ResGuest": [ { "Profiles": { "ProfileInfo": [ { "Profile": { "Customer": { "PersonName": [ { "NamePrefix": [ "Mr" ], "GivenName": [ "Bender" ], "Surname": "Bending" } ] } } } ] }, "GuestCounts": { "GuestCount": [ { "Age": 27 } ] }, "ResGuestRPH": "1", "AgeQualifyingCode": "10" } ] } ``` **Rules:** * Adults=10, Children=8, Infants=7. * Prices may change if switching between age and birthdate across flow; keep consistent. * Name and surname, mandatory. * NamePrefix (Mr., Mrs., etc.) is mandatory for all adult pax in a booking. * Age or true date of birth, mandatory for children and infants. Never both! * Contact info (Telephone and email), optional. * AgequalifyingCode, mandatory. * ResGuestRPH, mandatory. #### ResGlobalInfo **Comments** Only `Name="Applicant Notice"` comments are processed. Up to 10 comments; max 250 characters each. ```xml theme={null} late arrival - flight lands at 22:55 local time ``` ```json theme={null} { "ResGlobalInfo": { "Comments": { "Comment": [ { "Name": "Applicant Notice", "Text": "late arrival - flight lands at 22:55 local time" } ] } } } ``` **HotelReservationIDs** Provide your booking references. Use one parent reference and optional child/item references linked by `Item_RPH`. This reference must be printed on the voucher and is used to avoid duplicates. ```xml theme={null} ``` ```json theme={null} { "HotelReservationIDs": { "HotelReservationID": [ { "ResID_SourceContext": "Client", "ResID_Type": "36", "ResID_Value": "test_xxx" }, { "Item_RPH": "1", "ResID_SourceContext": "Client", "ResID_Type": "37", "ResID_Value": "test_xxx_ac1" } ] } } ``` > [!NOTE] > > See [Master and Child References](../general/messaging#master-and-child-references) for more information. #### TPA\_Extensions Send optional extras to be added to the quote/booking. Repeat per pax if required, and scope them by date range. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "Extras": { "Extra": [ { "Code": "106", "Start": "2027-07-17", "End": "2027-07-24", "ResGuestRPH": "1", "Quantity": "1" } ] } } } ``` **Attributes:** `Code` (contract code), `Quantity`, `Start`, `End`, `ResGuestRPH`. Applicability and pricing are returned in the response; booked extras will appear with `IncludedInRate="true"`. ## Additional Features ### Expected Booking Value You can include an **expected booking value** in each booking request to help ensure price consistency between search, quote, and notifications. This value is stored in the booking details and can be used to detect discrepancies or contract issues at the time of booking. * If the expected value is **lower** than the booking value, partners and destinations can investigate and avoid publishing rates that are not bookable. * If the expected value is **higher** than the booking value, it helps both parties understand complex contract conditions or mismatches in distribution. > [!NOTE] > > There is no additional functionality beyond storing the expected value for transparency and review. ```xml theme={null} ``` ## Complete Examples > [tab] Basic > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Mr > Bender > Bending > > > > > > > > > > > > > > > > Mrs > Angelina > Bending > > > > > > > > > > > > > > > > Jr > Ben > Bending > > > > > > > > > > > > > > late arrival - flight lands at 22:55 local time > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelResRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "PriceBreakdown", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelReservations" : { > "HotelReservation" : [ { > "RoomStays" : { > "RoomStay" : [ { > "ResGuestRPHs" : { > "ResGuestRPH" : [ { > "RPH" : 1 > }, { > "RPH" : 2 > }, { > "RPH" : 3 > } ] > }, > "ServiceRPHs" : { > "ServiceRPH" : [ { > "RPH" : "1" > } ] > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "TimeSpan" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "BasicPropertyInfo" : { > "HotelCode" : "AESPMI5L46" > } > } ] > }, > "Services" : { > "Service" : [ { > "ServiceRPH" : "1", > "ServiceInventoryCode" : "BB" > } ] > }, > "ResGuests" : { > "ResGuest" : [ { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Mr" ], > "GivenName" : [ "Bender" ], > "Surname" : "Bending" > } ], > "BirthDate" : 841788000000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 27, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "1", > "AgeQualifyingCode" : "10" > }, { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Mrs" ], > "GivenName" : [ "Angelina" ], > "Surname" : "Bending" > } ], > "BirthDate" : 841874400000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 27, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "2", > "AgeQualifyingCode" : "10" > }, { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Jr" ], > "GivenName" : [ "Ben" ], > "Surname" : "Bending" > } ], > "BirthDate" : 1536184800000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 6, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "3", > "AgeQualifyingCode" : "8" > } ] > }, > "ResGlobalInfo" : { > "Comments" : { > "Comment" : [ { > "Text" : [ { > "value" : "late arrival - flight lands at 22:55 local time" > } ], > "Name" : "Applicant Notice" > } ] > }, > "HotelReservationIDs" : { > "HotelReservationID" : [ { > "ResID_Type" : "36", > "ResID_Value" : "test_xxx", > "ResID_SourceContext" : "Client" > }, { > "ResID_Type" : "37", > "ResID_Value" : "test_xxx_ac1", > "ResID_SourceContext" : "Client" > } ] > } > } > } ] > }, > "ResStatus" : "Quote", > "Version" : 2016.2, > "PrimaryLangID" : "EN" > } > } > ``` > [tab] Multiroom > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Mr > Bender > Bending > > > > > > > > > > > > > > > > Mrs > Angelina > Bending > > > > > > > > > > > > > > > > Dr > John > Zoidberg > > > > > > > > > > > > > > late arrival - flight lands at 22:55 local time > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelResRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "PriceBreakdown", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelReservations" : { > "HotelReservation" : [ { > "RoomStays" : { > "RoomStay" : [ { > "ResGuestRPHs" : { > "ResGuestRPH" : [ { > "RPH" : 1 > }, { > "RPH" : 2 > } ] > }, > "ServiceRPHs" : { > "ServiceRPH" : [ { > "RPH" : "1" > } ] > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "TimeSpan" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "BasicPropertyInfo" : { > "HotelCode" : "AESPMI5L46" > } > }, { > "ResGuestRPHs" : { > "ResGuestRPH" : [ { > "RPH" : 3 > } ] > }, > "ServiceRPHs" : { > "ServiceRPH" : [ { > "RPH" : "2" > } ] > }, > "RoomTypes" : { > "RoomType" : [ { > "RoomTypeCode" : "RMCS00PT00" > } ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "TimeSpan" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "BasicPropertyInfo" : { > "HotelCode" : "AESPMI5L46" > } > } ] > }, > "Services" : { > "Service" : [ { > "ServiceRPH" : "1", > "ServiceInventoryCode" : "BB" > }, { > "ServiceRPH" : "2", > "ServiceInventoryCode" : "BB" > } ] > }, > "ResGuests" : { > "ResGuest" : [ { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Mr" ], > "GivenName" : [ "Bender" ], > "Surname" : "Bending" > } ], > "BirthDate" : 841788000000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 27, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "1", > "AgeQualifyingCode" : "10" > }, { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Mrs" ], > "GivenName" : [ "Angelina" ], > "Surname" : "Bending" > } ], > "BirthDate" : 841874400000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 27, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "2", > "AgeQualifyingCode" : "10" > }, { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Dr" ], > "GivenName" : [ "John" ], > "Surname" : "Zoidberg" > } ], > "BirthDate" : 526341600000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 37, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "3", > "AgeQualifyingCode" : "10" > } ] > }, > "ResGlobalInfo" : { > "Comments" : { > "Comment" : [ { > "Text" : [ { > "value" : "late arrival - flight lands at 22:55 local time" > } ], > "Name" : "Applicant Notice" > } ] > }, > "HotelReservationIDs" : { > "HotelReservationID" : [ { > "ResID_Type" : "36", > "ResID_Value" : "test_xxx", > "ResID_SourceContext" : "Client" > }, { > "ResID_Type" : "37", > "ResID_Value" : "test_xxx_ac_1", > "ResID_SourceContext" : "Client" > }, { > "ResID_Type" : "37", > "ResID_Value" : "test_xxx_ac_2", > "ResID_SourceContext" : "Client" > } ] > } > } > } ] > }, > "ResStatus" : "Quote", > "Version" : 2016.2, > "PrimaryLangID" : "EN" > } > } > ``` > [tab] Optional Extras > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Mr > Bender > Bending > > > > > > > > > > > > > > > > Mrs > Angelina > Bending > > > > > > > > > > > > > > > > Jr > Ben > Bending > > > > > > > > > > > > > > > > > > > > late arrival - flight lands at 22:55 local time > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelResRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelReservations" : { > "HotelReservation" : [ { > "RoomStays" : { > "RoomStay" : [ { > "ResGuestRPHs" : { > "ResGuestRPH" : [ { > "RPH" : 1 > }, { > "RPH" : 2 > }, { > "RPH" : 3 > } ] > }, > "ServiceRPHs" : { > "ServiceRPH" : [ { > "RPH" : "1" > } ] > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "TimeSpan" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "BasicPropertyInfo" : { > "HotelCode" : "AESPMI5L46" > } > } ] > }, > "Services" : { > "Service" : [ { > "ServiceRPH" : "1", > "ServiceInventoryCode" : "BB" > } ] > }, > "ResGuests" : { > "ResGuest" : [ { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Mr" ], > "GivenName" : [ "Bender" ], > "Surname" : "Bending" > } ], > "BirthDate" : 841788000000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 27, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "1", > "AgeQualifyingCode" : "10" > }, { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Mrs" ], > "GivenName" : [ "Angelina" ], > "Surname" : "Bending" > } ], > "BirthDate" : 841874400000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 27, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "2", > "AgeQualifyingCode" : "10" > }, { > "Profiles" : { > "ProfileInfo" : [ { > "Profile" : { > "Customer" : { > "PersonName" : [ { > "NamePrefix" : [ "Jr" ], > "GivenName" : [ "Ben" ], > "Surname" : "Bending" > } ], > "BirthDate" : 1536184800000 > } > } > } ] > }, > "GuestCounts" : { > "GuestCount" : [ { > "Age" : 6, > "Count" : 1 > } ] > }, > "ResGuestRPH" : "3", > "AgeQualifyingCode" : "8" > } ] > }, > "ResGlobalInfo" : { > "Comments" : { > "Comment" : [ { > "Text" : [ { > "value" : "late arrival - flight lands at 22:55 local time" > } ], > "Name" : "Applicant Notice" > } ] > }, > "HotelReservationIDs" : { > "HotelReservationID" : [ { > "ResID_Type" : "36", > "ResID_Value" : "test_xxx", > "ResID_SourceContext" : "Client" > }, { > "ResID_Type" : "37", > "ResID_Value" : "test_xxx_ac1", > "ResID_SourceContext" : "Client" > } ] > } > }, > "TPA_Extensions" : { > "Extras" : { > "Extra" : [ { > "Code" : "106", > "Quantity" : 1, > "Start" : 1784239200000, > "End" : 1784844000000, > "ResGuestRPH" : 1 > }, { > "Code" : "106", > "Quantity" : 1, > "Start" : 1784239200000, > "End" : 1784844000000, > "ResGuestRPH" : 2 > } ] > } > } > } ] > }, > "ResStatus" : "Quote", > "Version" : 2016.2, > "PrimaryLangID" : "EN" > } > } > ``` ## Best Practices 1. Quote (`ResStatus="Quote"`) before Commit to re-validate price/availability. 2. Keep guest details consistent across all services (same order and age/birthdate concept). 3. Provide partner references in `HotelReservationIDs` to prevent duplicates and facilitate cancellation flows. 4. Use ISO dates (`YYYY-MM-DD`) and link everything with `RPH`. 5. When multicontracting applies, send the full room+contract+rateplan code as `RoomTypeCode`. 6. Be aware that timestamps should include timezone information 7. Implement proper error handling for the response messages. [Error Scenarios](../glossary/errors). ## Playground > [card] [OTA\_HotelResRQ API call](/api-reference/endpoint/hotel/book) > > Try the Booking API playground with Quote first, then Commit. > [!TIP] > > Use your real `ResID_Value` as partner reference. For test extras, add them under `TPA_Extensions/Extras`. # OTA_HotelResRS Source: https://docs.axisdata.net/hotel/bookRS The OTA\_HotelResRS (Hotel Reservation Response) confirms quote or commit processing for a hotel booking and returns room-level totals, linked guest profiles, partner references, cancellation policies, and optional TPA extensions. It is returned in reply to an `OTA_HotelResRQ` of type Quote or Commit. ## Purpose * Confirm successful processing (``) or return error diagnostics (``). [Error Scenarios](../glossary/errors). * Return one `HotelReservation` with one or more `RoomStay` items, linked `ResGuests`, optional `Services`, and booking-level context under `ResGlobalInfo`. * **Quote** (`ResStatus="Quote"` in the request): verify availability, totals, and cancellation policy without creating a reservation ID at Axis Data (the client reference is echoed). * **Commit** (`ResStatus="Commit"` in the request): create a binding booking if accepted, with penalties per contract. ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_HotelResRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2008.1", "Success": {}, ... } } ``` > [!TIP] > > When `` is absent, inspect `` for diagnostics; multiple `` items may be returned. [Error Scenarios](../glossary/errors) ## Structure – Core Elements ### HotelReservation Envelope and item for the reservation response. Contains: `RoomStays`, optional `Services` (e.g., board), `ResGuests`, `ResGlobalInfo`, and `TPA_Extensions`. ### RoomStays Each `RoomStay` represents one reserved room (or quoted room) for the booking. It is very similar as the `RoomStay` returned in the [avail response](/searchRS#roomstays). * `RoomStay@RPH` is the room key used across the response; `IndexNumber` is a 1‑based display index. * Includes room identification (`RoomTypes/RoomType@RoomTypeCode`), `RoomDescription`, pricing at room level (`Total`), stay dates (`TimeSpan@Start/End`), and links to guests/services via `ResGuestRPHs` / `ServiceRPHs`. * The RatePlan code is echoed here. The examples on this page represent separate code approach. * Property context can be repeated under `RoomStay/BasicPropertyInfo` when needed. * Under `Features`, the booked board and a short description can be found. * `ResGuestRPH` and `ServiceRPH` link the Services and ResGuests to this RoomStay. * `Total@AmountAfterTax` returns the rate for this RoomStay. **Example** ```xml theme={null} Standard Room BB Breakfast ``` ```json theme={null} { "RoomStays": { "RoomStay": [ { "ResGuestRPHs": { "ResGuestRPH": [ { "RPH": 1 }, { "RPH": 2 }, { "RPH": 3 } ] }, "ServiceRPHs": { "ServiceRPH": [ { "RPH": "1" } ] }, "RoomTypes": { "RoomType": [ { "RoomDescription": { "Text": [ { "value": "RM00CRMV00", "Language": "EN" } ] }, "RoomTypeCode": "RM00CRMV00" } ] }, "RatePlans": { "RatePlan": [ { "RatePlanID": "-OWN2-BH000" } ] }, "RoomRates": { "RoomRate": [ { "Features": { "Feature": [ { "Description": [ { "Text": [ { "value": "BB" }, { "value": "BB", "Language": "EN" } ] } ] } ] }, "RoomTypeCode": "RM00CRMV00" } ] }, "TimeSpan": { "Start": "2027-07-17", "End": "2027-07-24" }, "Total": { "AmountAfterTax": 1078.50, "CurrencyCode": "EUR" }, "BasicPropertyInfo": { "HotelCode": "AESPMI5L46", "HotelName": "Hotel Overlook" }, "IndexNumber": 1 } ] } } ``` ### Services Non-room services (e.g., board) appear under `Services/Service` and can be linked to a `RoomStay` via `ServiceRPHs`. ```xml theme={null} ``` ```json theme={null} { "Services": { "Service": [ { "ServiceInventoryCode": "BB", "ServiceRPH": "1" } ] } } ``` ### ResGuests Passenger/guest profiles for the booking, referenced from rooms and services via `ResGuestRPH`. * Adults `AgeQualifyingCode="10"`; Children `"8"`; Infants `"7"`. ```xml theme={null} Mr Bender Bending ``` ```json theme={null} { "ResGuests": { "ResGuest": [ { "AgeQualifyingCode": "10", "ResGuestRPH": "1", "Profiles": { "ProfileInfo": [ { "Profile": { "Customer": { "BirthDate": "1996-09-04", "PersonName": [ { "NamePrefix": [ "Mr" ], "GivenName": [ "Bender" ], "Surname": "Bending" } ] } } } ] }, "GuestCounts": { "GuestCount": [ { "Age": "27" } ] } } ] } } ``` ### ResGlobalInfo Holds booking totals, comments, partner/child references, cancellation penalties, handling office, and optional property/vendormessages context. #### Totals Booking-level roll‑up amount for all rooms and services. ```xml theme={null} ... ``` ```json theme={null} { "ResGlobalInfo": { "Total": { "CurrencyCode": "EUR", "AmountAfterTax": "1050.00" } ... } } ``` #### Comments Returns the specified comments at the RQ. ```xml theme={null} late arrival - flight lands at 22:55 local time ``` ```json theme={null} { "Comments": { "Comment": { "Name": "Applicant Notice", "CommentOriginatorCode": "DISTRIBUTOR", "Text": "late arrival - flight lands at 22:55 local time" } } } ``` #### HotelReservationIDs * `ResID_Type="36"` — partner (distributor) reference (must be unique; prevents duplicates; print on voucher). * `ResID_Type="37"` — child references per item; associate with rooms/services via `Item_RPH`. ```xml theme={null} ``` ```json theme={null} { "HotelReservationIDs": { "HotelReservationID": [ { "ResID_Type": "36", "ResID_SourceContext": "Client", "ResID_Value": "TEST_XXX" }, { "Item_RPH": "1", "ResID_Type": "37", "ResID_SourceContext": "Client", "ResID_Value": "test_xxx_ac1" } ] } } ``` #### CancelPenalties Cancellation policy is linked to the room using `CancelPenalty@Item_RPH` (matching the room `RPH`). Deadlines can be expressed relative to arrival or booking. ```xml theme={null} ``` ```json theme={null} { "CancelPenalties": { "CancelPenalty": [ { "Item_RPH": "1", "Deadline": { "OffsetUnitMultiplier": "0", "OffsetTimeUnit": "Hour", "OffsetDropTime": "AfterBooking", "AbsoluteDeadline": "2025-09-23T18:54:31" }, "AmountPercent": { "Amount": "1050.00", "CurrencyCode": "EUR", "BasisType": "WholeStay", "Percent": "100" } } ] } } ``` #### BasicPropertyInfo Optional property context at booking level; [Vendor Messages](../general/messaging#vendor-messages) can include local taxes or operational notices. ```xml theme={null} Tax Payable Locally, Currency: EUR, type: city tax Due to the local logistics infrastructure, there is a possibility that your meeting point for arrival and departure transfer may not be direct at the hotel door, Approx. Distance: > 600 m ``` ```json theme={null} { "BasicPropertyInfo": { "VendorMessages": { "VendorMessage": [ { "SubSection": { "Paragraph": { "Text": "Tax Payable Locally, Currency: EUR, type: city tax" } }, "Title": "IncidentsAndErrata", "InfoType": "5" }, { "SubSection": { "Paragraph": { "Text": "Due to the local logistics infrastructure, there is a possibility that your meeting point for arrival and departure transfer may not be direct at the hotel door, Approx. Distance: > 600 m" } }, "Title": "IncidentsAndErrata", "InfoType": "5" } ] }, "HotelCodeContext": "11111", "AreaID": "927", "HotelName": "Hostal Cuba", "HotelCode": "AESPMI5L46" } } ``` #### Handling Office Handling office details are provided under `Profiles/ProfileInfo/Profile/CompanyInfo/CompanyName`. ```xml theme={null} ``` ```json theme={null} { "Profiles": { "ProfileInfo": [ { "Profile": { "CompanyInfo": { "CompanyName": { "CompanyShortName": "OTS Headquarter Office", "CountryCode": "AT", "Code": "OTSHQ" } } } } ] } } ``` ### TPA\_Extensions Provider-specific details. #### RateDetails Breakdown by guest and stay day; includes per‑guest totals and booking‑level totals under `Totals`. Returned if `Instance=PriceBreakdown` is specified at the RQ. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "RateDetails": { "GuestDetails": { "RateComponents": [ { "StayDay": "1", "ResGuestRPH": "1", "Code": "AMT9", "Edition": "0", "Rate": "150", "CurrencyCode": "EUR", "CodeType": "STDRATE" }, { "StayDay": "1", "ResGuestRPH": "1", "Code": "SMS1", "Edition": "0", "Rate": "15", "CurrencyCode": "EUR", "CodeType": "EXTR" } ], "ResGuestRPH": "1", "TotalAmount": "1050.00", "CurrencyCode": "EUR", "RateCode": "Price" }, "Totals": { "Total": { "TotalType": "Price", "CurrencyType": "Price", "CurrencyCode": "EUR", "AmountAfterTax": "1050.00", "Override": "false" } } } } } ``` #### BookingStatus Reservation status echo (TPA namespace), typically `ReservationStatusType="Available"` for a successful Quote and `ReservationStatusType="Reserved"` for a successful Commit. ```xml theme={null} ``` ```json theme={null} { "BookingStatus": { "xmlns:ns1": "http://www.opentravel.org/OTA/2003/05/tpa", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance", "xsi:type": "ns1:BookingStatusType", "ReservationStatusType": "Available", "prefix": "ns1" } } ``` #### Extras Optional and included extras. Optional extras may be offered or booked; see `IncludedInRate`, `Applicability`, `Amount`, and `ResGuestRPH`. ## Complete Examples > [tab] Basic > > ```xml expandable theme={null} > > > > > > > > > > > RM00CRMV00 > > > > > > > > > > > > BB > BB > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Mr > Bender > Bending > > > > > > > > > > > > > > > > Mrs > Angelina > Bending > > > > > > > > > > > > > > > > Jr > Ben > Bending > > > > > > > > > > > > > > > late arrival - flight lands at 22:55 local time > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelResRS": { > "Success": {}, > "HotelReservations": { > "HotelReservation": [ > { > "RoomStays": { > "RoomStay": [ > { > "ResGuestRPHs": { > "ResGuestRPH": [ > { > "RPH": 1 > }, > { > "RPH": 2 > }, > { > "RPH": 3 > } > ] > }, > "ServiceRPHs": { > "ServiceRPH": [ > { > "RPH": "1" > } > ] > }, > "RoomTypes": { > "RoomType": [ > { > "RoomDescription": { > "Text": [ > { > "value": "RM00CRMV00", > "Language": "EN" > } > ] > }, > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > }, > { > "value": "BB", > "Language": "EN" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "Total": { > "AmountAfterTax": 1078.50, > "CurrencyCode": "EUR" > }, > "BasicPropertyInfo": { > "HotelCode": "AESPMI5L46", > "HotelName": "Hotel Overlook" > }, > "IndexNumber": 1 > } > ] > }, > "Services": { > "Service": [ > { > "ServiceRPH": "1", > "ServiceInventoryCode": "BB" > } > ] > }, > "ResGuests": { > "ResGuest": [ > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Mr" > ], > "GivenName": [ > "Bender" > ], > "Surname": "Bending" > } > ], > "BirthDate": 841701600000 > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": 27 > } > ] > }, > "ResGuestRPH": "1", > "AgeQualifyingCode": "10" > }, > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Mrs" > ], > "GivenName": [ > "Angelina" > ], > "Surname": "Bending" > } > ], > "BirthDate": 841788000000 > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": 27 > } > ] > }, > "ResGuestRPH": "2", > "AgeQualifyingCode": "10" > }, > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Jr" > ], > "GivenName": [ > "Ben" > ], > "Surname": "Bending" > } > ], > "BirthDate": 1536098400000 > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": 6 > } > ] > }, > "ResGuestRPH": "3", > "AgeQualifyingCode": "8" > } > ] > }, > "ResGlobalInfo": { > "Comments": { > "Comment": [ > { > "Text": [ > { > "value": "late arrival - flight lands at 22:55 local time" > } > ], > "Name": "Applicant Notice", > "CommentOriginatorCode": "DISTRIBUTOR" > } > ] > }, > "CancelPenalties": { > "CancelPenalty": [ > { > "Deadline": { > "AbsoluteDeadline": "2027-07-11T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 6, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 35, > "CurrencyCode": "EUR", > "Amount": 377.48 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-14T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 3, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 50, > "CurrencyCode": "EUR", > "Amount": 539.25 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-16T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 1, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 100, > "CurrencyCode": "EUR", > "Amount": 1078.50 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-17T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 0, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 100, > "CurrencyCode": "EUR", > "Amount": 1078.50 > } > } > ] > }, > "Total": { > "AmountAfterTax": 1078.50, > "CurrencyCode": "EUR" > }, > "HotelReservationIDs": { > "HotelReservationID": [ > { > "ResID_Type": "36", > "ResID_Value": "TEST_XXX", > "ResID_SourceContext": "Client" > } > ] > }, > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "CompanyInfo": { > "CompanyName": [ > { > "value": "", > "CompanyShortName": "MTS Globe Spain - Palma De Mallorca", > "Code": "PMI", > "CountryCode": "ES" > } > ] > } > } > } > ] > } > }, > "TPA_Extensions": { > "BookingStatus": { > "ReservationStatusType": "Available" > }, > "RateDetails": { > "GuestDetails": [ > { > "RateComponents": [ > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 1, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 1, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 2, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 2, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 3, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 3, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 4, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 4, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 5, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 5, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 6, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 6, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 7, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 7, > "CodeType": "OFF" > } > ], > "CurrencyCode": "EUR", > "RateCode": "Price", > "ResGuestRPH": "1", > "TotalAmount": 406.98 > }, > { > "RateComponents": [ > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 1, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 1, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 2, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 2, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 3, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 3, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 4, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 4, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 5, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 5, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 6, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 6, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 7, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 7, > "CodeType": "OFF" > } > ], > "CurrencyCode": "EUR", > "RateCode": "Price", > "ResGuestRPH": "2", > "TotalAmount": 406.98 > }, > { > "RateComponents": [ > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 1, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 1, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 1, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 2, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 2, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 2, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 3, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 3, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 3, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 4, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 4, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 4, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 5, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 5, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 5, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 6, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 6, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 6, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "3", > "StayDay": 7, > "CodeType": "STDRATE" > }, > { > "Code": "ACPR3", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -21.42, > "ResGuestRPH": "3", > "StayDay": 7, > "CodeType": "PAX" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -1.99, > "ResGuestRPH": "3", > "StayDay": 7, > "CodeType": "OFF" > } > ], > "CurrencyCode": "EUR", > "RateCode": "Price", > "ResGuestRPH": "3", > "TotalAmount": 264.54 > } > ], > "Totals": { > "Total": [ > { > "AmountAfterTax": 1078.50, > "CurrencyCode": "EUR", > "CurrencyType": "Price", > "Override": false, > "TotalType": "Price" > } > ] > } > }, > "Extras": {} > } > } > ] > }, > "Version": 2016.2 > } > } > ``` > [tab] Multiroom > > ```xml expandable theme={null} > > > > > > > > > > > RM00CRMV00 > > > > > > > > > > > > BB > BB > > > > > > > > > > > > > > > > > > > > > RMCS00PT00 > > > > > > > > > > > > BB > BB > > > > > > > > > > > > > > > > > > > > > > > > > > > > Mr > Bender > Bending > > > > > > > > > > > > > > > > Mrs > Angelina > Bending > > > > > > > > > > > > > > > > Dr > John > Zoidberg > > > > > > > > > > > > > > > late arrival - flight lands at 22:55 local time > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelResRS": { > "Success": {}, > "HotelReservations": { > "HotelReservation": [ > { > "RoomStays": { > "RoomStay": [ > { > "ResGuestRPHs": { > "ResGuestRPH": [ > { > "RPH": 1 > }, > { > "RPH": 2 > } > ] > }, > "ServiceRPHs": { > "ServiceRPH": [ > { > "RPH": "1" > } > ] > }, > "RoomTypes": { > "RoomType": [ > { > "RoomDescription": { > "Text": [ > { > "value": "RM00CRMV00", > "Language": "EN" > } > ] > }, > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > }, > { > "value": "BB", > "Language": "EN" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RM00CRMV00" > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "Total": { > "AmountAfterTax": 813.96, > "CurrencyCode": "EUR" > }, > "BasicPropertyInfo": { > "HotelCode": "AESPMI5L46", > "HotelName": "Hotel Overlook" > }, > "IndexNumber": 1 > }, > { > "ResGuestRPHs": { > "ResGuestRPH": [ > { > "RPH": 3 > } > ] > }, > "ServiceRPHs": { > "ServiceRPH": [ > { > "RPH": "2" > } > ] > }, > "RoomTypes": { > "RoomType": [ > { > "RoomDescription": { > "Text": [ > { > "value": "RMCS00PT00", > "Language": "EN" > } > ] > }, > "RoomTypeCode": "RMCS00PT00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanID": "-OWN2-BH000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > }, > { > "value": "BB", > "Language": "EN" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RMCS00PT00" > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "Total": { > "AmountAfterTax": 373.06, > "CurrencyCode": "EUR" > }, > "BasicPropertyInfo": { > "HotelCode": "AESPMI5L46", > "HotelName": "Hotel Overlook" > }, > "IndexNumber": 2 > } > ] > }, > "Services": { > "Service": [ > { > "ServiceRPH": "1", > "ServiceInventoryCode": "BB" > }, > { > "ServiceRPH": "2", > "ServiceInventoryCode": "BB" > } > ] > }, > "ResGuests": { > "ResGuest": [ > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Mr" > ], > "GivenName": [ > "Bender" > ], > "Surname": "Bending" > } > ], > "BirthDate": 841701600000 > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": 27 > } > ] > }, > "ResGuestRPH": "1", > "AgeQualifyingCode": "10" > }, > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Mrs" > ], > "GivenName": [ > "Angelina" > ], > "Surname": "Bending" > } > ], > "BirthDate": 841788000000 > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": 27 > } > ] > }, > "ResGuestRPH": "2", > "AgeQualifyingCode": "10" > }, > { > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "Customer": { > "PersonName": [ > { > "NamePrefix": [ > "Dr" > ], > "GivenName": [ > "John" > ], > "Surname": "Zoidberg" > } > ], > "BirthDate": 526255200000 > } > } > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "Age": 37 > } > ] > }, > "ResGuestRPH": "3", > "AgeQualifyingCode": "10" > } > ] > }, > "ResGlobalInfo": { > "Comments": { > "Comment": [ > { > "Text": [ > { > "value": "late arrival - flight lands at 22:55 local time" > } > ], > "Name": "Applicant Notice", > "CommentOriginatorCode": "DISTRIBUTOR" > } > ] > }, > "CancelPenalties": { > "CancelPenalty": [ > { > "Deadline": { > "AbsoluteDeadline": "2027-07-11T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 6, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 35, > "CurrencyCode": "EUR", > "Amount": 284.89 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-14T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 3, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 50, > "CurrencyCode": "EUR", > "Amount": 406.98 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-16T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 1, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 100, > "CurrencyCode": "EUR", > "Amount": 813.96 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-17T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 0, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 100, > "CurrencyCode": "EUR", > "Amount": 813.96 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-11T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 6, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 35, > "CurrencyCode": "EUR", > "Amount": 130.57 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-14T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 3, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 50, > "CurrencyCode": "EUR", > "Amount": 186.53 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-16T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 1, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 100, > "CurrencyCode": "EUR", > "Amount": 373.06 > } > }, > { > "Deadline": { > "AbsoluteDeadline": "2027-07-17T00:00:00", > "OffsetTimeUnit": "Day", > "OffsetUnitMultiplier": 0, > "OffsetDropTime": "BeforeArrival" > }, > "AmountPercent": { > "BasisType": "FullStay", > "Percent": 100, > "CurrencyCode": "EUR", > "Amount": 373.06 > } > } > ] > }, > "Total": { > "AmountAfterTax": 1187.02, > "CurrencyCode": "EUR" > }, > "HotelReservationIDs": { > "HotelReservationID": [ > { > "ResID_Type": "36", > "ResID_Value": "TEST_XXX", > "ResID_SourceContext": "Client" > } > ] > }, > "Profiles": { > "ProfileInfo": [ > { > "Profile": { > "CompanyInfo": { > "CompanyName": [ > { > "value": "", > "CompanyShortName": "MTS Globe Spain - Palma De Mallorca", > "Code": "PMI", > "CountryCode": "ES" > } > ] > } > } > } > ] > } > }, > "TPA_Extensions": { > "BookingStatus": { > "ReservationStatusType": "Available" > }, > "RateDetails": { > "GuestDetails": [ > { > "RateComponents": [ > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 1, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 1, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 2, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 2, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 3, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 3, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 4, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 4, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 5, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 5, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 6, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 6, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "1", > "StayDay": 7, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "1", > "StayDay": 7, > "CodeType": "OFF" > } > ], > "CurrencyCode": "EUR", > "RateCode": "Price", > "ResGuestRPH": "1", > "TotalAmount": 406.98 > }, > { > "RateComponents": [ > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 1, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 1, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 2, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 2, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 3, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 3, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 4, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 4, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 5, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 5, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 6, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 6, > "CodeType": "OFF" > }, > { > "Code": "AMT8", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 61.20, > "ResGuestRPH": "2", > "StayDay": 7, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -3.06, > "ResGuestRPH": "2", > "StayDay": 7, > "CodeType": "OFF" > } > ], > "CurrencyCode": "EUR", > "RateCode": "Price", > "ResGuestRPH": "2", > "TotalAmount": 406.98 > }, > { > "RateComponents": [ > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 1, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 1, > "CodeType": "OFF" > }, > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 2, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 2, > "CodeType": "OFF" > }, > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 3, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 3, > "CodeType": "OFF" > }, > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 4, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 4, > "CodeType": "OFF" > }, > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 5, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 5, > "CodeType": "OFF" > }, > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 6, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 6, > "CodeType": "OFF" > }, > { > "Code": "AMT15", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": 56.10, > "ResGuestRPH": "3", > "StayDay": 7, > "CodeType": "STDRATE" > }, > { > "Code": "EBO1", > "CurrencyCode": "EUR", > "Edition": 0, > "Rate": -2.81, > "ResGuestRPH": "3", > "StayDay": 7, > "CodeType": "OFF" > } > ], > "CurrencyCode": "EUR", > "RateCode": "Price", > "ResGuestRPH": "3", > "TotalAmount": 373.06 > } > ], > "Totals": { > "Total": [ > { > "AmountAfterTax": 813.96, > "CurrencyCode": "EUR", > "CurrencyType": "Price", > "Override": false, > "TotalType": "Price" > }, > { > "AmountAfterTax": 373.06, > "CurrencyCode": "EUR", > "CurrencyType": "Price", > "Override": false, > "TotalType": "Price" > } > ] > } > }, > "Extras": {} > } > } > ] > }, > "Version": 2016.2 > } > } > ``` ## Best Practices 1. Always supply a unique partner reference (`ResID_Type="36"`) and reuse it for cancel/read operations. 2. Use `ResStatus="Quote"` before `Commit` to confirm pricing, availability, and penalties. 3. Provide `NamePrefix` for all adult guests and keep guest ordering consistent across rooms and services. 4. Link rooms, guests and services using `RPH` consistently; use `CancelPenalty@Item_RPH` to map policies to rooms. 5. For multi-room bookings, include each room as a separate `RoomStay` (up to 5 rooms) so combined availability is validated. 6. When booking optional extras, include them in the request and consume them from `TPA_Extensions/Extras` in the response. # OTA_HotelDescriptiveInfoRQ Source: https://docs.axisdata.net/hotel/mappingRQ The `OTA_HotelDescriptiveInfoRQ` (Non‑Bookable Content / static data request) lets you retrieve hotel descriptive data such as addresses, geocodes, amenities, images metadata, category codes, and other facts used for mapping and content enrichment. It is typically used for portfolio synchronization, templated inventory/amenities exports, delta updates, or geo‑area lookups. > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_HotelDescriptiveInfoRQ API call](/api-reference/endpoint/hotel/nbc) > > Skip & Hit the Playground. ## Purpose Use this request to: * Download **hotel lists** tied to one or more client feeds (`BrandCode`). * Pull **details** for a single hotel (`HotelCode`). * Retrieve **facts & amenities** (STOCK template) or a hotel’s **room/board/occupancy mapping set** (SUMMARY template). * Perform **geo‑area search** (lat/lon + radius) and limit results via `MaxResponses`. * Request **delta** updates since a point in time using `LastUpdateDate`. ## Structure – Root Element ```xml theme={null} ``` ```json theme={null} "OTA_HotelDescriptiveInfoRQ" ``` **Key Attributes:** * `xmlns` (required): `http://www.opentravel.org/OTA/2003/05`. * `Version` (required): specification version (e.g., `2008.1`). * `PrimaryLangID` (optional): primary language (ISO 639). Use `*` to return all available languages. * `AltLangID` (optional): fallback language (recommend `EN`). * `MaxResponses` (optional): caps the number of hotels returned (applies to geo‑area search). * `LastUpdateDate` (optional): filter to hotels modified **after** this timestamp (delta retrieval). ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and carries credentials. ```xml theme={null} ``` ```json theme={null} { "OTA_HotelDescriptiveInfoRQ": { "POS": { "Source": [ { "RequestorID": [ { "Type": "22", "ID": "TEST", "ID_Context": "AxisData" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } } ``` ### HotelDescriptiveInfo Wrapper for one or more requests. Use `BrandCode` to scope to one or multiple client feeds, or `HotelCode` to target a single property. ```xml theme={null} ``` ```json theme={null} { "HotelDescriptiveInfos": { "HotelDescriptiveInfo": { "BrandCode": "TEST", "ContactInfo": { "SendData": "false" }, "MultimediaObjects": { "SendData": "false" }, "HotelInfo": { "SendData": "false" }, "AreaInfo": { "SendRefPoints": "false" }, "AffiliationInfo": { "SendAwards": "false" } } } } ``` #### Enrichment Switches Include the child nodes below under `HotelDescriptiveInfo` to control which blocks are returned. If the switch node exists and is not set to `false`, data is included. * `ContactInfo` with `SendData="false"` → omit address/contact data. * `MultimediaObjects` with `SendData="false"` → omit image metadata. * `HotelInfo` with `SendData="false"` → omit descriptions/services blocks. * `AreaInfo` with `SendRefPoints="false"` → omit geo/location reference points. * `AffiliationInfo` with `SendAwards="false"` → omit star rating/awards. #### ContentInfos ```xml theme={null} ``` ```json theme={null} { "HotelDescriptiveInfo": { "BrandCode": "TEST", "ContentInfos": { "ContentInfo": { "Code": "Template", "Name": "STOCK" } } } } ``` Use `ContentInfos/ContentInfo` pairs to: * Request a **template**: `Code="Template" Name="STOCK"` (facts & amenities) or `Name="Summary"` (room+board+occupancy inventory for a hotel). Only **one template** can be requested at a time; templates are **not compatible** with other enrichment switches. * Perform **geo search**: provide `Code="GeoLatitude"`, `Code="GeoLongitude"`, and `Code="GeoRadius"` (meters). If radius not set, default is 200 m. Pair with `MaxResponses` at the root to cap the number of results. ## Additional Features ### Language Handling * Set `AltLangID="EN"` to ensure untranslated concepts fall back to English. * To request **all languages**, set `PrimaryLangID="*"` (may repeat `HotelDescriptiveContent` per language in the response). * To request a **specific set**, pass a backslash‑separated list in `PrimaryLangID` (e.g., `EN\DE\FR\IT`). Check [Languages](../general/messaging#languages) ### Multi‑Client Requests * Pass multiple Client IDs in `BrandCode` separated by **pipes** (e.g., `CLIENTA|CLIENTB`). Any hotel assigned to **at least one** of the requested Client IDs is returned. ```xml theme={null} ``` ```json theme={null} { "HotelDescriptiveInfo": { "BrandCode": "CLIENTA|CLIENTB|CLIENTC" } } ``` ### Delta Updates * Use `LastUpdateDate` to retrieve hotels modified after the provided timestamp. * Recommendation: subtract \~3 hours from your last known update to avoid timezone/skew issues. ```xml theme={null} ``` ```json theme={null} { "OTA_HotelDescriptiveInfoRQ": { "LastUpdateDate": "2019-08-08T18:00:00" } } ``` ## Complete Examples > [tab] Single Hotel > > ```xml expandable theme={null} > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelDescriptiveInfos" : { > "HotelDescriptiveInfo" : [ { > "BrandCode" : "TEST", > "HotelCode" : "AESPMI5L46" > } ] > }, > "Version" : 2009.1, > "PrimaryLangID" : "EN", > "AltLangID" : "EN" > } > } > ``` > [tab] Hotel List > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelDescriptiveInfos" : { > "HotelDescriptiveInfo" : [ { > "HotelInfo" : { > "SendData" : false > }, > "AreaInfo" : { > "SendRefPoints" : false > }, > "AffiliationInfo" : { > "SendAwards" : false > }, > "ContactInfo" : { > "SendData" : false > }, > "MultimediaObjects" : { > "SendData" : false > }, > "BrandCode" : "TEST" > } ] > }, > "Version" : 2009.1, > "PrimaryLangID" : "EN", > "AltLangID" : "EN" > } > } > ``` > [tab] Amenities > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelDescriptiveInfos" : { > "HotelDescriptiveInfo" : [ { > "ContentInfos" : { > "ContentInfo" : [ { > "Code" : "Template", > "Name" : "STOCK" > } ] > }, > "BrandCode" : "TEST" > } ] > }, > "Version" : 2009.1, > "PrimaryLangID" : "EN", > "AltLangID" : "EN" > } > } > ``` > [tab] Inventory > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelDescriptiveInfos" : { > "HotelDescriptiveInfo" : [ { > "ContentInfos" : { > "ContentInfo" : [ { > "Code" : "Template", > "Name" : "Summary" > } ] > }, > "HotelCode" : "AESPMI5L46" > } ] > }, > "Version" : 2009.1, > "PrimaryLangID" : "EN", > "AltLangID" : "EN" > } > } > ``` > [tab] Geo‑Area > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "HotelDescriptiveInfos" : { > "HotelDescriptiveInfo" : [ { > "HotelInfo" : { > "SendData" : false > }, > "AreaInfo" : { > "SendRefPoints" : false > }, > "ContactInfo" : { > "SendData" : false > }, > "MultimediaObjects" : { > "SendData" : false > }, > "ContentInfos" : { > "ContentInfo" : [ { > "Code" : "GeoLatitude", > "Name" : "40.4157" > }, { > "Code" : "GeoLongitude", > "Name" : "-3.7002" > }, { > "Code" : "GeoRadius", > "Name" : "200" > } ] > }, > "BrandCode" : "TEST" > } ] > }, > "Version" : 2009.1, > "PrimaryLangID" : "EN", > "AltLangID" : "EN" > } > } > ``` ## Best Practices 1. Keep `AltLangID="EN"` so untranslated concepts fall back consistently. 2. For **hotel list** downloads, set **all switches to `false`** to allow full-result batching and optimized processing. 3. Do **not** combine templates with other switches; request either `STOCK` **or** `Summary` per call. 4. For **geo search**, set `MaxResponses` to your desired cap (default is 10) and use a sensible radius (default 200 m) to control payload size. 5. When running **delta**, subtract \~3 hours from your last checkpoint in `LastUpdateDate` to avoid timezone drift. ## Playground > [card] [OTA\_HotelDescriptiveInfoRQ API call](/api-reference/endpoint/hotel/nbc) > > Try our API playground in real time. > [!TIP] > > Use any of the requests above in the playground and receive responses from the test environment. # OTA_HotelDescriptiveInfoRS Source: https://docs.axisdata.net/hotel/mappingRS Static, non-bookable content used for hotel mapping (rooms, boards, amenities, geo, media). Pairs with OTA\_HotelDescriptiveInfoRQ. ## Purpose This response delivers **Non‑Bookable Content (NBC)** for one or multiple properties so partners can map hotels, rooms, boards, amenities, locations, images, and DRV/third‑party codes. It is optimized for periodic full loads and daily deltas. ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_HotelDescriptiveInfoRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2009.1", "TransactionIdentifier": "1-37/37", ... } } ``` **Key Attributes** * `Version` — specification version (e.g., `2009.1`). * `TransactionIdentifier` — reports the count/range of hotels included in the payload. ## Structure – Core Elements ### HotelDescriptiveContent Container and item for each property returned. ```xml theme={null} ``` ```json theme={null} { "HotelDescriptiveContent": { "LanguageCode": "EN", "RPH": "1", "HotelCode": "AESPMI5L46", "HotelName": "Hostal Cuba", "HotelCodeContext": "354402", "LastModifiedDate": "2024-06-30T04:07:59" } } ``` **Common Attributes on `HotelDescriptiveContent`:** * `LanguageCode` — ISO language code of the content. * `RPH` — sequence reference. * `HotelCode` — partner hotel code. * `HotelName` — marketing name. * `HotelCodeContext` — GIATA code when licensed. * `ChainName` *(optional)* — brand/chain. * `LastModifiedDate` — last modification timestamp for the property’s static data. #### HotelInfo High‑level static details. **CategoryCodes** → `HotelCategory` and repeated `GuestRoomInfo` (room master data). ```xml theme={null} Double Standard Room ... ``` ```json theme={null} { "CategoryCodes": { "HotelCategory": { "Code": "20", "CodeDetail": "Hotel" }, "GuestRoomInfo": [ { "Code": "42", "CodeDetail": "RM00CRMV00", "DescriptiveText": "Double Standard Room" }, ... ] } } ``` Check [Hotel Related Codes](../glossary/codes#hotel-related-codes). **Descriptions** → `DescriptiveText` consists of a long‑form factsheet text; may contain multiple paragraphs. ```xml theme={null} General Description Located approximately 15 km from the nearest sandy beach, this charming rural hotel is set in a beautifully restored traditional farmhouse in the heart of Lanzarote. This boutique property offers a peaceful and authentic Canarian experience, surrounded by volcanic landscapes and vineyards. The town of San Bartolomé is just 2 km away, while Arrecife and Teguise are within a 10-minute drive. Guests will find a supermarket only 150 m from the property, and popular attractions such as Timanfaya National Park (18 km) and the Wine Museum (3 km) are easily accessible. Lanzarote Airport (ACE) is conveniently located just 5 km away, and the nearest hospital is 8 km from the hotel. Amenities This two-storey boutique hotel features 8 individually decorated rooms that combine rustic charm with modern comfort. Guests are welcomed at a cozy reception area (check-in from 12:00, check-out until 12:00), and free private parking is available on site. The hotel offers complimentary Wi-Fi throughout the property. Additional services include laundry and ironing (available for a fee). The on-site restaurant serves locally inspired cuisine in a warm and intimate setting, using fresh, seasonal ingredients. Meals Guests can enjoy a daily breakfast buffet featuring local products. Half-board options include breakfast and a delicious à la carte dinner served at the hotel’s restaurant. Sport and Leisure While the hotel is designed for relaxation, guests can enjoy a variety of nearby activities. Tennis courts are located approximately 15 km away, and water sports such as windsurfing, diving, and sailing are available at nearby beaches (services provided by local operators). A golf course is located around 12 km from the hotel. The surrounding area is ideal for hiking, cycling, and wine tasting tours. Additional Information Please note that some services and amenities may incur additional charges or depend on seasonal availability. The hotel staff speaks English, German, ``` ```json theme={null} { "Descriptions": { "DescriptiveText": "General Description\nLocated approximately 15 km from the nearest sandy beach, this charming rural hotel is set in a beautifully restored traditional farmhouse in the heart of Lanzarote. This boutique property offers a peaceful and authentic Canarian experience, surrounded by volcanic landscapes and vineyards. The town of San Bartolomé is just 2 km away, while Arrecife and Teguise are within a 10-minute drive. Guests will find a supermarket only 150 m from the property, and popular attractions such as Timanfaya National Park (18 km) and the Wine Museum (3 km) are easily accessible. Lanzarote Airport (ACE) is conveniently located just 5 km away, and the nearest hospital is 8 km from the hotel.\n\nAmenities\nThis two-storey boutique hotel features 8 individually decorated rooms that combine rustic charm with modern comfort. Guests are welcomed at a cozy reception area (check-in from 12:00, check-out until 12:00), and free private parking is available on site. The hotel offers complimentary Wi-Fi throughout the property. Additional services include laundry and ironing (available for a fee). The on-site restaurant serves locally inspired cuisine in a warm and intimate setting, using fresh, seasonal ingredients.\n\nMeals\nGuests can enjoy a daily breakfast buffet featuring local products. Half-board options include breakfast and a delicious à la carte dinner served at the hotel’s restaurant.\n\nSport and Leisure\nWhile the hotel is designed for relaxation, guests can enjoy a variety of nearby activities. Tennis courts are located approximately 15 km away, and water sports such as windsurfing, diving, and sailing are available at nearby beaches (services provided by local operators). A golf course is located around 12 km from the hotel. The surrounding area is ideal for hiking, cycling, and wine tasting tours.\n\nAdditional Information\nPlease note that some services and amenities may incur additional charges or depend on seasonal availability. The hotel staff speaks English, German," } } ``` **Position** (`Latitude`, `Longitude`) — geo coordinates placed under `HotelInfo`. ```xml theme={null} ``` ```json theme={null} { "Position": { "Latitude": "29.04025", "Longitude": "-13.51425" } } ``` **Services** → repeated `Service` entries; each `Service` may include `Features/Feature` and `OperationSchedules`. ```xml theme={null} Breakfast Food & Beverage|Dining Room|Air-Conditioning| ... ``` ```json theme={null} { "Services": { "Service": [ { "ID": "BB", "CodeDetail": "Board", "DescriptiveText": "Breakfast" }, { "CodeDetail": "FOOD|DININGROOM|FB_AIRCOND|", "DescriptiveText": "Food & Beverage|Dining Room|Air-Conditioning|" }, ... ] } } ``` > [!NOTE] > > `Service@CodeDetail` encodes a hierarchy using line breaks (pipes in textual examples). Related values can appear under `Features/Feature@CodeDetail` with a `DescriptiveText` value. Duration windows may be modeled with `OperationSchedules/OperationSchedule`. #### AreaInfo Location taxonomy and airports. Airports may specify: * `Nearest` (boolean), `PrimaryIndicator` (main airport), * `Distance` (km) with `UnitOfMeasureCode="2"`, and `Proximity` (travel time in minutes). ```xml theme={null} ``` ```json theme={null} { "AreaInfo": { "RefPoints": { "RefPoint": [ { "Name": "Spain", "RefPointName": "Country" }, { "Name": "San Bartolome", "RefPointName": "Resort" }, { "Name": "Lanzarote", "RefPointName": "Region" }, { "Name": "ES", "RefPointName": "CountryCode" }, { "Nearest": true, "Name": "ACE", "PrimaryIndicator": true, "Distance": 5, "UnitOfMeasureCode": 2, "Proximity": 15, "RefPointName": "Airport" } ] } } } ``` #### AffiliationInfo Optional star rating via `Award@Rating` (e.g., `4 Stars`). ```xml theme={null} ``` ```json theme={null} { "AffiliationInfo": { "Awards": { "Award": [ { "Rating": "2 Stars" } ] } } } ``` #### MultimediaDescriptions Image catalog per property. * `ImageItem` (category via `Category`/`ID`) and optional `LastModifyDateTime`. * `ImageFormat` includes `DimensionCategory` (`thumbnail`, `display`, `print`, `print_lead`), `Width`, `Height`, and a file `URL` (filename only). * `Description`: * It can define a short descritpion of the content of the image shown in `ImageItem`. It includes the attribute `Language`. * If the attribute `Caption` is included, and the node is inside of `ImageFormat`, it shows to the unit that this image is corresponding. * Prefer ordering by `Sort` (ascending). **Standard Image Sizes** * `print_lead` ≈ 2400 px (≈ 2.5 MB) * `print` ≈ 1200 px (≈ 1 MB) * `display` ≈ 450 px (≈ 130 KB) * `thumbnail` ≈ 200 px (≈ 40 KB) **Download rule**: construct the full image URL using the `hotel` code and `filename`; store images locally for runtime use. `http://tkimages.axisdata.net/ImageConverter.php?size={DimensionCategory}&height={Height}&hotel={HotelCode}&filename={URL}` Example: `size=print&height=1200&hotel=AMTSBG11C&filename=01.jpg` > [!WARNING] > > * Images are not for hotlinking; partners must download & serve from their CDNs. > * Test systems don’t serve images; use production. Show images by Sort (lower = higher priority). > * If originals are low quality, some sizes/categories may be missing. ```xml expandable theme={null} This image shows a white facade at the entrance of the hotel, with balconies. facade.jpg ... This image shows a cathedral gothic style cathedral outside of the hotel. Cathedral.jpg Cathedral.jpg ... ``` ```json expandable theme={null} { "MultimediaDescriptions": { "MultimediaDescription": [ { "ImageItems": { "ImageItem": [ { "Category": "HOTELEXTERIOR", "ID": "1", "LastModifyDateTime": "2017-04-12T10:44:48", "Description": { "Language": "EN", "text": " This image shows a white facade at the entrance of the hotel, with balconies." }, "ImageFormat": [ { "UnitOfMeasureCode": 9, "Width": 3543, "Height": 1877, "Format": 6, "FileName": "facade_1.jpg", "DimensionCategory": "original", "Sort": 1, "Title": "Hotel exterior", "RecordID": 1, "URL": "facade.jpg" }, ... ] }, ... ] } } ] } } ``` #### ContactInfos Postal address, phone, email, and web URL for the property and/or supplier contact. ```xml expandable theme={null}
C/. saten 8 San Bartolome 35562 ES Lanzarote Spain
fake_int@axisdata.net www.fakeweb.com
MTS Globe Spain -Lanzarote
``` ```json expandable theme={null} { "ContactInfos": { "ContactInfo": [ { "Location": 6, "Addresses": { "Address": [ { "AddressLine": "C/. saten 8", "CityName": "San Bartolome", "PostalCode": "35562", "Country": "ES", "StateProv": "Lanzarote", "CountryName": "Spain" } ] }, "Phones": { "Phone": [ { "PhoneTechType": 1, "PhoneNumber": "555 55 55 55" } ] }, "Emails": { "Email": "fake_int@axisdata.net" }, "URLs": { "URL": [ { "Type": "Web", "Value": "www.fakeweb.com" } ] } }, { "Location": 7, "CompanyName": { "Code": "ACE", "Value": "MTS Globe Spain -Lanzarote" } } ] } } ``` #### CodeConversions DRV GlobalType mappings for hotel, room, and board levels. Requires DRV license. Entries use repeated `CodeConversion` elements with nested `DRVGlobalTypes/DRVGlobalType/GTAttribute` and optional `Description`. Check complete example below to view in response. ## Behavior & Switches If an enrichment switch is present in the **request** and set to `false`, the corresponding section is **omitted** in the response. * `HotelInfo SendData="false"` → omits `Descriptions` and `Services`. * `ContactInfo SendData="false"` → omits address block. * `AreaInfo SendRefPoints="false"` → omits `RefPoints`. * `AffiliationInfo SendAwards="false"` → omits `Awards`. * `MultimediaObjects SendData="false"` → omits images. ## Complete Examples > [tab] Hotel List > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRS": { > "Success": {}, > "HotelDescriptiveContents": { > "HotelDescriptiveContent": [ > { > "LanguageCode": "EN", > "RPH": "1", > "LastModifiedDate": "2026-06-01T15:50:40", > "HotelCode": "AMTMLA5L7A", > "HotelName": "Inside Marsa", > "HotelCodeContext": "666555999" > }, > { > "LanguageCode": "EN", > "RPH": "3", > "LastModifiedDate": "2026-06-01T15:44:33", > "HotelCode": "AMTMLA5L78", > "HotelName": "Bright Bird Bock", > "HotelCodeContext": "554848484" > }, > { > "LanguageCode": "EN", > "RPH": "4", > "LastModifiedDate": "2026-05-28T15:25:19", > "HotelCode": "AMTMLA5L76", > "HotelName": "The Rocky Motel", > "HotelCodeContext": "554447784" > }, > { > "LanguageCode": "EN", > "RPH": "6", > "LastModifiedDate": "2026-06-01T15:34:04", > "HotelCode": "AMTMLA5L70", > "HotelName": "The Sea Uchin", > "HotelCodeContext": "287510930" > }, > { > "LanguageCode": "EN", > "RPH": "8", > "LastModifiedDate": "2026-06-01T15:42:16", > "HotelCode": "AMTMLA5L74", > "HotelName": "Royale Apartments Biri", > "HotelCodeContext": "15156415" > }, > { > "LanguageCode": "EN", > "RPH": "9", > "LastModifiedDate": "2026-06-01T15:39:27", > "HotelCode": "AMTMLA5L72", > "HotelName": "Sea Paradise", > "HotelCodeContext": "47878787" > }, > { > "LanguageCode": "EN", > "RPH": "11", > "LastModifiedDate": "2026-02-25T16:54:00", > "HotelCode": "AAEDXB5L7S", > "HotelName": "Grand Hotel Jamal", > "HotelCodeContext": "70900580" > }, > { > "LanguageCode": "EN", > "RPH": "13", > "LastModifiedDate": "2026-05-05T13:20:03", > "HotelCode": "AESPMI5L66", > "HotelName": "Hotel Tulipan", > "HotelCodeContext": "77788877" > }, > { > "LanguageCode": "EN", > "RPH": "14", > "LastModifiedDate": "2026-02-24T16:24:19", > "HotelCode": "AAEDXB5L7U", > "HotelName": "Resort Aljana Dubai", > "HotelCodeContext": "86456656" > }, > { > "LanguageCode": "EN", > "RPH": "15", > "LastModifiedDate": "2026-05-26T10:09:24", > "HotelCode": "AESPMI5L64", > "HotelName": "Heaven Place Resort", > "HotelCodeContext": "123456788" > }, > { > "LanguageCode": "EN", > "RPH": "16", > "LastModifiedDate": "2026-05-19T13:40:44", > "HotelCode": "AAEDXB5L80", > "HotelName": "Burj Aldalw", > "HotelCodeContext": "17368716" > }, > { > "LanguageCode": "EN", > "RPH": "18", > "LastModifiedDate": "2026-05-19T13:37:27", > "HotelCode": "AAEDXB5L82", > "HotelName": "Salat Bandar Hills", > "HotelCodeContext": "87966787" > }, > { > "LanguageCode": "EN", > "RPH": "19", > "LastModifiedDate": "2026-05-26T11:24:05", > "HotelCode": "AAEDXB5L7Q", > "HotelName": "Burj Alfursan", > "HotelCodeContext": "54548989" > }, > { > "LanguageCode": "EN", > "RPH": "20", > "LastModifiedDate": "2026-05-26T11:22:25", > "HotelCode": "AAEDXB5L7W", > "HotelName": "Alsarir Walafitar Jumeirah", > "HotelCodeContext": "879564354" > }, > { > "LanguageCode": "EN", > "RPH": "21", > "LastModifiedDate": "2026-05-11T11:56:07", > "HotelCode": "AAEDXB5L7Y", > "HotelName": "Hotel Shwkulata", > "HotelCodeContext": "489798795" > }, > { > "LanguageCode": "EN", > "RPH": "22", > "LastModifiedDate": "2026-04-09T16:30:53", > "HotelCode": "AGRHER5L96", > "HotelName": "Ykono Suites and Spa", > "HotelCodeContext": "84561234" > }, > { > "LanguageCode": "EN", > "RPH": "23", > "LastModifiedDate": "2026-05-28T15:10:28", > "HotelCode": "AGRHER5L98", > "HotelName": "Dionisius Stafyli", > "HotelCodeContext": "178495" > }, > { > "LanguageCode": "EN", > "RPH": "25", > "LastModifiedDate": "2026-05-26T11:14:55", > "HotelCode": "AESLPA5L68", > "HotelName": "El Pececito", > "HotelCodeContext": "45554545" > }, > { > "LanguageCode": "EN", > "RPH": "26", > "LastModifiedDate": "2026-05-28T15:18:12", > "HotelCode": "AGRHER5L92", > "HotelName": "Krusty Crab", > "HotelCodeContext": "321648651" > }, > { > "LanguageCode": "EN", > "RPH": "28", > "LastModifiedDate": "2026-04-09T16:22:52", > "HotelCode": "AGRHER5L94", > "HotelName": "Olimpic Hercules", > "HotelCodeContext": "4446664" > }, > { > "LanguageCode": "EN", > "RPH": "29", > "LastModifiedDate": "2026-05-28T11:36:52", > "HotelCode": "AGRHER5L90", > "HotelName": "Kalispera Hotel", > "HotelCodeContext": "6548745" > }, > { > "LanguageCode": "EN", > "RPH": "30", > "LastModifiedDate": "2026-05-28T11:20:29", > "HotelCode": "AESLPA5L6A", > "HotelName": "La Piedad Hotel", > "HotelCodeContext": "12369876" > }, > { > "LanguageCode": "EN", > "RPH": "31", > "LastModifiedDate": "2026-05-26T11:12:09", > "HotelCode": "AESLPA5L6G", > "HotelName": "Jardin de Flores", > "HotelCodeContext": "412784848" > }, > { > "LanguageCode": "EN", > "RPH": "33", > "LastModifiedDate": "2026-09-17T14:20:39", > "HotelCode": "AESPMI5L46", > "HotelName": "Hotel Overlook", > "HotelCodeContext": "789101112" > }, > { > "LanguageCode": "EN", > "RPH": "34", > "LastModifiedDate": "2026-05-26T10:38:56", > "HotelCode": "AESLPA5L6K", > "HotelName": "El Calao Canario", > "HotelCodeContext": "422211331" > }, > { > "LanguageCode": "EN", > "RPH": "36", > "LastModifiedDate": "2026-05-26T11:08:12", > "HotelCode": "AESLPA5L6I", > "HotelName": "Mirador de Montepinar", > "HotelCodeContext": "-812045715" > }, > { > "LanguageCode": "EN", > "RPH": "37", > "LastModifiedDate": "2026-05-26T11:18:10", > "HotelCode": "AESPMI5L3Q", > "HotelName": "Tramuntana Tech Hotel", > "HotelCodeContext": "145748" > }, > { > "LanguageCode": "EN", > "RPH": "39", > "LastModifiedDate": "2026-05-28T11:31:22", > "HotelCode": "AESLPA5L6O", > "HotelName": "Le Petite Paris", > "HotelCodeContext": "547816984" > }, > { > "LanguageCode": "EN", > "RPH": "40", > "LastModifiedDate": "2026-05-26T10:16:08", > "HotelCode": "AESLPA5L6M", > "HotelName": "Grand Hotel Resort Rico", > "HotelCodeContext": "333322221" > }, > { > "LanguageCode": "EN", > "RPH": "42", > "LastModifiedDate": "2026-05-26T11:36:32", > "HotelCode": "AESPMI5L4M", > "HotelName": "Bungalow for Life", > "HotelCodeContext": "456789123" > }, > { > "LanguageCode": "EN", > "RPH": "44", > "LastModifiedDate": "2026-05-26T11:33:11", > "HotelCode": "AESPMI5L4K", > "HotelName": "Sleep Well Motel", > "HotelCodeContext": "987654321" > }, > { > "LanguageCode": "EN", > "RPH": "49", > "LastModifiedDate": "2026-05-26T11:30:13", > "HotelCode": "AESPMI5L4A", > "HotelName": "The Tipton Hotel", > "HotelCodeContext": "123456789" > }, > { > "LanguageCode": "EN", > "RPH": "52", > "LastModifiedDate": "2026-05-28T12:39:40", > "HotelCode": "AGRHER5L9A", > "HotelName": "Zeus Rooms", > "HotelCodeContext": "3987125" > }, > { > "LanguageCode": "EN", > "RPH": "54", > "LastModifiedDate": "2026-04-09T16:50:21", > "HotelCode": "AGRHER5L9C", > "HotelName": "Trikinyuelas", > "HotelCodeContext": "3030303" > } > ] > }, > "Version": 2009.1, > "TransactionIdentifier": "1-35/35" > } > } > ``` > [tab] Hotel (Detailed) > > ```xml expandable theme={null} > > xmlns="http://www.opentravel.org/OTA/2003/05" Version="2009.1" TransactionIdentifier="1-1/1"> > > > > > > > > Standard Room > > > SingleUse Standard Room > > > > > General Description > Located approximately 15 km from the nearest sandy beach, this charming rural hotel is set in a beautifully restored traditional farmhouse in the heart of Lanzarote. This boutique property offers a peaceful and authentic Canarian experience, surrounded by volcanic landscapes and vineyards. The town of San Bartolomé is just 2 km away, while Arrecife and Teguise are within a 10-minute drive. Guests will find a supermarket only 150 m from the property, and popular attractions such as Timanfaya National Park (18 km) and the Wine Museum (3 km) are easily accessible. Lanzarote Airport (ACE) is conveniently located just 5 km away, and the nearest hospital is 8 km from the hotel. > > Amenities > This two-storey boutique hotel features 8 individually decorated rooms that combine rustic charm with modern comfort. Guests are welcomed at a cozy reception area (check-in from 12:00, check-out until 12:00), and free private parking is available on site. The hotel offers complimentary Wi-Fi throughout the property. Additional services include laundry and ironing (available for a fee). The on-site restaurant serves locally inspired cuisine in a warm and intimate setting, using fresh, seasonal ingredients. > > Meals > Guests can enjoy a daily breakfast buffet featuring local products. Half-board options include breakfast and a delicious à la carte dinner served at the hotel’s restaurant. > > Sport and Leisure > While the hotel is designed for relaxation, guests can enjoy a variety of nearby activities. Tennis courts are located approximately 15 km away, and water sports such as windsurfing, diving, and sailing are available at nearby beaches (services provided by local operators). A golf course is located around 12 km from the hotel. The surrounding area is ideal for hiking, cycling, and wine tasting tours. > > Additional Information > Please note that some services and amenities may incur additional charges or depend on seasonal availability. The hotel staff speaks English, German, > > > > > Breakfast > > > Half Board > > > > > sand > > > Bathing Facilities|Beach|Beach Type:|sand > > > Bathing Facilities|Beach|Public Beach| > > > > > by bus/car > > > Bathing Facilities|Beach|Route to Beach:|by bus/car > > > Boarding & Mealplan|Halfboard|Includes Breakfast| > > > Boarding & Mealplan|Halfboard|Includes Dinner| > > > Themes|Hotel Type|Charming Hotel| > > > > > 12 km > > > Sports|Diving|Diving School|12 > > > > > extra fee > > > Sports|Diving|Diving School|extra fee > > > > > 12 km > > > Sports|Diving|Diving Spot|12 > > > > > 15 min > > > Sports|Diving|Diving Spot|15 > > > Environmental Commitment|Hotel|Hotel Recycle Bins| > > > > > Breakfast Buffet > > > Food & Beverage|Breakfast|Breakfast Type:|Breakfast Buffet > > > > > A la Carte > > > Food & Beverage|Dinner|Main Course|A la Carte > > > > > A la Carte > > > Food & Beverage|Dinner|Dessert|A la Carte > > > Food & Beverage|Dinner|Dress Code| > > > > > A la Carte > > > Food & Beverage|Dinner|Salads|A la Carte > > > > > A la Carte > > > Food & Beverage|Dinner|Starters|A la Carte > > > Food & Beverage|Restaurants|Local/National Restaurant| > > > > > 1 > > > Food & Beverage|Restaurants|No. of Restaurants:|1 > > > > > Wi-Fi/HotSpots (free) > > > Hotel Facilities|Guest Amenities|Internet|Wi-Fi/HotSpots (free) > > > > > extra fee > > > Hotel Facilities|Guest Amenities|Ironing Service|extra fee > > > > > extra fee > > > Hotel Facilities|Guest Amenities|Laundry Service|extra fee > > > Hotel Facilities|General Facilties|Lobby| > > > Hotel Facilities|General Facilties|Lounge| > > > > > free of charge > > > Hotel Facilities|Parking Facilities|Car Park|free of charge > > > General Facilties|Reception| > > > Sports|Golf Hotel|Clubhouse| > > > Sports|Golf Hotel|Dressing Room| > > > > > 18 Hole > > > Sports|Golf Hotel|Golf Course|18 Hole > > > > > extra fee > > > Sports|Golf Hotel|Golf Course|extra fee > > > > > 12 km > > > Sports|Golf Hotel|Golf Location|12 > > > > > 15 min > > > Sports|Golf Hotel|Golf Location|15 > > > > > Driving Range, Pitching Area, Putting Green > > > Sports|Golf Hotel|Practice Area|Driving Range, Pitching Area, Putting Green > > > > > Golf School, Pro Shop, Rental Service, Golf Trolleys, Golf Cars > > > Sports|Golf Hotel|Service|Golf School, Pro Shop, Rental Service, Golf Trolleys, Golf Cars > > > > > Public > > > Sports|Golf Hotel|Type of Use|Public > > > Themes|Hotel Type|Historic Hotel| > > > > > 15 km > > > Sports|Kite Surfing|Kite Surf School|15 > > > > > extra fee > > > Sports|Kite Surfing|Kite Surf School|extra fee > > > > > 15 km > > > Sports|Kite Surfing|Kite Surf Spot|15 > > > > > 20 min > > > Sports|Kite Surfing|Kite Surf Spot|20 > > > Leisure Facilities|Activities|Reading Room| > > > > > 18 km > > > Locations & Distances|Other Locations|Attraction 1:|18 > > > > > Parque Nacionl De Timanfaya > > > Locations & Distances|Other Locations|Attraction 1:|Parque Nacionl De Timanfaya > > > > > 3 km > > > Locations & Distances|Other Locations|Attraction 2:|3 > > > > > El Grifo, Bodegas Y Museo > > > Locations & Distances|Other Locations|Attraction 2:|El Grifo, Bodegas Y Museo, El Grifo, Bodegas Y Museo > > > > > 15 km > > > Locations & Distances|Recreation Area|Beach|15 > > > > > Playa De Famara > > > Locations & Distances|Recreation Area|Beach|Playa De Famara > > > > > 2 km > > > Locations & Distances|Other Locations|Town Centre|2 > > > > > 2 km > > > Locations & Distances|Cities|City 1:|2 > > > > > San Bartolome > > > Locations & Distances|Cities|City 1:|San Bartolome > > > > > 5 min > > > Locations & Distances|Cities|City 1:|5 > > > > > 9 km > > > Locations & Distances|Cities|City 2:|9 > > > > > Arrecife > > > Locations & Distances|Cities|City 2:|Arrecife > > > > > > > > > > > > > > > > > > > > > > This image shows a white facade at the entrance of the hotel, with balconies. > > facade.jpg > > > > > > > > This image shows a cathedral gothic style cathedral outside of the hotel. > > Cathedral.jpg > > > Cathedral.jpg > > > > > > > > >
> C/. saten 8 > San Bartolome > 35562 > ES > Lanzarote > Spain >
>
> > > > > fake_int@axisdata.net > > > www.fakeweb.com > >
> > MTS Globe Spain -Lanzarote > >
>
>
>
> ``` > > ```json expandable theme={null} > { > "OTA_HotelDescriptiveInfoRS": { > "Success": {}, > "HotelDescriptiveContents": { > "HotelDescriptiveContent": [ > { > "HotelInfo": { > "CategoryCodes": { > "HotelCategory": [ > { > "Code": "62", > "CodeDetail": "Other" > } > ], > "GuestRoomInfo": [ > { > "DescriptiveText": " 2 ConnectingRooms Room (MountainView)", > "Code": "42", > "CodeDetail": "RM00CRMV00" > }, > { > "DescriptiveText": " 2 Queen Beds Room (Terrace)", > "Code": "42", > "CodeDetail": "RM00Q200T0" > }, > { > "DescriptiveText": " Classic Room (Patio View)", > "Code": "42", > "CodeDetail": "RMCS00PT00" > }, > { > "DescriptiveText": " Comfort Room (Garden-Pool View)", > "Code": "42", > "CodeDetail": "RMCF00GP00" > }, > { > "DescriptiveText": " Deluxe Room (Panoramic)", > "Code": "42", > "CodeDetail": "RMDL0000P3" > }, > { > "DescriptiveText": " Deluxe Superior Room (Terrace)", > "Code": "42", > "CodeDetail": "RMDS0000T0" > }, > { > "DescriptiveText": " 1 Double Bed Superior Room (Non-Refundable)", > "Code": "42", > "CodeDetail": "RMSPD1000N" > } > ] > }, > "Descriptions": { > "DescriptiveText": "\nObject Information\nNestled just steps away from the shimmering coastline, Hotel Overlook is a timeless retreat that blends historic charm with modern comfort. Located on the second line of the beach, this iconic property has been welcoming guests for decades, offering a serene escape from the bustle of the waterfront while keeping the sea breeze within reach.\nWith its classic architecture, elegant interiors, and a story that spans generations, Overlook invites you to experience the essence of coastal heritage. Guests can enjoy panoramic views from sunlit terraces, savor local cuisine in the vintage-style dining room, and unwind in lush gardens that whisper tales of the past.\nPerfect for those seeking tranquility without sacrificing proximity to the beach, Hotel Overlook is more than a stay—it’s a piece of history waiting to be discovered.\n\n" > }, > "Position": { > "Latitude": "39.63897", > "Longitude": "3.41551" > }, > "Services": { > "Service": [ > { > "DescriptiveText": "All Inclusive", > "ID": "AI", > "CodeDetail": "Board" > }, > { > "DescriptiveText": "Breakfast", > "ID": "BB", > "CodeDetail": "Board" > }, > { > "DescriptiveText": "Fullboard", > "ID": "FB", > "CodeDetail": "Board" > }, > { > "DescriptiveText": "Half Board", > "ID": "HB", > "CodeDetail": "Board" > }, > { > "DescriptiveText": "Bathing Facilities|Beach|Blue Flag|", > "CodeDetail": "BATH|BEACH|BF_BLUEFLAG|" > }, > { > "DescriptiveText": "Bathing Facilities|Beach|Public Beach|", > "CodeDetail": "BATH|BEACH|BF_PUBLICBEACH|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|24 hour service|", > "CodeDetail": "BOARD|AIU|BM_AIU_24H|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|A la carte Restaurant|", > "CodeDetail": "BOARD|AIU|BM_AIU_ALCR|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Sport Activities|", > "CodeDetail": "BOARD|AIU|BM_AIU_AV|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Water activities|", > "CodeDetail": "BOARD|AIU|BM_AIU_AV2|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Includes Breakfast|", > "CodeDetail": "BOARD|AIU|BM_AIU_BB|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Local Spirits|", > "CodeDetail": "BOARD|AIU|BM_AIU_BNA|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Mineral Water|", > "CodeDetail": "BOARD|AIU|BM_AIU_B_MW|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Softdrinks|", > "CodeDetail": "BOARD|AIU|BM_AIU_B_SD|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Child menu|", > "CodeDetail": "BOARD|AIU|BM_AIU_CHM|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Cocktails|", > "CodeDetail": "BOARD|AIU|BM_AIU_CT|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Includes Dinner|", > "CodeDetail": "BOARD|AIU|BM_AIU_D|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Free Wi-Fi|", > "CodeDetail": "BOARD|AIU|BM_AIU_FI|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Free Mini-Bar|", > "CodeDetail": "BOARD|AIU|BM_AIU_FMB|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Free Safe-Deposit|", > "CodeDetail": "BOARD|AIU|BM_AIU_FSD|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Beer|", > "CodeDetail": "BOARD|AIU|BM_AIU_F_BEER|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Cake & Pastries|", > "CodeDetail": "BOARD|AIU|BM_AIU_F_C_P|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Coffee & Tea|", > "CodeDetail": "BOARD|AIU|BM_AIU_F_C_T|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Midnight Snacks|", > "CodeDetail": "BOARD|AIU|BM_AIU_F_M_S|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Snacks|", > "CodeDetail": "BOARD|AIU|BM_AIU_F_SNACK|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Wine|", > "CodeDetail": "BOARD|AIU|BM_AIU_F_WINE|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Imported Spirits|", > "CodeDetail": "BOARD|AIU|BM_AIU_IA|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Includes Lunch|", > "CodeDetail": "BOARD|AIU|BM_AIU_L|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Late Breakfast|", > "CodeDetail": "BOARD|AIU|BM_AIU_LBB|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Premium Spirits|", > "CodeDetail": "BOARD|AIU|BM_AIU_PS|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Upgrade Room|", > "CodeDetail": "BOARD|AIU|BM_AIU_UR|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive Ultra|Welcome Drink|", > "CodeDetail": "BOARD|AIU|BM_AIU_WD|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Includes Breakfast|", > "CodeDetail": "BOARD|AI|BM_AI_BB|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Mineral Water|", > "CodeDetail": "BOARD|AI|BM_AI_B_MW|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Softdrinks|", > "CodeDetail": "BOARD|AI|BM_AI_B_SD|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Child Menu|", > "CodeDetail": "BOARD|AI|BM_AI_CHM|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Free Wi-Fi|", > "CodeDetail": "BOARD|AI|BM_AI_FI|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Beer|", > "CodeDetail": "BOARD|AI|BM_AI_F_BEER|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Cake & Pastries|", > "CodeDetail": "BOARD|AI|BM_AI_F_C_P|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Coffee & Tea|", > "CodeDetail": "BOARD|AI|BM_AI_F_C_T|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Late Breakfast|", > "CodeDetail": "BOARD|AI|BM_AI_F_LBB|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Midnight Snacks|", > "CodeDetail": "BOARD|AI|BM_AI_F_M_S|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Snacks|", > "CodeDetail": "BOARD|AI|BM_AI_F_SNACK|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Wine|", > "CodeDetail": "BOARD|AI|BM_AI_F_WINE|" > }, > { > "DescriptiveText": "Boarding & Mealplan|All-Inclusive|Includes Lunch|", > "CodeDetail": "BOARD|AI|BM_AI_L|" > }, > { > "DescriptiveText": "Hotel Facilities|Guest Amenities|Currency Exchange|", > "CodeDetail": "H_FACILITY|AMENITY|GA_EXCHANGE|" > }, > { > "DescriptiveText": "Hotel Facilities|Guest Amenities|Wi-Fi|", > "CodeDetail": "H_FACILITY|AMENITY|GA_INTERNET|" > }, > { > "DescriptiveText": "Hotel Facilities|Guest Amenities|Room Service|", > "CodeDetail": "H_FACILITY|AMENITY|GA_ROOM_SERVICE|" > }, > { > "DescriptiveText": "Hotel Facilities|Guest Amenities|Luggage Storage|", > "CodeDetail": "H_FACILITY|AMENITY|GA_STORAGE|" > }, > { > "DescriptiveText": "Hotel Facilities|General Facilties|Casino|", > "CodeDetail": "H_FACILITY|FACILITY|GF_CASINO|" > }, > { > "DescriptiveText": "Hotel Facilities|Parking Facilities|Garage|", > "CodeDetail": "H_FACILITY|PARKING|GF_GARAGE|" > }, > { > "DescriptiveText": "Hotel Facilities|General Facilties|Lobby|", > "CodeDetail": "H_FACILITY|FACILITY|GF_LOBBY|" > }, > { > "DescriptiveText": "Hotel Facilities|General Facilties|Lounge|", > "CodeDetail": "H_FACILITY|FACILITY|GF_LOUNGE|" > }, > { > "DescriptiveText": "Hotel Facilities|General Facilties|Reception|", > "CodeDetail": "H_FACILITY|FACILITY|GF_RECEPTION|" > }, > { > "DescriptiveText": "Hotel Facilities|General Facilties|Shops|", > "CodeDetail": "H_FACILITY|FACILITY|GF_SHOPS|" > }, > { > "DescriptiveText": "Themes|Hotel Type|Historic Hotel|", > "CodeDetail": "THEMES|HOTELTYPE|HISTORIC_HOTEL|" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "1 km", > "CodeDetail": "Distance:" > } > ] > }, > "DescriptiveText": "Locations & Distances|Recreation Area|Beach|1", > "CodeDetail": "LOCATION|RECREATION|LD_BEACH|DISTANCE" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "Pinos", > "CodeDetail": "Name:" > } > ] > }, > "DescriptiveText": "Locations & Distances|Recreation Area|Beach|Pinos", > "CodeDetail": "LOCATION|RECREATION|LD_BEACH|NAME" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "500 m", > "CodeDetail": "Distance:" > } > ] > }, > "DescriptiveText": "Locations & Distances|Public Transport|Public Bus Stop|500", > "CodeDetail": "LOCATION|PUBLICTRAN|LD_BUSSTOP|DISTANCE" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "1 km", > "CodeDetail": "Distance:" > } > ] > }, > "DescriptiveText": "Locations & Distances|Sport Locations|Golf Course|1", > "CodeDetail": "LOCATION|SPORTLOC|LD_GOLF|DISTANCE" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "700 m", > "CodeDetail": "Distance:" > } > ] > }, > "DescriptiveText": "Locations & Distances|Other Locations|Supermarket|700", > "CodeDetail": "LOCATION|OTHERLOC|LD_MARKET|DISTANCE" > }, > { > "DescriptiveText": "Themes|Target Group|Adults Recommmended|", > "CodeDetail": "THEMES|TARGETGRP|OI_ADULTSRECC|" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "English, German, French, Spanish", > "CodeDetail": "Languages:" > } > ] > }, > "DescriptiveText": "Object Information|Reception|Languages Spoken|English, German, French, Spanish", > "CodeDetail": "OBJECT|RECEPTION|OI_LANGUAGES|LANGUAGES" > }, > { > "DescriptiveText": "Object Information|Reception|Reception|", > "CodeDetail": "OBJECT|RECEPTION|OI_RECEPTION|" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "Yes", > "CodeDetail": "Property:" > } > ] > }, > "DescriptiveText": "Object Information|Policies|Smoking Allowed:|Yes", > "CodeDetail": "OBJECT|POLICIES|OI_SMOKING|SMOKING" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "Balcony/Terrace only", > "CodeDetail": "Rooms:" > } > ] > }, > "DescriptiveText": "Object Information|Policies|Smoking Allowed:|Balcony/Terrace only", > "CodeDetail": "OBJECT|POLICIES|OI_SMOKING|SMOKINGROOM" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "victorian", > "CodeDetail": "Architectural Style:" > } > ] > }, > "DescriptiveText": "Object Information|Property|Architectural Style:|victorian", > "CodeDetail": "OBJECT|PROPERTY|PI_ARCHITECTURE|ARCHITECTURE" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "4 sq km", > "CodeDetail": "Measurements:" > } > ] > }, > "DescriptiveText": "Object Information|Property|Garden|4", > "CodeDetail": "OBJECT|PROPERTY|PI_GARDEN|MEASUREMENTS" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "400 sq m", > "CodeDetail": "Measurements:" > } > ] > }, > "DescriptiveText": "Object Information|Property|Roof Top Terrace|400", > "CodeDetail": "OBJECT|PROPERTY|PI_ROOF_TOP_TERRACE|MEASUREMENTS" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "1749", > "CodeDetail": "Year:" > } > ] > }, > "DescriptiveText": "Object Information|Property|Construction Year:|1749", > "CodeDetail": "OBJECT|PROPERTY|PI_YEAR_CONSTRUCTION|YEAR" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "Rooms", > "CodeDetail": "Renovation Type:" > } > ] > }, > "DescriptiveText": "Object Information|Property|Last Renovation:|Rooms", > "CodeDetail": "OBJECT|PROPERTY|PI_YEAR_RENOVATION|RENOV_TYPE" > }, > { > "Features": { > "Feature": [ > { > "DescriptiveText": "2019", > "CodeDetail": "Year:" > } > ] > }, > "DescriptiveText": "Object Information|Property|Last Renovation:|2019", > "CodeDetail": "OBJECT|PROPERTY|PI_YEAR_RENOVATION|YEAR" > }, > { > "DescriptiveText": "Wellness & Health|Health|Massage|", > "CodeDetail": "WELLNESS|HEALTH|WS_MASSAGE|" > } > ] > } > }, > "AreaInfo": { > "RefPoints": { > "RefPoint": [ > { > "Name": "Spain", > "RefPointName": "Country" > }, > { > "Name": "Costa de los Pinos", > "RefPointName": "Resort" > }, > { > "Name": "Mallorca", > "RefPointName": "Region" > }, > { > "Name": "ES", > "RefPointName": "CountryCode" > } > ] > } > }, > "AffiliationInfo": { > "Awards": { > "Award": [ > { > "Rating": "4 Stars" > } > ] > } > }, > "MultimediaDescriptions": { > "MultimediaDescription": [ > { > "ImageItems": { > "ImageItem": [ > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208852.jpg", > "UnitOfMeasureCode": "9", > "Width": 3024, > "Height": 2016, > "Format": "0", > "FileName": "aespmi5l46_208852_1.jpg", > "DimensionCategory": "original", > "Sort": 1, > "Title": "Reception", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208852.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208852_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 1, > "Title": "Reception", > "RecordID": "2" > } > ], > "Category": "RECEPTION", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208854.jpg", > "UnitOfMeasureCode": "9", > "Width": 3000, > "Height": 2000, > "Format": "0", > "FileName": "aespmi5l46_208854_1.jpg", > "DimensionCategory": "original", > "Sort": 2, > "Title": "Reception", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208854.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208854_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 2, > "Title": "Reception", > "RecordID": "2" > } > ], > "Category": "ROOM", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208858.jpg", > "UnitOfMeasureCode": "9", > "Width": 5000, > "Height": 3333, > "Format": "0", > "FileName": "aespmi5l46_208858_1.jpg", > "DimensionCategory": "original", > "Sort": 3, > "Title": "Spa and wellness", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208858.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208858_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 3, > "Title": "Spa and wellness", > "RecordID": "2" > } > ], > "Category": "SPA", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208860.jpg", > "UnitOfMeasureCode": "9", > "Width": 4500, > "Height": 3000, > "Format": "0", > "FileName": "aespmi5l46_208860_1.jpg", > "DimensionCategory": "original", > "Sort": 4, > "Title": "Bar", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208860.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208860_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 4, > "Title": "Bar", > "RecordID": "2" > } > ], > "Category": "BAR", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208862.jpg", > "UnitOfMeasureCode": "9", > "Width": 3008, > "Height": 2000, > "Format": "0", > "FileName": "aespmi5l46_208862_1.jpg", > "DimensionCategory": "original", > "Sort": 5, > "Title": "Pool", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208862.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208862_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 5, > "Title": "Pool", > "RecordID": "2" > } > ], > "Category": "POOL", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208864.jpg", > "UnitOfMeasureCode": "9", > "Width": 1920, > "Height": 1280, > "Format": "0", > "FileName": "aespmi5l46_208864_1.jpg", > "DimensionCategory": "original", > "Sort": 6, > "Title": "Lobby", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208864.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208864_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 6, > "Title": "Lobby", > "RecordID": "2" > } > ], > "Category": "LOBBY", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208866.jpg", > "UnitOfMeasureCode": "9", > "Width": 4095, > "Height": 2730, > "Format": "0", > "FileName": "aespmi5l46_208866_1.jpg", > "DimensionCategory": "original", > "Sort": 7, > "Title": "Lobby", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208866.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208866_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 7, > "Title": "Lobby", > "RecordID": "2" > } > ], > "Category": "LOBBY", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208868.jpg", > "UnitOfMeasureCode": "9", > "Width": 3000, > "Height": 2000, > "Format": "0", > "FileName": "aespmi5l46_208868_1.jpg", > "DimensionCategory": "original", > "Sort": 8, > "Title": "Room", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208868.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208868_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 8, > "Title": "Room", > "RecordID": "2" > } > ], > "Category": "ROOM", > "LastModifyDateTime": "2026-05-26T11:20:14" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208870.jpg", > "UnitOfMeasureCode": "9", > "Width": 4000, > "Height": 2667, > "Format": "0", > "FileName": "aespmi5l46_208870_1.jpg", > "DimensionCategory": "original", > "Sort": 9, > "Title": "Room", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208870.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208870_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 9, > "Title": "Room", > "RecordID": "2" > } > ], > "Category": "ROOM", > "LastModifyDateTime": "2026-05-26T11:20:15" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208872.jpg", > "UnitOfMeasureCode": "9", > "Width": 4000, > "Height": 2666, > "Format": "0", > "FileName": "aespmi5l46_208872_1.jpg", > "DimensionCategory": "original", > "Sort": 10, > "Title": "Room", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208872.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208872_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 10, > "Title": "Room", > "RecordID": "2" > } > ], > "Category": "ROOM", > "LastModifyDateTime": "2026-05-26T11:20:15" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208874.jpg", > "UnitOfMeasureCode": "9", > "Width": 4000, > "Height": 2667, > "Format": "0", > "FileName": "aespmi5l46_208874_1.jpg", > "DimensionCategory": "original", > "Sort": 11, > "Title": "Room", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208874.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208874_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 11, > "Title": "Room", > "RecordID": "2" > } > ], > "Category": "ROOM", > "LastModifyDateTime": "2026-05-26T11:20:15" > }, > { > "ImageFormat": [ > { > "URL": "AESPMI5L46_208876.jpg", > "UnitOfMeasureCode": "9", > "Width": 4500, > "Height": 3000, > "Format": "0", > "FileName": "aespmi5l46_208876_1.jpg", > "DimensionCategory": "original", > "Sort": 12, > "Title": "Restaurant", > "RecordID": "1" > }, > { > "URL": "AESPMI5L46_208876.jpg", > "UnitOfMeasureCode": "9", > "Width": 200, > "Height": 133, > "Format": "0", > "FileName": "aespmi5l46_208876_2.jpg", > "DimensionCategory": "thumbnail", > "Sort": 12, > "Title": "Restaurant", > "RecordID": "2" > } > ], > "Category": "RESTAURANT", > "LastModifyDateTime": "2026-05-26T11:20:15" > } > ] > } > } > ] > }, > "ContactInfos": { > "ContactInfo": [ > { > "Addresses": { > "Address": [ > { > "AddressLine": [ > "Paseo Pinos del Mar, 45" > ], > "CityName": "Son Servera", > "PostalCode": "07560", > "Country": "ES", > "StateProv": { > "value": "Baleares" > }, > "CountryName": { > "value": "Spain" > } > } > ] > }, > "Location": "6" > }, > { > "CompanyName": { > "value": "MTS Globe Spain - Palma De Mallorca", > "Code": "PMI" > }, > "Location": "7" > } > ] > }, > "LanguageCode": "EN", > "RPH": "1", > "LastModifiedDate": "2026-09-17T14:20:39", > "HotelCode": "AESPMI5L46", > "HotelName": "Hotel Overlook", > "HotelCodeContext": "789101112" > } > ] > }, > "Version": 2009.1, > "TransactionIdentifier": "1-1/1" > } > } > ``` ## Best Practices 1. Use a two-step flow: **Hotel List** (minimal) → **Hotel Details** (per property, in needed languages). 2. Prefer `LastUpdateDate` deltas daily; subtract \~3 hours as a safety margin for time-zone skew. 3. When downloading media, sort and present by `ImageFormat@Sort`; issue HTTP `HEAD` to compare `Last-Modified` before downloading. 4. Persist images and static data; do not hotlink image URLs at runtime. 5. DRV and GIATA/TTI codes are license‑bound; enable per partner before relying on those fields. # OTA_HotelAvailRQ Source: https://docs.axisdata.net/hotel/searchRQ The OTA\_HotelAvailRQ (Hotel Availability Request) is an XML message used in the hospitality industry to request hotel availability information. It is part of the OpenTravel Alliance (OTA) specification, which provides standardized messaging formats for travel-related transactions. > [!TIP] > > Already know OTA messages? Jump straight into testing. > [card] [OTA\_HotelAvailRQ API call](/api-reference/endpoint/hotel/availability) > > Skip & Hit the Playground. ## Purpose This message is used to: * Search for available hotel rooms based on specific criteria. * Request rate information for available accommodations. * Query inventory across multiple properties or a single hotel. * Filter results based on guest requirements and preferences. ## Structure - Root Element ```xml theme={null} ``` ```json theme={null} "OTA_HotelAvailRQ" ``` **Key Attributes:** * `Version`: Specification version (e.g., "1.0") * `EchoToken`: Unique identifier for tracking request/response pairs * `PrimaryLangID`: Primary language code (ISO 639) * `xmlns`: "[http://www.opentravel.org/OTA/2003/05](http://www.opentravel.org/OTA/2003/05)" * MaxResponses: Limits number of bookable options returned. Default is 1500. ## Structure - Core Elements ### POS (Point of Sale) Identifies the requesting party and contains credentials. Check [Access to our Systems](../authentication/access#partner-identification) ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "Instance": "MF002", "ID_Context": "AxisData", "ID": "TEST", "Type": "22" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` The `Instance` attribute value in the `RequestorID` node filters the search results: **Basic Filters** | Switch | Behavior | | :- | :- | | `MF0x2` | Returns only the **cheapest room/board/rateplan** per hotel | | `MF0x1` | Returns cheapest **contract** option | | `MF0x3` | Returns **4 refund types**: fully refundable, non-refundable, semi-flexible, flexible | | `MF0x4` | Returns **2 refund types**: fully refundable + cheapest of the other three | | `MF0xx` | Returns **all available combinations** (e.g., MF005) | **Other Filters** `MF2xx` – Flexible Date Search: * Search over a period (e.g., 3 months) for a fixed stay duration. * Use `Duration="P7D"` and `StartDateWindow DOW="x"` to restrict arrival days. `MF1xx` – Calendar View: * Returns cheapest price per arrival date for a hotel. * Can be restricted by DOW (e.g., only Fridays → DOW = 16). ### AvailRequestSegments Container for one or more availability request segments. ```xml theme={null} ``` ```json theme={null} { "AvailRequestSegment": [ { "InfoSource": "12", "StayDateRange": { "End": "2027-07-24", "Start": "2027-07-17" }, "RoomStayCandidates": { "RoomStayCandidate": [ { "GuestCounts": { "GuestCount": [ { "Age": 30, "Count": 2, "AgeQualifyingCode": 10 } ] } } ] }, "HotelSearchCriteria": { "Criterion": [ { "ExactMatch": true, "HotelRef": [ { "HotelCode": "AESPMI5L46" } ] } ] } } ] } ``` #### InfoSource Attribute Controls the enrichment of the response. | Value | Enrichment Type | | :- | :- | | `0` | No enrichment | | `1` | HotelStays only | | `2` | Areas only | | `3` | Amenities only | | `4` | RoomDescription only | | `5` | BoardDescription only | | `1234` | Full enrichment (default) | #### StayDateRange Element * `Start`: Check-in date (YYYY-MM-DD) * `End`: Check-out date (YYYY-MM-DD) * `Duration`: Used in flexible searches and calendar view (e.g., "P3N" for 3 nights) * `StayDateRange/StartDateWindow` -> `DOW`: Restrict arrival days (e.g "Mon") #### RoomStayCandidate Element Defines Guest requirements into the `GuestCount` element, following these rules: * **Adults**: `AgeQualifyingCode="10"` * **Children**: `AgeQualifyingCode="8"` (must specify age) * **Infants**: `AgeQualifyingCode="7"` (must specify age) * **Conversion Logic**: * Children exceeding max age → treated as adults * Infants exceeding min child age → treated as children * Same logic applies in both search and booking requests #### Criterion Element It can be used to receive results by areas or per hotel exact matching. **Area Search** ```xml theme={null} Spain Mallorca ``` ```json theme={null} { "Criterion": { "RefPoint": [ { "CodeContext": "Country", "value": "Spain" }, { "CodeContext": "Region", "value": "Mallorca" } ] } } ``` Country and Region need to be included. Multiple resorts can be included in one request. You can receive a full list of Areas with OTA\_HotelAvailRQ, see [Complete examples](#complete-examples) "Area List". **Hotel Search** ```xml theme={null} ``` ```json theme={null} { "Criterion": { "ExactMatch": true, "HotelRef": [ { "HotelCode": "AESPMI5L46" } ] } } ``` > [!WARNING] > > The maximum numbers of hotels searched via Hotel List search is 99 ## Additional Features ### Multi-Room Logic * Up to **5 rooms** per request * Each room candidate is matched to available rooms * Remaining units tracked via `NumberOfUnits` * Combinations must be validated client-side based on availability * If no suitable room is found for a candidate, a warning is returned ### Search by Hotel Name * Minimum 3 characters required * Returns hotels with matching names ### Upfront Filtering * Filters can be applied before search: * Board type (`MealPlanCodes`) * Room type (`RoomClassificationCode`) * Star rating (`Award Rating`) * Specific room code (`RoomType`) ## Complete Examples > [tab] Location > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > Spain > Mallorca > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF002", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "HotelSearchCriteria" : { > "Criterion" : [ { > "RefPoint" : [ { > "value" : "Spain", > "CodeContext" : "Country" > }, { > "value" : "Mallorca", > "CodeContext" : "Region" > } ] > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Count" : 2 > } ] > } > } ] > }, > "InfoSource" : "12" > } ] > }, > "EchoToken" : "1", > "Version" : 2016.2, > "MaxResponses" : 200 > } > } > ``` > [tab] Hotel > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF005", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AESPMI5L46" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Age" : 30, > "Count" : 2 > } ] > } > } ] > }, > "InfoSource" : "12" > } ] > }, > "Version" : 2016.2, > "MaxResponses" : 200 > } > } > ``` > [tab] Hotel List > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF005", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AESPMI5L46" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Age" : 30, > "Count" : 2 > } ] > } > } ] > }, > "InfoSource" : "12" > }, { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AESPMI1234" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Age" : 30, > "Count" : 2 > } ] > } > } ] > }, > "InfoSource" : "12" > }, { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AESPMI5678" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Age" : 30, > "Count" : 2 > } ] > } > } ] > }, > "InfoSource" : "12" > } ] > }, > "Version" : 2016.2, > "MaxResponses" : 200 > } > } > ``` > [tab] Efficient List > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF002", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AMTSTR1UQ4" > }, { > "HotelCode" : "AMTSTR139E" > }, { > "HotelCode" : "AMTSTR13D0" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Age" : 30, > "Count" : 2 > } ] > } > } ] > }, > "InfoSource" : "12" > } ] > }, > "Version" : 2016.2, > "MaxResponses" : 200 > } > } > ``` > [tab] Multiroom > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF002", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AESPMI5L46" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "Start" : "2027-07-17", > "End" : "2027-07-24" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Count" : 1 > } ] > }, > "RPH" : "111", > "Quantity" : 1 > }, { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Count" : 2 > } ] > }, > "RPH" : "222", > "Quantity" : 1 > } ] > }, > "InfoSource" : "0" > } ] > }, > "Version" : 2016.2, > "MaxResponses" : 200 > } > } > ``` > [tab] CalendarView > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF102", > "ID" : "TEST ", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "HotelSearchCriteria" : { > "Criterion" : [ { > "HotelRef" : [ { > "HotelCode" : "AESPMI5L46" > } ], > "ExactMatch" : true > } ] > }, > "StayDateRange" : { > "StartDateWindow" : { > "DOW" : "Mon" > }, > "Start" : "2027-07-01", > "Duration" : "P7D", > "End" : "2027-07-31" > }, > "RoomStayCandidates" : { > "RoomStayCandidate" : [ { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "10", > "Count" : 2 > } ] > }, > "RPH" : "1" > }, { > "GuestCounts" : { > "GuestCount" : [ { > "AgeQualifyingCode" : "8", > "Count" : 1 > } ] > }, > "RPH" : "2" > } ] > }, > "InfoSource" : "0" > } ] > }, > "Version" : 2016.2, > "MaxResponses" : 200 > } > } > ``` > [tab] Areas > > ```xml expandable theme={null} > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF005", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "AvailRequestSegments" : { > "AvailRequestSegment" : [ { > "ResponseType" : "AreaList" > } ] > }, > "Version" : 2016.2 > } > } > ``` ## Common Use Cases * **Destination Search Request**: Searches hotels based on geographical definitions like country and region. * **Hotel Search Request**: Queries availability for a specific hotel using its unique code. * **Hotel List Request**: Searches availability for a list of hotels, often used in mapped or curated portfolios. * **Efficient Hotel List Request**: Optimized version of hotel list search for performance and reduced data volume. * **Multi-Room Search Request**: Allows querying availability for multiple rooms in a single request, with occupancy and quantity details. * **Calendar View Request**: Returns the cheapest price per arrival date for a given hotel or destination over a time range and a defined length of stay. * **Area List Request**: Retrieves available geographical areas based on the distributor's portfolio. ## Best Practices 1. **Always include EchoToken** - Essential for matching requests with responses. 2. **Specify TimeStamp** - Helps with debugging and tracking. 3. **Use ISO date formats** - YYYY-MM-DD for dates. 4. **Include guest counts** - Ensures accurate availability and pricing. 5. **Validate hotel codes** - Confirm codes before sending requests. 6. **Handle multiple rooms** - Use Quantity attribute when booking multiple rooms. 7. **Time Zones**: Be aware that timestamps should include timezone information 8. **Error Handling**: Implement proper error handling for the response messages ## Playground > [card] [OTA\_HotelAvailRQ API call](/api-reference/endpoint/hotel/availability) > > Try our API playground in real time. > [!TIP] > > Use the desired request at the playground and receive responses from our test environment API! # OTA_HotelAvailRS Source: https://docs.axisdata.net/hotel/searchRS The OTA\_HotelAvailRS (Hotel Availability Response) returns bookable options and related context for one or more properties in reply to an `OTA_HotelAvailRQ`. It is compatible with enrichment switches and multi-room behavior defined for the availability workflow. ## Purpose * Confirm successful processing (``) or return error diagnostics (``). [Error Scenarios](../glossary/errors). * Deliver one or more `` items with pricing, guest counts, and property references. * Optionally include contextual blocks (`HotelStays`, `Areas`, amenities/descriptions) controlled by `InfoSource`. ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_HotelAvailRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2016.2", "EchoToken": "1", "Success": "", ... } } ``` > [!TIP] > > The EchoToken is useful to identify transactions. **Success** Indicates the request was processed without fatal errors. When absent, see `Errors`. **Errors** Container for one or more `Error` items describing non-recoverable issues in the request. [Error Scenarios](../glossary/errors). **Warnings** Used for non-fatal guidance. Example: when a multi-room search cannot satisfy every candidate, a warning like `Code="14"` with text `Not all rooms in the request do have a suitable candidate` may be present. ## Structure - Core Elements ### HotelStays Portfolio-level hotel facts that can accompany availability (e.g., `BasicPropertyInfo` with `HotelCode`, `HotelName`, `AreaID`, optional `VendorMessages`, `Award`). **Example** ```xml theme={null} ``` ```json theme={null} { "HotelStays": { "HotelStay": [ { "BasicPropertyInfo": { "HotelCode": "AESPMI5L46", "HotelName": "Caserio de Lanzarote", "HotelCodeContext": "11111", "AreaID": "1012SA", "Award": { "Rating": "2 Stars" } } } ] } } ``` > [!NOTE] > > HotelCodeContext returns the GIATA code if the client is licensed ### Areas Geographical labels corresponding to the `AreaID` linkage. **Example** ```xml theme={null} Spain ES ACE Canarian Islands Lanzarote San Bartolome 1012SA ACE ``` ```json theme={null} "Areas": { "Area": [ { "AreaID": "1012SA", "AreaDescription": [ { "Name": "Country", "Text": "Spain" }, { "Name": "CountryCode", "Text": "ES" }, { "Name": "TravelDestination", "Text": "ACE" }, { "Name": "Destination", "Text": "Canarian Islands" }, { "Name": "Region", "Text": "Lanzarote" }, { "Name": "Resort", "Text": "San Bartolome" }, { "Name": "ResortCode", "Text": "1012SA" }, { "Name": "Airport", "Text": "ACE" } ] } ] } ``` ### RoomStays Each `RoomStay` conveys a bookable option (room/board/rateplan) for a given hotel. * `RoomStay@RoomStayCandidateRPH` echoes the corresponding room candidate index from the request. * **Grouping Semantics** * **Standard searches:** multiple room/board combinations for the **same hotel** may share the same `RPH` for grouping purposes. * **Multi-room mode**: each `RoomStay` carries a **unique** `RPH` (one per returned option) to help client-side combination logic. ```xml theme={null} ``` ```json theme={null} { "RoomStay": { "RoomStayCandidateRPH": "0", "RPH": "0", "ResponseType": "PropertyList" } } ``` #### RoomType Specifies the room code of the returned product. ```xml theme={null} ``` ```json theme={null} { "RoomTypes": { "RoomType": [ { "RoomTypeCode": "RM00CRMV00" } ] } } ``` The room codes breakdown can be found at [Mapping codes](../glossary/codes#hotel-room-codes-large) #### RatePlans It shows for which RatePlan the RoomStay corresponds. It needs to be used in the Booking request. More information at [RatePlans and Multicontracting](../general/rateplans_multicontracting). ```xml theme={null} ``` ```json theme={null} { "RatePlans": { "RatePlan": [ { "RatePlanCode": "-OWN2-BON00" } ] } } ``` > [!TIP] > > There is also the possibility to receive the codes concatenated at the Room code #### RoomRates * Pricing appears under `RoomRates/RoomRate/Rates/Rate` as `Base` and `Total` (amounts after tax, currency). * Availability for each option is indicated at `RoomRate@NumberOfUnits` (omitted when free sales apply). * The `ChargeType` code on `Rate` reflects the original contract rate basis (OTA CHG codelist): * `19` → Per Unit * `21` → Per Person * `Features/Feature/Description/Text` indicates the board for the returned rate. ```xml theme={null} BB ``` ```json theme={null} { "RoomRates": { "RoomRate": [ { "RoomTypeCode": "RM00CRMV00", "NumberOfUnits": "99", "RatePlanCode": "-OWN2-BON00", "Rates": { "Rate": [ { "ChargeType": "21", "Base": { "AmountAfterTax": "900.00", "CurrencyCode": "EUR" }, "Total": { "AmountAfterTax": "900.00", "CurrencyCode": "EUR" } } ] }, "Features": { "Feature": [ { "Description": { "Text": "BB" } } ] } } ] } } ``` #### GuestCounts Shows the pax count for the returned product: * AgeQualifyingCode values: * 10: Adult * 8: Child * 7: Infant ```xml theme={null} ``` ```json theme={null} { "GuestCounts": { "GuestCount": [ { "AgeQualifyingCode": "10", "Age": "30", "Count": "2" } ] } } ``` #### TimeSpan Indicates the dates for which the service is available. ```xml theme={null} ``` ```json theme={null} { "TimeSpan": { "Start": "2027-07-17", "End": "2027-07-24" } } ``` #### BasicPropertyInfo Shows the hotel code for the returned room stay. Vendor Messages can also be displayed at this section. Check [Vendor Messages](../general/messaging#vendor-messages) ```xml theme={null} Free Stay Offers 100 ``` ```json theme={null} { "BasicPropertyInfo": { "HotelCode": "AESPMI5L46", "VendorMessages": { "VendorMessage": [ { "Title": "Free Stay Offers", "InfoType": "3", "SubSection": [ { "SubTitle": "100", "SubCode": "Value", "Paragraph": { "Text": "Free Stay Offers 100" } }, { "SubTitle": "FSO", "SubCode": "OTS" } ] }, { "Title": "FreeCancellationConditions", "InfoType": "2", "SubSection": [ { "SubTitle": "FCP-RATE", "SubCode": "DRV" }, { "SubTitle": "FCP-P7D", "SubCode": "DRV" } ] } ] } } } ``` ## Rules and Features ### Enrichment via `InfoSource` The response can be enriched beyond `RoomStays` depending on the `InfoSource` value used in the request: | Value | Meaning | | - | - | | (not set) | Full enrichment (equivalent to `1234`) | | `0` | No enrichment – only `RoomStays` are included | | `1` | Include `HotelStays` only | | `2` | Include `Areas` only | | `3` | Include room `Amenities` only | | `4` | Include `RoomDescription` only | | `5` | Include `BoardDescription` only | > Combination is supported (e.g., `InfoSource="12"` returns `HotelStays` + `Areas`). ### Multi-Room Specifics * Up to **5** room candidates per request are supported. * Response returns one `RoomStay` per option that fits each candidate; combine client‑side using `RoomStayCandidateRPH`, `RPH`, and `NumberOfUnits`. * If one or more candidates cannot be satisfied, a warning is returned. ### Recommended Retail price As a distributor, there is an **optional** setup that can be activated so that the Hotel avail response returns the recommended retail price from the hotelier. In this case two rates will be received, our own selling price, and also the **the minimal price** for which this hotel can be sold to end-customers. The Rate node containing the attribute `RateMode = "1"` defines the minimal price to sell to an end-customer. See below example: ```xml theme={null} RO ``` ```json theme={null} { "RoomRates": { "RoomRate": [ { "RoomTypeCode": "RMSDDB00A0;FP000", "NumberOfUnits": "14", "Rates": { "Rate": [ { "ChargeType": "21", "Base": { "AmountAfterTax": "510.16", "CurrencyCode": "EUR" }, "Total": { "AmountAfterTax": "510.16", "CurrencyCode": "EUR" } }, { "ChargeType": "21", "RateMode": "1", "Base": { "AmountAfterTax": "520", "CurrencyCode": "EUR" }, "Total": { "AmountAfterTax": "520", "CurrencyCode": "EUR" } } ] }, ... } ] } } ``` > [!WARNING] > > Even when this feature is active for a distributor, not all portfolio would contain the RRP node, not all hotels would return this. ### Offer Tags As a distributor, there is an **optional** setup to receive Offer Tags. For more info please check [General Messaging](../general/messaging#offer-tags-and-extras) ## Complete Examples > [tab] Basic > > ```xml expandable theme={null} > > > > > > > > > > > AESPMI5L4M_208932.jpg > > > > > > > > > > > > > > AESPMI5L4K_208904.jpg > > > > > > > > > > > > > > AESPMI5L46_208852.jpg > > > > > > > > > > > Adults Only > > > > > > > > > AESPMI5L64_208436.jpg > > > > > > > > > > > > > > AESPMI5L3Q_208828.jpg > > > > > > > > > > > > > > AESPMI5L4A_208878.jpg > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > Early Booking Offers 5% > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > RO > > > > > > > > > > > > > > > Free Stay Offers 100 > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > RO > > > > > > > > > > > > > > > Free Stay Offers 100 > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > Rolling EarlyBooking Offers 5% > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > Minimum Stay Offers 5% > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > Rolling EarlyBooking Offers 5% > > > > > > > > > > > > > > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Arenal > > > 0895AR > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Can Picafort > > > 0914CA > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Playa de Palma > > > 0930PL > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Cala Romántica > > > 1456CA > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Puigpunyent > > > 4726PU > > > PMI > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Petra > > > 5116PE > > > > > Spain > > > ES > > > PMI > > > Balearic Islands > > > Mallorca > > > Costa de los Pinos > > > 7308CO > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRS": { > "Success": {}, > "HotelStays": { > "HotelStay": [ > { > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Image": [ > "AESPMI5L4M_208932.jpg" > ] > } > ] > } > ], > "Title": "Images" > } > ] > }, > "Award": [ > { > "Rating": "4 Stars" > } > ], > "HotelCode": "AESPMI5L4M", > "HotelName": "Bungalow for Life", > "HotelCodeContext": "456789123", > "AreaID": "5116PE" > } > }, > { > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Image": [ > "AESPMI5L4K_208904.jpg" > ] > } > ] > } > ], > "Title": "Images" > } > ] > }, > "Award": [ > { > "Rating": "2 Stars" > } > ], > "HotelCode": "AESPMI5L4K", > "HotelName": "Sleep Well Motel", > "HotelCodeContext": "987654321", > "AreaID": "0895AR" > } > }, > { > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Image": [ > "AESPMI5L46_208852.jpg" > ] > } > ] > } > ], > "Title": "Images" > } > ] > }, > "Award": [ > { > "Rating": "4 Stars" > } > ], > "HotelCode": "AESPMI5L46", > "HotelName": "Hotel Overlook", > "HotelCodeContext": "789101112", > "AreaID": "7308CO" > } > }, > { > "BasicPropertyInfo": { > "Award": [ > { > "Rating": "5 Stars" > } > ], > "Service": [ > { > "BusinessServiceCode": "Segmentation" > } > ], > "HotelCode": "AESPMI5L66", > "HotelName": "Hotel Tulipan", > "HotelCodeContext": "77788877", > "AreaID": "1456CA" > } > }, > { > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Image": [ > "AESPMI5L64_208436.jpg" > ] > } > ] > } > ], > "Title": "Images" > } > ] > }, > "Award": [ > { > "Rating": "4 Stars" > } > ], > "HotelCode": "AESPMI5L64", > "HotelName": "Heaven Place Resort", > "HotelCodeContext": "123456788", > "AreaID": "0930PL" > } > }, > { > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Image": [ > "AESPMI5L3Q_208828.jpg" > ] > } > ] > } > ], > "Title": "Images" > } > ] > }, > "Award": [ > { > "Rating": "5 Stars" > } > ], > "HotelCode": "AESPMI5L3Q", > "HotelName": "Tramuntana Tech Hotel", > "HotelCodeContext": "145748", > "AreaID": "4726PU" > } > }, > { > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Image": [ > "AESPMI5L4A_208878.jpg" > ] > } > ] > } > ], > "Title": "Images" > } > ] > }, > "Award": [ > { > "Rating": "4 Stars" > } > ], > "HotelCode": "AESPMI5L4A", > "HotelName": "The Tipton Hotel", > "HotelCodeContext": "123456789", > "AreaID": "0914CA" > } > } > ] > }, > "RoomStays": { > "RoomStay": [ > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RMCS00PT00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-BON00" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 406.98, > "AmountAfterTax": 406.98, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 406.98, > "AmountAfterTax": 406.98, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RMCS00PT00", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-BON00" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Early Booking Offers 5%" > } > ] > } > ], > "SubTitle": "5%", > "SubCode": "Value" > }, > { > "SubTitle": "EBO", > "SubCode": "OTS" > }, > { > "SubTitle": "EBO1", > "SubCode": "OTS" > } > ], > "Title": "Early Booking Offers", > "InfoType": "3" > }, > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCB-P0H", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L46" > }, > "RoomStayCandidateRPH": "0", > "RPH": "0", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RM00DB0000" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN1-00N00" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 428.40, > "AmountAfterTax": 428.40, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 428.40, > "AmountAfterTax": 428.40, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RM00DB0000", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN1-00N00" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCB-P0H", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L3Q" > }, > "RoomStayCandidateRPH": "0", > "RPH": "1", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RM00000000" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-S0000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 612.00, > "AmountAfterTax": 612.00, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 612.00, > "AmountAfterTax": 612.00, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "RO" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RM00000000", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-S0000" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Free Stay Offers 100" > } > ] > } > ], > "SubTitle": "100", > "SubCode": "Value" > }, > { > "SubTitle": "FSO", > "SubCode": "OTS" > }, > { > "SubTitle": "FSO1", > "SubCode": "OTS" > } > ], > "Title": "Free Stay Offers", > "InfoType": "3" > }, > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCP-P7D", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L4K" > }, > "RoomStayCandidateRPH": "0", > "RPH": "2", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "BU00T1000O" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-S0000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 734.40, > "AmountAfterTax": 734.40, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 734.40, > "AmountAfterTax": 734.40, > "CurrencyCode": "EUR" > }, > "ChargeType": "19" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "RO" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "BU00T1000O", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-S0000" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Free Stay Offers 100" > } > ] > } > ], > "SubTitle": "100", > "SubCode": "Value" > }, > { > "SubTitle": "FSO", > "SubCode": "OTS" > }, > { > "SubTitle": "FSO1", > "SubCode": "OTS" > } > ], > "Title": "Free Stay Offers", > "InfoType": "3" > }, > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCP-P7D", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L4M" > }, > "RoomStayCandidateRPH": "0", > "RPH": "3", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RMCS00PT00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-FP000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 949.62, > "AmountAfterTax": 949.62, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 949.62, > "AmountAfterTax": 949.62, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RMCS00PT00", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-FP000" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Rolling EarlyBooking Offers 5%" > } > ] > } > ], > "SubTitle": "5%", > "SubCode": "Value" > }, > { > "SubTitle": "EBR", > "SubCode": "OTS" > }, > { > "SubTitle": "EBR1", > "SubCode": "OTS" > } > ], > "Title": "Rolling EarlyBooking Offers", > "InfoType": "3" > }, > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCP-P7D", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L64" > }, > "RoomStayCandidateRPH": "0", > "RPH": "4", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "FSCL00GV00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-F0000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 1085.28, > "AmountAfterTax": 1085.28, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 1085.28, > "AmountAfterTax": 1085.28, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "FSCL00GV00", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-F0000" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Minimum Stay Offers 5%" > } > ] > } > ], > "SubTitle": "5%", > "SubCode": "Value" > }, > { > "SubTitle": "MSO", > "SubCode": "OTS" > }, > { > "SubTitle": "MSO1", > "SubCode": "OTS" > } > ], > "Title": "Minimum Stay Offers", > "InfoType": "3" > }, > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCP-P7D", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L4A" > }, > "RoomStayCandidateRPH": "0", > "RPH": "5", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RMLXT10000" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-SO000" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 2543.63, > "AmountAfterTax": 2543.63, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 2543.63, > "AmountAfterTax": 2543.63, > "CurrencyCode": "EUR" > }, > "ChargeType": "19" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RMLXT10000", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-SO000" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Rolling EarlyBooking Offers 5%" > } > ] > } > ], > "SubTitle": "5%", > "SubCode": "Value" > }, > { > "SubTitle": "EBR", > "SubCode": "OTS" > }, > { > "SubTitle": "EBR1", > "SubCode": "OTS" > } > ], > "Title": "Rolling EarlyBooking Offers", > "InfoType": "3" > }, > { > "SubSection": [ > { > "SubTitle": "FCP-RATE", > "SubCode": "DRV" > }, > { > "SubTitle": "FCP-P7D", > "SubCode": "DRV" > } > ], > "Title": "FreeCancellationConditions", > "InfoType": "2" > } > ] > }, > "HotelCode": "AESPMI5L66" > }, > "RoomStayCandidateRPH": "0", > "RPH": "6", > "ResponseType": "PropertyList" > } > ] > }, > "Areas": { > "Area": [ > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Arenal" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "0895AR" > } > ], > "Name": "ResortCode" > } > ], > "AreaID": "0895AR" > }, > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Can Picafort" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "0914CA" > } > ], > "Name": "ResortCode" > } > ], > "AreaID": "0914CA" > }, > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Playa de Palma" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "0930PL" > } > ], > "Name": "ResortCode" > } > ], > "AreaID": "0930PL" > }, > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Cala Romántica" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "1456CA" > } > ], > "Name": "ResortCode" > } > ], > "AreaID": "1456CA" > }, > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Puigpunyent" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "4726PU" > } > ], > "Name": "ResortCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "Airport" > } > ], > "AreaID": "4726PU" > }, > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Petra" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "5116PE" > } > ], > "Name": "ResortCode" > } > ], > "AreaID": "5116PE" > }, > { > "AreaDescription": [ > { > "Text": [ > { > "value": "Spain" > } > ], > "Name": "Country" > }, > { > "Text": [ > { > "value": "ES" > } > ], > "Name": "CountryCode" > }, > { > "Text": [ > { > "value": "PMI" > } > ], > "Name": "TravelDestination" > }, > { > "Text": [ > { > "value": "Balearic Islands" > } > ], > "Name": "Destination" > }, > { > "Text": [ > { > "value": "Mallorca" > } > ], > "Name": "Region" > }, > { > "Text": [ > { > "value": "Costa de los Pinos" > } > ], > "Name": "Resort" > }, > { > "Text": [ > { > "value": "7308CO" > } > ], > "Name": "ResortCode" > } > ], > "AreaID": "7308CO" > } > ] > }, > "EchoToken": "1", > "Version": 2016.2, > "TransactionIdentifier": "1-7/7" > } > } > ``` > [tab] Multiroom > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > Early Booking Offers 5% > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > BB > > > > > > > > > > > > > > > Early Booking Offers 5% > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_HotelAvailRS": { > "Success": {}, > "RoomStays": { > "RoomStay": [ > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RMCS00PT00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-BON00" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 271.32, > "AmountAfterTax": 271.32, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 271.32, > "AmountAfterTax": 271.32, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RMCS00PT00", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-BON00" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 1 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Early Booking Offers 5%" > } > ] > } > ], > "SubTitle": "5%", > "SubCode": "Value" > }, > { > "SubTitle": "EBO", > "SubCode": "OTS" > }, > { > "SubTitle": "EBO1", > "SubCode": "OTS" > } > ], > "Title": "Early Booking Offers", > "InfoType": "3" > } > ] > }, > "HotelCode": "AESPMI5L46" > }, > "RoomStayCandidateRPH": "111", > "RPH": "0", > "ResponseType": "PropertyList" > }, > { > "Reference": { > "Type": "22", > "ID": "TEST", > "ID_Context": "TEST" > }, > "RoomTypes": { > "RoomType": [ > { > "RoomTypeCode": "RMCS00PT00" > } > ] > }, > "RatePlans": { > "RatePlan": [ > { > "RatePlanCode": "-OWN2-BON00" > } > ] > }, > "RoomRates": { > "RoomRate": [ > { > "Rates": { > "Rate": [ > { > "Base": { > "AmountBeforeTax": 406.98, > "AmountAfterTax": 406.98, > "CurrencyCode": "EUR" > }, > "Total": { > "Taxes": { > "CurrencyCode": "EUR", > "Amount": 0 > }, > "AmountBeforeTax": 406.98, > "AmountAfterTax": 406.98, > "CurrencyCode": "EUR" > }, > "ChargeType": "21" > } > ] > }, > "Features": { > "Feature": [ > { > "Description": [ > { > "Text": [ > { > "value": "BB" > } > ] > } > ] > } > ] > }, > "RoomTypeCode": "RMCS00PT00", > "NumberOfUnits": 99, > "RatePlanCode": "-OWN2-BON00" > } > ] > }, > "GuestCounts": { > "GuestCount": [ > { > "AgeQualifyingCode": "10", > "Count": 2 > } > ] > }, > "TimeSpan": { > "Start": "2027-07-17", > "End": "2027-07-24" > }, > "BasicPropertyInfo": { > "VendorMessages": { > "VendorMessage": [ > { > "SubSection": [ > { > "Paragraph": [ > { > "Text": [ > { > "value": "Early Booking Offers 5%" > } > ] > } > ], > "SubTitle": "5%", > "SubCode": "Value" > }, > { > "SubTitle": "EBO", > "SubCode": "OTS" > }, > { > "SubTitle": "EBO1", > "SubCode": "OTS" > } > ], > "Title": "Early Booking Offers", > "InfoType": "3" > } > ] > }, > "HotelCode": "AESPMI5L46" > }, > "RoomStayCandidateRPH": "222", > "RPH": "0", > "ResponseType": "PropertyList" > } > ] > }, > "Version": 2016.2, > "TransactionIdentifier": "1-1/1" > } > } > ``` ## Best Practices 1. Include `EchoToken` in both request and response correlation. 2. Use `InfoSource=0` when you only need pricing blocks; enable specific enrichments incrementally. 3. In multi-room flows, validate combinations client‑side using `NumberOfUnits` and candidate indexes. 4. Parse `ChargeType` to correctly label price basis (per person/per unit). # Search and Book Other Products Source: https://docs.axisdata.net/other-products/otherProducts ## What Can You Book? * **Airport Services:** Fast-track security, VIP lounges, PCR tests (at airport or nearby clinics), and more. * **Hotel Extras:** Early check-in, late check-out, spa treatments (handled via OTA\_HotelAvail/OTA\_HotelRes). * **Special Services:** Chauffeur on demand, luxury transfers, and customizable add-ons. * **Excursions and activities**: [Tour Activities](../excursion/searchXARQ) can also be treated and booked as products. * **Transfer Services**: [Transfer](../transfer/searchTRRQ) can also be treated and booked as products. ## How Does It Work? The product flow mirrors the familiar **search → availability → quote → book** process, with real-time inventory and pricing. > [!TIP] > > **IMPORTANT** Follow the [Excursion](../excursion/searchXARQ) specification, since the logic and messages for product are exactly the same. Only the headers change. See the [Complete Examples](#complete-examples). The only difference is that at the Avail messages, the returned category can be chosen: ```xml theme={null} ``` ```json theme={null} { "CategoryTypePref": { "Category": { "Code": "XA" } } } ``` ## Key OTA Messages * **OTA\_ProductSearchRQ/RS:**\ Get real-time inventory descriptions and starting prices for available services (e.g., Marhaba Service, VIP, Fast Track, PCR test, Chauffeur). * **OTA\_ProductAvailRQ/RS:**\ Retrieve detailed pricing for all options and extras, or simply the cheapest available service.\ *Examples: Marhaba bronze/silver/gold/family, sleeping pods, luggage handling, luxury vehicles, and more.* * **OTA\_ProductBookRQ/RS:**\ Instantly quote and book your selected options using the codes provided in the availability response. ## Complete examples ### OTA\_ProductSearch #### Requests > [tab] Search by Region > > ```xml expandable theme={null} > > > > > > > > > > > > > Spain > Costa Blanca > > > AMTSES1IP0 > > > > ``` > > ```json expandable theme={null} > { > "OTA_ProductSearchRQ": { > "POS": { > "Source": [ > { > "RequestorID": { > "ID": "TEST", > "Type": "22", > "ID_Context": "AxisData" > } > }, > { > "RequestorID": { > "Type": "88", > "ID": "TEST", > "MessagePassword": "testpass" > } > } > ] > }, > "SearchCriteria": { > "DateTimePref": { > "Start": "2025-11-17", > "End": "2025-11-24" > }, > "LocationPref": [ > { > "Region": [ > { > "RegionCode": "Country", > "value": "Spain" > }, > { > "RegionCode": "Region", > "value": "Costa Blanca" > } > ], > "Context": "Service" > }, > { > "Region": { > "RegionCode": "Product", > "value": "AMTSES1IP0" > }, > "Context": "Source" > } > ] > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2016.2", > "PrimaryLangID": "EN" > } > } > ``` > [tab] Search by Product > > ```xml expandable theme={null} > > > > > > > > > > > > > OESALCEM74 > > > AMTSES1IP0 > > > > ``` > > ```json expandable theme={null} > { > "OTA_ProductSearchRQ": { > "POS": { > "Source": [ > { > "RequestorID": [ > { > "ID": "TEST", > "Type": "22", > "ID_Context": "AxisData" > } > ] > }, > { > "RequestorID": [ > { > "Type": "88", > "ID": "TEST", > "MessagePassword": "testpass" > } > ] > } > ] > }, > "SearchCriteria": { > "DateTimePref": { > "Start": "2025-11-17", > "End": "2025-11-24" > }, > "LocationPref": [ > { > "Region": { > "RegionCode": "Product", > "value": "OESALCEM74" > }, > "Context": "Service" > }, > { > "Region": { > "RegionCode": "Product", > "value": "AMTSES1IP0" > }, > "Context": "Source" > } > ] > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2016.2", > "PrimaryLangID": "EN" > } > } > ``` #### Responses ```xml Search Response expandable theme={null} Success Balloon Tour Fly over the Mediterranean orchard! Experience the magic of a hot air balloon ride above Elche & Vega Baja — lemon trees, olive groves, palm forests, and endless views await! Includes: Balloon inflation, 1hr flight, HD video, picnic in a palm grove, glass of cava & flight certificate. Total duration: 3 hrs (flight: 1 hr) Meeting point: Alannia Costa Blanca Resort (07:30 summer / 09:00 winter) Dress for a countryside walk — comfy clothes, closed shoes & a cap No minimum booking | Subject to availability XESALCHRS6_1317878.jpg XESALCHRS6_1317878.jpg XESALCHRS6_1317878.jpg XESALCHRS6_1317878.jpg XESALCHRS6_1317880.jpg XESALCHRS6_1317880.jpg XESALCHRS6_1317880.jpg XESALCHRS6_1317880.jpg XESALCHRS6_1317884.jpg XESALCHRS6_1317884.jpg XESALCHRS6_1317884.jpg XESALCHRS6_1317884.jpg XESALCHRS6_1317892.jpg XESALCHRS6_1317892.jpg XESALCHRS6_1317892.jpg XESALCHRS6_1317892.jpg XESALCHRS6_1317896.jpg XESALCHRS6_1317896.jpg XESALCHRS6_1317896.jpg XESALCHRS6_1317896.jpg All - Risk Insurance Easy Support Local Businesses Balloon inflation - 1 h. flight (shared) - Photos - Online HD video - Lunch in our palm grove - Glass of cava and Flight Certificate Free of Charge Snacks Guide English, Spanish Mobile Voucher accepted comfortable sportive Hat/cap Sport, Casual Sun protection Drinks Meals Transport Printed Voucher accepted Sunglasses Sun Protection Anybody Nature Lovers Relaxing Sightseeing Adventurous Enjoy a unique experience. You will discover the rich Mediterranean orchards of the region. An unforgettable landscape from the heights. Spain Valencia/Murcia/Catalunya Costa Blanca Elche ALC PerPerson Fishing Trip (1) Hop aboard our 11m catamaran, fully equipped for a perfect day of coastal fishing. We take care of everything — just bring your excitement! Included: Boat with skipper & fuel Rods, bait & tackle Cold drinks Time: 8:00h – 14:00h Duration: 6 hours Meeting Point: Marina Salinas, Dique de Levante, Torrevieja Whether you're a beginner or a seasoned angler, this is the perfect way to enjoy the sea and reel in some fun. XESALCHTTE_1348514.jpg XESALCHTTE_1348514.jpg XESALCHTTE_1348514.jpg XESALCHTTE_1348514.jpg XESALCHTTE_1348516.jpg XESALCHTTE_1348516.jpg XESALCHTTE_1348516.jpg XESALCHTTE_1348516.jpg XESALCHTTE_1348518.jpg XESALCHTTE_1348518.jpg XESALCHTTE_1348518.jpg XESALCHTTE_1348518.jpg XESALCHTTE_1348520.jpg XESALCHTTE_1348520.jpg XESALCHTTE_1348520.jpg XESALCHTTE_1348520.jpg XESALCHTTE_1348524.jpg XESALCHTTE_1348524.jpg XESALCHTTE_1348524.jpg XESALCHTTE_1348524.jpg Easy Reduced Mobility Support Local Businesses Drinks Boat with skipper and fuel included. Rods, bait, tackle and everything you need for fishing. Cold drinks. Guide English, Spanish Mobile Voucher accepted Casual Sun protection Swimsuit Meals Transport Printed Voucher accepted Motion Sickness Medication Sunglasses Sun Protection Anybody Entertainment Sport fishing Nature Lovers Adventurous Sustainable Conscious View the coast of Torrevieja by catamaran. Exciting fishing trip. Wonderful day at sea. Spain Valencia/Murcia/Catalunya Costa Blanca Torrevieja ALC PerPerson Baby Cot We have a free-delivery and collection service every day from 9 a.m. to 8 p.m. Minimal rent 3 days. Special prices for long term hires. Your satisfaction is our top priority, we want to know all your needs and offer the most suitable solution. * CAR SEAT * PUSHCHAIR * COT So if you are interested in this product leave your details and we will contact you as soon as possible. OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Regular Wheelchair We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals. * 1-SEATER SCOOTER: The LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. Designed for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. Available in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension... Speed 8 Km/h Autonomy 30 Km Lights and indicators Engine: 240w Speed: 8 km/h Batteries 36 Ah Total width: 59 cm Length: 122 cm * 2-SEATER SCOOTER * MANUAL WHEELCHAIR * WALKERS Your satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution. So if you are interested in this product please leave your details and we will contact you as soon as possible. OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Baby Car Seat We have a free-delivery and collection service every day from 9 a.m. to 8 p.m. Minimal rent 3 days. Special prices for long term hires. Your satisfaction is our top priority, we want to know all your needs and offer the most suitable solution. * CAR SEAT * PUSHCHAIR * COT So if you are interested in this product leave your details and we will contact you as soon as possible. OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Mobility Walkers We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals. * 1-SEATER SCOOTER: The LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. Designed for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. Available in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension... Speed 8 Km/h Autonomy 30 Km Lights and indicators Engine: 240w Speed: 8 km/h Batteries 36 Ah Total width: 59 cm Length: 122 cm * 2-SEATER SCOOTER * MANUAL WHEELCHAIR * WALKERS Your satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution. So if you are interested in this product please leave your details and we will contact you as soon as possible. OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Baby Stroller We have a free-delivery and collection service every day from 9 a.m. to 8 p.m. Minimal rent 3 days. Special prices for long term hires. Your satisfaction is our top priority, we want to know all your needs and offer the most suitable solution. * CAR SEAT * PUSHCHAIR * COT So if you are interested in this product leave your details and we will contact you as soon as possible. OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018658.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018660.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg OESALCF1ZC_1018562.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Mobile Scooter We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals. * 1-SEATER SCOOTER: The LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. Designed for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. Available in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension... Speed 8 Km/h Autonomy 30 Km Lights and indicators Engine: 240w Speed: 8 km/h Batteries 36 Ah Total width: 59 cm Length: 122 cm * 2-SEATER SCOOTER * MANUAL WHEELCHAIR * WALKERS Your satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution. So if you are interested in this product please leave your details and we will contact you as soon as possible. OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Double Electric Scoooter We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals. * 1-SEATER SCOOTER: The LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. Designed for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. Available in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension... Speed 8 Km/h Autonomy 30 Km Lights and indicators Engine: 240w Speed: 8 km/h Batteries 36 Ah Total width: 59 cm Length: 122 cm * 2-SEATER SCOOTER * MANUAL WHEELCHAIR * WALKERS Your satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution. So if you are interested in this product please leave your details and we will contact you as soon as possible. OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018530.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018532.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018534.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg OESALCEM74_1018656.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson Bouquet of Yellow Flowers Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel. Sending a bouquet of roses is the ideal way to please whatever the occasion! Red Roses are an expression of love. White Roses are an expression of purity, chastity and innocence. Yellow Roses are symbols of friendship and caring Say it with flowers! OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson Bouquet of Red Flowers Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel. Sending a bouquet of roses is the ideal way to please whatever the occasion! Red Roses are an expression of love. White Roses are an expression of purity, chastity and innocence. Yellow Roses are symbols of friendship and caring Say it with flowers! OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson Bouquet of White Flowers Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel. Sending a bouquet of roses is the ideal way to please whatever the occasion! Red Roses are an expression of love. White Roses are an expression of purity, chastity and innocence. Yellow Roses are symbols of friendship and caring Say it with flowers! OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson Multicolored Bouquet of Flowers Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel. Sending a bouquet of roses is the ideal way to please whatever the occasion! Red Roses are an expression of love. White Roses are an expression of purity, chastity and innocence. Yellow Roses are symbols of friendship and caring Say it with flowers! OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017194.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017196.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017198.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg OESALCF1FI_1017200.jpg Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson Beach Package Option 1 We will provide you with the products you will need to spend some time at the beach. Forget about packing towels, some paddles to play tennis on the sand or even the sun-scream in your suitcase (SPF50-100ml). We also offer you the possibility to rent a beach umbrella or a beach chair, and we can also provide you with water bottles that you can refill and thus contribute to keeping our beaches free of plastic. On the day of your arrival, you will have the purchased products at the reception of your hotel. OESALCG3II_1116042.jpg OESALCG3II_1116042.jpg OESALCG3II_1116042.jpg OESALCG3II_1116044.jpg OESALCG3II_1116044.jpg OESALCG3II_1116044.jpg OESALCG3II_1116044.jpg OESALCG3II_1116046.jpg OESALCG3II_1116046.jpg OESALCG3II_1116046.jpg OESALCG3II_1116046.jpg OESALCG3II_1116048.jpg OESALCG3II_1116048.jpg OESALCG3II_1116048.jpg OESALCG3II_1116048.jpg OESALCG3II_1116050.jpg OESALCG3II_1116050.jpg OESALCG3II_1116050.jpg OESALCG3II_1116050.jpg Towels Spain Valencia/Murcia/Catalunya Costa Blanca Benidorm Levante ALC PerPerson ``` ```json Search response expandable theme={null} { "OTA_ProductSearchRS": { "Success": "Success", "Product": [ { "BasicInfo": { "UnitCode": "TB000000", "ProductID": "XESALCHRS6", "BaseCode": "TIC", "Name": "Hot air balloon ride in Elche" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Balloon Tour", "LongDescription": "Fly over the Mediterranean orchard!\n\nExperience the magic of a hot air balloon ride above Elche & Vega Baja — lemon trees, olive groves, palm forests, and endless views await!\n\nIncludes: Balloon inflation, 1hr flight, HD video, picnic in a palm grove, glass of cava & flight certificate.\n\nTotal duration: 3 hrs (flight: 1 hr)\nMeeting point: Alannia Costa Blanca Resort (07:30 summer / 09:00 winter)\nDress for a countryside walk — comfy clothes, closed shoes & a cap\n\nNo minimum booking | Subject to availability", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "XESALCHRS6_1317878.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1125", "Format": "6", "FileName": "xesalchrs6_1317878_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHRS6_1317878.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "150", "Format": "6", "FileName": "xesalchrs6_1317878_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHRS6_1317878.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "338", "Format": "6", "FileName": "xesalchrs6_1317878_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHRS6_1317878.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "900", "Format": "6", "FileName": "xesalchrs6_1317878_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "AT-MISC", "ID": "20", "LastModifyDateTime": "2024-01-15T16:12:14" }, { "ImageFormat": [ { "URL": "XESALCHRS6_1317880.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "827", "Format": "6", "FileName": "xesalchrs6_1317880_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHRS6_1317880.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "110", "Format": "6", "FileName": "xesalchrs6_1317880_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHRS6_1317880.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "248", "Format": "6", "FileName": "xesalchrs6_1317880_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHRS6_1317880.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "662", "Format": "6", "FileName": "xesalchrs6_1317880_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "AT-MISC", "ID": "20", "LastModifyDateTime": "2024-01-15T16:12:15" }, { "ImageFormat": [ { "URL": "XESALCHRS6_1317884.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1576", "Format": "6", "FileName": "xesalchrs6_1317884_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHRS6_1317884.jpg", "UnitOfMeasureCode": "9", "Width": "190", "Height": "200", "Format": "6", "FileName": "xesalchrs6_1317884_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHRS6_1317884.jpg", "UnitOfMeasureCode": "9", "Width": "428", "Height": "450", "Format": "6", "FileName": "xesalchrs6_1317884_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHRS6_1317884.jpg", "UnitOfMeasureCode": "9", "Width": "1142", "Height": "1200", "Format": "6", "FileName": "xesalchrs6_1317884_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "AT-MISC", "ID": "20", "LastModifyDateTime": "2024-01-15T16:12:15" }, { "ImageFormat": [ { "URL": "XESALCHRS6_1317892.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1125", "Format": "6", "FileName": "xesalchrs6_1317892_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHRS6_1317892.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "150", "Format": "6", "FileName": "xesalchrs6_1317892_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHRS6_1317892.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "338", "Format": "6", "FileName": "xesalchrs6_1317892_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHRS6_1317892.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "900", "Format": "6", "FileName": "xesalchrs6_1317892_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "AT-MISC", "ID": "20", "LastModifyDateTime": "2024-01-15T16:12:15" }, { "ImageFormat": [ { "URL": "XESALCHRS6_1317896.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1028", "Format": "6", "FileName": "xesalchrs6_1317896_1.jpg", "DimensionCategory": "original", "Sort": "5", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHRS6_1317896.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "137", "Format": "6", "FileName": "xesalchrs6_1317896_2.jpg", "DimensionCategory": "thumbnail", "Sort": "5", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHRS6_1317896.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "308", "Format": "6", "FileName": "xesalchrs6_1317896_3.jpg", "DimensionCategory": "display", "Sort": "5", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHRS6_1317896.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "822", "Format": "6", "FileName": "xesalchrs6_1317896_4.jpg", "DimensionCategory": "print", "Sort": "5", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "AT-MISC", "ID": "20", "LastModifyDateTime": "2024-01-15T16:12:15" } ] }, "TextItems": { "TextItem": [ { "Description": "All - Risk Insurance", "Category": "EXCURSION", "SourceID": "EX_ALLRISK" }, { "Description": "Easy", "Category": "EX_DIFFIC", "SourceID": "EX_DIF_1" }, { "Description": "Support Local Businesses", "Category": "EX_ENVIR", "SourceID": "EX_E012" }, { "Description": "Balloon inflation - 1 h. flight (shared) - Photos - Online HD video - Lunch in our palm grove - Glass of cava and Flight Certificate", "Category": "EX_INCL", "SourceID": "EX_INCL_O" }, { "Description": "Free of Charge", "Category": "EX_INCL", "SourceID": "EX_INCL_PHOTOS" }, { "Description": "Snacks", "Category": "EX_INCL", "SourceID": "EX_INCL_SNACKS" }, { "Description": "Guide", "Category": "EX_INCL", "SourceID": "EX_INCL_TG" }, { "Description": "English, Spanish", "Category": "EXCURSION", "SourceID": "EX_LANGSPOKEN" }, { "Description": "Mobile Voucher accepted", "Category": "EXCURSION", "SourceID": "EX_MVOUCHER" }, { "Description": "comfortable sportive", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_DCODE" }, { "Description": "Hat/cap", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_OTHER" }, { "Description": "Sport, Casual", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SHOES" }, { "Description": "Sun protection", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SUB" }, { "Description": "Drinks", "Category": "EX_NOTINCL", "SourceID": "EX_NOTINCL_DRINK" }, { "Description": "Meals", "Category": "EX_NOTINCL", "SourceID": "EX_NOTINCL_FOOD" }, { "Description": "Transport", "Category": "EX_NOTINCL", "SourceID": "EX_NOTINCL_TRF" }, { "Description": "Printed Voucher accepted", "Category": "EXCURSION", "SourceID": "EX_PVOUCHER" }, { "Description": "Sunglasses", "Category": "EX_RECCOM", "SourceID": "EX_RECCOM_SUNG" }, { "Description": "Sun Protection", "Category": "EX_RECCOM", "SourceID": "EX_RECCOM_SUNP" }, { "Description": "Anybody", "Category": "EX_TARGET", "SourceID": "EX_TARGET_ALL" }, { "Description": "Nature Lovers", "Category": "EX_THEME", "SourceID": "EX_THEME_NATURE" }, { "Description": "Relaxing", "Category": "EX_THEME", "SourceID": "EX_THEME_RELAXING" }, { "Description": "Sightseeing", "Category": "EX_THEME", "SourceID": "EX_THEME_SIGHTS" }, { "Description": "Adventurous", "Category": "EX_THEME", "SourceID": "EX_THEME_SPORT" }, { "Description": "Enjoy a unique experience.\nYou will discover the rich Mediterranean orchards of the region.\nAn unforgettable landscape from the heights.", "Category": "EX_HIGHL", "SourceID": "IS_DESC001" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Elche" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.18079", "Longitude": "-0.81191" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "185.00", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "TF000001", "ProductID": "XESALCHTTE", "BaseCode": "TIC", "Name": "Catamaran fishing in Torrevieja" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Fishing Trip (1)", "LongDescription": "Hop aboard our 11m catamaran, fully equipped for a perfect day of coastal fishing. We take care of everything — just bring your excitement!\n\nIncluded:\nBoat with skipper & fuel\nRods, bait & tackle\nCold drinks\n\nTime: 8:00h – 14:00h\nDuration: 6 hours\nMeeting Point: Marina Salinas, Dique de Levante, Torrevieja\n\nWhether you're a beginner or a seasoned angler, this is the perfect way to enjoy the sea and reel in some fun.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "XESALCHTTE_1348514.jpg", "UnitOfMeasureCode": "9", "Width": "1080", "Height": "1920", "Format": "6", "FileName": "xesalchtte_1348514_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHTTE_1348514.jpg", "UnitOfMeasureCode": "9", "Width": "113", "Height": "200", "Format": "6", "FileName": "xesalchtte_1348514_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHTTE_1348514.jpg", "UnitOfMeasureCode": "9", "Width": "253", "Height": "450", "Format": "6", "FileName": "xesalchtte_1348514_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHTTE_1348514.jpg", "UnitOfMeasureCode": "9", "Width": "675", "Height": "1200", "Format": "6", "FileName": "xesalchtte_1348514_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "BT-MISC", "ID": "20", "LastModifyDateTime": "2024-02-27T17:13:14" }, { "ImageFormat": [ { "URL": "XESALCHTTE_1348516.jpg", "UnitOfMeasureCode": "9", "Width": "960", "Height": "1280", "Format": "6", "FileName": "xesalchtte_1348516_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHTTE_1348516.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "xesalchtte_1348516_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHTTE_1348516.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "xesalchtte_1348516_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHTTE_1348516.jpg", "UnitOfMeasureCode": "9", "Width": "900", "Height": "1200", "Format": "6", "FileName": "xesalchtte_1348516_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "BT-MISC", "ID": "20", "LastModifyDateTime": "2024-02-27T17:13:13" }, { "ImageFormat": [ { "URL": "XESALCHTTE_1348518.jpg", "UnitOfMeasureCode": "9", "Width": "1080", "Height": "1920", "Format": "6", "FileName": "xesalchtte_1348518_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHTTE_1348518.jpg", "UnitOfMeasureCode": "9", "Width": "113", "Height": "200", "Format": "6", "FileName": "xesalchtte_1348518_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHTTE_1348518.jpg", "UnitOfMeasureCode": "9", "Width": "253", "Height": "450", "Format": "6", "FileName": "xesalchtte_1348518_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHTTE_1348518.jpg", "UnitOfMeasureCode": "9", "Width": "675", "Height": "1200", "Format": "6", "FileName": "xesalchtte_1348518_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "BT-MISC", "ID": "20", "LastModifyDateTime": "2024-02-27T17:13:14" }, { "ImageFormat": [ { "URL": "XESALCHTTE_1348520.jpg", "UnitOfMeasureCode": "9", "Width": "1536", "Height": "2048", "Format": "6", "FileName": "xesalchtte_1348520_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHTTE_1348520.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "xesalchtte_1348520_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHTTE_1348520.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "xesalchtte_1348520_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHTTE_1348520.jpg", "UnitOfMeasureCode": "9", "Width": "900", "Height": "1200", "Format": "6", "FileName": "xesalchtte_1348520_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "BT-MISC", "ID": "20", "LastModifyDateTime": "2024-02-27T17:13:14" }, { "ImageFormat": [ { "URL": "XESALCHTTE_1348524.jpg", "UnitOfMeasureCode": "9", "Width": "1125", "Height": "1500", "Format": "6", "FileName": "xesalchtte_1348524_1.jpg", "DimensionCategory": "original", "Sort": "5", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "XESALCHTTE_1348524.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "xesalchtte_1348524_2.jpg", "DimensionCategory": "thumbnail", "Sort": "5", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "XESALCHTTE_1348524.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "xesalchtte_1348524_3.jpg", "DimensionCategory": "display", "Sort": "5", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "XESALCHTTE_1348524.jpg", "UnitOfMeasureCode": "9", "Width": "900", "Height": "1200", "Format": "6", "FileName": "xesalchtte_1348524_4.jpg", "DimensionCategory": "print", "Sort": "5", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "BT-MISC", "ID": "20", "LastModifyDateTime": "2024-02-27T17:13:13" } ] }, "TextItems": { "TextItem": [ { "Description": "Easy", "Category": "EX_DIFFIC", "SourceID": "EX_DIF_1" }, { "Description": "Reduced Mobility", "Category": "EX_DIFFIC", "SourceID": "EX_DIF_4" }, { "Description": "Support Local Businesses", "Category": "EX_ENVIR", "SourceID": "EX_E012" }, { "Description": "Drinks", "Category": "EX_INCL", "SourceID": "EX_INCL_DRINK" }, { "Description": "Boat with skipper and fuel included. Rods, bait, tackle and everything you need for fishing. Cold drinks.", "Category": "EX_INCL", "SourceID": "EX_INCL_O" }, { "Description": "Guide", "Category": "EX_INCL", "SourceID": "EX_INCL_TG" }, { "Description": "English, Spanish", "Category": "EXCURSION", "SourceID": "EX_LANGSPOKEN" }, { "Description": "Mobile Voucher accepted", "Category": "EXCURSION", "SourceID": "EX_MVOUCHER" }, { "Description": "Casual", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SHOES" }, { "Description": "Sun protection", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SUB" }, { "Description": "Swimsuit", "Category": "EX_NEEDED", "SourceID": "EX_NEEDED_SWIM" }, { "Description": "Meals", "Category": "EX_NOTINCL", "SourceID": "EX_NOTINCL_FOOD" }, { "Description": "Transport", "Category": "EX_NOTINCL", "SourceID": "EX_NOTINCL_TRF" }, { "Description": "Printed Voucher accepted", "Category": "EXCURSION", "SourceID": "EX_PVOUCHER" }, { "Description": "Motion Sickness Medication", "Category": "EX_RECCOM", "SourceID": "EX_RECCOM_MOSICK" }, { "Description": "Sunglasses", "Category": "EX_RECCOM", "SourceID": "EX_RECCOM_SUNG" }, { "Description": "Sun Protection", "Category": "EX_RECCOM", "SourceID": "EX_RECCOM_SUNP" }, { "Description": "Anybody", "Category": "EX_TARGET", "SourceID": "EX_TARGET_ALL" }, { "Description": "Entertainment", "Category": "EX_THEME", "SourceID": "EX_THEME_ENTERT" }, { "Description": "Sport fishing", "Category": "EX_THEME", "SourceID": "EX_THEME_FISHING" }, { "Description": "Nature Lovers", "Category": "EX_THEME", "SourceID": "EX_THEME_NATURE" }, { "Description": "Adventurous", "Category": "EX_THEME", "SourceID": "EX_THEME_SPORT" }, { "Description": "Sustainable Conscious", "Category": "EX_THEME", "SourceID": "EX_THEME_SUSTAIN" }, { "Description": "View the coast of Torrevieja by catamaran.\nExciting fishing trip.\nWonderful day at sea.", "Category": "EX_HIGHL", "SourceID": "IS_DESC001" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Torrevieja" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "37.9706", "Longitude": "-0.68004" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "200.00", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "BC", "ProductID": "OESALCF1ZC", "BaseCode": "NA", "Name": "Hire Supplements for Children" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Baby Cot", "LongDescription": "We have a free-delivery and collection service every day from 9 a.m. to 8 p.m. Minimal rent 3 days. Special prices for long term hires.\n\nYour satisfaction is our top priority, we want to know all your needs and offer the most suitable solution.\n\n* CAR SEAT\n\n* PUSHCHAIR\n\n* COT\n\nSo if you are interested in this product leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018658_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018658_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018658_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018658_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:59:09" }, { "ImageFormat": [ { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1701", "Format": "6", "FileName": "oesalcf1zc_1018660_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "141", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018660_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "317", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018660_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "847", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018660_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:59:09" }, { "ImageFormat": [ { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1500", "Format": "6", "FileName": "oesalcf1zc_1018562_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018562_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018562_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018562_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:03:54" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54042", "Longitude": "-0.11148" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.15", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "RW", "ProductID": "OESALCEM74", "BaseCode": "NA", "Name": "Rental of Wheelchairs and other Assistances Aids" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Regular Wheelchair", "LongDescription": "We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals.\n\n* 1-SEATER SCOOTER:\n\nThe LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. \n\nDesigned for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. \n\nAvailable in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension...\n\nSpeed 8 Km/h\nAutonomy 30 Km\nLights and indicators\nEngine: 240w\nSpeed: 8 km/h\nBatteries 36 Ah\nTotal width: 59 cm\nLength: 122 cm\n\n* 2-SEATER SCOOTER\n \n* MANUAL WHEELCHAIR\n\n* WALKERS\n\nYour satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution.\nSo if you are interested in this product please leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "4080", "Height": "5436", "Format": "6", "FileName": "oesalcem74_1018530_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018530_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018530_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "901", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018530_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "1801", "Height": "2400", "Format": "6", "FileName": "oesalcem74_1018530_5.jpg", "DimensionCategory": "print_lead", "Sort": "1", "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1772", "Height": "1824", "Format": "6", "FileName": "oesalcem74_1018532_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "194", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018532_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "437", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018532_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1166", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018532_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "2362", "Height": "2638", "Format": "6", "FileName": "oesalcem74_1018534_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "179", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018534_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "403", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018534_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "1074", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018534_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1307", "Format": "6", "FileName": "oesalcem74_1018656_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "184", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018656_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "413", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018656_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1102", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018656_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:58:25" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54031", "Longitude": "-0.11152" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.15", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "BS", "ProductID": "OESALCF1ZC", "BaseCode": "NA", "Name": "Hire Supplements for Children" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Baby Car Seat", "LongDescription": "We have a free-delivery and collection service every day from 9 a.m. to 8 p.m. Minimal rent 3 days. Special prices for long term hires.\n\nYour satisfaction is our top priority, we want to know all your needs and offer the most suitable solution.\n\n* CAR SEAT\n\n* PUSHCHAIR\n\n* COT\n\nSo if you are interested in this product leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018658_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018658_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018658_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018658_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:59:09" }, { "ImageFormat": [ { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1701", "Format": "6", "FileName": "oesalcf1zc_1018660_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "141", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018660_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "317", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018660_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "847", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018660_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:59:09" }, { "ImageFormat": [ { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1500", "Format": "6", "FileName": "oesalcf1zc_1018562_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018562_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018562_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018562_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:03:54" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54042", "Longitude": "-0.11148" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.15", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "MW", "ProductID": "OESALCEM74", "BaseCode": "NA", "Name": "Rental of Wheelchairs and other Assistances Aids" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Mobility Walkers", "LongDescription": "We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals.\n\n* 1-SEATER SCOOTER:\n\nThe LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. \n\nDesigned for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. \n\nAvailable in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension...\n\nSpeed 8 Km/h\nAutonomy 30 Km\nLights and indicators\nEngine: 240w\nSpeed: 8 km/h\nBatteries 36 Ah\nTotal width: 59 cm\nLength: 122 cm\n\n* 2-SEATER SCOOTER\n \n* MANUAL WHEELCHAIR\n\n* WALKERS\n\nYour satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution.\nSo if you are interested in this product please leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "4080", "Height": "5436", "Format": "6", "FileName": "oesalcem74_1018530_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018530_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018530_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "901", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018530_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "1801", "Height": "2400", "Format": "6", "FileName": "oesalcem74_1018530_5.jpg", "DimensionCategory": "print_lead", "Sort": "1", "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1772", "Height": "1824", "Format": "6", "FileName": "oesalcem74_1018532_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "194", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018532_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "437", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018532_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1166", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018532_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "2362", "Height": "2638", "Format": "6", "FileName": "oesalcem74_1018534_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "179", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018534_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "403", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018534_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "1074", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018534_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1307", "Format": "6", "FileName": "oesalcem74_1018656_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "184", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018656_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "413", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018656_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1102", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018656_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:58:25" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54031", "Longitude": "-0.11152" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.15", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "SB", "ProductID": "OESALCF1ZC", "BaseCode": "NA", "Name": "Hire Supplements for Children" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Baby Stroller", "LongDescription": "We have a free-delivery and collection service every day from 9 a.m. to 8 p.m. Minimal rent 3 days. Special prices for long term hires.\n\nYour satisfaction is our top priority, we want to know all your needs and offer the most suitable solution.\n\n* CAR SEAT\n\n* PUSHCHAIR\n\n* COT\n\nSo if you are interested in this product leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018658_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018658_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018658_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018658.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018658_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:59:09" }, { "ImageFormat": [ { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1701", "Format": "6", "FileName": "oesalcf1zc_1018660_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "141", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018660_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "317", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018660_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018660.jpg", "UnitOfMeasureCode": "9", "Width": "847", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018660_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:59:09" }, { "ImageFormat": [ { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "1500", "Format": "6", "FileName": "oesalcf1zc_1018562_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1zc_1018562_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1zc_1018562_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1ZC_1018562.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1zc_1018562_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:03:54" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54042", "Longitude": "-0.11148" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.15", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "MS", "ProductID": "OESALCEM74", "BaseCode": "NA", "Name": "Rental of Wheelchairs and other Assistances Aids" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Mobile Scooter", "LongDescription": "We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals.\n\n* 1-SEATER SCOOTER:\n\nThe LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. \n\nDesigned for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. \n\nAvailable in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension...\n\nSpeed 8 Km/h\nAutonomy 30 Km\nLights and indicators\nEngine: 240w\nSpeed: 8 km/h\nBatteries 36 Ah\nTotal width: 59 cm\nLength: 122 cm\n\n* 2-SEATER SCOOTER\n \n* MANUAL WHEELCHAIR\n\n* WALKERS\n\nYour satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution.\nSo if you are interested in this product please leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "4080", "Height": "5436", "Format": "6", "FileName": "oesalcem74_1018530_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018530_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018530_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "901", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018530_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "1801", "Height": "2400", "Format": "6", "FileName": "oesalcem74_1018530_5.jpg", "DimensionCategory": "print_lead", "Sort": "1", "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1772", "Height": "1824", "Format": "6", "FileName": "oesalcem74_1018532_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "194", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018532_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "437", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018532_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1166", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018532_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "2362", "Height": "2638", "Format": "6", "FileName": "oesalcem74_1018534_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "179", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018534_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "403", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018534_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "1074", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018534_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1307", "Format": "6", "FileName": "oesalcem74_1018656_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "184", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018656_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "413", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018656_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1102", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018656_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:58:25" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54031", "Longitude": "-0.11152" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.30", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "DS", "ProductID": "OESALCEM74", "BaseCode": "NA", "Name": "Rental of Wheelchairs and other Assistances Aids" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Double Electric Scoooter", "LongDescription": "We work together with all the hotels in Benidorm, so you won't have any problems recharging your scooter. We have a free daily delivery and collection service from 9am to 8pm. Minimum rental of 3 days. Special prices for long term rentals.\n\n* 1-SEATER SCOOTER:\n\nThe LEO 4 WHEELS electric scooter for seniors is ideal for an average sized person, weighing up to 127kg. \n\nDesigned for those who value their autonomy, with basket, pneumatic wheels, ergonomic handlebars, padded seat, brake lights and comfortable folding armrests. \n\nAvailable in silver, onyx blue and red. You can add accessories such as mirrors, luggage compartment, belt, support for walking sticks, crutches or walkers, protective cover, windscreen, external charger kit, suspension...\n\nSpeed 8 Km/h\nAutonomy 30 Km\nLights and indicators\nEngine: 240w\nSpeed: 8 km/h\nBatteries 36 Ah\nTotal width: 59 cm\nLength: 122 cm\n\n* 2-SEATER SCOOTER\n \n* MANUAL WHEELCHAIR\n\n* WALKERS\n\nYour satisfaction is our top priority, we want to know all your needs and offer you the most suitable solution.\nSo if you are interested in this product please leave your details and we will contact you as soon as possible.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "4080", "Height": "5436", "Format": "6", "FileName": "oesalcem74_1018530_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "150", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018530_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "338", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018530_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "901", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018530_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" }, { "URL": "OESALCEM74_1018530.jpg", "UnitOfMeasureCode": "9", "Width": "1801", "Height": "2400", "Format": "6", "FileName": "oesalcem74_1018530_5.jpg", "DimensionCategory": "print_lead", "Sort": "1", "Title": "Miscellaneous", "RecordID": "5" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1772", "Height": "1824", "Format": "6", "FileName": "oesalcem74_1018532_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "194", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018532_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "437", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018532_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018532.jpg", "UnitOfMeasureCode": "9", "Width": "1166", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018532_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "2362", "Height": "2638", "Format": "6", "FileName": "oesalcem74_1018534_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "179", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018534_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "403", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018534_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018534.jpg", "UnitOfMeasureCode": "9", "Width": "1074", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018534_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:01:59" }, { "ImageFormat": [ { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1307", "Format": "6", "FileName": "oesalcem74_1018656_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "184", "Height": "200", "Format": "6", "FileName": "oesalcem74_1018656_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "413", "Height": "450", "Format": "6", "FileName": "oesalcem74_1018656_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCEM74_1018656.jpg", "UnitOfMeasureCode": "9", "Width": "1102", "Height": "1200", "Format": "6", "FileName": "oesalcem74_1018656_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-30T16:58:25" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.54031", "Longitude": "-0.11152" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.51", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "YF", "ProductID": "OESALCF1FI", "BaseCode": "NA", "Name": "Bouquet of Flowers" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Bouquet of Yellow Flowers", "LongDescription": "Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel.\nSending a bouquet of roses is the ideal way to please whatever the occasion!\n\nRed Roses are an expression of love.\nWhite Roses are an expression of purity, chastity and innocence.\nYellow Roses are symbols of friendship and caring\n\nSay it with flowers!", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017194_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017194_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017194_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017194_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017196_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017196_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017196_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017196_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017198_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017198_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017198_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017198_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017200_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017200_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017200_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017200_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.28701", "Longitude": "-0.55663" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.86", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "RF", "ProductID": "OESALCF1FI", "BaseCode": "NA", "Name": "Bouquet of Flowers" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Bouquet of Red Flowers", "LongDescription": "Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel.\nSending a bouquet of roses is the ideal way to please whatever the occasion!\n\nRed Roses are an expression of love.\nWhite Roses are an expression of purity, chastity and innocence.\nYellow Roses are symbols of friendship and caring\n\nSay it with flowers!", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017194_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017194_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017194_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017194_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017196_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017196_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017196_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017196_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017198_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017198_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017198_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017198_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017200_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017200_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017200_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017200_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.28701", "Longitude": "-0.55663" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.86", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "WF", "ProductID": "OESALCF1FI", "BaseCode": "NA", "Name": "Bouquet of Flowers" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Bouquet of White Flowers", "LongDescription": "Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel.\nSending a bouquet of roses is the ideal way to please whatever the occasion!\n\nRed Roses are an expression of love.\nWhite Roses are an expression of purity, chastity and innocence.\nYellow Roses are symbols of friendship and caring\n\nSay it with flowers!", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017194_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017194_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017194_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017194_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017196_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017196_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017196_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017196_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017198_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017198_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017198_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017198_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017200_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017200_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017200_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017200_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.28701", "Longitude": "-0.55663" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "0.86", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "MF", "ProductID": "OESALCF1FI", "BaseCode": "NA", "Name": "Bouquet of Flowers" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Multicolored Bouquet of Flowers", "LongDescription": "Choose the bouquet of roses that you like and will be handcrafted and delivered by one of our local florists at your hotel.\nSending a bouquet of roses is the ideal way to please whatever the occasion!\n\nRed Roses are an expression of love.\nWhite Roses are an expression of purity, chastity and innocence.\nYellow Roses are symbols of friendship and caring\n\nSay it with flowers!", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017194_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017194_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017194_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017194.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017194_4.jpg", "DimensionCategory": "print", "Sort": "1", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017196_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017196_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017196_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017196.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017196_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017198_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017198_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017198_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017198.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017198_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" }, { "ImageFormat": [ { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1452", "Height": "1452", "Format": "6", "FileName": "oesalcf1fi_1017200_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "200", "Height": "200", "Format": "6", "FileName": "oesalcf1fi_1017200_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "450", "Height": "450", "Format": "6", "FileName": "oesalcf1fi_1017200_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCF1FI_1017200.jpg", "UnitOfMeasureCode": "9", "Width": "1200", "Height": "1200", "Format": "6", "FileName": "oesalcf1fi_1017200_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "MS-MISC", "ID": "20", "LastModifyDateTime": "2021-12-22T13:34:06" } ] } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.28701", "Longitude": "-0.55663" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "1.92", "CurrencyCode": "EUR" } }, { "BasicInfo": { "UnitCode": "BP1", "ProductID": "OESALCG3II", "BaseCode": "NA", "Name": "Beach Package" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-24" } }, "CategoryAndType": { "Category": "", "Type": "" }, "Description": { "ShortDescription": "Beach Package Option 1", "LongDescription": "We will provide you with the products you will need to spend some time at the beach.\n\nForget about packing towels, some paddles to play tennis on the sand or even the sun-scream in your suitcase (SPF50-100ml).\n\nWe also offer you the possibility to rent a beach umbrella or a beach chair, and we can also provide you with water bottles that you can refill and thus contribute to keeping our beaches free of plastic.\n\nOn the day of your arrival, you will have the purchased products at the reception of your hotel.", "Multimedia": { "MultimediaDescription": { "ImageItems": { "ImageItem": [ { "ImageFormat": [ { "URL": "OESALCG3II_1116042.jpg", "UnitOfMeasureCode": "9", "Width": "1000", "Height": "667", "Format": "6", "FileName": "oesalcg3ii_1116042_1.jpg", "DimensionCategory": "original", "Sort": "1", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCG3II_1116042.jpg", "UnitOfMeasureCode": "9", "Width": "300", "Height": "200", "Format": "6", "FileName": "oesalcg3ii_1116042_2.jpg", "DimensionCategory": "thumbnail", "Sort": "1", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCG3II_1116042.jpg", "UnitOfMeasureCode": "9", "Width": "675", "Height": "450", "Format": "6", "FileName": "oesalcg3ii_1116042_3.jpg", "DimensionCategory": "display", "Sort": "1", "Title": "Miscellaneous", "RecordID": "3" } ], "Category": "DS-MISCELLENOUS", "ID": "20", "LastModifyDateTime": "2022-09-30T15:21:37" }, { "ImageFormat": [ { "URL": "OESALCG3II_1116044.jpg", "UnitOfMeasureCode": "9", "Width": "1500", "Height": "634", "Format": "6", "FileName": "oesalcg3ii_1116044_1.jpg", "DimensionCategory": "original", "Sort": "2", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCG3II_1116044.jpg", "UnitOfMeasureCode": "9", "Width": "473", "Height": "200", "Format": "6", "FileName": "oesalcg3ii_1116044_2.jpg", "DimensionCategory": "thumbnail", "Sort": "2", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCG3II_1116044.jpg", "UnitOfMeasureCode": "9", "Width": "1065", "Height": "450", "Format": "6", "FileName": "oesalcg3ii_1116044_3.jpg", "DimensionCategory": "display", "Sort": "2", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCG3II_1116044.jpg", "UnitOfMeasureCode": "9", "Width": "2839", "Height": "1200", "Format": "6", "FileName": "oesalcg3ii_1116044_4.jpg", "DimensionCategory": "print", "Sort": "2", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "DS-MISCELLENOUS", "ID": "20", "LastModifyDateTime": "2022-09-30T15:21:37" }, { "ImageFormat": [ { "URL": "OESALCG3II_1116046.jpg", "UnitOfMeasureCode": "9", "Width": "1536", "Height": "1024", "Format": "6", "FileName": "oesalcg3ii_1116046_1.jpg", "DimensionCategory": "original", "Sort": "3", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCG3II_1116046.jpg", "UnitOfMeasureCode": "9", "Width": "300", "Height": "200", "Format": "6", "FileName": "oesalcg3ii_1116046_2.jpg", "DimensionCategory": "thumbnail", "Sort": "3", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCG3II_1116046.jpg", "UnitOfMeasureCode": "9", "Width": "675", "Height": "450", "Format": "6", "FileName": "oesalcg3ii_1116046_3.jpg", "DimensionCategory": "display", "Sort": "3", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCG3II_1116046.jpg", "UnitOfMeasureCode": "9", "Width": "1800", "Height": "1200", "Format": "6", "FileName": "oesalcg3ii_1116046_4.jpg", "DimensionCategory": "print", "Sort": "3", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "DS-MISCELLENOUS", "ID": "20", "LastModifyDateTime": "2022-09-30T15:21:37" }, { "ImageFormat": [ { "URL": "OESALCG3II_1116048.jpg", "UnitOfMeasureCode": "9", "Width": "1468", "Height": "979", "Format": "6", "FileName": "oesalcg3ii_1116048_1.jpg", "DimensionCategory": "original", "Sort": "4", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCG3II_1116048.jpg", "UnitOfMeasureCode": "9", "Width": "300", "Height": "200", "Format": "6", "FileName": "oesalcg3ii_1116048_2.jpg", "DimensionCategory": "thumbnail", "Sort": "4", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCG3II_1116048.jpg", "UnitOfMeasureCode": "9", "Width": "675", "Height": "450", "Format": "6", "FileName": "oesalcg3ii_1116048_3.jpg", "DimensionCategory": "display", "Sort": "4", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCG3II_1116048.jpg", "UnitOfMeasureCode": "9", "Width": "1799", "Height": "1200", "Format": "6", "FileName": "oesalcg3ii_1116048_4.jpg", "DimensionCategory": "print", "Sort": "4", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "DS-MISCELLENOUS", "ID": "20", "LastModifyDateTime": "2022-09-30T15:21:37" }, { "ImageFormat": [ { "URL": "OESALCG3II_1116050.jpg", "UnitOfMeasureCode": "9", "Width": "1339", "Height": "891", "Format": "6", "FileName": "oesalcg3ii_1116050_1.jpg", "DimensionCategory": "original", "Sort": "5", "Title": "Miscellaneous", "RecordID": "1" }, { "URL": "OESALCG3II_1116050.jpg", "UnitOfMeasureCode": "9", "Width": "301", "Height": "200", "Format": "6", "FileName": "oesalcg3ii_1116050_2.jpg", "DimensionCategory": "thumbnail", "Sort": "5", "Title": "Miscellaneous", "RecordID": "2" }, { "URL": "OESALCG3II_1116050.jpg", "UnitOfMeasureCode": "9", "Width": "676", "Height": "450", "Format": "6", "FileName": "oesalcg3ii_1116050_3.jpg", "DimensionCategory": "display", "Sort": "5", "Title": "Miscellaneous", "RecordID": "3" }, { "URL": "OESALCG3II_1116050.jpg", "UnitOfMeasureCode": "9", "Width": "1803", "Height": "1200", "Format": "6", "FileName": "oesalcg3ii_1116050_4.jpg", "DimensionCategory": "print", "Sort": "5", "Title": "Miscellaneous", "RecordID": "4" } ], "Category": "DS-MISCELLENOUS", "ID": "20", "LastModifyDateTime": "2022-09-30T15:21:37" } ] }, "TextItems": { "TextItem": { "Description": "Towels", "Category": "MS_INCL", "SourceID": "MS_INCL_TOW" } } } } }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Benidorm Levante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ], "Position": { "Latitude": "38.53656", "Longitude": "-0.11415" } }, "Policies": { "Participant": { "MinParticipants": "1", "MaxParticipants": "99" } }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" } } ], "xmlns": "http://www.opentravel.org/OTA/2003/05" } } ``` ### OTA\_ProductAvail #### Requests > [tab] Avail by Region > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > Spain > Costa Blanca > > > AMTSES1IP0 > > > > Adult > > > > ``` > > ```json expandable theme={null} > { > "OTA_ProductAvailRQ": { > "POS": { > "Source": [ > { > "RequestorID": [ > { > "ID": "TEST", > "Instance": "MF002", > "Type": "22", > "ID_Context": "AxisData" > } > ] > }, > { > "RequestorID": [ > { > "Type": "88", > "ID": "TEST", > "MessagePassword": "testpass" > } > ] > } > ] > }, > "Product": { > "BasicInfo": "", > "CategoryTypePref": { > "Category": { > "Code": "XA" > } > }, > "Location": [ > { > "Region": [ > { > "RegionCode": "Country", > "value": "Spain" > }, > { > "RegionCode": "Region", > "value": "Costa Blanca" > } > ], > "Context": "Service" > }, > { > "Region": { > "RegionCode": "Product", > "value": "AMTSES1IP0" > }, > "Context": "Source" > } > ], > "Schedule": { > "StartPeriod": "2025-11-17", > "EndPeriod": "2025-11-24" > }, > "ParticipantCount": { > "QualifierInfo": "Adult", > "Quantity": "2", > "Age": "25" > } > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2016.2", > "PrimaryLangID": "EN" > } > } > ``` > [tab] Avail by Product > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > XESALCGUG6 > > > AMTSES1IP0 > > > > Adult > > > > ``` > > ```json expandable theme={null} > { > "OTA_ProductAvailRQ": { > "POS": { > "Source": [ > { > "RequestorID": [ > { > "ID": "TEST", > "Instance": "MF002", > "Type": "22", > "ID_Context": "AxisData" > } > ] > }, > { > "RequestorID": [ > { > "Type": "88", > "ID": "TEST", > "MessagePassword": "testpass" > } > ] > } > ] > }, > "Product": { > "BasicInfo": "", > "CategoryTypePref": { > "Category": { > "Code": "XA" > } > }, > "Location": [ > { > "Region": { > "RegionCode": "Product", > "value": "XESALCGUG6" > }, > "Context": "Service" > }, > { > "Region": { > "RegionCode": "Product", > "value": "AMTSES1IP0" > }, > "Context": "Source" > } > ], > "Schedule": { > "StartPeriod": "2025-11-17", > "EndPeriod": "2025-11-24" > }, > "ParticipantCount": { > "QualifierInfo": "Adult", > "Quantity": "2", > "Age": "25" > } > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "Version": "2016.2", > "PrimaryLangID": "EN" > } > } > ``` #### Responses ```xml Avail Response expandable theme={null} MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson MARQ Archaeological Museum Alicante Spain Valencia/Murcia/Catalunya Costa Blanca Alicante ALC PerPerson ``` ```json Avail Response expandable theme={null} { "OTA_ProductAvailRS": { "Success": "", "Product": [ { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-23", "End": "2025-11-23" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "6.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-17" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-18", "End": "2025-11-18" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-19", "End": "2025-11-19" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-20", "End": "2025-11-20" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-21", "End": "2025-11-21" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-22", "End": "2025-11-22" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-24", "End": "2025-11-24" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "10.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-17", "End": "2025-11-17" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-18", "End": "2025-11-18" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-19", "End": "2025-11-19" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-20", "End": "2025-11-20" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-21", "End": "2025-11-21" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-22", "End": "2025-11-22" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-23", "End": "2025-11-23" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } }, { "BasicInfo": { "UnitCode": "TK000002", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "Schedule": { "Summary": { "Start": "2025-11-24", "End": "2025-11-24" } }, "CategoryAndType": { "Category": { "Code": "XA" }, "Type": { "Code": "MM" } }, "Description": { "ShortDescription": "MARQ Archaeological Museum Alicante" }, "Location": { "Region": [ { "RegionCode": "Country", "value": "Spain" }, { "RegionCode": "Destination", "value": "Valencia/Murcia/Catalunya" }, { "RegionCode": "Region", "value": "Costa Blanca" }, { "RegionCode": "Resort", "value": "Alicante" }, { "RegionCode": "TravelDestination", "value": "ALC" } ] }, "Pricing": { "PricingType": "PerPerson", "MinPrice": "16.00", "CurrencyCode": "EUR" }, "PickupDropoff": { "Code": "AMTSES1IP0", "LocationName": "Hospes Amerigo", "PickupInd": "false" } } ], "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2016.2" } } ``` ### OTA\_ProductBook #### Requests ```xml Book Request expandable theme={null} Mr Bender Bending Ms Angeline Bending ``` ```json Book Request expandable theme={null} { "OTA_ProductBookRQ": { "POS": { "Source": [ { "RequestorID": [ { "ID": "TEST", "Type": "22", "ID_Context": "AxisData" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] }, "BookingInfo": { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "ParticipantInfo": [ { "Category": { "QualifierInfo": "ADT" }, "Individual": { "NamePrefix": "Mr", "GivenName": "Bender", "Surname": "Bending", "Age": "36", "ParticipantID": "1", "LeadCustomerInd": "true" } }, { "Category": { "QualifierInfo": "ADT" }, "Individual": { "NamePrefix": "Ms", "GivenName": "Angeline", "Surname": "Bending", "Age": "32", "ParticipantID": "2", "LeadCustomerInd": "false" } } ], "Schedule": { "Start": "2025-11-23", "End": "2025-11-23" }, "PickupDropoff": { "DateTime": "2025-11-23T10:50:00", "PickupInd": "false", "LocationName": "AMTSES1IP0" } }, "TPA_Extensions": { "UniqueID": { "Type": "36", "ID_Context": "Client", "ID": "test_axis_product" } }, "xmlns": "http://www.opentravel.org/OTA/2003/05", "ResStatus": "Quote", "Version": "2016.2" } } ``` #### Responses ```xml Book Response expandable theme={null} Mr Bender Bending Ms Angeline Bending ALC ``` ```json Book Response expandable theme={null} { "OTA_ProductBookRS": { "Success": "", "ReservationDetails": { "BasicInfo": { "UnitCode": "TK000001", "ProductID": "XESALCGUG6", "BaseCode": "TIC" }, "ParticipantInfo": [ { "Category": { "QualifierInfo": "ADT" }, "Individual": { "NamePrefix": "Mr", "GivenName": "Bender", "Surname": "Bending", "Age": "36", "ParticipantID": "1", "LeadCustomerInd": "true" } }, { "Category": { "QualifierInfo": "ADT" }, "Individual": { "NamePrefix": "Ms", "GivenName": "Angeline", "Surname": "Bending", "Age": "32", "ParticipantID": "2", "LeadCustomerInd": "false" } } ], "Schedule": { "Start": "2025-11-23", "End": "2025-11-23" }, "Location": { "Region": { "RegionCode": "TravelDestination", "value": "ALC" }, "Context": "Service" }, "PickupDropoff": { "Schedule": { "OperationTimes": { "OperationTime": { "Start": "2025-11-23", "End": "2025-11-23" } } }, "DateTime": "2025-11-23T10:50:00", "PickupInd": "false", "LocationName": "AMTSES1IP0" }, "Pricing": { "Summary": { "Amount": "6.00", "CurrencyCode": "EUR" }, "Group": { "KnownGroupsize": "2" } } }, "TPA_Extensions": { "CancelPenalties": { "CancelPenalty": [ { "Deadline": { "OffsetUnitMultiplier": "24", "OffsetTimeUnit": "Hour", "OffsetDropTime": "BeforeArrival", "AbsoluteDeadline": "2025-11-22T01:00:00" }, "AmountPercent": { "Amount": "6.00", "CurrencyCode": "EUR", "BasisType": "FullStay", "Percent": "100" }, "Item_RPH": "1" } ] }, "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "test_axis_product" }, { "Item_RPH": "1", "ID": "test_axis_product-1", "Type": "37", "ID_Context": "Client" }, { "Item_RPH": "1", "ID": "1", "Type": "37", "ID_Context": "Internal" } ] }, "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2016.2" } } ``` # Excursion Source: https://docs.axisdata.net/pushmodel/excursionOTA ## Introduction OTA-based notifications for excursions use the **OTA\_TourActivityRQ/RS** message set (OpenTravel). These are used in push-model integrations to provide partners with up-to-date **rates**, **availability**, and **product content** for excursions and activities. A typical notification horizon is **12–18 months**. Delta notifications are commonly sent **every 15 minutes** during daytime and **hourly** overnight. > [!NOTE] > > This page keeps a **transactional focus**: structures and rules are aligned with the real-time messages you use in pricing/booking flows (OTA\_TourActivityRQ/RS), while showing how the same elements appear in push notifications. *** ## Notification Schedule * **Full notification**: inventories, rates, and/or availabilities for all products and for the full period. * **Delta notification**: * **Stock** (availability) deltas only include full affected files. * **Rates** deltas ship the full rate scope for the affected product/period. * Frequency guideline: full **weekly**; deltas **every 15 min** (09:00–22:59 CET) and **hourly** overnight. *** ## Allotment (Availability) `OTA_TourActivityAvailRS` with `Target="Stock"`. Used to communicate **when** a service operates, what **release** applies, and how many **units** remain. ### Skeleton ```xml theme={null} ``` ### Technical Notes (Availability Patterns) * The **`Detail`** node’s `Start`/`End` bounds the date range covered by all patterns underneath it. * **`OperationTime`** (`PatternLength="1"`): * `1` = service operates; `0` = closed (closeouts, DOW restrictions, etc.). * **`Release`** (`PatternLength="5"`): * Each day consumes **5 chars** in **XML duration** format (e.g., `PT00H`, `P1D`). * **`Allotment`** (`PatternLength="2"`): * `XX` = remaining integer units (e.g., `07`) * `99` = **Free sale** * `RQ` = **On request** * `SS` = **Stop sale** * A date is **bookable** only if **all three** concepts pass: `OperationTime=open` **AND** `Release satisfied` **AND** `Allotment available`. ### Pickup/Dropoff Logic * Services with transfers list allowed hotel pickup points in **`TPA_Extensions/Stocks/Stock/PickupDropoffs`**. * All hotels in the list are valid pickup/dropoff candidates; some allotment conditions may be constrained to **specific pickup points**. ### Deactivation Communicated with the same RS envelope, marking `StockStatusType="Deactivated"`. Without dates, the product is deactivated **entirely**. ```xml theme={null} ``` *** ## Rates `OTA_TourActivityAvailRS` with `Target="Rates"`. Used to communicate **amounts**, **pricing base** (per person / per group), **brand-specific rates**, pickup scope for transfer services, and **participant policies**. ### Skeleton ```xml theme={null} PerPerson ``` ### Technical Notes (Pricing & Policies) * **`PricingType`**: * `PerPerson`: multiply by pax that fall into priced participant categories. * `PerGroup`: amount covers a whole **group window** (see Policies). * If booking pax exceed `MaxParticipants`, compute **multiple units** (ceil division). * **Brand-specific pricing**: * Presence of `` means **rate applies only to those brands**. * **Override rule**: brand-specific beats generic for matching conditions. * **Policies / Participant windows**: * Expressed via **age ranges** and **Min/MaxParticipants**. * If only ADT policies are present, you effectively signal **adult-only** experiences; CHD/INF ranges can be omitted entirely when not permitted. > [!WARNING] > > **Authoritative price & availability** are those returned by **`OTA_TourActivityBookRQ/RS`** at booking time. Do **not** commit to fixed prices solely from notifications or search responses. *** ## Transactional Flow Hints (OTA\_TourActivityRQ/RS) While this page shows push **RS** envelopes, the same structures carry over to the **transactional pull** flow: 1. **Search/Price**: `OTA_TourActivityAvailRQ/RS` * Request filters by **TourActivityID**, **date**, **pax composition (ages)**, optional **brand**, and **pickup** scope. * Response mirrors **Schedule**, **Pricing**, **Policies**, and (for transfers) **PickupDropoffs**. 2. **Book**: `OTA_TourActivityBookRQ/RS` * Send the selected **date**, **pax detail (ages)**, **pickup** (if required), and any **brand** context used in pricing. * RS confirms inventory, final price, and returns **record locator**. 3. **Retrieve/Cancel**: `OTA_TourActivityResRetrieveRQ/RS` and `OTA_CancelRQ/RS` (when supported). > [!TIP] > > When computing eligibility for a date, apply **OperationTime → Release → Allotment** in that order. For price, apply **brand override**, then **PricingType math** (`PerPerson` vs `PerGroup`), then **policies**. *** ## Packaging Notes * **Pre-package**: Combine multiple services (e.g., **hotel + rent-a-car**) under a single offer. * **Dynamic package**: Compose at runtime. * Car packages: use **Inventory Block Codes** (ACRISS-based). *** # EDF Source: https://docs.axisdata.net/pushmodel/hotelEDF This page provides a high-level summary of EDF notifications for hotel inventory, rates, and allotment. ## Introduction EDF (Einheitliches Daten Format) is a component-based XML format for exchanging travel product data between tour operators and distributors. It ensures accuracy, detail, and speed in delivering travel offers. EDF supports two main notification types: * **EDF\_HOTEL**: Delivers inventory and rates information. * **EDF\_ALLOTMENT**: Delivers daily allotment (availability) information. EDF also supports detailed product attributes using DRV GlobalTypes for uniform descriptions. ## Product Identification Each notification includes a header with key product identifiers: * Hotel Code * FileKey and FileKeyCombination (for seasonal transitions). * ProgramType (optional, for booking requirements). * Source (origin of the product, optional). * TourOperatorCode (mandatory for bookings). > [!NOTE] > > Source and TourOperatorCode should be mapped on the client side. ## Packaging EDF supports both pre-packaged and dynamic package models: * Pre-packaged: Combines multiple services (e.g., hotel + car rental) into a single offer. * Dynamic: Allows flexible combinations at booking time. Car packages use inventory block codes and follow the ACRISS standard. ## Allotment Allotment files define room availability and distribution strategy: * **Strategy**: Can be by “Arrival” or “Stay” (default is Stay). * **Pattern**: Indicates daily availability using codes (0-9, \*, R, S). * `*`: More than 9 rooms available (free sale) * `0`: Not available * `R`: On request * `S`: Stop sale > [!NOTE] > > Check official documentation for the full list of pattern codes and usage. * **PatternLength**: Controls the length of the pattern string. * **Delta**: Indicates if the file is a full stock delivery (`Delta="false"`) or a delta update (`Delta="true"`). > [!WARNING] > > A full stock delivery must be performed once per day before sending delta updates. Delta files only update the specified dates, rooms, or boards. Hotels can be deactivated by sending an allotment update with all days set to stop sale. ## Inventory and Rates EDF Hotel files contain two main blocks: Basic Data and Selling Data. ### Basic Data Includes: * Hotel name, chain, codes (Giata, IFF), address, geolocation * Arrival/departure airports, transfer info, hotel attributes, reviews ### Selling Data Includes: * Season labels and definitions * Currency (ISO 4217 code) * Rounding rules for prices * Extras (offers, incentives, charges, included services) * Restrictions (stop sales, min/max stays, fixed arrival days, etc.) * Rooms (descriptions, occupancies, possible boards, prices) * Boards (board types, global codes for unified search) * ChargeBlocks (price calculation, board/guest charges, reductions) > [!NOTE] > > Check official documentation for XML structure, attribute details, and code examples. ### Key Concepts * **ChildrenAgeOrder**: Controls how child discounts are applied (ascending/descending by age). * **Occupancies**: Defines min/max guests, adults, children, infants per room. * **ChargeBlocks**: Assign prices by season, board, guest type, and apply reductions or supplements. > [!TIP] > > Use consistent currency codes and season definitions for accurate pricing and mapping. *** For technical details, XML samples, and attribute definitions, please refer to the official documentation. # Flat File Source: https://docs.axisdata.net/pushmodel/hotelFF ## Introduction The OTS FlatFile is developed to allow customers to store a limited set of prices and availability without any calculation logic. As portfolio is client-specific and client-specific, marketing actions, guarantees, etc. need to be considered, the OTS FlatFile can only be used for the ClientID it has been generated for. It is meant as an immediately searchable cache file. Three versions available: * **Version 1**: Without RatePlans. * **Version 2**: Accommodates RatePlans. * **Version 3**: Extended RoomCodes (30 chars) and RateplanCodes (20 chars). The file format provides for all hotels in the client portfolio, all rooms and boards available, end-prices for all arrival dates, all occupancies, and all possible length of stays up to 28 days. This results in an extreme volume of data. **Example calculation:** * 5,000 hotels * Average 3 room types * Average 3 boards * Lengths of stay: 25 (3–28) * Arrival days: 330 (not all hotels have a valid contract for a full year) * Adults: 1–3 (2.6 used for calculation) * Children: 1 of 5 years old (1.7 used for calculation) This can result in over 1.6 billion lines per delivery if all hotels have availability for all arrival dates. > [!NOTE] > > FlatFile is not suitable for systems that must produce search results for any occupancy or child age outside the agreed parameters. For more flexibility, use the Notification based model. Before installation, limitations are agreed with the client to limit data size and focus on relevant concepts. For example, only certain lengths of stay or occupancies may be included. ### Delta deliveries From Q2 2026, FlatFile allows delta deliveries. **File Logic** * When delta deliveries are active, **one FlatFile per hotel** is sent at every delivery (full or delta), instead of one FlatFile for the whole portfolio. * A delta delivery is a zip containing one file per **changed** hotel. * The expected frequency when working with deltas is a weekly full and a couple of delta deliveries a day. * An individual hotel file from a delta should substitute the previous file from that hotel and all its rates. * A hotel **deactivation** will be shown with an empty file. ## FlatFile Schedule Parameters | Parameter | Value | Description | | :- | :- | :- | | JobName | NOTIFY\_OTSFF\_CLIENTID | | | Client | TEST | ClientID | | Version | 01 or 02 or 03 | 01: no RatePlans, 02: Roomcode 20 chars + RatePlan 10 chars, 03: RoomCode 35 chars + RatePlan 20 chars | | StartDate | Today+1 | First arrival date included | | EndDate | Today+200 | Last arrival date included (max 365) | | FtpActive | TRUE | Send by FTP active | | FtpServer | sftp.axisdata.net | FTP for delivery | | FtpDir | / | FTP directory for delivery | | MinAdt | 2 | Start range of Adults to be included | | MaxAdt | 2 | End range of Adults to be included | | MinChd | 0 | Start range of Children to be included | | MaxChd | 0 | End range of Children to be included | | ChdAge | 5 | Age used to compute the price of children | | MaxAdtChd | 4 | Max number of pax (Max=6) | | SearchType | See below | See below | | SpecificBoards | SC, RO, AI, AI+ | Only generate lines for these boards | | Durations | 3,4,7,10,13,14,15,21 | Lengths of stays included (max 10) | | OffersSpecified | True/False | Adds 5 chars to each line to identify offers applied | | StatusEmail | [client@client.com](mailto:client@client.com) | Email notification upon finishing | ### SearchType Parameter The SearchType parameter is used to control the size of the file and filter offers that may be irrelevant for certain consumers. It's possible values are: * **AllUnits**: Generates the FlatFile as it is, with all possible offers following the rest of the parameters. * **CheapestStockUnit**: For every Product + Occupancy + Duration + Dates, only the cheapest offer is sent. It sends one room and board per hotel. * **CheapestSubServiceUnit**: For every Product + Occupancy + Duration + Dates, the cheapest offer for each board is sent. It sends one room and all boards per hotel. ### OffersSpecified Parameter The specified offers are shown as numbers. The mapping table is the following: Map.entry("EBO", "1"), // Early Booking Offer Map.entry("EBR", "2"), // Rolling Early Booking Offer Map.entry("FSO", "3"), // Free Stay Offer Map.entry("LSO", "4"), // Long Stay Offer Map.entry("MSO", "5"), // Minimum Stay Offer Map.entry("FBU", "6"), // Free Board Upgrade Map.entry("SPO", "7"), // Special Offer Map.entry("DPO", "8"), // Special Date Offers Map.entry("LMO", "9"), // Last Minute Offer Map.entry("AOO", "A"), // Adult Offer Map.entry("COO", "C") // Child Offer | Code | FF Value | Description | | :- | :- | :- | | EBO | 1 | Early Booking Offer | | EBR | 2 | Rolling Early Booking Offer | | FSO | 3 | Free Stay Offer | | LSO | 4 | Long Stay Offer | | MSO | 5 | Minimum Stay Offer | | FBU | 6 | Free Board Upgrade | | SPO | 7 | Special Offer | | DPO | 8 | Special Date Offers | | LMO | 9 | Last Minute Offer | | AOO | A | Adult Offer | | COO | C | Child Offer | *** ## FlatFile Structure ### V03 (RatePlan + Multicontracting) Separated RatePlan | Field Number | Field | Length | From Pos | To Pos | Type | Mandatory | | :- | :- | :- | :- | :- | :- | :- | | 01 | Version number | 2 | 1 | 2 | INT | Y | | 02 | Action | 1 | 3 | 3 | CHAR | Y | | 03 | Offer Number | 10 | 4 | 13 | CHAR | Y | | 04 | Hotel code | 17 | 14 | 30 | CHAR | Y | | 05 | Room code | 35 | 31 | 65 | CHAR | Y | | 06 | RatePlan code | 20 | 66 | 85 | | | | 07 | Board code | 3 | 86 | 88 | CHAR | Y | | 08 | Arrival date | 10 | 89 | 98 | DATE | Y | | 09 | Length of stay | 2 | 99 | 100 | INT | Y | | 10 | Occupancy total | 1 | 101 | 101 | INT | Y | | 11 | Occupancy ADT | 1 | 102 | 102 | INT | Y | | 12 | ADT1 age | 2 | 103 | 104 | INT | N | | 13 | ADT2 age | 2 | 105 | 106 | INT | N | | 14 | ADT3 age | 2 | 107 | 108 | INT | N | | 15 | ADT4 age | 2 | 109 | 110 | INT | N | | 16 | Occupancy CHD | 1 | 111 | 111 | INT | Y | | 17 | CHD1 age | 2 | 112 | 113 | INT | N | | 18 | Occupancy INF | 1 | 114 | 114 | INT | Y | | 19 | INF age | 1 | 115 | 115 | INT | N | | 20 | Price | 12 | 116 | 127 | CURR | Y | | 21 | Currency | 3 | 128 | 130 | CHAR | Y | | 22 | Remaining rooms | 2 | 131 | 132 | INT | Y | | 23 | Offers applied | 5 | 133 | 137 | CHAR | N | ### V03 (RatePlan + Multicontracting) Concatenated RatePlan | Field Number | Field | Length | From Pos | To Pos | Type | Mandatory | | :- | :- | :- | :- | :- | :- | :- | | 01 | Version number | 2 | 1 | 2 | INT | Y | | 02 | Action | 1 | 3 | 3 | CHAR | Y | | 03 | Offer Number | 10 | 4 | 13 | CHAR | Y | | 04 | Hotel code | 17 | 14 | 30 | CHAR | Y | | 05 | Room + Rateplan code | 55 | 31 | 85 | CHAR | Y | | 06 | Board code | 3 | 86 | 88 | CHAR | Y | | 07 | Arrival date | 10 | 89 | 98 | DATE | Y | | 08 | Length of stay | 2 | 99 | 100 | INT | Y | | 09 | Occupancy total | 1 | 101 | 101 | INT | Y | | 10 | Occupancy ADT | 1 | 102 | 102 | INT | Y | | 11 | ADT1 age | 2 | 103 | 104 | INT | N | | 12 | ADT2 age | 2 | 105 | 106 | INT | N | | 13 | ADT3 age | 2 | 107 | 108 | INT | N | | 14 | ADT4 age | 2 | 109 | 110 | INT | N | | 15 | Occupancy CHD | 1 | 111 | 111 | INT | Y | | 16 | CHD1 age | 2 | 112 | 113 | INT | N | | 17 | Occupancy INF | 1 | 114 | 114 | INT | Y | | 18 | INF age | 1 | 115 | 115 | INT | N | | 19 | Price | 12 | 116 | 127 | CURR | Y | | 20 | Currency | 3 | 128 | 130 | CHAR | Y | | 21 | Remaining rooms | 2 | 131 | 132 | INT | Y | | 22 | Offers applied | 5 | 133 | 137 | CHAR | N | ### V02 (RatePlan 10 chars, Room code 20 chars) | Field Number | Field | Length | From Pos | To Pos | Type | Mandatory | | :- | :- | :- | :- | :- | :- | :- | | 01 | Version number | 2 | 1 | 2 | INT | Y | | 02 | Action | 1 | 3 | 3 | CHAR | Y | | 03 | Offer Number | 10 | 4 | 13 | CHAR | Y | | 04 | Hotel code | 17 | 14 | 30 | CHAR | Y | | 05 | Room code | 20 | 31 | 50 | CHAR | Y | | 06 | RatePlan code | 10 | 51 | 60 | | | | 07 | Board code | 3 | 61 | 63 | CHAR | Y | | 08 | Arrival date | 10 | 64 | 73 | DATE | Y | | 09 | Length of stay | 2 | 74 | 75 | INT | Y | | 10 | Occupancy total | 1 | 76 | 76 | INT | Y | | 11 | Occupancy ADT | 1 | 77 | 77 | INT | Y | | 12 | ADT1 age | 2 | 78 | 79 | INT | N | | 13 | ADT2 age | 2 | 80 | 81 | INT | N | | 14 | ADT3 age | 2 | 82 | 83 | INT | N | | 15 | ADT4 age | 2 | 84 | 85 | INT | N | | 16 | Occupancy CHD | 1 | 86 | 86 | INT | Y | | 17 | CHD1 age | 2 | 87 | 88 | INT | N | | 18 | Occupancy INF | 1 | 89 | 89 | INT | Y | | 19 | INF age | 1 | 90 | 90 | INT | N | | 20 | Price | 12 | 91 | 102 | CURR | Y | | 21 | Currency | 3 | 103 | 105 | CHAR | Y | | 22 | Remaining rooms | 2 | 106 | 107 | INT | Y | | 23 | Offers applied | 5 | 108 | 112 | CHAR | N | ### V01 (No RatePlan, Room code 10 chars) | Field Number | Field | Length | From Pos | To Pos | Type | Mandatory | | :- | :- | :- | :- | :- | :- | :- | | 01 | Version number | 2 | 1 | 2 | INT | Y | | 02 | Action | 1 | 3 | 3 | CHAR | Y | | 03 | Offer Number | 10 | 4 | 13 | CHAR | Y | | 04 | Hotel code | 17 | 14 | 30 | CHAR | Y | | 05 | Room code | 10 | 31 | 40 | CHAR | Y | | 06 | Board code | 3 | 41 | 43 | CHAR | Y | | 07 | Arrival date | 10 | 44 | 53 | DATE | Y | | 08 | Length of stay | 2 | 54 | 55 | INT | Y | | 09 | Occupancy total | 1 | 56 | 56 | INT | Y | | 10 | Occupancy ADT | 1 | 57 | 57 | INT | Y | | 11 | ADT1 age | 2 | 58 | 59 | INT | N | | 12 | ADT2 age | 2 | 60 | 61 | INT | N | | 13 | ADT3 age | 2 | 62 | 63 | INT | N | | 14 | ADT4 age | 2 | 64 | 65 | INT | N | | 15 | Occupancy CHD | 1 | 66 | 66 | INT | Y | | 16 | CHD1 age | 2 | 67 | 68 | INT | N | | 17 | Occupancy INF | 1 | 69 | 69 | INT | Y | | 18 | INF age | 1 | 70 | 70 | INT | N | | 19 | Price | 12 | 71 | 82 | CURR | Y | | 20 | Currency | 3 | 83 | 85 | CHAR | Y | | 21 | Remaining rooms | 2 | 86 | 87 | INT | Y | | 22 | Offers applied | 5 | 88 | 92 | CHAR | N | *** ## FlatFile Details * **Version number**: Current version is 03. Older versions available for backward compatibility. * **Record format / Action**: * I: insert * U: update (partial) * D: delete * F: full update (replace) * **PriceLine number**: Unique per provider. * **Hotel code**: 17 chars, may have empty spaces for shorter codes. * **Room code**: Assembled from room characteristics (type, grade, view, etc.). * **RatePlan code**: Assembled from RatePlan characteristics (type, group, refundability, etc.). * **Board code**: Defines meal plans (e.g., Half Board, All Inclusive). * **Arrival date**: yyyy-mm-dd * **Length of stay**: 2 chars, e.g., 08 for 8 nights. * **Occupancy**: Total, adults, children, infants, with ages. * **Price**: Currency, right-aligned, 2 decimals. * **Remaining rooms**: Number of free hotel units at the time the PriceLine was produced. * **Offers applied**: Specification of offers applied in this PriceLine. ### Offer Codes Table [Check our codes -> Price Breakdown Codes](../glossary/codes#price-breakdown-codes) *** ## Examples When developing the FlatFile, always request an example file generated with your parameters from our INT environment to test the full flow, including making Quotes to test price consistency. *** ## Generation Report via Email Clients can receive daily generation emails with a list of hotels included in the generation. The email contains: * Type of generation * Status (Success/Error) * Additional info/Errorcode * Parameters (Client, Stock group, Boards, Dates, Durations, Min/Max adt/chd, Max pax, Chd age, Offers version, Search type, Offers specified) * FTP Transfer Details (Server type, Host, Username, Output filename, File size, Transfer times and speeds) * Operation Details (Threads, Parts, Compression, Download/Processing/Generation times and speeds) * Report (Searched stocks, Emitted stocks, Emitted datasets) *** > [!NOTE] > > For any implementation, coordinate with Axis Data to define the exact FlatFile parameters and structure for your use case. # OTA Source: https://docs.axisdata.net/pushmodel/hotelOTA This page summarizes how Axis Data’s **OTA-based notifications** work in a push model. ## Introduction Axis Data supports a **push** integration where product changes are delivered to partners using standard **OpenTravel Alliance (OTA)** messages. The OTA spec is maintained by OpenTravel and is updated twice per year ("A" and "B" releases). > [!TIP] > > Useful reference: OpenTravel’s Model Viewer and schemas are available from the OpenTravel website. Whenever you see protocol/message names or field-level details, treat them as pointers and **Check official documentation**. ## Message Types ### Inventory **Purpose** Gives the partner a clear picture of **what a property sells**: room types, board types, extras, amenities and descriptive content used for mapping and display. **Delivery Process** * Sent as notifications per property, both for initial load and when updates occur. Many partners still receive a daily full set; **delta inventory** is recommended so you only process what changed. * When anything in the property’s contracted services changes (rooms, boards, extras, occupancy periods, amenities), a **delta** may push a **full inventory snapshot for that property** so you can re‑evaluate what to keep on sale. **Essentials** * **Rooms, Boards, Extras, Amenities** are the core groupings you’ll map on your side. * **Non‑refundable rooms** are explicitly indicated and should be flagged in your UI/UX. * **Occupancy rules** (e.g., age ranges, total occupancy, excluded combinations) exist per period; infants may or may not count depending on the contract. * **Extras payable on arrival** (tourist taxes, safe boxes, heating, etc.) may be listed with amounts and whether they are obligatory or optional; these are **not** included in price and must be shown as information. * **Deactivated** inventory indicates a property is removed from the partner portfolio (permanent removal on your side only if agreed). * **Car packages**: Some rooms include a car; the hotel code may include a two‑letter extension (e.g., **AR**) and a **car inventory code** may be present. **Content Pull Option** * You can optionally pull non‑bookable content via **Hotel/Product Descriptive Info** and/or receive periodic pushes (full monthly + daily deltas) in agreed languages. ### Allotment **Purpose** Communicates **when** each room/board combination is open, closed, on request, or free‑sale, either over **date ranges** or **day‑by‑day**. **Availability Logic** * Two models, **range‑based open/close** or **per‑day remaining allotment** are using standard codes (e.g., on‑request, stop‑sale, free‑sale). * Availability can be tracked at **room + base board** level; if you cannot handle this combination, AxisData can send a simplified status at room level only. * **Stop‑sale by board** is possible either across all rooms or for specific rooms. **Delta Behavior** * Messages distinguish **baseline** vs **incremental** updates; deltas overlay the last baseline. A persistent **stop‑sale** may be reflected in baseline as a general close without dates. Apply deltas **in order** to get the final picture. **Also Supported** * **Car packages** can be controlled here too via inventory block codes. ### Rates **Purpose & Important Caveat** Rateplan notifications provide **price guidance** and rules (booking windows, LOS, supplements, offers), primarily for **packagers** who need prices to build packages and manage product. **Only the real‑time booking response is authoritative for availability and final payable amount**. Partners must not commit to fixed selling prices based on notifications or searches. > [!WARNING] > > Treat rate notifications as **informational**. Validate at booking time before confirming to customers. **Rateplan Breakdown (High Level)** * **Basic rates** for the product (usually a room type + board) over defined seasons/periods. * **Booking rules** like minimum stays, closed arrivals/departures, and selling windows. * **Supplements & extras** such as additional adults/children, board upgrades, gala dinners, or per‑stay/per‑person charges. * **Promotional offers** (e.g., early booking discounts, free nights, upgrades), with compatibility rules and application order. * **Deactivation**: Empty rate plans can signal a property going temporarily off‑sale; keep mapping, expect future rates. **Important Identifiers** * **Room code + RatePlan code combined** (e.g., `roomcode;rateplancode`) may appear in notifications and real‑time messages. * **InvCode** (room + base board) helps detect included board in the base rate. **Special Cases** * **Rate overrides** can temporarily supersede base rates for defined booking/arrival windows. * **Application units** (per person/night, per room/stay, per week, etc.) exist for both extras and offers. * **Car packages** (rooms including a car) can be priced via extras/supplements or controlled as inventory blocks. ## Common Scenarios & Tips * **Rooms with different base boards by season** (e.g., HB instead of BB in high season). Expect search/price responses to reflect what’s actually sold in that period. * **Non‑refundable rooms** should be clearly labeled in your UI and excluded from flexible cancellation logic. * **Extras payable on arrival**: Show these transparently; do not bake them into package prices. * **Day‑by‑day allotment**: On‑request, stop‑sale, and free‑sale are standard states—make sure your search UX reflects them. *** ### Message Names (Reference) * Inventory: **OTA\_HotelInvNotifRQ/RS** * Allotment: **OTA\_HotelAvailNotifRQ/RS** * Rates: **OTA\_HotelRatePlanNotifRQ/RS** # OTDS Source: https://docs.axisdata.net/pushmodel/hotelOTDS This page provides a high-level summary of OTDS notifications for hotel inventory, rates, and allotment. ## Introduction OTDS (Open Travel Data Standard) is an XML-based format for exchanging travel product data between tour operators and distributors. It is designed for accuracy, consistency, and extensibility. OTDS notifications are used to populate caches or redistribute supplier data. Updates can be sent as full deliveries or as deltas for changes only. OTDS supports two main notification types: * **Rates & Allotment**: Delivers inventory and rates information upon contract update. * **Allotment Only**: Delivers only availability updates following bookings, cancellations, or allotment changes. DRV GlobalTypes are used for uniform descriptions of touristic attributes. > [!NOTE] > > Check official documentation for XML structure, attribute definitions, and integration details. ## Integration Process * Clients receive a static OTDS dataset for integration testing. * Full notifications are sent weekly; delta updates are sent every 15 minutes for changes. * Delta updates always include all data for a changed contract to simplify replacement logic. > [!TIP] > > Use the integration environment to validate pricing and booking flows before going live. ## Common Information Each notification includes: * Product identifiers * Accommodation details (name, type, address, etc.) * SellingAccom elements for rates and availability. * Availabilities for allotment-only updates. > [!NOTE] > > Check official documentation for header structure and element definitions. ## Rates & Inventory Rates and inventory details are provided in SellingAccom blocks: * Boards (meal plans) * RatePlans * Basic rates, supplements, and offers. * Occupancy rules (min/max guests, adults, children, infants) * PriceItems for base rates, discounts, extras, and taxes. > [!NOTE] > > Offers can include early booking discounts, child reductions, and special date promotions. * Combinatorics define which PriceItems can be combined or excluded. * Reductions and overrides allow flexible pricing logic. * Amenities and property details are included in the Accommodation section. > [!NOTE] > > Check official documentation for conditions, combinatorics, and XML examples. ## Allotment Allotment notifications manage availability: * MainAvailabilities and SubAvailabilities show open, closed, or on-request status per day. * CloseSales indicates stop sales for specific dates, boards, or units. * Close Arrival/Departure enforces mandatory check-in or check-out dates. * Delta allotment updates only override specified dates, rooms, or boards. > [!WARNING] > > A full stock delivery must occur daily before sending delta updates. Deltas only update the specified data. > [!NOTE] > > Check official documentation for patterns, conditions, and XML samples. *** For technical details, XML samples, and attribute definitions, please refer to the official documentation. # Push NBC Source: https://docs.axisdata.net/pushmodel/nbcOTA You can receive **static content** and **Non-Bookable Content (NBC)** for excursions in the **same XML format** as the transactional OTA\_TourActivityRQ/RS messages. Instead of being returned in response to a real-time request, this static content is delivered as a **notification** (push) file. The structure, nodes, and data fields are identical to those used in transactional messages, making it easy to process and integrate static product information, descriptions, and amenities alongside your live pricing and availability feeds. > [!NOTE] > > Static content and NBC push notifications allow you to keep your excursion product catalog up-to-date with the same schemas and logic as your transactional integration. > [card] [Accommodation NBC](/hotel/mappingRS) > [card] [Product NBC](/excursion/mappingXARS) # Introduction Source: https://docs.axisdata.net/pushmodel/pushintro Please check this overview of all supported notification formats for distributing hotel, excursion, and transfer data to partners and clients. Our notification ecosystem is designed to support a wide range of integration needs, from real-time transactional flows to high-volume cache files and static content updates. All formats are designed for automation, reliability, and compatibility with industry standards. *** ## Examples An example for every of our formats is available at [Resources](../resources/downloadables#notification-examples). The examples can be useful to see how our message is implemented, which components from the official schemas are mostly used, etc. If more detailed examples are needed, contact Integrations. The examples produced are all for the same hotel, transfer and tour activity. They contain the most common scenarios for a contract: * Base rates. * Extras & Offers. * Board and Pax Supplements. * Rate Overrides. * Open and closed allotments. * Min stay, release and other rules. ## Common Information * **Push Model**: Most notifications are delivered as push files (via FTP/SFTP), either as full data sets or as deltas (incremental updates). * **Notification Frequency**: Full notifications are typically sent weekly or monthly; deltas can be as frequent as every 15 minutes. * **Customization**: Many formats allow for client-specific tailoring (e.g., FlatFile, EDF). * **Static Content**: Non-bookable content (NBC) and static product descriptions can be pushed in the same structure as transactional messages. * **Specifications and Schemas**: OTA, EDF and OTDS notifications are based on the official formats. Check [Specifications and Schemas](../glossary/specs) *** ## Supported Notification Formats ### **OTA Notifications** * **Hotel** and **Excursion** support. * Message/Files used: `OTA_HotelInvNotifRQ/RS`, `OTA_HotelAvailNotifRQ/RS`, `OTA_HotelRatePlanNotifRQ/RS`, `OTA_TourActivityAvailRQ/RS`, `OTA_TourActivityBookRQ/RS`. * Supports full and delta updates for inventory, rates, and availability. * Static content and NBC can be pushed in the same XML structure as transactional messages. ### **EDF** * Developed by Peakwork for hotel data. * Highly structured XML for inventory, rates, and allotment. * Includes DRV GlobalTypes for standardized product attributes. * Supports both full and delta notifications. ### **OTDS** * XML-based, developed by OTDS Verein. * Used for hotel data (rates, inventory, allotment). * Supports full and delta notifications. ### **FlatFile Notifications** * High-volume, line-based cache files for hotel inventory, rates, and allotment. * Multiple versions (with/without RatePlans, extended code lengths). * Fully technical, with detailed field grids and parameterization. * Ideal for advertising systems and large-scale cache/search solutions. * Not rule-based. ### **TransferEDF** * Proprietary Peakwork format for distributing transfer product data. * Structured similarly to other EDF notifications. * Contact us for details and integration options. *** ## Additional Capabilities * **Static Content & NBC Push**: Receive static product descriptions and non-bookable content in the same format as transactional messages, delivered as notifications. * **Packaging Support**: All major formats support both pre-packaged and dynamic packaging models. * **Brand/Partner Customization**: Many formats allow for brand-specific rates, policies, and content. *** ## Notification Cadence * **Full Notifications**: complete data sets (e.g., all inventories/rates/availabilities) for an agreed future window (commonly **12–18 months**). * **Delta Notifications**: only the changes since the last full set—for example, stock changes for affected dates or updated rates for an affected property/season. * **Typical Schedule**: full sets no more than **once per week** (often monthly); **deltas every 15 minutes** during daytime and **hourly overnight** (CET). ### Delta Deliveries Deltas are sent on top of the last full baseline and must be **applied in order of reception** to achieve the correct end state. *** ## Suggested Implementation Steps **1. Choose Ingestion model** Agree the **notification format** and whether you’ll process **full + delta** or **delta‑only** after initial load. **2. Map Properties & Products** Map hotels, rooms, boards, and extras from inventory notifications and (optionally) descriptive content pulls. Avoid hard‑coding assumptions; re‑evaluate selections when a delta sends a **full snapshot** for a property. **3. Apply Availability Updates Correctly** Treat the latest **baseline** as ground truth and **apply deltas in order**. Stop‑sales may appear in baseline as undated closes while they persist. **4. Respect Booking Rules & Price Logic** Use notifications for **price guidance** only. Validate **final price & stock** via real‑time booking before you confirm or collect payment. **5. Handle Deactivations & Removals** A **deactivated rateplan** usually means no future contract is currently active (keep your mapping). A **deactivated inventory** means the property left your portfolio (remove only if agreed with your PM). *** ## Getting Started * Review the dedicated pages for each format for technical details, message structures, and integration tips. * For static content and NBC, see the dedicated static content push page. > [!NOTE] > > If you have questions about which format fits your needs best, or require a custom integration, please contact our integrations team. # Transfer Source: https://docs.axisdata.net/pushmodel/transferEDF ## TransferEDF Notifications We also offer **TransferEDF notifications**, a format developed and owned by PeakWork. These notifications provide structured data for transfer products, using the same principles as other EDF-based notifications. If you require transfer product integration or want to learn more about TransferEDF, please contact us for details or check the official PeakWork documentation. > [!NOTE] > > TransferEDF is a proprietary PeakWork format for distributing transfer product data in a standardized, machine-readable way. # Useful Resources Source: https://docs.axisdata.net/resources/downloadables This page groups all the downloadables that may be useful for an integration: * **Postman Collection**: Our own Postman collection containing all messages with different scenarios. * **Notification Examples**: A .zip containing Push Model notification files for all our formats. * **Mapping Codes**: Tables with our mapping codes in developer-friendly formats. * **Certification**: Our certification document to go live. > [!NOTE] > > The downloadables work via our AWS S3 bucket ## Postman Collection Download our Postman Collection [Click here to download](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/AxisData_Postman.zip) ### RatePlanToken API Download the Postman Collection for the [RateplanToken API](../rptoken/rptoken-introduction) [Click here to download](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/RatePlanToken_Postman.zip) ## Notification Examples Download a zip folder containing an XML file of each notification type: * **OTA Hotel** * Inventory * Allotment (With and without pattern) * Rates * **EDF** * Hotel (Rates and Inventory) * Allotment * Transfer * **OTDS** * One file, includes hotel, availability and inventory. * **OTA Excursion** * Rates * Allotment * **FlatFile** -> Not downloadable due to size. If needed contact with Integrations. * **NBC files** -> Not attached. They are equivalent to the pull responses. [Click here to download Zip](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/push_samples.zip) > [!TIP] > > If any specific scenarios needed at the examples, contact Integrations ## Mapping codes Download all our mapping codes in Excel or CSV format. > [!NOTE] > > The CSV format is a zip that contains one file per table [Click here to download Excel](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/mapping_codes.xlsx) [Click here to download CSV Zip](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/mapping_codes_csv.zip) On a separate note, room codes table is very large and more commonly updated. See this file appart with all the updated room codes only: [Click here to download Room codes](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/Room_Mapping.xlsx) ## Certification Document Our certification document template, which needs to be fullfilled before going live with our API. Always get in contact with Integrations and Account Managers when wanting to go live. ### Direct Connection [Click here to download](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/Certification_Worksheet_Direct_Integration.zip) ### Connection via Certified Platform [Click here to download](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/Certification_Worksheet_Client_with_Certified_Platform.zip) ### Dynamic Inventory Certification [Click here to download](https://s3-bucket-production-downloadabledocs-f9b9.s3.eu-central-1.amazonaws.com/Certification_Worksheet_Direct_Integration_DynamicInventory_RateplanToken.zip) # RatePlanToken Book RQ Source: https://docs.axisdata.net/rptoken/rptoken-bookRQ The Book functionality for our RatePlanToken product is directly based on our original OTA\_HotelResRQ/RS. The request message is almost identical to the classic model. ## Purpose * Quote Room Stays retrieved from RatePlanToken Search. * Commit/Book Room Stays from our RatePlanToken portfolio. * Receive confirmation of the booking with relevant information of it. ## Details and Structure All the details regarding this message can be found at [OTA\_HotelResRQ](../hotel/bookRQ). The Booking for RatePlanToken products has to be done using the RatePlanToken, retrieved from the [Search Response](./direct-searchRS#booking-code). ### RatePlanToken This code, once retrieved from **Search** Response and stored, needs to be used in the **Quote** request as follows: ```xml theme={null} ... ... ``` **Important:** The **Quote** response may return a different RatePlanToken than the one returned in the Search and used to Quote. To **Commit** a booking, it is important to include the most recent **Quote Response RatePlanToken**. The system will then check if the code is correct and use it to link the rate to the one retrieved at the search step. ## Differences with classic Hotel Book The structure of the message is exactly the same as [OTA\_HotelResRQ](../hotel/bookRQ) plus the RatePlanToken, but there are some features that are not available. ### What's not included * [Optional Extras](../hotel/bookRQ#tpa-extensions) are not available for RatePlanToken Hotels. All other elements and their rules are equivalent to the traditional booking flow. ## Complete Examples ```xml Basic expandable theme={null} Mr Bender Bending Mrs Angelina Bending late arrival - flight lands at 22:55 local time ``` # RatePlanToken Book RS Source: https://docs.axisdata.net/rptoken/rptoken-bookRS The Book functionality for our RatePlanToken product is directly based on our original OTA\_HotelResRQ/RS. The request message is almost identical from the classic model. ## Purpose * Confirm successful processing (``) or return error diagnostics (``). [Error Scenarios](../glossary/errors). * Return one `HotelReservation` with one `RoomStay` item, linked `ResGuests`, and booking-level context under `ResGlobalInfo`. * **Quote** (`ResStatus="Quote"` in the request): verify availability, totals, and cancellation policy without creating a reservation ID at Axis Data (the client reference is echoed). * **Commit** (`ResStatus="Commit"` in the request): create a binding booking if accepted, with cancellation penalties per contract. ## Details and Structure All the details regarding this message can be found at [OTA\_HotelResRS](../hotel/bookRS). The Booking for RP Token products has to be done using the RatePlanToken, retrieved from the [Search Response](./rptoken-searchRS#rateplantoken). The Response will echo this RatePlanToken ### RatePlanToken This code, once requested in the Book Request will be echoed in the Booking Response as follows: ```xml theme={null} ... ... ``` ## Differences with classic Hotel Book The structure of the message is exactly the same as [OTA\_HotelResRS](../hotel/bookRS) plus the RatePlanToken. ### What's not included * [Optional Extras](../hotel/bookRS#extras) are not available for RatePlanToken Hotels. All other elements and their rules are equivalent to the traditional booking flow, including [Price Breakdown](../hotel/bookRS#ratedetails) usage. ### RatePlans and Multicontracting In this flow, rateplans and multicontracting are always included. The codes, in this case, will already be encoded inside the RatePlanToken and don't need to be used in the traditional "concatenated to room code" approach. The Rateplan code is needed to ensure a proper distribution of the rates. It will be visible in the booking confirmation in the following section, but it does not have to be used at the booking request. ```xml theme={null} ... ... ``` ### Taxes and Fees The Taxes and Fees are small rates or commisions that may be added to a booking if a contract requests it. There are three main types of Taxes and Fees: * **Mandatory**: They are treated as a supplement in the contract, and calculated as one in the booking. Visible in Price Breakdown. * **Included**: They are included in the hotel rate. They are visible under the Tax section as "Inclusive". * **Payable Locally**: Taxes for the customer to pay on spot. They are visible under the tax section as "Exclusive". ```xml theme={null} This is a mandatory tax included in the rate, total amount for the whole stay This is a mandatory tax included in the rate, value is per pax per night This is a mandatory tax NOT included in the rate (payable locally), total amount for the whole stay This is a mandatory tax NOT included in the rate (payable locally), expressed as a percentage of the total amount This is a mandatory tax NOT included in the rate (payable locally), expressed as a per pax per night value ``` The Code represents which type of Tax or Fee the element refers to. The Mapping of the codes is the following: **ChargeFrequency** uses OTA CHG codes: * 1 per night * 12 per stay * 18 per room per stay * 19 per room per night * 20 per pax per stay * 21 per pax per night **Code** uses OTA FTT codes: * 3 city tax * 6 federal tax * 30 country tax * 12 resort fee * 18 tourism tax * 27 miscellaneous * 5 energy tax * 36 VAT ## Complete Examples ```xml Basic expandable theme={null} Mr Bender Bending Mrs Angelina Bending ``` # RatePlanToken Cancel RQ Source: https://docs.axisdata.net/rptoken/rptoken-cancelRQ The Cancel functionality for our RatePlanToken product is directly based on our original OTA\_CancelRQ/RS. The request message is is almost identical to the classic model. ## Purpose This message is used to: * Cancel a whole booking. * Cancel an item of a booking. ## Details and Structure In the RatePlanToken API, it is important to differentiate the **Quote** and **Commit** for the Cancel request. ### Quote The **Quote** request works exactly the same as in [OTA\_CancelRQ](../bookingmgmt/bookCancelRQ). ### Commit The **Commit** structure is essentially the same as in [OTA\_CancelRQ](../bookingmgmt/bookCancelRQ). The **difference** is that for confirming a Cancelation, the **CancelToken** will be needed. This CancelToken will be returned in the Cancel Quote response. ```xml theme={null} ``` ## Complete Examples ```xml Quote expandable theme={null} ``` ```xml Commit expandable theme={null} ``` # RatePlanToken Cancel RS Source: https://docs.axisdata.net/rptoken/rptoken-cancelRS The Cancel functionality for our RatePlanToken product is directly based on our original OTA\_CancelRQ/RS. The request message is is almost identical to the classic model. ## Purpose This message is returned after a OTA\_CancelRQ. It is used to: * Return confirmation of a cancellation and its costs. * Return pre-confirmation of a cancellation and the CancelToken. ## Details and Structure In the RatePlanToken API, it is important to differentiate the **Quote** and **Commit** for the Cancel request. ### Quote The **Quote** response is essentially the same as in [OTA\_CancelRS](../bookingmgmt/bookCancelRS). The difference is that in the RatePlanToken API, this message returns the "CancelToken" as well. ### Commit The **Commit** response is also the same as in [OTA\_CancelRS](../bookingmgmt/bookCancelRS). The CancelToken is echoed here. ## Complete Examples ```xml Committed expandable theme={null} ``` ```xml Quote expandable theme={null} ``` # An introduction to Dynamic Inventory Source: https://docs.axisdata.net/rptoken/rptoken-introduction Beyond Static Inventory. The RatePlanToken seamlessly combines the speed of our intelligent cache with the depth and richness of real-time direct supplier connectivity. While our platform continues to leverage pre-aggregated hotel contracts, availability, and rates from leading channel managers, RatePlanToken goes one step further. Each search request dynamically reaches beyond our ecosystem and establishes live connections with carefully selected directly contracted and dynamic supply, unlocking an extended portfolio, exclusive rates, and real-time pricing and availability. The result is a single, unified response that blends the reliability of pre-validated and curated content with the power of real-time market access. By intelligently orchestrating multiple data sources behind the scenes, Rateplantoken delivers broader choice, greater pricing opportunities, and enhanced booking potential—all through a single API request. ## **Key Benefits** * **Expanded inventory** with real-time rates and availability * **Increased conversion potential** with broader product selection * **Single-point integration** with seamless response aggregation * **Optimized search performance** through intelligent source orchestration **RatePlanToken empowers travel businesses to access the widest possible marketplace—combining the efficiency of cached content with the limitless potential of live supplier connectivity.** ## RatePlanToken API To retrieve new products, our RateplanToken API needs to be used, this site shows all the details. ### Purpose The updated API will: * Retrieve all our products, directly contracted and dynamic supply via a RatePlanToken. * Change the authentication system, moving from in-message User and Password to API Key authentication. ### TEST Environment In order to develop and test the integration, our TEST/Integration Environment will be used. This environment uses the following URL: **Test URL:** `https://api-int.axisdata.net` **Authentication** The Authentication for this API consists of an API Key. This key needs to be sent at the header of the https requests. For all requests you have to send these Parameters in the header: * Accept: `application/xml` * Content-Type: `application/xml` * Key: `Authorization` * Value: `*The value of the token*` The API Key value for our TEST environment is the following: `jlEVcyDCEXYnmFOkGZ057NbMX7rpVRdoPKAswaVYS24` ### PRODUCTION Environment Once you have been successfully tested and certified in our INTEGRATION environment, our integration team coordinates the go-live. The API Key in the Production environment will be provided by our Integration Managers. The rest of the authorization data is the same as for the TEST environment. > [!CAUTION] > > **Important:** Never share credentials unless requested by an Integration Manager. Use encrypted email for passwords. * **Production URL:** `https://api.axisdata.net` Furthermore the access to our production systems is protected by a firewall. \ Our partners must provide their external IPs to be whitelisted on our side. Once this step is done you're ready to go live. Test the connectivity to the server by using this command: `curl https://api.axisdata.net` Or using the [OTA\_PingRQ](#checking-connectivity) described below. ## Endpoints This API will be based on REST, so different endpoints will be used for each message. * **OTA\_Ping**: `/ping` * **OTA\_HotelDescriptiveInfo**: `/hotel/nbc` * **OTA\_HotelAvailRQ**: `/hotel/search` * **OTA\_HotelResRQ**: `/hotel/book` ## **Checking Connectivity** Use `OTA_PingRQ` to verify connectivity. ### Ping Request ```xml theme={null} Connectivity test ``` **Response**: ```xml theme={null} Connectivity test ``` Use this to verify connectivity from new systems or endpoints. # RatePlanToken Mapping and NBC Source: https://docs.axisdata.net/rptoken/rptoken-mapping The NBC content is also available, which can be retrieved in the same way as the traditional booking flow. ## Purpose This message is used to: * Download **hotel lists** tied to one or more client feeds (`BrandCode`). These need to be mapped and used in the Search RQ. * Pull **details** for a single hotel (`HotelCode`). > [!NOTE] > > The logic of this message is the same as for the standard API booking flow. ## Hotel List Retrieval To retrieve all hotels, including the RatePlanToken products, the OTA\_HotelDescriptiveInfo message can be used in its **Hotel List** format. The usage of this message is explained at [HotelDescriptiveInfoRQ](..//hotel/mappingRQ#complete-examples) and [HotelDescriptiveInfoRS](..//hotel/mappingRS#complete-examples) ## NBC Retrieval To retrieve the NBC of a specific hotel, the OTA\_HotelDescriptiveInfo message can be used in its **Single Hotel** format. The usage of this message is explained at [HotelDescriptiveInfoRQ](..//hotel/mappingRQ#complete-examples) and [HotelDescriptiveInfoRS](..//hotel/mappingRS#complete-examples) ## Not Supported The following features are not supported for the RatePlanToken API: * Retrieve **facts & amenities** (STOCK template) or a hotel’s **room/board/occupancy mapping set** (SUMMARY template). * Perform **geo‑area search** (lat/lon + radius) and limit results via `MaxResponses`. * Request **delta** updates since a point in time using `LastUpdateDate`. # RatePlanToken Search RQ Source: https://docs.axisdata.net/rptoken/rptoken-searchRQ The Search functionality for our RatePlanToken product is directly based on our original OTA\_HotelAvailRQ/RS. The request message is essentially the same. ## Purpose This message is used to: * Search for available hotel rooms based on specific criteria. * Request rate information for available accommodations. * Query inventory across multiple properties or a single hotel. * Filter results based on guest requirements and preferences. * Retrieve both pre-aggregated hotel contracts and real-time market access. ## Details and Structure All the details regarding this message can be found at [OTA\_HotelAvailRQ](../hotel/searchRQ). This message works exactly the same. The RatePlanToken room stays will be returned with a RatePlanToken in the search RS, which will be needed at the booking step. ## Differences with classic Hotel Search The structure of the message is exactly the same, but the available optional features are less for these searches. ### What's not included * [Multi-Room logic](../hotel/searchRQ#multi-room-logic) is not yet available for RP Token Search. * Searching by [Hotel Name](../hotel/searchRQ#search-by-hotel-name) is not available. * Enrichment via [InfoSource](../hotel/searchRQ#infosource-attribute). Every response will be displayed as per InfoSource = 0. * [Area Search](../hotel/searchRQ#complete-examples) is not supported. * [CalendarView](../hotel/searchRQ#complete-examples) Search is not supported. * [Upfront Filtering](../hotel/searchRQ#upfront-filtering) is not supported. * Search by Location is still not available. ## Complete Examples ```xml Hotel expandable theme={null} ``` ```xml Hotel List expandable theme={null} ``` ```xml Efficient List expandable theme={null} ``` # RatePlanToken Search RS Source: https://docs.axisdata.net/rptoken/rptoken-searchRS The Search functionality for our RatePlanToken product is directly based on our original OTA\_HotelAvailRQ/RS. The response message is essentially the same with an extra attribute. ## Purpose * Confirm successful processing (``) or return error diagnostics (``). [Error Scenarios](../glossary/errors). * Deliver one or more `` items with pricing, guest counts, and property references. * Return the RatePlanToken needed for RP Token bookings. ## Details and Structure All the details regarding this message can be found at [OTA\_HotelAvailRS](../hotel/searchRS). This response works exactly the same, and depending on the distributor setup for RP Token, those new hotels will be received. The RatePlanToken room stays will be returned with a RatePlanToken in the search RS, which will be needed at the booking step. > [!WARNING] > > Response may contain a mix of RoomStays with and without RatePlanToken. If it is returned, it is **needed** for the booking. ### RatePlanToken The RatePlanToken consists of a string in the RoomStay, which needs to be used in the booking step. ```xml theme={null} ... ``` ## Differences with classic Hotel Search The structure of the message is exactly the same, but the available optional features are less for these searches. ### What's not included * [Multi-Room logic](../hotel/searchRS#multi-room-specifics) is not yet available for RP Token Search. * [Recommended Retail Price](../hotel/searchRS#recommended-retail-price) is not supported. * Enrichment via [InfoSource](../hotel/searchRS#enrichment-via-infosource). Every response will be displayed as per InfoSource = 0. * [Area Search](../hotel/searchRS#areas) is not supported. * [Offer tags](../hotel/searchRS#offer-tags) are not available in this mode. ### RatePlans and Multicontracting In this flow, rateplans and multicontracting are always included. The codes, in this case, will already be encoded inside the RatePlanToken and don't need to be used in the traditional "concatenated to room code" approach. The Rateplan code is needed to ensure a proper distribution of the rates. It will be visible in the response in the following section, but it does not have to be used at the booking request. ```xml theme={null} ... ... ``` ### Taxes and Fees The Taxes and Fees are small rates or commissions that may be added to a booking if a contract requests it. There are three main types of Taxes and Fees: * **Mandatory**: They are treated as a supplement in the contract, and calculated as one in the booking. Visible in Price Breakdown. * **Included**: They are included in the hotel rate. They are visible under the Tax section as "Inclusive". * **Payable Locally**: Taxes for the customer to pay on spot. They are visible under the tax section as "Exclusive". ```xml theme={null} This is a mandatory tax included in the rate, total amount for the whole stay This is a mandatory tax included in the rate, value is per pax per night This is a mandatory tax NOT included in the rate (payable locally), total amount for the whole stay This is a mandatory tax NOT included in the rate (payable locally), expressed as a percentage of the total amount This is a mandatory tax NOT included in the rate (payable locally), expressed as a per pax per night value ``` The Code represents which type of Tax or Fee the element refers to. The Mapping of the codes is the following: **ChargeFrequency** uses OTA CHG codes: * 1 per night * 12 per stay * 18 per room per stay * 19 per room per night * 20 per pax per stay * 21 per pax per night **Code** uses OTA FTT codes: * 3 city tax * 6 federal tax * 30 country tax * 12 resort fee * 18 tourism tax * 27 miscellaneous * 5 energy tax * 36 VAT ## Complete Examples ```xml Basic expandable theme={null} Classic Villa (Garden or Pool View) BB Classic Villa (Garden or Pool View) HB Comfort Villa BB Classic Villa (Park View) BB Comfort Villa HB Classic Villa (Park View) HB Cape Villa BB Cape Villa HB Club Villa BB Club Villa HB ``` # OTA_GroundBookRQ Source: https://docs.axisdata.net/transfer/bookTRRQ The `OTA_GroundBookRQ` (Transfer Booking Request) is used to **quote** or **commit** a ground transfer reservation, including service details, locations (Pickup/DropOff), passenger data, and partner references. > [!TIP] > > Already know OTA ground book messages? Jump straight into testing. > [card] [OTA\_GroundBookRQ API call](/api-reference/endpoint/transfer/book) > > Skip & Hit the Playground. ## Purpose Use this message to: * Request a **quote** (price + availability) without creating a booking by setting `ResStatus="Quote"`. * **Commit** a definitive booking by setting `ResStatus="Commit"`. ## Structure – Root Element ```xml theme={null} ``` ```json theme={null} { "OTA_GroundBookRQ": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2012.2", "ResStatus": "Quote", "EchoToken": "1234" } } ``` **Key Attributes** * `xmlns`: must be `http://www.opentravel.org/OTA/2003/05`. * `Version`: recommended `2012.2`. * `ResStatus`: `Quote` | `Commit`. * `EchoToken`: optional but recommended for idempotency and tracing. ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and carries credentials. ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "ID": "TEST", "Type": "22", "ID_Context": "AxisData", "Instance": "PriceBreakdown" } ] }, { "RequestorID": [ { "ID": "TEST", "Type": "88", "MessagePassword": "testpass" } ] } ] } } ``` ### GroundReservations Holds the service to be quoted or booked: locations, product and pricing qualifiers, and passengers. ```xml theme={null} ``` ```json theme={null} { "GroundReservations": { "Service": { "Locations": [], "ServiceLevel": { "Code": "S0000" }, "VehicleType": { "Code": "26", "Description": "Shared Shuttle" }, "RateQualifier": { "PromotionCode": "IN/OT", "RateQualifier": "TRESPMIPMI" } }, "Passengers": [] } } ``` **ServiceLevel**\ Specify the service code that has to be booked. e.g S0000, PW000,... **VehicleType**\ Define the returned description in the availability call of the desired product. **RateQualifier**\ `PromotionCode` defines if the trip is IN, OT, or both. `RateQualifier` defines the transfer stock code. #### Locations Each requested transfer is expressed with a `Location` (reference it by `RPH`). Provide the appropriate Pickup/DropOff details for **each** leg. ```xml theme={null}
``` ```json theme={null} { "Locations": [ { "RPH": "1", "Pickup": { "DateTime": "2027-07-17T00:00:00", "AirportInfo": { "Departure": { "CodeContext": "IATA", "LocationCode": "MAN", "DateTime": "2027-07-17T17:15:00" }, "Arrival": { "CodeContext": "IATA", "LocationCode": "PMI", "DateTime": "2027-07-17T20:55:00" } }, "Airline": { "FlightNumber": "3445", "Code": "FR" } }, "DropOff": { "Address": { "LocationType": { "Code": "11", "UniqueId": "AESPMI5L46" } } } } ] } ``` > [!NOTE] > > Flights at airports must include **both** the arrival and departure airport codes and times in `AirportInfo`. Use `DateTime` in ISO 8601. #### Passengers Provide the lead passenger under `Primary` and any others under `Additional`. **Age is required** (age at time of service). ```xml theme={null} Mr Bender Bending bender@gmail.com ``` ```json theme={null} { "Passengers": [ { "Primary": { "RPH": "1", "Age": "25", "PersonName": { "NamePrefix": "Mr", "GivenName": "Bender", "Surname": "Bending" }, "Telephone": { "PhoneNumber": "+4912252352" }, "Email": "bender@gmail.com" } } ] } ``` ### TPA\_Extensions #### Partner References Partner references are **mandatory**. Use one **master** reference (`Type="36"`) and one **child** reference (`Type="37"`) **per Location** (`Item_RPH` maps to the Location’s `RPH`). See [Master and child references](../general/messaging#master-and-child-references) ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "1234567890" }, { "Type": "37", "ID_Context": "Client", "ID": "1234567890_1", "Item_RPH": "1" } ] } } ``` #### Extras Optional extras returned by availability can be added as `Fees`. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "Fees": { "Fee": [ { "ExtraCode": "Child Restraint Seat/IN" }, { "ExtraCode": "Child Restraint Seat/OT" } ] } } } ``` ### Default Service If `ServiceLevel`/`RateQualifier` are omitted, the system will select the **cheapest** available option for the specified locations and passengers. ## Complete Examples > [tab] Round-trip > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > >
> >
>
>
> > >
> >
>
> > > > > > > >
>
> > > >
> > > > Mr > Bender > Bending > > > bender@gmail.com > > > > >
> > > > > > > > > >
> ``` > > ```json expandable theme={null} > { > "OTA_GroundBookRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "PriceBreakdown", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "GroundReservations" : [ { > "Service" : { > "Locations" : { > "Location" : [ { > "Pickup" : { > "AirportInfo" : { > "Arrival" : { > "DateTime" : "2027-07-17T20:55:00", > "LocationCode" : "PMI", > "CodeContext" : "IATA" > }, > "Departure" : { > "DateTime" : "2027-07-17T17:15:00", > "LocationCode" : "MAN", > "CodeContext" : "IATA" > } > }, > "Airline" : { > "value" : "", > "Code" : "FR", > "FlightNumber" : "3445" > }, > "DateTime" : "2027-07-17T00:00:00" > }, > "DropOff" : { > "Address" : { > "LocationType" : { > "Code" : "11", > "UniqueId" : "AESPMI5L46" > } > } > }, > "RPH" : "1" > }, { > "Pickup" : { > "Address" : { > "LocationType" : { > "Code" : "11", > "UniqueId" : "AESPMI5L46" > } > }, > "DateTime" : "2027-07-24T00:00:00" > }, > "DropOff" : { > "AirportInfo" : { > "Arrival" : { > "DateTime" : "2027-07-24T23:10:00", > "LocationCode" : "MAN", > "CodeContext" : "IATA" > }, > "Departure" : { > "DateTime" : "2027-07-24T21:30:00", > "LocationCode" : "PMI", > "CodeContext" : "IATA" > } > }, > "Airline" : { > "value" : "", > "Code" : "FR", > "FlightNumber" : "3446" > } > }, > "RPH" : "2" > } ] > }, > "ServiceLevel" : { > "Code" : "S0000" > }, > "VehicleType" : { > "value" : "", > "Code" : "26", > "Description" : "Shared Shuttle" > }, > "RateQualifier" : [ { > "RateQualifier" : "TRESPMIPMI", > "PromotionCode" : "IN/OT" > } ] > }, > "Passengers" : { > "Primary" : { > "PersonName" : { > "NamePrefix" : [ "Mr" ], > "GivenName" : [ "Bender" ], > "Surname" : "Bending" > }, > "Telephone" : [ { > "PhoneNumber" : "+4912252352" > } ], > "Email" : [ { > "value" : "bender@gmail.com" > } ], > "RPH" : "1", > "Age" : 25 > }, > "Additional" : [ { > "RPH" : "2", > "Age" : 25 > }, { > "RPH" : "3", > "Age" : 11 > } ] > } > } ], > "TPA_Extensions" : { > "UniqueID" : [ { > "Type" : "36", > "ID_Context" : "Client", > "ID" : "1234567890" > }, { > "Type" : "37", > "ID_Context" : "Client", > "ID" : "1234567890_1", > "Item_RPH" : "1" > }, { > "Type" : "37", > "ID_Context" : "Client", > "ID" : "1234567890_2", > "Item_RPH" : "2" > } ], > "Fees" : [ { > "Fee" : [ { > "ExtraCode" : "Child Restraint Seat/IN" > }, { > "ExtraCode" : "Child Restraint Seat/OT" > } ] > } ] > }, > "EchoToken" : "1234", > "Version" : 2012.2 > } > } > ``` > [tab] One-way > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > >
> >
>
>
>
> > > >
> > > > Mr > Bender > Bending > > > bender@gmail.com > > > > >
> > > > >
> ``` > > ```json expandable theme={null} > { > "OTA_GroundBookRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "PriceBreakdown", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "GroundReservations" : [ { > "Service" : { > "Locations" : { > "Location" : [ { > "Pickup" : { > "AirportInfo" : { > "Arrival" : { > "DateTime" : "2027-07-17T20:55:00", > "LocationCode" : "PMI", > "CodeContext" : "IATA" > }, > "Departure" : { > "DateTime" : "2027-07-17T17:15:00", > "LocationCode" : "MAN", > "CodeContext" : "IATA" > } > }, > "Airline" : { > "value" : "", > "Code" : "FR", > "FlightNumber" : "3445" > }, > "DateTime" : "2027-07-17T00:00:00" > }, > "DropOff" : { > "Address" : { > "LocationType" : { > "Code" : "11", > "UniqueId" : "AESPMI5L46" > } > } > }, > "RPH" : "1" > } ] > }, > "ServiceLevel" : { > "Code" : "S0000" > }, > "VehicleType" : { > "value" : "", > "Code" : "26", > "Description" : "Shared Shuttle" > }, > "RateQualifier" : [ { > "RateQualifier" : "TRESPMIPMI", > "PromotionCode" : "IN" > } ] > }, > "Passengers" : { > "Primary" : { > "PersonName" : { > "NamePrefix" : [ "Mr" ], > "GivenName" : [ "Bender" ], > "Surname" : "Bending" > }, > "Telephone" : [ { > "PhoneNumber" : "+4912252352" > } ], > "Email" : [ { > "value" : "bender@gmail.com" > } ], > "RPH" : "1", > "Age" : 25 > }, > "Additional" : [ { > "RPH" : "2", > "Age" : 25 > }, { > "RPH" : "3", > "Age" : 11 > } ] > } > } ], > "TPA_Extensions" : { > "UniqueID" : [ { > "Type" : "36", > "ID_Context" : "Client", > "ID" : "191206094817263" > }, { > "Type" : "37", > "ID_Context" : "Client", > "ID" : "Transfer_1", > "Item_RPH" : "1" > } ] > }, > "EchoToken" : "abcd-ef01", > "Version" : 2012.2 > } > } > ``` ## Playground > [card] [OTA\_GroundBookRQ API call](/api-reference/endpoint/transfer/book) > > Try our API playground in real time. > [!TIP] > > Use the desired request in the playground and receive responses from our test environment API. ## Best Practices 1. Always include `EchoToken` to correlate requests and responses. 2. Use ISO 8601 for all dates/times (`YYYY-MM-DDThh:mm:ss`). 3. Provide **both** arrival and departure flight legs when an airport is involved. 4. Include **ages** for all passengers; age is evaluated at time of service. 5. Send `UniqueID` (master + child per leg) to prevent duplicates and enable partial cancellations. 6. If you don’t have a specific service code, omit `ServiceLevel`/`RateQualifier` to book the **cheapest** option. # OTA_GroundBookRS Source: https://docs.axisdata.net/transfer/bookTRRS The `OTA_GroundBookRS` (Transfer Booking **Response**) returns the outcome of a **quote** or **commit** booking request for ground/transfer services, including final pricing, service details, and references. If the booking cannot be processed, the response omits `Success` and includes `Errors`. > [!TIP] > > Use this message to read **final prices** and **booking references** after a quote or commit operation. ## Purpose Get a successful response from the book request (either quote or commit). Recieve confirmation about the booking, meet and greet information, rates and cancellation rules. ## Structure – Root Element ```xml theme={null} ``` ```json theme={null} { "OTA_GroundBookRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2012.2", "EchoToken": "1234" } } ``` **Primary children:** `Reservation`, `TPA_Extensions`. > [!TIP] > > When `` is absent, inspect `` for diagnostics; multiple `` items may be returned. [Error Scenarios](../glossary/errors). ### Reservation Holds the booked/quoted service details, including locations, service, fees, charges and total. #### Locations Pickup/DropOff data required to operate the transfer. For airport legs provide **flight number** and **arrival/departure** timestamps; for hotels provide the **OTS hotel code**. ```xml theme={null}
``` ```json theme={null} { "Locations": { "Location": { "RPH": "1", "Pickup": { "Address": { "LocationType": { "Code": "11", "UniqueId": "AMTSES0000" } } }, "DropOff": { "Airline": { "FlightNumber": "2415", "Code": "AB" }, "AirportInfo": { "Arrival": { "CodeContext": "IATA", "LocationCode": "PMI", "DateTime": "2020-07-18T14:00:00" }, "Departure": { "CodeContext": "IATA", "LocationCode": "FAO", "DateTime": "2020-07-18T10:00:00" } } } } } } ``` #### Service Confirmed product and pricing key. ```xml theme={null} Shuttle ``` ```json theme={null} { "Service": { "ServiceLevel": { "Code": "S0000", "value": "Shuttle" }, "VehicleType": { "Code": "3", "Description": "Shared" }, "RateQualifier": { "PromotionCode": "IN/OT", "RateQualifier": "TRESPMIPMI" } } } ``` #### ServiceCharges & Total ```xml theme={null} ``` ```json theme={null} { "ServiceCharge": [ { "Amount": "18.00", "CurrencyCode": "EUR", "ChargePurpose": { "Code": "35", "Description": "Base Rate" }, "Calculation": { "Quantity": "3", "UnitName": "SERVICE" } }, { "Amount": "18.00", "CurrencyCode": "EUR", "ChargePurpose": { "Code": "35", "Description": "Base Rate" }, "Calculation": { "Quantity": "3", "UnitName": "SERVICE" } } ], "TotalCharge": { "RateTotalAmount": "36.00", "CurrencyCode": "EUR" } } ``` * **ServiceCharge** lines provide a detailed breakdown of the calculation for each chargeable item. Each line includes: * `Amount` and `CurrencyCode`: The value and currency for the charge. * `ChargePurpose` (`Code`, `Description`): The reason for the charge (e.g., 35 = Base Rate, 28 = Optional, 3 = Discount, 36 = Mandatory). * `Calculation` (`Quantity`, `UnitName`): How the charge was calculated (e.g., per service, per passenger, per unit). * **TotalCharge**: The `TotalCharge` node provides the **final price** for the booking, which is the amount used for accountancy and invoicing. This value includes all service charges and extras. * **Purpose Codes (VCP)**: * **3**: Discount * **28**: Optional * **35**: Base Rate * **36**: Mandatory > [!NOTE] > > All amounts in `ServiceCharge` and `Fees` are included in `TotalCharge`. The **final price** is always the value in `TotalCharge`—no hidden or additional fees. * **Example Breakdown**: * Two `ServiceCharge` lines may appear if, for example, the base rate is charged per leg or per passenger. * Extras such as bicycles or large pets are shown as `Fee` lines, and their amounts are included in the total. * The response structure is consistent for both Quote and Commit. > [!TIP] > > Always check the `ServiceCharge` and `Fees` sections for a full breakdown of what is included in the `TotalCharge`. This helps with reconciliation and customer transparency. #### Extras Optional/mandatory supplements included in the total. ```xml theme={null} ``` ```json theme={null} { "Fees": { "Fee": [ { "Amount": "15.00", "CurrencyCode": "EUR", "Description": "Large Pet/IN", "IncludeInRate": "true" }, { "Amount": "23.00", "CurrencyCode": "EUR", "Description": "Bicycle/IN", "IncludeInRate": "true" } ] } } ``` * **Fees**: All optional or mandatory extras (such as child seats, pets, bicycles) are listed in the `Fees` section. Each `Fee` includes: * `Amount`, `CurrencyCode`, `Description`, and `IncludeInRate` (true if already included in `TotalCharge`). * If multiple extras of the same type are requested, they are merged into a single line with the total amount. #### Meet and Greet Language depends on the request’s `PrimaryLangID`; defaults to English when not available. ```xml theme={null} Arrival Instructions: Once you have collected your luggage, please proceed to the MTS Globe Office desk at the arrivals hall. Identify yourself by showing your voucher. Our staff will indicate the location of your vehicle. Do not leave the arrivals hall until you have located our representative or your driver. Emergency number: (+34) 871 170 555 ``` ```json theme={null} { "Comments": { "Language": "EN", "value": "Arrival Instructions:\nOnce you have collected your luggage, please proceed to the MTS Globe Office desk at the arrivals hall.\nIdentify yourself by showing your voucher. Our staff will indicate the location of your vehicle.\nDo not leave the arrivals hall until you have located our representative or your driver.\nEmergency number: (+34) 871 170 555" } } ``` ### TPA\_Extensions Master and child references (client and internal) used for post-booking operations. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "191206094817263" }, { "Type": "37", "ID_Context": "Client", "ID": "Transfer_1", "Item_RPH": "1" }, { "Type": "37", "ID_Context": "Internal", "ID": "1", "Item_RPH": "1" } ] } } ``` ## Codes & Rules ### Cancellation Cancellation policy is returned in the response for both **quote** and **commit** flows. Use the **master** or **child** client reference to cancel the entire booking, or a specific child reference for partial cancellations. ### Language Arrival instructions text follows the `PrimaryLangID` from the original request. If the requested language is unavailable, **English** is returned by default. ## Complete Examples ```xml Basic expandable theme={null}
Shuttle Arrival Instructions: Once you have collected your luggage, please proceed to the MTS Globe Office desk at the arrivals hall. Identify yourself by showing your voucher. Our staff will indicate the location of your vehicle. Do not leave the arrivals hall until you have located our representative or your driver. Emergency number: (+34) 871 170 555
``` ```json Basic expandable theme={null} { "OTA_GroundBookRS": { "Success": "", "Reservation": { "Locations": { "Location": [ { "Pickup": { "Address": { "LocationType": { "Code": "11", "UniqueId": "AMTSES0000" } } }, "DropOff": { "Airline": { "FlightNumber": "2415", "Code": "AB" }, "AirportInfo": { "Arrival": { "CodeContext": "IATA", "LocationCode": "PMI", "DateTime": "2020-07-18T14:00:00" }, "Departure": { "CodeContext": "IATA", "LocationCode": "FAO", "DateTime": "2020-07-18T10:00:00" } } }, "RPH": "1" } ] }, "Service": { "ServiceLevel": { "Code": "S0000", "value": "Shuttle" }, "VehicleType": { "Code": "3", "Description": "Shared" }, "RateQualifier": { "PromotionCode": "IN/OT", "RateQualifier": "TRESPMIPMI" } }, "ServiceCharge": [ { "ChargePurpose": { "Code": "35", "Description": "Base Rate" }, "Calculation": { "Quantity": "3", "UnitName": "SERVICE" }, "Amount": "18.00", "CurrencyCode": "EUR" }, { "ChargePurpose": { "Code": "35", "Description": "Base Rate" }, "Calculation": { "Quantity": "3", "UnitName": "SERVICE" }, "Amount": "18.00", "CurrencyCode": "EUR" } ], "Fees": { "Fee": [ { "Amount": "15.00", "CurrencyCode": "EUR", "Description": "Large Pet/IN", "IncludeInRate": "true" }, { "Amount": "23.00", "CurrencyCode": "EUR", "Description": "Bicycle/IN", "IncludeInRate": "true" } ] }, "TotalCharge": { "RateTotalAmount": "36.00", "CurrencyCode": "EUR" }, "TPA_Extensions": { "UniqueID": [ { "Type": "36", "ID_Context": "Client", "ID": "191206094817263" }, { "Type": "37", "ID_Context": "Client", "ID": "Transfer_1", "Item_RPH": "1" }, { "Type": "37", "ID_Context": "Internal", "ID": "1", "Item_RPH": "1" } ] }, "Comments": { "Language": "EN", "value": "Arrival Instructions:\nOnce you have collected your luggage, please proceed to the MTS Globe Office desk at the arrivals hall.\nIdentify yourself by showing your voucher. Our staff will indicate the location of your vehicle.\nDo not leave the arrivals hall until you have located our representative or your driver.\nEmergency number: (+34) 871 170 555" } }, "xmlns": "http://www.opentravel.org/OTA/2003/05", "Version": "2012.2", "EchoToken": "1234" } } ``` # OTA_GroundAvailRQ Source: https://docs.axisdata.net/transfer/searchTRRQ The **OTA\_GroundAvailRQ** (Transfer Availability Request) is used to search available transfer services (e.g., airport ↔ hotel, port ↔ hotel), returning priced options according to the distributor’s agreements. > [!TIP] > > Already know OTA ground messages? Jump straight into testing. > [card] [OTA\_GroundAvailRQ API call](/api-reference/endpoint/transfer/availability) > > Skip & Hit the Playground. ## Purpose This request allows you to: * Identify transfer services between two points (airport/port ↔ hotel). * Send mandatory flight details needed to operate the transfer. * Specify passenger mix and special requirements (e.g., disability). * Optionally narrow by vehicle/service level. ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_GroundAvailRQ": { "Version": "2016.2", "xmlns": "http://www.opentravel.org/OTA/2003/05", ... } } ``` **Key Attributes:** * `Version`: OTA Ground pack supported from **2012.2** and higher. Use the latest supported version (e.g., `2016.2`). * `xmlns`: `http://www.opentravel.org/OTA/2003/05` * `EchoToken`: optional but recommended for idempotency and tracing. ## Structure – Core Elements ### POS (Point of Sale) Identifies the requesting party and credentials. Use `Instance` to control availability behavior (e.g., include OnRequest products). ```xml theme={null} ``` ```json theme={null} { "POS": { "Source": [ { "RequestorID": [ { "Instance": "MF0000", "ID_Context": "AxisData", "ID": "TEST", "Type": "22" } ] }, { "RequestorID": [ { "Type": "88", "ID": "TEST", "MessagePassword": "testpass" } ] } ] } } ``` **OnRequest Switch:** set `Instance="MF0001"` to include OnRequest products in search results (otherwise use `MF0000`). The response will include warnings indicating OnRequest services. ### Service → Location A **Service** defines the transfer and contains one or two **Location** blocks. One Location = one-way; two Locations = roundtrip. Locations are ordered by `RPH` and composed of: * **Pickup**: where the service starts for that leg. * **DropOff**: where the service ends for that leg. > [!TIP] > > Use Hotel or Airport as Pickup/DropOff as needed. #### AirportInfo Provide flight **Arrival**/**Departure** with IATA airport codes and ISO 8601 datetimes. Include the **Airline** (code and flight number) when known. ```xml theme={null} ``` ```json theme={null} { "Pickup": { "AirportInfo": { "Arrival": { "CodeContext": "IATA", "LocationCode": "PMI", "DateTime": "2027-07-17T20:55:00" }, "Departure": { "CodeContext": "IATA", "LocationCode": "MAN", "DateTime": "2027-07-17T17:15:00" } }, "Airline": { "FlightNumber": "3445", "Code": "FR" } } } ``` #### Address Use **hotel/property codes** for hotel points. ```xml theme={null}
``` ```json theme={null} { "DropOff": { "Address": { "LocationType": { "Code": "11" }, "UniqueId": "AESPMI5L46" } } } ``` For now, only LocationType Code = 11 is supported. > [!TIP] > > If the OTS hotel code is unknown, it is possible to add the GIATA ID at `UniqueId` ### Passengers Define each passenger group with `Quantity` and **mandatory** `Age`, and classify via `Category/Code` using OTA AQC values: * Adults → `10` * Children → `8` * Infants → `7` ```xml theme={null} ``` ```json theme={null} { "Passengers": [ { "Quantity": "2", "Age": "30", "Category": { "Code": "10" } }, { "Quantity": "1", "Age": "9", "Category": { "Code": "8" } } ] } ``` ### ServiceType Classifies the request as a transfer search. ```xml theme={null} ``` ```json theme={null} { "ServiceType": { "Code": "TRANSFER" } } ``` ### DisabilityInfo Flag if an adapted vehicle is required. ```xml theme={null} ``` ```json theme={null} { "DisabilityInfo": { "RequiredInd": "false" } } ``` ### Vehicle Preferences Optional node. Constrain response to a specific service/vehicle level when needed. ```xml theme={null} ``` ```json theme={null} { "VehiclePrefs": { "ServiceLevel": { "Code": "P0000" } } } ``` ### GeoCodes If the exact hotel code is unknown, search by **latitude/longitude** and radius to get candidate hotels. ```xml theme={null}
``` ```json theme={null} { "Address": { "Latitude": "6.12345", "Longitude": "8.12345", "Radius": "100", "MaxServiceLocations": "15", "LocationType": { "Code": "11" } } } ``` > [!WARNING] > > GeoCode search is only available for airport/port ↔ hotel combinations (not for inter-resort transfers). ## Complete Examples > [tab] Basic Roundtrip > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > >
> >
>
>
> > >
> >
>
> > > > > > > >
>
>
> > > > > > > > >
> ``` > > ```json expandable theme={null} > { > "OTA_GroundAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF0000", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "Service" : { > "Locations" : { > "Location" : [ { > "Pickup" : { > "AirportInfo" : { > "Arrival" : { > "DateTime" : "2027-07-17T20:55:00", > "LocationCode" : "PMI", > "CodeContext" : "IATA" > }, > "Departure" : { > "DateTime" : "2027-07-17T17:15:00", > "LocationCode" : "MAN", > "CodeContext" : "IATA" > } > }, > "Airline" : { > "value" : "", > "Code" : "FR", > "FlightNumber" : "3445" > } > }, > "DropOff" : { > "Address" : { > "LocationType" : { > "Code" : "11", > "UniqueId" : "AESPMI5L46" > } > } > }, > "RPH" : "1" > }, { > "Pickup" : { > "Address" : { > "LocationType" : { > "Code" : "11", > "UniqueId" : "AESPMI5L46" > } > } > }, > "DropOff" : { > "AirportInfo" : { > "Arrival" : { > "DateTime" : "2027-07-24T23:10:00", > "LocationCode" : "MAN", > "CodeContext" : "IATA" > }, > "Departure" : { > "DateTime" : "2027-07-24T21:30:00", > "LocationCode" : "PMI", > "CodeContext" : "IATA" > } > }, > "Airline" : { > "value" : "", > "Code" : "FR", > "FlightNumber" : "3446" > } > }, > "RPH" : "2" > } ] > } > }, > "Passengers" : [ { > "Category" : { > "Code" : "10" > }, > "Age" : 30, > "Quantity" : 2 > }, { > "Category" : { > "Code" : "8" > }, > "Age" : 2, > "Quantity" : 1 > } ], > "ServiceType" : { > "Code" : "TRANSFER" > }, > "DisabilityInfo" : { > "RequiredInd" : false > }, > "Version" : 2016.2 > } > } > ``` > [tab] Minimal One-Way > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > >
> >
>
>
>
>
> > > > > > > > >
> ``` > > ```json expandable theme={null} > { > "OTA_GroundAvailRQ" : { > "POS" : { > "Source" : [ { > "RequestorID" : [ { > "Type" : "22", > "Instance" : "MF0000", > "ID" : "TEST", > "ID_Context" : "AxisData" > } ] > }, { > "RequestorID" : [ { > "Type" : "88", > "ID" : "TEST", > "MessagePassword" : "testpass" > } ] > } ] > }, > "Service" : { > "Locations" : { > "Location" : [ { > "Pickup" : { > "AirportInfo" : { > "Arrival" : { > "DateTime" : "2027-07-17T12:00:00", > "LocationCode" : "PMI", > "CodeContext" : "IATA" > } > } > }, > "DropOff" : { > "Address" : { > "LocationType" : { > "Code" : "11", > "UniqueId" : "AESPMI5L46" > } > } > }, > "RPH" : "1" > } ] > } > }, > "Passengers" : [ { > "Category" : { > "Code" : "10" > }, > "Age" : 30, > "Quantity" : 2 > }, { > "Category" : { > "Code" : "8" > }, > "Age" : 9, > "Quantity" : 1 > } ], > "ServiceType" : { > "Code" : "TRANSFER" > }, > "DisabilityInfo" : { > "RequiredInd" : false > }, > "Version" : 2016.2 > } > } > ``` ## Best Practices 1. **Always include flight details** (airline, number, airports, and times) for each leg so operations can allocate the correct transfer. 2. **Provide passenger ages** for *every* passenger group; pricing uses age, not just category. 3. **Use valid property codes** for hotel Pickup/DropOff (`LocationType Code="11" UniqueId=...`). 4. **Roundtrip searches**: send two `Location` blocks (inbound and outbound) with correct `RPH` ordering. 5. **Use ISO 8601** datetimes (`YYYY-MM-DDThh:mm:ss`) and IATA airport codes. 6. **Switch to `MF0001`** when you want to include OnRequest products in the results. ## Playground > [card] [OTA\_GroundAvailRQ API call](/api-reference/endpoint/transfer/availability) > > Try our API playground in real time. > [!TIP] > > Use any example in the playground to test against our sandbox. # OTA_GroundAvailRS Source: https://docs.axisdata.net/transfer/searchTRRS The `OTA_GroundAvailRS` (Ground Availability **Response**) returns available ground transfer services in response to an `OTA_GroundAvailRQ`. Use it to read priced service options, conditions, and any applicable fees or penalties. ## Structure – Root Element ```xml theme={null} ... ``` ```json theme={null} { "OTA_GroundAvailRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "EchoToken": "1912GBEZGBQ9", "Version": "2016.2" } } ``` **Key children:** `Success` | `Errors` | `GroundServices` | `Warnings` (if products are **OnRequest**). ### Success & Errors * On success, the message **may** include an empty `` and populated ``. * If no suitable services are found, the response returns `` with `Code="14"` and `ShortText="calculation error"`. [Error Scenarios](../glossary/errors). ```xml theme={null} No suitable services found No suitable services found ``` ```json theme={null} { "OTA_GroundAvailRS": { "xmlns": "http://www.opentravel.org/OTA/2003/05", "EchoToken": "1912GBEZGBQ9", "Version": "2016.2", "GroundServices": {}, "Errors": [ { "ShortText": "calculation error", "Code": "14" }, { "ShortText": "calculation error", "Code": "14" } ] } } ``` ## Structure - Core Elements GroundServices is a container of one or more `GroundService` items, each representing a priced transfer option and its rules. ### GroundService #### ServiceInfo High‑level details for the service. * Attributes: `DisabilityVehicleInd` (boolean), `ServiceType` (e.g., `AirportTransfer`), `MaximumPassengers` (integer), `ShortDescription` (string). * Children: `ServiceLevel` (vehicle/contract code), `VehicleType` (OTA vehicle descriptor). ```xml theme={null} ``` ```json theme={null} { "ServiceInfo": { "DisabilityVehicleInd": false, "ServiceType": "AirportTransfer", "MaximumPassengers": 99, "ShortDescription": "Airport PMI to Resorts PMI/Shared", "ServiceLevel": { "Code": "S0000" }, "VehicleType": { "Code": 3, "Description": "Bus" } } } ``` #### RateQualifier Shows the transfer stock code and the promotion (IN, OT or both). ```xml theme={null} ``` ```json theme={null} { "RateQualifier": { "RateQualifier": "TRESPMIPMI", "PromotionCode": "IN/OT" } } ``` #### Restrictions Operational/financial flags at search time. * `CalculationPenaltyInd="true"` indicates cancellations may incur a penalty, specified under `PaymentRules`. ```xml theme={null} ``` ```json theme={null} { "Restrictions": { "CalculationPenaltyInd": true } } ``` #### TotalCharge Total price (currency and amount) for the service option in the search response. ```xml theme={null} ``` ```json theme={null} { "TotalCharge": { "CurrencyCode": "EUR", "Amount": "45.00" } } ``` #### Extras Optional or mandatory extras available. Use `RequiredInd` to distinguish if they are mandatory or not: ```xml theme={null} ``` ```json theme={null} { "Fees": [ { "RequiredInd": false, "Description": "Golf Clubs/IN", "IncludedInRate": false, "CurrencyCode": "EUR", "Amount": 12.50 } ] } ``` #### PaymentRules Cancellation rules (`RuleType="1"` = **Cancel**). When multiple rules apply, the one **nearest** to the service start date is used. ```xml theme={null} ``` ```json theme={null} { "PaymentRules": [ { "RuleType": 1, "Amount": 10.00, "CurrencyCode": "EUR", "AbsoluteDeadline": "2025-07-06T00:00:00" }, { "RuleType": 1, "Amount": 20.00, "CurrencyCode": "EUR", "AbsoluteDeadline": "2025-07-09T00:00:00" } ] } ``` ### Shuttle (GeoCode Searches) When the request used GeoCodes, services may include `Shuttle/ServiceLocation` entries. `PickupInd` marks direction membership; hotel candidates are sorted by distance from the provided GeoCode. If the distributor is Giata‑licensed, `ResourceName` can carry the Giata code. ```xml theme={null}
``` ```json theme={null} { "Shuttle": [ { "ServiceLocation": { "PickupInd": true, "Sequence": 1, "Address": { "Latitude": 3.12345, "Longitude": 6.12345, "Distance": 8, "LocationType": { "Code": 11, "UniqueId": "AMTSES1234", "ResourceName": "54123", "DescriptionDetail": "Hotel Happy 1" } } } }, { "ServiceLocation": { "PickupInd": true, "Sequence": 2, "Address": { "Latitude": 3.12366, "Longitude": 6.565, "Distance": 34, "LocationType": { "Code": 11, "UniqueId": "AMTSES1235", "ResourceName": "54163", "DescriptionDetail": "Hotel Happy 2" } } } } ] } ``` ### Per‑Resort Searches If the search is per‑resort, the response may list available hotels under `TPA_Extensions/Properties`. ```xml theme={null} ``` ```json theme={null} { "TPA_Extensions": { "Properties": [ { "Property": { "HotelCode": "AMTSES0M1C", "HotelName": "Central Park", "HotelCodeContext": "35252" } }, { "Property": { "HotelCode": "AMTSES2EWO", "HotelName": "Anibal Hostal", "HotelCodeContext": "47988" } } ] } } ``` ### Warnings When the request asks to include **OnRequest** products, the response includes warnings noting the service status. ```xml theme={null} Service S0000/S0000 is OnRequest Service P0000/P0000 is OnRequest ``` ```json theme={null} { "Warnings": [ { "Type": 3, "Code": 507, "Message": "Service S0000/S0000 is OnRequest" }, { "Type": 3, "Code": 507, "Message": "Service P0000/P0000 is OnRequest" } ] } ``` ## Complete Examples > [tab] Basic > > ```xml expandable theme={null} > > > > > > > > > > > > > > > > > > > > > > > ``` > > ```json expandable theme={null} > { > "OTA_GroundAvailRS": { > "Success": {}, > "GroundServices": { > "GroundService": [ > { > "ServiceInfo": { > "MaximumPassengers": 99, > "ShortDescription": "Airport PMI to Resorts PMI/Shared Economy", > "ServiceLevel": { > "Code": "SE000" > }, > "VehicleType": { > "value": "", > "Code": "26", > "Description": "Shared Economy" > }, > "DisabilityVehicleInd": false, > "ServiceType": "AirportTransfer" > }, > "RateQualifier": [ > { > "RateQualifier": "TRESPMIPMI", > "PromotionCode": "IN/OT" > } > ], > "Restrictions": [ > { > "CancellationPenaltyInd": false > } > ], > "ServiceCharge": [ > { > "ChargePurpose": { > "Code": "35", > "Description": "Base Rate", > "DescriptionDetail": "Per Pax" > }, > "Calculation": [ > { > "Quantity": 6, > "UnitName": "SERVICE" > } > ], > "Amount": 32.64, > "CurrencyCode": "EUR" > } > ], > "Fees": { > "Fee": [ > { > "Description": "Luggage/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 5.00, > "RequiredInd": false > }, > { > "Description": "Luggage/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 5.00, > "RequiredInd": false > } > ] > }, > "TotalCharge": { > "EstimatedTotalAmount": 32.64, > "CurrencyCode": "EUR" > } > }, > { > "ServiceInfo": { > "MaximumPassengers": 99, > "ShortDescription": "Airport PMI to Resorts PMI/Shared", > "ServiceLevel": { > "Code": "S0000" > }, > "VehicleType": { > "value": "", > "Code": "3", > "Description": "Shared" > }, > "DisabilityVehicleInd": false, > "ServiceType": "AirportTransfer" > }, > "RateQualifier": [ > { > "RateQualifier": "TRESPMIPMI", > "PromotionCode": "IN/OT" > } > ], > "Restrictions": [ > { > "CancellationPenaltyInd": false > } > ], > "ServiceCharge": [ > { > "ChargePurpose": { > "Code": "35", > "Description": "Base Rate", > "DescriptionDetail": "Per Pax" > }, > "Calculation": [ > { > "Quantity": 6, > "UnitName": "SERVICE" > } > ], > "Amount": 57.12, > "CurrencyCode": "EUR" > } > ], > "Fees": { > "Fee": [ > { > "Description": "Luggage/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 5.00, > "RequiredInd": false > }, > { > "Description": "Luggage/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 5.00, > "RequiredInd": false > } > ] > }, > "TotalCharge": { > "EstimatedTotalAmount": 57.12, > "CurrencyCode": "EUR" > } > }, > { > "ServiceInfo": { > "MaximumPassengers": 99, > "ShortDescription": "Airport PMI to Resorts PMI/Shared Speedy", > "ServiceLevel": { > "Code": "SS000" > }, > "VehicleType": { > "value": "", > "Code": "26", > "Description": "Shared Speedy" > }, > "DisabilityVehicleInd": false, > "ServiceType": "AirportTransfer" > }, > "RateQualifier": [ > { > "RateQualifier": "TRESPMIPMI", > "PromotionCode": "IN/OT" > } > ], > "Restrictions": [ > { > "CancellationPenaltyInd": false > } > ], > "ServiceCharge": [ > { > "ChargePurpose": { > "Code": "35", > "Description": "Base Rate", > "DescriptionDetail": "Per Pax" > }, > "Calculation": [ > { > "Quantity": 6, > "UnitName": "SERVICE" > } > ], > "Amount": 81.60, > "CurrencyCode": "EUR" > } > ], > "Fees": { > "Fee": [ > { > "Description": "Luggage/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 5.00, > "RequiredInd": false > }, > { > "Description": "Luggage/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 5.00, > "RequiredInd": false > } > ] > }, > "TotalCharge": { > "EstimatedTotalAmount": 81.60, > "CurrencyCode": "EUR" > } > }, > { > "ServiceInfo": { > "MaximumPassengers": 4, > "ShortDescription": "Airport PMI to Resorts PMI/Private", > "ServiceLevel": { > "Code": "P0000" > }, > "VehicleType": { > "value": "", > "Code": "26", > "Description": "Private" > }, > "DisabilityVehicleInd": false, > "ServiceType": "AirportTransfer" > }, > "RateQualifier": [ > { > "RateQualifier": "TRESPMIPMI", > "PromotionCode": "IN/OT" > } > ], > "Restrictions": [ > { > "CancellationPenaltyInd": false > } > ], > "ServiceCharge": [ > { > "ChargePurpose": { > "Code": "35", > "Description": "Base Rate", > "DescriptionDetail": "Per Unit 1-4" > }, > "Calculation": [ > { > "Quantity": 6, > "UnitName": "SERVICE" > } > ], > "Amount": 163.20, > "CurrencyCode": "EUR" > } > ], > "Fees": { > "Fee": [ > { > "Description": "Pet - Large Size/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 20.00, > "RequiredInd": false > }, > { > "Description": "Water 50cl/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 2.00, > "RequiredInd": false > }, > { > "Description": "Pet - Large Size/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 20.00, > "RequiredInd": false > }, > { > "Description": "Water 50cl/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 2.00, > "RequiredInd": false > } > ] > }, > "TotalCharge": { > "EstimatedTotalAmount": 163.20, > "CurrencyCode": "EUR" > } > }, > { > "ServiceInfo": { > "MaximumPassengers": 4, > "ShortDescription": "Airport PMI to Resorts PMI/Private Wheelchair adapted", > "ServiceLevel": { > "Code": "PW000" > }, > "VehicleType": { > "value": "", > "Code": "26", > "Description": "Private Wheelchair adapted" > }, > "DisabilityVehicleInd": false, > "ServiceType": "AirportTransfer" > }, > "RateQualifier": [ > { > "RateQualifier": "TRESPMIPMI", > "PromotionCode": "IN/OT" > } > ], > "Restrictions": [ > { > "CancellationPenaltyInd": false > } > ], > "ServiceCharge": [ > { > "ChargePurpose": { > "Code": "35", > "Description": "Base Rate", > "DescriptionDetail": "Per Unit 1-4" > }, > "Calculation": [ > { > "Quantity": 6, > "UnitName": "SERVICE" > } > ], > "Amount": 204.00, > "CurrencyCode": "EUR" > } > ], > "Fees": { > "Fee": [ > { > "Description": "Water 50cl/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 2.00, > "RequiredInd": false > }, > { > "Description": "Water 50cl/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 2.00, > "RequiredInd": false > } > ] > }, > "TotalCharge": { > "EstimatedTotalAmount": 204.00, > "CurrencyCode": "EUR" > } > }, > { > "ServiceInfo": { > "MaximumPassengers": 8, > "ShortDescription": "Airport PMI to Resorts PMI/Private Limousine", > "ServiceLevel": { > "Code": "P0L00" > }, > "VehicleType": { > "value": "", > "Code": "26", > "Description": "Private Limousine" > }, > "DisabilityVehicleInd": false, > "ServiceType": "AirportTransfer" > }, > "RateQualifier": [ > { > "RateQualifier": "TRESPMIPMI", > "PromotionCode": "IN/OT" > } > ], > "Restrictions": [ > { > "CancellationPenaltyInd": false > } > ], > "ServiceCharge": [ > { > "ChargePurpose": { > "Code": "35", > "Description": "Base Rate", > "DescriptionDetail": "Per Unit 1-8" > }, > "Calculation": [ > { > "Quantity": 6, > "UnitName": "SERVICE" > } > ], > "Amount": 1224.00, > "CurrencyCode": "EUR" > } > ], > "Fees": { > "Fee": [ > { > "Description": "VIP Treatment/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 1000.00, > "RequiredInd": false > }, > { > "Description": "Pet - Large Size/IN", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 20.00, > "RequiredInd": false > }, > { > "Description": "VIP Treatment/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 1000.00, > "RequiredInd": false > }, > { > "Description": "Pet - Large Size/OT", > "IncludedInRate": false, > "CurrencyCode": "EUR", > "Amount": 20.00, > "RequiredInd": false > } > ] > }, > "TotalCharge": { > "EstimatedTotalAmount": 1224.00, > "CurrencyCode": "EUR" > } > } > ] > }, > "Version": 2016.2, > "TransactionIdentifier": "1-6/6" > } > } > ``` > [tab] GeoCode search (shuttle + candidates) > > ```xml expandable theme={null} > > > > > > > > > > >
> >
>
> >
> >
>
>
> >
>
> > Service S0000/S0000 is OnRequest > >
> ``` > > ```json expandable theme={null} > { > "OTA_GroundAvailRS": { > "Success": "", > "GroundServices": { > "GroundService": [ > { > "ServiceInfo": { > "ServiceLevel": { > "Code": "S0000" > }, > "VehicleType": { > "Code": "3", > "Description": "Bus" > }, > "DisabilityVehicleInd": "false", > "ServiceType": "AirportTransfer", > "MaximumPassengers": "99", > "ShortDescription": "Airport PMI to Resorts PMI/Shared" > }, > "Shuttle": { > "ServiceLocation": [ > { > "Address": { > "LocationType": { > "Code": "11", > "UniqueId": "AMTSES1234", > "ResourceName": "54123", > "DescriptionDetail": "Hotel Happy 1" > }, > "Latitude": "3.12345", > "Longitude": "6.12345", > "Distance": "8" > }, > "PickupInd": "true", > "Sequence": "1" > }, > { > "Address": { > "LocationType": { > "Code": "11", > "UniqueId": "AMTSES1235", > "ResourceName": "54163", > "DescriptionDetail": "Hotel Happy 2" > }, > "Latitude": "3.12366", > "Longitude": "6.565", > "Distance": "34" > }, > "PickupInd": "true", > "Sequence": "2" > } > ] > }, > "TotalCharge": { > "CurrencyCode": "EUR", > "Amount": "45.00" > } > } > ] > }, > "Warnings": { > "Warning": { > "Type": "3", > "Code": "507", > "_text": "Service S0000/S0000 is OnRequest" > } > }, > "xmlns": "http://www.opentravel.org/OTA/2003/05", > "EchoToken": "geocode-xyz", > "Version": "2016.2" > } > } > ``` ## Best Practices 1. **Always echo** the request token in `EchoToken`. 2. **Validate totals** before booking—`TotalCharge` is authoritative at search time. 3. **Cancellations**: apply the rule with the deadline closest to the service start date. 4. **Extras**: treat `RequiredInd="true"` as mandatory and auto‑include in pricing.