MANUÁL K XML SOUBORŮM KOVOTOUR PLUS Každý dokument obsahuje minimálně následující uzly: •
Hotel (všeobecné informace k akci, které se nemění v čase)
•
Termin (seznam nastupních sermínů včetně pobytového zařízení a upřesnění produktu – „Hladiny“)
•
Cena (ceník vztažený k řádku uzlu „Termin“ )
•
Popisy ( kategorizovaný upřesňující popisi k akci)
•
Obrázky (seznam obrázků k akci, pouze názvy )
•
Instrukce ( pro prodej individuálních zájezdů )
XML dokument tablo uzel „Hotel“ Všeobecné informace k akci, které se nemění v čase. tour_id
označení akce ( jednoznačné )
country
Země
location
Místo
hotel
hotel (název)
class
kategorie hotelu
country2
alternativní země
location2
alternativní oblast
place2
alternativní místo
country_list
země seznam (pro poznávací zájezdy přes více zemí
url_detail
url s popisem hotelu
category
katalog (ikony systém., katalog.)
XML dokument tablo uzel „Termin“ Kompletní seznam nabízených kapacit s provázáním na dopravy, nástupní místa a upřesnění produktu ( počet noc, typ stravy, typ dopravy ). list_id
id_řádku
tour_id
označení akce ( jednoznačné )
booking_unit
typ pokoje
booking_unit_description
upřesnění pokoje (popis)
date_start
začátek nástupu na zájezd
date_exit
konec zájezdu
booking_unit_available
je pokoj k dispozici (0=NE, 1=ANO)
air_transport_there_unit_available
je k dispozici letecká doprava TAM (0=NE, 1=ANO)
bus_transport_there_unit_available
je k dispozici bus doprava TAM (0=NE, 1=ANO)
air_transport_back_unit_available
je k dispozici letecká doprava ZPĚT(0=NE,1=ANO)
bus_transport_back_unit_available
je k dispozici bus doprava ZPĚT (0=NE, 1=ANO)
rule_description
upřesnění produktu (hladina)
Days
počet dní zájezdu
Nights
počet nocí zájezdu
air_transport_start_date
nástup na leteckou dopravu TAM
bus_transport_start_date
nástup na bus dopravu TAM
air_transport_exit_date
výstup z letecké dopravy
bus_transport_exit_date
výstup z bus dopravy
url_booking
url pro rezervaci
picture_description
název hlavního obrázu k hotelu
unit_price_adult_from
cena za dospělou osobu od (bez Povinných příplatků)
own_transport
je povolena individuální doprava (N=NE, A=ANO)
food_included
možné typy stravy v termínu
transfer_included
možné typy transferu
is_lastminute
je nabídka LastMinute (N=NE, A=ANO)
route_pick_up
nástupní místa na svoz
bus_departure_from
nástupní místa na odjezd bus
air_departure_from
nástupní místa na odjezd letecky
booking_unit_layout
možné obsazovací plány pokoje. Jsou zadány jeko řetězce oddělene pomoci čárky. Např. AAA,AAC,ACC,ACS. „A“ znamená dospělou osobu. „C“ znamená ditě. „S“ znamená dítě bez nároku na lůžko. Příslušné věkové limity pro „C“ a „S“ jsou uvedeny v následujících položkách.
infant_age_limit
věkový limit pro infanta
child_age_limit
věkový limit pro dítě
child2_age_limit
věkový limit pro dítě bez nároku na lůžko
own_term_available
je možný individuální termín (A=ANO, N=NE)
XML dokument tablo uzel „Ceny“ Kompletní seznam nabízených cen k řádku (list_id) uzlu „Termín“. list_id
id řádku (odkaz do termin)
price_description
slovní popis ceníkové položky
price_per_booking_unit
cena na osobu / apartmán
age_limit_from
věkový limit klienta od
age_limit_to
věkový limit klienta do
price_type
Základní cena, Povinný příplatek, Nepovinný příplatek
price_bed
Základní lůžko / přistýlka / dítě bez nároku na lůžko
price_bed_number
Pořadí lůřka
price_persons_in_apartment
počet osob v apartmanu
price_template
název ceníku (základní ceník = Univers, LM ceník=LastMinute)
price_currency
kód měny
unit_price_currency
prodejní cena
price_caption
upoutávka na speciální nabídku. Typicky zájezdy, které se zobrazí na titulní stránce CK. Povolené hodonty jsou: “S“ Superlast, „F“ FisrtMoment, „L“LastMoment, „K“ Katalogová upoutávka.
price_food_included
strava v ceně (seznam typu stravy)
price_transfer_included
transfer v ceně (seznam typu dopravy)
price_insurance_included
pojištění v ceně (N=NE, A=ANO)
price_sale_type
je cena závislá na termínu (naklad=ANO, pousal=NE)
price_nights
pokud price_sale_type=naklad, tak zde je uvedeno na kolik je nocí. Jinak je vždy 0.
XML dokument tablo uzel „Popisy“ Kategorizovaný upřesňující popis k akci.
- konkrétní hodnota klíče je závisla od každé jednotlivé CK.
slovní vyjádření klíče
XML dokument tablo uzel „Obrazky“ Kategorizovaný upřesňující popis k akci. filename
Název obrázku. Konkrétní umístění obrázků je potřeba dohodnou s CK.
XML dokument tablo uzel „Instrukce“ Pokud je v uzlu „Termin“ hodnota položky „own_term_available“ povolena, tak v této sekci se zjistí pravidla pro individuální pobyty. date_start
začátek platnosti instrukce
date_exit
konec platnosti instrukce
booking_unit
typ pokoje, pokud zadán, tak instrukce se vztahuje pouze pro zadaný pokoj
rule_description
upřesnění produktu (hladina) , tak instrukce se vztahuje pouze pro zadanou hladinu
monday_available
Je možné nastoupit v pondělí (A=ANO, N=NE)
monday_min_days
pokud je povoleno, tak minimální počet nocí.
monday_max_days
pokud je povoleno, tak maximální počet nocí.
tuesday_available
Je možné nastoupit v úterý (A=ANO, N=NE)
tuesday_min_days
pokud je povoleno, tak minimální počet
nocí.
tuesday_max_days
pokud je povoleno, tak maximální počet nocí.
wednesday_available
Je možné nastoupit ve středu (A=ANO, N=NE)
wednesday_min_days
pokud je povoleno, tak minimální počet nocí.
wednesday_max_days
pokud je povoleno, tak maximální počet nocí.
thursday_available
Je možné nastoupit ve čtvrtek (A=ANO, N=NE)
thursday_min_days
pokud je povoleno, tak minimální počet nocí.
thursday_max_days
pokud je povoleno, tak maximální počet nocí.
friday_available
Je možné nastoupit v pátek (A=ANO, N=NE)
friday_min_days
pokud je povoleno, tak minimální počet nocí.
friday_max_days
pokud je povoleno, tak maximální počet nocí.
saturday_available
Je možné nastoupit v sobotu (A=ANO, N=NE)
saturday_min_days
pokud je povoleno, tak minimální počet nocí.
saturday_max_days
pokud je povoleno, tak maximální počet nocí.
sunday_available
Je možné nastoupit v neděli (A=ANO, N=NE)
sunday_min_days
pokud je povoleno, tak minimální počet nocí.
sunday_max_days
pokud je povoleno, tak maximální počet
nocí.
Výpočet ceny má několik základních schémat Schéma 1. price_per_booking_unit = „apartman“ a type = „zakladni“ Ceníková položka zahrnuje cenu za celý pokoj. To je celková cena za pokoj. Pokud je ale uvedeno persons_in_apartment (>0), tak je potřeba znát počet osob a použít cenu dle počtu persons_in_apartment. type = „povinne“ Povinné příplatky. Aplikují se 1x pro každou osobu v pokoji ( kapacita pokoje časti booking_unit ). Je ale potřeba přihlédnout k věkovému limitu klienta. type = „nepovinne“ Nepovinné příplatky. Uživatel je může volitelně přiobjednat.
Schéma 2. price_per_booking_unit = „za osobu“ a type = „zakladni“ Ceníková položka zahrnuje cenu za lůžko. K přesnému určení ceny je potřeba znát strukturu obsazení pokoje ( počet dospělých, dětí a kdo je na přistýlce ). Každé osobě se přiřadí cena podle bed = „luzko“ osoba je na pevném lůžku. bed = „pristylka“ osoba je na přistýlce. Ověřit č.přistýlky bed_numer ( dítě na 1. a 2. přistýlce může mít jinou cenu ) bed = „dite bez naroku na luzko“ osoba je infant. V případě „luzko“ a „pristylka“ se kontroluje věkový limit. Pokud se neobsadí veškerá pevná lůžka v pokoji, tak se připočte cena za emptybed. type = „povinne“ Povinné příplatky. Aplikují se 1x pro každou osobu v pokoji ( kapacita pokoje časti booking_unit ). Je ale potřeba přihlédnout k věkovému limitu klienta. type = „nepovinne“ Nepovinné příplatky. Uživatel je může volitelně přiobjednat.