Data

6 min.

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>

Naše tipy na zájezdy