Data
Zdroje dat pro import zájezdů na tento web Řecko v detailech
Možné zdroje dat pro import zájezdů
Abychom mohli zobrazit Vaší nabídku a Vaše zájezdy, potřebujeme to na web nějak dostat. V současné době jsou možné tři formáty dat, které jsme schopni zpracovat a udržovat tak Vaše data stále aktuální.
Jsou to formáty:
- Formát dat pro MagicWare
- Formát dat pro Invii
- Vlastní formát XML dle níže uvedeného popisu - jestliže již jednou data v elektronické podobě máte, je pro programátory otázka chvilky vytvořit scipt, který je upraví do požadovaného formátu a bude je udržovat aktualizovaná.
- Nemáte-li vlastní zdroj dat, respektive data v elektornické podobě či někoho, kdo je schopen úpravu provést, kontaktujte nás.
Upozornění pro CK - důležité
V současné době jsou na webu data spravována různými způsoby a velmi často nejsou aktuální (což může být i důvodem nízkého nebo bulového prodeje některých CK) . Tento stav je neudržitelný. Jsme nuceni přistoupit ke kroku, kdy pokud nebudeme mít od cestovního kanceláře, z nabídky na tomto webu bude stažena.
Popis dat pro import zájezdů a hotelů
Kódování UTF-8
Při aktualizaci dat na webu, například Last, First či speciální akce, si musíme vždy bstáhnout celé XML. Není tedy možné stahovat třeba jen lasty ze samostatného souboru. Fotografie se stahují pouze při prvním importu, nedochází tedy ke stahování nadměrných objemů.
Vzor dat XML
Popis jednotlivých částí
Název CK (root)
Tag <agency> tvoří kořen XML souboru. Název CK musí obsahovat pouze numerické a alfanumerické znaky a musí být jednoznačný v rámci našeho systému. Z toho důvodu je nutné ověřit, zda název není používán jinou CK. Pokud však za název zvolíte jméno CK, duplicita je vyloučena.
Hotel, ubytovací zařízení (parent : <agency>)
Atribut | Popis | Může být prázdný |
name | zobrazuje se v nabídce zákazníkům | Ne |
site | Středisko | Ne |
area | oblast v dané zemi (např. pro Řecko název ostrova Kréta) | Ne |
countryCode | id země (viz. optCountry.xml) | Ne |
code | identifikátor ubytovacího zařízení (jedinečný v rámci vaší CK) | Ne |
stars | Počet hvězd hotelu (např. 3 nebo 3.5) | Ano |
Popis hotelu, ubytovacího zařízení (parent : <hotel>)
Obsahuje údaje o ubytovacím zařízení.
Tag | Popis | Může být prázdný |
<desc> | Obsahuje popisné údaje o hotelu. Můžete použít HTML značky: h3,p,strong,ul,li,ol | Ano |
Fotografie (parent : <hotel>)
Tagy <photo> obsahují cestu k fotografiím. Pokud data neposkytujete prostřednictvím URL adres ale např. ve formě jednoho ZIP archivu, cesta bude ve formátu
E: Tour_Images azev_CK azev_fotky.jpg, kde nazev_CK je stejný string jako v atributu „id“ v <agency> . Pokud jsou jednotlivé soubory v ZIP archivu strukturovány do podadresářů, místo „nazev_fotky.jpg“ se uvede cesta k rootu ZIP archivu.
Seskupovací (vyhledávací) informace (parent : <hotel>)
Tento tag slouží k seskupení zájezdů podle určitých kritérií pro vyhledávaní podle klíčových informací.
Aribut | Popis | Může být prázdný |
departurePoint | odletové/odjezdové místo – název v 1.pádě (Praha, Brno, ...) | Ne |
boardBasis | typ stravování (viz. optBoardBasis.xml) | Ne |
transportation | způsob dopravy (viz. optTransportation.xml) | Ne |
id | zatím se nezpracovává | Ano |
Termín zájezdu (parent : <tour>)
Specifikace konkrétního termínu zájezdu.
Aribut | Popis | Může být prázdný |
priceFrom | „cena od“ jak ji chcete prezentovat (většinou cena 1dosp./pokoj) | Ne |
taxes | součet povinných tax | Ano |
from | datum odjezdu ve formátu dd.mm.YYYY | Ne |
to | datum příjezdu ve formátu dd.mm.YYYY | Ne |
type | příznak akční nabídky FIRST/LAST (viz. optType.xml) | Ano |
Cenové položky zájezdu (parent : <date>)
Jednotlivé cenové položky vztahující se k nadřazenému termínu.
Aribut | Popis | Může být prázdný |
desc | popis ceny | Ne |
price | cena v dále uvedené měně | Ne |
duty | příznak příplatku (viz. optDuty.xml) – prázdné nebo nula se uvažuje jako standardní cenová položka | Ano |
currency | standardní zkratka ceny (CZK, EUR, USD) – pokud je prázdná, cena se uvažuje v CZK | Ano |
Popis ceny (parent : <date>)
Text uvedený v tagu je určen k dodatkovým informacím k ceně, typicky “cena zahrnuje / nezahrnuje”. Taxy a příplatky je možné uvést pouze zde (pak ovšem klient nebude moci započítat příplatky do kalkulace na našem webu a bude ji muset připočítat mimo náš rezervační systém). Proto je lépe uvést příplatky jako cenovou položku a nastavi se odpovídající přiznak (viz. tag <price>).
Volby stravy:
<?xml version="1.0" encoding="utf-8"?>
<boardbasis>
<type id="0" name="neznamý" />
<type id="1" name="žádný" />
<type id="2" name="snídaně" />
<type id="3" name="polopenze" />
<type id="4" name="plná penze" />
<type id="5" name="all inclusive" />
<type id="6" name="ultra all inclusive" />
<type id="7" name="večeře" />
<type id="8" name="kombinovaný" />
</boardbasis>
Volby země:
<?xml version="1.0" encoding="utf-8"?>
<countries>
<country name="Bulharsko" id="52" />
<country name="Turecko" id="53" />
<country name="Egypt" id="54" />
<country name="Řecko" id="55" />
</countries>
Popisy poplatků:
<?xml version="1.0" encoding="utf-8"?>
<duty>
<type id="1" name="povinný příplatek" /> <!-- letištní taxy, pobytové taxy, transfery, ... -->
<type id="2" name="nepovinný příplatek" /> <!-- trezor, pes, příplatek za polopenzi ... -->
</duty>
Popisy dopravy
<?xml version="1.0" encoding="utf-8"?>
<transportation>
<type id="1" name="vlastní" />
<type id="2" name="letecky" />
<type id="3" name="autobus" />
<type id="4" name="jiný" />
<type id="5" name="loď" />
<type id="6" name="kombinovaný" />
</transportation>
Popisy typu zájezdu
<?xml version="1.0" encoding="utf-8"?>
<type>
<type id="1" name="first minute" />
<type id="2" name="last minute" />
<type id="3" name="speciální nabídka" />
<type id="4" name="normal" />
</type>