Руководство по интеграциям

Как получить коды, необходимые для подключения вашего объекта к сервисам Alloggiati Web, ISTAT и PayTourist

Alloggiati Web Портал Questura - отправка карточек регистрации гостей

Alloggiati Web — это портал Polizia di Stato для обязательной передачи персональных данных гостей в течение 24 часов после заезда. Чтобы подключить Vezpa к сервису, необходимы учётные данные доступа через веб-сервис (Web Service, WS).

Необходимые коды

Поле Описание
Имя пользователя WS Имя пользователя для веб-сервиса (отличается от логина на портале)
Пароль WS Пароль, предназначенный для веб-сервиса
Токен WS Токен аутентификации для автоматических запросов

Как их получить

  1. Войдите на портал Alloggiati Web с учётными данными, выданными Questura вашей провинции: alloggiatiweb.poliziadistato.it (открывается в новой вкладке)
  2. Оказавшись внутри, откройте раздел «Tabelle» в главном меню, затем выберите «Gestione WS» (веб-сервис).
  3. Если учётных данных WS у вас ещё нет, нажмите «Genera credenziali». Система автоматически создаст имя пользователя, пароль и токен.
  4. Скопируйте три значения (имя пользователя WS, пароль WS, токен WS) и введите их в разделе Интеграции > Alloggiati в настройках номера в Vezpa.
Внимание: Учётные данные WS отличаются от данных для входа на портал. Если вы не находите раздел «Gestione WS», обратитесь в Questura вашей провинции с запросом на подключение веб-сервиса.
Токен WS имеет ограниченный срок действия. Когда он истечёт, потребуется создать его заново на портале и обновить в Vezpa. В случае ошибок отправки мы отправим вам уведомление.

ISTAT - туристические потоки Статистический учёт движения гостей

ISTAT требует от объектов размещения регулярной передачи статистических данных о гостях (заезды, ночёвки, выезды). У каждого итальянского региона своя система. Vezpa поддерживает 19 регионов с автоматической отправкой или формированием файла.

Поддерживаемые регионы

РегионСистемаОтправкаУчётные данные
Пьемонт, Тоскана, Лигурия, Абруццо, Венето, Эмилия-Романья, Ломбардия, Калабрия, БазиликатаTurismo5АвтоматическаяИмя пользователя, пароль, код
Марке, Сардиния, Лацио, МолизеRoss1000АвтоматическаяИмя пользователя, пароль, код
СицилияOsservatorio TuristicoАвтоматическаяUserId, Password, HotelCode
КампанияSinfonia SMARTАвтоматическаяCUSR, API-ключ
ТрентиноDTU (Trentino Digitale)АвтоматическаяИмя пользователя, пароль, ID объекта
УмбрияTurismaticaФайл для скачиванияКод объекта
Фриули-Венеция-ДжулияWebTurФайл для скачиванияКод объекта
Валле-д'АостаVIT Albergatori (INVA)АвтоматическаяПользователь, пароль, ID объекта

Turismo5 / Ross1000 (13 регионов) — автоматическая отправка

Большинство регионов использует протокол Turismo5 или платформу Ross1000. Отправка полностью автоматическая.

  1. Обратитесь в туристическое бюро или в APT вашей провинции либо региона.
  2. Запросите учётные данные доступа к порталу Ross1000/Turismo5 для вашего объекта.
  3. Код объекта виден на панели регионального портала после входа.
  4. Введите имя пользователя, пароль и код объекта в настройках номера в Vezpa, выбрав свой регион в выпадающем меню.

Сицилия — Osservatorio Turistico Regionale — автоматическая отправка

Сицилия использует собственную систему. Учётные данные запрашиваются по электронной почте.

  1. Отправьте письмо на адрес [email protected] с запросом на активацию профиля «PMS User» для вашего объекта.
  2. Вы получите: UserId, Password и HotelCode (напр. TRS-IT-SIC-00004).
  3. В Vezpa выберите Сицилию в меню регионов и введите три значения в соответствующие поля.
Учётные данные для Сицилии отличаются от данных Questura и от данных ISTAT других регионов. Профиль «PMS User» предназначен для автоматической отправки из систем управления.

Кампания — Sinfonia Turismo SMART — автоматическая отправка

Кампания использует платформу Sinfonia SMART с аутентификацией через CUSR и API-ключ.

  1. Войдите на портал Sinfonia Turismo SMART с помощью SPID: turismo.regione.campania.it (открывается в новой вкладке)
  2. В разделе настроек получите CUSR (единый код объекта размещения) и создайте API-ключ.
  3. В Vezpa выберите Кампанию в меню регионов. Поля изменятся автоматически: введите CUSR и API-ключ в указанные поля.
CUSR — это региональный код объекта (формат: 15123123ALBXXXX). API-ключ — это ключ UUID, который можно создать на портале Sinfonia SMART.

Трентино — DTU (Trentino Digitale) — автоматическая отправка

Провинция Тренто использует систему DTU с отдельным веб-сервисом. Учётные данные те же, что и для портала STU.

  1. Войдите на портал STU: www.stu.provincia.tn.it (открывается в новой вкладке) с учётными данными вашего объекта.
  2. Запросите подключение к веб-сервису в Servizio Turismo провинции, заполнив соответствующую форму (доступна в разделе портала, посвящённом системам управления).
  3. Получите ID объекта (IDOBJ Esercizio, отображается в разделе «Inserimento movimentazione giornaliera C59 > da file»).
  4. В Vezpa выберите Трентино в меню регионов и введите имя пользователя, пароль и ID объекта.
Учётные данные те же, что вы используете для входа на портал STU. ID объекта — это число (напр. 1212051), а НЕ буквенно-цифровой код.

Валле-д'Аоста — VIT Albergatori — автоматическая отправка

Автономный регион Валле-д'Аоста использует систему VIT Albergatori, управляемую INVA. Отправка полностью автоматическая.

  1. Запросите учётные данные для доступа к сервису через Office du Tourisme вашей зоны или обратившись в регион.
  2. По электронной почте вы получите: пользователя, пароль и ID объекта (число, напр. 9005709).
  3. В Vezpa выберите Валле-д'Аосту в меню регионов и введите полученные учётные данные.
Переданные данные можно проверить, войдя на региональный портал с теми же учётными данными. Данные необходимо ежемесячно подтверждать закрытием C59-M на портале.

Умбрия и Фриули-Венеция-Джулия — скачивание файла

Для этих регионов Vezpa автоматически формирует файл в формате, который требует региональный портал. Директор гостиницы скачивает его из приложения и загружает вручную.

  1. Выберите Умбрию или Фриули-Венецию-Джулию в меню регионов в настройках номера.
  2. Введите код объекта, присвоенный регионом.
  3. В разделе «Интеграции» скачайте файл ISTAT за нужный период.
  4. Загрузите файл на региональный портал: Turismatica для Умбрии (turismatica.regione.umbria.it (открывается в новой вкладке)) или WebTur для Фриули-Венеции-Джулии (servizistatistici.regione.fvg.it/webtur (открывается в новой вкладке)).
Если вашего региона нет в списке (Апулия, Южный Тироль), свяжитесь с нами: мы постепенно добавляем поддержку всех итальянских регионов.

PayTourist Управление и взимание туристического налога

PayTourist — это платформа, которую многие итальянские коммуны используют для управления туристическим налогом. При подключении Vezpa к PayTourist декларации отправляются автоматически при каждом выезде.

Необходимые коды

Поле Описание
Код объекта Уникальный код, присвоенный вашему объекту сервисом PayTourist
API-ключ Ключ аутентификации для автоматического обмена данными

Как их получить

  1. Проверьте, использует ли ваша коммуна PayTourist для управления туристическим налогом. Это можно узнать на сайте коммуны или обратившись в налоговый отдел.
  2. Войдите на портал PayTourist с учётными данными, выданными вашей коммуной: www.paytourist.com (открывается в новой вкладке)
  3. В разделе «Настройки» или «Профиль объекта» вы найдёте присвоенный код объекта.
  4. Чтобы получить API-ключ, найдите раздел «Интеграции» или «API» на портале PayTourist. Если вы его не находите, обратитесь в поддержку PayTourist или в налоговый отдел вашей коммуны с запросом на подключение API.
  5. Введите код объекта и API-ключ в разделе Интеграции > PayTourist в настройках номера в Vezpa.
Примечание: Не все итальянские коммуны используют PayTourist. Некоторые применяют альтернативные платформы или не взимают туристический налог. Уточните в своей коммуне, какая система используется.

Нужна помощь?

Если вам сложно найти коды или у вас есть вопросы по настройке, наша команда к вашим услугам.

Свяжитесь с нами