Ръководство за държавните системи
Questura, ISTAT, PayTourist и европейските конектори — настройка, идентификационни данни и автоматично изпращане
Съдържание
Докъде е стигнала връзкатаСъобщението, което приложението показва, и какво означава
Регистрацията на гости работи във всяка държава, в която Vezpa е достъпна, и продължава да работи. Това, което не е включено навсякъде, е автоматичната връзка с органа: изпращането на данните, които вече сте въвели.
Там, където връзката още не е активна, най-горе в Профил → Държавна регистрация ще намерите информационно каре, което го казва: автоматичното изпращане към органа на тази държава се тества, а регистрацията на гости работи нормално. Това е само информация: нищо не блокира, няма какво да потвърждавате или затваряте, а карето се появява и когато за вашата държава още няма никакъв конектор за настройка.
Карето изчезва само, когато връзката за вашата държава стане активна: не е нужно да правите нищо и никаква настройка не се обновява. Разделите по-долу описват как се настройва всяка система; съобщението казва докъде е стигнала.
Кога тръгва това, което сте оторизиралиТрите ритъма, кошницата «За изпращане» и обобщението за деня
Другите раздели казват на кого обявява Vezpa и с какви данни за достъп. Този казва кога, защото решението е на обекта и го вземате вие: отворете Конфигурация → Държавна регистрация и в карето «Кога да се изпраща към органите» изберете един от трите ритъма. Важи във всяка държава: в Италия управлява картоните към Questura (полицейската префектура) през услугата Alloggiati Web на Polizia di Stato, другаде изпращанията на конектора на вашата държава.
- «На всеки 4 часа» — шест преминавания на ден. Регистрирате госта и повече не мислите за това.
- «В 23:15» — само едно преминаване, в края на деня.
- «Ръчно» — тръгва само това, което изберете и изпратите вие.
Кошницата «За изпращане»
Щом изберете ръчния ритъм, в същото каре се появява редът «За изпращане»: кошницата с резервациите, които чакат, подредени по ден на пристигане. Отмятате тези, които искате да обявите, и натискате «Изпрати избраните». При другите два ритъма този ред го няма и нищо не липсва: няма какво да се избира, всичко тръгва само.
Да оторизираш не е да изпратиш и разликата не е дребнавост. Когато натиснете, разрешението се записва преди тръгването, а едно натискане може да отнесе само част от работата: тогава страницата ви го казва — «оторизирани, но изпращането още не е завършено» — и ви предлага «Завърши сега». Натискате пак и продължава оттам, където е спряло: това не е грешка. По същата причина на екрана никога не четете думата изпратена: една резервация е «Оторизирана», когато разрешението го има, а дали органът наистина я е приел казва резултатът, един по един.
ISTAT и PayTourist следват Questura
Тук няма какво да се решава и няма втори ключ: ISTAT и PayTourist вървят след Questura, сами. Ако една резервация е обявена на Questura, обявяват я и те; ако не е, не я обявяват. Така е устроено и на ръчно това има последствие, което е добре да се знае предварително: една нощ, която още не сте изпратили, стига до ISTAT като затворена стая. Включвайте ръчния ритъм само ако сте готови да изпращате редовно, иначе данните ви за заетост ще се променят по причина, която няма нищо общо със стаите ви.
На ръчно Questura приема само днес и вчера
Това не е наш избор, а на портала: Alloggiati Web приема като дата на пристигане само днес или вчера, а отвъд тази граница картонът се отхвърля. Не е формалност, защото картон със стара дата сам по себе си обявява изпращане след срока. Затова кошницата има прозорец: при ръчния ритъм да отложиш с два дена не е отлагане, а загуба.
Обобщението за деня
От горната част на страницата «За изпращане» се отваря «Обобщение за деня»: докъде сте стигнали днес, в три числа — «Гости за деня», «Оторизирани» и «Избрани за изпращане». Страницата е само за четене: оттук не се добавя и не се премахва нищо, в кошницата се връщате с «Добави или премахни резервации». Две места, които пишат същия списък, биха били два различни списъка.
Двата реда, които трябва да гледате, са тези, защото на тях се реагира:
- Избрани гости, които още не могат да бъдат обявени — липсва регистрацията им. Няма да тръгнат: регистрирайте ги и се връщат в декларацията.
- Гости, чийто избор е излязъл от прозореца — няма да тръгнат, изборът вече не може да се премахне и от приложението няма какво повече да се направи: за тези дни се минава през портала на органа. Броят се отделно от избраните, не сред тях, а това обобщение е единственото място, което още ви ги показва.
Данните за достъп се менят според държаватаПолета, които органът изисква, и тези, които важат по обект
Страницата с данните за достъп не е един и същ формуляр за всички. Освен общите полета — потребителско име, парола, идентификатор на имота, адрес на услугата — всяка държава обявява допълнителните полета, които нейният орган изисква, и страницата ги рисува сама: отворете Профил → Държавна регистрация, изберете системата и попълнете това, което виждате. Надписите носят официалното име, което органът им дава, и не се превеждат, за да ги намерите непроменени в портала, от който копирате стойностите. Където органът предлага тестова среда, има и превключвател за нея: позволява да проверите настройката, преди нещо да тръгне наистина. Поле, което не виждате, не липсва по погрешка: във вашата държава не се изисква.
И има нещо, което не се очаква: част от данните за достъп не са на имота, а на отделния обект. Където органът издава отделен идентификатор за всеки обект за настаняване, под общите полета се появява още една карта: Данни за достъп по обект. Изберете обекта от менюто и попълнете само това, което се различава за него: каквото оставите празно, използва стойността на имота и не се повтаря. Ако тази карта не се появява, във вашата държава не е нужна и всичко важи за целия имот.
Ако профилът има няколко имота, менюто на картата първо показва по един избор за всеки имот, „…: всички обекти“: данните за достъп, които запишете там, се записват за всеки от обектите му. Полезно е, когато органът ви е дал един идентификатор за адрес, а не за апартамент: въвеждате го веднъж и винаги можете да поправите отделен обект, като го изберете от менюто.
Questura (Alloggiati Web)Изпращане на регистрационните картони до Polizia di Stato
Всички италиански места за настаняване са задължени да съобщават данните на гостите си на Questura (полицейската префектура) чрез услугата Alloggiati Web на Polizia di Stato. Vezpa изпраща данните за гостите автоматично веднага щом бъдат регистрирани.
Как да получите идентификационните данни
- Регистрирайте се на alloggiatiweb.poliziadistato.it
- Подайте заявление за активиране в местната Questura
- Получавате идентификационните данни по имейл: потребителско име, парола и токен WS
- Въведете данните във Vezpa: Профил → Конфигурация → Questura
- Активирайте превключвателя „Активирано“
Автоматичен поток
Задължителни полета за Questura
| Поле | Описание |
|---|---|
| Фамилия, име | Лични данни на госта |
| Пол | M / F (задължително само за Италия) |
| Дата и място на раждане | С кода по ISTAT на общината |
| Гражданство | Код на държавата по Alloggiati Web |
| Вид и номер на документа | 95 налични вида (паспорт, лична карта и др.) |
| Вид настанено лице | Единичен гост (16), Глава на семейство (17), Ръководител на група (18) |
ISTAT — Туристическа статистика19 области, всяка със своя собствена система
Италия има 19 различни регионални системи за събиране на статистически данни за туризма. Vezpa поддържа всички: повечето напълно автоматично, а някои области изискват изтегляне на файл.
Области с автоматично изпращане (16 области)
За тези области Vezpa изпраща данните автоматично всяка вечер чрез уеб услуга. Нужни са ви само регионалните идентификационни данни.
| ID | Област | Протокол | Идентификационни данни |
|---|---|---|---|
| 0 | Пиемонт | SOAP v2 | Потребителско име + парола |
| 1 | Тоскана | SOAP v2 | Потребителско име + парола |
| 2 | Базиликата | SOAP v1 | Потребителско име + парола |
| 3 | Лигурия | SOAP v2 | Потребителско име + парола |
| 4 | Абруцо | SOAP v2 (Turismo5) | Потребителско име + парола |
| 5 | Венето | SOAP v2 | Потребителско име + парола |
| 6 | Емилия-Романя | SOAP v2 | Потребителско име + парола |
| 7 | Марке | ROSS1000 | Потребителско име + парола |
| 8 | Ломбардия | Turismo5 | Потребителско име + парола |
| 9 | Калабрия | SOAP v2 | Потребителско име + парола |
| 10 | Сардиния | ROSS1000 | Потребителско име + парола |
| 11 | Лацио | ROSS1000 | Потребителско име + парола |
| 12 | Молизе | ROSS1000 | Потребителско име + парола |
| 13 | Сицилия | REST XML | PMS User + HotelCode |
| 14 | Кампания | REST JSON (Sinfonia) | CUSR + API ключ |
| 17 | Трентино | SOAP DTU C59 | Потребителско име + парола |
| 19 | Вале д'Аоста | SOAP VIT (INVA) | Потребител + парола + ID на обекта |
Области с изтегляне на файл (3 области)
За тези области Vezpa генерира файла, който трябва да изтеглите от приложението и да качите ръчно в регионалния портал.
| ID | Област | Формат | Портал за качване |
|---|---|---|---|
| 15 | Умбрия | TXT (ROSS 1000) | Turismatica |
| 16 | Фриули-Венеция Джулия | TXT (ROSS 1000) | WebTur |
| 18 | Пулия | XML (SPOT) | www.dms.puglia.it (SPID) |
Как да настроите ISTAT
- Отворете Профил → Конфигурация и изберете вашата стая/жилище
- В раздела ISTAT активирайте превключвателя „Активирано“
- Изберете вашата област от падащото меню
- Въведете идентификационните данни, предоставени от регионалния портал
- Въведете кода по ISTAT на обекта
- Запазете. Автоматичното изпращане ще започне още същата вечер
PayTouristПлатформа за туристическата такса
PayTourist е незадължителна платформа, която автоматизира събирането и внасянето на туристическата такса за много италиански общини. Vezpa се интегрира директно с PayTourist, за да изпраща данните за гостите.
Необходими идентификационни данни
| Поле | Откъде се получава |
|---|---|
| ID за PayTourist | Регистрация на paytourist.it (самостоятелна) |
| API токен | Таблото на PayTourist след регистрацията |
Цифров подписСъбиране на подписа на госта при регистрацията
Цифровият подпис се събира както от приложението Flutter (при регистрацията на госта), така и от уеб самостоятелното настаняване (сензорно платно). Подписът се запазва като PNG изображение в профила на госта.
Подписът на госта се предлага само в държавите, където законът го изисква във формуляра за регистрация: Германия, Австрия, Франция и Испания. Дори там е по избор — в приложението и при онлайн регистрацията — защото гостът може да подпише формуляра на хартия при пристигане; в нито една държава подписът не се изпраща на властите, той служи на обекта като доказателство. В другите държави разделът за подпис не се показва, а където Vezpa може да създаде формуляра, PDF файлът се генерира въпреки това, с ред за подпис на хартия.
Формулярът се генерира от детайлите на резервацията чрез докосване до «Регистрационен документ»: излиза вече попълнен с данните на госта, на езика на държавата на обекта, готов за подпис и съхранение. Бутонът се появява сам там, където Vezpa може да изготви формуляра, и остава неактивен — със съобщение, което го обяснява — докато отговорникът на резервацията не бъде регистриран.
Европейски държавни конекториАвтоматично изпращане на данни за гостите за 7 държави + регистър за Исландия
За обекти, разположени в една от следните европейски държави, Vezpa може автоматично да изпраща данните за гостите към националната държавна система. Настройката се намира в Профил → Държавна регистрация. Ако връзката за вашата държава още не е активна, приложението ви го казва със съобщение в горната част на страницата: вижте Докъде е стигнала връзката.
🇪🇸 Испания — SES.Hospedajes
Задължително от 2 декември 2024 г. (Real Decreto 933/2021). Registro de viajeros към Ministerio del Interior.
| Данни за достъп | Откъде се получават |
|---|---|
| API ключ | seshospedajes.es (самостоятелно) |
| Establishment ID | Порталът SES след регистрация на обекта |
🇭🇷 Хърватия — eVisitor
Национална електронна система, управлявана от Hrvatska turistička zajednica (HTZ).
| Данни за достъп | Откъде се получават |
|---|---|
| Потребителско име + парола | evisitor.hr (самостоятелно) |
| API ключ | Порталът eVisitor след регистрация |
| Facility Code | Присвоява се при регистрацията |
🇭🇺 Унгария — NTAK
Националната система NTAK (Nemzeti Turisztikai Adatszolgáltatási Központ). Vezpa се свързва чрез посредника NTAK.guru, за да опрости интеграцията.
| Данни за достъп | Откъде се получават |
|---|---|
| Bearer Token | ntak.guru (самостоятелно) |
| Accommodation ID | Порталът NTAK.guru след регистрация |
🇵🇹 Португалия — SIBA
Boletim de Alojamento, задължителен съгласно Lei n.º 23/2007 (чл. 15-16).
| Данни за достъп | Откъде се получават |
|---|---|
| Потребителско име + парола | siba.ssi.gov.pt |
| Код Estabelecimento | Регистрация в SIBA |
🇨🇿 Чешка република — UbyPort
Задължителен регистър на чужденците, управляван от Cizinecká policie (Полиция за чужденците).
От 9 октомври 2026 г. Vezpa е одобрен от чешката полиция (Ředitelství služby cizinecké policie, RSCP) като софтуер за автоматично изпращане на данните на чуждестранните гости към UbyPort. Изпращането тръгва само, при ежечасното обхождане. Ако на гост липсват данни или полицията отхвърли запис, получавате известието «Проверете данните за госта» с името на госта и причината: отхвърленият запис не се повтаря сам, а се изпраща отново, след като коригирате данните.
| Данни за достъп | Откъде се получават |
|---|---|
| Потребителско име + парола | Акаунт за роботизирано изпращане на данни (účet pro robotické zasílání dat), издаден от RSCP |
| IDUB | Определя се от RSCP при регистрацията на обекта |
| Zkratka | Съкращение на обекта, дава се заедно с IDUB (по избор, препоръчително) |
Как се получава акаунтът. Не се създава автоматично; случаите са три:
- Вече имате роботизиран акаунт (например използван с друга PMS): с полицията няма какво да правите, акаунтът е прехвърлим. Въведете във Vezpa съществуващите данни за достъп.
- Имате IDUB, но нямате роботизиран акаунт: пишете на RSCP чрез datová schránka (ID ybndqw9) или по имейл на [email protected] с молба за акаунт за роботизирано изпращане на данни. Посочете IDUB, името и пълния адрес на обекта, производителя и името на софтуера, което трябва да е точно «Vezpa»: с всяко друго име искането не се одобрява.
- Нямате нито IDUB, нито акаунт: подайте обичайното заявление за регистрация на нов обект (Žádost o registraci nového ubytovacího zařízení) на ubyport.pcr.cz, като изберете «Účet pro ubytovatele + 1x Účet pro robotické zasílání dat» и посочите «Vezpa» като име на програмата.
Примерен текст на искането (на чешки): «Žádám o přihlašovací údaje do Ubyport Webová služba pro ubytovací zařízení <název>, <adresa>, IDUB: <IDUB>, které budu zasílat prostřednictvím programu Vezpa, výrobce Vezpa.» Повече на официалната страница на чешката полиция.
Във Vezpa, в Конфигурация → Държавна регистрация: потребителското име и паролата на роботизирания акаунт, IDUB в полето «Код на обекта», Zkratka в «Допълнителни настройки», след което включете «Автоматично изпращане». Оставете endpoint празен и «Тестова среда» изключена: тя е само за тестовите акаунти на разработчиците. Няколко обекта с отделни IDUB: използвайте «Данни за достъп по обект».
🇦🇹 Австрия — Meldeamt
Gästemeldung, задължителна съгласно Meldegesetz. Всяка провинция (Bundesland) има собствена система; Vezpa поддържа всички 9 провинции чрез настройваем endpoint.
| Данни за достъп | Откъде се получават |
|---|---|
| Потребителско име + парола или API ключ | Порталът на съответната провинция (feratel Deskline, GMS и др.) |
| Betriebsnummer | Присвоява се от регионалния Meldeamt |
| Endpoint URL | Специфичен за всяка провинция |
🇸🇮 Словения — eTurizem (AJPES)
Задължителна регистрация на туристите, управлявана от AJPES. Изисква квалифициран цифров сертификат, издаден от акредитиран словенски доставчик.
| Данни за достъп | Откъде се получават |
|---|---|
| Цифров сертификат PEM | SIGEN-CA, Halcom, NLB или друг акредитиран орган |
| ID nastanitvenega obrata | Порталът AJPES след регистрация |
🇮🇸 Исландия — Gistiskrá (регистър на гостите)
Съгласно исландския закон за местата за настаняване (Lög um veitingastaði, gististaði og skemmtanahald) всеки обект трябва да води регистър на гостите (gistiskrá) с данните на всички гости. Регистърът трябва да е на разположение за проверка от исландската полиция (Lögreglan).
Vezpa записва автоматично всички изисквани данни по време на настаняването. Не е необходима никаква настройка на данни за достъп — данните са винаги налични в приложението и могат да бъдат експортирани или разпечатани по всяко време.
| Задължително поле | Описание |
|---|---|
| Пълно име | Име и фамилия на госта |
| Дата на раждане | Пълна дата |
| Националност | Държава на гражданство |
| Документ | Вид и номер (паспорт или лична карта) |
| Местожителство | Пълен адрес |
| Дати на престоя | Пристигане и заминаване |
Изтегляне на файла за ISTATЗа областите с ръчно качване (Умбрия, Фриули-Венеция Джулия, Пулия)
Областите Умбрия, Фриули-Венеция Джулия и Пулия не разполагат с уеб услуга за автоматично изпращане. За тези области Vezpa генерира файла, който трябва да изтеглите и да качите ръчно.
Как да изтеглите файла
- Отворете конфигурацията на обекта (Профил → докоснете дадена стая)
- В раздела ISTAT проверете дали е избрана правилната област
- Натиснете бутона „Изтегли файл ISTAT“
- Изберете началната дата и крайната дата на периода
- Натиснете „Генерирай и изтегли файла“
- Файлът се генерира и можете да го споделите (имейл, WhatsApp, запис във файловата система)
Формати на файловете по области
| Област | Формат | Къде се качва |
|---|---|---|
| Умбрия | TXT (ROSS 1000, 338 знака/запис) | Turismatica |
| Фриули В.Дж. | TXT (ROSS 1000, 338 знака/запис) | WebTur |
| Пулия | XML (SPOT, формат movimentogiornaliero-0.6.xsd) | www.dms.puglia.it (достъп със SPID) |
<movimento> за всеки ден от избрания период, с пристигания, заминавания и данни за обекта (налични стаи, легла, заети стаи). Доставчикът се задава автоматично като „Vezpa“.
Имате нужда от помощ?
Ако имате въпроси относно настройката на държавните системи или не успявате да получите данните за достъп, свържете се с поддръжката на Vezpa.