Руководство по государственным системам
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
- Получите учётные данные по электронной почте: Имя пользователя, Пароль и Token WS
- Введите учётные данные в Vezpa: Профиль → Конфигурация → Questura
- Включите переключатель «Активно»
Автоматический процесс
Обязательные поля Questura
| Поле | Описание |
|---|---|
| Фамилия, имя | Персональные данные гостя |
| Пол | M / F (обязательно только для Италии) |
| Дата и место рождения | С кодом ISTAT муниципалитета |
| Гражданство | Код страны Alloggiatiweb |
| Тип и номер документа | 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 (self-service) |
| API-токен | Личный кабинет PayTourist после регистрации |
Цифровая подписьПолучение подписи гостя во время регистрации
Цифровая подпись собирается как в приложении Flutter (во время регистрации гостя), так и при веб-самостоятельной регистрации (self check-in) (сенсорный холст). Подпись сохраняется в профиле гостя в виде изображения PNG.
Подпись гостя предлагается только в странах, где закон требует её в регистрационной форме: Германия, Австрия, Франция и Испания. Даже там она необязательна — в приложении и при онлайн-регистрации — потому что гость может подписать форму на бумаге по прибытии; ни в одной стране подпись не передаётся властям, она служит объекту доказательством. В остальных странах раздел подписи не отображается, а там, где Vezpa умеет формировать форму, PDF всё равно создаётся, со строкой для подписи на бумаге.
Форма создаётся из карточки бронирования нажатием на «Документ регистрации»: она выходит уже заполненной данными гостя, на языке страны объекта, готовой к подписи и хранению. Кнопка появляется сама там, где Vezpa умеет сформировать форму, и остаётся неактивной — с сообщением, которое это объясняет — пока ответственный за бронь не будет зарегистрирован.
Европейские государственные коннекторыАвтоматическая отправка данных гостей для 7 стран + реестр Исландии
Для объектов, расположенных в одной из перечисленных ниже европейских стран, Vezpa может автоматически отправлять данные гостей в национальную государственную систему. Настройка находится в разделе Профиль → Государственная регистрация. Если подключение для вашей страны ещё не активно, приложение сообщит об этом рамкой вверху страницы: см. На каком этапе подключение.
🇪🇸 Испания — SES.Hospedajes
Обязательно с 2 декабря 2024 года (Real Decreto 933/2021). Registro de viajeros при Ministerio del Interior.
| Учётные данные | Где их получить |
|---|---|
| API Key | seshospedajes.es (self-service) |
| Establishment ID | Портал SES после регистрации объекта |
🇭🇷 Хорватия — eVisitor
Национальная электронная система, управляемая организацией Hrvatska turisticka zajednica (HTZ).
| Учётные данные | Где их получить |
|---|---|
| Имя пользователя + Пароль | evisitor.hr (self-service) |
| API Key | Портал eVisitor после регистрации |
| Facility Code | Присваивается при регистрации |
🇭🇺 Венгрия — NTAK
Национальная система NTAK (Nemzeti Turisztikai Adatszolgaltatasi Kozpont). Vezpa подключается через посредника NTAK.guru, что упрощает интеграцию.
| Учётные данные | Где их получить |
|---|---|
| Bearer Token | ntak.guru (self-service) |
| Accommodation ID | Портал NTAK.guru после регистрации |
🇵🇹 Португалия — SIBA
Boletim de Alojamento обязателен согласно Lei № 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
Gaestemeldung обязательна согласно закону Meldegesetz. У каждой федеральной земли (Bundesland) своя система; Vezpa поддерживает все 9 Bundeslaender с настраиваемым эндпоинтом.
| Учётные данные | Где их получить |
|---|---|
| Имя пользователя + Пароль либо API Key | Портал своей федеральной земли (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> на каждый день выбранного периода с заездами, выездами и данными объекта (доступные номера, спальные места, занятые номера). Поставщик (vendor) автоматически указывается как «Vezpa».
Нужна помощь?
Если у вас есть вопросы по настройке государственных систем или не удаётся получить учётные данные, обратитесь в службу поддержки Vezpa.