Načítání

XML feed načítáme v kratké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.

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>
    <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.

<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.

Skrz.cz s.r.o. (2019) Všeobecné obchodní podmínky | Pravidla pro zveřejňování nabídek