Evropské kanály registrace hostů spadají do tří odlišných archetypů integrace: vládní webové služby s publikovaným schématem a testovacím prostředím (španělské SES.Hospedajes, italský Alloggiati Web, portugalský SIBA, slovinský AJPES eTurizem, chorvatský eVisitor, český UbyPort), komerční dodavatelské kanály soustředěné v regionu DACH (rozhraní feratel a AVS XML smluvně sjednaná přímo s obcemi, ne poskytovaná národní vládou) a země pouze s portálem bez jakéhokoli programového přístupu. Toto strukturální rozdělení je hlavní důvod, proč většina PMS systémů a channel managerů integruje compliance hlášení pro jednu nebo dvě země a dál se nedostane, místo aby vybudovala skutečně celoevropské pokrytí.
Jaké jsou tři archetypy integrace?
Vládní webové služby jsou nejblíže konvenčnímu zážitku REST nebo SOAP API: národní úřad publikuje schéma, obvykle testovací/sandbox prostředí, a očekává, že se dodavatelé softwaru integrují přímo. Španělsko, Itálie, Portugalsko, Slovinsko, Chorvatsko i Česko spadají do této kategorie, i když kvalita a modernost samotného rozhraní se mezi nimi výrazně liší.
Komerční dodavatelské kanály jsou specifické pro strukturu regionu DACH, kde byla registrace hostů historicky delegována na systémy obecních nebo regionálních turistických úřadů místo provozu na národní úrovni. V Rakousku to znamená, že praktickým integračním bodem pro většinu obcí je komerční dodavatel jako feratel, ne vládní API — proč na tom provozně záleží, vysvětluje další oddíl.
Země pouze s portálem — mezi ně patří Slovensko, Německo, Francie a Švýcarsko — poskytují webový formulář nebo papírový proces pro jednotlivé provozovatele, ale žádné publikované rozhraní, na které by se dodavatelé softwaru mohli vůbec integrovat. Budování „pokrytí” pro tyto země vypadá strukturálně jinak než u prvních dvou kategorií: znamená to připravit dokument připravený k podání, ne volat API.
Které systémy publikují skutečné specifikace a testovací prostředí?
Tam, kde skutečný vývojářský zážitek existuje, stojí za to vědět, s čím se vlastně integrujete:
- Španělské SES.Hospedajes publikuje předprodukční prostředí pro testování před ostrým nasazením.
- Slovinský AJPES nabízí vyhrazenou testovací službu pro integraci eTurizem.
- Italský Alloggiati Web dodává kompletní manuál WS_ALLOGGIATI, včetně formátu záznamu s pevnou šířkou 188 znaků (tracciato), který předchází moderním JSON API a stále vyžaduje pečlivé zacházení s diakritikou.
- Maďarský NTAK poskytuje sandboxové testovací prostředí jako součást svého certifikačního programu, popsaného níže.
Proč je region DACH jiný?
Rakouská krajina registrace hostů je užitečnou případovou studií toho, proč je otázka „má tato země API” ta špatná otázka. Neexistuje jeden celostátní digitální kanál — místo toho zhruba 80 % registrace hostů v rakouských obcích běží přes komerční systémy jako feratel Deskline, na základě komerční smlouvy o rozhraní mezi dodavatelem softwaru a obcí nebo turistickou radou, ne certifikace vydané vládou. Integrace „Rakouska” v praxi často znamená integraci konkrétně feratelu, což je zásadně jiný vztah s dodavatelem než integrace vládní webové služby.
Kde je certifikace povinná, ne volitelná?
Maďarsko je nejjasnějším příkladem země, kde si nemůžete jen tak vyžádat přihlašovací údaje k API a začít podávat. Hlášení VIZA musí být podávána konkrétně přes software certifikovaný NTAK — certifikace vyžaduje onboarding u Maďarské turistické agentury (MTÜ), vývojový balíček, integrační testování v sandboxovém prostředí a formální certifikaci před přístupem do produkce, což je proces, který obvykle trvá šest až dvanáct měsíců. VIZA navíc pro ověření totožnosti očekává vstup z dokladového skeneru místo ručního zadávání dat, což formuje UX check-inu, který musí každý certifikovaný software nabídnout.
Jaké jsou typické chyby při integraci?
Za většinu tření, na které dodavatelé narazí při přímé integraci těchto systémů, mohou dvě chyby:
- Správa přihlašovacích údajů. Téměř každý kanál se autentizuje jako konkrétní provozovatel nebo nemovitost, ne jako dodavatel softwaru — což znamená, že multi-tenantní platforma musí bezpečně ukládat a pro každé podání správně použít vlastní přihlašovací údaje každého zákazníka, ne sdílet jedny přihlašovací údaje dodavatele napříč zákazníky.
- Kódování znaků ve formátech s pevnou šířkou. Formát tracciato italského Alloggiati Web a podobné starší formáty s pevnou šířkou jinde zacházejí s diakritikou a nelatinskými znaky nekonzistentně, pokud proti nim konkrétně netestujete — jméno hosta s háčkem nebo čárkou je běžným zdrojem tiše odmítnutých podání.
Má PMS systém tohle stavět interně, nebo integrovat hotové řešení?
Vybudování přímých integrací i jen pro tři nebo čtyři z výše uvedených zemí je vícemsíční inženýrský projekt na zemi, poté průběžná zátěž údržby pokaždé, když vládní systém změní schéma nebo certifikační program aktualizuje požadavky — a to ještě před pokrytím zemí pouze s portálem, které potřebují úplně jiný provozní proces, ne integraci. Většina PMS systémů a channel managerů získá větší pokrytí rychleji tím, že integruje hotovou compliance vrstvu, která už rozdíly mezi archetypy řeší, než že by kanál každé země budovala a udržovala nezávisle.
Jak pomáhá Best Guest
Soukromé partnerské API Best Guest dává PMS systémům, channel managerům a rezervačním enginům jeden integrační bod — ilustrovaný příkladem POST /v1/checkins na naší stránce pro vývojáře — se specifickým zacházením pro jednotlivé země popsaným výše, které se řeší pod kapotou. Automatizované vládní podání dnes běží pro český UbyPort; ostatní země jsou pokryté formou připravených dokumentů k podání, zatímco se integrují jejich oficiální systémy, zhruba v pořadí podle dostupnosti API. Jak partneři typicky integrují, najdete v naší sekci řešení pro partnery PMS a channel manažerů, nebo v našem srovnání povinností registrace hostů napříč Evropou pro podkladová pravidla jednotlivých zemí, která toto API zakrývá.
Časté otázky
Existuje jedno API, které pokrývá hlášení registrace hostů napříč Evropou?
Žádný stát ho neposkytuje — přesně tuto mezeru mají za úkol zakrýt compliance API jako to od Best Guest. Systém každé země byl vybudován nezávisle, s vlastním modelem autentizace, datovým schématem a v případě Maďarska povinným certifikačním procesem místo otevřeného API.
Může dodavatel softwaru podávat hlášení hostů jménem provozovatele?
Obvykle ano, pomocí uložených přihlašovacích údajů provozovatele — legalita a praktičnost takového delegování se ale liší podle země. Slovenský postup přes slovensko.sk je vázán na vlastní eID provozovatele, což citelně omezuje, kolik z tohoto konkrétního podání může dodavatel automatizovat bez aktivní účasti provozovatele.
Ve kterých evropských zemích v tuto chvíli neexistuje žádné API pro registraci hostů?
Slovensko, Rakousko (na národní úrovni — obce z velké části místo toho používají komerční systém feratel), Německo, Francie a Švýcarsko se všechny spoléhají na hlášení přes portál, papír nebo místní záznam místo veřejného státního API.
Co obnáší maďarský certifikační proces NTAK?
Software musí projít onboardingem u MTÜ (Maďarská turistická agentura), získat vývojový balíček, dokončit integrační testování v sandboxu a získat certifikaci, než může podávat hlášení VIZA — proces obvykle trvá šest až dvanáct měsíců, ne prostou žádost o API klíč.
Zdroje
Ověřeno podle
Pouze informativní
Tato stránka slouží pouze pro obecnou informaci a není právním ani daňovým poradenstvím. Sazby, lhůty a osvobození stanoví zákon a obecní vyhlášky a mohou se měnit — aktuální požadavky si vždy ověřte u své obce nebo odborného poradce.