Ръководство за интеграциите

Как да получите кодовете, необходими за свързване на вашия обект с услугите 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. Някои използват алтернативни платформи или нямат туристическа такса. Проверете с вашата община коя система се използва.

Имате нужда от помощ?

Ако срещате трудности при намирането на кодовете или имате въпроси относно конфигурацията, нашият екип е на ваше разположение.

Свържете се с нас