Načítání

Kapacitní feed načítáme v krátkém pravidelném intervalu (cca jednou za 15 minut).

Pokud položka s určitým ID ve feedu chybí, její kapacita se nezapočítává a tím se snižuje její váha ve výpisu nabídek na Skrz.cz.

Vyměnitelnost dat

Skrz.cz se snaží o kultivaci trhu a proto jsme schopni feed ve stejném formátu obohacený o dostupnost získanou z našich zdrojů poskytovat našim partnerům. Pro export našich dat prosím kontaktujte naše obchodní zástupce

Příklad exportu

<?xml version="1.0" encoding="utf-8"?>
<SERVER>
  <DEAL>
    <ID>12345</ID>
    <DATA_QUALITY>exact</DATA_QUALITY>
    <CAPACITIES>
      <CAPACITY>
        <DATE>2017-01-01</DATE>
        <STATUS>available</STATUS>
        <UPDATED>2017-07-19 12:00:00</UPDATED>
      </CAPACITY>
      <CAPACITY>
        <DATE>2017-01-02</DATE>
        <STATUS>unavailable</STATUS>
        <UPDATED>2017-07-19 12:00:00</UPDATED>
      </CAPACITY>
    </CAPACITIES>
  </DEAL>
</SERVER>

Elementy

<SERVER>

Povinný	ano
Typ	kořenový element dokumentu

Kořenový element, v dokumentu je obsažen pouze jednou na nejvyšší úrovni.

<DEAL>

Povinný	ano
Typ	obalující element

Element sdružuje informace k jedné nabídce. V dokumentu se může vyskytovat vícekrát. Pokud např. budu mít 5 nabídek, kostra XML feedu (jsou vynechány podelementy <DEAL>) bude vypadat následovně:

<?xml version="1.0" encoding="utf-8"?>
<SERVER>
    <DEAL>
        <ID>101</ID>
        <!-- ... -->
    </DEAL>
    <DEAL>
        <ID>102</ID>
        <!-- ... -->
    </DEAL>
    <DEAL>
        <ID>103</ID>
        <!-- ... -->
    </DEAL>
    <DEAL>
        <ID>104</ID>
        <!-- ... -->
    </DEAL>
    <DEAL>
        <ID>105</ID>
        <!-- ... -->
    </DEAL>
</SERVER>

<ID>

Povinný	ano
Opakování	ne
Typ	řetězec
Příklad	<ID>42</ID>, <ID>400-ABC-15</ID>

Vaše unikátní ID nabídky, 1 nabídka = 1 ID. ID se nikdy v budoucnosti nesmí změnít, ani použít pro další nabídky! ID se musí shodovat s ID posílaným v konverzním kódu a xml feedu nabídek.

<DATA_QUALITY>

Povinný	ne
Opakování	ne
Typ	řetězec
Příklad	<DATA_QUALIY>exact</DATA_QUALITY>

V případě, že používáte rezervační systém a máte přesná data o kapacitě hotelu 24/7, bez nutnosti hotel kontaktovat telefonicky, tak můžete nabídku označit jako "exact" a tím pádem budou ověřená data na Skrz.cz přímo odkazovat na daný termín na vaší webové stránce. V opačném případě tag nechte prázdný.

<CAPACITIES>

Povinný	ano
Opakování	ne
Typ	obalující element

Obaluje seznam kapacit k jednotlivým dnům <CAPACITY>.

<CAPACITY>

Povinný	ano
Opakování	ano
Typ	obalující element
Příklad	<CAPACITY>   ... </CAPACITY>

Obalující element jednotlivých dnů.

<CAPACITY> / <DATE>

Povinný	ano
Opakování	ne
Typ	datum ve formátu YYYY-MM-DD
Příklad	<CAPACITY>   <DATE>2017-07-01</DATE> </CAPACITY>

Datum jednotlivé kapacity

<CAPACITY> / <STATUS>

Povinný	ano
Opakování	ne
Typ	řetězec z hodnot: available - datum je dostupný on_demand - dostupnost datumu není známa unavailable - datum je nedostupný
Příklad	<CAPACITY>   <STATUS>available</STATUS> </CAPACITY>

Typ jednotlivé kapacity. Pokud není uveden element <STATUS> ani <FREE_ROOMS> datum se automaticky považuje za dostupný.

<CAPACITY> / <FREE_ROOMS>

Povinný	ne
Opakování	ne
Typ	celé číslo
Příklad	<CAPACITY>   <FREE_ROOMS>2</FREE_ROOMS> </CAPACITY>

Počet volných pokojů k dané kapacitě. V případě konfliktu prvků <STATUS> a <FREE_ROOMS> má přednost <STATUS>.

<CAPACITY> / <UPDATED>

Povinný	ano
Opakování	ne
Typ	datum ve formátu YYYY-MM-DD HH:MM:SS
Příklad	<CAPACITY>   <UPDATED>2017-07-01 12:34:56</UPDATED> </CAPACITY>

Datum kdy byla ve vašem systému kapacita pro daný den aktualizována naposledy.