Importing

We load the XML feed at regular intervals (approx. once a day). If the XML feed contains an error (HTTP error, invalid XML), you will receive an email once a day and a notification will appear in the menu at the top right on Muj.Skrz.cz.

Example

<?xml version="1.0" encoding="utf-8"?>
<TOURS>
     <!-- currency id according to the "currency" code -->
     <CURRENCY_ID>1</CURRENCY_ID>
     <!-- example of a residential trip -->
     <TOUR>
         <!-- unique trip ID generated by CK -->
         <TOUR_ID>A123456</TOUR_ID>
         <!-- ID "type of trip" according to the number-->
         <TOUR_TYPE>101</TOUR_TYPE>
         <!-- trip detail url -->
         <TOUR_DETAIL_URL>http://www.ck.cz/detail-zajezdu</TOUR_DETAIL_URL>
         <!-- detour priority -->
         <TOUR_PRIORITY>0</TOUR_PRIORITY>
         <!-- specified country and area of travel -->
         <LOCATIONS>
             <LOCATION>
                 <!-- ISO country code according to the "country" code -->
                 <COUNTRY_ID>AUT</COUNTRY_ID>
                 <!-- text area name-->
                 <AREA_TITLE></AREA_TITLE>
                 <!-- text name of the place -->
                 <PLACE_TITLE></PLACE_TITLE>
             </LOCATION>
         </LOCATIONS>
         <!-- name of the trip -->
         <TOUR_TITLE>Odpočiňte si u moře v moderním hotelu Paradise</TOUR_TITLE>
         <!-- text description of the trip.-->
         <TOUR_DESC>Týden strávený v klidu u moře s horami v zádech, k dispozici je 
        sauna, venkovní bazén, vše v ceně</TOUR_DESC>

         <ACCOMMODATION>
             <!-- type of accommodation -->
             <TYPE>Hotel</TYPE>
             <!-- ID of accommodation level according to the code "accommodation level" -->
             <CLASS_ID>3</CLASS_ID>
             <!-- accommodation coordinates in the format 60.2233-->
             <GPS>
                 <LAT>60.2233</LAT>
                 <LON>114.1234</LON>
             </GPS>
             <!-- name of accommodation -->
             <TITLE>Paradise Hotel</TITLE>
             <!-- Accommodation location descriptions -->
             <LOCATION_DESCS>
                 <LOCATION_DESC title="Location">Hotel se nachazi v klidne obasti 200m
                od moře a 500m od centra mesta.</LOCATION_DESC>
                 <LOCATION_DESC title="Nadpis2">Popis2</LOCATION_DESC>
             </LOCATION_DESCS>

             <!-- descriptions of equipment and accommodation options -->
             <ACCOMMODATION_DESCS>
                 <ACCOMMODATION_DESC title="Vybavení">Hotel byl rekonstruovan v roce 
                2000 a splnuje tak pozadavky i tech nejnarocnejsich zakazniku. mezi 
                vybaveni patri bazen, posilovna a herna pro 
                deti.</ACCOMMODATION_DESC>
             </ACCOMMODATION_DESCS>
         </ACCOMMODATION>


         <!-- list of photos for the trip -->
         <PHOTOS>
             <PHOTO>
                 <!-- order the photos in the list on the website -->
                 <ORDER>1</ORDER>
                 <!-- photo url -->
                 <URL>http://www.xyz.cz/fotka1.jpg</URL>
                 <!-- photo description -->
                 <DESC>Paradise Hotel</DESC>
             </PHOTO>
             <PHOTO>
                 <ORDER>2</ORDER>
                 <URL>http://www.xyz.cz/fotka2.jpg</URL>
                 <DESC>Pristup k mori</DESC>
             </PHOTO>
         </PHOTOS>

        <!-- list of specifying tags for the trip -->
         <TAGS>
             <TAG>dovolená u moře</TAG>
             <TAG>first minute</TAG>
         </TAGS>

         <!-- tour options -->
         <TERM_GROUPS>
             <TERM_GROUP>
                 <!-- Food ID according to the code "food" -->
                 <BOARD>
                     <ID>5</ID>
                     <!-- description of the meals of the trip -->
                     <DESC>Stravovani je zajisteno v budove hotelu. Snidane formou 
                    bufetu, vecere servirovane.</DESC>
                 </BOARD>

                 <!-- turn right -->
                 <TRANSPORT>
                     <ID>3</ID>
                 </TRANSPORT>

                 <!-- list of departure points -->
                 <DEPT_PLACES>
                     <PLACE>Prague</PLACE>
                     <PLACE>Brno</PLACE>
                 </DEPT_PLACES>

                 <!-- list of items that are included in the tour price -->
                 <PRICE_INCL>
                     <ITEM>
                         <DESC>8x nocleh v hotelu</DESC>
                     </ITEM>
                     <ITEM>
                         <DESC>letistni a palivove priplatky</DESC>
                     </ITEM>
                 </PRICE_INCL>

                 <!-- list of items that are not included in the tour price -->
                 <PRICE_EXCL>
                     <ITEM>
                         <DESC>viza</DESC>
                     </ITEM>
                     <ITEM>
                         <DESC>fakultativni vylety</DESC>
                     </ITEM>
                 </PRICE_EXCL>

                 <!-- list of possible discounts for the trip -->
                 <DISCOUNTS>
                     <ITEM>
                         <DESC>Sleva 10 % za nákup do 22.6.2022</DESC>
                     </ITEM>
                 </DISCOUNTS>

                <TERMS>
                     <!-- information about a specific term -->
                     <TERM>
                         <!-- Term ID -->
                         <ID>22222</ID>
                         <!-- initial day of travel, year-month-day -->
                         <START>2022-07-14</START>
                         <!-- end day of the trip, year-month-day -->
                         <END>2022-07-22</END>
                         <!-- count in -->
                         <DAY_COUNT>9</DAY_COUNT>
                         <!-- number of nights -->
                         <NIGHT_COUNT>8</NIGHT_COUNT>
                         <!-- pricing section -->
                         <PRICES>
                             <!-- specific price item of the term -->
                             <PRICE>
                                 <!-- ID of the price description according to the number "type of price description" -->
                                 <DESC_ID>1</DESC_ID>
                                 <!-- final price -->
                                 <FINAL_PRICE>20000</FINAL_PRICE>
                             </PRICE>
                            
                             <!-- example price for children 6-12 -->
                             <PRICE>
                                 <!-- determined by the type of person -->
                                 <DESC_ID>2</DESC_ID>
                                 <!-- determined by the age of the child -->
                                 <AGE_FROM>6</AGE_FROM>
                                 <AGE_TO>12</AGE_TO>
                                 <FINAL_PRICE>15000</FINAL_PRICE>
                             </PRICE>
                            
                             <!-- example of the price of the 2nd child at the same age (as the previous one
                             dite) free-->
                             <PRICE>
                                 <!-- determined by the type of person -->
                                 <DESC_ID>2</DESC_ID>
                                 <!-- determined by the age of the child -->
                                 <AGE_FROM>6</AGE_FROM>
                                 <AGE_TO>12</AGE_TO>
                                 <FINAL_PRICE>0</FINAL_PRICE>
                             </PRICE>
                            
                             <!-- example of a prize for a senior over 60 -->
                             <PRICE>
                                 <DESC_ID>3</DESC_ID>
                                 <AGE_FROM>60</AGE_FROM>
                                 <FINAL_PRICE>15000</FINAL_PRICE>
                             </PRICE>
                             <PRICE_ORIG>22000</PRICE_ORIG>
                             <DISCOUNT>10</DISCOUNT>
                         </PRICES>
                         <DEPOSIT>999.00</DEPOSIT>

                         <!-- link to the script that verifies the availability of the term -->
                         <AVAILABILITY>http://www.ck.cz/zjistovani-
                         availability.php?termin=122234</AVAILABILITY>
                         <!-- link to the order for a specific appointment on the ck website -->
                         <PURCHASE_URL>http://www.ck.cz/nazev-zajezdu/objednavka-
                         termin.php?termin=122234</PURCHASE_URL>
                     </TERM>
                 </TERMS>
             </TERM_GROUP>
         </TERM_GROUPS>
     </TOUR>
</TOURS>

Elements

<TOURS>

Required	yes
Repeat	no
Type	document root element

The root element, it is contained only once at the top level in the document.

<CURRENCY_ID>

Required	yes
Repeat	no
Type	integer
Example	<CURRENCY_ID>1</CURRENCY_ID> = Czech Koruna

Indicates the currency in which all prices are in the given XML feed. Currently, only Czech koruna with ID 1 is supported.

<TOUR>

Required	yes
Repeat	yes
Type	wrapper element

The element combines information for one trip. It can appear more than once in a document. If, for example, I have 5 tours, the skeleton of the XML feed (<TOUR> sub-elements are omitted) will look like this:

<?xml version="1.0" encoding="utf-8"?>
<TOURS>
     <CURRENCY_ID>1</CURRENCY_ID>
     <TOUR>
         <TOUR_ID>101</TOUR_ID>
         <!-- ... -->
     </TOUR>
     <TOUR>
         <TOUR_ID>102</TOUR_ID>
         <!-- ... -->
     </TOUR>
     <TOUR>
         <TOUR_ID>103</TOUR_ID>
         <!-- ... -->
     </TOUR>
     <TOUR>
         <TOUR_ID>104</TOUR_ID>
         <!-- ... -->
     </TOUR>
     <TOUR>
         <TOUR_ID>105</TOUR_ID>
         <!-- ... -->
     </TOUR>
</TOURS>

<TOUR_ID>

Required	yes
Repeat	no
Type	string
Example	<TOUR_ID>42</TOUR_ID>, <TOUR_ID>400-ABC-15</TOUR_ID>

Your unique tour ID, 1 tour/stay = 1 ID. The ID must never be changed in the future, or used for other products! The ID must match the ID sent in the conversion code.

Each offer must have a unique ID that never changes during the offer's history. We do not identify the offer based on the URL, because the offer can be duplicated by changing the parameters in the URL.

<TOUR_TYPE>

Required	yes
Repeat	no
Type	number
Example	<TOUR_TYPE>101</TOUR_TYPE>

It determines the type of tour according to the following code:

<TOUR_DETAIL_URL>

Required	yes
Repeat	no
Type	string
Example	<TOUR_DETAIL_URL>http://cestovni-kancelar.cz/pobyt-123</TOUR_DETAIL_URL>

You will be redirected to this page if you wish to find out more about the tour.

<TOUR_PRIORITY>

Required	no
Repeat	no
Type	number
Example	<TOUR_PRIORITY>0</TOUR_PRIORITY>

Indicates the priority of the trip. The lower, the more important the stay - 0 = highest priority.

<LOCATIONS>

Required	yes
Repeat	no
Type	wrapper element

Wraps a list with individual elements <LOCATION>.

<LOCATION>

Required	yes
Repeat	yes
Type	wrapper element

Wraps a list of elements <LOCATION_DESC>.

<COUNTRY_ID>

Required	yes
Repeat	no
Type	string
Example	<COUNTRY_ID>CZE</COUNTRY_ID> (= Czech Republic)

Destination country code. Country codes:

<AREA_TITLE>

Required	no
Repeat	no
Type	string
Example	<AREA_TITLE>Antalya</TOUR_PRIORITY>

Text name of the area. Must not match country name.

<PLACE_TITLE>

Required	no
Repeat	no
Type	string
Example	<PLACE_TITLE>Kumkoy Beach</PLACE_TITLE>

Text name of places. It must not match the area name.

<TOUR_TITLE>

Required	yes
Repeat	no
Type	string
Example	<TOUR_TITLE>Relax by the sea at the modern Paradise Hotel</TOUR_TITLE>

Name of the tour. Use only alphanumeric characters, the tour name (including spaces) should be a maximum of 80 characters long.

<TOUR_DESC>

Required	yes
Repeat	no
Type	string
Example	<TOUR_DESC>0</TOUR_DESC>

Tour description.

<ACCOMMODATION>

Required	yes
Repeat	no
Type	wrapper element

It covers elements related to accommodation:

• <TYPE>
• <CLASS_ID>
• <TITLE>
• <GPS>
• <LOCATION_DESCS>
• <ACCOMMODATION_DESCS>

<TYPE>

Required	yes
Repeat	no
Type	string
Example	<TYPE>Hotel</TYPE>

Text description of the type of accommodation. If the tour is without accommodation, enter Without accommodation.
We recommend using the following expressions:

• hotel - hotel accommodation
• pension - accommodation in a pension
• apartment - accommodation in an apartment
• bungalow - accommodation in a bungalow-type summer building
• cottage - accommodation in a cottage, a full-fledged house
• cottage - stay in a cottage, often without sanitary facilities
• srub - stay in a Scandinavian-style cottage, wooden structure
• mobile home - stay in a mobile home
• camping - staying in a campsite, in a caravan or in a tent
• farmhouse - stay on a farm
• hostel - stay in group rooms with shared sanitary facilities
• botel - stay in a floating hotel
• houseboat - stay in a floating house
• spa - stay in a spa

<CLASS_ID>

Required	yes
Repeat	no
Type	string
Example	<CLASS_ID>11</CLASS_ID>

It determines the level of accommodation. Values according to the dial:
(Those accommodation facilities that meet more than just the mandatory criteria and the minimum number of optional criteria within the individual classification classes can receive the "+" designation in addition to the "star" designation)

<TITLE>

Required	no (yes for residential tours)
Repeat	no
Type	string
Example	<TITLE>Sun Island Resort & Spa</TITLE>

Name of accommodation/hotel. Can't contain stars or price!

<GPS>

Required	no
Repeat	no
Type	wrapper element

Wraps <LAT> and <LON>.

<LAT>

Required	no
Repeat	no
Type	decimal number
Example	<LAT>60.2233</LAT>

Latitude.

<LON>

Required	no
Repeat	no
Type	decimal number
Example	<LON>114.1234</LON>

Longitude.

<LOCATION_DESCS>

Required	no (yes in the absence of other descriptions)
Repeat	no
Type	wrapper element

Wraps a list of elements <LOCATION_DESC>.

<LOCATION_DESC>

attribute

Required	no
Repeat	yes
Type	string
The title	Type of description, eg Location, Environment.
Example	<LOCATION_DESC title="Location">The hotel is located in a quiet area 200m from the sea and 500m from the city center.</LOCATION_DESC>

Describes the location of the accommodation.

<ACCOMMODATION_DESCS>

Required	no (yes in the absence of other descriptions)
Repeat	no
Type	wrapper element

Wraps a list of <ACCOMMODATION_DESC> elements.

<ACCOMMODATION_DESC>

attribute

Required	no
Repeat	no
Type	string
The title	Type of description, eg Equipment.
Example	<ACCOMMODATION_DESC title="Equipment">The hotel was reconstructed in 2000 and thus meets the requirements of even the most demanding customers. Facilities include a swimming pool, gym and children's playroom.</ACCOMMODATION_DESC>

Describes room equipment and accommodation options.

<PHOTOS>

Required	yes
Repeat	no
Type	wrapper element

Wraps a list of <PHOTO> elements.

<PHOTO>

Required	no
Repeat	no
Type	wrapper element

Wraps elements related to one photo:

• <ORDER>
• <URL>
• <DESC>

<PHOTO>/<ORDER>

Required	yes
Repeat	no
Type	number
Example	<ORDER>1</ORDER>

Photo serial number, 1 = first photo, 2 = second photo.

<PHOTO>/<URL>

Required	yes
Repeat	no
Type	string
Example	<URL>http://www.dovolenkovyserver.cz/fotkaXYZ.jpg</URL>

URL where the photo is located.

<PHOTO>/<DESC>

Required	yes
Repeat	string
Type	number
Example	<DESC>Enter Hotel</DESC>

Photo description.

<TAGS>

Required	no
Repeat	no
Part of the official specification	no
Type	wrapper element

Wraps <TAG> elements. This tag is not part of the official Sdovolená specification, it is only functional on Skrz.cz

<TAG>

Required	no
Repeat	yes
Part of the official specification	no
Type	string
Example	<TAG>New Year's Eve stay</TAG>, <TAG>wellness stay</TAG>, <TAG>first minute</ TAG>

Word characteristic of value (keywords).

For accommodation offers only fill in the terms listed below. Do not fill in a specific provider or address.

<TERM_GROUPS>

Required	yes
Repeat	no
Type	wrapper element

Contains individual tour variants in <TERM_GROUP>.

<TERM_GROUP>

Required	yes
Repeat	yes
Type	wrapper element

Tour variant.

<BOARD>

Required	yes
Repeat	no
Type	wrapper element

Type of diet.

<BOARD>/<ID>

Required	yes
Repeat	no
Type	integer
Example	<ID>5</ID>

Catering type dial:

<BOARD>/<DESC>

Required	yes
Repeat	no
Type	integer
Example	<DESC>Boarding is provided at the hotel for both breakfast, lunch and dinner</DESC>

Text description of the eating method.

<TRANSPORT>

Required	yes
Repeat	no
Type	wrapper element

Transport type.

<TRANSPORT>/<ID>

Required	yes
Repeat	no
Type	integer
Example	<ID>5</ID>

Transport type code:

<DEPT_PLACES>

Required	yes
Repeat	no
Type	wrapper element

Places of departure. The attribute is optional only for self-transportation tours, where it does not make sense.

<DEPT_PLACES>/<PLACE>

Required	yes
Repeat	yes
Type	string
Example	<PLACE>Prague</PLACE>

Place of departure/departure for the given stay. Enter only the name of the cities, without any other information. What term_group is ONE dept_place. The attribute is optional only in the case of a stay with own transport, where it does not make sense.

<PRICE_INCL>/<ITEM>

Required	no
Repeat	no
Type	wrapper element

Items/services included in the final price.

<PRICE_INCL>/<ITEM>/<DESC>

Required	no
Repeat	no
Type	string
Example	<DESC>5</DESC>

Description of what the final price includes.

<PRICE_EXCL>/<ITEM>

Required	no
Repeat	no
Type	wrapper element

Items/services not included in the final price.

<PRICE_EXCL>/<ITEM>/<DESC>

Required	no
Repeat	no
Type	string
Example	<DESC>5</DESC>

Description of what is not included in the final price.

<DISCOUNTS>/<ITEM>

Required	no
Repeat	no
Type	wrapper element

Discounted price.

<DISCOUNTS>/<ITEM>/<DESC>

Required	no
Repeat	no
Type	string
Example	<DESC>5</DESC>

Discount description.

<TERMS>

Required	yes
Repeat	no
Type	wrapper element

Wraps a list of terms.

<TERM>

Required	yes
Repeat	yes
Type	wrapper element

Specific date.

<TERM>/<ID>

Required	yes
Repeat	no
Type	integer
Example	<ID>12345</ID>

The ID of a specific term.

<TERM>/<START>

format

Required	yes
Repeat	no
Type	date in YYYY-MM-DD
Example	<START>2015-03-05</START>

Term start date. Must be before <END>.

<TERM>/<END>

format

Required	yes
Repeat	no
Type	date in YYYY-MM-DD
Example	<END>2015-03-15</END>

Term start date. Must be before <START>.

<TERM>/<DAY_COUNT>

Required	yes
Repeat	no
Type	integer
Example	<DAY_COUNT>7</DAY_COUNT>

Number of days.

<TERM>/<NIGHT_COUNT>

Required	yes
Repeat	no
Type	integer
Example	<NIGHT_COUNT>6</NIGHT_COUNT>

Number of nights.

<PRICES>

Required	yes
Repeat	no
Type	wrapper element

Price list.

<PRICE>

Required	yes
Repeat	yes
Type	wrapper element

Price list item.

<PRICE>/<DESC_ID>

Required	yes
Repeat	no
Type	integer
Example	<DESC_ID>6</DESC_ID>

Type of price list item:

<PRICE>/<AGE_FROM>

Required	no
Repeat	no
Type	integer
Example	<AGE_FROM>6</AGE_FROM>

Lower age limit.

<PRICE>/<AGE_TO>

Required	no
Repeat	no
Type	integer
Example	<AGE_TO>60</AGE_TO>

Upper age limit.

<PRICE>/<FINAL_PRICE>

Required	yes
Repeat	no
Type	integer, decimal
Example	<FINAL_PRICE>6999</FINAL_PRICE>

Final price.

<PRICE_ORIG>

Required	yes
Repeat	no
Part of the official specification	no
Type	integer, decimal
Example	<PRICE_ORIG>8000</PRICE_ORIG>

So that we can realistically evaluate how big a discount it is, please give us the price before the discount.

<DISCOUNT>

Required	no
Type	integer
Example	<DISCOUNT>42</DISCOUNT>

Percentage discount of this variant.

<DEPOSIT>

Required	no
Repeat	no
Part of the official specification	no
Type	integer, decimal
Example	<DEPOSIT>0</DEPOSIT>, <DEPOSIT>150.00</DEPOSIT>

This tag is not part of the official Sdovolená specification, it is only functional on Skrz.cz

A deposit for the stay, which the customer must pay immediately upon placing the order.

With offers, it is always necessary to state the final price <PRICES> that the customer has to pay (as determined by ČOI), not just the deposit! That's why we created this special tag in XML, in which you fill in the amount of the deposit. The customer will then be adequately informed about the price and deposit on Skrz.cz. Offers that do not respect this rule will be turned off during inspection.

The Deposit tag is at the <TERMS> level, so the value can be different for each term of stay if necessary. If the deposit is the same for all dates of stay, enter the same values in the tag.

<TERM>/<AVAILABILITY>

Required	no
Repeat	no
Type	string
Example	<AVAILABILITY>http://www.ck.cz/zjistovani-dostupnosti.php?termin=122234</AVAILABILITY>

URL to check the availability of the date.

<TERM>/<PURCHASE_URL>

Required	no
Repeat	no
Type	string
Example	<PURCHASE_URL>http://www.ck.cz/objednavka.php?termin=122234</PURCHASE_URL>

URL for ordering a tour on the given date.