Ubyport webová služba: jak napojit vlastní systém a hlásit automaticky

Webová služba je jediná varianta Ubyportu, kde po počátečním nastavení už nemusíte hlášení nijak ručně odesílat. Software, vlastní nebo dodavatelský, se napojí přímo na rozhraní cizinecké policie a hlásí za vás. Vyžaduje to trochu technického nastavení navíc, ale vyplatí se to každému, kdo hlásí pravidelně.

Jak webová služba technicky funguje

• Ubyport nabízí SOAP webovou službu s NTLM autentizací. Přihlašovací jméno a heslo, které vám policie přidělí, slouží zároveň jako autentizační kód přímo v těle SOAP zprávy.
• K dispozici je testovací i produkční endpoint. Integraci vždy nejdřív ověřte v testu, než přepnete na ostrý provoz, chyba v produkci se totiž řeší hůř než chyba v testu.
• Odpověď služby obsahuje potvrzení o přijetí, nebo popis chyby u konkrétního záznamu. Software může chybu rovnou zpracovat a vás na ni upozornit, místo aby se ztratila v protokolu.

Krok 1: Požádejte o přístup k webové službě

Webová služba vyžaduje jiné přihlašovací údaje než formulář nebo UNL, takže i když už do Ubyportu přistupujete ručně, o přístup k webové službě musíte požádat zvlášť. Podle toho, jestli už jste u Ubyportu registrovaní nebo ne, se postup mírně liší.

Pokud už jste v Ubyportu registrovaní

Zašlete žádost datovou schránkou na adresu ybndqw9, případně e-mailem na reguby@pcr.cz. Žádost je volnou formou, stačí uvést IDUB, název a adresu ubytovacího zařízení a název programu, který bude data zasílat. Text si můžete zkopírovat a jen doplnit vlastní údaje:

Stačí doplnit název, adresu a IDUB vašeho zařízení, zbytek textu zůstává stejný.

Pokud se teprve registrujete

Při registraci do Ubyportu rovnou zvolte „Účet pro ubytovatele + 1x Účet pro robotické zasílání dat“ a vyplňte údaje o používané aplikaci (checkin.blue). Přístup k webové službě tak dostanete rovnou při zřízení účtu, bez samostatné žádosti.

Postup podle oficiálního vyjádření cizinecké policie k automatizaci Ubyportu. Přihlašovací údaje pro webovou službu se liší od údajů pro formulář nebo UNL, takže je potřeba o ně požádat i v případě, že do Ubyportu už běžně přistupujete.

Krok 2: Předejte přihlašovací údaje softwaru

IDUB, zkratku ubytovatele, přihlašovací jméno a heslo předáte systému, který bude hlášení sestavovat. Pokud používáte hotové řešení pro ubytovatele, obvykle stačí tyto údaje zadat do administrace, technickou stránku integrace za vás řeší dodavatel.

Krok 3: Otestujte integraci

Než začnete hlásit ostré hosty, odešlete pár zkušebních záznamů na testovací endpoint a zkontrolujte, že odpověď odpovídá očekávání, tedy že se hlášení skutečně přijme a případné chyby se srozumitelně vrátí zpět.

Krok 4: Přepněte na produkční provoz

Po úspěšném testu přepnete na produkční endpoint. Hlášení pak odchází automaticky, obvykle jednou denně nebo průběžně po každém check-inu, v zákonné lhůtě 3 pracovních dnů od ubytování.