Európske kanály registrácie hostí spadajú do troch odlišných archetypov integrácie: vládne webové služby s publikovanou schémou a testovacím prostredím (španielske SES.Hospedajes, taliansky Alloggiati Web, portugalský SIBA, slovinský AJPES eTurizem, chorvátsky eVisitor, český UbyPort), komerčné dodávateľské kanály sústredené v regióne DACH (rozhrania feratel a AVS XML zmluvne dohodnuté priamo s obcami, nie poskytované národnou vládou) a krajiny iba s portálom bez akéhokoľvek programového prístupu. Toto štrukturálne rozdelenie je hlavný dôvod, prečo väčšina PMS systémov a channel manažérov integruje compliance hlásenie pre jednu alebo dve krajiny a ďalej sa nedostane, namiesto toho, aby vybudovala skutočne celoeurópske pokrytie.

Aké sú tri archetypy integrácie?

Vládne webové služby sú najbližšie konvenčnému zážitku REST alebo SOAP API: národný úrad publikuje schému, zvyčajne testovacie/sandboxové prostredie, a očakáva, že sa dodávatelia softvéru integrujú priamo. Španielsko, Taliansko, Portugalsko, Slovinsko, Chorvátsko aj Česko spadajú do tejto kategórie, hoci kvalita a modernosť samotného rozhrania sa medzi nimi výrazne líši.

Komerčné dodávateľské kanály sú špecifické pre štruktúru regiónu DACH, kde bola registrácia hostí historicky delegovaná na systémy obecných alebo regionálnych turistických úradov namiesto prevádzky na národnej úrovni. V Rakúsku to znamená, že praktickým integračným bodom pre väčšinu obcí je komerčný dodávateľ ako feratel, nie vládne API — prečo na tom prevádzkovo záleží, vysvetľuje ďalšia časť.

Krajiny iba s portálom — patrí medzi ne Slovensko, Nemecko, Francúzsko a Švajčiarsko — poskytujú webový formulár alebo papierový proces pre jednotlivých prevádzkovateľov, ale žiadne publikované rozhranie, na ktoré by sa dodávatelia softvéru mohli vôbec integrovať. Budovanie „pokrytia” pre tieto krajiny vyzerá štrukturálne inak než pri prvých dvoch kategóriách: znamená to pripraviť dokument pripravený na podanie, nie volať API.

Ktoré systémy publikujú skutočné špecifikácie a testovacie prostredia?

Tam, kde skutočný vývojársky zážitok existuje, oplatí sa vedieť, s čím sa vlastne integrujete:

  • Španielske SES.Hospedajes publikuje predprodukčné prostredie na testovanie pred ostrým nasadením.
  • Slovinský AJPES ponúka vyhradenú testovaciu službu na integráciu eTurizem.
  • Taliansky Alloggiati Web dodáva kompletný manuál WS_ALLOGGIATI, vrátane formátu záznamu s pevnou šírkou 188 znakov (tracciato), ktorý predchádza moderným JSON API a stále vyžaduje starostlivé zaobchádzanie s diakritikou.
  • Maďarský NTAK poskytuje sandboxové testovacie prostredie ako súčasť svojho certifikačného programu, opísaného nižšie.

Prečo je región DACH iný?

Rakúska krajina registrácie hostí je užitočnou prípadovou štúdiou toho, prečo je otázka „má táto krajina API” tá nesprávna otázka. Neexistuje jeden celoštátny digitálny kanál — namiesto toho zhruba 80 % registrácie hostí v rakúskych obciach beží cez komerčné systémy ako feratel Deskline, na základe komerčnej zmluvy o rozhraní medzi dodávateľom softvéru a obcou alebo turistickou radou, nie certifikácie vydanej vládou. Integrácia „Rakúska” v praxi často znamená integráciu konkrétne feratelu, čo je zásadne iný vzťah s dodávateľom než integrácia vládnej webovej služby.

Kde je certifikácia povinná, nie voliteľná?

Maďarsko je najjasnejším príkladom krajiny, kde si nemôžete len tak vyžiadať prihlasovacie údaje k API a začať podávať. Hlásenia VIZA musia byť podávané konkrétne cez softvér certifikovaný NTAK — certifikácia vyžaduje onboarding u Maďarskej turistickej agentúry (MTÜ), vývojový balík, integračné testovanie v sandboxovom prostredí a formálnu certifikáciu pred prístupom do produkcie, čo je proces, ktorý zvyčajne trvá šesť až dvanásť mesiacov. VIZA navyše na overenie totožnosti očakáva vstup z dokladového skenera namiesto ručného zadávania dát, čo formuje UX check-inu, ktorý musí poskytnúť každý certifikovaný softvér.

Aké sú typické chyby pri integrácii?

Za väčšinu trenia, na ktoré dodávatelia narazia pri priamej integrácii týchto systémov, môžu dve chyby:

  • Správa prihlasovacích údajov. Takmer každý kanál sa autentizuje ako konkrétny prevádzkovateľ alebo nehnuteľnosť, nie ako dodávateľ softvéru — čo znamená, že multi-tenantná platforma musí bezpečne ukladať a pre každé podanie správne použiť vlastné prihlasovacie údaje každého zákazníka, nie zdieľať jedny prihlasovacie údaje dodávateľa naprieč zákazníkmi.
  • Kódovanie znakov vo formátoch s pevnou šírkou. Formát tracciato talianskeho Alloggiati Web a podobné staršie formáty s pevnou šírkou inde zaobchádzajú s diakritikou a nelatinskými znakmi nekonzistentne, ak proti nim konkrétne netestujete — meno hosťa s dĺžňom alebo mäkčeňom je bežným zdrojom potichu odmietnutých podaní.

Má PMS systém toto stavať interne, alebo integrovať hotové riešenie?

Vybudovanie priamych integrácií aj len pre tri alebo štyri z vyššie uvedených krajín je viacmesačný inžiniersky projekt na krajinu, potom priebežná záťaž údržby zakaždým, keď vládny systém zmení schému alebo certifikačný program aktualizuje požiadavky — a to ešte pred pokrytím krajín iba s portálom, ktoré potrebujú úplne iný prevádzkový proces, nie integráciu. Väčšina PMS systémov a channel manažérov získa väčšie pokrytie rýchlejšie tým, že integruje hotovú compliance vrstvu, ktorá už rozdiely medzi archetypmi rieši, než že by kanál každej krajiny budovala a udržiavala nezávisle.

Ako pomáha Best Guest

Súkromné partnerské API Best Guest dáva PMS systémom, channel manažérom a rezervačným enginom jeden integračný bod — ilustrovaný príkladom POST /v1/checkins na našej stránke pre vývojárov — so špecifickým zaobchádzaním pre jednotlivé krajiny opísaným vyššie, ktoré sa rieši pod kapotou. Automatizované vládne podanie dnes beží pre český UbyPort; ostatné krajiny sú pokryté formou pripravených dokumentov na podanie, zatiaľ čo sa integrujú ich oficiálne systémy, zhruba v poradí podľa dostupnosti API. Ako partneri typicky integrujú, nájdete v našej sekcii riešenia pre partnerov PMS a channel manažérov, alebo v našom porovnaní povinností registrácie hostí naprieč Európou pre podkladové pravidlá jednotlivých krajín, ktoré toto API zakrýva.

Časté otázky

Existuje jedno API, ktoré pokrýva hlásenie registrácie hostí naprieč Európou?

Žiadny štát ho neposkytuje — presne túto medzeru majú za úlohu zakryť compliance API, ako je to od Best Guest. Systém každej krajiny bol vybudovaný nezávisle, s vlastným modelom autentizácie, dátovou schémou a v prípade Maďarska povinným certifikačným procesom namiesto otvoreného API.

Môže dodávateľ softvéru podávať hlásenia hostí v mene prevádzkovateľa?

Zvyčajne áno, pomocou uložených prihlasovacích údajov prevádzkovateľa — legalita a praktickosť takého delegovania sa však líši podľa krajiny. Slovenský postup cez slovensko.sk je viazaný na vlastné eID prevádzkovateľa, čo citeľne obmedzuje, koľko z tohto konkrétneho podania môže dodávateľ automatizovať bez aktívnej účasti prevádzkovateľa.

V ktorých európskych krajinách momentálne neexistuje žiadne API na registráciu hostí?

Slovensko, Rakúsko (na národnej úrovni — obce namiesto toho vo veľkej miere používajú komerčný systém feratel), Nemecko, Francúzsko a Švajčiarsko sa všetky spoliehajú na hlásenie cez portál, papier alebo miestny záznam namiesto verejného štátneho API.

Čo obnáša maďarský certifikačný proces NTAK?

Softvér musí prejsť onboardingom u MTÜ (Maďarská turistická agentúra), získať vývojový balík, dokončiť integračné testovanie v sandboxe a získať certifikáciu, kým môže podávať hlásenia VIZA — proces zvyčajne trvá šesť až dvanásť mesiacov, nie jednoduchú žiadosť o API kľúč.