Přenos a aktualizace
- HTTPS URL, autentizovaný endpoint, SFTP nebo dohodnuté API.
- UTF-8 a stabilní struktura.
- U úplného snapshotu musí být uvedeno, že chybějící položka už není aktuální.
- U rozdílového feedu musí být dostupné vytvoření, změna a odstranění.
- Import musí mít dostatečně stabilní identifikátory, aby nevznikala nová nabídka při každé aktualizaci.
Povinná pole
| Pole | Význam | Příklad |
|---|---|---|
id | Stabilní ID konkrétní nabídky nebo termínu | offer-2026-0001 |
title | Srozumitelný název | Hotel Example Resort – 8 dní |
country | Země pobytu | Egypt |
startDate | Datum odjezdu ISO | 2026-08-15 |
nights | Počet nocí | 7 |
price | Částka, měna a význam ceny | 18 990 CZK za osobu |
availability | Dostupnost termínu | available |
detailUrl | Konkrétní HTTPS měřený deeplink | https://…/zajezd/123 |
Silně doporučená pole
tourId,termIdahotelIdpro přesné slučování,hotelName, oblast a letovisko,- typ dopravy a místo odjezdu,
- strava, typ pokoje a obsazenost,
priceCheckedAtaupdatedAt,- pořadatel a prodejce,
- zahrnutá zavazadla, transfer a služby,
- odkaz na obchodní a storno podmínky,
- fotografie s potvrzeným oprávněním k publikaci.
Stabilní identifikátory
ID nabídky se nesmí měnit jen kvůli změně ceny. Pokud partner rozlišuje zájezd, termín, hotel a pokoj, doporučujeme posílat všechny tyto identifikátory. Díky tomu lze přesněji vytvořit hotelovou entitu, termínovou skupinu a historii ceny.
Cena
U každé ceny musí být jasné, zda je za osobu, za celý pokoj nebo jde o cenu „od“. Měna musí být ISO 4217. Původní cena se používá pouze tehdy, když je oprávněná a vztahuje se ke stejné variantě.
Dostupnost
Podporované základní hodnoty jsou available, on-request, limited, sold-out, unavailable a cancelled. Vyprodaný termín může zůstat ve zdroji, ale musí být jednoznačně označený.
Čerstvost
Pro last minute termíny doporučujeme aktualizaci několikrát za hodinu nebo živé ověření. U ostatních zájezdů alespoň několikrát denně. Každá nabídka by měla obsahovat čas posledního ověření ceny.
Deeplink a měření
Odkaz musí vést přímo na konkrétní termín nebo nejbližší možnou konfiguraci. Musí být platný pro náš partnerský účet a nesmí návštěvníka bez důvodu vracet na obecnou úvodní stránku.
Bezpečnost
Produkční hesla a privátní klíče neposílejte běžným e-mailem. Nejprve se domluví typ autentizace a bezpečný způsob předání. Přístup má mít nejnižší oprávnění potřebné pouze pro čtení katalogu.
Validace
JSON lze ověřit proti veřejnému souboru travel-feed.schema.json. U XML přijmeme stávající strukturu a připravíme mapování, pokud obsahuje povinné údaje.